Difference between revisions of "Draft Draft2Sketch"

From FreeCAD Documentation
Jump to navigation Jump to search
m (Languages spanish)
 
(40 intermediate revisions by 7 users not shown)
Line 1: Line 1:
{{GuiCommand|Name=Draft_Draft2Sketch|Workbenches=[[Draft Module|Draft]], [[Arch Module|Arch]]|MenuLocation=Drafting -> Draft to Sketch}}
+
<languages/>
 +
<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
 +
}}
  
==Description==
+
<!--T:1-->
 +
{{GuiCommand
 +
|Name=Draft Draft2Sketch
 +
|MenuLocation=Draft → Draft to Sketch
 +
|Workbenches=[[Draft_Module|Draft]], [[Arch_Module|Arch]]
 +
|SeeAlso=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]
 +
}}
  
This tool converts [[Draft Module|Draft objects]] to [[Sketcher Module|Sketcher objects]], and vice-versa.
+
==Description== <!--T:21-->
  
[[Image:Draft Draft2Sketch example.jpg|400px]]
+
<!--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.
  
==How to use==
+
</translate>
 +
[[Image:Draft Draft2Sketch example.jpg||480px]]
 +
<translate>
 +
<!--T:3-->
 +
{{Caption|Converting Draft shapes into Sketcher shapes with constraints}}
  
# Select a Draft object or a Sketch
+
==Usage== <!--T:22-->
# Press the {{KEY|[[Image:Draft Draft2Sketch.png|16px]] [[Draft Draft2Sketch]]}} button
 
  
==Options==
+
<!--T:4-->
 +
# Select a Draft object or a Sketch.
 +
# Press the {{Button|[[Image:Draft Draft2Sketch.svg|16px]] [[Draft_Draft2Sketch|Draft Draft2Sketch]]}} button.
  
* If you convert a [[Draft Wire]], point constraints will be applied to the nodes
+
<!--T:9-->
* If you convert a [[Draft Rectangle]], point constraints will be applied to the corners, and horizontal and vertical constraints to the edges
+
Notes:
* Non-Draft objects that are totally planar will also get converted to sketches
+
* If you convert a [[Image:Draft_Wire.svg|16px]] [[Draft_Wire|Draft Wire]], the resulting sketch will use point constraints for the nodes.
 +
* 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.
  
==Scripting==
+
===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.
  
Not available, see the [[Sketcher Module]] documentation for how to create sketches by scripting
+
<!--T:11-->
 +
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.
  
{{languages | {{es|Draft_Draft2Sketch/es}} }}
+
<!--T:12-->
 +
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-->
 +
 
 +
<!--T:13-->
 +
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}}

Latest revision as of 10:36, 5 December 2020

Other languages:
Deutsch • ‎English • ‎Türkçe • ‎español • ‎français • ‎hrvatski • ‎italiano • ‎română • ‎svenska • ‎čeština • ‎русский
Arrow-left.svg Previous: Draft Shape2DView.svg Shape 2D View
Next: Array Draft Array.svg Arrow-right.svg

Draft Draft2Sketch.svg 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.svg Draft Draft2Sketch tool converts Workbench Draft.svg Draft objects to Workbench Sketcher.svg Sketcher Sketches, and vice-versa.

Draft Draft2Sketch example.jpg

Converting Draft shapes into Sketcher shapes with constraints


Usage

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

Notes:

  • If you convert a Draft Wire.svg Draft Wire, the resulting sketch will use point constraints for the nodes.
  • If you convert a Draft Rectangle.svg 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.svg Draft BezCurve, the resulting sketch will be approximated by a Sketcher CreateBSpline.svg 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 v0.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)
Arrow-left.svg Previous: Draft Shape2DView.svg Shape 2D View
Next: Array Draft Array.svg Arrow-right.svg