Draft Draft2Sketch: Difference between revisions

From FreeCAD Documentation
(précision sur l'outil esquisse)
No edit summary
(37 intermediate revisions by 7 users not shown)
Line 1: Line 1:
<languages/>
{{GuiCommand|Name=Draft_Draft2Sketch|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Drafting -> Draft to Sketch}}
<translate>
<!--T:16-->
{{Docnav
|[[Draft_Shape2DView|Shape 2D View]]
|[[Draft_Array|Array]]
|[[Draft_Module|Draft]]
|IconL=Draft_Shape2DView.svg
|IconR=Draft_Array.svg
|IconC=Workbench_Draft.svg
}}


<!--T:1-->
==Description==
{{GuiCommand
|Name=Draft Draft2Sketch
|MenuLocation=Draft → Draft to Sketch
|Workbenches=[[Draft_Module|Draft]], [[Arch_Module|Arch]]
|SeeAlso=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]
}}


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


<!--T:2-->
[[Image:Draft Draft2Sketch example.jpg|400px]]
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>
==How to use==
[[Image:Draft Draft2Sketch example.jpg||480px]]
<translate>
<!--T:3-->
{{Caption|Converting Draft shapes into Sketcher shapes with constraints}}


==Usage== <!--T:22-->
# Select a Draft object or a Sketch
# Press the {{KEY|[[Image:Draft Draft2Sketch.png|16px]] [[Draft Draft2Sketch]]}} button


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


<!--T:9-->
* If you convert a [[Draft Wire]], point constraints will be applied to the nodes
Notes:
* 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 [[Image:Draft_Wire.svg|16px]] [[Draft_Wire|Draft Wire]], the resulting sketch will use point constraints for the nodes.
* Non-Draft objects that are totally planar will also get converted to sketches
* If you convert a [[Image:Draft_Rectangle.svg|16px]] [[Draft_Rectangle|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_BezCurve.svg|16px]] [[Draft_BezCurve|Draft BezCurve]], the resulting sketch will be approximated by a [[Image:Sketcher_CreateBSpline.svg|16px]] [[Sketcher_CreateBSpline|Sketcher BSpline]], as the [[Sketcher_Workbench|Sketcher Workbench]] doesn't support Bezier curves currently.
* Non-Draft objects that are totally planar will also get converted to sketches.


===Limitations=== <!--T:10-->
The sketcher does support straight lines and circular arcs. The conversion of any element that can not be reprsented 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:11-->
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.
In the past, a [[Draft_BSpline|Draft BSpline]] couldn't be converted directly to a sketch. A tool to perform this conversion was developed for the [[KicadStepUp_Workbench|KicadStepUp Workbench]], which would take a [[Draft_BSpline|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-->
==Scripting==
As of {{VersionPlus|0.17}} the conversion from [[Draft_BSpline|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-->
Not available, see the [[Sketcher Module]] documentation for how to create sketches by scripting


<!--T:13-->
{{languages | {{es|Draft_Draft2Sketch/es}} {{fr|Draft_Draft2Sketch/fr}} {{it|Draft_Draft2Sketch/it}} }}
There are no options for this tool. Either it works with the selected object or not.

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

<!--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>
{{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
|IconR=Draft_Array.svg
|IconC=Workbench_Draft.svg
}}

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

Revision as of 10:36, 5 December 2020

Draft Draft2Sketch

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

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)