Draft Drawing: Difference between revisions

From FreeCAD Documentation
(More details for the properties)
m (moved templates out of translation tags)
(20 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
Line 8: Line 22:
|SeeAlso=[[TechDraw Workbench]], [[Draft Shape2DView]]
|SeeAlso=[[TechDraw Workbench]], [[Draft Shape2DView]]
}}
}}
{{VeryImportantMessage|Development of the [[Drawing Workbench]] stopped in FreeCAD v0.16, and 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.}}


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


<!--T:3-->
<!--T:3-->
The Drawing tool allows you to put selected objects on a drawing sheet created with the [[Drawing Workbench]]. If no [[Drawing templates|sheet]] exists in the document, a default one will be created.
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]] 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.
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 that 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]] page object in which you want to draw the projection of the objects.
# 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 {{Button|[[Image:Draft Drawing.png|16px]] [[Draft Drawing]]}} button.
# Press the {{Button|[[Image:Draft_Drawing.svg|16px]] [[Draft Drawing|Draft Drawing]]}} button.


Notes:
==Notes== <!--T:16-->
* The tool will work best with 2D objects from the [[Draft Workbench]] or [[Sketcher Workbench]].
* 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]], which will show the elements viewed by that plane.
* 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 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 no page was selected but there is at least one in the document, the first page found will be used to put the projections.
Line 48: Line 64:


==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 67: 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()