Draft Draft2Sketch: Difference between revisions

From FreeCAD Documentation
(Sketches, not "objects")
(Marked this version for translation)
(10 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<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
|Name=Draft Draft2Sketch
|MenuLocation=Drafting → Draft to Sketch
|MenuLocation=Draft → Draft to Sketch
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]
|SeeAlso=[[Sketcher Workbench]], [[PartDesign Workbench]]
|SeeAlso=[[Sketcher Workbench]], [[PartDesign Workbench]]
Line 12: Line 15:
This tool converts [[Draft Module|Draft objects]] to [[Sketcher Module|Sketcher Sketches]], 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-->
Line 19: Line 25:
# Press the {{Button|[[Image:Draft Draft2Sketch.svg|16px]] [[Draft Draft2Sketch]]}} button.
# Press the {{Button|[[Image:Draft Draft2Sketch.svg|16px]] [[Draft Draft2Sketch]]}} button.


<!--T:9-->
Notes:
Notes:
* If you convert a [[Draft Wire]], the resulting sketch will use point constraints for the nodes.
* If you convert a [[Draft Wire]], the resulting sketch will use point constraints for the nodes.
Line 25: Line 32:
* Non-Draft objects that are totally planar will also get converted to sketches.
* Non-Draft objects that are totally planar will also get converted to sketches.


===Limitations===
===Limitations=== <!--T:10-->
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.
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:11-->
In the past, a [[Draft BSpline]] couldn't be converted directly to a sketch. A special tool was required, such as a function in the the [[KicadStepUp Workbench]], which can approximate B-Splines to a series of [[Draft Arc]]s. See the forum thread [https://forum.freecadweb.org/viewtopic.php?f=9&t=25082 BSplines to Shape2DView and Sketcher].
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.


<!--T:12-->
Since FreeCAD 0.17, the conversion from [[Draft BSpline]] to [[Sketcher CreateBSpline|Sketcher BSpline]] is possible. However, converting to a series of arcs is still useful in order to export the curved shape to a particular application that doesn't support B-Splines, like KiCad.
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-->
==Options== <!--T:5-->


<!--T:13-->
There are no options for this tool. Either it works with the selected object or not.
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]].
{{Emphasis|See also:}} [[Draft API]] and [[FreeCAD Scripting Basics]].


<!--T:14-->
There is no programming interface available for the Draft2Sketch tool. See the [[Sketcher Workbench]] documentation for the Sketcher API.
Internally the Draft2Sketch tool uses two methods to convert back and forth from Draft to Sketch.

<!--T:19-->
Convert objects to Sketch:
</translate>
{{Code|code=
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}}
{{Draft Tools navi}}

<!--T:18-->
{{Userdocnavi}}
{{Userdocnavi}}
</translate>
</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)