Draft Draft2Sketch: Difference between revisions

From FreeCAD Documentation
No edit summary
(Marked this version for translation)
(21 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<translate>
<translate>
<!--T:16-->
{{Docnav|[[Draft_Shape2DView|Shape 2D View]]|[[Draft_Array|Array]]|[[Draft_Module|Draft]]|IconL=Draft_Shape2DView.svg|IconC=Workbench_Draft.svg|IconR=Draft_Array.svg}}

<!--T:1-->
<!--T:1-->
{{GuiCommand
{{GuiCommand|Name=Draft Draft2Sketch|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Drafting -> Draft to Sketch}}
|Name=Draft Draft2Sketch
|MenuLocation=Draft → Draft to Sketch
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|SeeAlso=[[Sketcher Workbench]], [[PartDesign Workbench]]
}}


==Description== <!--T:2-->
==Description== <!--T:2-->
This tool converts [[Draft Module|Draft objects]] to [[Sketcher Module|Sketcher objects]], and vice-versa.
This tool converts [[Draft Module|Draft objects]] to [[Sketcher Module|Sketcher Sketches]], and vice-versa.


</translate>
<!--T:3-->
[[Image:Draft Draft2Sketch example.jpg||480px]]
[[Image:Draft Draft2Sketch example.jpg||480px]]
<translate>
<!--T:3-->
{{Caption|Converting Draft shapes into Sketcher shapes with constraints}}


==How to use== <!--T:4-->
==How to use== <!--T:4-->
# Select a Draft object or a Sketch
# Select a Draft object or a Sketch.
# Press the {{KEY|[[Image:Draft Draft2Sketch.png|16px]] [[Draft Draft2Sketch]]}} button
# Press the {{Button|[[Image:Draft Draft2Sketch.svg|16px]] [[Draft Draft2Sketch]]}} button.


==Options== <!--T:5-->
<!--T:9-->
Notes:
* If you convert a [[Draft Wire]], point constraints will be applied to the nodes
* If you convert a [[Draft Rectangle]], point constraints will be applied to the corners, and horizontal and vertical constraints to the edges
* If you convert a [[Draft Wire]], the resulting sketch will use point constraints for the nodes.
* If you convert a [[Draft Rectangle]], the resulting sketch will use point constraints for the corners, and horizontal and vertical constraints for the edges.
* Non-Draft objects that are totally planar will also get converted to sketches
* If you convert a [[Draft BezCurve]], the resulting sketch will be approximated by a [[Sketcher CreateBSpline|Sketcher BSpline]], as the [[Sketcher Workbench]] doesn't support Bezier curves currently.
* Non-Draft objects that are totally planar will also get converted to sketches.


<!--T:6-->
===Limitations=== <!--T:10-->
The sketcher does support straight lines and circular arcs. The conversion of any element that can not be represented with those will fail.
The conversion of an object that cannot be represented with a combination of straight lines, circular arcs, and B-Splines will usually fail, that is, the item will not appear in the sketch.


<!--T:7-->
<!--T:11-->
In the past, a [[Draft BSpline]] couldn't be converted directly to a sketch. A tool to perform this conversion was developed for the [[KicadStepUp Workbench]], which would take a [[Draft BSpline]] and convert it into a series of [[Sketcher CreateArc|Sketcher Arcs]]. See the forum thread [https://forum.freecadweb.org/viewtopic.php?f=9&t=25082 BSplines to Shape2DView and Sketcher] for more information.
The conversion of any element that can not be represented with either a straight line or circular curve will just fail, i.e. the item will not appear in the sketch.

<!--T:12-->
Since FreeCAD 0.17, the conversion from [[Draft BSpline]] to [[Sketcher CreateBSpline|Sketcher BSpline]] is possible. However, converting a spline to a series of arcs may still be useful for exporting geometry to applications that don't support B-Splines, like KiCad.

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

<!--T:13-->
There are no options for this tool. Either it works with the selected object or not.


==Scripting== <!--T:8-->
==Scripting== <!--T:8-->
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]].
Not available, see the [[Sketcher Module]] documentation for how to create sketches by scripting


<!--T:14-->
Internally the Draft2Sketch tool uses two methods to convert back and forth from Draft to Sketch.

<!--T:19-->
Convert objects to Sketch:
</translate>
</translate>
{{Code|code=
<languages/>
Draft.makeSketch(objectslist, autoconstraints=False, addTo=None, delete=False, name="Sketch", radiusPrecision=-1)
}}
<translate>

<!--T:20-->
Convert objects to Draft:
</translate>
{{Code|code=
Draft.draftify(objectslist, makeblock=False, delete=True)
}}
<translate>

<!--T:15-->
{{Docnav|[[Draft_Shape2DView|Shape 2D View]]|[[Draft_Array|Array]]|[[Draft_Module|Draft]]|IconL=Draft_Shape2DView.svg|IconC=Workbench_Draft.svg|IconR=Draft_Array.svg}}

<!--T:17-->
{{Draft Tools navi}}

<!--T:18-->
{{Userdocnavi}}
</translate>
{{clear}}

Revision as of 08:09, 22 August 2019

Draft Draft2Sketch

Menu location
Draft → Draft to Sketch
Workbenches
Draft, Arch
Default shortcut
None
Introduced in version
-
See also
Sketcher Workbench, PartDesign Workbench

Description

This tool converts Draft objects to Sketcher Sketches, and vice-versa.

Converting Draft shapes into Sketcher shapes with constraints

How to use

  1. Select a Draft object or a Sketch.
  2. Press the Draft Draft2Sketch button.

Notes:

  • If you convert a Draft Wire, the resulting sketch will use point constraints for the nodes.
  • If you convert a Draft Rectangle, the resulting sketch will use point constraints for the corners, and horizontal and vertical constraints for the edges.
  • If you convert a Draft BezCurve, the resulting sketch will be approximated by a Sketcher BSpline, as the Sketcher Workbench doesn't support Bezier curves currently.
  • Non-Draft objects that are totally planar will also get converted to sketches.

Limitations

The conversion of an object that cannot be represented with a combination of straight lines, circular arcs, and B-Splines will usually fail, that is, the item will not appear in the sketch.

In the past, a Draft BSpline couldn't be converted directly to a sketch. A tool to perform this conversion was developed for the KicadStepUp Workbench, which would take a Draft BSpline and convert it into a series of Sketcher Arcs. See the forum thread BSplines to Shape2DView and Sketcher for more information.

Since FreeCAD 0.17, the conversion from Draft BSpline to Sketcher BSpline is possible. However, converting a spline to a series of arcs may still be useful for exporting geometry to applications that don't support B-Splines, like KiCad.

Options

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

Scripting

See also: Draft API and FreeCAD Scripting Basics.

Internally the Draft2Sketch tool uses two methods to convert back and forth from Draft to Sketch.

Convert objects to Sketch:

Draft.makeSketch(objectslist, autoconstraints=False, addTo=None, delete=False, name="Sketch", radiusPrecision=-1)

Convert objects to Draft:

Draft.draftify(objectslist, makeblock=False, delete=True)