https://wiki.freecad.org/api.php?action=feedcontributions&user=FuzzyBot&feedformat=atomFreeCAD Documentation - User contributions [en]2024-03-28T20:02:35ZUser contributionsMediaWiki 1.40.1https://wiki.freecad.org/index.php?title=Draft_PathArray/de&diff=1388583Draft PathArray/de2024-03-28T18:20:17Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav/de<br />
|[[Draft_CircularArray/de|KreisAnordnung]]<br />
|[[Draft_PathLinkArray/de|PfadVerknüpfungsanordnung]]<br />
|[[Draft_Workbench/de|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{GuiCommand/de<br />
|Name=Draft PathArray<br />
|Name/de=Draft PfadAnordnung<br />
|MenuLocation=Änderung → Anordnungswerkzeuge → Pfad-Anordnung<br />
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]<br />
|Version=0.14<br />
|SeeAlso=[[Draft_OrthoArray/de|Draft RechtwinkligeAnordnung]], [[Draft_PolarArray/de|Draft PolareAnordnung]], [[Draft_CircularArray/de|Draft KreisAnordnung]], [[Draft_PathLinkArray/de|Draft PfadVerknüpfungsanordnung]], [[Draft_PointArray/de|Draft PunktAnordnung]], [[Draft_PointLinkArray/de|Draft PunktVerknüpfungsanordnung]]<br />
}}<br />
<br />
<span id="Description"></span><br />
==Beschreibung==<br />
<br />
Der Befehl [[Image:Draft_PathArray.svg|24px]] '''Draft PfadAnordnung''' erstellt eine regelmäßige Anordnung aus einem ausgewählten Objekt, indem er Kopien entlang eines Pfades positioniert. Der Befehl [[Draft_PathLinkArray/de|Draft PfadVerknüpfungsanordnung]] erstellt alternativ eine effizientere Verknüpfungsanordnung ([[App_Link|Link]]-Array). Außer der Art der Anordnung die erstellt wird, normale Anordnung oder Verknüpfungsanordnung, ist der Befehl [[Draft_PathLinkArray/de|Draft PfadVerknüpfungsanordnung]] identisch mit diesem Befehl.<br />
<br />
Beide Befehle können für 2D-Objekte verwendet werden, die mit den Arbeitsbereichen [[Draft_Workbench/de|Draft]] oder [[Sketcher_Workbench/de|Sketcher]] erstellt wurden, aber auch für viele 3D-Objekte, die mit anderen Arbeitsbereichen wie [[Part_Workbench/de|Part]], [[PartDesign_Workbench/de|PartDesign]] oder [[Arch_Workbench/de|Arch]] erstellt wurden.<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PfadAnordnung}}<br />
<br />
<span id="Usage"></span><br />
==Anwendung==<br />
<br />
# Ein Objekt auswählen, das angeordnet werden soll.<br />
# Ein Pfadobjekt zur Auswahl hinzufügen. Es ist auch möglich stattdessen Kanten auszuwählen. Die Kanten müssen zu demselben Objekt gehören und miteinander verbunden sein.<br />
# Es gibt mehrere Möglichkeiten den Befehl aufzurufen:<br />
#* Die Schaltfläche {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray|Pfad-Anordnung]]}} drücken.<br />
#* Den Menüeintrag {{MenuCommand|Änderung → Anordnungswerkzeuge → [[Image:Draft_PathArray.svg|16px]] Pfad-Anordnung}} auswählen.<br />
# Die Anordnung wird erstellt.<br />
# Wahlweise die [[#Eigenschaften|Eigenschaften]] der Anordnung im [[property_editor/de|Eigenschafteneditor]] ändern.<br />
<br />
<span id="Alignment"></span><br />
==Ausrichtung==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 Anordnungen die auf demselben nicht ebenen Pfad basieren. Von links nach rechts: '''Align''' ist ''false'', '''Align''' ist ''true'' mit '''Align Mode''' ''Original'' und '''Align''' ist ''true'' mit '''Align Mode''' ''Frenet''}}.<br />
<br />
<span id="Align_Mode"></span><br />
===Ausrichtungsmodus===<br />
<br />
Es gibt drei Ausrichtungsmodi<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
<span id="Tangent"></span><br />
====Tangente====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
<span id="Properties"></span><br />
==Eigenschaften==<br />
<br />
Siehe auch: [[property_editor/de|Eigenschafteneditor]].<br />
<br />
Eine [[Draft_PathArray/de|Pfad-Anordnung]] (Path-Array-Objekt) ist von einem [[Part_Feature/de|Part-Formelement]] abgeleitet und erbt alle seine Eigenschaften (mit Ausnahme einiger Ansicht-Eigenschaften, die nicht an die Verknüpfungsanordnungen vererbt werden). Außerdem sind, wenn nicht anders angegeben, die folgenden zusätzlichen Eigenschaften vorhanden:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
Die Eigenschaften dieser Gruppe stehen nur für Verknüpfungsanordnungen zur Verfügung. Siehe [[Std_LinkMake/de#Eigenschaften|Std VerknüpfungErstellen]] für weitere Informationen.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
* {{PropertyData/de|Align|Bool}}: Legt fest, ob die Elemente der Anordnung entlang des Pfades ausgerichtet werden oder nicht. Ist sie {{FALSE}}, sind alle anderen Eigenschaften in dieser Gruppe, außer {{PropertyData/de|Extra Translation}} nicht anwendbar und werden ausgeblendet.<br />
* {{PropertyData/de|Align Mode|Enumeration}}: Legt das Ausrichtungsverfahren fest; zur Auswahl stehen {{Value|Original}}, {{Value|Frenet}} oder {{Value|Tangent}}.<br />
* {{PropertyData/de|End Offset|Length}}: Legt die Länge vom Ende des Pfades bis zur letzten Kopie fest. Muss kleiner sein als die Länge des Pfades abzüglich der {{PropertyData/de|Start Offset}}. {{Version/de|0.21}}<br />
* {{PropertyData/de|Extra Translation|VectorDistance}}: Legt einen zusätzlichen Versatz für jedes Element entlang des Pfades fest.<br />
* {{PropertyData/de|Force Vertical|Bool}}: Legt fest, ob die vorgegebene Ausrichtung der Normale mit dem Wert der {{PropertyData/de|Vertical Vector}} überschrieben wird. Wird nur verwendet, wenn die {{PropertyData/de|Align Mode}} auf {{Value|Original}} oder {{Value|Tangent}} gesetzt ist.<br />
* {{PropertyData/de|Start Offset|Length}}: Legt die Länge vom Startpunkt des Pfades bis zur ersten Kopie fest. Muss kleiner als die Länge des Pfades sein. {{Version/de|0.21}}<br />
* {{PropertyData/de|Tangent Vector|Vector}}: Legt den Ausrichtungsvektor fest. Wird nur verwendet, wenn die {{PropertyData/de|Align Mode}} auf {{Value|Tangent}} gesetzt ist.<br />
* {{PropertyData/de|Vertical Vector|Vector}}: Legt den Vektor zum Überschreiben der Richtung der Normale fest. Wird nur verwendet, wenn die {{PropertyData/de|Vertical Vector}} auf {{TRUE}} gesetzt ist.<br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
<span id="View"></span><br />
===Ansicht===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
Die Eigenschaften dieser Gruppe, mit Ausnahme der ererbten Eigenschaften, stehen nur für Verknüpfungsanordnungen zur Verfügung. Siehe [[Std_LinkMake/de#Eigenschaften|Std VerknüpfungErstellen]] für weitere Informationen.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
Die Eigenschaften in dieser Gruppe sind ererbte Eigenschaften. Siehe auch [[Part_Feature/de#Eigenschaften|Part Formelement]].<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
Die Eigenschaften dieser Gruppe werden nicht an Verknüpfungsanordnungen vererbt.<br />
<br />
<span id="Scripting"></span><br />
==Skripten==<br />
<br />
Siehe auch: [https://freecad.github.io/SourceDoc/ Autogenerierte API Dokumentation] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].<br />
<br />
Zum Erstellen einer Pfad-Anordnung wird die Methode {{incode|make_path_array}} des Draft-Moduls verwendet ({{Version/de|0.19}}). Diese Methode ersetzt die veraltete Methode {{incode|makePathArray}}.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} ist das Objekt, das angeordnet werden soll. Es kann auch die Benennung (die Zeichenkette {{incode|Label}}) eines Objekts im aktuellen Dokument sein.<br />
* {{incode|path_object}}: Ist das Pfadobjekt (path object). Es kann auch die Benennung (die Zeichenkette {{incode|Label}}) eines Objekts im aktuellen Dokument sein.<br />
* {{incode|count}} ist die Anzahl der Elemente einer Anordnung.<br />
* {{incode|extra}} ist ein Vektor, der jedes Element versetzt.<br />
* {{incode|subelements}} ist eine Liste von Kanten im {{incode|path_object}}, z.B. {{incode|["Edge1", "Edge2"]}}. Wenn vorhanden, werden nur diese Kanten für den Pfad verwendet.<br />
* Ist {{incode|align}} auf {{incode|True}} gestzt, werden die Elemente abhängig von der Eigenschaft {{incode|align_mode}}, die die Werte {{incode|"Original"}}, {{incode|"Frenet"}} oder {{incode|"Tangent"}} annehmen kann, entlang des Pfades ausgerichtet.<br />
* {{incode|tan_vector}} ist ein Einheitsvektor, der die örtliche Tangentenrichtung der Elemente entlang des Pfades festlegt. Er wird verwendet, wenn {{incode|align_mode}} auf {{incode|"Tangent"}} gesetzt ist.<br />
* Ist {{incode|force_vertical}} auf {{incode|True}} gsetzt, wird {{incode|vertical_vector}} für die lokale Z-Achse der Elemente entlang des Pfades verwendet. Es wird verwendet, wenn {{incode|align_mode}} auf {{incode|"Original"}} oder {{incode|"Tangent"}} gesetzt ist.<br />
* Ist {{incode|use_link}} auf {{incode|True}} gesetzt, werden [[App_Link/de|App-Links]] anstatt normaler Kopien erstellt.<br />
* {{incode|path_array}} wird mit der erstellten Anordnung zurückgegeben.<br />
<br />
Beispiel:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav/de<br />
|[[Draft_CircularArray/de|KreisAnordnung]]<br />
|[[Draft_PathLinkArray/de|PfadVerknüpfungsanordnung]]<br />
|[[Draft_Workbench/de|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/cs&diff=1388582Draft PathArray/cs2024-03-28T18:20:13Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/cs|Name=Draft PathArray|Name/cs=Kreslení TrasovéPole|Workbenches=[[Draft_Workbench/cs|Kreslení]], [[Arch_Workbench/cs|Architektura]]|MenuLocation=Draft → PathArray|SeeAlso=[[Draft Array/cs|Draft Array]] }}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Popis==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Nástroj TrasovéPole umístí vybraný tvar na vybranou trasu. Trasa může být drát nebo jedna nebo více hran. Tvary na trase mohou být volitelně zarovnány podle trasy. Podle potřeby může být specifikován Vektor pro posunutí tvaru tak, že těžiště tvaru bude na trase. Pokud není vybrán žádný objekt, budete vyzváni k jeho výběru.<br />
</div><br />
<br />
Both commands can be used on 2D objects created with the [[Draft_Workbench|Draft Workbench]] or [[Sketcher_Workbench|Sketcher Workbench]], but also on many 3D objects such as those created with the [[Part_Workbench|Part Workbench]], [[PartDesign_Workbench|PartDesign Workbench]] or [[Arch_Workbench|Arch Workbench]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PathArray}}<br />
<br />
<span id="Usage"></span><br />
<div class="mw-translate-fuzzy"><br />
==Použití==<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
# Vyberte objekt tvaru, který chcete kopírovat.<br />
# Vyberte objekt trasy, po které chcete tvar kopírovat -nebo-<br />
# Vyberte nějaké hrany pro určení trasy.<br />
# Stiskněte tlačítko {{KEY|[[Image:Draft_PathArray.png|16px]] [[Draft PathArray/cs|Kreslení TrasovéPole]]}}.<br />
</div><br />
<br />
==Alignment==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 arrays based on the same non-planar path. From left to right: Align is false, Align is true with Align Mode Original and Align is true with Align Mode Frenet}}.<br />
<br />
===Align Mode===<br />
<br />
Three modes are available:<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
====Tangent====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
<span id="Properties"></span><br />
==Vlastnosti==<br />
<br />
See also: [[property_editor|Property editor]].<br />
<br />
A Draft PathArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* {{PropertyData|Base}}: Objekt tvaru<br />
* {{PropertyData|PathObj}}: Objekt trasy<br />
* {{PropertyData|PathSubs}}: Subelementy(hrany) objektu trasy, které budou použity jako trasa <br />
* {{PropertyData|Count}}: Počet kopií tvaru<br />
* {{PropertyData|Xlate}}: Vektor posunutí<br />
* {{PropertyData|Align}}: Hodnota True pro zarovnání tvarů podle trasy, False pro ponechání tvarů podle jejich původní orientace.<br />
</div><br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
===View===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
The properties in this group are not inherited by Link arrays.<br />
<br />
==Scripting==<br />
<br />
<div class="mw-translate-fuzzy"><br />
==Skriptování==<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
Nástroj TrasovéPole může být využit v [[macros|makrech]] a z konzoly Pythonu použitím následující funkce:<br />
</div><br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* Rozloží požadovaný počet (count) kopií objektu shapeobject podél trasy pathobject nebo subobject (vybrané hrany) pathobjectu. Volitelně posune každou kopii ve směru a vzdálenosti podle FreeCAD.Vectoru pro nastavení rozdílu mezi středem tvaru a referenčním bodem tvaru. Volitelně zarovná baseobject tangenciálně/normálně/binormálně k trase.<br />
</div><br />
<br />
Příklad:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/ru&diff=1388581Draft PathArray/ru2024-03-28T18:20:11Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/ru<br />
|Name=Draft PathArray<br />
|Name/ru=Draft PathArray<br />
|MenuLocation=Черчение → Массив по направляющей<br />
|Workbenches=[[Draft_Workbench/ru|Draft]], [[Arch_Workbench/ru|Arch]]<br />
|SeeAlso=[[Draft Array/ru|Массив]] <br />
}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Draft_PathArray.svg|24px]] '''Draft PathArray''' command creates a regular array from a selected object by placing copies along a path. Use the [[Draft_PathLinkArray|Draft PathLinkArray]] command to create a more efficient [[App_Link|Link]] array instead. Except for the type of array that is created, Link array or regular array, the [[Draft_PathLinkArray|Draft PathLinkArray]] command is identical to this command.<br />
<br />
Both commands can be used on 2D objects created with the [[Draft_Workbench|Draft Workbench]] or [[Sketcher_Workbench|Sketcher Workbench]], but also on many 3D objects such as those created with the [[Part_Workbench|Part Workbench]], [[PartDesign_Workbench|PartDesign Workbench]] or [[Arch_Workbench|Arch Workbench]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PathArray}}<br />
<br />
==Usage==<br />
<br />
# Select the object you wish to array.<br />
# Add the path object to the selection. It is also possible to select edges instead. The edges must belong to the same object and they must be connected.<br />
# There are several ways to invoke the command:<br />
#* Press the {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray|Path array]]}} button.<br />
#* Select the {{MenuCommand|Modification → Array tools → [[Image:Draft_PathArray.svg|16px]] Path array}} option from the menu.<br />
# The array is created.<br />
# Optionally change the [[#Properties|properties]] of the array in the [[property_editor|Property editor]].<br />
<br />
==Alignment==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 arrays based on the same non-planar path. From left to right: Align is false, Align is true with Align Mode Original and Align is true with Align Mode Frenet}}.<br />
<br />
===Align Mode===<br />
<br />
Three modes are available:<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
====Tangent====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
==Properties==<br />
<br />
See also: [[property_editor|Property editor]].<br />
<br />
A Draft PathArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
* {{PropertyData|Align|Bool}}: specifies if the elements in the array are aligned along the path or not. If it is {{FALSE}} all other properties in this group, except {{PropertyData|Extra Translation}}, do not apply and are hidden.<br />
* {{PropertyData|Align Mode|Enumeration}}: specifies the align mode, which can be {{Value|Original}}, {{Value|Frenet}} or {{Value|Tangent}}.<br />
* {{PropertyData|End Offset|Length}}: specifies the length from the end of the path to the last copy. Must be smaller than the length of the path minus the {{PropertyData|Start Offset}}. {{Version|0.21}}<br />
* {{PropertyData|Extra Translation|VectorDistance}}: specifies an additional displacement for each element along the path.<br />
* {{PropertyData|Force Vertical|Bool}}: specifies whether to override the default normal direction with the value of {{PropertyData|Vertical Vector}}. Only used if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}.<br />
* {{PropertyData|Start Offset|Length}}: specifies the length from the start of the path to the first copy. Must be smaller than the length of the path. {{Version|0.21}}<br />
* {{PropertyData|Tangent Vector|Vector}}: specifies the alignment vector. Only used if {{PropertyData|Align Mode}} is {{Value|Tangent}}.<br />
* {{PropertyData|Vertical Vector|Vector}}: specifies the override for the default normal direction. Only used if {{PropertyData|Vertical Vector}} is {{TRUE}}.<br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
===View===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
The properties in this group are not inherited by Link arrays.<br />
<br />
==Scripting==<br />
<br />
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].<br />
<br />
To create a path array use the {{incode|make_path_array}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makePathArray}} method.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} is the object to be arrayed. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|path_object}} is the path object. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|count}} is the number of elements in the array.<br />
* {{incode|extra}} is a vector that displaces each element.<br />
* {{incode|subelements}} is a list of edges of {{incode|path_object}}, for example {{incode|["Edge1", "Edge2"]}}. If supplied only these edges are used for the path.<br />
* If {{incode|align}} is {{incode|True}} the elements are aligned along the path depending on the value of {{incode|align_mode}}, which can be {{incode|"Original"}}, {{incode|"Frenet"}} or {{incode|"Tangent"}}.<br />
* {{incode|tan_vector}} is a unit vector that defines the local tangent direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Tangent"}}.<br />
* If {{incode|force_vertical}} is {{incode|True}} {{incode|vertical_vector}} is used for the local Z direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Original"}} or {{incode|"Tangent"}}.<br />
* If {{incode|use_link}} is {{incode|True}} the created elements are [[App_Link|App Links]] instead of regular copies.<br />
* {{incode|path_array}} is returned with the created array object.<br />
<br />
Example:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/tr&diff=1388580Draft PathArray/tr2024-03-28T18:20:11Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/tr<br />
|Name=Draft PathArray<br />
|Name/tr=Yol dizisi<br />
|MenuLocation=Draft → PathArray<br />
|Workbenches=[[Draft_Workbench/tr|Draft]], [[Arch_Workbench/tr|Arch]]<br />
|SeeAlso=[[Draft Array/tr|Draft Array]]<br />
}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Draft_PathArray.svg|24px]] '''Draft PathArray''' command creates a regular array from a selected object by placing copies along a path. Use the [[Draft_PathLinkArray|Draft PathLinkArray]] command to create a more efficient [[App_Link|Link]] array instead. Except for the type of array that is created, Link array or regular array, the [[Draft_PathLinkArray|Draft PathLinkArray]] command is identical to this command.<br />
<br />
Both commands can be used on 2D objects created with the [[Draft_Workbench|Draft Workbench]] or [[Sketcher_Workbench|Sketcher Workbench]], but also on many 3D objects such as those created with the [[Part_Workbench|Part Workbench]], [[PartDesign_Workbench|PartDesign Workbench]] or [[Arch_Workbench|Arch Workbench]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PathArray}}<br />
<br />
==Usage==<br />
<br />
# Select the object you wish to array.<br />
# Add the path object to the selection. It is also possible to select edges instead. The edges must belong to the same object and they must be connected.<br />
# There are several ways to invoke the command:<br />
#* Press the {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray|Path array]]}} button.<br />
#* Select the {{MenuCommand|Modification → Array tools → [[Image:Draft_PathArray.svg|16px]] Path array}} option from the menu.<br />
# The array is created.<br />
# Optionally change the [[#Properties|properties]] of the array in the [[property_editor|Property editor]].<br />
<br />
==Alignment==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 arrays based on the same non-planar path. From left to right: Align is false, Align is true with Align Mode Original and Align is true with Align Mode Frenet}}.<br />
<br />
===Align Mode===<br />
<br />
Three modes are available:<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
====Tangent====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
==Properties==<br />
<br />
See also: [[property_editor|Property editor]].<br />
<br />
A Draft PathArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
* {{PropertyData|Align|Bool}}: specifies if the elements in the array are aligned along the path or not. If it is {{FALSE}} all other properties in this group, except {{PropertyData|Extra Translation}}, do not apply and are hidden.<br />
* {{PropertyData|Align Mode|Enumeration}}: specifies the align mode, which can be {{Value|Original}}, {{Value|Frenet}} or {{Value|Tangent}}.<br />
* {{PropertyData|End Offset|Length}}: specifies the length from the end of the path to the last copy. Must be smaller than the length of the path minus the {{PropertyData|Start Offset}}. {{Version|0.21}}<br />
* {{PropertyData|Extra Translation|VectorDistance}}: specifies an additional displacement for each element along the path.<br />
* {{PropertyData|Force Vertical|Bool}}: specifies whether to override the default normal direction with the value of {{PropertyData|Vertical Vector}}. Only used if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}.<br />
* {{PropertyData|Start Offset|Length}}: specifies the length from the start of the path to the first copy. Must be smaller than the length of the path. {{Version|0.21}}<br />
* {{PropertyData|Tangent Vector|Vector}}: specifies the alignment vector. Only used if {{PropertyData|Align Mode}} is {{Value|Tangent}}.<br />
* {{PropertyData|Vertical Vector|Vector}}: specifies the override for the default normal direction. Only used if {{PropertyData|Vertical Vector}} is {{TRUE}}.<br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
===View===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
The properties in this group are not inherited by Link arrays.<br />
<br />
==Scripting==<br />
<br />
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].<br />
<br />
To create a path array use the {{incode|make_path_array}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makePathArray}} method.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} is the object to be arrayed. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|path_object}} is the path object. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|count}} is the number of elements in the array.<br />
* {{incode|extra}} is a vector that displaces each element.<br />
* {{incode|subelements}} is a list of edges of {{incode|path_object}}, for example {{incode|["Edge1", "Edge2"]}}. If supplied only these edges are used for the path.<br />
* If {{incode|align}} is {{incode|True}} the elements are aligned along the path depending on the value of {{incode|align_mode}}, which can be {{incode|"Original"}}, {{incode|"Frenet"}} or {{incode|"Tangent"}}.<br />
* {{incode|tan_vector}} is a unit vector that defines the local tangent direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Tangent"}}.<br />
* If {{incode|force_vertical}} is {{incode|True}} {{incode|vertical_vector}} is used for the local Z direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Original"}} or {{incode|"Tangent"}}.<br />
* If {{incode|use_link}} is {{incode|True}} the created elements are [[App_Link|App Links]] instead of regular copies.<br />
* {{incode|path_array}} is returned with the created array object.<br />
<br />
Example:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/it&diff=1388579Draft PathArray/it2024-03-28T18:20:09Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav/it<br />
|[[Draft_CircularArray/it|Serie circolare]]<br />
|[[Draft_PathLinkArray/it|Serie di link su tracciato]]<br />
|[[Draft_Workbench/it|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{GuiCommand/it<br />
|Name=Draft_PathArray<br />
|Name/it=Serie su tracciato<br />
|MenuLocation=Modifiche → Strumenti serie → Serie su tracciato<br />
|Workbenches=[[Draft_Workbench/it|Draft]], [[Arch_Workbench/it|Arch]]<br />
|Version=0.14<br />
|SeeAlso=[[Draft_OrthoArray/it|Serie ortogonale]], [[Draft_PolarArray/it|Serie polare]], [[Draft_CircularArray/it|Serie circolare]], [[Draft_PathLinkArray/it|Serie di link su tracciato]], [[Draft_PointArray/it|Serie su punti]], [[Draft_PointLinkArray/it|Serie di link su punti]] <br />
}}<br />
<br />
<span id="Description"></span><br />
==Descrizione==<br />
<br />
Il comando [[Image:Draft_PathArray.svg|24px]] '''Serie su tracciato''' crea una serie (array) regolare da un oggetto selezionato posizionando copie lungo un percorso. Utilizzare invece il comando [[Draft_PathLinkArray/it|Serie di link su tracciato]] per creare una serie di [[App_Link/it|Link]] più efficiente. Fatta eccezione per il tipo di serie creato, Serie di link o Serie normale, il comando [[Draft_PathLinkArray/it|Serie di link su tracciato]] è identico a questo comando.<br />
<br />
Entrambi i comandi possono essere utilizzati su oggetti 2D creati con [[Draft_Workbench/it|Draft]] o [[Sketcher_Workbench/it|Sketcher]], ma anche su molti oggetti 3D come quelli creati con gli ambienti [[Part_Workbench/it|Part]], [[PartDesign_Workbench/it|PartDesign]] o [[Arch_Workbench/it|Arch]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Serie su tracciato}}<br />
<br />
<span id="Usage"></span><br />
==Utilizzo==<br />
<br />
# Selezionare l'oggetto che si desidera allineare.<br />
# Aggiungere l'oggetto tracciato alla selezione. È anche possibile selezionare invece dei bordi. I bordi devono appartenere allo stesso oggetto e devono essere collegati.<br />
# Esistono diversi modi per invocare il comando:<br />
#* Premere il pulsante {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray/it|Serie su tracciato]]}}.<br />
#* Selezionare l'opzione {{MenuCommand|Modifiche → Strumenti serie → [[Image:Draft_PathArray.svg|16px]] Serie su tracciato}} dal menu.<br />
# La serie viene creata.<br />
# Facoltativamente, modificare le [[#Proprietà|proprietà]] della serie nell'[[property_editor/it|Editor delle proprietà]].<br />
<br />
<span id="Alignment"></span><br />
==Allineamento==<br />
<br />
L'allineamento degli elementi in una Serie su tracciato dipende dalle proprietà della serie e dall'orientamento dell'oggetto sorgente. La posizione dell'oggetto sorgente viene ignorata: ai fini della serie {{Value|x}}, {{Value|y}} e {{Value|z}} sono impostati su {{Value|0}}. Se la proprietà {{PropertyData|Align}} della serie è impostata su {{FALSE}} l'orientamento degli elementi della serie è identico a quello dell'oggetto sorgente. Se è impostata su {{TRUE}}, l'asse X del sistema di coordinate locale di ciascun posizionamento dell'elemento è tangente al percorso. Gli assi Y e Z dei sistemi di coordinate locali dipendono dalla proprietà {{PropertyData|Align Mode}} della serie. Altre proprietà della serie coinvolte nell'allineamento includono {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} e {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 serie basate sullo stesso percorso non planare. Da sinistra a destra: Align è falso, Align è vero con Align Mode Original e Align è vero con Align Mode Frenet}}.<br />
<br />
<span id="Align_Mode"></span><br />
===Modalità allineamento===<br />
<br />
Sono disponibili tre modalità:<br />
<br />
<span id="Original"></span><br />
====Originale====<br />
<br />
Questa modalità si avvicina di più alla singola {{PropertyData|Align Mode}} disponibile nella versione 0.18. Si basa su un vettore normale fisso. Se il percorso è planare questo vettore è perpendicolare al piano del percorso, altrimenti viene utilizzato un vettore predefinito, l'asse Z positivo. Da questo vettore normale e dal vettore tangente locale (l'asse X locale) viene calcolato un [https://en.wikipedia.org/wiki/Cross_product cross product]. Questo nuovo vettore viene utilizzato come asse Z locale. L'orientamento dell'asse Y locale è determinato dagli assi X e Z locali.<br />
<br />
====Frenet====<br />
<br />
Questa modalità utilizza il vettore normale locale derivato dal percorso in corrispondenza di ciascun posizionamento dell'elemento. Se questo vettore non può essere determinato (ad esempio nel caso di un segmento retto) viene utilizzato un vettore predefinito, sempre l'asse Z positivo. Con questo vettore e il vettore tangente locale si determina il sistema di coordinate locale utilizzando la stessa procedura del paragrafo precedente.<br />
<br />
<span id="Tangent"></span><br />
====Tangente====<br />
<br />
Questa modalità è simile a {{PropertyData|Align Mode}} {{Value|Original}} ma include la possibilità di pre-ruotare l'oggetto sorgente specificando un {{PropertyData|Tangent Vector}}.<br />
<br />
<span id="Force_Vertical_and_Vertical_Vector"></span><br />
===Forza Verticale e Vettore Verticale===<br />
<br />
Queste proprietà sono disponibili solo se {{PropertyData|Align Mode}} è {{Value|Original}} o {{Value|Tangent}}. Se {{PropertyData|Force Vertical}} è impostato su {{TRUE}} il sistema di coordinate locale viene calcolato in modo diverso. Il {{PropertyData|Vertical Vector}} viene utilizzato come vettore normale fisso. Da questo vettore normale e dal vettore tangente locale (l'asse X locale) viene nuovamente calcolato un prodotto incrociato. Ma ora questo vettore è usato come asse Y locale. L'orientamento dell'asse Z locale è determinato dagli assi X e Y locali.<br />
<br />
L'utilizzo di queste proprietà può essere richiesto se uno degli spigoli del percorso è (quasi) parallelo alla normale predefinita del percorso.<br />
<br />
<span id="Properties"></span><br />
== Proprietà ==<br />
<br />
Vedere anche: [[Property_editor/it|Editor delle proprietà]].<br />
<br />
Un oggetto Serie su tracciato è derivato da un oggetto [[Part_Feature/it|Part Feature]] e ne eredita tutte le proprietà (ad eccezione di alcune proprietà View che non sono ereditate da Serie di Link). Le seguenti proprietà sono aggiuntive se non diversamente specificato:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
Le proprietà in questo gruppo sono disponibili solo per le serie di link. Vedere [[Std_LinkMake/it#Proprietà|Crea link]] per ulteriori informazioni.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
* {{PropertyData|Align|Bool}}: specifica se gli elementi nella serie sono allineati o meno lungo il percorso. Se è {{FALSE}} tutte le altre proprietà in questo gruppo, eccetto {{PropertyData|Extra Translation}}, non si applicano e sono nascoste.<br />
* {{PropertyData|Align Mode|Enumeration}}: specifica la modalità di allineamento, che può essere {{Value|Original}}, {{Value|Frenet}} o {{Value|Tangent}}.<br />
* {{PropertyData|End Offset|Length}}: specifica la lunghezza dalla fine del percorso all'ultima copia. Deve essere inferiore alla lunghezza del percorso meno {{PropertyData|Start Offset}}. {{Version/it|0.21}}<br />
* {{PropertyData|Extra Translation|VectorDistance}}: specifica uno spostamento aggiuntivo per ogni elemento lungo il percorso.<br />
* {{PropertyData|Force Vertical|Bool}}: specifica se sovrascrivere la direzione normale predefinita con il valore di {{PropertyData|Vertical Vector}}. Utilizzato solo se {{PropertyData|Align Mode}} è {{Value|Original}} o {{Value|Tangent}}.<br />
* {{PropertyData|Start Offset|Length}}: specifica la lunghezza dall'inizio del percorso alla prima copia. Deve essere inferiore alla lunghezza del percorso. {{Version/it|0.21}}<br />
* {{PropertyData|Tangent Vector|Vector}}: specifica il vettore di allineamento. Utilizzato solo se {{PropertyData|Align Mode}} è {{Value|Tangent}}.<br />
* {{PropertyData|Vertical Vector|Vector}}: specifica l'override per la direzione normale predefinita. Utilizzato solo se {{PropertyData|Vertical Vector}} è {{TRUE}}.<br />
<br />
{{TitleProperty|Objects}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* {{PropertyData|Base|LinkGlobal}}: specifica l'oggetto da duplicare nella serie.<br />
* {{PropertyData|Count|Integer}}: specifica il numero di elementi nella serie.<br />
* {{PropertyData|Expand Array|Bool}}: specifica se espandere la serie nella [[Tree_view/it|Vista ad albero]] per abilitare la selezione dei suoi singoli elementi. Disponibile solo per le serie di Link.<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifica l'oggetto da utilizzare per il percorso. Deve contenere {{Value|Edges}} nella sua [[Part_TopoShape/it|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifica un elenco di spigoli dell'{{PropertyData|Path Object}}. Se forniti solo questi bordi vengono utilizzati per il percorso.<br />
</div><br />
<br />
===View===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
Le proprietà in questo gruppo, ad eccezione della proprietà ereditata, sono disponibili solo per le serie di link. Vedere [[Std_LinkMake/it#Proprietà|Crea link]] per ulteriori informazioni.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: questa è una proprietà ereditata che appare nel gruppo Selezione per altre serie<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
Le proprietà in questo gruppo, ad eccezione della proprietà ereditata, sono disponibili solo per le serie di link. Vedere [[Std_LinkMake/it#Proprietà|Crea link]] per ulteriori informazioni.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: questa è una proprietà ereditata.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
Le proprietà in questo gruppo sono proprietà ereditate. Vedere [[Part_Feature#Properties|Part Feature]] per ulteriori informazioni.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: questa proprietà non è ereditata dalle serie di link.<br />
* {{PropertyView|Display Mode|Enumeration}}: per le serie di link può essere {{value|Link}} o {{value|ChildView}}. Per altre serie può essere: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} o {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
Le proprietà in questo gruppo non vengono ereditate dalle serie di link.<br />
<br />
<span id="Scripting"></span><br />
==Script==<br />
<br />
Vedere anche: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] e [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]].<br />
<br />
Per creare una serie su tracciato utilizzare il metodo {{incode|make_path_array}} ({{Version/it|0.19}}) del modulo Draft. Questo metodo sostituisce il metodo deprecato {{incode|makePathArray}}.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} è l'oggetto da disporre in serie. Può anche essere la {{incode|Label}} (string) di un oggetto nel documento corrente.<br />
* {{incode|path_object}} è l'oggetto percorso. Può anche essere la {{incode|Label}} (string) di un oggetto nel documento corrente.<br />
* {{incode|count}} è il numero di elementi nella serie.<br />
* {{incode|extra}} è un vettore che sposta ogni elemento.<br />
* {{incode|subelements}} è un elenco di bordi di {{incode|path_object}}, ad esempio {{incode|["Edge1", "Edge2"]}}. Se forniti solo questi bordi vengono utilizzati per il percorso.<br />
* Se {{incode|align}} è {{incode|True}} gli elementi sono allineati lungo il percorso a seconda del valore di {{incode|align_mode}}, che può essere {{incode|"Original"}}, {{incode|"Frenet"}} o {{incode|"Tangent"}}.<br />
* {{incode|tan_vector}} è un vettore unitario che definisce la direzione tangente locale degli elementi lungo il percorso. Viene utilizzato quando {{incode|align_mode}} è {{incode|"Tangent"}}.<br />
* Se {{incode|force_vertical}} è {{incode|True}} {{incode|vertical_vector}} viene utilizzato per la direzione Z locale degli elementi lungo il percorso. Viene utilizzato quando {{incode|align_mode}} è {{incode|"Original"}} o {{incode|"Tangent"}}.<br />
* Se {{incode|use_link}} è {{incode|True}} gli elementi creati sono [[App_Link/it|App Links]] invece di normali copie.<br />
* {{incode|path_array}} viene restituito con l'oggetto serie creato.<br />
<br />
Esempio:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav/it<br />
|[[Draft_CircularArray/it|Serie circolare]]<br />
|[[Draft_PathLinkArray/it|Serie di link su tracciato]]<br />
|[[Draft_Workbench/it|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/sv&diff=1388578Draft PathArray/sv2024-03-28T18:20:08Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/sv|Name=Draft PathArray|Name/sv=Draft PathArray|Workbenches=[[Draft_Workbench/sv|Draft]], [[Arch_Workbench/sv|Arch]]|MenuLocation=Draft → PathArray|SeeAlso=[[Draft Array/sv|Draft Array]] }}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Beskrivning==<br />
<br />
The [[Image:Draft_PathArray.svg|24px]] '''Draft PathArray''' command creates a regular array from a selected object by placing copies along a path. Use the [[Draft_PathLinkArray|Draft PathLinkArray]] command to create a more efficient [[App_Link|Link]] array instead. Except for the type of array that is created, Link array or regular array, the [[Draft_PathLinkArray|Draft PathLinkArray]] command is identical to this command.<br />
<br />
Both commands can be used on 2D objects created with the [[Draft_Workbench|Draft Workbench]] or [[Sketcher_Workbench|Sketcher Workbench]], but also on many 3D objects such as those created with the [[Part_Workbench|Part Workbench]], [[PartDesign_Workbench|PartDesign Workbench]] or [[Arch_Workbench|Arch Workbench]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PathArray}}<br />
<br />
<span id="Usage"></span><br />
<div class="mw-translate-fuzzy"><br />
==Bruk==<br />
</div><br />
<br />
# Select the object you wish to array.<br />
# Add the path object to the selection. It is also possible to select edges instead. The edges must belong to the same object and they must be connected.<br />
# There are several ways to invoke the command:<br />
#* Press the {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray|Path array]]}} button.<br />
#* Select the {{MenuCommand|Modification → Array tools → [[Image:Draft_PathArray.svg|16px]] Path array}} option from the menu.<br />
# The array is created.<br />
# Optionally change the [[#Properties|properties]] of the array in the [[property_editor|Property editor]].<br />
<br />
==Alignment==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 arrays based on the same non-planar path. From left to right: Align is false, Align is true with Align Mode Original and Align is true with Align Mode Frenet}}.<br />
<br />
===Align Mode===<br />
<br />
Three modes are available:<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
====Tangent====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
==Properties==<br />
<br />
See also: [[property_editor|Property editor]].<br />
<br />
A Draft PathArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
* {{PropertyData|Align|Bool}}: specifies if the elements in the array are aligned along the path or not. If it is {{FALSE}} all other properties in this group, except {{PropertyData|Extra Translation}}, do not apply and are hidden.<br />
* {{PropertyData|Align Mode|Enumeration}}: specifies the align mode, which can be {{Value|Original}}, {{Value|Frenet}} or {{Value|Tangent}}.<br />
* {{PropertyData|End Offset|Length}}: specifies the length from the end of the path to the last copy. Must be smaller than the length of the path minus the {{PropertyData|Start Offset}}. {{Version|0.21}}<br />
* {{PropertyData|Extra Translation|VectorDistance}}: specifies an additional displacement for each element along the path.<br />
* {{PropertyData|Force Vertical|Bool}}: specifies whether to override the default normal direction with the value of {{PropertyData|Vertical Vector}}. Only used if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}.<br />
* {{PropertyData|Start Offset|Length}}: specifies the length from the start of the path to the first copy. Must be smaller than the length of the path. {{Version|0.21}}<br />
* {{PropertyData|Tangent Vector|Vector}}: specifies the alignment vector. Only used if {{PropertyData|Align Mode}} is {{Value|Tangent}}.<br />
* {{PropertyData|Vertical Vector|Vector}}: specifies the override for the default normal direction. Only used if {{PropertyData|Vertical Vector}} is {{TRUE}}.<br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
===View===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
The properties in this group are not inherited by Link arrays.<br />
<br />
==Scripting==<br />
<br />
<div class="mw-translate-fuzzy"><br />
==Skript==<br />
</div><br />
<br />
To create a path array use the {{incode|make_path_array}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makePathArray}} method.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} is the object to be arrayed. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|path_object}} is the path object. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|count}} is the number of elements in the array.<br />
* {{incode|extra}} is a vector that displaces each element.<br />
* {{incode|subelements}} is a list of edges of {{incode|path_object}}, for example {{incode|["Edge1", "Edge2"]}}. If supplied only these edges are used for the path.<br />
* If {{incode|align}} is {{incode|True}} the elements are aligned along the path depending on the value of {{incode|align_mode}}, which can be {{incode|"Original"}}, {{incode|"Frenet"}} or {{incode|"Tangent"}}.<br />
* {{incode|tan_vector}} is a unit vector that defines the local tangent direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Tangent"}}.<br />
* If {{incode|force_vertical}} is {{incode|True}} {{incode|vertical_vector}} is used for the local Z direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Original"}} or {{incode|"Tangent"}}.<br />
* If {{incode|use_link}} is {{incode|True}} the created elements are [[App_Link|App Links]] instead of regular copies.<br />
* {{incode|path_array}} is returned with the created array object.<br />
<br />
Example:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/es&diff=1388577Draft PathArray/es2024-03-28T18:20:07Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/es<br />
|Name=Draft PathArray<br />
|Name/es=Draft PathArray<br />
|MenuLocation=Draft → PathArray<br />
|Workbenches=[[Draft_Workbench/es|Draft]], [[Arch_Workbench/es|Arch]]<br />
|SeeAlso=[[Draft Array/es|Draft Array]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Descripción==<br />
<br />
<div class="mw-translate-fuzzy"><br />
La herramienta PathArray coloca copias de una forma seleccionada a lo largo de una ruta seleccionada. La ruta puede ser un alambre o uno o más bordes. Las formas pueden alinearse opcionalmente con la tangente del camino. Si es necesario, se puede especificar un vector de translación para cambiar las formas de modo que el centroide esté en la ruta. Si no se seleccionan objetos, se le invitará a seleccionarlos.<br />
</div><br />
<br />
Both commands can be used on 2D objects created with the [[Draft_Workbench|Draft Workbench]] or [[Sketcher_Workbench|Sketcher Workbench]], but also on many 3D objects such as those created with the [[Part_Workbench|Part Workbench]], [[PartDesign_Workbench|PartDesign Workbench]] or [[Arch_Workbench|Arch Workbench]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PathArray}}<br />
<br />
<span id="Usage"></span><br />
<div class="mw-translate-fuzzy"><br />
==Como utilizar==<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
# Crea un objeto de forma que desees distribuir. Obtendrá los mejores resultados si su objeto está centrado en el origen, incluso si la ruta comienza en otro lugar.<br />
# Seleccione un objeto de ruta a lo largo del cual se distribuirán las formas. -o-<br />
# Seleccione algunos bordes de un objeto de ruta.<br />
# Presiona el botón {{KEY|[[Image:Draft_PathArray.png|16px]] [[Draft PathArray]]}} .<br />
</div><br />
<br />
==Alignment==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 arrays based on the same non-planar path. From left to right: Align is false, Align is true with Align Mode Original and Align is true with Align Mode Frenet}}.<br />
<br />
===Align Mode===<br />
<br />
Three modes are available:<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
====Tangent====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
<span id="Properties"></span><br />
==Propiedades==<br />
<br />
See also: [[property_editor|Property editor]].<br />
<br />
A Draft PathArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* {{PropertyData|Base}}: El objeto de forma<br />
* {{PropertyData|PathObj}}: El objeto de ruta<br />
* {{PropertyData|PathSubs}}: los subelementos (bordes) del objeto de ruta que se usará como ruta<br />
* {{PropertyData|Count}}: la cantidad de tiempo para copiar la forma<br />
* {{PropertyData|Xlate}}: El vector de traducción<br />
* {{PropertyData|Align}}: True para alinear las formas con la ruta, False para dejar las formas en su orientación predeterminada.<br />
</div><br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
===View===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
The properties in this group are not inherited by Link arrays.<br />
<br />
==Scripting==<br />
<br />
<div class="mw-translate-fuzzy"><br />
==Programación==<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
La herramienta PathArray puede usarse en [[macros/es|macros]] y desde la consola de Python utilizando la siguiente función:<br />
</div><br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* Distribuir recuento de copias de un objeto de forma de documento a lo largo de un objeto de ruta o subobjetos de un objeto de ruta. Opcionalmente, traduce cada copia por FreeCAD.Vector xlate la dirección y la distancia para ajustar la diferencia entre el centro de la forma y el punto de referencia de la forma. Opcionalmente alinea el objeto base con la tangente / normal / binormal de la ruta.<br />
</div><br />
<br />
Ejemplo:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/pl&diff=1388576Draft PathArray/pl2024-03-28T18:20:06Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav/pl<br />
|[[Draft_CircularArray/pl|Szyk kołowy]]<br />
|[[Draft_PathLinkArray/pl|Szyk powiązań po ścieżce]]<br />
|[[Draft_Workbench/pl|środowisko pracy Rysunek Roboczy]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{GuiCommand/pl<br />
|Name=Draft PathArray<br />
|Name/pl=Rysunek Roboczy: Szyk po ścieżce<br />
|MenuLocation=Modyfikacja → Narzędzia szyku → Szyk po ścieżce<br />
|Workbenches=[[Draft_Workbench/pl|Rysunek Roboczy]], [[Arch_Workbench/pl|Architektura]]<br />
|Version=0.14<br />
|SeeAlso=[[Draft_OrthoArray/pl|Szyk ortogonalny]], [[Draft_PolarArray/pl|Szyk biegunowy]], [[Draft_CircularArray/pl|Szyk kołowy]], [[Draft_PathLinkArray/pl|Szyk powiązań po ścieżce]], [[Draft_PointArray/pl|Szyk z punktów]], [[Draft_PointLinkArray/pl|Szyk powiązań w punktach]]<br />
}}<br />
<br />
<span id="Description"></span><br />
==Opis==<br />
<br />
Polecenie [[Image:Draft_PathArray.svg|24px]] '''Szyk po ścieżce''' tworzy zwykły szyk z wybranego obiektu przez umieszczenie kopii wzdłuż ścieżki. Zamiast tego użyj polecenia [[Draft_PathLinkArray/pl|Szyk powiązań po ścieżce]], aby utworzyć bardziej wydajny szyk [[App_Link|powiązań]]. Z wyjątkiem typu utworzonych szyków ''(szyk powiązań lub zwykły szyk)'', polecenie [[Draft_PathLinkArray/pl|Szyk powiązań po ścieżce]] jest identyczne z tym poleceniem.<br />
<br />
Oba polecenia mogą być używane na obiektach 2D utworzonych za pomocą środowisk pracy [[Draft_Workbench/pl|Rysunek Roboczy]] lub [[Sketcher_Workbench/pl|Szkicownik]], ale można ich również użyć dla wielu typów obiektów 3D, takich jak te utworzone za pomocą środowisk pracy [[Part_Workbench/pl|Część]], [[PartDesign_Workbench/pl|Projekt Części]] lub [[Arch_Workbench/pl|Architektura]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Szyk po ścieżce}}<br />
<br />
<span id="Usage"></span><br />
==Użycie==<br />
<br />
# Wybierz obiekt, który chcesz wyświetlić.<br />
# Dodaj obiekt ścieżki do zaznaczenia. Zamiast tego można również wybrać krawędzie. Krawędzie muszą należeć do tego samego obiektu i muszą być połączone.<br />
# Polecenie można wywołać na kilka sposobów:<br />
#* Naciśnij przycisk {{Button|[[Image:Draft_PathArray.svg|16px]] '''Szyk po ścieżce'''}}.<br />
#* Wybierz opcję z menu {{MenuCommand|Modyfikacja → Narzędzia szyku → [[Image:Draft_PathArray.svg|16px]] Szyk po ścieżce}}.<br />
# Szyk zostanie utworzony.<br />
# Opcjonalnie można zmienić [[#Właściwości|właściwości]] szyku w [[Property_editor/pl|edytorze właściwości]].<br />
<br />
<span id="Alignment"></span><br />
==Wyrównanie==<br />
<br />
Wyrównanie elementów w Szyk po ścieżce zależy od właściwości szyku i orientacji obiektu źródłowego. Pozycja obiektu źródłowego jest ignorowana: dla celów szyku wartości {{Value|x}}, {{Value|y}} i {{Value|z}} są ustawione na {{Value|0}}. Jeśli właściwość {{PropertyData|Wyrównaj}} szyku jest ustawiona na wartość {{FALSE/pl}}, orientacja elementów szyku jest identyczna z orientacją obiektu źródłowego. Jeśli jest ustawiona na {{TRUE/pl}}, oś X lokalnego układu współrzędnych każdego umieszczonego elementu jest styczna do ścieżki. Osie Y i Z lokalnych układów współrzędnych zależą od właściwości {{PropertyData|Tryb wyrównania}} szyku. Inne właściwości szyku związane z wyrównaniem obejmują: {{PropertyData|Wektor styczny}}, {{PropertyData|Wymuś pionowo}} i {{PropertyData|Wektor pionowy}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|Trzy szyki oparte na tej samej nieplanarnej ścieżce. Od lewej do prawej: Wyrównanie ustawiono na {{false/pl}}, Wyrównanie ustawiono na {{true/pl}} z trybem wyrównania Original i Wyrównaj ustawiono na {{true/pl}} z trybem wyrównania Frenet.}}.<br />
<br />
<span id="Align_Mode"></span><br />
===Tryb wyrównania===<br />
<br />
Dostępne są trzy tryby:<br />
<br />
====Original====<br />
<br />
Ten tryb jest najbardziej zbliżony do pojedynczego {{PropertyData|Tryb wyrównania}} dostępnego w wersji 0.18. Opiera się on na stałym wektorze normalnym. Jeśli ścieżka jest płaska, wektor ten jest prostopadły do płaszczyzny ścieżki, w przeciwnym razie używany jest wektor domyślny, o dodatniej osi Z. Na podstawie tego wektora normalnego i lokalnego wektora stycznego ''(lokalna oś X)'' obliczany jest [https://en.wikipedia.org/wiki/Cross_product iloczyn krzyżowy]. Ten nowy wektor jest używany jako lokalna oś Z. Orientacja lokalnej osi Y jest określana na podstawie lokalnych osi X i Z.<br />
<br />
====Frenet====<br />
<br />
Tryb ten wykorzystuje lokalny wektor normalny wyprowadzony ze ścieżki przy każdym umieszczeniu elementu. Jeśli nie można określić tego wektora ''(na przykład w przypadku odcinka prostego)'', zamiast niego używany jest wektor domyślny, ponownie dodatnia oś Z. Za pomocą tego wektora i lokalnego wektora stycznego lokalny układ współrzędnych jest określany przy użyciu tej samej procedury, co w poprzednim akapicie.<br />
<br />
<span id="Tangent"></span><br />
===Styczna===<br />
<br />
Tryb ten jest podobny do {{PropertyData|Trybu wyrównania}} {{Value|Original}}, ale obejmuje możliwość wstępnego obrócenia obiektu źródłowego poprzez określenie {{PropertyData|Wektora stycznej}}.<br />
<br />
<span id="Force_Vertical_and_Vertical_Vector"></span><br />
===Wymuś pionowo i Wektor pionowy===<br />
<br />
Właściwości te są dostępne tylko wtedy, gdy {{PropertyData|Tryb wyrównania}} ma wartość {{Value|Original}} lub {{Value|Styczny}}. Jeśli właściowść {{PropertyData|Wymuś pionowo}} jest ustawione na {{TRUE/pl}}, lokalny układ współrzędnych jest obliczany w inny sposób. {{PropertyData|Wektor pionowy}} jest używany jako stały wektor normalny. Z tego wektora normalnego i lokalnego wektora stycznego ''(lokalna oś X)'' ponownie obliczany jest iloczyn krzyżowy. Ale teraz ten wektor jest używany jako lokalna oś Y. Orientacja lokalnej osi Z jest określana na podstawie lokalnych osi X i Y.<br />
<br />
Użycie tych właściwości może być wymagane, jeśli jedna z krawędzi ścieżki jest ''(prawie)'' równoległa do domyślnej normalnej ścieżki.<br />
<br />
<span id="Properties"></span><br />
==Właściwości==<br />
<br />
Zobacz również stronę: [[Property_editor/pl|Edytor właściwości]].<br />
<br />
Obiekt Szyk po ścieżce środowiska Rysunek Roboczy wywodzi się z obiektu [[Part_Feature/pl|Część: Cecha]] i dziedziczy wszystkie jego właściwości ''(z wyjątkiem niektórych właściwości Widoku, które nie są dziedziczone przez szyki Łączy)''. Poniższe właściwości są dodatkowe, chyba że zaznaczono inaczej:<br />
<br />
<span id="Data"></span><br />
===Dane===<br />
<br />
{{TitleProperty|Łącze}}<br />
<br />
Właściwości w tej grupie są dostępne tylko dla szyków łączy. Więcej informacji można znaleźć na stronie [[Std_LinkMake/pl#Właściwości|Std: Utwórz łącze]].<br />
<br />
* {{PropertyData|Skala|Float}}<br />
* {{PropertyData|Wektor skali|Vector|Ukryte}}.<br />
* {{PropertyData|Lista skali|VectorList}}<br />
* {{PropertyData|Lista widoczności|BoolList|Ukryte}}<br />
* {{PropertyData|Lista umiejscowienia|PlacementList|Ukryte}}<br />
* {{PropertyData|Lista elementów|LinkList|Ukryte}}<br />
* {{PropertyData|_ Link Touched|Bool|Ukryte}}<br />
* {{PropertyData|_ Child Cache|LinkList|Ukryte}}<br />
* {{PropertyData|Elementy kolorowe|LinkSubHidden|Ukryte}}<br />
* {{PropertyData|Przekształcenie łącza|Bool}}<br />
<br />
{{TitleProperty|Wyrównanie}}<br />
<br />
* {{PropertyData|Wyrównaj|Bool}}: określa, czy elementy w tablicy są wyrównane wzdłuż ścieżki, czy nie. Jeśli ma wartość {{FALSE/pl}}, wszystkie inne właściwości w tej grupie, z wyjątkiem {{PropertyData|Dodatkowe przesunięcie}}, nie mają zastosowania i są ukryte.<br />
* {{PropertyData|Tryb wyrównania|Enumeration}}: określa tryb wyrównania, który może być {{Value|Original}}, {{Value|Frenet}} lub {{Value|Stycznie}}.<br />
* {{PropertyData|Koniec odsunięcia|Length}}: określa długość od końca ścieżki do ostatniej kopii. Musi być mniejsza niż długość ścieżki minus {{PropertyData|Początek odsunięcia}}. {{Version/pl|0.21}}<br />
* {{PropertyData|Dodatkowe przesunięcie|VectorDistance}}: określa dodatkowe przemieszczenie dla każdego elementu wzdłuż ścieżki.<br />
* {{PropertyData|Wymuś pionowo|Bool}}: określa, czy zastąpić domyślny kierunek normalny wartością {{PropertyData|Wektor pionowy}}. Używane tylko jeśli {{PropertyData|Tryb wyrównania}} ma wartość {{Value|Original}} lub {{Value|Styczna}}.<br />
* {{PropertyData|Przesunięcie początkowe|Length}}: określa długość od początku ścieżki do pierwszej kopii. Musi być mniejsza niż długość ścieżki. {{Version/pl|0.21}}<br />
* {{PropertyData|Wektor styczny|Vector}}: określa wektor wyrównania. Używane tylko jeśli {{PropertyData|Tryb wyrównania}} jest {{Value|Styczna}}.<br />
* {{PropertyData|Wektor pionowy|Vector}}: określa nadpisanie domyślnego kierunku normalnego. Używane tylko jeśli właściwość {{PropertyData|Wektor pionowy}} ma wartość {{TRUE/pl}}.<br />
<br />
{{TitleProperty|Obiekty}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* {{PropertyData|Baza|LinkGlobal}}: określa obiekt do powielenia w szyku.<br />
* {{PropertyData|Ilość|Integer}}: określa liczbę elementów w szyku.<br />
* {{PropertyData|Rozwiń szyk|Bool}}: określa, czy tablica ma zostać rozwinięta w [[Tree_view/pl|widoku drzewa]], aby umożliwić wybór jej poszczególnych elementów. Dostępne tylko dla szyków łączy.<br />
* {{PropertyData|Obiekt ścieżki|LinkGlobal}}: określa obiekt, który ma być użyty dla ścieżki. Musi zawierać {{Value|Krawędzie}} w swoim [[Part_TopoShape/pl|kształcie topologicznym]].<br />
* {{PropertyData|Elementy podżędne ścieżki|LinkSubListGlobal}}: określa listę krawędzi {{PropertyData|Obiektu ścieżki}}. Jeśli zostanie podana, tylko te krawędzie są używane dla ścieżki.<br />
</div><br />
<br />
<span id="View"></span><br />
===Widok===<br />
<br />
{{TitleProperty|Łącze}}<br />
<br />
Właściwości w tej grupie, z wyjątkiem właściwości dziedziczonej, są dostępne tylko dla szyków łączy. Więcej informacji można znaleźć na stronie [[Std_LinkMake/pl#Właściwości|Std: Utwórz łącze]].<br />
<br />
* {{PropertyView|Styl kreślenia|Enumeration}}<br />
* {{PropertyView|Szerokość linii|FloatConstraint}}<br />
* {{PropertyView|Nadpisanie materiału|Bool}}<br />
* {{PropertyView|Rozmiar punktu|FloatConstraint}}<br />
* {{PropertyView|Wybieralny|Bool}}: jest to właściwość dziedziczona, która pojawia się w grupie "Wybór" dla innych szyków.<br />
* {{PropertyView|Kształt materiału|Material}}.<br />
<br />
{{TitleProperty|Podstawa}}<br />
<br />
Właściwości w tej grupie, z wyjątkiem właściwości dziedziczonej, są dostępne tylko dla szyków łączy. Więcej informacji można znaleźć na stronie [[Std_LinkMake/pl#Właściwości|Std: Utwórz łącze]].<br />
<br />
* {{PropertyView|Dostawca widoku elementu podrzędnego|PersistentObject|Ukryte}}.<br />
* {{PropertyView|Lista materiałów|MaterialList|Ukryte}}<br />
* {{PropertyView|Zastąp listę kolorów|ColorList|Ukryte}}<br />
* {{PropertyView|Zastąp listę materiałów|BoolList|Ukryte}}<br />
* {{PropertyView|Proxy|PythonObject|Ukryte}}: jest to właściwość dziedziczona.<br />
<br />
{{TitleProperty|Opcje wyświetlania}}<br />
<br />
Właściwości w tej grupie są dziedziczone. Więcej informacji można znaleźć na stronie [[Part_Feature/pl#Własności|Część: Cecha]].<br />
<br />
* {{PropertyView|Ramka otaczająca|Bool}}: ta właściwość nie jest dziedziczona przez szyk łączy.<br />
* {{PropertyView|Tryb wyświetlania|Enumeration}}: dla szyku Łączy może to być {{value|Link}} lub {{value|ChildView}}. Dla innych szyków może to być: {{value|Cieniowany z krawędziami}}, {{value|Cieniowany}}, {{value|Szkieletowy}} lub {{value|Punkty}}.<br />
* {{PropertyView|Pokaż w drzewie|Bool}}<br />
* {{PropertyView|Widoczność|Bool}}<br />
<br />
{{TitleProperty|Rysunek Roboczy}}<br />
<br />
* {{PropertyView|Wzór|Enumeration}}: niewykorzystane.<br />
* {{PropertyView|Rozmiar wzoru|Float}}: niewykorzystane.<br />
<br />
{{TitleProperty|Styl obiektu}}<br />
<br />
Właściwości w tej grupie nie są dziedziczone przez szyk łączy.<br />
<br />
<span id="Scripting"></span><br />
==Tworzenie skryptów==<br />
<br />
Zobacz również stronę: [https://freecad.github.io/SourceDoc/ Dokumentacja API generowana automatycznie] oraz [[FreeCAD_Scripting_Basics/pl|Podstawy pisania skryptów dla FreeCAD]].<br />
<br />
Aby utworzyć Szyk po ścieżce, należy użyć metody {{incode|make_path_array}} ({{Version/pl|0.19}}) modułu Rysunek Roboczy. Metoda ta zastępuje przestarzałą metodę {{incode|makePathArray}}.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} jest obiektem, który ma być użyty w szyku. Może to być również {{incode|Etykieta}} ''(ciąg znaków)'' obiektu w bieżącym dokumencie.<br />
* {{incode|obiekt_ścieżki}} jest obiektem ścieżki. Może to być również {{incode|Etykieta}} ''(ciąg znaków)'' obiektu w bieżącym dokumencie.<br />
* {{incode|Ilość}} jest liczbą elementów w tablicy.<br />
* {{incode|extra}} jest wektorem, który przesuwa każdy element.<br />
* {{incode|Element podrzędny}} jest listą krawędzi {{incode|obiekt_ścieżki}}, na przykład {{incode|["Edge1", "Edge2"]}}. Jeśli zostanie podana, tylko te krawędzie są używane dla ścieżki.<br />
* Jeśli {{incode|Wyrównaj}} ma wartość {{True/pl}}, elementy są wyrównywane wzdłuż ścieżki w zależności od wartości właściwości {{incode|tryb_wyrównania}}, która może mieć wartość {{incode|"Original"}}, {{incode|"Frenet"}} lub {{incode|"Styczna"}}.<br />
* {{incode|tan_vector}} jest wektorem jednostkowym, który definiuje lokalny kierunek styczny elementów wzdłuż ścieżki. Jest on używany, gdy właściwość {{incode|tryb_wyrównania}} ma wartość {{incode|"Styczna"}}.<br />
* Jeśli {{incode|Wymuś_pionowo}} ma wartość {{True/pl}}, {{incode|vertical_vector}} jest używany dla lokalnego kierunku Z elementów wzdłuż ścieżki. Jest on używany, gdy właściwość {{incode|tryb_wyrównania}} ma wartość {{incode|"Original"}} lub {{incode|"Styczna"}}.<br />
* Jeśli {{incode|użyj_łaczy}} ma wartość {{True/pl}}, utworzone elementy są obiektami [[App_Link/pl|App: Łącze]] zamiast zwykłych kopii.<br />
* {{incode|Szyk_ścieżki}} jest zwracany wraz z utworzonym obiektem szyku.<br />
<br />
Przykład:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav/pl<br />
|[[Draft_CircularArray/pl|Szyk kołowy]]<br />
|[[Draft_PathLinkArray/pl|Szyk powiązań po ścieżce]]<br />
|[[Draft_Workbench/pl|Środowisko pracy Rysunek Roboczy]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/fr&diff=1388575Draft PathArray/fr2024-03-28T18:20:06Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav/fr<br />
|[[Draft_CircularArray/fr|Réseau circulaire]]<br />
|[[Draft_PathLinkArray/fr|Réseau lié selon une courbe]]<br />
|[[Draft_Workbench/fr|Atelier Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{GuiCommand/fr<br />
|Name=Draft PathArray<br />
|Name/fr=Draft Réseau selon une courbe<br />
|MenuLocation=Modification → Outils pour les réseaux → Réseau selon une courbe<br />
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]<br />
|Version=0.14<br />
|SeeAlso=[[Draft_OrthoArray/fr|Draft Réseau orthogonal]], [[Draft_PolarArray/fr|Draft Réseau polaire]], [[Draft_CircularArray/fr|Draft Réseau circulaire]], [[Draft_PathLinkArray/fr|Draft Réseau lié selon une courbe]], [[Draft_PointArray/fr|Draft Réseau de points]], [[Draft_PointLinkArray/fr|Draft Réseau lié selon des points]]<br />
}}<br />
<br />
==Description==<br />
<br />
La commande [[Image:Draft_PathArray.svg|24px]] '''Draft Réseau selon une courbe''' crée un réseau régulier à partir d'un objet sélectionné en plaçant des copies le long d'un chemin. Utilisez la commande [[Draft_PathLinkArray/fr|Draft Réseau lié selon une courbe]] pour créer un réseau [[App_Link/fr|Link]] plus efficace à la place. À l'exception du type de réseau créé, réseau de liens ou réseau régulier, la commande [[Draft_PathLinkArray/fr|Draft Réseau lié selon une courbe]] est identique à cette commande.<br />
<br />
Ces deux commandes peuvent être utilisées sur des objets 2D créés avec l'[[Draft_Workbench/fr|atelier Draft]] ou l'[[Sketcher_Workbench/fr|atelier Sketcher]], mais aussi sur de nombreux objets 3D tels que ceux créés avec l'[[Part_Workbench/fr|atelier Part]], l'[[PartDesign_Workbench/fr|atelier PartDesign]] ou l'[[Arch_Workbench/fr|atelier Arch]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Un Draft réseau selon une courbe}}<br />
<br />
<span id="Usage"></span><br />
==Utilisation==<br />
<br />
# Sélectionner l'objet que vous souhaitez mettre en réseau.<br />
# Ajouter l'objet trajectoire à la sélection. Il est également possible de sélectionner des arêtes à la place. Les arêtes doivent appartenir au même objet et doivent être connectées.<br />
# Il existe plusieurs façons de lancer la commande :<br />
#* Appuyer sur le {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray/fr|Réseau selon une courbe]]}}.<br />
#* Sélectionner l'option {{MenuCommand|Modification → Outils pour les réseaux → [[Image:Draft_PathArray.svg|16px]] Réseau selon une courbe}} du menu.<br />
# Le réseau est créé.<br />
# Vous pouvez éventuellement modifier les [[#Propri.C3.A9t.C3.A9s|propriétés]] du réseau dans l'[[Property_editor/fr|éditeur de propriétés]].<br />
<br />
<span id="Alignment"></span><br />
==Alignement==<br />
<br />
L'alignement des éléments d'un Draft Réseau selon une courbe dépend des propriétés du réseau et de l'orientation de l'objet source. La position de l'objet source est ignorée : pour les besoins du réseau, les valeurs {{Value|x}}, {{Value|y}} et {{Value|z}} sont fixées à {{Value|0}}. Si la propriété {{PropertyData|Align}} du réseau est définie à {{FALSE}}, l'orientation des éléments du réseau est identique à celle de l'objet source. Si elle a pour valeur {{TRUE}}, l'axe X du système de coordonnées local de chaque élément placé est tangent à la trajectoire. Les axes Y et Z des systèmes de coordonnées locaux dépendent de la propriété {{PropertyData|Align Mode}} du réseau. Les autres propriétés du réseau impliquées dans l'alignement comprennent {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} et {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 réseaux basés sur la même courbe non planaire.<br>De gauche à droite : Align est false, Align à true pour Align Mode Original et Align à true pour Align Mode Frenet.}}.<br />
<br />
<span id="Align_Mode"></span><br />
===Mode d'alignement===<br />
<br />
Trois modes sont disponibles :<br />
<br />
====Original====<br />
<br />
Ce mode se rapproche le plus du mode unique {{PropertyData|Align Mode}} disponible dans la version 0.18. Il s'appuie sur un vecteur normal fixe. Si le chemin est planaire, ce vecteur est perpendiculaire au plan du chemin, sinon un vecteur par défaut, l'axe Z positif, est utilisé. À partir de ce vecteur normal et du vecteur tangent local (l'axe X local), un [https://fr.wikipedia.org/wiki/Produit_vectoriel produit vectoriel] est calculé. Ce nouveau vecteur est utilisé comme axe Z local. L'orientation de l'axe Y local est déterminée à partir des axes X et Z locaux.<br />
<br />
====Frenet====<br />
<br />
Ce mode utilise le vecteur normal local dérivé de la trajectoire à chaque placement d'élément. Si ce vecteur ne peut pas être déterminé (par exemple dans le cas d'un segment droit), un vecteur par défaut, toujours l'axe Z positif, est utilisé à la place. Avec ce vecteur et le vecteur tangent local, le système de coordonnées local est déterminé en utilisant la même procédure que dans le paragraphe précédent.<br />
<br />
====Tangent====<br />
<br />
Ce mode est similaire à {{PropertyData|Align Mode}}. {{Value|Original}} mais offre la possibilité de pré-rotation de l'objet source en spécifiant un {{PropertyData|Tangent Vector}}.<br />
<br />
<span id="Force_Vertical_and_Vertical_Vector"></span><br />
===Force Vertical et Vertical Vector===<br />
<br />
Ces propriétés ne sont disponibles que si {{PropertyData|Align Mode}} est {{Value|Original}} ou {{Value|Tangent}}. Si {{PropertyData|Force Vertical}} est défini sur {{TRUE}}, le système de coordonnées local est calculé d'une manière différente. {{PropertyData|Vertical Vector}} est utilisé comme vecteur normal fixe. Un produit vectoriel est à nouveau calculé à partir de ce vecteur normal et du vecteur tangent local (l'axe X local). Mais ce vecteur est maintenant utilisé comme l'axe Y local. L'orientation de l'axe Z local est déterminée à partir des axes X et Y locaux.<br />
<br />
L'utilisation de ces propriétés peut être nécessaire si l'un des bords du chemin est (presque) parallèle à la normale par défaut du chemin.<br />
<br />
<span id="Properties"></span><br />
==Propriétés==<br />
<br />
Voir aussi: [[Property_editor/fr|Éditeur de propriétés]]<br />
<br />
Un objet Draft Réseau selon une courbe est dérivé d'un objet [[Part_Feature/fr|Part Feature]] et hérite de toutes ses propriétés (à l'exception de certaines propriétés Vue qui ne sont pas héritées par les réseaux Link). Les propriétés suivantes sont supplémentaires, sauf indication contraire :<br />
<br />
<span id="Data"></span><br />
===Données===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
Les propriétés de ce groupe ne sont disponibles que pour les réseaux de liens. Voir [[Std_LinkMake/fr#Propri.C3.A9t.C3.A9s|Std Créer un lien]] pour plus d'informations.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Caché}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Caché}}<br />
* {{PropertyData|Placement List|PlacementList|Caché}}<br />
* {{PropertyData|Element List|LinkList|Caché}}<br />
* {{PropertyData|_ Link Touched|Bool|Caché}}<br />
* {{PropertyData|_ Child Cache|LinkList|Caché}}<br />
* {{PropertyData|Colored Elements|LinkSubCaché|Caché}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
* {{PropertyData|Align|Bool}} : spécifie si les éléments du réseau sont alignés ou non le long du chemin. Si elle vaut {{FALSE}}, toutes les autres propriétés de ce groupe, à l'exception de {{PropertyData|Extra Translation}} ne s'appliquent pas et sont masquées.<br />
* {{PropertyData|Align Mode|Enumeration}} : spécifie le mode d'alignement, qui peut être {{Value|Original}}, {{Value|Frenet}} ou {{Value|Tangent}}.<br />
* {{PropertyData|End Offset|Length}} : spécifie la longueur entre la fin du chemin et la dernière copie. Elle doit être inférieure à la longueur du chemin moins {{PropertyData|Start Offset}}. {{Version/fr|0.21}}<br />
* {{PropertyData|Extra Translation|VectorDistance}} : spécifie un déplacement supplémentaire pour chaque élément le long du chemin.<br />
* {{PropertyData|Force Vertical|Bool}} : spécifie s'il faut remplacer la direction normale par défaut par la valeur de {{PropertyData|Vecteur Vertical}}. Utilisé uniquement si {{PropertyData|Align Mode}} est {{Value|Original}} ou {{Value|Tangent}}.<br />
* {{PropertyData|Start Offset|Length}} : spécifie la longueur entre le début du chemin et la première copie. Elle doit être inférieure à la longueur du chemin. {{Version/fr|0.21}}<br />
* {{PropertyData|Tangent Vector|Vector}} : spécifie le vecteur d'alignement. Utilisé uniquement si {{PropertyData|Align Mode}} est {{Value|Tangent}}.<br />
* {{PropertyData|Vertical Vector|Vector}} : spécifie le remplacement de la direction normale par défaut. Utilisé uniquement si {{PropertyData|Vertical Vector}} est {{TRUE}}.<br />
<br />
{{TitleProperty|Objects}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* {{PropertyData|Base|LinkGlobal}} : spécifie l'objet à dupliquer dans le réseau.<br />
* {{PropertyData|Count|Integer}} : spécifie le nombre d'éléments dans le réseau.<br />
* {{PropertyData|Expand Array|Bool}} : indique s'il faut développer le réseau dans la [[Tree_view/fr|vue en arborescence]] pour permettre la sélection de ses éléments individuels. Disponible uniquement pour les réseaux de type lien (Link).<br />
* {{PropertyData|Path Object|LinkGlobal}} : spécifie l'objet à utiliser pour le chemin. Il doit contenir {{Value|Edges}} dans sa [[Part_TopoShape/fr|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}} : spécifie une liste d'arêtes de {{PropertyData|Path Object}}. Si elle est renseignée, seules ces arêtes sont utilisées pour le chemin.<br />
</div><br />
<br />
<span id="View"></span><br />
=== Vue ===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
Les propriétés de ce groupe, à l'exception de la propriété héritée, ne sont disponibles que pour les réseaux liens (Link). Voir [[Std_LinkMake/fr#Propri.C3.A9t.C3.A9s|Std Créer un lien]] pour plus d'informations.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}} : il s'agit d'une propriété héritée qui apparaît dans le groupe Sélection pour d'autres réseaux.<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
Les propriétés de ce groupe, à l'exception de la propriété héritée, ne sont disponibles que pour les réseaux liens (Link). Voir [[Std_LinkMake/fr#Propri.C3.A9t.C3.A9s|Std Créer un lien]] pour plus d'informations.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Caché}}<br />
* {{PropertyView|Material List|MaterialList|Caché}}<br />
* {{PropertyView|Override Color List|ColorList|Caché}}<br />
* {{PropertyView|Override Material List|BoolList|Caché}}<br />
* {{PropertyView|Proxy|PythonObject|Caché}}: il s'agit d'une propriété héritée.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
Les propriétés de ce groupe sont des propriétés héritées. Voir [[Part_Feature/fr#Propri.C3.A9t.C3.A9s|Part Feature]] pour plus d'informations.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: cette propriété n'est pas héritée par les réseaux de liens (Link).<br />
* {{PropertyView|Display Mode|Enumeration}}: pour les réseaux de liens, il peut s'agir de {{value|Link}} ou {{value|ChildView}}. Pour les autres réseaux, il peut s'agir de : {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} ou {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}} : non utilisé.<br />
* {{PropertyView|Pattern Size|Float}} : non utilisé.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
Les propriétés de ce groupe ne sont pas héritées par les réseaux de liens.<br />
<br />
<span id="Scripting"></span><br />
==Script==<br />
<br />
Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].<br />
<br />
Pour créer un réseau selon une courbe, utilisez la méthode {{incode|make_path_array}} ({{Version/fr|0.19}}) de l'atelier Draft. Cette méthode remplace la méthode dépréciée {{incode|makePathArray}}.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} est l'objet à mettre en réseau. Il peut également s'agir du {{incode|Label}} (chaîne de caractères) d'un objet du document courant.<br />
* {{incode|path_object}} est l'objet courbe. Il peut également s'agir du {{incode|Label}} (chaîne de caractères) d'un objet du document courant.<br />
* {{incode|count}} est le nombre d'éléments dans le réseau.<br />
* {{incode|extra}} est un vecteur qui déplace chaque élément.<br />
* {{incode|subelements}} est une liste d'arêtes de {{incode|path_object}}, par exemple {{incode|["Bord1", "Bord2"]}}. Si elle est renseignée, seules ces arêtes sont utilisées pour le chemin.<br />
* Si {{incode|align}} est {{incode|True}} les éléments sont alignés le long de la courbe en fonction de la valeur de {{incode|align_mode}}, qui peut être {{incode|"Original"}}, {{incode|"Frenet"}} ou {{incode|"Tangent"}}.<br />
* {{incode|tan_vector}} est un vecteur unitaire qui définit la direction tangente locale des éléments le long de la courbe. Il est utilisé lorsque {{incode|align_mode}} est {{incode|"Tangent"}}.<br />
* Si {{incode|force_vertical}} est {{incode|True}} {{incode|vertical_vector}} est utilisé pour la direction Z locale des éléments le long de la courbe. Il est utilisé lorsque {{incode|align_mode}} est {{incode|"Original"}} ou {{incode|"Tangent"}}.<br />
* Si {{incode|use_link}} est {{incode|True}}, les éléments créés sont des [[App_Link/fr|App Links]] au lieu de copies ordinaires.<br />
* {{incode|path_array}} est restitué avec l'objet réseau créé.<br />
<br />
Exemple :<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav/fr<br />
|[[Draft_CircularArray/fr|Réseau circulaire]]<br />
|[[Draft_PathLinkArray/fr|Réseau lié selon une courbe]]<br />
|[[Draft_Workbench/fr|Atelier Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/ro&diff=1388574Draft PathArray/ro2024-03-28T18:20:06Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/ro<br />
|Name=Draft PathArray<br />
|Name/ro=Draft PathArray<br />
|MenuLocation=Draft → PathArray<br />
|Workbenches=[[Draft_Workbench/ro|Draft]], [[Arch_Workbench/ro|Arch]]<br />
|Version=0.14<br />
|SeeAlso=[[Draft Array/ro|Draft Array]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Descriere==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Instrumentul PathArray plasează copii ale unei forme selectate de-a lungul unei căi selectate. Calea poate fi un Filament sau una sau mai multe muchii. Formele pot fi opțional aliniate cu tangenta traiectoriei. Dacă este necesar, poate fi specificat un Vector de tranlație pentru a deplasa formele astfel încât centroidul să fie pe traiectorie. Dacă nu sunt selectate obiecte, veți fi invitat să le selectați.<br />
</div><br />
<br />
Both commands can be used on 2D objects created with the [[Draft_Workbench|Draft Workbench]] or [[Sketcher_Workbench|Sketcher Workbench]], but also on many 3D objects such as those created with the [[Part_Workbench|Part Workbench]], [[PartDesign_Workbench|PartDesign Workbench]] or [[Arch_Workbench|Arch Workbench]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PathArray}}<br />
<br />
<span id="Usage"></span><br />
<div class="mw-translate-fuzzy"><br />
== Cum se folosește ==<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
# Creați un obiect tip formă pe care doriți să îl distribuiți/multiplicați. Veți obține cele mai bune rezultate dacă obiectul dvs. este centrat în jurul originii, chiar dacă calea începe în altă parte.<br />
# Selectați un obiect tip traiectorie de-a lungul căruia vor fi distribuite formele. -sau-<br />
# Selectați unele margini ale unui obiect traiectorie.<br />
# Apasați pe butonul {{KEY|[[Image:Draft_PathArray.png|16px]] [[Draft PathArray]]}}.<br />
</div><br />
<br />
==Alignment==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 arrays based on the same non-planar path. From left to right: Align is false, Align is true with Align Mode Original and Align is true with Align Mode Frenet}}.<br />
<br />
===Align Mode===<br />
<br />
Three modes are available:<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
====Tangent====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
<span id="Properties"></span><br />
==Proprietăți==<br />
<br />
See also: [[property_editor|Property editor]].<br />
<br />
A Draft PathArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* {{PropertyData|Base}}: Obiectul tip formă<br />
* {{PropertyData|PathObj}}: Obeictul tip traiectorie<br />
* {{PropertyData|PathSubs}}: Sub-elementele(edges) obeictului tip traiectorie car va fi utilizat<br />
* {{PropertyData|Count}}: Numărul de ori de repetarea a formei<br />
* {{PropertyData|Xlate}}: Vectorul de translație<br />
* {{PropertyData|Align}}: Este adevărat să aliniați formele la traiectorie, False pentru a lăsa forme în orientarea lor implicită.<br />
</div><br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
===View===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
The properties in this group are not inherited by Link arrays.<br />
<br />
==Scripting==<br />
<br />
<div class="mw-translate-fuzzy"><br />
== Scrip-Programare ==<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
Instrumentul PathArray poate fi utilizat în [[macros]] și de la consola Python utilizând umătoarea funcție:<br />
</div><br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
* Plasează un numpr de copii ale unui obiect tip formă al documentului de-a lungul unui obiect tip traiectorie sau sub-obiecte ale unui path-object. Opțional translatează fiecare copie prin FreeCAD.Vector xlate pe direcția și la distanța pentru a ajusta pentru diferența de formă centru vs punct de referință. Opțional, aliniază elementul de bază la calea tangentă/normală/binormală.<br />
</div><br />
<br />
Exempluː<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/pt-br&diff=1388573Draft PathArray/pt-br2024-03-28T18:20:06Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav<br />
|[[Draft_CircularArray/pt-br|Série circular]]<br />
|[[Draft_PathLinkArray/pt-br|Série de links sobre trilhos]]<br />
|[[Draft_Workbench/pt-br|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
</div><br />
<br />
{{GuiCommand<br />
|Name=Draft PathArray<br />
|MenuLocation=Modification → Array tools → Path array<br />
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]]<br />
|Version=0.14<br />
|SeeAlso=[[Draft_OrthoArray|Draft OrthoArray]], [[Draft_PolarArray|Draft PolarArray]], [[Draft_CircularArray|Draft CircularArray]], [[Draft_PathLinkArray|Draft PathLinkArray]], [[Draft_PointArray|Draft PointArray]], [[Draft_PointLinkArray|Draft PointLinkArray]]<br />
}}<br />
<br />
<span id="Description"></span><br />
==Descrição==<br />
<br />
The [[Image:Draft_PathArray.svg|24px]] '''Draft PathArray''' command creates a regular array from a selected object by placing copies along a path. Use the [[Draft_PathLinkArray|Draft PathLinkArray]] command to create a more efficient [[App_Link|Link]] array instead. Except for the type of array that is created, Link array or regular array, the [[Draft_PathLinkArray|Draft PathLinkArray]] command is identical to this command.<br />
<br />
Both commands can be used on 2D objects created with the [[Draft_Workbench|Draft Workbench]] or [[Sketcher_Workbench|Sketcher Workbench]], but also on many 3D objects such as those created with the [[Part_Workbench|Part Workbench]], [[PartDesign_Workbench|PartDesign Workbench]] or [[Arch_Workbench|Arch Workbench]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PathArray}}<br />
<br />
<span id="Usage"></span><br />
==Utilização==<br />
<br />
# Select the object you wish to array.<br />
# Add the path object to the selection. It is also possible to select edges instead. The edges must belong to the same object and they must be connected.<br />
# There are several ways to invoke the command:<br />
#* Press the {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray|Path array]]}} button.<br />
#* Select the {{MenuCommand|Modification → Array tools → [[Image:Draft_PathArray.svg|16px]] Path array}} option from the menu.<br />
# The array is created.<br />
# Optionally change the [[#Properties|properties]] of the array in the [[property_editor|Property editor]].<br />
<br />
==Alignment==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 arrays based on the same non-planar path. From left to right: Align is false, Align is true with Align Mode Original and Align is true with Align Mode Frenet}}.<br />
<br />
===Align Mode===<br />
<br />
Three modes are available:<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
====Tangent====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
<span id="Properties"></span><br />
==Propriedades==<br />
<br />
See also: [[property_editor|Property editor]].<br />
<br />
A Draft PathArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
* {{PropertyData|Align|Bool}}: specifies if the elements in the array are aligned along the path or not. If it is {{FALSE}} all other properties in this group, except {{PropertyData|Extra Translation}}, do not apply and are hidden.<br />
* {{PropertyData|Align Mode|Enumeration}}: specifies the align mode, which can be {{Value|Original}}, {{Value|Frenet}} or {{Value|Tangent}}.<br />
* {{PropertyData|End Offset|Length}}: specifies the length from the end of the path to the last copy. Must be smaller than the length of the path minus the {{PropertyData|Start Offset}}. {{Version|0.21}}<br />
* {{PropertyData|Extra Translation|VectorDistance}}: specifies an additional displacement for each element along the path.<br />
* {{PropertyData|Force Vertical|Bool}}: specifies whether to override the default normal direction with the value of {{PropertyData|Vertical Vector}}. Only used if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}.<br />
* {{PropertyData|Start Offset|Length}}: specifies the length from the start of the path to the first copy. Must be smaller than the length of the path. {{Version|0.21}}<br />
* {{PropertyData|Tangent Vector|Vector}}: specifies the alignment vector. Only used if {{PropertyData|Align Mode}} is {{Value|Tangent}}.<br />
* {{PropertyData|Vertical Vector|Vector}}: specifies the override for the default normal direction. Only used if {{PropertyData|Vertical Vector}} is {{TRUE}}.<br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
<span id="View"></span><br />
===Vista===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
The properties in this group are not inherited by Link arrays.<br />
<br />
==Scripting==<br />
<br />
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].<br />
<br />
To create a path array use the {{incode|make_path_array}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makePathArray}} method.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} is the object to be arrayed. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|path_object}} is the path object. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|count}} is the number of elements in the array.<br />
* {{incode|extra}} is a vector that displaces each element.<br />
* {{incode|subelements}} is a list of edges of {{incode|path_object}}, for example {{incode|["Edge1", "Edge2"]}}. If supplied only these edges are used for the path.<br />
* If {{incode|align}} is {{incode|True}} the elements are aligned along the path depending on the value of {{incode|align_mode}}, which can be {{incode|"Original"}}, {{incode|"Frenet"}} or {{incode|"Tangent"}}.<br />
* {{incode|tan_vector}} is a unit vector that defines the local tangent direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Tangent"}}.<br />
* If {{incode|force_vertical}} is {{incode|True}} {{incode|vertical_vector}} is used for the local Z direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Original"}} or {{incode|"Tangent"}}.<br />
* If {{incode|use_link}} is {{incode|True}} the created elements are [[App_Link|App Links]] instead of regular copies.<br />
* {{incode|path_array}} is returned with the created array object.<br />
<br />
Example:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav<br />
|[[Draft_CircularArray/pt-br|Série circular]]<br />
|[[Draft_PathLinkArray/pt-br|Série de links sobre trilhos]]<br />
|[[Draft_Workbench/pt-br|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
</div><br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_PathArray/en&diff=1388572Draft PathArray/en2024-03-28T18:20:04Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{GuiCommand<br />
|Name=Draft PathArray<br />
|MenuLocation=Modification → Array tools → Path array<br />
|Workbenches=[[Draft_Workbench|Draft]], [[Arch_Workbench|Arch]]<br />
|Version=0.14<br />
|SeeAlso=[[Draft_OrthoArray|Draft OrthoArray]], [[Draft_PolarArray|Draft PolarArray]], [[Draft_CircularArray|Draft CircularArray]], [[Draft_PathLinkArray|Draft PathLinkArray]], [[Draft_PointArray|Draft PointArray]], [[Draft_PointLinkArray|Draft PointLinkArray]]<br />
}}<br />
<br />
==Description==<br />
<br />
The [[Image:Draft_PathArray.svg|24px]] '''Draft PathArray''' command creates a regular array from a selected object by placing copies along a path. Use the [[Draft_PathLinkArray|Draft PathLinkArray]] command to create a more efficient [[App_Link|Link]] array instead. Except for the type of array that is created, Link array or regular array, the [[Draft_PathLinkArray|Draft PathLinkArray]] command is identical to this command.<br />
<br />
Both commands can be used on 2D objects created with the [[Draft_Workbench|Draft Workbench]] or [[Sketcher_Workbench|Sketcher Workbench]], but also on many 3D objects such as those created with the [[Part_Workbench|Part Workbench]], [[PartDesign_Workbench|PartDesign Workbench]] or [[Arch_Workbench|Arch Workbench]].<br />
<br />
[[Image:Draft_PathArray_Example.png|400px]]<br />
{{Caption|Draft PathArray}}<br />
<br />
==Usage==<br />
<br />
# Select the object you wish to array.<br />
# Add the path object to the selection. It is also possible to select edges instead. The edges must belong to the same object and they must be connected.<br />
# There are several ways to invoke the command:<br />
#* Press the {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray|Path array]]}} button.<br />
#* Select the {{MenuCommand|Modification → Array tools → [[Image:Draft_PathArray.svg|16px]] Path array}} option from the menu.<br />
# The array is created.<br />
# Optionally change the [[#Properties|properties]] of the array in the [[property_editor|Property editor]].<br />
<br />
==Alignment==<br />
<br />
The alignment of the elements in a Draft PathArray depends on the properties of the array and the orientation of the source object. The position of the source object is ignored: for the purpose of the array the {{Value|x}}, {{Value|y}} and {{Value|z}} are set to {{Value|0}}. If the {{PropertyData|Align}} property of the array is set to {{FALSE}} the orientation of the array elements is identical to that of the source object. If it is set to {{TRUE}} the X axis of the local coordinate system of each element placement is tangent to the path. The Y and Z axes of the local coordinate systems depend on the {{PropertyData|Align Mode}} property of the array. Other array properties involved in the alignment include {{PropertyData|Tangent Vector}}, {{PropertyData|Force Vertical}} and {{PropertyData|Vertical Vector}}.<br />
<br />
[[Image:Draft_PathArray_example2.png|600px]]<br />
{{Caption|3 arrays based on the same non-planar path. From left to right: Align is false, Align is true with Align Mode Original and Align is true with Align Mode Frenet}}.<br />
<br />
===Align Mode===<br />
<br />
Three modes are available:<br />
<br />
====Original====<br />
<br />
This mode comes closest to the single {{PropertyData|Align Mode}} available in version 0.18. It relies on a fixed normal vector. If the path is planar this vector is perpendicular to the plane of the path, else a default vector, the positive Z axis, is used. From this normal vector and the local tangent vector (the local X axis) a [https://en.wikipedia.org/wiki/Cross_product cross product] is calculated. This new vector is used as the local Z axis. The orientation of the local Y axis is determined from the local X and Z axes.<br />
<br />
====Frenet====<br />
<br />
This mode uses the local normal vector derived from the path at each element placement. If this vector cannot be determined (for example in the case of a straight segment) a default vector, again the positive Z axis, is used instead. With this vector and the local tangent vector the local coordinate system is determined using the same procedure as in the previous paragraph.<br />
<br />
====Tangent====<br />
<br />
This mode is similar to {{PropertyData|Align Mode}} {{Value|Original}} but includes the possibility to pre-rotate the source object by specifying a {{PropertyData|Tangent Vector}}.<br />
<br />
===Force Vertical and Vertical Vector===<br />
<br />
These properties are only available if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}. If {{PropertyData|Force Vertical}} is set to {{TRUE}} the local coordinate system is calculated in a different manner. The {{PropertyData|Vertical Vector}} is used as a fixed normal vector. From this normal vector and the local tangent vector (the local X axis) again a cross product is calculated. But now this vector is used as the local Y axis. The orientation of the local Z axis is determined from the local X and Y axes.<br />
<br />
Using these properties can be required if one of the edged of the path is (almost) parallel to the default normal of the path.<br />
<br />
==Properties==<br />
<br />
See also: [[property_editor|Property editor]].<br />
<br />
A Draft PathArray object is derived from a [[Part_Feature|Part Feature]] object and inherits all its properties (with the exception of some View properties that are not inherited by Link arrays). The following properties are additional unless otherwise stated:<br />
<br />
===Data===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyData|Scale|Float}}<br />
* {{PropertyData|Scale Vector|Vector|Hidden}}<br />
* {{PropertyData|Scale List|VectorList}}<br />
* {{PropertyData|Visibility List|BoolList|Hidden}}<br />
* {{PropertyData|Placement List|PlacementList|Hidden}}<br />
* {{PropertyData|Element List|LinkList|Hidden}}<br />
* {{PropertyData|_ Link Touched|Bool|Hidden}}<br />
* {{PropertyData|_ Child Cache|LinkList|Hidden}}<br />
* {{PropertyData|Colored Elements|LinkSubHidden|Hidden}}<br />
* {{PropertyData|Link Transform|Bool}}<br />
<br />
{{TitleProperty|Alignment}}<br />
<br />
* {{PropertyData|Align|Bool}}: specifies if the elements in the array are aligned along the path or not. If it is {{FALSE}} all other properties in this group, except {{PropertyData|Extra Translation}}, do not apply and are hidden.<br />
* {{PropertyData|Align Mode|Enumeration}}: specifies the align mode, which can be {{Value|Original}}, {{Value|Frenet}} or {{Value|Tangent}}.<br />
* {{PropertyData|End Offset|Length}}: specifies the length from the end of the path to the last copy. Must be smaller than the length of the path minus the {{PropertyData|Start Offset}}. {{Version|0.21}}<br />
* {{PropertyData|Extra Translation|VectorDistance}}: specifies an additional displacement for each element along the path.<br />
* {{PropertyData|Force Vertical|Bool}}: specifies whether to override the default normal direction with the value of {{PropertyData|Vertical Vector}}. Only used if {{PropertyData|Align Mode}} is {{Value|Original}} or {{Value|Tangent}}.<br />
* {{PropertyData|Start Offset|Length}}: specifies the length from the start of the path to the first copy. Must be smaller than the length of the path. {{Version|0.21}}<br />
* {{PropertyData|Tangent Vector|Vector}}: specifies the alignment vector. Only used if {{PropertyData|Align Mode}} is {{Value|Tangent}}.<br />
* {{PropertyData|Vertical Vector|Vector}}: specifies the override for the default normal direction. Only used if {{PropertyData|Vertical Vector}} is {{TRUE}}.<br />
<br />
{{TitleProperty|Objects}}<br />
<br />
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.<br />
<br />
===View===<br />
<br />
{{TitleProperty|Link}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Draw Style|Enumeration}}<br />
* {{PropertyView|Line Width|FloatConstraint}}<br />
* {{PropertyView|Override Material|Bool}}<br />
* {{PropertyView|Point Size|FloatConstraint}}<br />
* {{PropertyView|Selectable|Bool}}: this is an inherited property that appears in the Selection group for other arrays<br />
* {{PropertyView|Shape Material|Material}}<br />
<br />
{{TitleProperty|Base}}<br />
<br />
The properties in this group, with the exception of the inherited property, are only available for Link arrays. See [[Std_LinkMake#Properties|Std LinkMake]] for more information.<br />
<br />
* {{PropertyView|Child View Provider|PersistentObject|Hidden}}<br />
* {{PropertyView|Material List|MaterialList|Hidden}}<br />
* {{PropertyView|Override Color List|ColorList|Hidden}}<br />
* {{PropertyView|Override Material List|BoolList|Hidden}}<br />
* {{PropertyView|Proxy|PythonObject|Hidden}}: this is an inherited property.<br />
<br />
{{TitleProperty|Display Options}}<br />
<br />
The properties in this group are inherited properties. See [[Part_Feature#Properties|Part Feature]] for more information.<br />
<br />
* {{PropertyView|Bounding Box|Bool}}: this property is not inherited by Link arrays.<br />
* {{PropertyView|Display Mode|Enumeration}}: for Link arrays it can be {{value|Link}} or {{value|ChildView}}. For other arrays it can be: {{value|Flat Lines}}, {{value|Shaded}}, {{value|Wireframe}} or {{value|Points}}<br />
* {{PropertyView|Show In Tree|Bool}}<br />
* {{PropertyView|Visibility|Bool}}<br />
<br />
{{TitleProperty|Draft}}<br />
<br />
* {{PropertyView|Pattern|Enumeration}}: not used.<br />
* {{PropertyView|Pattern Size|Float}}: not used.<br />
<br />
{{TitleProperty|Object style}}<br />
<br />
The properties in this group are not inherited by Link arrays.<br />
<br />
==Scripting==<br />
<br />
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].<br />
<br />
To create a path array use the {{incode|make_path_array}} method ({{Version|0.19}}) of the Draft module. This method replaces the deprecated {{incode|makePathArray}} method.<br />
<br />
{{Code|code=<br />
path_array = make_path_array(base_object, path_object,<br />
count=4, extra=App.Vector(0, 0, 0), subelements=None,<br />
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),<br />
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),<br />
use_link=True)<br />
}}<br />
<br />
* {{incode|base_object}} is the object to be arrayed. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|path_object}} is the path object. It can also be the {{incode|Label}} (string) of an object in the current document.<br />
* {{incode|count}} is the number of elements in the array.<br />
* {{incode|extra}} is a vector that displaces each element.<br />
* {{incode|subelements}} is a list of edges of {{incode|path_object}}, for example {{incode|["Edge1", "Edge2"]}}. If supplied only these edges are used for the path.<br />
* If {{incode|align}} is {{incode|True}} the elements are aligned along the path depending on the value of {{incode|align_mode}}, which can be {{incode|"Original"}}, {{incode|"Frenet"}} or {{incode|"Tangent"}}.<br />
* {{incode|tan_vector}} is a unit vector that defines the local tangent direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Tangent"}}.<br />
* If {{incode|force_vertical}} is {{incode|True}} {{incode|vertical_vector}} is used for the local Z direction of the elements along the path. It is used when {{incode|align_mode}} is {{incode|"Original"}} or {{incode|"Tangent"}}.<br />
* If {{incode|use_link}} is {{incode|True}} the created elements are [[App_Link|App Links]] instead of regular copies.<br />
* {{incode|path_array}} is returned with the created array object.<br />
<br />
Example:<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import Draft<br />
<br />
doc = App.newDocument()<br />
<br />
p1 = App.Vector(500, -1000, 0)<br />
p2 = App.Vector(1500, 1000, 0)<br />
p3 = App.Vector(3000, 500, 0)<br />
p4 = App.Vector(4500, 100, 0)<br />
spline = Draft.make_bspline([p1, p2, p3, p4])<br />
obj = Draft.make_polygon(3, 500)<br />
<br />
path_array = Draft.make_path_array(obj, spline, 6)<br />
doc.recompute()<br />
<br />
wire = Draft.make_wire([p1, -p2, -p3, -p4])<br />
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)<br />
doc.recompute()<br />
}}<br />
<br />
<br />
{{Docnav<br />
|[[Draft_CircularArray|CircularArray]]<br />
|[[Draft_PathLinkArray|PathLinkArray]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_CircularArray.svg<br />
|IconR=Draft_PathLinkArray.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Translations:Draft_PathArray/47/en&diff=1388571Translations:Draft PathArray/47/en2024-03-28T18:19:58Z<p>FuzzyBot: Importing a new version from external source</p>
<hr />
<div>* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the array.<br />
* {{PropertyData|Count|Integer}}: specifies the number of elements in the array.<br />
* {{PropertyData|Expand Array|Bool}}: specifies whether to expand the array in the [[Tree_view|Tree view]] to enable the selection of its individual elements. Only available for Link arrays.<br />
* {{PropertyData|Fuse|Bool}}: specifies if overlapping elements in the array are fused or not. Not used for Link arrays. {{Version|0.22}}<br />
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object to be used for the path. It must contain {{Value|Edges}} in its [[Part_TopoShape|Part TopoShape]].<br />
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies a list of edges of the {{PropertyData|Path Object}}. If supplied only these edges are used for the path.</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_Dialog/pt-br&diff=1388298Sketcher Dialog/pt-br2024-03-28T11:41:32Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_EditSketch|Edit sketch]]<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{TOCright}}<br />
<br />
==Introduction==<br />
<br />
While a sketch is being edited, or, in other words, while a sketch is in edit mode, the Sketcher Dialog is displayed on the Task tab of the [[Combo_view|Combo view]].<br />
<br />
To put a sketch in edit mode see [[Image:Sketcher_EditSketch.svg|16px]] [[Sketcher_EditSketch|Sketcher EditSketch]]. To finish edit mode see [[Image:Sketcher_LeaveSketch.svg|16px]] [[Sketcher_LeaveSketch|Sketcher LeaveSketch]].<br />
<br />
The Sketcher Dialog has the following sections:<br />
<br />
==Tool parameters==<br />
<br />
{{Version|0.22}}<br />
<br />
Some tools add a parameters section at the top of the dialog. Available options and/or modes depend on the tool.<br />
<br />
[[Image:Sketcher_Dialog_Line_parameters.png]]<br />
{{Caption|The parameters section of the [[Sketcher_CreateLine|Sketcher CreateLine]] tool}}<br />
<br />
==Solver messages==<br />
<br />
This section informs about the state of the sketch.<br />
<br />
The possible messages are:<br />
* Empty sketch<br />
* <span style="color:green;">Fully constrained</span><br />
* Under constrained: <span style="color:blue;text-decoration:underline;">n DoF(s)</span><br />
* <span style="color:red;">Redundant constraints: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
* <span style="color:red;">Over-constrained: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
<br />
If a sketch is under-constrained the number of degrees of freedom (or DoFs) is indicated. Clicking the underlined text will select the under-constrained sketch elements. See [[Image:Sketcher_SelectElementsWithDoFs.svg|16px]] [[Sketcher_SelectElementsWithDoFs|Sketcher SelectElementsWithDoFs]].<br />
<br />
If a sketch has redundant constraints or is over-constrained the indices of the involved constraints are indicated. Clicking the underlined text will select them. See [[Image:Sketcher_SelectRedundantConstraints.svg|16px]] [[Sketcher_SelectRedundantConstraints|Sketcher SelectRedundantConstraints]] and [[Image:Sketcher_SelectConflictingConstraints.svg|16px]] [[Sketcher_SelectConflictingConstraints|Sketcher SelectConflictingConstraints]].<br />
<br />
The last two messages are displayed in red for a reason: they are warnings that should not be ignored. They indicate issues that must be addressed as they interfere with the solver.<br />
<br />
The last three messages are not mutually exclusive. If more than one applies only the most important message, occurring lowest in the list, is displayed.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|[[Image:View-refresh.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Auto update}}: If checked, the whole document is recomputed after every sketch action. Not advisable for complex documents.<br />
|}<br />
<br />
==Advanced solver control==<br />
<br />
This section will only appear if you check the '''Show section 'Advanced solver control'''' option in the [[Sketcher_Preferences|sketcher preferences]].<br />
<br />
Note that most of the options in this section are of no practical use. They can however help with testing and understanding the solvers.<br />
<br />
Available options:<br />
<br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{MenuCommand|Default solver}}<br />
| The solver that is used for solving the geometry. '''[https://en.wikipedia.org/wiki/Levenberg%E2%80%93Marquardt_algorithm LevenbergMarquardt]''' and '''DogLeg''' are [https://en.wikipedia.org/wiki/Trust_region trust region] optimization algorithms. The '''BFGS''' solver uses the [https://en.wikipedia.org/wiki/Broyden%E2%80%93Fletcher%E2%80%93Goldfarb%E2%80%93Shanno_algorithm Broyden–Fletcher–Goldfarb–Shanno algorithm].<br />
|-<br />
| {{MenuCommand|DogLeg Gauss step}}<br />
| This setting is only available for the solver '''DogLeg'''. It is the step type used in the DogLeg algorithm.<br />
|-<br />
| {{MenuCommand|Maximum iterations}}<br />
| If the solver needs more iterations to find a convergence to a solution, it will stop and output that it failed.<br />
|-<br />
| {{MenuCommand|Sketch size multiplier}}<br />
| If checked, the maximum iterations will be multiplied by the number of parameters. The idea is that bigger sketches would need more iterations to converge.<br />
|-<br />
| {{MenuCommand|Convergence}}<br />
| The threshold for the squared error. This error is used to determine whether a solution converges or not.<br />
|-<br />
| {{MenuCommand|Eps/Eps1/Tau}}<br />
| These settings are only available for the solver '''LevenbergMarquardt'''. You should only change something here if you fully understand how the LevenbergMarquardt solver works.<br />
|-<br />
| {{MenuCommand|Tolg/Tolx/Tolf}}<br />
| These settings are only available for the solver '''DogLeg'''. You should only change something here if you fully understand how the DogLeg solver works.<br />
|-<br />
| {{MenuCommand|QR Algorithm}}<br />
| During diagnosing the rank of the matrix is calculated which enables to further analyze the constraint system to determine if there are redundant/conflicting constraints. The rank revealing decomposition used in FreeCAD is QR. There are two algorithms: '''Eigen Dense QR''' is a dense matrix QR with full pivoting, which is the legacy proven algorithm that works very well but it is rather slow as the system grows. The '''Eigen Sparse QR''' algorithm is an optimization for sparse matrices (having lots of zeros), which is usually much faster, since FreeCAD's systems do have a lot of zeros.<br />
|-<br />
| {{MenuCommand|Pivot threshold}}<br />
| When doing a QR, values under the pivot threshold are treated as zero.<br />
|-<br />
| {{MenuCommand|Redundant Solver}}<br />
| The solver that is used during diagnosing to determine whether a group is redundant or conflicting.<br />
|-<br />
| {{MenuCommand|Red. Max Iterations}}<br />
| The same as {{MenuCommand|Maximum iterations}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Red. Sketch size multiplier}}<br />
| The same as {{MenuCommand|Sketch size multiplier}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Red. Convergence}} <br />
| The same as {{MenuCommand|Convergence}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|R.Eps/R.Eps1/R.Tau}}<br />
| The same as {{MenuCommand|Eps/Eps1/Tau}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|R.Tolg/R.Tolx/R.Tolf}}<br />
| The same as {{MenuCommand|Tolg/Tolx/Tolf}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Console Debug mode}}<br />
| Setting to specify the verbosity of the console output.<br />
|-<br />
| {{Button|Solve}}<br />
| This button explicitly starts the solver.<br />
|-<br />
| {{Button|Restore Defaults}}<br />
| This button restores the default solver settings.<br />
|}<br />
<br />
==Constraints==<br />
<br />
This section lists the constraints in the sketch. Unchecking a constraint in the list will hide it in the sketch. Constraints can be selected in the list as well as in the sketch.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filter [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| If the Filter checkbox is checked the Filter dropdown list controls which constraints are listed:<br />
* {{MenuCommand|All}}: All constraints.<br />
* {{MenuCommand|Geometric}}: Geometric constraints.<br />
* {{MenuCommand|Datums}}: [[Sketcher_ToggleDrivingConstraint|Driving]] dimensional constraints. Does not work properly: all dimensional constraints are filtered.<br />
* {{MenuCommand|Named}}: Named constraints. Does not work.<br />
* {{MenuCommand|Reference}}: [[Sketcher_ToggleDrivingConstraint|Driven]] dimensional constraints. Does not work.<br />
* {{MenuCommand|Selected constraints}}: Constraints selected in the sketch.<br />
* {{MenuCommand|Associated constraints}}: Constraints associated with elements selected in the sketch.<br />
|-<br />
| {{Button|[[Image:Std_ToggleVisibility.svg|x16px]]}}<br />
| This button toggles the visibility of the listed constraints in the sketch.<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Auto constraints}}: If checked, some geometric constraints are applied automatically to new elements.<br />
* {{MenuCommand|Auto remove redundants}}: If checked, new constraints that are redundant are automatically removed.<br />
* {{MenuCommand|Show only filtered Constraints}}: If checked, only the listed constraints are shown in the sketch.<br />
* {{MenuCommand|Extended information (in widget)}}: If checked, extended information is added in this form:<br />
: {{Incode|[(GeoID1,PosID1),(GeoID2,PosID2),(GeoID3,PosID3)]}}<br />
: GeoID is a zero-based index for non-external geometry. The X axis has GeoID -1, the Y axis has GeoID -2. GeoID -3, -4 etc. are used for external geometry.<br />
: PosID can have the following values:<br />
: 0 = edge, 1 = start point, 2 = end point, 3 = center point.<br />
: For example a dimension from the origin to the center of a circle that is the 2nd non-external element in the sketch will have this extended information:<br />
: {{Incode|[(-1,1),(1,3)]}}<br />
* {{MenuCommand|Hide internal alignment (in widget)}}: If checked, constraints associated with internal alignments are hidden in the list. The [[Image:Sketcher_RestoreInternalAlignmentGeometry.svg|16px]] [[Sketcher_RestoreInternalAlignmentGeometry|Show/Hide internal geometry]] tool can also hide these constraints, but will also hide the internal alignments in the sketch.<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking constraints selected in the list opens a context menu. The menu has the following options:<br />
* {{MenuCommand|Change value}}: Changes the value of a dimensional constraint. Only works for a single constraint. You can also double click the constraint in the list, or double click its value in the [[3D_view|3D view]].<br />
* {{MenuCommand|Toggle to/from reference}}: See [[Sketcher_ToggleDrivingConstraint|Sketcher ToggleDrivingConstraint]].<br />
* {{MenuCommand|Deactivate}} or {{MenuCommand|Activate}}: See [[Sketcher_ToggleActiveConstraint|Sketcher ToggleActiveConstraint]].<br />
* {{MenuCommand|Show constraints}}: Same as checking the constraint checkbox. But, unlike the checkbox, also works for more than one constraint.<br />
* {{MenuCommand|Hide constraints}}: Same as unchecking the constraint checkbox. Idem.<br />
* {{MenuCommand|Select Elements}}: See [[Sketcher_SelectElementsAssociatedWithConstraints|Sketcher SelectElementsAssociatedWithConstraints]].<br />
* {{MenuCommand|Rename}}: Renames the constraint.<br />
* {{MenuCommand|Center sketch}}: Centers the 3D view around the selected constraints.<br />
* {{MenuCommand|Delete}}: Deletes the selected constrains. The {{KEY|Del}} key can also be used.<br />
* {{MenuCommand|Swap constraint names}}: Swaps the names of selected constraints. Only works if two constraints with user given names are selected.<br />
|}<br />
<br />
==Elements==<br />
<br />
This section lists the elements in the sketch. Unchecking an element in the list will hide it in the sketch. Elements can be selected in the list as well as in the sketch.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filter [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| If the Filter checkbox is checked the Filter dropdown list controls which elements are listed:<br />
* {{MenuCommand|Normal}}: Normal geometry: geometry that does not fall in the next three categories.<br />
* {{MenuCommand|Construction}}: [[Sketcher_ToggleConstruction|Construction geometry]].<br />
* {{MenuCommand|Internal}}: [[Sketcher_RestoreInternalAlignmentGeometry|Internal geometry]].<br />
* {{MenuCommand|External}}: [[Sketcher_External|External geometry]].<br />
* {{MenuCommand|All types}}: All geometry types. Specific types can be selected in the rest of the list:<br />
** {{MenuCommand|Point}}<br />
** {{MenuCommand|Line}}<br />
** {{MenuCommand|Circle}}<br />
** {{MenuCommand|Ellipse}}<br />
** {{MenuCommand|Arc of circle}}<br />
** {{MenuCommand|Arc of ellipse}}<br />
** {{MenuCommand|Arc of hyperbola}}<br />
** {{MenuCommand|Arc of parabola}}<br />
** {{MenuCommand|B-Spline}}<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Extended information}}: If checked, extended element information is provided.<br />
: For non-external geometry the information in the list then changes from:<br />
: {{Incode|<N>-<TYPE>}}<br />
: to:<br />
: {{Incode|<TYPE>(Edge<N>#ID<GeoID>#<VLX>)[-Construction]}}<br />
: <TYPE>: Element type.<br />
: <N>: A 1-based index that indicates the creation order of the element.<br />
: <GeoID>: See under [[#Constraints|Constraints]].<br />
: <VLX>: Element layer. See below.<br />
|-<br />
| [[Image:Sketcher_Element_Arc_Edge.svg|24px]] [[Image:Sketcher_Element_Arc_StartingPoint.svg|24px]] [[Image:Sketcher_Element_Arc_EndPoint.svg|24px]] [[Image:Sketcher_Element_Arc_MidPoint.svg|24px]]<br />
| Each element in the list has 1 to 4 buttons organized in 4 columns. These select a specific part of the element. Only applicable buttons are shown.<br />
* Button in column 1: Selects the edge of the element.<br />
* Button in column 2: Selects the start point of the element.<br />
* Button in column 3: Selects the end point of the element.<br />
* Button in column 4: Selects the center point of the element.<br />
Clicking the text has the same effect as clicking the first available button of the element.<br />
<br />
[[Image:Sketcher_Dialog_Elements.png]]<br><br />
''In the image the edge of a line and the center of an arc have been selected.''<br><br />
''The line does not have a button in column 4 as it does not have a center.''<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking elements selected in the list opens a context menu. The menu contains the Geometric [[Sketcher_Workbench#Sketcher_constraints|constraint tools]], the Dimensional constraint tools and the following additional options:<br />
* {{MenuCommand|Toggle construction geometry}}: See [[Sketcher_ToggleConstruction|Sketcher ToggleConstruction]].<br />
* {{MenuCommand|Select Constraints}}: See [[Sketcher_SelectConstraints|Sketcher SelectConstraints]].<br />
* {{MenuCommand|Select Origin}}: See [[Sketcher_SelectOrigin|Sketcher SelectOrigin]].<br />
* {{MenuCommand|Select Horizontal Axis}}: See [[Sketcher_SelectHorizontalAxis|Sketcher SelectHorizontalAxis]].<br />
* {{MenuCommand|Select Vertical Axis}}: See [[Sketcher_SelectVerticalAxis|Sketcher SelectVerticalAxis]].<br />
* {{MenuCommand|Layer}}: 3 layers are available:<br />
** {{MenuCommand|Layer 0}}: Indicated as {{Incode|VL0}} in extended information. This is the default layer. Elements on this layer are displayed with a solid line type.<br />
** {{MenuCommand|Layer 1}}: Indicated as {{Incode|VL1}} in extended information. Elements on this layer are displayed with a dashed line type.<br />
** {{MenuCommand|Hidden}}: Indicated as {{Incode|VL2}} in extended information. Elements on this layer are hidden in the sketch.<br />
: The rendering order of layers 0 and 1 is such that when picking coincident points in the [[3D_view|3D view]] elements on layer 0 are selected in favor of those on layer 1.<br />
* {{MenuCommand|Delete}}: Deletes the selected elements. The {{KEY|Del}} key can also be used.<br />
|}<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_EditSketch|Edit sketch]]<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_Dialog/fr&diff=1388297Sketcher Dialog/fr2024-03-28T11:41:30Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/fr<br />
|[[Sketcher_EditSketch/fr|Modifier une esquisse]]<br />
|[[Sketcher_MapSketch/fr|Esquisse sur une face]]<br />
|[[Sketcher_Workbench/fr|Atelier Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{TOCright}}<br />
<br />
<span id="Introduction"></span><br />
== Introduction ==<br />
<br />
Lorsqu'une esquisse est en cours d'édition, la boîte de dialogue de Sketcher s'affiche dans l'onglet Tâche de la [[Combo_view/fr|vue combinée]].<br />
<br />
To put a sketch in edit mode see [[Image:Sketcher_EditSketch.svg|16px]] [[Sketcher_EditSketch|Sketcher EditSketch]]. To finish edit mode see [[Image:Sketcher_LeaveSketch.svg|16px]] [[Sketcher_LeaveSketch|Sketcher LeaveSketch]].<br />
<br />
<div class="mw-translate-fuzzy"><br />
La boîte de dialogue comprend les sections suivantes :<br />
</div><br />
<br />
==Tool parameters==<br />
<br />
{{Version|0.22}}<br />
<br />
Some tools add a parameters section at the top of the dialog. Available options and/or modes depend on the tool.<br />
<br />
[[Image:Sketcher_Dialog_Line_parameters.png]]<br />
{{Caption|The parameters section of the [[Sketcher_CreateLine|Sketcher CreateLine]] tool}}<br />
<br />
<span id="Solver_messages"></span><br />
== Messages du solveur ==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Cette section renseigne sur l'état de l'esquisse. Une esquisse peut être sous contrainte, entièrement contrainte ou avoir des contraintes redondantes.<br />
</div><br />
<br />
The possible messages are:<br />
* Empty sketch<br />
* <span style="color:green;">Fully constrained</span><br />
* Under constrained: <span style="color:blue;text-decoration:underline;">n DoF(s)</span><br />
* <span style="color:red;">Redundant constraints: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
* <span style="color:red;">Over-constrained: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
<br />
<div class="mw-translate-fuzzy"><br />
Si une esquisse est sous contrainte, le nombre de degrés de liberté (ou Dofs) est indiqué. En cliquant sur ce texte, les éléments de l'esquisse sous contrainte sont sélectionnés.<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
Si un esquisse a des contraintes redondantes, les indices de ces contraintes sont indiqués. Un clic sur ce texte sélectionnera ces contraintes.<br />
</div><br />
<br />
The last two messages are displayed in red for a reason: they are warnings that should not be ignored. They indicate issues that must be addressed as they interfere with the solver.<br />
<br />
The last three messages are not mutually exclusive. If more than one applies only the most important message, occurring lowest in the list, is displayed.<br />
<br />
Options disponibles :<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|[[Image:View-refresh.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Ce bouton ouvre un menu :<br />
* {{MenuCommand|Mise à jour automatique}} : si cette option est cochée, l'ensemble du document est recalculé après chaque action d'esquisse. Déconseillé pour les documents complexes.<br />
|}<br />
<br />
<span id="Advanced_solver_control"></span><br />
== Contrôle avancé du solveur ==<br />
<br />
Cette section n'apparaîtra que si vous cochez l'option '''Afficher la section "Contrôle avancé du solveur"''' dans les [[Sketcher_Preferences/fr|préférences de Sketcher]].<br />
<br />
Remarquez que la plupart des options de cette section n'ont pas d'utilité pratique. Elles peuvent cependant aider à tester et à comprendre les solveurs.<br />
<br />
Les options disponibles :<br />
<br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{MenuCommand|Solveur par défaut}}<br />
| Le solveur utilisé pour résoudre la géométrie. L''''[https://fr.wikipedia.org/wiki/Algorithme_de_Levenberg-Marquardt algorithme Levenberg-Marquardt]''' et l'algorithme '''DogLeg''' sont des algorithmes d'optimisation des [https://fr.wikipedia.org/wiki/Algorithme_%C3%A0_r%C3%A9gions_de_confiance régions de confiance]. Le solveur '''BFGS''' utilise l'[https://fr.wikipedia.org/wiki/M%C3%A9thode_de_Broyden-Fletcher-Goldfarb-Shanno algorithme Broyden–Fletcher–Goldfarb–Shanno].<br />
|-<br />
| {{MenuCommand|Niveau de DogLeg Gauss}}<br />
| Ce paramètre est uniquement disponible pour le solveur '''DogLeg'''. C'est le type d'étape utilisé dans l'algorithme DogLeg.<br />
|-<br />
| {{MenuCommand|Itérations maximum}}<br />
| Si le solveur a besoin de plus d'itérations pour trouver une convergence vers une solution, il s'arrête et génère le résultat de son échec.<br />
|-<br />
| {{MenuCommand|Multiplicateur par la taille de l'esquisse}}<br />
| Si coché, le maximum d'itérations est multiplié par le nombre de paramètres. L'idée est que les esquisses plus grandes nécessitent plus d'itérations pour converger.<br />
|-<br />
| {{MenuCommand|Convergence}}<br />
| Le seuil de l'erreur au carré. Cette erreur est utilisée pour déterminer si une solution converge ou non.<br />
|-<br />
| {{MenuCommand|Eps/Eps1/Tau}}<br />
| Ces paramètres ne sont disponibles que pour le solveur '''Levenberg-Marquardt'''. Vous ne devriez changer quelque chose que si vous comprenez parfaitement le fonctionnement du solveur LevenbergMarquardt.<br />
|-<br />
| {{MenuCommand|Tolg/Tolx/Tolf}}<br />
| Ces paramètres ne sont disponibles que pour le solveur '''DogLeg'''. Vous ne devriez changer quelque chose que si vous comprenez parfaitement le fonctionnement du solveur DogLeg.<br />
|-<br />
| {{MenuCommand|Algorithme QR}}<br />
| Pendant le diagnostic, le rang de la matrice est calculé, ce qui permet d'analyser plus en détail le système de contraintes pour déterminer s'il existe des contraintes redondantes/conflictuelles. La décomposition révélatrice utilisée dans FreeCAD est QR. Il existe deux algorithmes : '''Eigen Dense QR''' est une matrice QR dense à pivotement complet, c'est un algorithme éprouvé qui fonctionne très bien, mais qui est plutôt lent à mesure que le système se développe. L'algorithme '''Eigen Sparse QR''' est une optimisation pour les matrices creuses (avec beaucoup de zéros), qui est généralement beaucoup plus rapide, car les systèmes de FreeCAD ont beaucoup de zéros.<br />
|-<br />
| {{MenuCommand|Seuil de pivot}}<br />
| Lorsque vous faites un QR, les valeurs situées sous le seuil de pivot sont considérées comme nulles.<br />
|-<br />
| {{MenuCommand|Solveur des redondances}}<br />
| Le solveur utilisé lors du diagnostic pour déterminer si un groupe est redondant ou en conflit.<br />
|-<br />
| {{MenuCommand|Itérations maximum pour les redondances}}<br />
| Le même que {{MenuCommand|Itérations maximum}}, mais pour la résolution des redondances.<br />
|-<br />
| {{MenuCommand|Multiplicateur par la taille de l'esquisse pour les redondances}}<br />
| Le même que {{MenuCommand|Multiplicateur par la taille de l'esquisse}}, mais pour la résolution des redondances.<br />
|-<br />
| {{MenuCommand|Convergence pour les redondances}} <br />
| Le même que {{MenuCommand|Convergence}}, mais pour la résolution des redondances.<br />
|-<br />
| {{MenuCommand|R.Eps/R.Eps1/R.Tau}}<br />
| Le même que {{MenuCommand|Eps/Eps1/Tau}}, mais pour la résolution des redondances.<br />
|-<br />
| {{MenuCommand|R.Tolg/R.Tolx/R.Tolf}}<br />
| Le même que {{MenuCommand|Tolg/Tolx/Tolf}}, mais pour la résolution des redondances.<br />
|-<br />
| {{MenuCommand|Mode de la console de débogage}}<br />
| Réglage permettant de spécifier la verbosité de la sortie de la console.<br />
|-<br />
| {{Button|Résoudre}}<br />
| Ce bouton lance explicitement le solveur.<br />
|-<br />
| {{Button|Rétablir les paramètres par défaut}}<br />
| Ce bouton rétablit les paramètres par défaut du solveur.<br />
|}<br />
<br />
<span id="Constraints"></span><br />
==Contraintes==<br />
<br />
Cette section dresse la liste des contraintes présentes dans l'esquisse. Si vous décochez une contrainte dans la liste, elle sera masquée dans l'esquisse. Les contraintes peuvent être sélectionnées dans la liste ainsi que dans l'esquisse.<br />
<br />
Les options disponibles :<br />
<br />
<div class="mw-translate-fuzzy"><br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filtre [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Si la case Filtre est cochée, la liste déroulante Filtre contrôle les contraintes qui sont listées :<br />
* {{MenuCommand|Tout}} : toutes les contraintes.<br />
* {{MenuCommand|Contraintes géométriques}} : contraintes géométriques.<br />
* {{MenuCommand|Contraintes pilotantes}} : contraintes dimensionnelles [[Sketcher_ToggleDrivingConstraint/fr|pilotantes]]. Ne fonctionne pas correctement : toutes les contraintes dimensionnelles sont filtrées.<br />
* {{MenuCommand|Contraintes nommés}} : contraintes nommées. Ne fonctionne pas.<br />
* {{MenuCommand|Contraintes pilotées}} : contraintes dimensionnelles [[Sketcher_ToggleDrivingConstraint/fr|pilotées]]. Ne fonctionne pas.<br />
* {{MenuCommand|Contraintes sélectionnées}} : contraintes sélectionnées dans l'esquisse.<br />
* {{MenuCommand|Contraintes associées}} : contraintes associées aux éléments sélectionnés dans l'esquisse.<br />
|-<br />
| {{Button|[[Image:Std_ToggleVisibility.svg|x16px]]}}<br />
| Ce bouton permet d'activer la visibilité des contraintes répertoriées dans l'esquisse.<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Ce bouton ouvre un menu :<br />
* {{MenuCommand|Contraintes automatiques}} : si cette option est cochée, certaines contraintes géométriques sont appliquées automatiquement aux nouveaux éléments.<br />
* {{MenuCommand|Suppression automatique des redondances}} : si cette option est cochée, les nouvelles contraintes qui sont redondantes sont automatiquement supprimées.<br />
* {{MenuCommand|Afficher uniquement les contraintes filtrées}} : si cette option est cochée, seules les contraintes répertoriées sont affichées dans l'esquisse.<br />
* {{MenuCommand|Informations complémentaires (dans le widget)}} : si cette option est cochée, des informations complémentaires sont ajoutées dans ce formulaire :<br />
: {{Incode|[(GeoID1,PosID1),(GeoID2,PosID2),(GeoID3,PosID3)]}}<br />
: Le GeoID est un index à base zéro pour la géométrie non externe. L'axe X a le GeoID -1, l'axe Y le GeoID -2. Les GeoID -3, -4, etc. sont utilisés pour la géométrie externe.<br />
: PosID peut avoir les valeurs suivantes :<br />
: 0 = bord, 1 = point de départ, 2 = point d'arrivée, 3 = point central.<br />
: Par exemple, une cote allant de l'origine au centre d'un cercle qui est le 2e élément non externe de l'esquisse aura ces informations étendues :<br />
: {{Incode|[(-1,1),(1,3)]}}<br />
* {{MenuCommand|Masquer l'alignement interne (dans le widget)}} : si cette option est cochée, les contraintes associées aux alignements internes sont cachées dans la liste. L'outil [[File:Sketcher_Element_Ellipse_All.svg|16px]] [[Sketcher_RestoreInternalAlignmentGeometry/fr|Basculer la géométrie interne]] peut également masquer ces contraintes, mais masquera également les alignements internes de l'esquisse.<br />
|-<br />
| {{MenuCommand|Menu contextuel}}<br />
| Un clic droit sur les contraintes sélectionnées dans la liste ouvre un menu contextuel. Le menu propose les options suivantes :<br />
* {{MenuCommand|Changer la valeur}} : modifie la valeur d'une contrainte dimensionnelle. Ne fonctionne que pour une seule contrainte.<br />
* {{MenuCommand|Basculer vers/depuis la référence}} : voir [[Sketcher_ToggleDrivingConstraint/fr|Sketcher Basculer les contraintes pilotantes]].<br />
* {{MenuCommand|Désactiver}} ou {{MenuCommand|Activer}} : voir [[Sketcher_ToggleActiveConstraint/fr|Sketcher Activation des contraintes]].<br />
* {{MenuCommand|Afficher les contraintes}} : identique à la case à cocher des contraintes. Mais, contrairement à la case à cocher, fonctionne également pour plus d'une contrainte.<br />
* {{MenuCommand|Masquer les contraintes}} : identique à la désactivation de la case à cocher des contraintes. Idem.<br />
* {{MenuCommand|Sélectionner les éléments}} : voir [[Sketcher_SelectElementsAssociatedWithConstraints/fr|Sketcher Éléments associés aux contraintes]].<br />
* {{MenuCommand|Renommer}} : renomme la contrainte.<br />
* {{MenuCommand|Centrer l'esquisse}} : centre la vue 3D autour des contraintes sélectionnées.<br />
* {{MenuCommand|Supprimer}} : supprime les contraintes sélectionnées. La touche {{KEY|Supprimer}} peut également être utilisée.<br />
* {{MenuCommand|Échanger les noms des contraintes}} : échange les noms des contraintes sélectionnées. Ne fonctionne que si deux contraintes avec des noms donnés par l'utilisateur sont sélectionnées.<br />
|}<br />
</div><br />
<br />
<span id="Elements"></span><br />
== Éléments ==<br />
<br />
Cette section répertorie les éléments de l'esquisse. Si vous décochez un élément dans la liste, il sera masqué dans l'esquisse. Les éléments peuvent être sélectionnés dans la liste ainsi que dans l'esquisse.<br />
<br />
Les options disponibles :<br />
<br />
<div class="mw-translate-fuzzy"><br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filtre [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Si la case Filtre est cochée, la liste déroulante Filtre contrôle les éléments qui sont listés :<br />
* {{MenuCommand|Normal}} : géométrie normale : géométrie qui n'entre pas dans les trois catégories suivantes.<br />
* {{MenuCommand|Géométrie de construction }} : [[Sketcher_ToggleConstruction/fr|géométrie de construction]].<br />
* {{MenuCommand|Géométrie interne}} : [[Sketcher_RestoreInternalAlignmentGeometry/fr|géométrie interne]].<br />
* {{MenuCommand|Géométrie externe}} : [[Sketcher_External/fr|géométrie externe]].<br />
* {{MenuCommand|Tous les types}} : tous les types de géométrie. Des types spécifiques peuvent être sélectionnés dans le reste de la liste :<br />
** {{MenuCommand|Point}}<br />
** {{MenuCommand|Ligne}}<br />
** {{MenuCommand|Cercle}}<br />
** {{MenuCommand|Ellipse}}<br />
** {{MenuCommand|Arc de cercle}}<br />
** {{MenuCommand|Arc d'ellipse}}<br />
** {{MenuCommand|Arc d'hyperbole}}<br />
** {{MenuCommand|Arc de parabole}}<br />
** {{MenuCommand|B-spline}}<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Ce bouton ouvre un menu :<br />
* {{MenuCommand|Informations complémentaires}} : si cette case est cochée, des informations complémentaires sur l'élément sont fournies.<br />
: Pour les géométries non externes, les informations de la liste passent alors de :<br />
: {{Incode|<N>-<TYPE>}}<br />
: à :<br />
: {{Incode|<TYPE>(Edge<N>#ID<GeoID>#<VLX>)[-Construction]}}<br />
: <TYPE> : Type d'élément.<br />
: <N> : indice basé sur 1 qui indique l'ordre de création de l'élément.<br />
: <GeoID> : voir [[#Contraintes|Contraintes]].<br />
: <VLX> : calque d'élément. Voir ci-dessous.<br />
|-<br />
| [[Image:Sketcher_Element_Arc_Edge.svg|24px]] [[Image:Sketcher_Element_Arc_StartingPoint.svg|24px]] [[Image:Sketcher_Element_Arc_EndPoint.svg|24px]] [[Image:Sketcher_Element_Arc_MidPoint.svg|24px]]<br />
| Chaque élément de la liste comporte de 1 à 4 boutons organisés en 4 colonnes. Ces boutons permettent de sélectionner une partie spécifique de l'élément. Seuls les boutons applicables sont affichés.<br />
* Bouton de la colonne 1 : sélectionne le bord de l'élément.<br />
* Bouton de la colonne 2 : sélectionne le point de départ de l'élément.<br />
* Bouton de la colonne 3 : sélectionne le point final de l'élément.<br />
* Bouton de la colonne 4 : sélectionne le point central de l'élément.<br />
Cliquer sur le texte a le même effet que de cliquer sur le premier bouton disponible de l'élément.<br />
|-<br />
| {{MenuCommand|Menu contextuel}}<br />
| Un clic droit sur les éléments sélectionnés dans la liste ouvre un menu contextuel. Le menu contient les [[Sketcher_Workbench/fr#Contraintes_géométriques|outils de contrainte géométrique]], les [[Sketcher_Workbench/fr#Contraintes_dimensionnelles|Outils de contrainte dimensionnelle]] et les options supplémentaires suivantes :<br />
* {{MenuCommand|Basculer le mode de la géométrie de construction}} : voir [[Sketcher_ToggleConstruction/fr|Sketcher Basculer en géométrie de construction]].<br />
* {{MenuCommand|Sélectionner les contraintes}} : voir [[Sketcher_SelectConstraints/fr|Sketcher Sélecteur de contraintes associées]].<br />
* {{MenuCommand|Sélectionner l'origine}} : voir [[Sketcher_SelectOrigin/fr|Sketcher Sélectionner l'origine]].<br />
* {{MenuCommand|Sélectionner l'axe horizontal}} : voir [[Sketcher_SelectHorizontalAxis/fr|Sketcher Sélection axe horizontal]].<br />
* {{MenuCommand|Sélectionner l'axe vertical}} : voir [[Sketcher_SelectVerticalAxis/fr|Sketcher Sélection axe vertical]].<br />
* {{MenuCommand|Calque}} : 3 calques sont disponibles :<br />
** {{MenuCommand|Calque 0}} : indiqué comme {{Incode|VL0}} dans les informations étendues. Il s'agit du calque par défaut. Les éléments de ce calque sont affichés avec un type de ligne solide.<br />
** {{MenuCommand|Calque 1}} : indiqué comme {{Incode|VL1}} dans les informations étendues. Les éléments de ce calque sont affichés avec un type de ligne en pointillé.<br />
** {{MenuCommand|Caché}} : indiqué comme {{Incode|VL2}} dans les informations complémentaires. Les éléments de ce calque sont cachés dans l'esquisse.<br />
: L'ordre de rendu des calques 0 et 1 est tel que lors de la sélection de points coïncidents dans la [[3D_view/fr|vue 3D]], les éléments du calque 0 sont sélectionnés en faveur de ceux du calque 1.<br />
* {{MenuCommand|Supprimer}} : supprime les éléments sélectionnés. La touche {{KEY|Suppr}} peut également être utilisée.<br />
|}<br />
</div><br />
<br />
[[Image:Sketcher_Dialog_Elements.png]]<br><br />
''In the image the edge of a line and the center of an arc have been selected.''<br><br />
''The line does not have a button in column 4 as it does not have a center.''<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking elements selected in the list opens a context menu. The menu contains the Geometric [[Sketcher_Workbench#Sketcher_constraints|constraint tools]], the Dimensional constraint tools and the following additional options:<br />
* {{MenuCommand|Toggle construction geometry}}: See [[Sketcher_ToggleConstruction|Sketcher ToggleConstruction]].<br />
* {{MenuCommand|Select Constraints}}: See [[Sketcher_SelectConstraints|Sketcher SelectConstraints]].<br />
* {{MenuCommand|Select Origin}}: See [[Sketcher_SelectOrigin|Sketcher SelectOrigin]].<br />
* {{MenuCommand|Select Horizontal Axis}}: See [[Sketcher_SelectHorizontalAxis|Sketcher SelectHorizontalAxis]].<br />
* {{MenuCommand|Select Vertical Axis}}: See [[Sketcher_SelectVerticalAxis|Sketcher SelectVerticalAxis]].<br />
* {{MenuCommand|Layer}}: 3 layers are available:<br />
** {{MenuCommand|Layer 0}}: Indicated as {{Incode|VL0}} in extended information. This is the default layer. Elements on this layer are displayed with a solid line type.<br />
** {{MenuCommand|Layer 1}}: Indicated as {{Incode|VL1}} in extended information. Elements on this layer are displayed with a dashed line type.<br />
** {{MenuCommand|Hidden}}: Indicated as {{Incode|VL2}} in extended information. Elements on this layer are hidden in the sketch.<br />
: The rendering order of layers 0 and 1 is such that when picking coincident points in the [[3D_view|3D view]] elements on layer 0 are selected in favor of those on layer 1.<br />
* {{MenuCommand|Delete}}: Deletes the selected elements. The {{KEY|Del}} key can also be used.<br />
|}<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/fr<br />
|[[Sketcher_EditSketch/fr|Modifier une esquisse]]<br />
|[[Sketcher_MapSketch/fr|Esquisse sur une face]]<br />
|[[Sketcher_Workbench/fr|Atelier Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_Dialog/de&diff=1388296Sketcher Dialog/de2024-03-28T11:41:30Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/de<br />
|[[Sketcher_EditSketch/de|SkizzeBearbeiten]]<br />
|[[Sketcher_MapSketch/de|SkizzeZuordnen]]<br />
|[[Sketcher_Workbench/de|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{TOCright}}<br />
<br />
<span id="Introduction"></span><br />
== Einleitung ==<br />
<br />
Während eine Skizze bearbeitet wird, oder anders gesagt, während die Skizze im Bearbeitungsmodus ist, wird der Sketcher-Dialog auf der Registerkarte Aufgaben der [[Combo_view/de|Combo-Ansicht]] angezeigt.<br />
<br />
To put a sketch in edit mode see [[Image:Sketcher_EditSketch.svg|16px]] [[Sketcher_EditSketch|Sketcher EditSketch]]. To finish edit mode see [[Image:Sketcher_LeaveSketch.svg|16px]] [[Sketcher_LeaveSketch|Sketcher LeaveSketch]].<br />
<br />
<div class="mw-translate-fuzzy"><br />
Der Dialog besteht aus den folgenden Abschnitten:<br />
</div><br />
<br />
==Tool parameters==<br />
<br />
{{Version|0.22}}<br />
<br />
Some tools add a parameters section at the top of the dialog. Available options and/or modes depend on the tool.<br />
<br />
[[Image:Sketcher_Dialog_Line_parameters.png]]<br />
{{Caption|The parameters section of the [[Sketcher_CreateLine|Sketcher CreateLine]] tool}}<br />
<br />
<span id="Solver_messages"></span><br />
==Meldungen des Lösers==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Dieser Abschnitt informiert über den Zustand der Skizze. Eine Skizze kann unterbestimmt, vollständig bestimmt oder überbestimmt (mit redundant festgelegten Freiheitsgraden) sein.<br />
</div><br />
<br />
The possible messages are:<br />
* Empty sketch<br />
* <span style="color:green;">Fully constrained</span><br />
* Under constrained: <span style="color:blue;text-decoration:underline;">n DoF(s)</span><br />
* <span style="color:red;">Redundant constraints: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
* <span style="color:red;">Over-constrained: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
<br />
<div class="mw-translate-fuzzy"><br />
Ist eine Skizze ist unterbestimmt, wird die Anzahl nicht festgelegter Freiheitsgrade angezeigt. Klickt man darauf, werden die unterbestimmten Skizzenelemente ausgewählt.<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
Besitzt eine Skizze redundant festgelegte Randbedingungen, werden die Indizes der Randbedingungen angezeigt. Klickt man darauf, werden diese Randbedingungen ausgewählt.<br />
</div><br />
<br />
The last two messages are displayed in red for a reason: they are warnings that should not be ignored. They indicate issues that must be addressed as they interfere with the solver.<br />
<br />
The last three messages are not mutually exclusive. If more than one applies only the most important message, occurring lowest in the list, is displayed.<br />
<br />
Vorhandene Optionen:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Beschreibung<br />
|-<br />
| {{Button|[[Image:View-refresh.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Diese Schaltfläche öffnet ein Menü:<br />
* {{MenuCommand|Auto update}}: wenn aktiviert, wird nach jeder Aktion in der Skizze das ganze Modell neu berechnet. Nicht empfohlen für komplexe Dokumente.<br />
|}<br />
<br />
<span id="Advanced_solver_control"></span><br />
==Erweiterte Steuerung des Lösers==<br />
<br />
Dieser Abschnitt wird nur angezeigt, wenn die Option '''Bereich 'Erweiterte Steuerung des Lösers' anzeigen''' in den [[Sketcher_Preferences/de|Voreinstellungen des Sketchers]] aktiviert wurde.<br />
<br />
Beachte, dass die meisten Optionen in diesem Abschnitt haben keinen praktischen Nutzen besitzen. Sie können trotzdem beim Testen und Verstehen der Löser helfen.<br />
<br />
Vorhandene Optionen:<br />
<br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{MenuCommand|Standard-Löser}}<br />
| Der Löser, der zur Lösung der Geometrie verwendet wird. '''[https://de.wikipedia.org/wiki/Levenberg-Marquardt-Algorithmus Levenberg-Marquardt-Algorithmus]''' und '''DogLeg''' ([https://de.wikipedia.org/wiki/Trust-Region-Verfahren Trust-Region-Verfahren]) sind Optimierungsalgorithmen. Der '''BFGS'''-Löser verwendet das [https://de.wikipedia.org/wiki/BFGS-Verfahren Broyden–Fletcher–Goldfarb–Shanno -Verfahren].<br />
|-<br />
| {{MenuCommand|DogLeg Gauss Schritt}}<br />
| Diese Einstellung ist nur für den '''DogLeg'''-Löser verfügbar. Es ist der im DogLeg-Algorithmus verwendete Schritttyp.<br />
|-<br />
| {{MenuCommand|Maximale Iterationszahl}}<br />
| Falls der Löser mehr Iterationen benötigt, um eine Konvergenz für eine Lösung zu finden, wird er anhalten und melden, dass er gescheitert ist.<br />
|-<br />
| {{MenuCommand|Multiplikator der Skizzengröße}}<br />
| Falls aktiviert, wird die Zahl der maximalen Iterationen mit der Anzahl der Parameter multipliziert. Die Idee ist, dass größere Skizzen mehr Iterationen zum Konvergieren benötigen.<br />
|-<br />
| {{MenuCommand|Konvergenz}}<br />
| Der Grenzwert für den Quadratfehler (squared error). Dieser Fehler wird verwendet, um festzustellen, ob eine Lösung konvergiert oder nicht.<br />
|-<br />
| {{MenuCommand|Eps/Eps1/Tau}}<br />
| Diese Einstellungen sind nur für den '''LevenbergMarquardt'''-Löser verfügbar. Du solltest nur dann etwas ändern, wenn du vollständig verstehst, wie der Levenberg-Marquardt-Löser arbeitet.<br />
|-<br />
| {{MenuCommand|Tolg/Tolx/Tolf}}<br />
| Diese Einstellungen sind nur für den '''Dogleg'''-Löser verfügbar. Du solltest nur dann etwas ändern, wenn du vollständig verstehst, wie der Dogleg-Löser arbeitet.<br />
|-<br />
| {{MenuCommand|QR-Algorithmus}}<br />
| Während der Diagnose wird der Rang der Matrix berechnet, was die weitere Analyse des Beschränkungssystem ermöglicht, um festzustellen, ob es redundante/sich widersprechende Beschränkungen gibt. Die 'Rang'-berechnende Zerlegung in FreeCAD ist QR. Es gibt zwei Algorithmen: '''Eigen Dense QR''' ist ein dichte Matrix-QR mit voller Pivotisierung, was ein altbewährter Algorithmus ist, der sehr gut arbeitet, aber ziemlich langsam ist, wenn das System wächst. Der '''Eigen Sparse QR'''-Algoritmus ist eine Optimierung für dünnbesetzte Matrizen (mit vielen Nullen), der üblicherweise viel schneller ist, da FreeCADs Systeme viele Nullen haben.<br />
(''During diagnosing the rank of the matrix is calculated which enables to further analyze the constraint system to determine if there are redundant/conflicting constraints. The rank revealing decomposition used in FreeCAD is QR. There are two algorithms: '''Eigen Dense QR''' is a dense matrix QR with full pivoting, which is the legacy proven algorithm that works very well but it is rather slow as the system grows. The '''Eigen Sparse QR''' algorithm is an optimization for sparse matrices (having lots of zeros), which is usually much faster, since FreeCAD's systems do have a lot of zeros.'')<br />
|-<br />
| {{MenuCommand|Pivot-Grenzwert}}<br />
| Bei der Ausführung des QR-Verfahrens werden Werte unterhalb des Pivot-Grenzwertes als Null behandelt.<br />
|-<br />
| {{MenuCommand|Redundanz-Löser}}<br />
| Der Löser, der während der Diagnose verwendet wird, ob eine Gruppe redundant oder sich widersprechend (conflicting) ist.<br />
|-<br />
| {{MenuCommand|Redundant max. Iterationen}}<br />
| Das Gleiche wie {{MenuCommand|Maximale Iterationszahl}}, aber für das redundante Lösen.<br />
|-<br />
| {{MenuCommand|Redundanter Zeichnungsgrößen-Multplikator}}<br />
| Das Gleiche wie {{MenuCommand|Multiplikator der Skizzengröße}}, aber für das redundante Lösen<br />
|-<br />
| {{MenuCommand|Redundante Konvergenz}}<br />
| Das Gleiche wie {{MenuCommand|Konvergenz}}, aber für das redundante Lösen<br />
|-<br />
| {{MenuCommand|R.Tolg/R.Tolx/R.Tolf}}<br />
| Das Gleiche wie {{MenuCommand|Tolg/Tolx/Tolf}}, aber für das redundante Lösen<br />
|-<br />
| {{MenuCommand|Konsolen-Debug-Modus}}<br />
| Einstellung für die Ausführlichkeit der Konsolenausgaben.<br />
|-<br />
| {{Button|Lösen}}<br />
| Diese Schaltfläche startet den Löser direkt.<br />
|-<br />
| {{Button|Standardeinstellungen wiederherstellen}}<br />
| Dieser Schaltfläche stellt die Standardeinstellungen wieder her.<br />
|}<br />
<br />
<span id="Constraints"></span><br />
==Einschränkungen==<br />
<br />
Dieser Abschnitt listet die Randbedingungen der Skizze. Wird eine Randbedingung in der Liste deaktiviert, wird sie in der Skizze ausgeblendet. Randbedingungen können sowohl in der Liste als auch in der Skizze ausgewählt werden.<br />
<br />
Vorhandene Optionen:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filter [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| If the Filter checkbox is checked the Filter dropdown list controls which constraints are listed:<br />
* {{MenuCommand|All}}: All constraints.<br />
* {{MenuCommand|Geometric}}: Geometric constraints.<br />
* {{MenuCommand|Datums}}: [[Sketcher_ToggleDrivingConstraint|Driving]] dimensional constraints. Does not work properly: all dimensional constraints are filtered.<br />
* {{MenuCommand|Named}}: Named constraints. Does not work.<br />
* {{MenuCommand|Reference}}: [[Sketcher_ToggleDrivingConstraint|Driven]] dimensional constraints. Does not work.<br />
* {{MenuCommand|Selected constraints}}: Constraints selected in the sketch.<br />
* {{MenuCommand|Associated constraints}}: Constraints associated with elements selected in the sketch.<br />
|-<br />
| {{Button|[[Image:Std_ToggleVisibility.svg|x16px]]}}<br />
| This button toggles the visibility of the listed constraints in the sketch.<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Auto constraints}}: If checked, some geometric constraints are applied automatically to new elements.<br />
* {{MenuCommand|Auto remove redundants}}: If checked, new constraints that are redundant are automatically removed.<br />
* {{MenuCommand|Show only filtered Constraints}}: If checked, only the listed constraints are shown in the sketch.<br />
* {{MenuCommand|Extended information (in widget)}}: If checked, extended information is added in this form:<br />
: {{Incode|[(GeoID1,PosID1),(GeoID2,PosID2),(GeoID3,PosID3)]}}<br />
: GeoID is a zero-based index for non-external geometry. The X axis has GeoID -1, the Y axis has GeoID -2. GeoID -3, -4 etc. are used for external geometry.<br />
: PosID can have the following values:<br />
: 0 = edge, 1 = start point, 2 = end point, 3 = center point.<br />
: For example a dimension from the origin to the center of a circle that is the 2nd non-external element in the sketch will have this extended information:<br />
: {{Incode|[(-1,1),(1,3)]}}<br />
* {{MenuCommand|Hide internal alignment (in widget)}}: If checked, constraints associated with internal alignments are hidden in the list. The [[Image:Sketcher_RestoreInternalAlignmentGeometry.svg|16px]] [[Sketcher_RestoreInternalAlignmentGeometry|Show/Hide internal geometry]] tool can also hide these constraints, but will also hide the internal alignments in the sketch.<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking constraints selected in the list opens a context menu. The menu has the following options:<br />
* {{MenuCommand|Change value}}: Changes the value of a dimensional constraint. Only works for a single constraint. You can also double click the constraint in the list, or double click its value in the [[3D_view|3D view]].<br />
* {{MenuCommand|Toggle to/from reference}}: See [[Sketcher_ToggleDrivingConstraint|Sketcher ToggleDrivingConstraint]].<br />
* {{MenuCommand|Deactivate}} or {{MenuCommand|Activate}}: See [[Sketcher_ToggleActiveConstraint|Sketcher ToggleActiveConstraint]].<br />
* {{MenuCommand|Show constraints}}: Same as checking the constraint checkbox. But, unlike the checkbox, also works for more than one constraint.<br />
* {{MenuCommand|Hide constraints}}: Same as unchecking the constraint checkbox. Idem.<br />
* {{MenuCommand|Select Elements}}: See [[Sketcher_SelectElementsAssociatedWithConstraints|Sketcher SelectElementsAssociatedWithConstraints]].<br />
* {{MenuCommand|Rename}}: Renames the constraint.<br />
* {{MenuCommand|Center sketch}}: Centers the 3D view around the selected constraints.<br />
* {{MenuCommand|Delete}}: Deletes the selected constrains. The {{KEY|Del}} key can also be used.<br />
* {{MenuCommand|Swap constraint names}}: Swaps the names of selected constraints. Only works if two constraints with user given names are selected.<br />
|}<br />
<br />
<span id="Elements"></span><br />
==Elemente==<br />
<br />
Dieser Abschnitt listet die Elemente in der Skizze. Wird ein Element in der Liste deaktiviert, wird es in der Skizze ausgeblendet. Elemente können sowohl in der Liste als auch in der Skizze ausgewählt werden.<br />
<br />
Vorhandene Optionen:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filter [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| If the Filter checkbox is checked the Filter dropdown list controls which elements are listed:<br />
* {{MenuCommand|Normal}}: Normal geometry: geometry that does not fall in the next three categories.<br />
* {{MenuCommand|Construction}}: [[Sketcher_ToggleConstruction|Construction geometry]].<br />
* {{MenuCommand|Internal}}: [[Sketcher_RestoreInternalAlignmentGeometry|Internal geometry]].<br />
* {{MenuCommand|External}}: [[Sketcher_External|External geometry]].<br />
* {{MenuCommand|All types}}: All geometry types. Specific types can be selected in the rest of the list:<br />
** {{MenuCommand|Point}}<br />
** {{MenuCommand|Line}}<br />
** {{MenuCommand|Circle}}<br />
** {{MenuCommand|Ellipse}}<br />
** {{MenuCommand|Arc of circle}}<br />
** {{MenuCommand|Arc of ellipse}}<br />
** {{MenuCommand|Arc of hyperbola}}<br />
** {{MenuCommand|Arc of parabola}}<br />
** {{MenuCommand|B-Spline}}<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Extended information}}: If checked, extended element information is provided.<br />
: For non-external geometry the information in the list then changes from:<br />
: {{Incode|<N>-<TYPE>}}<br />
: to:<br />
: {{Incode|<TYPE>(Edge<N>#ID<GeoID>#<VLX>)[-Construction]}}<br />
: <TYPE>: Element type.<br />
: <N>: A 1-based index that indicates the creation order of the element.<br />
: <GeoID>: See under [[#Constraints|Constraints]].<br />
: <VLX>: Element layer. See below.<br />
|-<br />
| [[Image:Sketcher_Element_Arc_Edge.svg|24px]] [[Image:Sketcher_Element_Arc_StartingPoint.svg|24px]] [[Image:Sketcher_Element_Arc_EndPoint.svg|24px]] [[Image:Sketcher_Element_Arc_MidPoint.svg|24px]]<br />
| Each element in the list has 1 to 4 buttons organized in 4 columns. These select a specific part of the element. Only applicable buttons are shown.<br />
* Button in column 1: Selects the edge of the element.<br />
* Button in column 2: Selects the start point of the element.<br />
* Button in column 3: Selects the end point of the element.<br />
* Button in column 4: Selects the center point of the element.<br />
Clicking the text has the same effect as clicking the first available button of the element.<br />
<br />
[[Image:Sketcher_Dialog_Elements.png]]<br><br />
''In the image the edge of a line and the center of an arc have been selected.''<br><br />
''The line does not have a button in column 4 as it does not have a center.''<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking elements selected in the list opens a context menu. The menu contains the Geometric [[Sketcher_Workbench#Sketcher_constraints|constraint tools]], the Dimensional constraint tools and the following additional options:<br />
* {{MenuCommand|Toggle construction geometry}}: See [[Sketcher_ToggleConstruction|Sketcher ToggleConstruction]].<br />
* {{MenuCommand|Select Constraints}}: See [[Sketcher_SelectConstraints|Sketcher SelectConstraints]].<br />
* {{MenuCommand|Select Origin}}: See [[Sketcher_SelectOrigin|Sketcher SelectOrigin]].<br />
* {{MenuCommand|Select Horizontal Axis}}: See [[Sketcher_SelectHorizontalAxis|Sketcher SelectHorizontalAxis]].<br />
* {{MenuCommand|Select Vertical Axis}}: See [[Sketcher_SelectVerticalAxis|Sketcher SelectVerticalAxis]].<br />
* {{MenuCommand|Layer}}: 3 layers are available:<br />
** {{MenuCommand|Layer 0}}: Indicated as {{Incode|VL0}} in extended information. This is the default layer. Elements on this layer are displayed with a solid line type.<br />
** {{MenuCommand|Layer 1}}: Indicated as {{Incode|VL1}} in extended information. Elements on this layer are displayed with a dashed line type.<br />
** {{MenuCommand|Hidden}}: Indicated as {{Incode|VL2}} in extended information. Elements on this layer are hidden in the sketch.<br />
: The rendering order of layers 0 and 1 is such that when picking coincident points in the [[3D_view|3D view]] elements on layer 0 are selected in favor of those on layer 1.<br />
* {{MenuCommand|Delete}}: Deletes the selected elements. The {{KEY|Del}} key can also be used.<br />
|}<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/de<br />
|[[Sketcher_EditSketch/de|SkizzeBearbeiten]]<br />
|[[Sketcher_MapSketch/de|SkizzeZuordnen]]<br />
|[[Sketcher_Workbench/de|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_Dialog/it&diff=1388295Sketcher Dialog/it2024-03-28T11:41:29Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/it<br />
|[[Sketcher_EditSketch/it|Modifica schizzo]]<br />
|[[Sketcher_MapSketch/it|Mappa schizzo su una faccia]]<br />
|[[Sketcher_Workbench/it|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{TOCright}}<br />
<br />
<span id="Introduction"></span><br />
==Introduzione==<br />
<br />
Mentre uno schizzo viene modificato o, in altre parole, mentre uno schizzo è in modalità di modifica, la finestra di dialogo Sketcher viene visualizzata nella scheda Attività della [[Combo_view/it|Vista combinata]].<br />
<br />
To put a sketch in edit mode see [[Image:Sketcher_EditSketch.svg|16px]] [[Sketcher_EditSketch|Sketcher EditSketch]]. To finish edit mode see [[Image:Sketcher_LeaveSketch.svg|16px]] [[Sketcher_LeaveSketch|Sketcher LeaveSketch]].<br />
<br />
<div class="mw-translate-fuzzy"><br />
La finestra di dialogo è composta dalle seguenti sezioni:<br />
</div><br />
<br />
==Tool parameters==<br />
<br />
{{Version|0.22}}<br />
<br />
Some tools add a parameters section at the top of the dialog. Available options and/or modes depend on the tool.<br />
<br />
[[Image:Sketcher_Dialog_Line_parameters.png]]<br />
{{Caption|The parameters section of the [[Sketcher_CreateLine|Sketcher CreateLine]] tool}}<br />
<br />
<span id="Solver_messages"></span><br />
==Messaggi del solutore==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Questa sezione informa sullo stato dello schizzo. Uno schizzo può essere sottovincolato, completamente vincolato o avere vincoli ridondanti.<br />
</div><br />
<br />
The possible messages are:<br />
* Empty sketch<br />
* <span style="color:green;">Fully constrained</span><br />
* Under constrained: <span style="color:blue;text-decoration:underline;">n DoF(s)</span><br />
* <span style="color:red;">Redundant constraints: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
* <span style="color:red;">Over-constrained: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
<br />
<div class="mw-translate-fuzzy"><br />
Se uno schizzo è sottovincolato, viene indicato il numero di gradi di libertà (o Dof). Facendo clic su questo testo verranno selezionati gli elementi dello schizzo sottovincolati.<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
Se uno schizzo presenta vincoli ridondanti vengono indicati gli indici dei vincoli. Facendo clic su quel testo verranno selezionati questi vincoli.<br />
</div><br />
<br />
The last two messages are displayed in red for a reason: they are warnings that should not be ignored. They indicate issues that must be addressed as they interfere with the solver.<br />
<br />
The last three messages are not mutually exclusive. If more than one applies only the most important message, occurring lowest in the list, is displayed.<br />
<br />
Opzioni disponibili:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Opzione<br />
!style="width: 85%;"|Descrizione<br />
|-<br />
| {{Button|[[Image:View-refresh.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Questo pulsante apre un menu:<br />
* {{MenuCommand|Aggiornamento automatico}}: se selezionato, l'intero documento viene ricalcolato dopo ogni azione di schizzo. Non consigliabile per documenti complessi.<br />
|}<br />
<br />
<span id="Advanced_solver_control"></span><br />
==Controlli avanzati del solutore==<br />
<br />
Questa sezione verrà visualizzata solo se si seleziona l'opzione '''Mostra sezione 'Controllo avanzato del solutore'''' nelle [[Sketcher_Preferences/it|preferenze di Sketchcher]].<br />
<br />
Tenere presente che la maggior parte delle opzioni presenti in questa sezione non hanno alcuna utilità pratica. Possono tuttavia aiutare a testare e comprendere i solutori.<br />
<br />
Opzioni disponibili:<br />
<br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Opzione<br />
!style="width: 85%;"|Descrizione<br />
|-<br />
| {{MenuCommand|Risolutore predefinito}}<br />
| Il risolutore utilizzato per risolvere la geometria. '''[https://en.wikipedia.org/wiki/Levenberg%E2%80%93Marquardt_algorithm LevenbergMarquardt]''' e '''DogLeg''' sono [https://en.wikipedia.org/wiki/ Trust_region trust regione] algoritmi di ottimizzazione. Il risolutore '''BFGS''' utilizza l'[https://en.wikipedia.org/wiki/Broyden%E2%80%93Fletcher%E2%80%93Goldfarb%E2%80%93Shanno_algorithm Broyden–Fletcher–Goldfarb–Shanno algoritmo].<br />
|-<br />
| {{MenuCommand|DogLeg per passo di Gauss}}<br />
| Questa impostazione è disponibile solo per il risolutore '''DogLeg'''. È il tipo di passo utilizzato nell'algoritmo DogLeg.<br />
|-<br />
| {{MenuCommand|Numero massimo di iterazioni}}<br />
| Se il risolutore necessita di più iterazioni per trovare una convergenza verso una soluzione, si fermerà e indicherà che ha fallito.<br />
|-<br />
| {{MenuCommand|Moltiplicatore dimensione schizzo}}<br />
| Se selezionato, le iterazioni massime verranno moltiplicate per il numero di parametri. L'idea è che schizzi più grandi avrebbero bisogno di più iterazioni per convergere.<br />
|-<br />
| {{MenuCommand|Convergenza}}<br />
| La soglia per l'errore quadrato. Questo errore viene utilizzato per determinare se una soluzione converge o meno.<br />
|-<br />
| {{MenuCommand|Eps/Eps1/Tau}}<br />
| Queste impostazioni sono disponibili solo per il risolutore '''LevenbergMarquardt'''. Si dovrebbe cambiare qualcosa qui solo se si comprende appieno come funziona il risolutore LevenbergMarquardt.<br />
|-<br />
| {{MenuCommand|Tolg/Tolx/Tolf}}<br />
| Queste impostazioni sono disponibili solo per il risolutore '''DogLeg'''. Si dovrebbe cambiare qualcosa qui solo se si comprende appieno come funziona il risolutore DogLeg.<br />
|-<br />
| {{MenuCommand|Algoritmo QR}}<br />
| Durante la diagnosi viene calcolato il rango della matrice che consente di analizzare ulteriormente il sistema di vincoli per determinare se esistono vincoli ridondanti/conflittuali. La scomposizione rivelatrice del rango utilizzata in FreeCAD è QR. Esistono due algoritmi: '''Eigen Dense QR''' è un QR a matrice densa con rotazione completa, che è l'algoritmo collaudato legacy che funziona molto bene ma è piuttosto lento man mano che il sistema cresce. L'algoritmo '''Eigen Sparse QR''' è un'ottimizzazione per matrici sparse (con molti zeri), che di solito è molto più veloce, poiché i sistemi di FreeCAD hanno molti zeri.<br />
|-<br />
| {{MenuCommand|Soglia pivot}}<br />
| Quando si esegue un QR, i valori inferiori alla soglia pivot vengono trattati come zero.<br />
|-<br />
| {{MenuCommand|Risolutore ridondanze}}<br />
| Il risolutore utilizzato durante la diagnosi per determinare se un gruppo è ridondante o in conflitto.<br />
|-<br />
| {{MenuCommand|Iterazioni massime ridondanti}}<br />
| Uguale a {{MenuCommand|Iterazioni massime}}, ma per la risoluzione delle ridondanze.<br />
|-<br />
| {{MenuCommand|Moltiplicatore della dimensione dello schizzo per le rid.}}<br />
| Uguale a {{MenuCommand|Moltiplicatore dimensione schizzo}}, ma per la risoluzione delle ridondanze.<br />
|-<br />
| {{MenuCommand|Convergenza delle ridondanze}}<br />
| Lo stesso di {{MenuCommand|Convergence}}, ma per la risoluzione delle ridondanze.<br />
|-<br />
| {{MenuCommand|R.Eps/R.Eps1/R.Tau}}<br />
| Lo stesso di {{MenuCommand|Eps/Eps1/Tau}}, ma per la risoluzione delle ridondanze.<br />
|-<br />
| {{MenuCommand|R.Tolg/R.Tolx/R.Tolf}}<br />
| Uguale a {{MenuCommand|Tolg/Tolx/Tolf}}, ma per la risoluzione delle ridondanze.<br />
|-<br />
| {{MenuCommand|Modalità debug della console}}<br />
| Impostazione per specificare la verbosità dell'output della console.<br />
|-<br />
| {{Button|Risolvi}}<br />
| Questo pulsante avvia esplicitamente il risolutore.<br />
|-<br />
| {{Button|Ripristina impostazioni predefinite}}<br />
| Questo pulsante ripristina le impostazioni predefinite del risolutore.<br />
|}<br />
<br />
<span id="Constraints"></span><br />
== Vincoli ==<br />
<br />
Questa sezione elenca i vincoli nello schizzo. Deselezionando un vincolo nell'elenco lo si nasconderà nello schizzo. I vincoli possono essere selezionati sia nell'elenco che nello schizzo.<br />
<br />
Opzioni disponibili:<br />
<br />
<div class="mw-translate-fuzzy"><br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Opzione<br />
!style="width: 85%;"|Descrizione<br />
|-<br />
| {{Button|Filtro [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Se la casella di controllo Filtro è selezionata, l'elenco a discesa Filtro controlla quali vincoli sono elencati:<br />
* {{MenuCommand|Tutti}}: tutti i vincoli.<br />
* {{MenuCommand|Geometrico}}: vincoli geometrici.<br />
* {{MenuCommand|Dati}}: [[Sketcher_ToggleDrivingConstraint|Driving]] vincoli dimensionali. Non funziona correttamente: tutti i vincoli dimensionali vengono filtrati.<br />
* {{MenuCommand|Denominazione}}: vincoli denominati. Non funziona.<br />
* {{MenuCommand|Riferimento}}: [[Sketcher_ToggleDrivingConstraint|Driven]] vincoli dimensionali. Non funziona.<br />
* {{MenuCommand|Vincoli selezionati}}: vincoli selezionati nello schizzo.<br />
* {{MenuCommand|Vincoli associati}}: vincoli associati agli elementi selezionati nello schizzo.<br />
|-<br />
| {{Button|[[Image:Std_ToggleVisibility.svg|x16px]]}}<br />
| Questo pulsante attiva/disattiva la visibilità dei vincoli elencati nello schizzo.<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Questo pulsante apre un menu:<br />
* {{MenuCommand|Vincoli automatici}}: Se selezionato, alcuni vincoli geometrici vengono applicati automaticamente ai nuovi elementi.<br />
* {{MenuCommand|Rimuovi automaticamente i ridondanti}}: se selezionato, i nuovi vincoli ridondanti verranno rimossi automaticamente.<br />
* {{MenuCommand|Mostra solo vincoli filtrati}}: se selezionato, solo i vincoli elencati verranno mostrati nello schizzo.<br />
* {{MenuCommand|Informazioni estese (nel widget)}}: se selezionato, le informazioni estese vengono aggiunte in questo modulo:<br />
: {{Incode|[(GeoID1,PosID1),(GeoID2,PosID2),(GeoID3,PosID3)]}}<br />
: GeoID è un indice in base zero per la geometria non esterna. L'asse X ha GeoID -1, l'asse Y ha GeoID -2. GeoID -3, -4 ecc. vengono utilizzati per la geometria esterna.<br />
: PosID può avere i seguenti valori:<br />
: 0 = bordo, 1 = punto iniziale, 2 = punto finale, 3 = punto centrale.<br />
: Ad esempio, una quota dall'origine al centro di un cerchio che è il 2° elemento non esterno nello schizzo avrà queste informazioni estese:<br />
: {{Incode|[(-1,1),(1,3)]}}<br />
* {{MenuCommand|Nascondi allineamento interno (nel widget)}}: se selezionato, i vincoli associati agli allineamenti interni vengono nascosti nell'elenco. Lo strumento [[File:Sketcher_Element_Ellipse_All.svg|16px]] [[Sketcher_RestoreInternalAlignmentGeometry|Mostra/Nascondi geometria interna]] può anche nascondere questi vincoli, ma nasconderà anche gli allineamenti interni nello schizzo.<br />
|-<br />
| {{MenuCommand|Menu contestuale}}<br />
| Facendo clic con il pulsante destro del mouse sui vincoli selezionati nell'elenco si apre un menu contestuale. Il menu presenta le seguenti opzioni:<br />
* {{MenuCommand|Cambia valore}}: modifica il valore di un vincolo dimensionale. Funziona solo per un singolo vincolo.<br />
* {{MenuCommand|Attiva/disattiva riferimento}}: vedere [[Sketcher_ToggleDrivingConstraint|Sketcher ToggleDrivingConstraint]].<br />
* {{MenuCommand|Disattiva}} o {{MenuCommand|Attiva}}: vedere [[Sketcher_ToggleActiveConstraint/it|Sketcher ToggleActiveConstraint]].<br />
* {{MenuCommand|Visualizza i vincoli}}: equivale a selezionare la casella di controllo dei vincoli. Ma, a differenza della casella di controllo, funziona anche per più di un vincolo.<br />
* {{MenuCommand|Nascondi i vincoli}}: equivale a deselezionare la casella di controllo dei vincoli. Idem.<br />
* {{MenuCommand|Seleziona Elementi}}: vedere [[Sketcher_SelectElementsAssociatedWithConstraints|Sketcher SelectElementsAssociatedWithConstraints]].<br />
* {{MenuCommand|Rinomina}}: rinomina il vincolo.<br />
* {{MenuCommand|Centra lo schizzo}}: Centra la vista 3D attorno ai vincoli selezionati.<br />
* {{MenuCommand|Elimina}}: Elimina i vincoli selezionati. È possibile utilizzare anche il tasto {{KEY|Canc}}.<br />
* {{MenuCommand|Scambia i nomi dei vincoli}}: scambia i nomi dei vincoli selezionati. Funziona solo se sono selezionati due vincoli con nomi utente.<br />
|}<br />
</div><br />
<br />
<span id="Elements"></span><br />
== Elementi ==<br />
<br />
Questa sezione elenca gli elementi nello schizzo. Deselezionando un elemento nell'elenco lo si nasconderà nello schizzo. Gli elementi possono essere selezionati sia nell'elenco che nello schizzo.<br />
<br />
Opzioni disponibili:<br />
<br />
<div class="mw-translate-fuzzy"><br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Opzione<br />
!style="width: 85%;"|Descrizione<br />
|-<br />
| {{Button|Filtro [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Se la casella di controllo Filtro è selezionata, l'elenco a discesa Filtro controlla quali elementi sono elencati:<br />
* {{MenuCommand|Normale}}: Geometria normale: geometria che non rientra nelle tre categorie successive.<br />
* {{MenuCommand|Costruzione}}: [[Sketcher_ToggleConstruction/it|Geometria della costruzione]].<br />
* {{MenuCommand|Interna}}: [[Sketcher_RestoreInternalAlignmentGeometry/it|Geometria interna]].<br />
* {{MenuCommand|Esterna}}: [[Sketcher_External/it|Geometria esterna]].<br />
* {{MenuCommand|Tutti i tipi}}: tutti i tipi di geometria. È possibile selezionare tipi specifici nel resto dell'elenco:<br />
** {{MenuCommand|Punto}}<br />
** {{MenuCommand|Linea}}<br />
** {{MenuCommand|Cerchio}}<br />
** {{MenuCommand|Ellisse}}<br />
** {{MenuCommand|Arco di cerchio}}<br />
** {{MenuCommand|Arco di ellisse}}<br />
** {{MenuCommand|Arco di iperbole}}<br />
** {{MenuCommand|Arco di parabola}}<br />
** {{MenuCommand|B-Spline}}<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Questo pulsante apre un menu:<br />
* {{MenuCommand|Informazioni estese}}: se selezionato, vengono fornite informazioni estese sull'elemento.<br />
: Per la geometria non esterna le informazioni nell'elenco cambiano da:<br />
: {{Incode|<N>-<TIPO>}}<br />
: A:<br />
: {{Incode|<TYPE>(Bordo<N>#ID<GeoID>#<VLX>)[-Costruzione]}}<br />
: <TYPE>: tipo di elemento.<br />
: <N>: un indice in base 1 che indica l'ordine di creazione dell'elemento.<br />
: <GeoID>: vedere sotto [[#Constraints|Vincoli]].<br />
: <VLX>: Livello elemento. Vedere sotto.<br />
|-<br />
| [[Image:Sketcher_Element_Arc_Edge.svg|24px]] [[Image:Sketcher_Element_Arc_StartingPoint.svg|24px]] [[Image:Sketcher_Element_Arc_EndPoint.svg|24px]] [[Image:Sketcher_Element_Arc_MidPoint.svg|24px]]<br />
| Ogni elemento nell'elenco ha da 1 a 4 pulsanti organizzati in 4 colonne. Questi selezionano una parte specifica dell'elemento. Vengono visualizzati solo i pulsanti applicabili.<br />
* Pulsante nella colonna 1: seleziona il bordo dell'elemento.<br />
* Pulsante nella colonna 2: seleziona il punto iniziale dell'elemento.<br />
* Pulsante nella colonna 3: seleziona il punto finale dell'elemento.<br />
* Pulsante nella colonna 4: seleziona il punto centrale dell'elemento.<br />
Fare clic sul testo ha lo stesso effetto che fare clic sul primo pulsante disponibile dell'elemento.<br />
|-<br />
| {{MenuCommand|Menu contestuale}}<br />
| Facendo clic con il pulsante destro del mouse sugli elementi selezionati nell'elenco si apre un menu contestuale. Il menu contiene gli [[Sketcher_Workbench/it#Vincoli_geometrici|Strumenti di vincolo geometrico]], gli [[Sketcher_Workbench/it#Vincoli_dimensionali|Strumenti di vincolo dimensionale]] e le seguenti opzioni aggiuntive:<br />
* {{MenuCommand|Attiva/disattiva geometria di costruzione}}: vedere [[Sketcher_ToggleConstruction/it|Sketcher Geometria di costruzione]].<br />
* {{MenuCommand|Seleziona vincoli}}: vedere [[Sketcher_SelectConstraints/it|Sketcher Seleziona i vincoli]].<br />
* {{MenuCommand|Seleziona origine}}: vedere [[Sketcher_SelectOrigin/it|Sketcher Seleziona l'origine]].<br />
* {{MenuCommand|Seleziona asse orizzontale}}: vedere [[Sketcher_SelectHorizontalAxis/it|Sketcher Seleziona l'asse orizzontale]].<br />
* {{MenuCommand|Seleziona asse verticale}}: vedere [[Sketcher_SelectVerticalAxis/it|Sketcher Seleziona l'asse verticale]].<br />
* {{MenuCommand|Livello}}: sono disponibili 3 livelli:<br />
** {{MenuCommand|Livello 0}}: indicato come {{Incode|VL0}} nelle informazioni estese. Questo è il livello predefinito. Gli elementi su questo livello vengono visualizzati con un tipo di linea continua.<br />
** {{MenuCommand|Livello 1}}: indicato come {{Incode|VL1}} nelle informazioni estese. Gli elementi su questo livello vengono visualizzati con un tipo di linea tratteggiata.<br />
** {{MenuCommand|Nascosto}}: indicato come {{Incode|VL2}} nelle informazioni estese. Gli elementi su questo livello sono nascosti nello schizzo.<br />
: L'ordine di rendering dei livelli 0 e 1 è tale che quando si selezionano punti coincidenti nella [[3D_view/it|Vista 3D]] gli elementi sul livello 0 vengono selezionati a favore di quelli sul livello 1.<br />
* {{MenuCommand|Elimina}}: Elimina gli elementi selezionati. È possibile utilizzare anche il tasto {{KEY|Canc}}.<br />
|}<br />
</div><br />
<br />
[[Image:Sketcher_Dialog_Elements.png]]<br><br />
''In the image the edge of a line and the center of an arc have been selected.''<br><br />
''The line does not have a button in column 4 as it does not have a center.''<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking elements selected in the list opens a context menu. The menu contains the Geometric [[Sketcher_Workbench#Sketcher_constraints|constraint tools]], the Dimensional constraint tools and the following additional options:<br />
* {{MenuCommand|Toggle construction geometry}}: See [[Sketcher_ToggleConstruction|Sketcher ToggleConstruction]].<br />
* {{MenuCommand|Select Constraints}}: See [[Sketcher_SelectConstraints|Sketcher SelectConstraints]].<br />
* {{MenuCommand|Select Origin}}: See [[Sketcher_SelectOrigin|Sketcher SelectOrigin]].<br />
* {{MenuCommand|Select Horizontal Axis}}: See [[Sketcher_SelectHorizontalAxis|Sketcher SelectHorizontalAxis]].<br />
* {{MenuCommand|Select Vertical Axis}}: See [[Sketcher_SelectVerticalAxis|Sketcher SelectVerticalAxis]].<br />
* {{MenuCommand|Layer}}: 3 layers are available:<br />
** {{MenuCommand|Layer 0}}: Indicated as {{Incode|VL0}} in extended information. This is the default layer. Elements on this layer are displayed with a solid line type.<br />
** {{MenuCommand|Layer 1}}: Indicated as {{Incode|VL1}} in extended information. Elements on this layer are displayed with a dashed line type.<br />
** {{MenuCommand|Hidden}}: Indicated as {{Incode|VL2}} in extended information. Elements on this layer are hidden in the sketch.<br />
: The rendering order of layers 0 and 1 is such that when picking coincident points in the [[3D_view|3D view]] elements on layer 0 are selected in favor of those on layer 1.<br />
* {{MenuCommand|Delete}}: Deletes the selected elements. The {{KEY|Del}} key can also be used.<br />
|}<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/it<br />
|[[Sketcher_EditSketch/it|Modifica schizzo]]<br />
|[[Sketcher_MapSketch/it|Mappa schizzo su una faccia]]<br />
|[[Sketcher_Workbench/it|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_Dialog/pl&diff=1388294Sketcher Dialog/pl2024-03-28T11:41:28Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/pl<br />
|[[Sketcher_EditSketch/pl|Edycja szkicu]]<br />
|[[Sketcher_MapSketch/pl|Mapuj szkic na powierzchnię ...]]<br />
|[[Sketcher_Workbench/pl|środowisko pracy Szkicownik]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{TOCright}}<br />
<br />
<span id="Introduction"></span><br />
==Wprowadzenie==<br />
<br />
Podczas edycji szkicu lub, innymi słowy, gdy szkic jest w trybie edycji, okno dialogowe szkicownika jest wyświetlane na karcie Zadanie w panelu [[Combo_view/pl|Widoku złożonego]].<br />
<br />
To put a sketch in edit mode see [[Image:Sketcher_EditSketch.svg|16px]] [[Sketcher_EditSketch|Sketcher EditSketch]]. To finish edit mode see [[Image:Sketcher_LeaveSketch.svg|16px]] [[Sketcher_LeaveSketch|Sketcher LeaveSketch]].<br />
<br />
<div class="mw-translate-fuzzy"><br />
Okno dialogowe składa się z następujących sekcji:<br />
</div><br />
<br />
==Tool parameters==<br />
<br />
{{Version|0.22}}<br />
<br />
Some tools add a parameters section at the top of the dialog. Available options and/or modes depend on the tool.<br />
<br />
[[Image:Sketcher_Dialog_Line_parameters.png]]<br />
{{Caption|The parameters section of the [[Sketcher_CreateLine|Sketcher CreateLine]] tool}}<br />
<br />
<span id="Solver_messages"></span><br />
==Komunikaty solvera==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Ta część informuje o stanie szkicu, czy jest on niedostatecznie lub nadmiernie związany oraz ile stopni swobody ma szkic. Szkic może być częściowo związany, w pełni związany lub mieć nadmiarowe wiązania.<br />
</div><br />
<br />
The possible messages are:<br />
* Empty sketch<br />
* <span style="color:green;">Fully constrained</span><br />
* Under constrained: <span style="color:blue;text-decoration:underline;">n DoF(s)</span><br />
* <span style="color:red;">Redundant constraints: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
* <span style="color:red;">Over-constrained: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
<br />
<div class="mw-translate-fuzzy"><br />
Jeśli szkic jest nie w pełni związany, wskazana jest liczba stopni swobody ''(lub Dofs)''. Kliknięcie tego tekstu spowoduje wybranie elementów szkicu podlegających więzom.<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
Jeśli szkic ma nadmiarowe wiązania, wskazane są ich indeksy. Kliknięcie tego tekstu spowoduje wybranie tych więzów.<br />
</div><br />
<br />
The last two messages are displayed in red for a reason: they are warnings that should not be ignored. They indicate issues that must be addressed as they interfere with the solver.<br />
<br />
The last three messages are not mutually exclusive. If more than one applies only the most important message, occurring lowest in the list, is displayed.<br />
<br />
Dostępne opcje:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Opcja<br />
!style="width: 85%;"|Opis<br />
|-<br />
| {{Button|[[Image:View-refresh.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Ten przycisk otwiera menu:<br />
* {{MenuCommand|Aktualizuj automatycznie}}: Jeśli opcja jest zaznaczona, cały dokument jest ponownie obliczany po każdej akcji na szkicu. Niewskazane dla złożonych dokumentów.<br />
|}<br />
<br />
<span id="Advanced_solver_control"></span><br />
==Zaawansowana kontrola solvera==<br />
<br />
Ta sekcja pojawi się tylko wtedy, gdy zaznaczysz opcję '''Pokaż sekcję ''Zaawansowane sterowanie solverem''''' w [[Sketcher_Preferences/pl|ustawieniach szkicownika]].<br />
<br />
Zauważ, że większość opcji w tej sekcji nie ma praktycznego zastosowania. Mogą one jednak pomóc w testowaniu i zrozumieniu solverów.<br />
<br />
Dostępne opcje:<br />
<br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Opcja<br />
!style="width: 85%;"|Opis<br />
|-<br />
| {{MenuCommand|Domyślny solver}}<br />
| Solver, który jest używany do rozwiązywania geometrii. ''[https://en.wikipedia.org/wiki/Levenberg%E2%80%93Marquardt_algorithm LevenbergMarquardt]'' i '''DogLeg''' to [https://en.wikipedia.org/wiki/Trust_region region zaufania] algorytmy optymalizacyjne. Solver '''BFGS'''' wykorzystuje [https://en.wikipedia.org/wiki/Broyden%E2%80%93Fletcher%E2%80%93Goldfarb%E2%80%93Shanno_algorithm algorytm Broyden-Fletcher-Goldfarb-Shanno].<br />
|-<br />
| {{MenuCommand|Krok Gauss DogLeg}}<br />
| To ustawienie jest dostępne tylko dla solvera '''DogLeg'''. Jest to typ kroku używany w algorytmie DogLeg.<br />
|-<br />
| {{MenuCommand|Maksymalna liczba kolejnych kroków}}<br />
| Jeśli solver potrzebuje więcej kroków, aby znaleźć zbieżność do rozwiązania, zatrzyma się i napisze, że się nie udało.<br />
|-<br />
| {{MenuCommand|Mnożnik dla rozmiaru szkicu}}<br />
| Jeśli opcja jest zaznaczona, maksymalna liczba powtórzeń zostanie pomnożona przez liczbę parametrów. Chodzi o to, że większe szkice będą potrzebowały większej liczby iteracji, aby się zrównać.<br />
|-<br />
| {{MenuCommand|Zbieżność}}<br />
| Próg dla błędu kwadratowego. Ten błąd jest używany do określenia, czy rozwiązanie jest zbieżne, czy nie.<br />
|-<br />
| {{MenuCommand|Eps/Eps1/Tau}}<br />
| Ustawienia te są dostępne tylko dla solwera '''LevenbergMarquardt'''. Powinieneś zmieniać tam coś tylko wtedy, gdy w pełni rozumiesz jak działa solver LevenbergMarquardt.<br />
|-<br />
| {{MenuCommand|Tolg/Tolx/Tolf}}<br />
| Te ustawienia są dostępne tylko dla solwera '''DogLeg'''. Powinieneś zmieniać tam coś tylko wtedy, gdy w pełni rozumiesz jak działa solver DogLeg.<br />
|-<br />
| {{MenuCommand|Algorytm QR}}<br />
| Podczas diagnozowania obliczana jest ranga macierzy, która umożliwia dalszą analizę układu wiązań w celu określenia, czy istnieją nadmiarowe / konfliktowe wiązania. Dekompozycja ujawniająca rangę używana w programie FreeCAD to QR. Istnieją dwa algorytmy: '''Eigen Dense QR''' jest to gęsta macierz QR z pełnym przestawieniem, co jest sprawdzonym algorytmem, który działa bardzo dobrze, ale jest raczej powolny, gdy układ rozrasta się. Algorytm '''Eigen Sparse QR''' jest optymalizacją dla macierzy rzadkich ''(mających dużo zer)'', który jest zwykle znacznie szybszy, ponieważ systemy FreeCAD mają dużo zer.<br />
|-<br />
| {{MenuCommand|Próg przestawny}}<br />
| W przypadku QR przyjmuje się wartości poniżej przestawnej wartości progowej są traktowane jako zero.<br />
|-<br />
| {{MenuCommand|Solver nadmiarowy}}<br />
| Solver, który jest używany podczas diagnozowania, aby określić, czy grupa jest zbędna lub konfliktowa.<br />
|-<br />
| {{MenuCommand|Maksymalna liczba kolejnych kroków solvera nadmiarowego}}<br />
| To samo co {{MenuCommand|Maksymalna liczba kolejnych kroków}}, ale dla solvera nadmiarowego.<br />
|-<br />
| {{MenuCommand|Mnożnik dla rozmiaru szkicu solvera nadmiarowego}}<br />
| To samo co {{MenuCommand|Mnożnik dla rozmiaru szkicu}}, ale dla solvera nadmiarowego.<br />
|-<br />
| {{MenuCommand|Zbieżność solvera nadmiarowego}} <br />
| To samo co {{MenuCommand|Zbieżność}}, ale dla solvera nadmiarowego.<br />
|-<br />
| {{MenuCommand|R.Eps/R.Eps1/R.Tau}}<br />
| To samo co {{MenuCommand|Eps/Eps1/Tau}}, ale dla solvera nadmiarowego.<br />
|-<br />
| {{MenuCommand|R.Tolg/R.Tolx/R.Tolf}}<br />
| To samo co {{MenuCommand|Tolg/Tolx/Tolf}}, ale dla solvera nadmiarowego.<br />
|-<br />
| {{MenuCommand|Tryb debugowania w konsoli}}<br />
| Ustawienie określające szczegółowość komunikatów w konsoli.<br />
|-<br />
| {{Button|Rozwiąż}}<br />
| Za pomocą tego przycisku nastąpi natychmiastowe uruchomienie solvera.<br />
|-<br />
| {{Button|Przywróć nastawy domyślne}}<br />
| Ten przycisk przywraca domyślne ustawienia solwera.<br />
|}<br />
<br />
<span id="Constraints"></span><br />
==Wiązania==<br />
<br />
W tej części znajduje się lista wiązań szkicu. Usunięcie zaznaczenia wiązania na liście spowoduje jego ukrycie w szkicu. Wiązania można wybierać zarówno na liście, jak i w szkicu.<br />
<br />
Dostępne opcje:<br />
<br />
<div class="mw-translate-fuzzy"><br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Opcja<br />
!style="width: 85%;"|Opis<br />
|-<br />
| {{Button|Filtry [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Jeśli pole wyboru Filtr jest zaznaczone, rozwijana lista kontroluje, które wiązania będą wyświetlane poniżej:<br />
* {{MenuCommand|Wszystkie}}: Wszystkie więzy.<br />
* {{MenuCommand|Geometryczne}}: Wiązania geometryczne.<br />
* {{MenuCommand|Odniesienia}}: [[Sketcher_ToggleDrivingConstraint/pl|Kontrolujące]] więzy wymiarowe. Nie działa poprawnie: wszystkie ograniczenia wymiarowe są filtrowane.<br />
* {{MenuCommand|Nazwane}}: Wiązania z nazwą. Nie działa.<br />
* {{MenuCommand|Odniesienie}}: [[Sketcher_ToggleDrivingConstraint/pl|Kontrolujące]] więzy wymiarowe. Nie działa.<br />
* {{MenuCommand|Wybrane wiązania}}: Wiązania zaznaczone w szkicu.<br />
* {{MenuCommand|Powiązane wiązania}}: Więzy związane z elementami wybranymi w szkicu.<br />
|-<br />
| {{Button|[[Image:Std_ToggleVisibility.svg|x16px]]}}<br />
| Ten przycisk przełącza widoczność wymienionych wiązań w szkicu.<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Ten przycisk otwiera menu podręczne:<br />
* {{MenuCommand|Wiązania automatyczne}}: Jeśli opcja jest zaznaczona, niektóre wiązania geometryczne są automatycznie stosowane do nowych elementów.<br />
* {{MenuCommand|Usuń wiązania nadmiarowe automatycznie}}: Jeśli opcja jest zaznaczona, nowe wiązania, które są zbędne, będą automatycznie usuwane.<br />
* {{MenuCommand|Pokazuj wyłącznie wiązania według filtrów}}: Jeśli opcja ta jest zaznaczona, na szkicu będą widoczne tylko wybrane wiązania.<br />
* {{MenuCommand|Informacje rozszerzone (w widżecie)}}: Jeśli opcja jest zaznaczona, w tym formularzu dodawane są rozszerzone informacje:<br />
: {{Incode|[(GeoID1,PosID1),(GeoID2,PosID2),(GeoID3,PosID3)]}}<br />
: GeoID jest indeksem o wartości zero dla geometrii niezewnętrznej. Oś X ma GeoID -1, oś Y ma GeoID -2. Dla geometrii zewnętrznej stosuje się GeoID -3, -4 itd.<br />
: PosID może mieć następujące wartości:<br />
: 0 = krawędź, 1 = punkt początkowy, 2 = punkt końcowy, 3 = punkt środkowy.<br />
: Na przykład wymiar od początku do środka okręgu, który jest 2. niezewnętrznym elementem w szkicu, będzie miał następująco rozszerzoną informację:<br />
: {{Incode|[(-1,1),(1,3)]}}<br />
* {{MenuCommand|Ukryj wyrównanie wewnętrzne (w widżecie)}}: Jeśli opcja jest zaznaczona, więzy związane z wewnętrznymi wyrównaniami są ukryte na liście. Narzędzie [[File:Sketcher_Element_Ellipse_All.svg|16px]] [[Sketcher_RestoreInternalAlignmentGeometry/pl|Pokaż / ukryj geometrię wewnętrzną]] może również ukryć te wiązania, ale ukryje również wewnętrzne wyrównania w szkicu.<br />
|-<br />
| {{MenuCommand|Menu podręczne}}<br />
| Kliknięcie prawym przyciskiem myszy na wybranych na liście wiązaniach otwiera menu kontekstowe. Menu zawiera następujące opcje:<br />
* {{MenuCommand|Zmień wartość}}: Zmienia wartość wiązania wymiarowego. Działa tylko dla pojedynczego ograniczenia.<br />
* {{MenuCommand|Przełącz z / do trybu konstrukcyjnego}}: zobacz stronę [[Sketcher_ToggleDrivingConstraint/pl|Przełącz kontrolę wiązania]].<br />
* {{MenuCommand|Dezaktywuj}} or {{MenuCommand|Aktywuj}}: zobacz stronę [[Sketcher_ToggleActiveConstraint/pl|Przełącz aktywność wiązania]].<br />
* {{MenuCommand|Pokaż wiązania}}: To samo działanie co zaznaczenie pola wyboru wiązania. Ale w przeciwieństwie do pola wyboru, działa również dla więcej niż jednego wiązania.<br />
* {{MenuCommand|Ukryj wiązania}}: To samo działanie co odzanaczenie pola wyboru wiązania. Jak wyżej.<br />
* {{MenuCommand|Zaznacz elementy w szkicu}}: zobacz stronę [[Sketcher_SelectElementsAssociatedWithConstraints/pl|Wybierz powiązaną geometrię]].<br />
* {{MenuCommand|Zmień nazwę}}: Umożliwia zmianę nazwy wiązania.<br />
* {{MenuCommand|Wyśrodkuj szkic}}: Wyśrodkowuje widok 3D wokół wybranych wiązań.<br />
* {{MenuCommand|Usuń}}: Usuwa wybrane więzy. Można również użyć klawisza {{KEY|Del}}.<br />
* {{MenuCommand|Zamień nazwy wiązań}}: Zamienia nazwy wybranych więzów. Działa tylko wtedy, gdy wybrane są dwa wiązania o nazwach podanych przez użytkownika.<br />
|}<br />
</div><br />
<br />
<span id="Elements"></span><br />
==Elementy==<br />
<br />
W tej części znajduje się lista elementów szkicu. Usunięcie zaznaczenia elementu na liście spowoduje jego ukrycie w szkicu. Elementy można wybierać zarówno na liście, jak i w szkicu.<br />
<br />
Dostępne opcje:<br />
<br />
<div class="mw-translate-fuzzy"><br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Opcja<br />
!style="width: 85%;"|Opis<br />
|-<br />
| {{Button|Filtry [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Jeśli pole wyboru Filtr jest zaznaczone, rozwijana lista kontroluje, które wiązania będą wyświetlane poniżej:<br />
* {{MenuCommand|Normalny}}: Normal geometry: geometry that does not fall in the next three categories.<br />
* {{MenuCommand|Konstrukcyjny}}: [[Sketcher_ToggleConstruction|Construction geometry]].<br />
* {{MenuCommand|Wewnętrzne}}: [[Sketcher_RestoreInternalAlignmentGeometry|Internal geometry]].<br />
* {{MenuCommand|Zewnętrzne}}: [[Sketcher_External|External geometry]].<br />
* {{MenuCommand|Wszystkie rodzaje}}: All geometry types. Specific types can be selected in the rest of the list:<br />
** {{MenuCommand|Punkt}}<br />
** {{MenuCommand|Linia}}<br />
** {{MenuCommand|Okrąg}}<br />
** {{MenuCommand|Elipsa}}<br />
** {{MenuCommand|Łuk okręgu}}<br />
** {{MenuCommand|Łuk elipsy}}<br />
** {{MenuCommand|Łuk hiperboli}}<br />
** {{MenuCommand|Łuk paraboli}}<br />
** {{MenuCommand|Krzywa złożona}}<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| Ten przycisk otwiera menu podręczne:<br />
* {{MenuCommand|Informacje rozszerzone}}: Jeśli opcja jest zaznaczona, wyświetlane są rozszerzone informacje o elemencie.<br />
: Dla geometrii niezewnętrznej informacje na liście zmieniają się wówczas z:<br />
: {{Incode|<N>-<TYPE>}}<br />
: na:<br />
: {{Incode|<TYPE>(Edge<N>#ID<GeoID>#<VLX>)[-Construction]}}<br />
: <TYPE>: Typ elementu.<br />
: <N>: Indeks o wartości 1, który wskazuje na kolejność tworzenia elementu.<br />
: <GeoID>: Patrz akapit [[#Wiązania|Wiązania]]<br />
: <VLX>: Warstwa elementu. Zobacz poniżej.<br />
|-<br />
| [[Image:Sketcher_Element_Arc_Edge.svg|24px]] [[Image:Sketcher_Element_Arc_StartingPoint.svg|24px]] [[Image:Sketcher_Element_Arc_EndPoint.svg|24px]] [[Image:Sketcher_Element_Arc_MidPoint.svg|24px]]<br />
| Każdy element na liście ma od 1 do 4 przycisków zorganizowanych w 4 kolumnach. Wybierają one określoną część elementu. Pokazane są tylko przyciski mające zastosowanie.<br />
* Przycisk w kolumnie 1: wybiera krawędź elementu.<br />
* Przycisk w kolumnie 2: wybiera punkt początkowy elementu.<br />
* Przycisk w kolumnie 3: Wybiera punkt końcowy elementu.<br />
* Przycisk w kolumnie 4: Wybiera punkt środkowy elementu.<br />
Kliknięcie tekstu ma taki sam efekt jak kliknięcie pierwszego dostępnego przycisku elementu.<br />
|-<br />
| {{MenuCommand|Menu podręczne}}<br />
| Kliknięcie prawym przyciskiem myszy elementów zaznaczonych na liście otwiera menu podręczne. Menu zawiera narzędzia [[Sketcher_Workbench/pl#Więzy_geometrii|Narzędzia wiązań geometrycznych]], [[Sketcher_Workbench/pl#Wiązania_wymiarów|Narzędzia ograniczeń wymiarowych]] oraz następujące opcje dodatkowe:<br />
* {{MenuCommand|Przełącz tryb konstrukcji}}: Zobacz stronę [[Sketcher_ToggleConstruction/pl|Przełącz tryb konstrukcji]].<br />
* {{MenuCommand|Wybierz powiązane więzy}}: Zobacz stronę [[Sketcher_SelectConstraints/pl|Wybierz powiązane więzy]].<br />
* {{MenuCommand|Wybierz odniesienie położenia}}: Zobacz stronę [[Sketcher_SelectOrigin/pl|Wybierz odniesienie położenia]].<br />
* {{MenuCommand|Wybierz oś poziomą}}: Zobacz stronę [[Sketcher_SelectHorizontalAxis/pl|Wybierz oś poziomą]].<br />
* {{MenuCommand|Wybierz oś pionową}}: Zobacz stronę [[Sketcher_SelectVerticalAxis/pl|Wybierz oś pionową]].<br />
* {{MenuCommand|Warstwa}}: dostępne są trzy opcje:<br />
** {{MenuCommand|Warstwa 0}}: Wskazana jako {{Incode|VL0}} w informacji rozszerzonej. Jest to warstwa domyślna. Elementy na tej warstwie są wyświetlane za pomocą linii ciągłej.<br />
** {{MenuCommand|Warstwa 1}}: Wskazane jako {{Incode|VL1}} w rozszerzonej informacji. Elementy na tej warstwie wyświetlane są za pomocą typu linii przerywanej.<br />
** {{MenuCommand|Ukryte}}: Wskazane jako {{Incode|VL2}} w rozszerzonych informacjach. Elementy na tej warstwie są ukryte w szkicu.<br />
: Kolejność renderowania warstw 0 i 1 jest taka, że podczas wybierania punktów zbieżnych w oknie [[3D_view/pl|widoku 3D]] elementy na warstwie 0 są wybierane priorytetowo względem tych na warstwie 1.<br />
* {{MenuCommand|Usuń}}: Usuwa zaznaczone elementy. Można również użyć klawisza {{KEY|Del}}.<br />
|}<br />
</div><br />
<br />
[[Image:Sketcher_Dialog_Elements.png]]<br><br />
''In the image the edge of a line and the center of an arc have been selected.''<br><br />
''The line does not have a button in column 4 as it does not have a center.''<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking elements selected in the list opens a context menu. The menu contains the Geometric [[Sketcher_Workbench#Sketcher_constraints|constraint tools]], the Dimensional constraint tools and the following additional options:<br />
* {{MenuCommand|Toggle construction geometry}}: See [[Sketcher_ToggleConstruction|Sketcher ToggleConstruction]].<br />
* {{MenuCommand|Select Constraints}}: See [[Sketcher_SelectConstraints|Sketcher SelectConstraints]].<br />
* {{MenuCommand|Select Origin}}: See [[Sketcher_SelectOrigin|Sketcher SelectOrigin]].<br />
* {{MenuCommand|Select Horizontal Axis}}: See [[Sketcher_SelectHorizontalAxis|Sketcher SelectHorizontalAxis]].<br />
* {{MenuCommand|Select Vertical Axis}}: See [[Sketcher_SelectVerticalAxis|Sketcher SelectVerticalAxis]].<br />
* {{MenuCommand|Layer}}: 3 layers are available:<br />
** {{MenuCommand|Layer 0}}: Indicated as {{Incode|VL0}} in extended information. This is the default layer. Elements on this layer are displayed with a solid line type.<br />
** {{MenuCommand|Layer 1}}: Indicated as {{Incode|VL1}} in extended information. Elements on this layer are displayed with a dashed line type.<br />
** {{MenuCommand|Hidden}}: Indicated as {{Incode|VL2}} in extended information. Elements on this layer are hidden in the sketch.<br />
: The rendering order of layers 0 and 1 is such that when picking coincident points in the [[3D_view|3D view]] elements on layer 0 are selected in favor of those on layer 1.<br />
* {{MenuCommand|Delete}}: Deletes the selected elements. The {{KEY|Del}} key can also be used.<br />
|}<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/pl<br />
|[[Sketcher_EditSketch/pl|Edycja szkicu]]<br />
|[[Sketcher_MapSketch/pl|Mapuj szkic na powierzchnię ...]]<br />
|[[Sketcher_Workbench/pl|środowisko pracy Szkicownik]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_Dialog/ko&diff=1388293Sketcher Dialog/ko2024-03-28T11:41:26Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_EditSketch|Edit sketch]]<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{TOCright}}<br />
<br />
==Introduction==<br />
<br />
While a sketch is being edited, or, in other words, while a sketch is in edit mode, the Sketcher Dialog is displayed on the Task tab of the [[Combo_view|Combo view]].<br />
<br />
To put a sketch in edit mode see [[Image:Sketcher_EditSketch.svg|16px]] [[Sketcher_EditSketch|Sketcher EditSketch]]. To finish edit mode see [[Image:Sketcher_LeaveSketch.svg|16px]] [[Sketcher_LeaveSketch|Sketcher LeaveSketch]].<br />
<br />
The Sketcher Dialog has the following sections:<br />
<br />
==Tool parameters==<br />
<br />
{{Version|0.22}}<br />
<br />
Some tools add a parameters section at the top of the dialog. Available options and/or modes depend on the tool.<br />
<br />
[[Image:Sketcher_Dialog_Line_parameters.png]]<br />
{{Caption|The parameters section of the [[Sketcher_CreateLine|Sketcher CreateLine]] tool}}<br />
<br />
==Solver messages==<br />
<br />
This section informs about the state of the sketch.<br />
<br />
The possible messages are:<br />
* Empty sketch<br />
* <span style="color:green;">Fully constrained</span><br />
* Under constrained: <span style="color:blue;text-decoration:underline;">n DoF(s)</span><br />
* <span style="color:red;">Redundant constraints: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
* <span style="color:red;">Over-constrained: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
<br />
If a sketch is under-constrained the number of degrees of freedom (or DoFs) is indicated. Clicking the underlined text will select the under-constrained sketch elements. See [[Image:Sketcher_SelectElementsWithDoFs.svg|16px]] [[Sketcher_SelectElementsWithDoFs|Sketcher SelectElementsWithDoFs]].<br />
<br />
If a sketch has redundant constraints or is over-constrained the indices of the involved constraints are indicated. Clicking the underlined text will select them. See [[Image:Sketcher_SelectRedundantConstraints.svg|16px]] [[Sketcher_SelectRedundantConstraints|Sketcher SelectRedundantConstraints]] and [[Image:Sketcher_SelectConflictingConstraints.svg|16px]] [[Sketcher_SelectConflictingConstraints|Sketcher SelectConflictingConstraints]].<br />
<br />
The last two messages are displayed in red for a reason: they are warnings that should not be ignored. They indicate issues that must be addressed as they interfere with the solver.<br />
<br />
The last three messages are not mutually exclusive. If more than one applies only the most important message, occurring lowest in the list, is displayed.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|[[Image:View-refresh.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Auto update}}: If checked, the whole document is recomputed after every sketch action. Not advisable for complex documents.<br />
|}<br />
<br />
==Advanced solver control==<br />
<br />
This section will only appear if you check the '''Show section 'Advanced solver control'''' option in the [[Sketcher_Preferences|sketcher preferences]].<br />
<br />
Note that most of the options in this section are of no practical use. They can however help with testing and understanding the solvers.<br />
<br />
Available options:<br />
<br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{MenuCommand|Default solver}}<br />
| The solver that is used for solving the geometry. '''[https://en.wikipedia.org/wiki/Levenberg%E2%80%93Marquardt_algorithm LevenbergMarquardt]''' and '''DogLeg''' are [https://en.wikipedia.org/wiki/Trust_region trust region] optimization algorithms. The '''BFGS''' solver uses the [https://en.wikipedia.org/wiki/Broyden%E2%80%93Fletcher%E2%80%93Goldfarb%E2%80%93Shanno_algorithm Broyden–Fletcher–Goldfarb–Shanno algorithm].<br />
|-<br />
| {{MenuCommand|DogLeg Gauss step}}<br />
| This setting is only available for the solver '''DogLeg'''. It is the step type used in the DogLeg algorithm.<br />
|-<br />
| {{MenuCommand|Maximum iterations}}<br />
| If the solver needs more iterations to find a convergence to a solution, it will stop and output that it failed.<br />
|-<br />
| {{MenuCommand|Sketch size multiplier}}<br />
| If checked, the maximum iterations will be multiplied by the number of parameters. The idea is that bigger sketches would need more iterations to converge.<br />
|-<br />
| {{MenuCommand|Convergence}}<br />
| The threshold for the squared error. This error is used to determine whether a solution converges or not.<br />
|-<br />
| {{MenuCommand|Eps/Eps1/Tau}}<br />
| These settings are only available for the solver '''LevenbergMarquardt'''. You should only change something here if you fully understand how the LevenbergMarquardt solver works.<br />
|-<br />
| {{MenuCommand|Tolg/Tolx/Tolf}}<br />
| These settings are only available for the solver '''DogLeg'''. You should only change something here if you fully understand how the DogLeg solver works.<br />
|-<br />
| {{MenuCommand|QR Algorithm}}<br />
| During diagnosing the rank of the matrix is calculated which enables to further analyze the constraint system to determine if there are redundant/conflicting constraints. The rank revealing decomposition used in FreeCAD is QR. There are two algorithms: '''Eigen Dense QR''' is a dense matrix QR with full pivoting, which is the legacy proven algorithm that works very well but it is rather slow as the system grows. The '''Eigen Sparse QR''' algorithm is an optimization for sparse matrices (having lots of zeros), which is usually much faster, since FreeCAD's systems do have a lot of zeros.<br />
|-<br />
| {{MenuCommand|Pivot threshold}}<br />
| When doing a QR, values under the pivot threshold are treated as zero.<br />
|-<br />
| {{MenuCommand|Redundant Solver}}<br />
| The solver that is used during diagnosing to determine whether a group is redundant or conflicting.<br />
|-<br />
| {{MenuCommand|Red. Max Iterations}}<br />
| The same as {{MenuCommand|Maximum iterations}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Red. Sketch size multiplier}}<br />
| The same as {{MenuCommand|Sketch size multiplier}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Red. Convergence}} <br />
| The same as {{MenuCommand|Convergence}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|R.Eps/R.Eps1/R.Tau}}<br />
| The same as {{MenuCommand|Eps/Eps1/Tau}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|R.Tolg/R.Tolx/R.Tolf}}<br />
| The same as {{MenuCommand|Tolg/Tolx/Tolf}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Console Debug mode}}<br />
| Setting to specify the verbosity of the console output.<br />
|-<br />
| {{Button|Solve}}<br />
| This button explicitly starts the solver.<br />
|-<br />
| {{Button|Restore Defaults}}<br />
| This button restores the default solver settings.<br />
|}<br />
<br />
==Constraints==<br />
<br />
This section lists the constraints in the sketch. Unchecking a constraint in the list will hide it in the sketch. Constraints can be selected in the list as well as in the sketch.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filter [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| If the Filter checkbox is checked the Filter dropdown list controls which constraints are listed:<br />
* {{MenuCommand|All}}: All constraints.<br />
* {{MenuCommand|Geometric}}: Geometric constraints.<br />
* {{MenuCommand|Datums}}: [[Sketcher_ToggleDrivingConstraint|Driving]] dimensional constraints. Does not work properly: all dimensional constraints are filtered.<br />
* {{MenuCommand|Named}}: Named constraints. Does not work.<br />
* {{MenuCommand|Reference}}: [[Sketcher_ToggleDrivingConstraint|Driven]] dimensional constraints. Does not work.<br />
* {{MenuCommand|Selected constraints}}: Constraints selected in the sketch.<br />
* {{MenuCommand|Associated constraints}}: Constraints associated with elements selected in the sketch.<br />
|-<br />
| {{Button|[[Image:Std_ToggleVisibility.svg|x16px]]}}<br />
| This button toggles the visibility of the listed constraints in the sketch.<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Auto constraints}}: If checked, some geometric constraints are applied automatically to new elements.<br />
* {{MenuCommand|Auto remove redundants}}: If checked, new constraints that are redundant are automatically removed.<br />
* {{MenuCommand|Show only filtered Constraints}}: If checked, only the listed constraints are shown in the sketch.<br />
* {{MenuCommand|Extended information (in widget)}}: If checked, extended information is added in this form:<br />
: {{Incode|[(GeoID1,PosID1),(GeoID2,PosID2),(GeoID3,PosID3)]}}<br />
: GeoID is a zero-based index for non-external geometry. The X axis has GeoID -1, the Y axis has GeoID -2. GeoID -3, -4 etc. are used for external geometry.<br />
: PosID can have the following values:<br />
: 0 = edge, 1 = start point, 2 = end point, 3 = center point.<br />
: For example a dimension from the origin to the center of a circle that is the 2nd non-external element in the sketch will have this extended information:<br />
: {{Incode|[(-1,1),(1,3)]}}<br />
* {{MenuCommand|Hide internal alignment (in widget)}}: If checked, constraints associated with internal alignments are hidden in the list. The [[Image:Sketcher_RestoreInternalAlignmentGeometry.svg|16px]] [[Sketcher_RestoreInternalAlignmentGeometry|Show/Hide internal geometry]] tool can also hide these constraints, but will also hide the internal alignments in the sketch.<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking constraints selected in the list opens a context menu. The menu has the following options:<br />
* {{MenuCommand|Change value}}: Changes the value of a dimensional constraint. Only works for a single constraint. You can also double click the constraint in the list, or double click its value in the [[3D_view|3D view]].<br />
* {{MenuCommand|Toggle to/from reference}}: See [[Sketcher_ToggleDrivingConstraint|Sketcher ToggleDrivingConstraint]].<br />
* {{MenuCommand|Deactivate}} or {{MenuCommand|Activate}}: See [[Sketcher_ToggleActiveConstraint|Sketcher ToggleActiveConstraint]].<br />
* {{MenuCommand|Show constraints}}: Same as checking the constraint checkbox. But, unlike the checkbox, also works for more than one constraint.<br />
* {{MenuCommand|Hide constraints}}: Same as unchecking the constraint checkbox. Idem.<br />
* {{MenuCommand|Select Elements}}: See [[Sketcher_SelectElementsAssociatedWithConstraints|Sketcher SelectElementsAssociatedWithConstraints]].<br />
* {{MenuCommand|Rename}}: Renames the constraint.<br />
* {{MenuCommand|Center sketch}}: Centers the 3D view around the selected constraints.<br />
* {{MenuCommand|Delete}}: Deletes the selected constrains. The {{KEY|Del}} key can also be used.<br />
* {{MenuCommand|Swap constraint names}}: Swaps the names of selected constraints. Only works if two constraints with user given names are selected.<br />
|}<br />
<br />
==Elements==<br />
<br />
This section lists the elements in the sketch. Unchecking an element in the list will hide it in the sketch. Elements can be selected in the list as well as in the sketch.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filter [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| If the Filter checkbox is checked the Filter dropdown list controls which elements are listed:<br />
* {{MenuCommand|Normal}}: Normal geometry: geometry that does not fall in the next three categories.<br />
* {{MenuCommand|Construction}}: [[Sketcher_ToggleConstruction|Construction geometry]].<br />
* {{MenuCommand|Internal}}: [[Sketcher_RestoreInternalAlignmentGeometry|Internal geometry]].<br />
* {{MenuCommand|External}}: [[Sketcher_External|External geometry]].<br />
* {{MenuCommand|All types}}: All geometry types. Specific types can be selected in the rest of the list:<br />
** {{MenuCommand|Point}}<br />
** {{MenuCommand|Line}}<br />
** {{MenuCommand|Circle}}<br />
** {{MenuCommand|Ellipse}}<br />
** {{MenuCommand|Arc of circle}}<br />
** {{MenuCommand|Arc of ellipse}}<br />
** {{MenuCommand|Arc of hyperbola}}<br />
** {{MenuCommand|Arc of parabola}}<br />
** {{MenuCommand|B-Spline}}<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Extended information}}: If checked, extended element information is provided.<br />
: For non-external geometry the information in the list then changes from:<br />
: {{Incode|<N>-<TYPE>}}<br />
: to:<br />
: {{Incode|<TYPE>(Edge<N>#ID<GeoID>#<VLX>)[-Construction]}}<br />
: <TYPE>: Element type.<br />
: <N>: A 1-based index that indicates the creation order of the element.<br />
: <GeoID>: See under [[#Constraints|Constraints]].<br />
: <VLX>: Element layer. See below.<br />
|-<br />
| [[Image:Sketcher_Element_Arc_Edge.svg|24px]] [[Image:Sketcher_Element_Arc_StartingPoint.svg|24px]] [[Image:Sketcher_Element_Arc_EndPoint.svg|24px]] [[Image:Sketcher_Element_Arc_MidPoint.svg|24px]]<br />
| Each element in the list has 1 to 4 buttons organized in 4 columns. These select a specific part of the element. Only applicable buttons are shown.<br />
* Button in column 1: Selects the edge of the element.<br />
* Button in column 2: Selects the start point of the element.<br />
* Button in column 3: Selects the end point of the element.<br />
* Button in column 4: Selects the center point of the element.<br />
Clicking the text has the same effect as clicking the first available button of the element.<br />
<br />
[[Image:Sketcher_Dialog_Elements.png]]<br><br />
''In the image the edge of a line and the center of an arc have been selected.''<br><br />
''The line does not have a button in column 4 as it does not have a center.''<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking elements selected in the list opens a context menu. The menu contains the Geometric [[Sketcher_Workbench#Sketcher_constraints|constraint tools]], the Dimensional constraint tools and the following additional options:<br />
* {{MenuCommand|Toggle construction geometry}}: See [[Sketcher_ToggleConstruction|Sketcher ToggleConstruction]].<br />
* {{MenuCommand|Select Constraints}}: See [[Sketcher_SelectConstraints|Sketcher SelectConstraints]].<br />
* {{MenuCommand|Select Origin}}: See [[Sketcher_SelectOrigin|Sketcher SelectOrigin]].<br />
* {{MenuCommand|Select Horizontal Axis}}: See [[Sketcher_SelectHorizontalAxis|Sketcher SelectHorizontalAxis]].<br />
* {{MenuCommand|Select Vertical Axis}}: See [[Sketcher_SelectVerticalAxis|Sketcher SelectVerticalAxis]].<br />
* {{MenuCommand|Layer}}: 3 layers are available:<br />
** {{MenuCommand|Layer 0}}: Indicated as {{Incode|VL0}} in extended information. This is the default layer. Elements on this layer are displayed with a solid line type.<br />
** {{MenuCommand|Layer 1}}: Indicated as {{Incode|VL1}} in extended information. Elements on this layer are displayed with a dashed line type.<br />
** {{MenuCommand|Hidden}}: Indicated as {{Incode|VL2}} in extended information. Elements on this layer are hidden in the sketch.<br />
: The rendering order of layers 0 and 1 is such that when picking coincident points in the [[3D_view|3D view]] elements on layer 0 are selected in favor of those on layer 1.<br />
* {{MenuCommand|Delete}}: Deletes the selected elements. The {{KEY|Del}} key can also be used.<br />
|}<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_EditSketch|Edit sketch]]<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_Dialog/en&diff=1388292Sketcher Dialog/en2024-03-28T11:41:25Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_EditSketch|Edit sketch]]<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{TOCright}}<br />
<br />
==Introduction==<br />
<br />
While a sketch is being edited, or, in other words, while a sketch is in edit mode, the Sketcher Dialog is displayed on the Task tab of the [[Combo_view|Combo view]].<br />
<br />
To put a sketch in edit mode see [[Image:Sketcher_EditSketch.svg|16px]] [[Sketcher_EditSketch|Sketcher EditSketch]]. To finish edit mode see [[Image:Sketcher_LeaveSketch.svg|16px]] [[Sketcher_LeaveSketch|Sketcher LeaveSketch]].<br />
<br />
The Sketcher Dialog has the following sections:<br />
<br />
==Tool parameters==<br />
<br />
{{Version|0.22}}<br />
<br />
Some tools add a parameters section at the top of the dialog. Available options and/or modes depend on the tool.<br />
<br />
[[Image:Sketcher_Dialog_Line_parameters.png]]<br />
{{Caption|The parameters section of the [[Sketcher_CreateLine|Sketcher CreateLine]] tool}}<br />
<br />
==Solver messages==<br />
<br />
This section informs about the state of the sketch.<br />
<br />
The possible messages are:<br />
* Empty sketch<br />
* <span style="color:green;">Fully constrained</span><br />
* Under constrained: <span style="color:blue;text-decoration:underline;">n DoF(s)</span><br />
* <span style="color:red;">Redundant constraints: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
* <span style="color:red;">Over-constrained: </span><span style="color:blue;text-decoration:underline;">(#, #, #)</span><br />
<br />
If a sketch is under-constrained the number of degrees of freedom (or DoFs) is indicated. Clicking the underlined text will select the under-constrained sketch elements. See [[Image:Sketcher_SelectElementsWithDoFs.svg|16px]] [[Sketcher_SelectElementsWithDoFs|Sketcher SelectElementsWithDoFs]].<br />
<br />
If a sketch has redundant constraints or is over-constrained the indices of the involved constraints are indicated. Clicking the underlined text will select them. See [[Image:Sketcher_SelectRedundantConstraints.svg|16px]] [[Sketcher_SelectRedundantConstraints|Sketcher SelectRedundantConstraints]] and [[Image:Sketcher_SelectConflictingConstraints.svg|16px]] [[Sketcher_SelectConflictingConstraints|Sketcher SelectConflictingConstraints]].<br />
<br />
The last two messages are displayed in red for a reason: they are warnings that should not be ignored. They indicate issues that must be addressed as they interfere with the solver.<br />
<br />
The last three messages are not mutually exclusive. If more than one applies only the most important message, occurring lowest in the list, is displayed.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|[[Image:View-refresh.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Auto update}}: If checked, the whole document is recomputed after every sketch action. Not advisable for complex documents.<br />
|}<br />
<br />
==Advanced solver control==<br />
<br />
This section will only appear if you check the '''Show section 'Advanced solver control'''' option in the [[Sketcher_Preferences|sketcher preferences]].<br />
<br />
Note that most of the options in this section are of no practical use. They can however help with testing and understanding the solvers.<br />
<br />
Available options:<br />
<br />
{| class="wikitable mw-collapsible mw-collapsed"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{MenuCommand|Default solver}}<br />
| The solver that is used for solving the geometry. '''[https://en.wikipedia.org/wiki/Levenberg%E2%80%93Marquardt_algorithm LevenbergMarquardt]''' and '''DogLeg''' are [https://en.wikipedia.org/wiki/Trust_region trust region] optimization algorithms. The '''BFGS''' solver uses the [https://en.wikipedia.org/wiki/Broyden%E2%80%93Fletcher%E2%80%93Goldfarb%E2%80%93Shanno_algorithm Broyden–Fletcher–Goldfarb–Shanno algorithm].<br />
|-<br />
| {{MenuCommand|DogLeg Gauss step}}<br />
| This setting is only available for the solver '''DogLeg'''. It is the step type used in the DogLeg algorithm.<br />
|-<br />
| {{MenuCommand|Maximum iterations}}<br />
| If the solver needs more iterations to find a convergence to a solution, it will stop and output that it failed.<br />
|-<br />
| {{MenuCommand|Sketch size multiplier}}<br />
| If checked, the maximum iterations will be multiplied by the number of parameters. The idea is that bigger sketches would need more iterations to converge.<br />
|-<br />
| {{MenuCommand|Convergence}}<br />
| The threshold for the squared error. This error is used to determine whether a solution converges or not.<br />
|-<br />
| {{MenuCommand|Eps/Eps1/Tau}}<br />
| These settings are only available for the solver '''LevenbergMarquardt'''. You should only change something here if you fully understand how the LevenbergMarquardt solver works.<br />
|-<br />
| {{MenuCommand|Tolg/Tolx/Tolf}}<br />
| These settings are only available for the solver '''DogLeg'''. You should only change something here if you fully understand how the DogLeg solver works.<br />
|-<br />
| {{MenuCommand|QR Algorithm}}<br />
| During diagnosing the rank of the matrix is calculated which enables to further analyze the constraint system to determine if there are redundant/conflicting constraints. The rank revealing decomposition used in FreeCAD is QR. There are two algorithms: '''Eigen Dense QR''' is a dense matrix QR with full pivoting, which is the legacy proven algorithm that works very well but it is rather slow as the system grows. The '''Eigen Sparse QR''' algorithm is an optimization for sparse matrices (having lots of zeros), which is usually much faster, since FreeCAD's systems do have a lot of zeros.<br />
|-<br />
| {{MenuCommand|Pivot threshold}}<br />
| When doing a QR, values under the pivot threshold are treated as zero.<br />
|-<br />
| {{MenuCommand|Redundant Solver}}<br />
| The solver that is used during diagnosing to determine whether a group is redundant or conflicting.<br />
|-<br />
| {{MenuCommand|Red. Max Iterations}}<br />
| The same as {{MenuCommand|Maximum iterations}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Red. Sketch size multiplier}}<br />
| The same as {{MenuCommand|Sketch size multiplier}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Red. Convergence}} <br />
| The same as {{MenuCommand|Convergence}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|R.Eps/R.Eps1/R.Tau}}<br />
| The same as {{MenuCommand|Eps/Eps1/Tau}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|R.Tolg/R.Tolx/R.Tolf}}<br />
| The same as {{MenuCommand|Tolg/Tolx/Tolf}}, but for the redundant solving.<br />
|-<br />
| {{MenuCommand|Console Debug mode}}<br />
| Setting to specify the verbosity of the console output.<br />
|-<br />
| {{Button|Solve}}<br />
| This button explicitly starts the solver.<br />
|-<br />
| {{Button|Restore Defaults}}<br />
| This button restores the default solver settings.<br />
|}<br />
<br />
==Constraints==<br />
<br />
This section lists the constraints in the sketch. Unchecking a constraint in the list will hide it in the sketch. Constraints can be selected in the list as well as in the sketch.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filter [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| If the Filter checkbox is checked the Filter dropdown list controls which constraints are listed:<br />
* {{MenuCommand|All}}: All constraints.<br />
* {{MenuCommand|Geometric}}: Geometric constraints.<br />
* {{MenuCommand|Datums}}: [[Sketcher_ToggleDrivingConstraint|Driving]] dimensional constraints. Does not work properly: all dimensional constraints are filtered.<br />
* {{MenuCommand|Named}}: Named constraints. Does not work.<br />
* {{MenuCommand|Reference}}: [[Sketcher_ToggleDrivingConstraint|Driven]] dimensional constraints. Does not work.<br />
* {{MenuCommand|Selected constraints}}: Constraints selected in the sketch.<br />
* {{MenuCommand|Associated constraints}}: Constraints associated with elements selected in the sketch.<br />
|-<br />
| {{Button|[[Image:Std_ToggleVisibility.svg|x16px]]}}<br />
| This button toggles the visibility of the listed constraints in the sketch.<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Auto constraints}}: If checked, some geometric constraints are applied automatically to new elements.<br />
* {{MenuCommand|Auto remove redundants}}: If checked, new constraints that are redundant are automatically removed.<br />
* {{MenuCommand|Show only filtered Constraints}}: If checked, only the listed constraints are shown in the sketch.<br />
* {{MenuCommand|Extended information (in widget)}}: If checked, extended information is added in this form:<br />
: {{Incode|[(GeoID1,PosID1),(GeoID2,PosID2),(GeoID3,PosID3)]}}<br />
: GeoID is a zero-based index for non-external geometry. The X axis has GeoID -1, the Y axis has GeoID -2. GeoID -3, -4 etc. are used for external geometry.<br />
: PosID can have the following values:<br />
: 0 = edge, 1 = start point, 2 = end point, 3 = center point.<br />
: For example a dimension from the origin to the center of a circle that is the 2nd non-external element in the sketch will have this extended information:<br />
: {{Incode|[(-1,1),(1,3)]}}<br />
* {{MenuCommand|Hide internal alignment (in widget)}}: If checked, constraints associated with internal alignments are hidden in the list. The [[Image:Sketcher_RestoreInternalAlignmentGeometry.svg|16px]] [[Sketcher_RestoreInternalAlignmentGeometry|Show/Hide internal geometry]] tool can also hide these constraints, but will also hide the internal alignments in the sketch.<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking constraints selected in the list opens a context menu. The menu has the following options:<br />
* {{MenuCommand|Change value}}: Changes the value of a dimensional constraint. Only works for a single constraint. You can also double click the constraint in the list, or double click its value in the [[3D_view|3D view]].<br />
* {{MenuCommand|Toggle to/from reference}}: See [[Sketcher_ToggleDrivingConstraint|Sketcher ToggleDrivingConstraint]].<br />
* {{MenuCommand|Deactivate}} or {{MenuCommand|Activate}}: See [[Sketcher_ToggleActiveConstraint|Sketcher ToggleActiveConstraint]].<br />
* {{MenuCommand|Show constraints}}: Same as checking the constraint checkbox. But, unlike the checkbox, also works for more than one constraint.<br />
* {{MenuCommand|Hide constraints}}: Same as unchecking the constraint checkbox. Idem.<br />
* {{MenuCommand|Select Elements}}: See [[Sketcher_SelectElementsAssociatedWithConstraints|Sketcher SelectElementsAssociatedWithConstraints]].<br />
* {{MenuCommand|Rename}}: Renames the constraint.<br />
* {{MenuCommand|Center sketch}}: Centers the 3D view around the selected constraints.<br />
* {{MenuCommand|Delete}}: Deletes the selected constrains. The {{KEY|Del}} key can also be used.<br />
* {{MenuCommand|Swap constraint names}}: Swaps the names of selected constraints. Only works if two constraints with user given names are selected.<br />
|}<br />
<br />
==Elements==<br />
<br />
This section lists the elements in the sketch. Unchecking an element in the list will hide it in the sketch. Elements can be selected in the list as well as in the sketch.<br />
<br />
Available options:<br />
<br />
{| class="wikitable"<br />
!style="width: 15%;"|Option<br />
!style="width: 85%;"|Description<br />
|-<br />
| {{Button|Filter [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| If the Filter checkbox is checked the Filter dropdown list controls which elements are listed:<br />
* {{MenuCommand|Normal}}: Normal geometry: geometry that does not fall in the next three categories.<br />
* {{MenuCommand|Construction}}: [[Sketcher_ToggleConstruction|Construction geometry]].<br />
* {{MenuCommand|Internal}}: [[Sketcher_RestoreInternalAlignmentGeometry|Internal geometry]].<br />
* {{MenuCommand|External}}: [[Sketcher_External|External geometry]].<br />
* {{MenuCommand|All types}}: All geometry types. Specific types can be selected in the rest of the list:<br />
** {{MenuCommand|Point}}<br />
** {{MenuCommand|Line}}<br />
** {{MenuCommand|Circle}}<br />
** {{MenuCommand|Ellipse}}<br />
** {{MenuCommand|Arc of circle}}<br />
** {{MenuCommand|Arc of ellipse}}<br />
** {{MenuCommand|Arc of hyperbola}}<br />
** {{MenuCommand|Arc of parabola}}<br />
** {{MenuCommand|B-Spline}}<br />
|-<br />
| {{Button|[[Image:Sketcher_Settings.svg|x16px]] [[Image:Toolbar_flyout_arrow.svg|x16px]]}}<br />
| This button opens a menu:<br />
* {{MenuCommand|Extended information}}: If checked, extended element information is provided.<br />
: For non-external geometry the information in the list then changes from:<br />
: {{Incode|<N>-<TYPE>}}<br />
: to:<br />
: {{Incode|<TYPE>(Edge<N>#ID<GeoID>#<VLX>)[-Construction]}}<br />
: <TYPE>: Element type.<br />
: <N>: A 1-based index that indicates the creation order of the element.<br />
: <GeoID>: See under [[#Constraints|Constraints]].<br />
: <VLX>: Element layer. See below.<br />
|-<br />
| [[Image:Sketcher_Element_Arc_Edge.svg|24px]] [[Image:Sketcher_Element_Arc_StartingPoint.svg|24px]] [[Image:Sketcher_Element_Arc_EndPoint.svg|24px]] [[Image:Sketcher_Element_Arc_MidPoint.svg|24px]]<br />
| Each element in the list has 1 to 4 buttons organized in 4 columns. These select a specific part of the element. Only applicable buttons are shown.<br />
* Button in column 1: Selects the edge of the element.<br />
* Button in column 2: Selects the start point of the element.<br />
* Button in column 3: Selects the end point of the element.<br />
* Button in column 4: Selects the center point of the element.<br />
Clicking the text has the same effect as clicking the first available button of the element.<br />
<br />
[[Image:Sketcher_Dialog_Elements.png]]<br><br />
''In the image the edge of a line and the center of an arc have been selected.''<br><br />
''The line does not have a button in column 4 as it does not have a center.''<br />
|-<br />
| {{MenuCommand|Context menu}}<br />
| Right-clicking elements selected in the list opens a context menu. The menu contains the Geometric [[Sketcher_Workbench#Sketcher_constraints|constraint tools]], the Dimensional constraint tools and the following additional options:<br />
* {{MenuCommand|Toggle construction geometry}}: See [[Sketcher_ToggleConstruction|Sketcher ToggleConstruction]].<br />
* {{MenuCommand|Select Constraints}}: See [[Sketcher_SelectConstraints|Sketcher SelectConstraints]].<br />
* {{MenuCommand|Select Origin}}: See [[Sketcher_SelectOrigin|Sketcher SelectOrigin]].<br />
* {{MenuCommand|Select Horizontal Axis}}: See [[Sketcher_SelectHorizontalAxis|Sketcher SelectHorizontalAxis]].<br />
* {{MenuCommand|Select Vertical Axis}}: See [[Sketcher_SelectVerticalAxis|Sketcher SelectVerticalAxis]].<br />
* {{MenuCommand|Layer}}: 3 layers are available:<br />
** {{MenuCommand|Layer 0}}: Indicated as {{Incode|VL0}} in extended information. This is the default layer. Elements on this layer are displayed with a solid line type.<br />
** {{MenuCommand|Layer 1}}: Indicated as {{Incode|VL1}} in extended information. Elements on this layer are displayed with a dashed line type.<br />
** {{MenuCommand|Hidden}}: Indicated as {{Incode|VL2}} in extended information. Elements on this layer are hidden in the sketch.<br />
: The rendering order of layers 0 and 1 is such that when picking coincident points in the [[3D_view|3D view]] elements on layer 0 are selected in favor of those on layer 1.<br />
* {{MenuCommand|Delete}}: Deletes the selected elements. The {{KEY|Del}} key can also be used.<br />
|}<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_EditSketch|Edit sketch]]<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Translations:Sketcher_Dialog/25/en&diff=1388291Translations:Sketcher Dialog/25/en2024-03-28T11:41:24Z<p>FuzzyBot: Importing a new version from external source</p>
<hr />
<div>{{Docnav<br />
|[[Sketcher_EditSketch|Edit sketch]]<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Translations:Sketcher_Dialog/1/en&diff=1388290Translations:Sketcher Dialog/1/en2024-03-28T11:41:24Z<p>FuzzyBot: Importing a new version from external source</p>
<hr />
<div>{{Docnav<br />
|[[Sketcher_EditSketch|Edit sketch]]<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_EditSketch.svg<br />
|IconR=Sketcher_MapSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/fr&diff=1388288Sketcher ReorientSketch/fr2024-03-28T11:40:55Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/fr<br />
|[[Sketcher_MapSketch/fr|Esquisse sur une face]]<br />
|[[Sketcher_ValidateSketch/fr|Valider une esquisse]]<br />
|[[Sketcher_Workbench/fr|Atelier Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/fr<br />
|Name=Sketcher ReorientSketch<br />
|Name/fr=Sketcher Réorienter une esquisse<br />
|MenuLocation=Esquisse → Réorienter une esquisse...<br />
|Workbenches=[[Sketcher_Workbench/fr|Sketcher]], [[PartDesign_Workbench/fr|PartDesign]]<br />
|SeeAlso=[[Sketcher_MapSketch/fr|Sketcher Appliquer une esquisse sur une face]], [[Sketcher_NewSketch/fr|Sketcher Créer une esquisse]]<br />
}}<br />
</div><br />
<br />
==Description==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Permet de détacher une esquisse d’une face et de la lier à l’un des plans principaux (avec un décalage).<br />
</div><br />
<br />
<span id="Usage"></span><br />
==Utilisation==<br />
<br />
<div class="mw-translate-fuzzy"><br />
#Sélectionner l'esquisse à réorienter dans l'arborescence<br />
#Choisir {{MenuCommand|Esquisse → [[File:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch/fr|Réorienter une esquisse...]]}} du menu supérieur<br />
#Un menu apparaîtra et vous demandera si vous souhaitez détacher l'esquisse de sa face<br />
#Sélectionner {{Button|Oui}} vous donnera le même menu que {{MenuCommand|Esquisse → Créer une esquisse}}.<br />
#Vous pouvez attacher l'esquisse à l'un des plans principaux.<br />
#Vous avez également la possibilité d'ajouter un décalage positif ou négatif.<br />
</div><br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/fr<br />
|[[Sketcher_MapSketch/fr|Esquisse sur une face]]<br />
|[[Sketcher_ValidateSketch/fr|Valider une esquisse]]<br />
|[[Sketcher_Workbench/fr|Atelier Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/en&diff=1388287Sketcher ReorientSketch/en2024-03-28T11:40:53Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{GuiCommand<br />
|Name=Sketcher ReorientSketch<br />
|MenuLocation=Sketch → Reorient sketch<br />
|Workbenches=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]<br />
|SeeAlso=[[Sketcher_MapSketch|Sketcher MapSketch]], [[Sketcher_NewSketch|Sketcher NewSketch]]<br />
}}<br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_ReorientSketch.svg|24px]] [[Sketcher_ReorientSketch|Sketcher ReorientSketch]] tool places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.<br />
<br />
==Usage==<br />
<br />
# Select a sketch.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch|Reorient sketch]]}} button (not available in the [[PartDesign_Workbench|PartDesign Workbench]]).<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ReorientSketch.svg|16px]] Reorient sketch}} option from the menu.<br />
# If the sketch is attached:<br />
## The '''Sketch has support''' dialog opens.<br />
## Press the {{Button|Yes}} button to detach the sketch.<br />
# The '''Choose orientation''' dialog opens.<br />
# Optionally press the {{Button|Cancel}} button to only detach the sketch and finish the tool.<br />
# Specify the plane for the orientation. The plane is relative to the local coordinate system the sketch is in:<br />
#* If the '''Reverse direction''' checkbox is not checked:<br />
#** Top: '''XY-Plane'''<br />
#** Front: '''XZ-Plane'''<br />
#** Right: '''YZ-Plane'''<br />
#* If the '''Reverse direction''' checkbox is checked:<br />
#** Bottom: '''XY-Plane'''<br />
#** Rear: '''XZ-Plane'''<br />
#** Left: '''YZ-Plane'''<br />
# Optionally change the '''Offset'''. The offset is measured along the Z, Y or X axis of the local coordinate system.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/zh-cn&diff=1388286Sketcher ReorientSketch/zh-cn2024-03-28T11:40:53Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/zh-cn<br />
|[[Sketcher_MapSketch/zh-cn|映射草图至面]]<br />
|[[Sketcher_ValidateSketch/zh-cn|校验草图…]]<br />
|[[Sketcher_Workbench/zh-cn|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/zh-cn<br />
|Name/zh-cn=调整草图方向...<br />
|Name=Sketcher_ReorientSketch<br />
|MenuLocation=Sketch → Reorient sketch<br />
|Workbenches=[[Sketcher_Workbench/zh-cn|Sketcher]], [[PartDesign_Workbench/zh-cn|PartDesign]]<br />
|SeeAlso=[[Sketcher_MapSketch/zh-cn|映射草图至面...]], [[Sketcher_NewSketch/zh-cn|创建草图]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==描述==<br />
<br />
<div class="mw-translate-fuzzy"><br />
借助此工具,您可以将一个草图从原来的面上分离开来,再将其(以一个偏移值)附于一个主平面上。<br />
</div><br />
<br />
<span id="Usage"></span><br />
==如何使用==<br />
<br />
<div class="mw-translate-fuzzy"><br />
#在树状视图中选择待重定位的草图<br />
#从顶级菜单中选择{{KEY| Sketch}} → {{KEY| Reorient sketch}}<br />
#这时会弹出一个菜单,问您是否将选中的草图从所在的面上分离出来<br />
#选择{{KEY| Yes}}将显示与{{KEY| Sketch}} → {{KEY| New Sketch}}相同的菜单<br />
#此时,您可以将此草图附于一个主平面之上<br />
#您还可以为之添加一个正/负偏移值<br />
</div><br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/zh-cn<br />
|[[Sketcher_MapSketch/zh-cn|映射草图至面]]<br />
|[[Sketcher_ValidateSketch/zh-cn|校验草图…]]<br />
|[[Sketcher_Workbench/zh-cn|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/tr&diff=1388285Sketcher ReorientSketch/tr2024-03-28T11:40:52Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{GuiCommand<br />
|Name=Sketcher ReorientSketch<br />
|MenuLocation=Sketch → Reorient sketch<br />
|Workbenches=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]<br />
|SeeAlso=[[Sketcher_MapSketch|Sketcher MapSketch]], [[Sketcher_NewSketch|Sketcher NewSketch]]<br />
}}<br />
<br />
<span id="Description"></span><br />
==Tanım==<br />
<br />
The [[Image:Sketcher_ReorientSketch.svg|24px]] [[Sketcher_ReorientSketch|Sketcher ReorientSketch]] tool places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.<br />
<br />
==Usage==<br />
<br />
# Select a sketch.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch|Reorient sketch]]}} button (not available in the [[PartDesign_Workbench|PartDesign Workbench]]).<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ReorientSketch.svg|16px]] Reorient sketch}} option from the menu.<br />
# If the sketch is attached:<br />
## The '''Sketch has support''' dialog opens.<br />
## Press the {{Button|Yes}} button to detach the sketch.<br />
# The '''Choose orientation''' dialog opens.<br />
# Optionally press the {{Button|Cancel}} button to only detach the sketch and finish the tool.<br />
# Specify the plane for the orientation. The plane is relative to the local coordinate system the sketch is in:<br />
#* If the '''Reverse direction''' checkbox is not checked:<br />
#** Top: '''XY-Plane'''<br />
#** Front: '''XZ-Plane'''<br />
#** Right: '''YZ-Plane'''<br />
#* If the '''Reverse direction''' checkbox is checked:<br />
#** Bottom: '''XY-Plane'''<br />
#** Rear: '''XZ-Plane'''<br />
#** Left: '''YZ-Plane'''<br />
# Optionally change the '''Offset'''. The offset is measured along the Z, Y or X axis of the local coordinate system.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/pl&diff=1388284Sketcher ReorientSketch/pl2024-03-28T11:40:52Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/pl<br />
|[[Sketcher_MapSketch/pl|Mapuj szkic na ścianę]]<br />
|[[Sketcher_ValidateSketch/pl|Sprawdź poprawność szkicu]]<br />
|[[Sketcher_Workbench/pl|środowisko pracy Szkicownik]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/pl<br />
|Name=Sketcher ReorientSketch<br />
|Name/pl=Szkicownik: Zmień orientację szkicu<br />
|MenuLocation=Szkic → Zmień orientację szkicu ...<br />
|Workbenches=[[Sketcher_Workbench/pl|Szkicownik]], [[PartDesign_Workbench/pl|Projekt Części]]<br />
|SeeAlso=[[Sketcher_MapSketch/pl|Mapuj szkic]], [[Sketcher_NewSketch/pl|Nowy szkic]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Opis==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Pozwala na oderwanie szkicu od powierzchni i przymocowanie go do jednej z głównych płaszczyzn ''(z przesunięciem)''.<br />
</div><br />
<br />
<span id="Usage"></span><br />
==Użycie==<br />
<br />
<div class="mw-translate-fuzzy"><br />
#W widoku drzewa wybierz szkic, który ma zostać zmieniony.<br />
#Wybierz z menu głównego {{MenuCommand|Szkic → [[File:Sketcher_ReorientSketch.svg|16px]] Zmień orientację szkicu ...}}.<br />
#Pojawi się menu z pytaniem, czy chcesz odłączyć szkic od jego powierzchni.<br />
#Wybierz {{Button|Tak}} uzyskasz identyczne menu co w {{Button|Szkic}} → {{Button|Nowy szkic}}.<br />
#Możesz podłączyć szkic do jednej z głównych płaszczyzn.<br />
#Masz również możliwość dodania przesunięcia w kierunku dodatnim lub ujemnym.<br />
</div><br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/pl<br />
|[[Sketcher_MapSketch/pl|Mapuj szkic na ścianę]]<br />
|[[Sketcher_ValidateSketch/pl|Sprawdź poprawność szkicu]]<br />
|[[Sketcher_Workbench/pl|środowisko pracy Szkicownik]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/cs&diff=1388283Sketcher ReorientSketch/cs2024-03-28T11:40:52Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/cs<br />
|Name=Sketcher Reorient<br />
|Name/cs=Skicář Změna orientace<br />
|Empty=1<br />
|Workbenches=[[Sketcher Workbench/cs|Skicář]], [[PartDesign Workbench/cs|Návrh dílu]]<br />
|MenuLocation=Návrh dílu → Změna orientace náčrtu<br />
|SeeAlso=[[Sketcher_MapSketch/cs|Vyznač náčrt]], [[Sketcher_NewSketch/cs|Nový náčrt]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Popis==<br />
<br />
The [[Image:Sketcher_ReorientSketch.svg|24px]] [[Sketcher_ReorientSketch|Sketcher ReorientSketch]] tool places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.<br />
<br />
==Usage==<br />
<br />
# Select a sketch.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch|Reorient sketch]]}} button (not available in the [[PartDesign_Workbench|PartDesign Workbench]]).<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ReorientSketch.svg|16px]] Reorient sketch}} option from the menu.<br />
# If the sketch is attached:<br />
## The '''Sketch has support''' dialog opens.<br />
## Press the {{Button|Yes}} button to detach the sketch.<br />
# The '''Choose orientation''' dialog opens.<br />
# Optionally press the {{Button|Cancel}} button to only detach the sketch and finish the tool.<br />
# Specify the plane for the orientation. The plane is relative to the local coordinate system the sketch is in:<br />
#* If the '''Reverse direction''' checkbox is not checked:<br />
#** Top: '''XY-Plane'''<br />
#** Front: '''XZ-Plane'''<br />
#** Right: '''YZ-Plane'''<br />
#* If the '''Reverse direction''' checkbox is checked:<br />
#** Bottom: '''XY-Plane'''<br />
#** Rear: '''XZ-Plane'''<br />
#** Left: '''YZ-Plane'''<br />
# Optionally change the '''Offset'''. The offset is measured along the Z, Y or X axis of the local coordinate system.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/hr&diff=1388282Sketcher ReorientSketch/hr2024-03-28T11:40:52Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{GuiCommand<br />
|Name=Sketcher ReorientSketch<br />
|MenuLocation=Sketch → Reorient sketch<br />
|Workbenches=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]<br />
|SeeAlso=[[Sketcher_MapSketch|Sketcher MapSketch]], [[Sketcher_NewSketch|Sketcher NewSketch]]<br />
}}<br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_ReorientSketch.svg|24px]] [[Sketcher_ReorientSketch|Sketcher ReorientSketch]] tool places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.<br />
<br />
==Usage==<br />
<br />
# Select a sketch.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch|Reorient sketch]]}} button (not available in the [[PartDesign_Workbench|PartDesign Workbench]]).<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ReorientSketch.svg|16px]] Reorient sketch}} option from the menu.<br />
# If the sketch is attached:<br />
## The '''Sketch has support''' dialog opens.<br />
## Press the {{Button|Yes}} button to detach the sketch.<br />
# The '''Choose orientation''' dialog opens.<br />
# Optionally press the {{Button|Cancel}} button to only detach the sketch and finish the tool.<br />
# Specify the plane for the orientation. The plane is relative to the local coordinate system the sketch is in:<br />
#* If the '''Reverse direction''' checkbox is not checked:<br />
#** Top: '''XY-Plane'''<br />
#** Front: '''XZ-Plane'''<br />
#** Right: '''YZ-Plane'''<br />
#* If the '''Reverse direction''' checkbox is checked:<br />
#** Bottom: '''XY-Plane'''<br />
#** Rear: '''XZ-Plane'''<br />
#** Left: '''YZ-Plane'''<br />
# Optionally change the '''Offset'''. The offset is measured along the Z, Y or X axis of the local coordinate system.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/pt&diff=1388281Sketcher ReorientSketch/pt2024-03-28T11:40:51Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/pt<br />
|Name=Sketcher Reorient<br />
|Name/pt=Sketcher Reorient<br />
|Empty=1<br />
|Workbenches=[[Sketcher Workbench/pt|Sketcher]], [[PartDesign Workbench/pt|PartDesign]]<br />
|MenuLocation=Part design → Reorient sketch<br />
|SeeAlso=[[Sketcher_MapSketch/pt|Map sketch]], [[Sketcher_NewSketch/pt|New Sketch]]<br />
}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_ReorientSketch.svg|24px]] [[Sketcher_ReorientSketch|Sketcher ReorientSketch]] tool places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.<br />
<br />
==Usage==<br />
<br />
# Select a sketch.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch|Reorient sketch]]}} button (not available in the [[PartDesign_Workbench|PartDesign Workbench]]).<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ReorientSketch.svg|16px]] Reorient sketch}} option from the menu.<br />
# If the sketch is attached:<br />
## The '''Sketch has support''' dialog opens.<br />
## Press the {{Button|Yes}} button to detach the sketch.<br />
# The '''Choose orientation''' dialog opens.<br />
# Optionally press the {{Button|Cancel}} button to only detach the sketch and finish the tool.<br />
# Specify the plane for the orientation. The plane is relative to the local coordinate system the sketch is in:<br />
#* If the '''Reverse direction''' checkbox is not checked:<br />
#** Top: '''XY-Plane'''<br />
#** Front: '''XZ-Plane'''<br />
#** Right: '''YZ-Plane'''<br />
#* If the '''Reverse direction''' checkbox is checked:<br />
#** Bottom: '''XY-Plane'''<br />
#** Rear: '''XZ-Plane'''<br />
#** Left: '''YZ-Plane'''<br />
# Optionally change the '''Offset'''. The offset is measured along the Z, Y or X axis of the local coordinate system.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/ru&diff=1388280Sketcher ReorientSketch/ru2024-03-28T11:40:51Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/ru<br />
|[[Sketcher_MapSketch/ru|Разместить эскиз на грани...]]<br />
|[[Sketcher_ValidateSketch/ru|Проверить эскиз...]]<br />
|[[Sketcher_Workbench/ru|Верстак "Sketcher"]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/ru<br />
|Name/ru=Переориентировать эскиз<br />
|Name=Sketcher_ReorientSketch<br />
|MenuLocation=Sketch → Переориентировать эскиз<br />
|Workbenches=[[Sketcher_Workbench/ru|Sketcher]], [[PartDesign_Workbench/ru|PartDesign]]<br />
|SeeAlso=[[Sketcher_MapSketch/ru|Разместить эскиз на грани]], [[Sketcher_NewSketch/ru|Создать эскиз]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Описание==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Позволяет отделить эскиз от грани и прикрепить его к одной из основных плоскостей (со смещением).<br />
</div><br />
<br />
<span id="Usage"></span><br />
==Применение==<br />
<br />
<div class="mw-translate-fuzzy"><br />
#В дереве модели выберите эскиз, который требуется переориентировать.<br />
#Нажмите {{MenuCommand|Sketch → [[File:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch/ru|Переориентировать эскиз]]}} в верхнем меню.<br />
#Появится всплывающее меню, в котором вас спросят, хотите ли вы отделить эскиз от грани.<br />
#Нажатие {{Button|Да}} даст вам то же самое меню что и в {{MenuCommand|Эскиз → Создать Эскиз}}.<br />
#Вы можете прикрепить эскиз к одной из основных плоскостей.<br />
#У вас также есть возможность добавить положительное или отрицательное смещение.<br />
</div><br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/ru<br />
|[[Sketcher_MapSketch/ru|Разместить эскиз на грани...]]<br />
|[[Sketcher_ValidateSketch/ru|Проверить эскиз...]]<br />
|[[Sketcher_Workbench/ru|Верстак "Sketcher"]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/ro&diff=1388279Sketcher ReorientSketch/ro2024-03-28T11:40:51Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand<br />
|Name=Sketcher Reorient<br />
|Empty=1<br />
|Workbenches=[[Sketcher Workbench|Sketcher]], [[PartDesign Workbench|PartDesign]]<br />
|MenuLocation=Part design → Reorient sketch<br />
|SeeAlso=[[Sketcher_MapSketch|Map sketch]], [[Sketcher_NewSketch|New Sketch]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Descriere==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Vă permite să detașați o schiță de pe o fațetă și să o atașați la unul dintre planurile importante (cu sau fără o deplasare gen offset).<br />
</div><br />
<br />
<span id="Usage"></span><br />
==Utilizare==<br />
<br />
<div class="mw-translate-fuzzy"><br />
#Selectați schița care va fi reorientată în vizualizarea arborescentă<br />
#Selectați {{KEY| Sketch}} → {{KEY| Reorient sketch}} din meniul principal<br />
#Un meniui contextual vă va întreba dacă doriți să detașați schița de pe fațeta ei<br />
#Selectând {{KEY| Yes}} veți obține același meniu ca în {{KEY| Sketch}} → {{KEY| New Sketch}}<br />
#Puteți să atașați o schiță pe unul dintre planurile principale<br />
#Aveți și posibilitatea să adăugați o deplasare pozitivă sau negativă (offset).<br />
[[IMAGE:Sketcher_New_it.png|left|Fenêtre de sélection du plan]] <br />
<br /><br />
Orientarea schiței<br />
<br />
* Planul XY [[IMAGE:View-top.svg|24px]]<br />
* Planul XZ [[IMAGE:View-front.svg|24px]]<br />
* Planul YZ [[IMAGE:View-right.svg|24px]]<br />
<br /><br />
{{clear}}<br />
* '''Inversare Direcției''' vizualizării din plan, de exemplu de sus sau de jos.<br />
* '''Offset''': a da o deplasarea planului în raport cu coordonatele originii '''X=0 Y=0 et Z=0'''.<br />
{{clear}}<br />
</div><br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/it&diff=1388278Sketcher ReorientSketch/it2024-03-28T11:40:51Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/it<br />
|[[Sketcher_MapSketch/it|Mappa schizzo su faccia]]<br />
|[[Sketcher_ValidateSketch/it|Convalida lo schizzo]]<br />
|[[Sketcher_Workbench/it|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/it<br />
|Name=Sketcher_ReorientSketch<br />
|Name/it=Riposiziona lo schizzo<br />
|MenuLocation=Schizzo → Riposiziona lo schizzo<br />
|Workbenches=[[Sketcher_Workbench/it|Sketcher]], [[PartDesign_Workbench/it|PartDesign]]<br />
|SeeAlso=[[Sketcher_MapSketch/it|Mappa schizzo]], [[Sketcher_NewSketch/it|Crea schizzo]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Descrizione==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Permette di staccare uno schizzo da una faccia e attaccarlo ad uno dei piani principali (con un offset).<br />
</div><br />
<br />
<span id="Usage"></span><br />
==Utilizzo==<br />
<br />
<div class="mw-translate-fuzzy"><br />
#Selezionare lo schizzo da riorientare nella visualizzazione ad albero<br />
#Scegliere {{MenuCommand|Schizzo → [[File:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch/it|Riposiziona lo schizzo...]]}} dal menu in alto.<br />
#Apparirà un menu che chiederà se si vuole staccare lo schizzo dalla sua faccia<br />
#Selezionando {{Button|Si}} verrà visualizzato lo stesso menu di {{MenuCommand|Schizzo → Crea schizzo}}.<br />
#E' possibile attaccare lo schizzo a uno dei piani principali<br />
#Si ha anche la possibilità di aggiungere un offset positivo o negativo<br />
</div><br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/it<br />
|[[Sketcher_MapSketch/it|Mappa schizzo su faccia]]<br />
|[[Sketcher_ValidateSketch/it|Convalida lo schizzo]]<br />
|[[Sketcher_Workbench/it|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/es&diff=1388277Sketcher ReorientSketch/es2024-03-28T11:40:51Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/es<br />
|Name=Sketcher Reorient<br />
|Name/es=Sketcher Reorient<br />
|Empty=1<br />
|Workbenches=[[Sketcher Workbench/es|Sketcher]], [[PartDesign Workbench/es|PartDesign]]<br />
|MenuLocation=Part design → Reorient sketch<br />
|SeeAlso=[[Sketcher_MapSketch/es|Map sketch]], [[Sketcher_NewSketch/es|New Sketch]]<br />
}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_ReorientSketch.svg|24px]] [[Sketcher_ReorientSketch|Sketcher ReorientSketch]] tool places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.<br />
<br />
==Usage==<br />
<br />
# Select a sketch.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch|Reorient sketch]]}} button (not available in the [[PartDesign_Workbench|PartDesign Workbench]]).<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ReorientSketch.svg|16px]] Reorient sketch}} option from the menu.<br />
# If the sketch is attached:<br />
## The '''Sketch has support''' dialog opens.<br />
## Press the {{Button|Yes}} button to detach the sketch.<br />
# The '''Choose orientation''' dialog opens.<br />
# Optionally press the {{Button|Cancel}} button to only detach the sketch and finish the tool.<br />
# Specify the plane for the orientation. The plane is relative to the local coordinate system the sketch is in:<br />
#* If the '''Reverse direction''' checkbox is not checked:<br />
#** Top: '''XY-Plane'''<br />
#** Front: '''XZ-Plane'''<br />
#** Right: '''YZ-Plane'''<br />
#* If the '''Reverse direction''' checkbox is checked:<br />
#** Bottom: '''XY-Plane'''<br />
#** Rear: '''XZ-Plane'''<br />
#** Left: '''YZ-Plane'''<br />
# Optionally change the '''Offset'''. The offset is measured along the Z, Y or X axis of the local coordinate system.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/de&diff=1388276Sketcher ReorientSketch/de2024-03-28T11:40:50Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/de<br />
|[[Sketcher_MapSketch/de|SkizzeZuordnen]]<br />
|[[Sketcher_ValidateSketch/de|SkizzeÜberprüfen]]<br />
|[[Sketcher_Workbench/de|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/de<br />
|Name=Sketcher ReorientSketch<br />
|Name/de=Sketcher SkizzeAnordnen<br />
|MenuLocation=Sketch → Skizze neu Anordnen<br />
|Workbenches=[[Sketcher_Workbench/de|Sketcher]], [[PartDesign_Workbench/de|PartDesign]]<br />
|SeeAlso=[[Sketcher_MapSketch/de|Sketcher SkizzeZuordnen]], [[Sketcher_NewSketch/de|Sketcher NeueSkizze]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Beschreibung==<br />
<br />
<div class="mw-translate-fuzzy"><br />
Ermöglicht es dir, eine Skizze von einer Fläche zu lösen und sie an einer der Hauptebenen (mit einem Versatz) anzuheften.<br />
</div><br />
<br />
<span id="Usage"></span><br />
==Anwendung==<br />
<br />
<div class="mw-translate-fuzzy"><br />
#Die Skizze, die neu ausgerichtet werden soll, in der Baumansicht auswählen.<br />
#Den Menüeintrag {{MenuCommand|Sketch → [[File:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch/de|Skizze neu ausrichten...]]}} auswählen.<br />
#Ein Menü wird geöffnet und erfragt, ob die Skizze von ihrer Fläche gelöst werden soll.<br />
#Die Auswahl von {{Button|Ja}} öffnet dasselbe Menü wie {{MenuCommand|Sketch → Skizze erstellen}}.<br />
#Die Skizze kann an eine der Hauptebenen angehängt werden.<br />
#Es besteht auch die Möglichkeit, einen positiven oder negativen Versatz hinzuzufügen<br />
</div><br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/de<br />
|[[Sketcher_MapSketch/de|SkizzeZuordnen]]<br />
|[[Sketcher_ValidateSketch/de|SkizzeÜberprüfen]]<br />
|[[Sketcher_Workbench/de|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_ReorientSketch/pt-br&diff=1388275Sketcher ReorientSketch/pt-br2024-03-28T11:40:48Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/pt-br<br />
|Name=Sketcher Reorient<br />
|Name/pt-br=Sketcher Reorient<br />
|Empty=1<br />
|Workbenches=[[Sketcher Workbench/pt-br|Sketcher]], [[PartDesign Workbench/pt-br|PartDesign]]<br />
|MenuLocation=Part design → Reorient sketch<br />
|SeeAlso=[[Sketcher_MapSketch/pt-br|Map sketch]], [[Sketcher_NewSketch/pt-br|New Sketch]]<br />
}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_ReorientSketch.svg|24px]] [[Sketcher_ReorientSketch|Sketcher ReorientSketch]] tool places a sketch on one of the main planes with an optional offset. It can also be used to detach a sketch.<br />
<br />
==Usage==<br />
<br />
# Select a sketch.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_ReorientSketch.svg|16px]] [[Sketcher_ReorientSketch|Reorient sketch]]}} button (not available in the [[PartDesign_Workbench|PartDesign Workbench]]).<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_ReorientSketch.svg|16px]] Reorient sketch}} option from the menu.<br />
# If the sketch is attached:<br />
## The '''Sketch has support''' dialog opens.<br />
## Press the {{Button|Yes}} button to detach the sketch.<br />
# The '''Choose orientation''' dialog opens.<br />
# Optionally press the {{Button|Cancel}} button to only detach the sketch and finish the tool.<br />
# Specify the plane for the orientation. The plane is relative to the local coordinate system the sketch is in:<br />
#* If the '''Reverse direction''' checkbox is not checked:<br />
#** Top: '''XY-Plane'''<br />
#** Front: '''XZ-Plane'''<br />
#** Right: '''YZ-Plane'''<br />
#* If the '''Reverse direction''' checkbox is checked:<br />
#** Bottom: '''XY-Plane'''<br />
#** Rear: '''XZ-Plane'''<br />
#** Left: '''YZ-Plane'''<br />
# Optionally change the '''Offset'''. The offset is measured along the Z, Y or X axis of the local coordinate system.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Translations:Sketcher_ReorientSketch/12/en&diff=1388274Translations:Sketcher ReorientSketch/12/en2024-03-28T11:40:47Z<p>FuzzyBot: Importing a new version from external source</p>
<hr />
<div>{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Translations:Sketcher_ReorientSketch/11/en&diff=1388273Translations:Sketcher ReorientSketch/11/en2024-03-28T11:40:47Z<p>FuzzyBot: Importing a new version from external source</p>
<hr />
<div>{{Docnav<br />
|[[Sketcher_MapSketch|Attach sketch]]<br />
|[[Sketcher_ValidateSketch|Validate sketch]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=Sketcher_MapSketch.svg<br />
|IconR=Sketcher_ValidateSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_MapSketch/pt&diff=1388270Sketcher MapSketch/pt2024-03-28T11:36:41Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_Dialog|Dialog]]<br />
|[[Sketcher_ReorientSketch|Reorient sketch ]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/pt|Name=Sketcher MapSketch|Name/pt=Sketcher MapSketch|Create a sketch on a face|Workbenches=[[Sketcher Workbench/pt|Sketcher]], [[PartDesign Workbench/pt|PartDesign]]|MenuLocation=Part design → Create a sketch on a face|SeeAlso=[[Sketcher NewSketch/pt|Create a sketch]]}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_MapSketch.svg|24px]] [[Sketcher_MapSketch|Sketcher MapSketch]] tool attaches a sketch to selected geometry.<br />
<br />
Typical use cases are:<br />
* The sketch was created on a standard plane (XY, XZ or YZ) and you want to attach it to the face of a solid in order to build a new feature upon it.<br />
* The sketch was attached to a specific face of a solid but you need to attached it to a different face.<br />
* A broken model needs to be repaired.<br />
<br />
[[File:Sketcher_MapSketch_00.png|480px|none]]<br />
<br />
==Usage== <br />
<br />
# Select an object with a shape, or one or more vertices, edges, and/or faces, and/or a plane.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_MapSketch.svg|16px]] [[Sketcher_MapSketch|Attach sketch...]]}} button.<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_MapSketch.svg|16px]] Attach sketch...}} option from the menu.<br />
# The '''Select sketch''' dialog opens.<br />
# Select a sketch from the dropdown list.<br />
# Press the {{Button|OK}} button.<br />
# The '''Sketch attachment''' dialog opens.<br />
# Select an [[Part_EditAttachment#Attachment_modes|attachment method]] from the dropdown list. Or select '''Don't attach''' to detach the sketch.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
[[Category:Sketcher/pt]]<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_MapSketch/hr&diff=1388269Sketcher MapSketch/hr2024-03-28T11:36:39Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_Dialog|Dialog]]<br />
|[[Sketcher_ReorientSketch|Reorient sketch ]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{GuiCommand<br />
|Name=Sketcher MapSketch<br />
|MenuLocation=Sketch → Attach sketch...<br />
|Workbenches=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]<br />
|SeeAlso=[[Sketcher_ReorientSketch|Sketcher ReorientSketch]], [[Sketcher_NewSketch|Sketcher NewSketch]]<br />
}}<br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_MapSketch.svg|24px]] [[Sketcher_MapSketch|Sketcher MapSketch]] tool attaches a sketch to selected geometry.<br />
<br />
Typical use cases are:<br />
* The sketch was created on a standard plane (XY, XZ or YZ) and you want to attach it to the face of a solid in order to build a new feature upon it.<br />
* The sketch was attached to a specific face of a solid but you need to attached it to a different face.<br />
* A broken model needs to be repaired.<br />
<br />
[[File:Sketcher_MapSketch_00.png|480px|none]]<br />
<br />
==Usage== <br />
<br />
# Select an object with a shape, or one or more vertices, edges, and/or faces, and/or a plane.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_MapSketch.svg|16px]] [[Sketcher_MapSketch|Attach sketch...]]}} button.<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_MapSketch.svg|16px]] Attach sketch...}} option from the menu.<br />
# The '''Select sketch''' dialog opens.<br />
# Select a sketch from the dropdown list.<br />
# Press the {{Button|OK}} button.<br />
# The '''Sketch attachment''' dialog opens.<br />
# Select an [[Part_EditAttachment#Attachment_modes|attachment method]] from the dropdown list. Or select '''Don't attach''' to detach the sketch.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_Dialog|Dialog]]<br />
|[[Sketcher_ReorientSketch|Reorient sketch ]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_MapSketch/en&diff=1388268Sketcher MapSketch/en2024-03-28T11:36:38Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_Dialog|Dialog]]<br />
|[[Sketcher_ReorientSketch|Reorient sketch ]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{GuiCommand<br />
|Name=Sketcher MapSketch<br />
|MenuLocation=Sketch → Attach sketch...<br />
|Workbenches=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]<br />
|SeeAlso=[[Sketcher_ReorientSketch|Sketcher ReorientSketch]], [[Sketcher_NewSketch|Sketcher NewSketch]]<br />
}}<br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_MapSketch.svg|24px]] [[Sketcher_MapSketch|Sketcher MapSketch]] tool attaches a sketch to selected geometry.<br />
<br />
Typical use cases are:<br />
* The sketch was created on a standard plane (XY, XZ or YZ) and you want to attach it to the face of a solid in order to build a new feature upon it.<br />
* The sketch was attached to a specific face of a solid but you need to attached it to a different face.<br />
* A broken model needs to be repaired.<br />
<br />
[[File:Sketcher_MapSketch_00.png|480px|none]]<br />
<br />
==Usage== <br />
<br />
# Select an object with a shape, or one or more vertices, edges, and/or faces, and/or a plane.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_MapSketch.svg|16px]] [[Sketcher_MapSketch|Attach sketch...]]}} button.<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_MapSketch.svg|16px]] Attach sketch...}} option from the menu.<br />
# The '''Select sketch''' dialog opens.<br />
# Select a sketch from the dropdown list.<br />
# Press the {{Button|OK}} button.<br />
# The '''Sketch attachment''' dialog opens.<br />
# Select an [[Part_EditAttachment#Attachment_modes|attachment method]] from the dropdown list. Or select '''Don't attach''' to detach the sketch.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
{{Docnav<br />
|[[Sketcher_Dialog|Dialog]]<br />
|[[Sketcher_ReorientSketch|Reorient sketch ]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_MapSketch/pt-br&diff=1388267Sketcher MapSketch/pt-br2024-03-28T11:36:37Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_Dialog|Dialog]]<br />
|[[Sketcher_ReorientSketch|Reorient sketch ]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/pt-br|Name=Sketcher MapSketch|Name/pt-br=Sketcher MapSketch|Create a sketch on a face|Workbenches=[[Sketcher Workbench/pt-br|Sketcher]], [[PartDesign Workbench/pt-br|PartDesign]]|MenuLocation=Part design → Create a sketch on a face|SeeAlso=[[Sketcher NewSketch/pt-br|Create a sketch]]}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_MapSketch.svg|24px]] [[Sketcher_MapSketch|Sketcher MapSketch]] tool attaches a sketch to selected geometry.<br />
<br />
Typical use cases are:<br />
* The sketch was created on a standard plane (XY, XZ or YZ) and you want to attach it to the face of a solid in order to build a new feature upon it.<br />
* The sketch was attached to a specific face of a solid but you need to attached it to a different face.<br />
* A broken model needs to be repaired.<br />
<br />
[[File:Sketcher_MapSketch_00.png|480px|none]]<br />
<br />
==Usage== <br />
<br />
# Select an object with a shape, or one or more vertices, edges, and/or faces, and/or a plane.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_MapSketch.svg|16px]] [[Sketcher_MapSketch|Attach sketch...]]}} button.<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_MapSketch.svg|16px]] Attach sketch...}} option from the menu.<br />
# The '''Select sketch''' dialog opens.<br />
# Select a sketch from the dropdown list.<br />
# Press the {{Button|OK}} button.<br />
# The '''Sketch attachment''' dialog opens.<br />
# Select an [[Part_EditAttachment#Attachment_modes|attachment method]] from the dropdown list. Or select '''Don't attach''' to detach the sketch.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
[[Category:Sketcher/pt-br]]<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_MapSketch/sv&diff=1388266Sketcher MapSketch/sv2024-03-28T11:36:34Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/sv<br />
|[[Sketcher_ViewSection/sv|Visa snitt]]<br />
|[[Sketcher_ReorientSketch/sv|Omrikta skiss]]<br />
|[[Sketcher_Workbench/sv|Sketcher]]<br />
|IconL=Sketcher_ViewSection.svg<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
Translations:Sketcher MapSketch/1<br />
{{GuiCommand/sv<br />
|Name/sv=Kartera skiss till ytan<br />
|Name=Sketcher_MapSketch<br />
|MenuLocation=Part Design/Sketch → Kartera skiss till ytan<br />
|Workbenches=[[Sketcher_Workbench/sv|Sketcher]], [[PartDesign_Workbench/sv|PartDesign]]<br />
|SeeAlso=[[Sketcher_NewSketch/sv|Skapa skiss]]<br />
}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_MapSketch.svg|24px]] [[Sketcher_MapSketch|Sketcher MapSketch]] tool attaches a sketch to selected geometry.<br />
<br />
Typical use cases are:<br />
* The sketch was created on a standard plane (XY, XZ or YZ) and you want to attach it to the face of a solid in order to build a new feature upon it.<br />
* The sketch was attached to a specific face of a solid but you need to attached it to a different face.<br />
* A broken model needs to be repaired.<br />
<br />
[[File:Sketcher_MapSketch_00.png|480px|none]]<br />
<br />
==Usage== <br />
<br />
# Select an object with a shape, or one or more vertices, edges, and/or faces, and/or a plane.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_MapSketch.svg|16px]] [[Sketcher_MapSketch|Attach sketch...]]}} button.<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_MapSketch.svg|16px]] Attach sketch...}} option from the menu.<br />
# The '''Select sketch''' dialog opens.<br />
# Select a sketch from the dropdown list.<br />
# Press the {{Button|OK}} button.<br />
# The '''Sketch attachment''' dialog opens.<br />
# Select an [[Part_EditAttachment#Attachment_modes|attachment method]] from the dropdown list. Or select '''Don't attach''' to detach the sketch.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/sv<br />
|[[Sketcher_ViewSection/sv|Visa snitt]]<br />
|[[Sketcher_ReorientSketch/sv|Omrikta skiss]]<br />
|[[Sketcher_Workbench/sv|Sketcher]]<br />
|IconL=Sketcher_ViewSection.svg<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Sketcher_MapSketch/es&diff=1388265Sketcher MapSketch/es2024-03-28T11:36:34Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Sketcher_Dialog|Dialog]]<br />
|[[Sketcher_ReorientSketch|Reorient sketch ]]<br />
|[[Sketcher_Workbench|Sketcher]]<br />
|IconL=<br />
|IconR=Sketcher_ReorientSketch.svg<br />
|IconC=Workbench_Sketcher.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/es|Name=Sketcher MapSketch|Name/es=Sketcher MapSketch|Create a sketch on a face|Workbenches=[[Sketcher Workbench/es|Sketcher]], [[PartDesign Workbench/es|PartDesign]]|MenuLocation=Part Design/Sketch → Map sketch to face...|SeeAlso=[[Sketcher NewSketch/es|Create a new sketch]]}}<br />
</div><br />
<br />
==Description==<br />
<br />
The [[Image:Sketcher_MapSketch.svg|24px]] [[Sketcher_MapSketch|Sketcher MapSketch]] tool attaches a sketch to selected geometry.<br />
<br />
Typical use cases are:<br />
* The sketch was created on a standard plane (XY, XZ or YZ) and you want to attach it to the face of a solid in order to build a new feature upon it.<br />
* The sketch was attached to a specific face of a solid but you need to attached it to a different face.<br />
* A broken model needs to be repaired.<br />
<br />
[[File:Sketcher_MapSketch_00.png|480px|none]]<br />
<br />
==Usage== <br />
<br />
# Select an object with a shape, or one or more vertices, edges, and/or faces, and/or a plane.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_MapSketch.svg|16px]] [[Sketcher_MapSketch|Attach sketch...]]}} button.<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_MapSketch.svg|16px]] Attach sketch...}} option from the menu.<br />
# The '''Select sketch''' dialog opens.<br />
# Select a sketch from the dropdown list.<br />
# Press the {{Button|OK}} button.<br />
# The '''Sketch attachment''' dialog opens.<br />
# Select an [[Part_EditAttachment#Attachment_modes|attachment method]] from the dropdown list. Or select '''Don't attach''' to detach the sketch.<br />
# Press the {{Button|OK}} button.<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
[[Category:Sketcher/es]]<br />
</div><br />
<br />
{{Sketcher Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Translations:Sketcher_MapSketch/3/en&diff=1388264Translations:Sketcher MapSketch/3/en2024-03-28T11:36:30Z<p>FuzzyBot: Importing a new version from external source</p>
<hr />
<div># Select an object with a shape, or one or more vertices, edges, and/or faces, and/or a plane.<br />
# There are several ways to invoke the tool:<br />
#* Press the {{Button|[[Image:Sketcher_MapSketch.svg|16px]] [[Sketcher_MapSketch|Attach sketch...]]}} button.<br />
#* Select the {{MenuCommand|Sketch → [[Image:Sketcher_MapSketch.svg|16px]] Attach sketch...}} option from the menu.<br />
# The '''Select sketch''' dialog opens.<br />
# Select a sketch from the dropdown list.<br />
# Press the {{Button|OK}} button.<br />
# The '''Sketch attachment''' dialog opens.<br />
# Select an [[Part_EditAttachment#Attachment_modes|attachment method]] from the dropdown list. Or select '''Don't attach''' to detach the sketch.<br />
# Press the {{Button|OK}} button.</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Translations:Sketcher_MapSketch/1/en&diff=1388263Translations:Sketcher MapSketch/1/en2024-03-28T11:36:30Z<p>FuzzyBot: Importing a new version from external source</p>
<hr />
<div>{{GuiCommand<br />
|Name=Sketcher MapSketch<br />
|MenuLocation=Sketch → Attach sketch...<br />
|Workbenches=[[Sketcher_Workbench|Sketcher]], [[PartDesign_Workbench|PartDesign]]<br />
|SeeAlso=[[Sketcher_ReorientSketch|Sketcher ReorientSketch]], [[Sketcher_NewSketch|Sketcher NewSketch]]<br />
}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_SelectPlane/tr&diff=1388259Draft SelectPlane/tr2024-03-28T09:37:35Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav<br />
|[[Draft_Shape2DView|Shape2DView]]<br />
|[[Draft_SetStyle|SetStyle]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_Shape2DView.svg<br />
|IconR=Draft_SetStyle.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/tr<br />
|Name=Draft SelectPlane<br />
|Name/tr=Çalışma düzlemini ayarla<br />
|MenuLocation=Draft → Utilities → Select Plane<br />
|Workbenches=[[Draft_Workbench/tr|Draft]], [[Arch_Workbench/tr|Arch]]<br />
}}<br />
</div><br />
<br />
==Description== <br />
<br />
The [[Image:Draft_SelectPlane.svg|24px]] '''Draft SelectPlane''' command defines the current Draft working plane. This is the plane in the [[3D_view|3D view]] where new [[Draft_Workbench|Draft]] objects are created. A working plane can be based on one of several [[#Usage_with_presets|presets]] or on a selection. The selection can be created before ([[#Usage_with_pre-selection|pre-selection]]) or after ([[#Usage_with_post-selection|post-selection]]) starting the command.<br />
<br />
{{Version|0.22}}: For each 3D view a separate working plane is stored.<br />
<br />
The [[Image:Draft_tray_button_plane.png]] button in the [[Draft_Tray|Draft Tray]] changes depending on the current working plane. {{Version|0.22}}: If the working plane is not set to {{MenuCommand|Auto}} an asterisk ({{MenuCommand|*}}) is appended to the button label if the origin of the working plane does not match the global origin.<br />
<br />
[[Image:WorkingPlane_example.png|400px]]<br />
{{Caption|Shapes created on different working planes}}<br />
<br />
==Usage with pre-selection==<br />
<br />
# Do one of the following:<br />
#* Select a single object. The following objects are supported:<br />
#** [[Draft_WorkingPlaneProxy|Draft WorkingPlaneProxies]]: the {{PropertyView|View Data}} (the camera position) and the {{PropertyView|Visibility Map}} (the saved visibility of objects) of the working plane proxy are also restored.<br />
#** [[Arch_Axis|Arch Axes]] ({{Version|0.22}})<br />
#** [[Arch_AxisSystem|Arch AxisSystems]] ({{Version|0.22}})<br />
#** [[Arch_BuildingPart|Arch BuildingParts]]<br />
#** [[Arch_SectionPlane|Arch SectionPlanes]]<br />
#** [[Std_Part|Std Parts]]: to avoid selecting subelements it is advisable to select these in the [[Tree_view|Tree view]].<br />
#** Non-solid objects that consist of a single flat face or a single curved edge, or ({{Version|0.22}}) that have three or more vertices.<br />
#** Solid objects or objects without a shape that have a {{PropertyData|Placement}} property. ({{Version|0.22}})<br />
#* Select one or more subelements. You can select:<br />
#** A flat face.<br />
#** A curved edge.<br />
#** Three vertices.<br />
#** An edge and a vertex, or two edges. The combined vertices must define a plane. ({{Version|0.22}})<br />
# There are several ways to invoke the command:<br />
#* Press the [[Image:Draft_tray_button_plane.png]] button in the [[Draft_Tray|Draft Tray]].<br />
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select plane}} option from the menu.<br />
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.<br />
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.<br />
<br />
==Usage with post-selection==<br />
<br />
# There are several ways to invoke the command:<br />
#* Press the [[Image:Draft_tray_button_plane.png]] button in the [[Draft_Tray|Draft Tray]].<br />
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select plane}} option from the menu.<br />
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.<br />
# The {{MenuCommand|Working plane setup}} task panel opens. See [[#Options|Options]] for more information.<br />
# Do one of the following:<br />
#* Select a single object. See the [[#Usage_with_pre-selection|previous paragraph]].<br />
#* Select one or more subelements. See the [[#Usage_with_pre-selection|previous paragraph]].<br />
# Click anywhere in the [[3D_view|3D view]] to confirm the selection and finish the command.<br />
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.<br />
<br />
==Usage with presets==<br />
<br />
# There are several ways to invoke the command:<br />
#* Press the [[Image:Draft_tray_button_plane.png]] button in the [[Draft_Tray|Draft Tray]].<br />
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select plane}} option from the menu.<br />
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.<br />
# The {{MenuCommand|Working plane setup}} task panel opens. See [[#Options|Options]] for more information.<br />
# Press any of the buttons to finish the command.<br />
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.<br />
<br />
==Options== <br />
<br />
* Press the {{Button|[[Image:View-top.svg|16px]] Top (XY)}} button to align the working plane with the XY plane of the global coordinate system.<br />
* Press the {{Button|[[Image:View-front.svg|16px]] Front (XZ)}} button to align the working plane with the XZ plane of the global coordinate system.<br />
* Press the {{Button|[[Image:View-right.svg|16px]] Side (YZ)}} button to align the working plane with the YZ plane of the global coordinate system.<br />
* Press the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button to align the working plane with the current [[3D_view|3D view]]. If the {{MenuCommand|Center plane on view}} checkbox is not checked the working plane origin will match the origin of the global coordinate system, else it will match the center of the current [[3D_view|3D view]].<br />
* Press the {{Button|[[Image:View-axonometric.svg|16px]] Automatic}} button to set the working plane to {{MenuCommand|Auto}}. A working plane set to {{MenuCommand|Auto}} will automatically align with the current [[3D_view|3D view]] whenever a Draft or [[Arch_Workbench|Arch]] command requiring point input is started. This is equivalent to pressing the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button before using the command. Additionally the working plane will align to planar faces that have been selected before starting the command, or when points on planar faces are picked during the command.<br />
* The {{MenuCommand|Offset}} defines the perpendicular distance between the calculated plane and the actual working plane.<br />
* Check the {{MenuCommand|Center plane on view}} checkbox to put the origin of the working plane in the center of to the current [[3D_view|3D view]]. This option can be useful in combination with the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button.<br />
* Select a vertex in the [[3D_view|3D view]] and press the {{Button|[[Image:Draft_Move.svg|16px]] Move working plane}} button to move the working plane so that its origin matches the position of the selected vertex.<br />
* The {{MenuCommand|Grid color}} button allows to quickly change the color of the grid. {{Version|0.22}}<br />
* The {{MenuCommand|Grid spacing}} defines the distance between grid lines.<br />
* The {{MenuCommand|Main line every}} value determines where main grid lines are drawn. Main grid lines are slightly thicker than normal grid lines. For example if the grid spacing is {{Value|0.5 m}} and there is a main line every {{Value|10 lines}}, such a line will occur every {{Value|5 m}}.<br />
* The {{MenuCommand|Grid extension}} value determines the number of grid lines in the X and Y direction of the grid.<br />
* The {{MenuCommand|Snapping radius}} is the maximum distance at which [[Draft_Snap_Grid|Draft Snap Grid]] detects the intersections of grid lines.<br />
* Press the {{Button|[[Image:view-fullscreen.svg|16px]] Center view}} button to align the [[3D_view|3D view]] with the current working plane.<br />
* Press the {{Button|[[Image:sel-back.svg|16px]] Previous}} button to reset the working plane to its previous position.<br />
* Press the {{Button|Next [[Image:sel-forward.svg|16px]]}} button to reset the working plane to its next position. {{Version|0.22}}<br />
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the command.<br />
<br />
==Notes==<br />
<br />
* It can be useful to align the [[3D_view|3D view]] with the selected Draft working plane. For example after switching the working plane to Front you may want to switch to the [[Std_ViewFront|Front view]] as well.<br />
* The grid can be toggled with the [[Draft_ToggleGrid|Draft ToggleGrid]] command.<br />
* By double-clicking [[Draft_WorkingPlaneProxy|Draft WorkingPlaneProxies]] in the [[Tree_view|Tree view]] you can quickly switch between working planes.<br />
<br />
==Preferences==<br />
<br />
See also: [[Preferences_Editor|Preferences Editor]] and [[Draft_Preferences|Draft Preferences]].<br />
<br />
* The grid settings in the task panel as well as several other grid settings are available as preferences: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping}}.<br />
* The Snapping radius can also be changed on-the-fly (see [[Draft_Snap#Preferences|Draft Snap]]) or by changing: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Draft → snapRange}}.<br />
<br />
==Scripting==<br />
<br />
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].<br />
<br />
{{Version|0.22}}:<br />
<br />
The WorkingPlane module offers two classes to create working plane objects: the {{incode|PlaneBase}} class and the {{incode|PlaneGui}} class. The second class inherits from the first. Objects of the {{incode|PlaneGui}} class interact with the GUI (the [[Draft_Tray|Draft Tray]] button), the [[3D_view|3D view]] and the [[Draft_Snap_Grid|grid]]. {{incode|PlaneBase}} objects do not.<br />
<br />
Use the {{incode|get_working_plane()}} method of the WorkingPlane module to get an instance of the {{incode|PlaneGui}} class linked to the current 3D view. The method either returns the existing working plane linked to the view or creates a new working plane if required.<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import WorkingPlane<br />
<br />
wp = WorkingPlane.get_working_plane()<br />
<br />
origin = App.Vector(0, 0, 0)<br />
normal = App.Vector(1, 1, 1).normalize()<br />
offset = 17<br />
wp.align_to_point_and_axis(origin, normal, offset)<br />
<br />
point = App.Vector(10, 15, 2)<br />
projection = wp.project_point(point)<br />
print(projection)<br />
}}<br />
<br />
The {{incode|PlaneBase}} class can be used to create working planes independent of the GUI:<br />
<br />
{{Code|code=<br />
import WorkingPlane<br />
<br />
wp = WorkingPlane.PlaneBase()<br />
}}<br />
<br />
<br />
{{Docnav<br />
|[[Draft_Shape2DView|Shape2DView]]<br />
|[[Draft_SetStyle|SetStyle]]<br />
|[[Draft_Workbench|Draft]]<br />
|IconL=Draft_Shape2DView.svg<br />
|IconR=Draft_SetStyle.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_SelectPlane/fr&diff=1388258Draft SelectPlane/fr2024-03-28T09:37:34Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav/fr<br />
|[[Draft_Shape2DView/fr|Projection 2D d'une forme]]<br />
|[[Draft_SetStyle/fr|Définir le style]]<br />
|[[Draft_Workbench/fr|Atelier Draft]]<br />
|IconL=Draft_Shape2DView.svg<br />
|IconR=Draft_SetStyle.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<!--Note : pour des raisons de lisibilité, un espace a été ajouté au texte du menu--><br />
{{GuiCommand/fr<br />
|Name=Draft SelectPlane<br />
|Name/fr=Draft Plan de travail<br />
|MenuLocation=Utilitaires → Sélectionner un plan<br />
|Workbenches=[[Draft_Workbench/fr|Draft]], [[Arch_Workbench/fr|Arch]]<br />
|Shortcut={{KEY|W}} {{KEY|P}}<br />
|SeeAlso=[[Draft_WorkingPlaneProxy/fr|Draft Objet Proxy pour plan de travail]]<br />
}}<br />
<br />
==Description== <br />
<br />
La commande [[Image:Draft_SelectPlane.svg|24px]] '''Draft Plan de travail''' définit le plan de travail en cours sous Draft. C'est le plan dans la [[3D_view/fr|vue 3D]] où les nouveaux objets de [[Draft_Workbench/fr|Draft]] sont créés. Un nouveau plan de travail peut être basé sur l'une des nombreuses [[#Utilisation_avec_les_pr.C3.A9s.C3.A9lections|présélections]] ou sur une sélection. La sélection peut être créée avant ([[#Utilisation_avec_pr.C3.A9s.C3.A9lection|présélection]]) ou après ([[#Utilisation_avec_post-s.C3.A9lection|post-sélection]]) le lancement de la commande.<br />
<br />
{{Version|0.22}} : pour chaque vue 3D, un plan de travail distinct est enregistré.<br />
<br />
Le bouton [[Image:Draft_tray_button_plane.png]] dans [[Draft_Tray/fr|Draft La barre]] change en fonction du plan de travail courant. {{Version/fr|0.22}} : si le plan de travail n'est pas réglé sur {{MenuCommand|Automatique}}, un astérisque ({{MenuCommand|*}}) est ajouté à l'étiquette du bouton si l'origine du plan de travail ne correspond pas à l'origine globale.<br />
<br />
[[Image:WorkingPlane_example.png|400px]]<br />
{{Caption|Formes créées sur différents plans de travail}}<br />
<br />
<span id="Usage_with_pre-selection"></span><br />
==Utilisation avec présélection==<br />
<br />
# Faites l'une des choses suivantes :<br />
#* Sélectionnez un seul objet. Les objets suivants sont pris en charge :<br />
#** [[Draft_WorkingPlaneProxy/fr|Draft Proxy pour plan de travail]] : la {{PropertyView|View Data}} (position de la caméra) et la {{PropertyView|Visibility Map}} (la visibilité enregistrée des objets) du proxy plan de travail sont également restaurées.<br />
#** [[Arch_Axis/fr|Arch Axes]] ({{Version/fr|0.22}})<br />
#** [[Arch_AxisSystem/fr|Arch Système d'axes]] ({{Version/fr|0.22}})<br />
#** [[Arch_BuildingPart/fr|Arch Partie de bâtiment]].<br />
#** [[Arch_SectionPlane/fr|Arch Plan de coupe]].<br />
#** Les objets [[Std_Part/fr|Std Parts]] : pour éviter de sélectionner des sous-éléments, il est conseillé de les sélectionner dans la [[Tree_view/fr|vue en arborescence]].<br />
#** Les objets non solides constitués d'une seule face plane ou d'une seule arête courbe, ou ({{Version/fr|0.22}}) qui ont trois sommets ou plus.<br />
#** Les objets solides ou objets sans forme ayant une propriété {{PropertyData|Placement}}. ({{Version/fr|0.22}})<br />
#* Sélectionnez un ou plusieurs sous-éléments. Vous pouvez sélectionner :<br />
#** Une face plane.<br />
#** Une arête incurvée.<br />
#** Trois sommets.<br />
#** Une arête et un sommet, ou deux arêtes. Les sommets combinés doivent définir un plan. ({{Version/fr|0.22}})<br />
# Il existe plusieurs façons de lancer la commande :<br />
#* Appuyez sur le bouton [[Image:Draft_tray_button_plane.png]] de [[Draft_Tray/fr|Draft La barre]].<br />
#* Sélectionnez l'option {{MenuCommand|Utilitaires → [[Image:Draft_SelectPlane.svg|16px]] Sélectionner un plan}} du menu.<br />
#* Utilisez le raccourci clavier : {{KEY|W}} puis {{KEY|P}}.<br />
# Le plan de travail et le bouton de [[Draft_Tray/fr|Draft La barre]] sont mis à jour.<br />
<br />
<span id="Usage_with_post-selection"></span><br />
==Utilisation avec post-sélection==<br />
<br />
# Il y a plusieurs façons de lancer la commande :<br />
#* Appuyez sur le bouton [[Image:Draft_tray_button_plane.png]] de [[Draft_Tray/fr|Draft La barre]].<br />
#* Sélectionnez l'option {{MenuCommand|Utilitaires → [[Image:Draft_SelectPlane.svg|16px]] Sélectionner un plan}} du menu.<br />
#* Utilisez le raccourci clavier : {{KEY|W}} puis {{KEY|P}}.<br />
# Le panneau de tâches {{MenuCommand|Configuration du plan de travail}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.<br />
# Effectuez l'une des opérations suivantes :<br />
#* Sélectionnez un seul objet. Voir le [[#Utilisation_avec_présélection|paragraphe précédent]] pour les objets pris en charge.<br />
#* Sélectionner un ou plusieurs sous-éléments. Voir le [[#Utilisation_avec_présélection|paragraphe précédent]].<br />
# Cliquez n'importe où dans la [[3D_view/fr|vue 3D]] pour confirmer la sélection et terminer la commande.<br />
# Le plan de travail et le bouton de [[Draft_Tray/fr|Draft La barre]] sont mis à jour.<br />
<br />
<span id="Usage_with_presets"></span><br />
==Utilisation avec les présélections==<br />
<br />
# Il y a plusieurs façons de lancer la commande :<br />
#* Appuyez sur le bouton [[Image:Draft_tray_button_plane.png]] de [[Draft_Tray/fr|Draft La barre]].<br />
#* Sélectionnez l'option {{MenuCommand|Utilitaires → [[Image:Draft_SelectPlane.svg|16px]] Sélectionner un plan}} dans le menu.<br />
#* Utilisez le raccourci clavier : {{KEY|W}} puis {{KEY|P}}.<br />
# Le panneau de tâches {{MenuCommand|Configuration du plan de travail}} s'ouvre. Voir [[#Options|Options]] pour plus d'informations.<br />
# Appuyez sur l'un des boutons pour terminer la commande.<br />
# Le plan de travail et le bouton de [[Draft_Tray/fr|Draft La barre]] sont mis à jour.<br />
<br />
==Options== <br />
<br />
<div class="mw-translate-fuzzy"><br />
* Appuyez sur le bouton {{Button|[[Image:View-top.svg|16px]] Haut (XY)}} pour aligner le plan de travail avec le plan XY du système de coordonnées global.<br />
* Appuyez sur le bouton {{Button|[[Image:View-front.svg|16px]] Face (XZ)}} pour aligner le plan de travail sur le plan XZ du système de coordonnées global.<br />
* Appuyez sur le bouton {{Button|[[Image:View-right.svg|16px]] Côté (YZ)}} pour aligner le plan de travail sur le plan YZ du système de coordonnées global.<br />
* Appuyez sur le bouton {{Button|[[Image:View-isometric.svg|16px]] Aligner selon la vue}} pour aligner le plan de travail sur la [[3D_view/fr|vue 3D]] en cours. Si la case {{MenuCommand|Centrer le plan dans la vue}} n'est pas cochée, l'origine du plan de travail correspondra à l'origine du système de coordonnées global, sinon elle correspondra au centre de la [[3D_view/fr|vue 3D]] en cours.<br />
* Appuyez sur le bouton {{Button|[[Image:View-axonometric.svg|16px]] Automatique}} pour régler le plan de travail en {{MenuCommand|Automatique}}. Un plan de travail réglé sur {{MenuCommand|Automatique}} s'alignera automatiquement sur la [[3D_view/fr|vue 3D]] en cours chaque fois qu'une commande de Draft ou de [[Arch_Workbench/fr|Arch]] nécessitant l'entrée de points est lancée. Cela équivaut à appuyer sur le bouton {{Button|[[Image:View-isometric.svg|16px]] Aligner selon la vue}} avant d'utiliser la commande. De plus, le plan de travail s'alignera sur les faces planes qui ont été sélectionnées avant de lancer la commande, ou lorsque des points sur des faces planes sont sélectionnés pendant la commande.<br />
* {{MenuCommand|Décalage}} définit la distance perpendiculaire entre le plan calculé et le plan de travail réel en cours.<br />
* Cochez la case {{MenuCommand|Centrer le plan dans la vue}} pour placer l'origine du plan de travail au centre de la [[3D_view/fr|vue 3D]] en cours. Cette option peut être utile en combinaison avec le bouton {{Button|[[Image:View-isometric.svg|16px]] Aligner selon la vue}}.<br />
* Sélectionnez un sommet dans la [[3D_view/fr|vue 3D]] et appuyez sur le bouton {{Button|[[Image:Draft_Move.svg|16px]] Déplacer le plan de travail}} pour déplacer le plan de travail afin que son origine corresponde à la position du sommet sélectionné.<br />
* {{MenuCommand|Espacement de la grille}} définit la distance entre les lignes de la grille.<br />
* La valeur de {{MenuCommand|Ligne principale tous les}} détermine l'endroit où les lignes de grille principales sont dessinées. Les lignes de grille principales sont légèrement plus épaisses que les lignes de grille normales. Par exemple, si l'espacement de la grille est de {{Value|0.5 m}} et qu'une ligne principale est tracée toutes les {{Value|10 lignes}}, une telle ligne sera tracée tous les {{Value|5 m}}.<br />
* La valeur de {{MenuCommand|Extension de la grille}} détermine le nombre de lignes de grille dans les directions X et Y de la grille.<br />
* {{MenuCommand|Rayon d'aimantation}} est la distance maximale à laquelle [[Draft_Snap_Grid/fr|Draft Aimantation Grille]] détecte les intersections des lignes de la grille.<br />
* Appuyez sur le bouton {{Button|[[Image:view-fullscreen.svg|16px]] Centrer la vue}} pour aligner la [[3D_view/fr|vue 3D]] sur le plan de travail en cours.<br />
* Appuyez sur le bouton {{Button|[[Image:sel-back.svg|16px]] Précédent}} pour réinitialiser le plan de travail à sa position précédente.<br />
* Appuyez sur le bouton {{Button|Suivant [[Image:sel-forward.svg|16px]]}} pour réinitialiser le plan de travail à sa position suivante. {{Version/fr|0.22}}<br />
* Appuyez sur {{KEY|Échap}} ou sur le bouton {{Button|Fermer}} pour abandonner la commande.<br />
</div><br />
<br />
<span id="Notes"></span><br />
==Remarques==<br />
<br />
* Il peut être utile d'aligner la [[3D_view/fr|vue 3D]] avec le plan de travail Draft sélectionné. Par exemple, après avoir changé le plan de travail en vue de face, vous pouvez vouloir passer à la [[Std_ViewFront/fr|vue de face]] également.<br />
* La grille peut être basculée avec la commande [[Draft_ToggleGrid/fr|Draft Visibilité de la grille]].<br />
* En double-cliquant sur [[Draft_WorkingPlaneProxy/fr|Draft Proxy pour plan de travail]] dans la [[Tree_view/fr|vue en arborescence]], vous pouvez rapidement passer d'un plan de travail à un autre.<br />
<br />
<span id="Preferences"></span><br />
==Préférences==<br />
<br />
Voir aussi : [[Preferences_Editor/fr|Réglage des préférences]] et [[Draft_Preferences/fr|Draft Préférences]].<br />
<br />
* Les paramètres de la grille dans le panneau des tâches ainsi que plusieurs autres paramètres de la grille sont disponibles en tant que préférences : {{MenuCommand|Édition → Préférences... → Draft → Grille et aimantation}}.<br />
* Le rayon d'aimantation peut également être modifié à la volée (voir [[Draft_Snap/fr#Pr.C3.A9f.C3.A9rences|Draft Aimantation]]) ou en modifiant : {{MenuCommand|Outils → Éditer les paramètres... → BaseApp → Preferences → Mod → Draft → snapRange}}.<br />
<br />
<span id="Scripting"></span><br />
==Script==<br />
<br />
Voir aussi : [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] et [[FreeCAD_Scripting_Basics/fr|FreeCAD Débuter avec les scripts]].<br />
<br />
{{Version/fr|0.22}} :<br />
<br />
Le module WorkingPlane propose deux classes pour créer des objets plan de travail : la classe {{incode|PlaneBase}} et la classe {{incode|PlaneGui}}. La seconde classe hérite de la première. Les objets de la classe {{incode|PlaneGui}} interagissent avec l'interface graphique (le bouton de [[Draft_Tray/fr|Draft La barre]]), la [[3D_view/fr|vue 3D]] et la [[Draft_Snap_Grid/fr|grille]]. Les objets {{incode|PlaneBase}} ne le sont pas.<br />
<br />
Utilisez la méthode {{incode|get_working_plane()}} du module WorkingPlane pour obtenir une instance de la classe {{incode|PlaneGui}} liée à la vue 3D en cours. La méthode renvoie le plan de travail existant lié à la vue ou crée un nouveau plan de travail si nécessaire.<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import WorkingPlane<br />
<br />
wp = WorkingPlane.get_working_plane()<br />
<br />
origin = App.Vector(0, 0, 0)<br />
normal = App.Vector(1, 1, 1).normalize()<br />
offset = 17<br />
wp.align_to_point_and_axis(origin, normal, offset)<br />
<br />
point = App.Vector(10, 15, 2)<br />
projection = wp.project_point(point)<br />
print(projection)<br />
}}<br />
<br />
La classe {{incode|PlaneBase}} peut être utilisée pour créer des plans de travail indépendants de l'interface graphique :<br />
<br />
{{Code|code=<br />
import WorkingPlane<br />
<br />
wp = WorkingPlane.PlaneBase()<br />
}}<br />
<br />
<br />
{{Docnav/fr<br />
|[[Draft_Shape2DView/fr|Projection 2D d'une forme]]<br />
|[[Draft_SetStyle/fr|Définir le style]]<br />
|[[Draft_Workbench/fr|Atelier Draft]]<br />
|IconL=Draft_Shape2DView.svg<br />
|IconR=Draft_SetStyle.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_SelectPlane/ru&diff=1388257Draft SelectPlane/ru2024-03-28T09:37:33Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/ru<br />
|[[Draft_Stretch/ru|Stretch]]<br />
|[[Draft_FinishLine/ru|Finish line]]<br />
|[[Draft_Workbench/ru|Draft]]<br />
|IconL=Draft_Stretch.svg<br />
|IconR=Draft_FinishLine.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
</div><br />
<br />
<div class="mw-translate-fuzzy"><br />
{{GuiCommand/ru<br />
|Name=Draft SelectPlane<br />
|Name/ru=Draft SelectPlane<br />
|MenuLocation=Draft → Utilities → Select Plane<br />
|Workbenches=[[Draft_Workbench/ru|Draft]], [[Arch_Workbench/ru|Arch]]<br />
|Shortcut={{KEY|W}} {{KEY|P}}<br />
|SeeAlso=[[Draft_SetWorkingPlaneProxy/ru|Draft SetWorkingPlaneProxy]], [[Draft_ToggleGrid/ru|Draft ToggleGrid]]<br />
}}<br />
</div><br />
<br />
<span id="Description"></span><br />
==Описание== <br />
<br />
The [[Image:Draft_SelectPlane.svg|24px]] '''Draft SelectPlane''' command defines the current Draft working plane. This is the plane in the [[3D_view|3D view]] where new [[Draft_Workbench|Draft]] objects are created. A working plane can be based on one of several [[#Usage_with_presets|presets]] or on a selection. The selection can be created before ([[#Usage_with_pre-selection|pre-selection]]) or after ([[#Usage_with_post-selection|post-selection]]) starting the command.<br />
<br />
{{Version|0.22}}: For each 3D view a separate working plane is stored.<br />
<br />
The [[Image:Draft_tray_button_plane.png]] button in the [[Draft_Tray|Draft Tray]] changes depending on the current working plane. {{Version|0.22}}: If the working plane is not set to {{MenuCommand|Auto}} an asterisk ({{MenuCommand|*}}) is appended to the button label if the origin of the working plane does not match the global origin.<br />
<br />
[[Image:WorkingPlane_example.png|400px]]<br />
{{Caption|Shapes created on different working planes}}<br />
<br />
==Usage with pre-selection==<br />
<br />
# Do one of the following:<br />
#* Select a single object. The following objects are supported:<br />
#** [[Draft_WorkingPlaneProxy|Draft WorkingPlaneProxies]]: the {{PropertyView|View Data}} (the camera position) and the {{PropertyView|Visibility Map}} (the saved visibility of objects) of the working plane proxy are also restored.<br />
#** [[Arch_Axis|Arch Axes]] ({{Version|0.22}})<br />
#** [[Arch_AxisSystem|Arch AxisSystems]] ({{Version|0.22}})<br />
#** [[Arch_BuildingPart|Arch BuildingParts]]<br />
#** [[Arch_SectionPlane|Arch SectionPlanes]]<br />
#** [[Std_Part|Std Parts]]: to avoid selecting subelements it is advisable to select these in the [[Tree_view|Tree view]].<br />
#** Non-solid objects that consist of a single flat face or a single curved edge, or ({{Version|0.22}}) that have three or more vertices.<br />
#** Solid objects or objects without a shape that have a {{PropertyData|Placement}} property. ({{Version|0.22}})<br />
#* Select one or more subelements. You can select:<br />
#** A flat face.<br />
#** A curved edge.<br />
#** Three vertices.<br />
#** An edge and a vertex, or two edges. The combined vertices must define a plane. ({{Version|0.22}})<br />
# There are several ways to invoke the command:<br />
#* Press the [[Image:Draft_tray_button_plane.png]] button in the [[Draft_Tray|Draft Tray]].<br />
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select plane}} option from the menu.<br />
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.<br />
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.<br />
<br />
==Usage with post-selection==<br />
<br />
# There are several ways to invoke the command:<br />
#* Press the [[Image:Draft_tray_button_plane.png]] button in the [[Draft_Tray|Draft Tray]].<br />
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select plane}} option from the menu.<br />
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.<br />
# The {{MenuCommand|Working plane setup}} task panel opens. See [[#Options|Options]] for more information.<br />
# Do one of the following:<br />
#* Select a single object. See the [[#Usage_with_pre-selection|previous paragraph]].<br />
#* Select one or more subelements. See the [[#Usage_with_pre-selection|previous paragraph]].<br />
# Click anywhere in the [[3D_view|3D view]] to confirm the selection and finish the command.<br />
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.<br />
<br />
==Usage with presets==<br />
<br />
# There are several ways to invoke the command:<br />
#* Press the [[Image:Draft_tray_button_plane.png]] button in the [[Draft_Tray|Draft Tray]].<br />
#* Select the {{MenuCommand|Utilities → [[Image:Draft_SelectPlane.svg|16px]] Select plane}} option from the menu.<br />
#* Use the keyboard shortcut: {{KEY|W}} then {{KEY|P}}.<br />
# The {{MenuCommand|Working plane setup}} task panel opens. See [[#Options|Options]] for more information.<br />
# Press any of the buttons to finish the command.<br />
# The working plane and the button in the [[Draft_Tray|Draft Tray]] are updated.<br />
<br />
<span id="Options"></span><br />
==Опции== <br />
<br />
* Press the {{Button|[[Image:View-top.svg|16px]] Top (XY)}} button to align the working plane with the XY plane of the global coordinate system.<br />
* Press the {{Button|[[Image:View-front.svg|16px]] Front (XZ)}} button to align the working plane with the XZ plane of the global coordinate system.<br />
* Press the {{Button|[[Image:View-right.svg|16px]] Side (YZ)}} button to align the working plane with the YZ plane of the global coordinate system.<br />
* Press the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button to align the working plane with the current [[3D_view|3D view]]. If the {{MenuCommand|Center plane on view}} checkbox is not checked the working plane origin will match the origin of the global coordinate system, else it will match the center of the current [[3D_view|3D view]].<br />
* Press the {{Button|[[Image:View-axonometric.svg|16px]] Automatic}} button to set the working plane to {{MenuCommand|Auto}}. A working plane set to {{MenuCommand|Auto}} will automatically align with the current [[3D_view|3D view]] whenever a Draft or [[Arch_Workbench|Arch]] command requiring point input is started. This is equivalent to pressing the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button before using the command. Additionally the working plane will align to planar faces that have been selected before starting the command, or when points on planar faces are picked during the command.<br />
* The {{MenuCommand|Offset}} defines the perpendicular distance between the calculated plane and the actual working plane.<br />
* Check the {{MenuCommand|Center plane on view}} checkbox to put the origin of the working plane in the center of to the current [[3D_view|3D view]]. This option can be useful in combination with the {{Button|[[Image:View-isometric.svg|16px]] Align to view}} button.<br />
* Select a vertex in the [[3D_view|3D view]] and press the {{Button|[[Image:Draft_Move.svg|16px]] Move working plane}} button to move the working plane so that its origin matches the position of the selected vertex.<br />
* The {{MenuCommand|Grid color}} button allows to quickly change the color of the grid. {{Version|0.22}}<br />
* The {{MenuCommand|Grid spacing}} defines the distance between grid lines.<br />
* The {{MenuCommand|Main line every}} value determines where main grid lines are drawn. Main grid lines are slightly thicker than normal grid lines. For example if the grid spacing is {{Value|0.5 m}} and there is a main line every {{Value|10 lines}}, such a line will occur every {{Value|5 m}}.<br />
* The {{MenuCommand|Grid extension}} value determines the number of grid lines in the X and Y direction of the grid.<br />
* The {{MenuCommand|Snapping radius}} is the maximum distance at which [[Draft_Snap_Grid|Draft Snap Grid]] detects the intersections of grid lines.<br />
* Press the {{Button|[[Image:view-fullscreen.svg|16px]] Center view}} button to align the [[3D_view|3D view]] with the current working plane.<br />
* Press the {{Button|[[Image:sel-back.svg|16px]] Previous}} button to reset the working plane to its previous position.<br />
* Press the {{Button|Next [[Image:sel-forward.svg|16px]]}} button to reset the working plane to its next position. {{Version|0.22}}<br />
* Press {{KEY|Esc}} or the {{Button|Close}} button to abort the command.<br />
<br />
==Notes==<br />
<br />
* It can be useful to align the [[3D_view|3D view]] with the selected Draft working plane. For example after switching the working plane to Front you may want to switch to the [[Std_ViewFront|Front view]] as well.<br />
* The grid can be toggled with the [[Draft_ToggleGrid|Draft ToggleGrid]] command.<br />
* By double-clicking [[Draft_WorkingPlaneProxy|Draft WorkingPlaneProxies]] in the [[Tree_view|Tree view]] you can quickly switch between working planes.<br />
<br />
==Preferences==<br />
<br />
See also: [[Preferences_Editor|Preferences Editor]] and [[Draft_Preferences|Draft Preferences]].<br />
<br />
* The grid settings in the task panel as well as several other grid settings are available as preferences: {{MenuCommand|Edit → Preferences... → Draft → Grid and snapping}}.<br />
* The Snapping radius can also be changed on-the-fly (see [[Draft_Snap#Preferences|Draft Snap]]) or by changing: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → Mod → Draft → snapRange}}.<br />
<br />
==Scripting==<br />
<br />
See also: [https://freecad.github.io/SourceDoc/ Autogenerated API documentation] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].<br />
<br />
{{Version|0.22}}:<br />
<br />
The WorkingPlane module offers two classes to create working plane objects: the {{incode|PlaneBase}} class and the {{incode|PlaneGui}} class. The second class inherits from the first. Objects of the {{incode|PlaneGui}} class interact with the GUI (the [[Draft_Tray|Draft Tray]] button), the [[3D_view|3D view]] and the [[Draft_Snap_Grid|grid]]. {{incode|PlaneBase}} objects do not.<br />
<br />
Use the {{incode|get_working_plane()}} method of the WorkingPlane module to get an instance of the {{incode|PlaneGui}} class linked to the current 3D view. The method either returns the existing working plane linked to the view or creates a new working plane if required.<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import WorkingPlane<br />
<br />
wp = WorkingPlane.get_working_plane()<br />
<br />
origin = App.Vector(0, 0, 0)<br />
normal = App.Vector(1, 1, 1).normalize()<br />
offset = 17<br />
wp.align_to_point_and_axis(origin, normal, offset)<br />
<br />
point = App.Vector(10, 15, 2)<br />
projection = wp.project_point(point)<br />
print(projection)<br />
}}<br />
<br />
The {{incode|PlaneBase}} class can be used to create working planes independent of the GUI:<br />
<br />
{{Code|code=<br />
import WorkingPlane<br />
<br />
wp = WorkingPlane.PlaneBase()<br />
}}<br />
<br />
<br />
<div class="mw-translate-fuzzy"><br />
{{Docnav/ru<br />
|[[Draft_Stretch/ru|Stretch]]<br />
|[[Draft_FinishLine/ru|Finish line]]<br />
|[[Draft_Workbench/ru|Draft]]<br />
|IconL=Draft_Stretch.svg<br />
|IconR=Draft_FinishLine.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
</div><br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBothttps://wiki.freecad.org/index.php?title=Draft_SelectPlane/de&diff=1388256Draft SelectPlane/de2024-03-28T09:37:33Z<p>FuzzyBot: Updating to match new version of source page</p>
<hr />
<div><languages/><br />
<br />
{{Docnav/de<br />
|[[Draft_Shape2DView/de|Form2DAnsicht]]<br />
|[[Draft_SetStyle/de|StilFestlegen]]<br />
|[[Draft_Workbench/de|Draft]]<br />
|IconL=Draft_Shape2DView.svg<br />
|IconR=Draft_SetStyle.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
<!--Note: for legibility a space was added to the menu text--><br />
{{GuiCommand/de<br />
|Name=Draft SelectPlane<br />
|Name/de=Draft EbeneAuswählen<br />
|MenuLocation=Dienstprogramme → Ebene wählen<br />
|Workbenches=[[Draft_Workbench/de|Draft]], [[Arch_Workbench/de|Arch]]<br />
|Shortcut={{KEY|W}} {{KEY|P}}<br />
|SeeAlso=[[Draft_WorkingPlaneProxy/de|Draft ArbeitsebenenProxy]]<br />
}}<br />
<br />
<span id="Description"></span><br />
==Beschreibung== <br />
<br />
Der Befehl [[Image:Draft_SelectPlane.svg|24px]] '''Draft EbeneAuswählen''' legt die aktuelle Arbeitsebene fest. Dies ist die Ebene in der [[3D_view/de|3D-Ansicht]] auf der neue [[Draft_Workbench|Draft]]-Objekte erstellt werden. Eine Arbeitsebene kann auf einer oder mehreren [[#Anwendung_mit_Voreinstellungen|Voreinstellungen]] basieren oder auf einer Auswahl. Die Auswahl kann vor dem Aufruf des Befehls erfolgen ([[#Anwendung_mit_Vorauswahl|Vorauswahl]]) oder danach ([[#Anwendung_mit_nahträglicher Auswahl|nachträgliche Auswahl]]).<br />
<br />
{{Version/de|0.22}}: Zu jeder 3D-Ansicht wird eine eigene Arbeitebene gespeichert.<br />
<br />
Die Schaltfläche [[Image:Draft_tray_button_plane.png]] im [[Draft_Tray|Draft Tray]] ändert sich abhängig von der aktuellen Arbeitsebene. {{Version/de|0.22}}: Ist die Arbeitsebene nicht auf {{MenuCommand|Auto}} gesetzt, wird der Benennung der Schaltfläche ein Stern ({{MenuCommand|*}}) vorangestellt, wenn der Ursprung der Arbeitsebene nicht dem globalen Ursprung entspricht.<br />
<br />
[[Image:WorkingPlane_example.png|400px]]<br />
{{Caption|Formen die auf unterschiedlichen Arbeitsebenen erstellt wurden}}<br />
<br />
<span id="Usage_with_pre-selection"></span><br />
==Anwendung mit Vorauswahl==<br />
<br />
# Eine der folgenden Möglichkeiten ausführen:<br />
#* Ein einzelnes Objekt auswählen. Die folgenden Objekte werden unterstützt:<br />
#** [[Draft_WorkingPlaneProxy/de|Draft ArbeitsebenenProxies]]: Die {{PropertyView/de|View Data}} (die Kameraposition) und die {{PropertyView/de|Visibility Map}} (die gespeicherten Sichtbarkeitseinstellungen von Objekten) des Arbeitseben-Proxys werden ebenfalls wiederhergestellt.<br />
#** [[Arch_Axis/de|Arch Achsen]] ({{Version/de|0.22}})<br />
#** [[Arch_AxisSystem/de|Arch Achsensysteme]] ({{Version/de|0.22}})<br />
#** [[Arch_BuildingPart/de|Arch Gebäudeteile]]<br />
#** [[Arch_SectionPlane/de|Arch Schnittebenen]]<br />
#** [[Std_Part/de|Std Teile]]: Sollen nicht nur die angeklickten Subelemente ausgewählt werden, wird empfohlen Std-Teile in der [[Tree_view/de|Baumansicht]] auszuwählen.<br />
#** Nicht-Festkörper-Objekte, die aus einer einzelnen ebenen Fläche oder einer einzelnen gekrümmten Kante bestehen oder ({{Version/de|0.22}}) die mindestens drei Knoten enthalten.<br />
#** Festkörper-Objekte oder Objekte ohne eine Form, die eine {{PropertyData/de|Placement}} besitzen. ({{Version/de|0.22}})<br />
#* Ein oder mehrere Unterelemente auswählen. Zur Wahl stehen:<br />
#** Eine ebene Fläche.<br />
#** Eine gekrümmte Kante.<br />
#** Drei Knotenpunkte.<br />
#** Eine Kante und ein Knoten oder zwei Kanten. Die Knoten müssen zusammen eine Ebene definieren. ({{Version/de|0.22}})<br />
# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:<br />
#* Die Schaltfläche [[Image:Draft_tray_button_plane.png]] im [[Draft_Tray/de|Draft Tray]] drücken.<br />
#* Den Menüeintrag {{MenuCommand|Dienstprogramme → [[Image:Draft_SelectPlane.svg|16px]] Ebene wählen}} auswählen.<br />
#* Das Tastaturkürzel {{KEY|W}} dann {{KEY|P}}.<br />
# Die Arbeitsebene und die Schaltfläche in der [[Draft_Tray/de|Draft Tray]] werden aktualisiert.<br />
<br />
<span id="Usage_with_post-selection"></span><br />
==Anwendung mit nachträglicher Auswahl==<br />
<br />
# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:<br />
#* Die Schaltfläche [[Image: Draft_tray_button_plane.png]] im [[Draft_Tray/de|Draft Tray]] drücken.<br />
#* Den Menüeintrag {{MenuCommand|Dienstprogramme → [[Image:Draft_SelectPlane.svg|16px]] Ebene wählen}} auswählen.<br />
#* Das Tastaturkürzel {{KEY|W}} dann {{KEY|P}}.<br />
# Der Aufgaben-Bereich {{MenuCommand|Arbeitsebene einrichten}} wird geöffnet. Siehe [[#Optionen|Optionen]] für weitere Informationen.<br />
# Eine der folgenden Möglichkeiten ausführen:<br />
#* Ein einzelnes Objekt auswählen. Siehe den [[#Anwendung mit Vorauswahl|vorherigen Absatz]].<br />
#* Ein oder mehrere Unterelemente auswählen. Siehe den [[#Anwendung mit Vorauswahl|vorherigen Absatz]].<br />
# An eine beliebige Stelle in der [[3D_view/de|3D-Ansicht]] klicken, um die Auswahl zu bestätigen und den Befehl zu beenden.<br />
# Die Arbeitsebene und die Schaltfläche im [[Draft_Tray/de|Draft Tray]] werden aktualisiert.<br />
<br />
<span id="Usage_with_presets"></span><br />
==Anwendung mit Voreinstellungen==<br />
<br />
# Es gibt mehrere Möglichkeiten, den Befehl aufzurufen:<br />
#* Die Schaltfläche [[Image:Draft_tray_button_plane.png]] im [[Draft_Tray/de|Draft Tray]] drücken.<br />
#* Den Menüeintrag {{MenuCommand|Dienstprogramme → [[Image:Draft_SelectPlane.svg|16px]] Ebene wählen}} auswählen.<br />
#* Das Tastaturkürzel {{KEY|W}} dann {{KEY|P}}.<br />
# Der Aufgaben-Bereich {{MenuCommand|Arbeitsebene einrichten}} wird geöffnet. Siehe [[#Optionen|Optionen]] für weitere Informationen.<br />
# Eine der Schaltflächen drücken, um den Befehl zu beenden.<br />
# Die Arbeitsebene und die Schaltfläche im [[Draft_Tray/de|Draft Tray]] werden aktualisiert.<br />
<br />
<span id="Options"></span><br />
==Optionen== <br />
<br />
<div class="mw-translate-fuzzy"><br />
* Die Schaltfläche {{Button|[[Image:View-top.svg|16px]] Oben (XY)}} drücken, um die Arbeitsebene zur XY-Ebene des globalen Koordinatensystems auszurichten.<br />
* Die Schaltfläche {{Button|[[Image:View-front.svg|16px]] Front (XZ)}} drücken, um die Arbeitsebene zur XZ-Ebene des globalen Koordinatensystems auszurichten.<br />
* Die Schaltfläche {{Button|[[Image:View-right.svg|16px]] Seite (YZ)}} drücken, um die Arbeitsebene zur YZ-Ebene des globalen Koordinatensystems auszurichten.<br />
* Die Schaltfläche {{Button|[[Image:View-isometric.svg|16px]] Zur Ansicht ausrichten}} drücken, um die Arbeitsebene zur aktuellen [[3D_view/de|3D-Ansicht]] auszurichten. Ist die Checkbox {{MenuCommand|Ebene in Ansicht zentrieren}} nicht aktiviert, ist der Ursprung der Arbeitsebene deckungsgleich mit dem Ursprung des globalen Koordinatensystems, andernfalls ist er deckungsgleich mit der Mitte der aktuellen [[3D_view/de|3D-Ansicht]].<br />
* Die Schaltfläche {{Button|[[Image:View-axonometric.svg|16px]] Automatisch}} drücken, um die Arbeitsebene auf {{MenuCommand|Auto}} zu setzen. Eine auf {{MenuCommand|Auto}} gesetzte Arbeitsebene wird automatisch zur aktuellen [[3D_view/de|3D-Ansicht]] ausgerichtet, wann immer ein Draft- oder [[Arch_Workbench/de|Arch]]-Befehl gestartet wird, der eine Punkteingabe erfordert. Dies ist entspricht dem Drücken der Schaltfläche {{Button|[[Image:View-isometric.svg|16px]] Zur Ansicht ausrichten}}, bevor der Befehl verwendet wird. Außerdem richtet sich die Arbeitsebene zu ebenen Flächen aus, die vor dem Start des Befehls ausgewählt wurden, oder wenn während der Ausführung des Befehls Punkte auf ebenen Flächen ausgewählt werden.<br />
* {{MenuCommand|Versetzen}} legt den senkrechten Abstand zwischen der berechneten Ebene und der tatsächlichen Arbeitsebene fest.<br />
* Die Checkbox {{MenuCommand|Center plane on view}} aktivieren, um den Ursprung der Arbeitsebene auf den Mittelpunkt der aktuellen [[3D_view/de|3D-Ansicht]] zu setzen. Diese Option kann in Kombination mit der Schaltfläche {{Button|[[Image:View-isometric.svg|16px]] Zur Ansicht ausrichten}} nützlich sein.<br />
* Einen Knoten in der [[3D_view/de|3D-Ansicht]] auswählen und die Schaltfläche {{Button|[[Image:Draft_Move.svg|16px]] Move working plane}} drücken, um die die Arbeitsebene so zu versetzen, dass ihr Ursprung auf dem ausgewählten Knoten liegt.<br />
* {{MenuCommand|Rasterabstand}} legt den Abstand zwischen den Rasterlinien fest.<br />
* Der Wert {{MenuCommand|Hauptlinien alle}} legt fest, wo Hauptrasterlinien gezeichnet werden. Hauptrasterlinien sind geringfügig dicker, als normale Rasterlinen. Ist z.B. der Rasterabstand {{Value|0.5 m}} und es gibt eine Hauptlinie alle {{Value|10}} Linien, treten die Hauptlinien alle {{Value|5 m}} auf.<br />
* Der Wert {{MenuCommand|Grid extension}} legt die Anzahl der Rasterlinien in X- und Y-Richtung des Rasters fest.<br />
* Der {{MenuCommand|Einrast-Radius}} ist der maximale Abstand, den [[Draft_Snap_Grid/de|Draft EinrastenAufRaster]] berücksichtigt, um die Schnittstellen der Rasterlinien zu finden.<br />
* Die Schaltfläche {{Button|[[Image:view-fullscreen.svg|16px]] Ansicht zentrieren}} drücken, um die [[3D_view/de|3D-Ansicht]] zur aktuellen Arbeitsebene auszurichten.<br />
* Die Schaltfläche {{Button|[[Image:sel-back.svg|16px]] Vorherige}} drücken, um die Arbeitsebene auf ihre vorherige Position zurückzusetzen.<br />
* Die Schaltfläche {{Button|Next [[Image:sel-forward.svg|16px]]}} drücken, um die Arbeitsebene auf ihre nachfolgende Position zu setzen. {{Version/de|0.22}}<br />
* {{KEY|Esc}} oder die Schaltfläche {{Button|Close}} drücken, um den Befehl abzubrechen.<br />
</div><br />
<br />
<span id="Notes"></span><br />
==Hinweise==<br />
<br />
* Es kann sinnvoll sein, die [[3D_view/de|3D-Ansicht]] zur ausgewählten Arbeitsebene auszurichten. Beispielsweise stellt man nach dem setzen der Arbeitsebene auf Front auch für die Ansicht auf die [[Std_ViewFront|Vorderansicht]] um.<br />
* Das Raster kann mit dem Befehl [[Draft_ToggleGrid/de|Raster ein-/ausblenden]] umgeschaltet werden.<br />
* Durch Doppelklicken auf [[Draft_WorkingPlaneProxy/de|Draft Arbeitsebenen-Proxies]] in der [[Tree_view/de|Baumansicht]] kann schnell zwischen Arbeitsebenen gewechselt werden.<br />
<br />
<span id="Preferences"></span><br />
==Einstellungen==<br />
<br />
Siehe auch: [[Preferences_Editor/de|Voreinstellungseditor]] und [[Draft_Preferences/de|Draft Einstellungen]].<br />
<br />
* Die Rastereinstellungen im Aufgaben-Bereich und auch einige andere Rastereinstellungen stehen als Voreinstellungen zur Verfügung: {{MenuCommand|Bearbeiten → Einstellungen... → Draft → Raster und Einrasten}}.<br />
* Der Einrastradius kann auch "on-the-fly" geändert werden (see [[Draft_Snap/de#Einstellungen|Draft Einrasten]]) oder durch {{MenuCommand|Werkzeuge → Parameter bearbeiten... → BaseApp → Preferences → Mod → Draft → snapRange}}.<br />
<br />
<span id="Scripting"></span><br />
==Skripten==<br />
<br />
Siehe auch: [https://freecad.github.io/SourceDoc/ Autogenerierte API-Dokumentation] und [[FreeCAD_Scripting_Basics/de|FreeCAD Grundlagen Skripten]].<br />
<br />
{{Version/de|0.22}}<br />
<br />
Das Modul WorkingPlane (Arbeitsebene) enthält zwei Klassen zur Erstellung von Arbeitsebenen (working plane objects): Die Klasse {{incode|PlaneBase}} und die Klasse {{incode|PlaneGui}}. Die zweite Klasse ist von der ersten abgeleitet. Objekte der Klasse {{incode|PlaneGui}} arbeiten mit der GUI (Schaltfläche im [[Draft_Tray/de|Draft Tray]]), der [[3D_view|3D-Ansicht]] und dem [[Draft_Snap_Grid/de|Raster]] zusammen. {{incode|PlaneBase}}-Objekte tun dies nicht.<br />
<br />
Die Methode {{incode|get_working_plane()}} der Arbeitsebene wird verwendet, um eine Instanz der Klasse {{incode|PlaneGui}} zu erhalten, die mit der 3D-Ansicht verknüpft ist. Die Methode gibt entweder die vorhandene Arbeitsebene zurück, die mit der Ansicht verknüpft ist, oder erstellt eine neue Arbeitsebene, fallls erforderlich.<br />
<br />
{{Code|code=<br />
import FreeCAD as App<br />
import WorkingPlane<br />
<br />
wp = WorkingPlane.get_working_plane()<br />
<br />
origin = App.Vector(0, 0, 0)<br />
normal = App.Vector(1, 1, 1).normalize()<br />
offset = 17<br />
wp.align_to_point_and_axis(origin, normal, offset)<br />
<br />
point = App.Vector(10, 15, 2)<br />
projection = wp.project_point(point)<br />
print(projection)<br />
}}<br />
<br />
Die Klasse {{incode|PlaneBase}} kann verwendet werden, um Arbeitsebenen unabhängig von der GUI zuerstellen:<br />
<br />
{{Code|code=<br />
import WorkingPlane<br />
<br />
wp = WorkingPlane.PlaneBase()<br />
}}<br />
<br />
<br />
{{Docnav/de<br />
|[[Draft_Shape2DView/de|Form2DAnsicht]]<br />
|[[Draft_SetStyle/de|StilFestlegen]]<br />
|[[Draft_Workbench/de|Draft]]<br />
|IconL=Draft_Shape2DView.svg<br />
|IconR=Draft_SetStyle.svg<br />
|IconC=Workbench_Draft.svg<br />
}}<br />
<br />
{{Draft Tools navi{{#translation:}}}}<br />
{{Userdocnavi{{#translation:}}}}</div>FuzzyBot