Draft Drawing: Difference between revisions

From FreeCAD Documentation
No edit summary
m (moved templates out of translation tags)
(28 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
<!--T:19-->
{{Docnav
|[[Draft_Clone|Clone]]
|[[Draft_Mirror|Mirror]]
|[[Draft_Module|Draft]]
|IconL=Draft_Clone.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Mirror.svg
}}


<!--T:23-->
{{VeryImportantMessage|Development of the [[Drawing Workbench|Drawing Workbench]] stopped in FreeCAD 0.16; the new [[TechDraw Workbench|TechDraw Workbench]] aiming to replace it was introduced in v0.17. Both workbenches are still provided in v0.17, but the Drawing Workbench may be removed in future releases.}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=Draft Drawing|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Drafting → Drawing}}
|Name=Draft Drawing
|MenuLocation=Drafting → Drawing
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|SeeAlso=[[TechDraw Workbench]], [[Draft Shape2DView]]
}}


==Description== <!--T:2-->
==Description== <!--T:2-->


<!--T:3-->
<!--T:3-->
This tool allows you to put selected objects on a svg [[Drawing Module|Drawing sheet]]. If no [[Drawing_templates|sheet]] exists in the document, a default one will be created. This tool works similarly to the [[Drawing View]] tool, but is optimized for [[Draft Workbench|Draft]] objects, and can render flat 2D objects with a face filling. It can also handle a couple of specific Draft objects, such as [[Draft Dimension|dimensions]] and [[Draft Text|texts]], that the [[Drawing View]] tool cannot handle.
The Drawing tool allows you to put selected objects on a drawing sheet created with the [[Drawing Workbench|Drawing Workbench]]. If no [[Drawing templates|sheet]] exists in the document, a default one will be created.

<!--T:14-->
This tool works similarly to the [[Drawing View|Drawing View]] tool but is optimized for [[Draft Workbench|Draft Workbench]] objects, and can render 2D objects with a face filling. It can handle specific objects such as [[Draft Dimension|Draft Dimension]] and [[Draft Text|Draft Text]], that the [[Drawing View|Drawing View]] tool cannot handle.


</translate>
</translate>
[[Image:Draft drawing example.jpg|640px]]
[[Image:Draft drawing example.jpg|640px]]
<translate>
<translate>
<!--T:15-->
{{Caption|Draft object and dimensions imported into a Drawing page}}


==How to use== <!--T:4-->
==Usage== <!--T:4-->


<!--T:5-->
<!--T:5-->
# Select the objects you wish to put on a drawing sheet
# Select the objects that you wish to put on a drawing sheet.
# In the same selection, add the [[Drawing Workbench|Drawing Workbench]] page object in which you want to draw the projection of the objects.
# Press the {{KEY|[[Image:Draft Drawing.png|16px]] [[Draft Drawing]]}} button
# Press the {{Button|[[Image:Draft_Drawing.svg|16px]] [[Draft Drawing|Draft Drawing]]}} button.

==Notes== <!--T:16-->
* The tool will work best with 2D objects from the [[Draft Workbench|Draft Workbench]] or [[Sketcher Workbench|Sketcher Workbench]].
* The selected object can also be an [[Arch SectionPlane|Arch SectionPlane]], which will show the elements viewed by that plane.
* If there is no existing page, a new one will be created.
* If no page was selected but there is at least one in the document, the first page found will be used to put the projections.
* If you select a sheet and the objects already projected on that sheet, the projections will be updated.


==Options== <!--T:6-->
==Options== <!--T:6-->


<!--T:7-->
<!--T:7-->
There are no options for this tool. Either it works with the selected objects or not.
* Select objects you want to put on the drawing sheet. The tool will work best with flat 2D objects from the [[Draft Module|Draft]] or [[Sketcher Workbench|Sketcher]] modules.
* If the selected object is an [[Arch SectionPlane]], this tool will create an additional view of that section plane.
* In the same selection, add the page object you want to draw your objects to. If there is no existing page, a new one will be created. If you didn't select a page but there is at least one in the document, the first found one will be used to draw to.
* If you selected an existing sheet, and the objects in the selection that are already on that sheet (for ex. for a "Rectangle" object there is already a "ViewRectangle" object on the sheet), they will be substitued. This allows you to simply select all the objects and send them to an existing page, which will simply be updated.


==Properties== <!--T:8-->
==Properties== <!--T:8-->


<!--T:9-->
<!--T:9-->
* {{PropertyData|Fill Style}}: For closed shapes, allows to specify one of the Default Draft fill styles, or use the shape color.
* {{PropertyData|Fill Style}}: specifies the fill style "concrete", "square", "simple", "wood", "line", "cross", "woodgrain", or "shape color". This property only works for closed shapes.
* {{PropertyData|Font Size}}: Allows you to specify the font size of texts and dimensions.
* {{PropertyData|Font Size}}: specifies the font size of texts and dimensions.
* {{PropertyData|Line Width}}: Allows you to specify the line width of viewed objects.
* {{PropertyData|Line Width}}: specifies the line width of viewed objects in millimeters.


