TechDraw PageDefault: Difference between revisions

From FreeCAD Documentation
(Removed Version=0.19. Tool exists in V0.17 and maybe even in an earlier version.)
('TechDraw Insert Page using Template' is an over-correction.)
Line 16: Line 16:
|MenuLocation=TechDraw → Insert Default Page
|MenuLocation=TechDraw → Insert Default Page
|Workbenches=[[TechDraw_Module|TechDraw]]
|Workbenches=[[TechDraw_Module|TechDraw]]
|SeeAlso=[[TechDraw_PageTemplate|TechDraw Insert Page using Template]], [[TechDraw_Templates|TechDraw Templates]]
|SeeAlso=[[TechDraw_PageTemplate|Insert Page using Template]], [[TechDraw_Templates|TechDraw Templates]]
}}
}}



Revision as of 19:01, 21 November 2020

TechDraw PageDefault

Menu location
TechDraw → Insert Default Page
Workbenches
TechDraw
Default shortcut
None
Introduced in version
-
See also
Insert Page using Template, TechDraw Templates

Description

The New Default tool creates a new Page object using the the template file specified in the TechDraw Preferences.

Default template that comes with TechDraw: A4 page in landscape orientation, with editable text fields

Usage

Notes

  • If a Page is marked as "do not keep updated" either through the KeepUpdated Property or by the setting in Preferences, it will ignore changes in the 3D model. You may notice anomalies (missing geometry, missing Dimension values, etc) in the appearance of the Page. These will correct themselves once the Page is updated. The Page will have this icon in the tree while updating is suspended. This setting also affects the startup process. If the Page is marked "do not keep updated" it will not be drawn at program start.

If the default template is not specified in your user configuration file user.cfg, the tool will try

$INSTALL_DIR/Mod/TechDraw/Templates/A4_LandscapeTD.svg

Where $INSTALL_DIR is the directory where FreeCAD was installed, for example

/usr/share/freecad/Mod/TechDraw/Templates/A4_LandscapeTD.svg

Properties

  • DataProjection Type: Default projection type (First or Third Angle) for this Page.
  • DataKeep Updated: If false, Page is not updated with changes to the 3D model. Useful for complicated/slow drawings. See Notes.
  • DataTemplate: A link to this Page's Template object.
  • DataViews: A list of links to the Views on this Page.
  • DataScale: Default scale for Views in this Page.

Scripting

See also: TechDraw API and FreeCAD Scripting Basics.

The New Default tool can be used in macros and from the Python console by using the following functions:

page = FreeCAD.ActiveDocument.addObject('TechDraw::DrawPage','Page')
template = FreeCAD.ActiveDocument.addObject('TechDraw::DrawSVGTemplate','Template')
template.Template = templateFileSpec
page.Template = FreeCAD.ActiveDocument.Template
  • Creates a new Page in the current document

Editable text fields

See also: TechDraw Templates for more information on creating templates.

Once a new page has been created, its Template attribute holds an EditableTexts dictionary with the name of the editable fields (keys) and their textual values. Copy this dictionary to a variable, make changes, and then re-assign the dictionary to the EditableTexts attribute to see the changes.

page = FreeCAD.ActiveDocument.Page
texts = page.Template.EditableTexts

for key, value in texts.items():
    print("{0} = {1}".format(key, value))

texts["FC-Title"] = "The title of my page"
page.Template.EditableTexts = texts