Draft Draft2Sketch: Difference between revisions

From FreeCAD Documentation
(Marked this version for translation)
(Button template, not KEY)
(14 intermediate revisions by 4 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
Line 9: Line 19:
}}
}}


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

This tool converts [[Draft Module|Draft objects]] to [[Sketcher Module|Sketcher Sketches]], and vice-versa.
<!--T:2-->
The {{Button|[[Image:Draft Draft2Sketch.svg|16px]] [[Draft Draft2Sketch|Draft Draft2Sketch]]}} tool converts {{Button|[[Image:Workbench_Draft.svg|16px]] [[Draft Module|Draft objects]]}} to {{Button|[[Image:Workbench_Sketcher.svg|16px]] [[Sketcher Module|Sketcher Sketches]]}}, and vice-versa.


</translate>
</translate>
Line 18: Line 30:
{{Caption|Converting Draft shapes into Sketcher shapes with constraints}}
{{Caption|Converting Draft shapes into Sketcher shapes with constraints}}


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

<!--T:4-->
# Select a Draft object or a Sketch.
# Select a Draft object or a Sketch.
# Press the {{Button|[[Image:Draft Draft2Sketch.svg|16px]] [[Draft Draft2Sketch]]}} button.
# Press the {{Button|[[Image:Draft Draft2Sketch.svg|16px]] [[Draft Draft2Sketch]]}} button.
Line 24: Line 38:
<!--T:9-->
<!--T:9-->
Notes:
Notes:
* If you convert a [[Draft Wire]], the resulting sketch will use point constraints for the nodes.
* If you convert a [[Image:Draft_Wire.svg|16px]] [[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 [[Image:Draft_Rectangle.svg|16px]] [[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 CreateBSpline|Sketcher BSpline]], as the [[Sketcher Workbench]] doesn't support Bezier curves currently.
* If you convert a [[Image:Draft_BezCurve.svg|16px]] [[Draft BezCurve]], the resulting sketch will be approximated by a [[Image:Sketcher_CreateBSpline.svg|16px]] [[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.
* Non-Draft objects that are totally planar will also get converted to sketches.


Line 36: Line 50:


<!--T:12-->
<!--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.
As of {{VersionPlus|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-->
Line 47: Line 61:


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

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

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

Revision as of 15:46, 13 March 2020

Draft Draft2Sketch

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

Description

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

Converting Draft shapes into Sketcher shapes with constraints

Usage

  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.

As of version 0.17 and above 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)