==Scripting== <!--T:10-->
==Scripting== <!--T:10-->
{{Emphasis|See also:}} [[Draft API|Draft API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


<!--T:11-->
<!--T:11-->
The Draft Drawing tool can by used in [[macros]] and from the python console by using the following function:
The Drawing tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:


</translate>
</translate>
{{Code|code=
{{Code|code=
DrawingView = makeDrawingView(obj, page, lwmod=None, tmod=None, otherProjection=None)
Draft.makeDrawingView (object,page)
}}
}}
<translate>
<translate>


<!--T:12-->
<!--T:12-->
* Creates a {{incode|DrawingView}} from {{incode|obj}} in the specified {{incode|page}}.
* Adds a view of the given object to the given page.
* If given, {{incode|lwmod}} modifies line weights in percentage, and {{incode|tmod}} modifies text heights in percentage.
* Returns the created view object.

<!--T:17-->
The attributes of the view usually need to be modified so that it is displayed correctly in the drawing page. In particular, the position is controlled by {{incode|X}} and {{incode|Y}}, which are given in millimeters, and {{incode|Scale}} is important to correctly fit the projected shape in the page. The scale usually ranges from 1 to 0.25 (1:1 to 1:4) for small solids, and from 0.02 to 0.01 (1:50 to 1:100) for typical architectural elements.


<!--T:13-->
<!--T:13-->
Line 54: Line 87:
</translate>
</translate>
{{Code|code=
{{Code|code=
import FreeCAD,Draft
import FreeCAD, Draft, Drawing

obj = FreeCAD.ActiveDocument.ActiveObject
obj = Draft.makePolygon(5, 1000)
page = FreeCAD.ActiveDocument.Page
page = FreeCAD.ActiveDocument.addObject('Drawing::FeaturePage', 'Page')
Draft.makeDrawingView(obj,page)
page.Template = FreeCAD.getResourceDir() + 'Mod/Drawing/Templates/A3_Landscape.svg'

View = Draft.makeDrawingView(obj, page)
View.Scale = 0.02
FreeCAD.ActiveDocument.recompute()

View.X = 200
View.Y = 150
FreeCAD.ActiveDocument.recompute()
}}
}}
<translate>

<!--T:18-->
{{Docnav
|[[Draft_Clone|Clone]]
|[[Draft_Mirror|Mirror]]
|[[Draft_Module|Draft]]
|IconL=Draft_Clone.svg
|IconC=Workbench_Draft.svg
|IconR=Draft_Mirror.svg
}}

</translate>
{{Draft Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Revision as of 04:58, 21 February 2020


Development of the Drawing Workbench stopped in FreeCAD 0.16; the new TechDraw Workbench aiming to replace it was introduced in v0.17. Both workbenches are still provided in v0.17, but the Drawing Workbench may be removed in future releases.

Draft Drawing

Menu location
Drafting → Drawing
Workbenches
Draft, Arch
Default shortcut
None
Introduced in version
-
See also
TechDraw Workbench, Draft Shape2DView

Description

The Drawing tool allows you to put selected objects on a drawing sheet created with the Drawing Workbench. If no sheet exists in the document, a default one will be created.

This tool works similarly to the Drawing View tool but is optimized for Draft Workbench objects, and can render 2D objects with a face filling. It can handle specific objects such as Draft Dimension and Draft Text, that the Drawing View tool cannot handle.

Draft object and dimensions imported into a Drawing page

Usage

  1. Select the objects that you wish to put on a drawing sheet.
  2. In the same selection, add the Drawing Workbench page object in which you want to draw the projection of the objects.
  3. Press the Draft Drawing button.

Notes

  • The tool will work best with 2D objects from the Draft Workbench or Sketcher Workbench.
  • The selected object can also be an Arch SectionPlane, which will show the elements viewed by that plane.
  • If there is no existing page, a new one will be created.
  • If no page was selected but there is at least one in the document, the first page found will be used to put the projections.
  • If you select a sheet and the objects already projected on that sheet, the projections will be updated.

Options

There are no options for this tool. Either it works with the selected objects or not.

Properties

  • DataFill Style: specifies the fill style "concrete", "square", "simple", "wood", "line", "cross", "woodgrain", or "shape color". This property only works for closed shapes.
  • DataFont Size: specifies the font size of texts and dimensions.
  • DataLine Width: specifies the line width of viewed objects in millimeters.

Scripting

See also: Draft API and FreeCAD Scripting Basics.

The Drawing tool can be used in macros and from the Python console by using the following function:

DrawingView = makeDrawingView(obj, page, lwmod=None, tmod=None, otherProjection=None)
  • Creates a DrawingView from obj in the specified page.
  • If given, lwmod modifies line weights in percentage, and tmod modifies text heights in percentage.

The attributes of the view usually need to be modified so that it is displayed correctly in the drawing page. In particular, the position is controlled by X and Y, which are given in millimeters, and Scale is important to correctly fit the projected shape in the page. The scale usually ranges from 1 to 0.25 (1:1 to 1:4) for small solids, and from 0.02 to 0.01 (1:50 to 1:100) for typical architectural elements.

Example:

import FreeCAD, Draft, Drawing

obj = Draft.makePolygon(5, 1000)
page = FreeCAD.ActiveDocument.addObject('Drawing::FeaturePage', 'Page')
page.Template = FreeCAD.getResourceDir() + 'Mod/Drawing/Templates/A3_Landscape.svg'

View = Draft.makeDrawingView(obj, page)
View.Scale = 0.02
FreeCAD.ActiveDocument.recompute()

View.X = 200
View.Y = 150
FreeCAD.ActiveDocument.recompute()