Draft PathArray/de: Difference between revisions
No edit summary |
(Updating to match new version of source page) |
||
(29 intermediate revisions by 3 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
<languages/> |
||
<div class="mw-translate-fuzzy"> |
|||
{{Docnav/de |
{{Docnav/de |
||
|[[Draft_LinkArray|Verknüpfe Anordnung]] |
|[[Draft_LinkArray/de|Verknüpfe Anordnung]] |
||
|[[Draft_PathLinkArray|Pfad VerknüpfeAnordnung]] |
|[[Draft_PathLinkArray/de|Pfad VerknüpfeAnordnung]] |
||
|[[Draft_Module| |
|[[Draft_Module/de|Entwurf]] |
||
|IconL=Draft_LinkArray.svg |
|IconL=Draft_LinkArray.svg |
||
|IconC=Workbench_Draft.svg |
|IconC=Workbench_Draft.svg |
||
|IconR=Draft_PathLinkArray.svg |
|IconR=Draft_PathLinkArray.svg |
||
}} |
}} |
||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
{{GuiCommand/de |
{{GuiCommand/de |
||
|Name=Draft PathArray |
|Name=Draft PathArray |
||
| |
|Name/de=Entwurf PfadAnordnung |
||
|MenuLocation=Modifikation → Anordnung Werkzeuge → Pfad Anordnung |
|||
|Workbenches=[[Draft Module/de|Entwurf]], [[Arch Module/de|Arch]] |
|Workbenches=[[Draft Module/de|Entwurf]], [[Arch Module/de|Arch]] |
||
|SeeAlso=[[ |
|SeeAlso=[[Draft_OrthoArray/de|Entwurf OrthoAnordnung]], [[Draft_PolarArray/de|Entwurf PolarArray]], [[Draft_CircularArray/de|Entwurf CircularArray]], [[Draft PathLinkArray/de|Entwurf PfadVerknüpfeAnordnung]], [[Draft PointArray/de|Entwurf PunktAnordnung]], [[Draft_Clone/de|Entwurf Klonen]] |
||
|Version=0.14 |
|||
}} |
}} |
||
</div> |
|||
==Beschreibung== |
==Beschreibung== |
||
<div class="mw-translate-fuzzy"> |
|||
Das {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft PathArray/de|Entwurf PfadAnordnung]]}} Werkzeug platziert Kopien einer ausgewählten Form entlang eines ausgewählten Pfades, der ein [[Draft Wire/de|Entwurf Draht]], ein [[Draft BSpline|Entwurf BSpline]] und ähnliche Kanten sein kann. |
Das {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft PathArray/de|Entwurf PfadAnordnung]]}} Werkzeug platziert Kopien einer ausgewählten Form entlang eines ausgewählten Pfades, der ein [[Draft Wire/de|Entwurf Draht]], ein [[Draft BSpline|Entwurf BSpline]] und ähnliche Kanten sein kann. |
||
</div> |
|||
Das PfadAnordnungswerkzeug kann auf |
Das PfadAnordnungswerkzeug kann auf jedes Objekt verwendet werden das eine [[Part_TopoShape/de|Part TopoForm]] hat, bedeutet 2D Formen, die mit dem [[Draft Workbench/de|Entwurf Arbeitsbereich]] erstellt wurden, aber auch 3D Festkörper, die mit anderen Arbeitsbereichen erstellt wurden, z.B. [[Part Workbench/de|Part Arbeitsbereich]], [[PartDesign Workbench/de|PartDesign Arbeitsbereich]] oder [[Arch Workbench/de|Arch Arbeitsbereich]]. |
||
* Um rechtwinklig, polare oder kreisförmige Anordnungen zu erstellen, verwende die entsprechende {{Button|[[File:Draft_OrthoArray.svg|16px]] [[Draft_OrthoArray/de|OrthoAnordnung]]}}, {{Button|[[File:Draft_PolarArray.svg|16px]] [[Draft_PolarArray/de|PolarAnordnung]]}}, oder {{Button|[[File:Draft_CircularArray.svg|16px]] [[Draft_CircularArray/de|CircularAnordnung]]}}s Werkzeuge. |
|||
Um Kopien in einem orthogonalen Anordnung zu positionieren, verwende [[Draft Array/de|Entwurf Anordnung]]; um Kopien an bestimmten Punkten zu positionieren, verwende [[Draft PointArray/de|Entwurf PunktAnordnung]]; um Kopien oder Klone zu erstellen und diese manuell zu platzieren, verwende [[Draft Move/de|Entwurf Bewegen]], [[Draft Rotate/de|Entwurf Drehung]] und [[Draft Clone/de|Entwurf Klon]]. |
|||
* Um [[App_Link/de|Anwendungsverknüpfungs]] Kopien entlang eines Pfades zu positionieren, verwende {{Button|[[File:Draft_PathLinkArray.svg|16px]] [[Draft_PathLinkArray/de|PfadVerknüpfeAnordnung]]}}. |
|||
* Um Kopien an festgelegten Punkten zu positionieren, verwende {{Button|[[File:Draft_PointArray.svg|16px]] [[Draft_PointArray/de|PunktAnordnung]]}} oder {{Button|[[File:Draft_PointLinkArray.svg|16px]] [[Draft_PointLinkArray/de|PunktVerknüpfeAnordnung]]}}. |
|||
* Um Kopien zu erstellen und manuell zu platzieren, verwende {{Button|[[File:Draft_Move.svg|16px]] [[Draft_Move/de|Bewegen]]}} oder {{Button|[[File:Draft_Rotate.svg|16px]] [[Draft_Rotate/de|Drehen]]}}. |
|||
* Um exakte Kopien zu erstellen und diese manuell zu platzieren oder zu skalieren, verwende {{Button|[[File:Draft_Clone.svg|16px]] [[Draft_Clone/de|Klonen]]}} oder {{Button|[[File:Std_LinkMake.svg|16px]] [[Std_LinkMake/de|Std MacheVerknüpfung]]}}. |
|||
[[Image:Draft_PathArray_Example.png|400px]] |
[[Image:Draft_PathArray_Example.png|400px]] |
||
{{Caption|Objekt entlang |
{{Caption|Objekt entlang eines Pfades angeordnet}} |
||
==Anwendung== |
==Anwendung== |
||
# Wähle |
# Wähle das Objekt aus, das du verteilen möchtest. |
||
# Wähle |
# Wähle das Pfadobjekt oder die Kanten, entlang derer das Objekt verteilt werden soll. |
||
# Drücke die |
# Drücke die {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray/de|PfadAnordnung]]}} Schaltfläche. |
||
# Das Anordnungsobjekt wird sofort erzeugt. Du musst die Eigenschaften der Anordnung ändern, um die Anzahl und Richtung der erstellten Kopien zu ändern. |
# Das Anordnungsobjekt wird sofort erzeugt. Du musst die Eigenschaften der Anordnung ändern, um die Anzahl und Richtung der erstellten Kopien zu ändern. |
||
Jedes Element in der Anordnung ist ein exakter Klon des ursprünglichen Objekts, aber die gesamte Anordnung wird in Bezug auf Eigenschaften und Aussehen als eine Einheit betrachtet. |
Jedes Element in der Anordnung ist ein exakter Klon des ursprünglichen Objekts, aber die gesamte Anordnung wird in Bezug auf Eigenschaften und Aussehen als eine Einheit betrachtet. |
||
{{Emphasis|Hinweis:}} wenn das {{PropertyData|Basis}} Objekt nicht korrekt im Pfad positioniert zu sein scheint, prüfe, ob seine {{PropertyData|Platzierung}} im Ursprung {{Value|(0,0,0)}} liegt. |
|||
Das Basisobjekt sollte um den Ursprung zentriert sein, auch wenn die Bahn irgendwo anders beginnt. |
|||
Bestimmte Objekte können überall im 3D Raum platziert werden wenn mit dem {{Button|[[Image:Draft_PathArray.svg|16px]] [[Draft_PathArray/de|PfadAnordnungs]]}} Werkzeug verwendet, jedoch müssen andere am Ursprung sein, insbesondere solche, die unter Verwendung von {{Button|[[File:Part_Extrude.svg|16px]] [[Part_Extrude/de|Part Extrudieren]]}} mit einem 2D Profil wie eine {{Button|[[File:Sketcher_NewSketch.svg|16px]] [[Sketch/de|Skizze]]}} erstellt wurden. |
|||
==Optionen== |
==Optionen== |
||
Line 44: | Line 57: | ||
==Eigenschaften== |
==Eigenschaften== |
||
Eine [[Draft_PathArray/de|PfadAnordnung]] wird abgeleitet von einer [[Part_Feature/de|Part Formelement]] ({{incode|Part::Feature}} Klasse), daher teilt sie alle Eigenschaften der letzteren. Zusätzlich zu den in [[Part_Feature/de|Part Formelement]] beschriebenen Eigenschaften hat die PfadAnordnung die folgenden Eigenschaften im [[property_editor/de|Eigenschaftseditor]] . |
|||
* {{PropertyData|Base}}: specifies the object to duplicate in the path. |
|||
* {{PropertyData|PathObj}}: specifies the path object. |
|||
* {{PropertyData|PathSubs}}: specifies the sub-elements (edges) of the path object. This property does not yet appear in the [[property editor|property editor]]. |
|||
* {{PropertyData|Count}}: specifies the number of copies of the base object. |
|||
* {{PropertyData|Align}}: if it is {{TRUE}} the copies are aligned to the path; otherwise they are left in their default orientation. |
|||
:{{Emphasis|Note:}} in certain cases the shape will appear flat, in reality it may have moved in the 3D space, so instead of using a flat view, change the view to axonometric. |
|||
* {{PropertyData|Xlate}}: specifies a translation vector (x, y, z) to displace each copy along the path. |
|||
:{{Emphasis|Note:}} when {{PropertyData|Align}} is {{TRUE}}, the vector is relative to the local tangent, normal or binormal coordinates; otherwise the vector is relative to the global coordinates. |
|||
<div class="mw-translate-fuzzy"> |
|||
==Skripteng== |
|||
{{TitleProperty|Ausrichtung}} |
|||
{{Emphasis|Siehe auch:}} [[Draft API/de|Draft API]] und [[FreeCAD Scripting Basics/de|FreeCAD Scripting Grundlagen]]. |
|||
* {{PropertyData|Ausrichten|Bool}}: wenn es {{TRUE}} ist, werden die Kopien am Pfad ausgerichtet; andernfalls werden sie in ihrer Standardausrichtung belassen. |
|||
:{{Emphasis|Hinweis:}} in bestimmten Fällen wird die Form flach erscheinen, in Wirklichkeit kann sie sich im 3D Raum bewegt haben, ändere also statt einer flachen Ansicht die Ansicht auf axonometrisch. |
|||
* {{PropertyData|Ausrichtungsmodus|Aufzählung}}: drei Modi, {{Value|Original}}, {{Value|Frenet}}, {{Value|Tangent}}. |
|||
* {{PropertyDataZusätzliche Translation|VektorAbstand}}: zusätzlicher Verschiebungsvektor {{Value|(x, y, z)}}, der auf jede Kopie entlang des Pfades angewendet wird. Dies ist nützlich, um kleine Anpassungen in der Position der Kopien vorzunehmen, z.B. wenn ihr Referenzpunkt nicht mit dem Mittelpunkt ihrer Form übereinstimmt. |
|||
* {{PropertyData|Force Vertical|Bool}}: Wenn er {{TRUE}} ist, wird der Wert von {{PropertyData|Vertikal Vektor}} als lokale Z Richtung verwendet, wenn {{PropertyData|Ausrichtungsmodus}} {{Value|Original}} oder {{Value|Tangente}} ist. {{Version|0.19}} |
|||
* {{PropertyData|Tangentenvektor|Vektor}}: die Standardeinstellung ist {{Value|(1, 0, 0)}}; Ausrichtungseinheitsvektor, der verwendet wird, wenn {{PropertyData|Ausrichtungsmodus}} {{Value|Tangente}} ist. {{Version|0.19}} |
|||
* {{PropertyData|Vertikal Vektor|Vektor}}}: Standardeinstellung ist {{Value|(0, 0, 1)}}; Einheitsvektor der lokalen Z Richtung, der verwendet wird, wenn {{PropertyData|VertiKal Vektor}} {{TRUE}} ist. {{Version|0.19}} |
|||
</div> |
|||
{{TitleProperty|Objects}} |
|||
Das BahnAnordnungswerkzeug kann in [[macros/de|Makros]] und von der [[Python/de|Python]]-Konsole aus mit folgender Funktion verwendet werden: |
|||
* {{PropertyData|Base|LinkGlobal}}: specifies the object to duplicate in the path. |
|||
* {{PropertyData|Count|Integer}}: specifies the number of copies to create in the path. |
|||
* {{PropertyData|Path Object|LinkGlobal}}: specifies the object along which the copies will be distributed. It must contain {{Value|'Edges'}} in its [[Part_TopoShape|Part TopoShape]]; for example, it could be a {{Button|[[File:Draft_Wire.svg|16px]] [[Draft_Wire|Wire]]}} or {{Button|[[File:Draft_BSpline.svg|16px]] [[Draft_BSpline|BSpline]]}}. |
|||
* {{PropertyData|Path Subelements|LinkSubListGlobal}}: specifies the sub-elements (edges) of the {{PropertyData|Path Object}} on which the copies will be created. The copies will be created only on these edges. If this property is empty, the copies will be distributed on the entire {{PropertyData|Path Object}}. |
|||
==Skripten== |
|||
{{Emphasis|Siehe auch:}} [[Draft API/de|Draft API]] und [[FreeCAD Scripting Basics/de|FreeCAD Grundlagen Skripten]]. |
|||
Das Pfadanordnungswerkzeug kann in [[macros/de|Makros]] und von der [[Python/de|Python]] Konsole aus mit folgender Funktion verwendet werden: |
|||
Alter Aufruf: |
|||
{{Code|code= |
{{Code|code= |
||
path_array = makePathArray(base_object, path_object, count, xlate=None, align=False, pathobjsubs=[]) |
|||
}} |
}} |
||
Neuer Aufruf: |
|||
* Creates a {{incode|PathArray}} object from the {{incode|baseobject}}, by placing as many as {{incode|count}} copies along {{incode|pathobject}}. |
|||
{{Code|code= |
|||
** If {{incode|pathobjsubs}} is given, it is a list of sub-objects of {{incode|pathobject}}, and the copies are created along this shorter path. |
|||
path_array = make_path_array(base_object, path_object, |
|||
* If {{incode|xlate}} is given, it is a {{incode|FreeCAD.Vector}} that indicates an additional displacement to move the base point of the copies. |
|||
count=4, extra=App.Vector(0, 0, 0), subelements=None, |
|||
* If {{incode|align}} is {{incode|True}} the copies are aligned to the tangent, normal or binormal of the {{incode|pathobject}} at the point where the copy is placed. |
|||
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0), |
|||
force_vertical=False, vertical_vector=App.Vector(0, 0, 1), |
|||
use_link=True): |
|||
}} |
|||
<div class="mw-translate-fuzzy"> |
|||
* Erstellt eine {{incode|Pfad Anordnungs}} Objekt aus dem {{incode|baseobject}}, indem bis zu {{incode|Anzahl}} Kopien entlang des {{incode/de|Pfadobjekt}} platziert werden. |
|||
** Wenn {{incode/de|Pfadobjektunter}} angegeben wird, handelt es sich um eine Liste von Unterobjekten von {{incode/de|Pfadobjekt}}, und die Kopien werden entlang dieses kürzeren Pfades erstellt. |
|||
* Wenn {{incode|xlate}} angegeben wird, handelt es sich um einen {{incode|FreeCAD.Vector}}, der eine zusätzliche Verschiebung anzeigt, um den Basispunkt der Kopien zu verschieben. |
|||
* Wenn {{incode|align}} {{incode|True}} ist, werden die Kopien an der Tangente, der Normalen oder dem Binormalen des {{incode/de|Pfadobjekt}} an dem Punkt ausgerichtet, an dem die Kopie platziert wird. |
|||
</div> |
|||
Beispiel: |
Beispiel: |
||
{{Code|code= |
{{Code|code= |
||
import FreeCAD |
import FreeCAD as App |
||
import Draft |
|||
doc = App.newDocument() |
|||
p1 = App.Vector(500, -1000, 0) |
|||
p2 = App.Vector(1500, 1000, 0) |
|||
p3 = App.Vector(3000, 500, 0) |
|||
p4 = App.Vector(4500, 100, 0) |
|||
spline = Draft.make_bspline([p1, p2, p3, p4]) |
|||
obj = Draft.make_polygon(3, 500) |
|||
path_array = Draft.make_path_array(obj, spline, 6) |
|||
p1 = FreeCAD.Vector(500, -1000, 0) |
|||
doc.recompute() |
|||
p2 = FreeCAD.Vector(1500, 1000, 0) |
|||
p3 = FreeCAD.Vector(3000, 500, 0) |
|||
p4 = FreeCAD.Vector(4500, 100, 0) |
|||
spline = Draft.makeBSpline([p1, p2, p3, p4]) |
|||
object = Draft.makePolygon(3, 500) |
|||
wire = Draft.make_wire([p1, -p2, -p3, -p4]) |
|||
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True) |
|||
doc.recompute() |
|||
}} |
}} |
||
==Technische Erklärung für die Ausrichteigenschaft== |
==Technische Erklärung für die Ausrichteigenschaft== |
||
Wenn {{PropertyData| |
Wenn {{PropertyData|Ausrichten}} {{FALSE}} ist, ist die Platzierung der kopierten Formen leicht zu verstehen; sie werden einfach an eine andere Position in ihrer ursprünglichen Ausrichtung verschoben. |
||
[[Image:patharray_NoAlign.png|600px|left|Align false]] |
[[Image:patharray_NoAlign.png|600px|left|Align false]] |
||
{{clear}} |
{{clear}} |
||
{{Caption|Objekt, das entlang eines geschlossenen Pfades in der ursprünglichen Ausrichtung angeordnet ist.}} |
{{Caption|Objekt, das entlang eines geschlossenen Pfades in der ursprünglichen Ausrichtung angeordnet ist.}} |
||
Wenn {{PropertyData|Align}} {{TRUE}} ist, wird die Positionierung der Formen etwas komplexer: |
|||
# |
# Zuerst werden Frenet Koordinatensysteme auf dem Pfad aufgebaut: X ist tangential, Z ist normal, Y ist binormal. |
||
# Dann wird das Originalobjekt in jedes pfadbegleitende Koordinatensystem kopiert, so dass der globale Ursprung mit dem Ursprung des pfadbegleitenden Koordinatensystems übereinstimmt. |
|||
# Then the original object is copied to every on-path coordinate system, so that the global origin is matched with the on-path coordinate system origin. |
|||
[[Image:patharray alignment annotated.png|600px|left]] |
[[Image:patharray alignment annotated.png|600px|left]] |
||
{{clear}} |
{{clear}} |
||
Line 111: | Line 155: | ||
Da du den Pfad, aber nicht das Objekt neu orientierst, ist das Ergebnis konsistent: Das Objekt bleibt so am Pfad ausgerichtet, wie es vor der Neuausrichtung des Pfades war. |
Da du den Pfad, aber nicht das Objekt neu orientierst, ist das Ergebnis konsistent: Das Objekt bleibt so am Pfad ausgerichtet, wie es vor der Neuausrichtung des Pfades war. |
||
{{Emphasis|Editor:}} Vielen Dank an den Benutzer DeepSOIC für diese Erklärung. |
|||
==Additional alignment modes and options introduced in v0.19== |
|||
'''Original''' mode (the default) is the historic alignment mode as in version 0.18. |
|||
It is not really the Frenet alignment. Original mode uses the normal parameter |
|||
from Draft.getNormal (or the default) as a constant - it does not calculate |
|||
curve normal. X follows the curve tangent, Y is the normal parameter, Z is |
|||
X.Cross(Y). |
|||
'''Tangent''' mode is similar to '''Original''', but includes a rotation to align the |
|||
Base object's X to the TangentVector before placing copies. After the |
|||
rotation, Tangent behaves the same as Original. In previous versions this |
|||
rotation would be performed manually before invoking PathArray. |
|||
'''Frenet''' mode orients the copies to a coordinate system along the path. X is |
|||
tangent to curve, Y is curve normal, Z is curve binormal. If a normal can not |
|||
be computed (ex a straight line), the default is used. |
|||
The ForceVertical option applies to Original and Tangent modes. When this |
|||
option is applied, the normal parameter from Draft.getNormal is ignored. X |
|||
follows the curve tangent, Z is the VerticalVector property and Y is |
|||
X.Cross(Z). |
|||
Version 18 cycle chain - Original mode |
|||
[[Image:patharray_cycleChain.png|600px|left|Align false]] |
|||
{{clear}} |
|||
Railway cross ties (sleepers) - Tangent mode + ForceVertical |
|||
[[Image:patharray_railwayTies.png|600px|left|Align false]] |
|||
{{clear}} |
|||
Frenet Modus |
|||
[[Image:patharray_FrenetMode.png|600px|left|Align false]] |
|||
{{clear}} |
|||
<div class="mw-translate-fuzzy"> |
<div class="mw-translate-fuzzy"> |
||
{{Docnav/de |
|||
{{Emphasis|Editor:}}} Vielen Dank an den Benutzer DeepSOIC für diese Erklärung. |
|||
|[[Draft_LinkArray/de|Verknüpfe Anordnung]] |
|||
|[[Draft_PathLinkArray/de|Pfad VerknüpfeAnordnung]] |
|||
|[[Draft_Module/de|Entwurf]] |
|||
|IconL=Draft_LinkArray.svg |
|||
|IconC=Workbench_Draft.svg |
|||
|IconR=Draft_PathLinkArray.svg |
|||
}} |
|||
</div> |
</div> |
||
{{Docnav|[[Draft_LinkArray|Link Array]]|[[Draft_PathLinkArray|Path LinkArray]]|[[Draft_Module|Draft]]|IconL=Draft_LinkArray.svg|IconC=Workbench_Draft.svg|IconR=Draft_PathLinkArray.svg}} |
|||
{{Draft Tools navi{{#translation:}}}} |
{{Draft Tools navi{{#translation:}}}} |
Revision as of 14:19, 1 December 2020
Entwurf PfadAnordnung |
Menüeintrag |
---|
Modifikation → Anordnung Werkzeuge → Pfad Anordnung |
Arbeitsbereich |
Entwurf, Arch |
Standardtastenkürzel |
Keiner |
Eingeführt in Version |
0.14 |
Siehe auch |
Entwurf OrthoAnordnung, Entwurf PolarArray, Entwurf CircularArray, Entwurf PfadVerknüpfeAnordnung, Entwurf PunktAnordnung, Entwurf Klonen |
Beschreibung
Das Entwurf PfadAnordnung Werkzeug platziert Kopien einer ausgewählten Form entlang eines ausgewählten Pfades, der ein Entwurf Draht, ein Entwurf BSpline und ähnliche Kanten sein kann.
Das PfadAnordnungswerkzeug kann auf jedes Objekt verwendet werden das eine Part TopoForm hat, bedeutet 2D Formen, die mit dem Entwurf Arbeitsbereich erstellt wurden, aber auch 3D Festkörper, die mit anderen Arbeitsbereichen erstellt wurden, z.B. Part Arbeitsbereich, PartDesign Arbeitsbereich oder Arch Arbeitsbereich.
- Um rechtwinklig, polare oder kreisförmige Anordnungen zu erstellen, verwende die entsprechende OrthoAnordnung, PolarAnordnung, oder CircularAnordnungs Werkzeuge.
- Um Anwendungsverknüpfungs Kopien entlang eines Pfades zu positionieren, verwende PfadVerknüpfeAnordnung.
- Um Kopien an festgelegten Punkten zu positionieren, verwende PunktAnordnung oder PunktVerknüpfeAnordnung.
- Um Kopien zu erstellen und manuell zu platzieren, verwende Bewegen oder Drehen.
- Um exakte Kopien zu erstellen und diese manuell zu platzieren oder zu skalieren, verwende Klonen oder Std MacheVerknüpfung.
Objekt entlang eines Pfades angeordnet
Anwendung
- Wähle das Objekt aus, das du verteilen möchtest.
- Wähle das Pfadobjekt oder die Kanten, entlang derer das Objekt verteilt werden soll.
- Drücke die PfadAnordnung Schaltfläche.
- Das Anordnungsobjekt wird sofort erzeugt. Du musst die Eigenschaften der Anordnung ändern, um die Anzahl und Richtung der erstellten Kopien zu ändern.
Jedes Element in der Anordnung ist ein exakter Klon des ursprünglichen Objekts, aber die gesamte Anordnung wird in Bezug auf Eigenschaften und Aussehen als eine Einheit betrachtet.
Hinweis: wenn das DatenBasis Objekt nicht korrekt im Pfad positioniert zu sein scheint, prüfe, ob seine DatenPlatzierung im Ursprung (0,0,0)
liegt.
Bestimmte Objekte können überall im 3D Raum platziert werden wenn mit dem PfadAnordnungs Werkzeug verwendet, jedoch müssen andere am Ursprung sein, insbesondere solche, die unter Verwendung von Part Extrudieren mit einem 2D Profil wie eine Skizze erstellt wurden.
Optionen
Es gibt keine Optionen für dieses Werkzeug. Entweder funktioniert es mit den ausgewählten Objekten oder nicht.
Eigenschaften
Eine PfadAnordnung wird abgeleitet von einer Part Formelement (Part::Feature
Klasse), daher teilt sie alle Eigenschaften der letzteren. Zusätzlich zu den in Part Formelement beschriebenen Eigenschaften hat die PfadAnordnung die folgenden Eigenschaften im Eigenschaftseditor .
Ausrichtung
- DatenAusrichten (
Bool
): wenn estrue
ist, werden die Kopien am Pfad ausgerichtet; andernfalls werden sie in ihrer Standardausrichtung belassen.
- Hinweis: in bestimmten Fällen wird die Form flach erscheinen, in Wirklichkeit kann sie sich im 3D Raum bewegt haben, ändere also statt einer flachen Ansicht die Ansicht auf axonometrisch.
- DatenAusrichtungsmodus (
Aufzählung
): drei Modi,Original
,Frenet
,Tangent
. - Template:PropertyDataZusätzliche Translation: zusätzlicher Verschiebungsvektor
(x, y, z)
, der auf jede Kopie entlang des Pfades angewendet wird. Dies ist nützlich, um kleine Anpassungen in der Position der Kopien vorzunehmen, z.B. wenn ihr Referenzpunkt nicht mit dem Mittelpunkt ihrer Form übereinstimmt. - DatenForce Vertical (
Bool
): Wenn ertrue
ist, wird der Wert von DatenVertikal Vektor als lokale Z Richtung verwendet, wenn DatenAusrichtungsmodusOriginal
oderTangente
ist. introduced in version 0.19 - DatenTangentenvektor (
Vektor
): die Standardeinstellung ist(1, 0, 0)
; Ausrichtungseinheitsvektor, der verwendet wird, wenn DatenAusrichtungsmodusTangente
ist. introduced in version 0.19 - DatenVertikal Vektor (
Vektor
)}: Standardeinstellung ist(0, 0, 1)
; Einheitsvektor der lokalen Z Richtung, der verwendet wird, wenn DatenVertiKal Vektortrue
ist. introduced in version 0.19
Objects
- DatenBase (
LinkGlobal
): specifies the object to duplicate in the path. - DatenCount (
Integer
): specifies the number of copies to create in the path. - DatenPath Object (
LinkGlobal
): specifies the object along which the copies will be distributed. It must contain'Edges'
in its Part TopoShape; for example, it could be a Wire or BSpline. - DatenPath Subelements (
LinkSubListGlobal
): specifies the sub-elements (edges) of the DatenPath Object on which the copies will be created. The copies will be created only on these edges. If this property is empty, the copies will be distributed on the entire DatenPath Object.
Skripten
Siehe auch: Draft API und FreeCAD Grundlagen Skripten.
Das Pfadanordnungswerkzeug kann in Makros und von der Python Konsole aus mit folgender Funktion verwendet werden:
Alter Aufruf:
path_array = makePathArray(base_object, path_object, count, xlate=None, align=False, pathobjsubs=[])
Neuer Aufruf:
path_array = make_path_array(base_object, path_object,
count=4, extra=App.Vector(0, 0, 0), subelements=None,
align=False, align_mode="Original", tan_vector=App.Vector(1, 0, 0),
force_vertical=False, vertical_vector=App.Vector(0, 0, 1),
use_link=True):
- Erstellt eine
Pfad Anordnungs
Objekt aus dembaseobject
, indem bis zuAnzahl
Kopien entlang des Template:Incode/de platziert werden.- Wenn Template:Incode/de angegeben wird, handelt es sich um eine Liste von Unterobjekten von Template:Incode/de, und die Kopien werden entlang dieses kürzeren Pfades erstellt.
- Wenn
xlate
angegeben wird, handelt es sich um einenFreeCAD.Vector
, der eine zusätzliche Verschiebung anzeigt, um den Basispunkt der Kopien zu verschieben. - Wenn
align
True
ist, werden die Kopien an der Tangente, der Normalen oder dem Binormalen des Template:Incode/de an dem Punkt ausgerichtet, an dem die Kopie platziert wird.
Beispiel:
import FreeCAD as App
import Draft
doc = App.newDocument()
p1 = App.Vector(500, -1000, 0)
p2 = App.Vector(1500, 1000, 0)
p3 = App.Vector(3000, 500, 0)
p4 = App.Vector(4500, 100, 0)
spline = Draft.make_bspline([p1, p2, p3, p4])
obj = Draft.make_polygon(3, 500)
path_array = Draft.make_path_array(obj, spline, 6)
doc.recompute()
wire = Draft.make_wire([p1, -p2, -p3, -p4])
path_array2 = Draft.make_path_array(obj, wire, count=3, extra=App.Vector(0, -500, 0), subelements=["Edge2", "Edge3"], align=True, force_vertical=True)
doc.recompute()
Technische Erklärung für die Ausrichteigenschaft
Wenn DatenAusrichten false
ist, ist die Platzierung der kopierten Formen leicht zu verstehen; sie werden einfach an eine andere Position in ihrer ursprünglichen Ausrichtung verschoben.
Objekt, das entlang eines geschlossenen Pfades in der ursprünglichen Ausrichtung angeordnet ist.
Wenn DatenAlign true
ist, wird die Positionierung der Formen etwas komplexer:
- Zuerst werden Frenet Koordinatensysteme auf dem Pfad aufgebaut: X ist tangential, Z ist normal, Y ist binormal.
- Dann wird das Originalobjekt in jedes pfadbegleitende Koordinatensystem kopiert, so dass der globale Ursprung mit dem Ursprung des pfadbegleitenden Koordinatensystems übereinstimmt.
Objekt angeordnet entlang einer geschlossenen Bahn; Beschreibung der Komponenten und der Bahn
Die folgenden Bilder zeigen, wie die Anordnung erzeugt wird, je nachdem, in welcher Ebene die Bahn liegt.
Bahn in der XY Ebene:
Objekt, angeordnet entlang einer geschlossenen Bahn, die auf die XY Ebene ausgerichtet ist
Pfad in der XZ Ebene:
Objekt angeordnet entlang einer geschlossenen Bahn, die auf die XZ Ebene ausgerichtet ist
Pfad in der YZ Ebene:
Objekt angeordnet entlang eines geschlossenen Pfades, der auf die YZ Ebene ausgerichtet ist
Da du den Pfad, aber nicht das Objekt neu orientierst, ist das Ergebnis konsistent: Das Objekt bleibt so am Pfad ausgerichtet, wie es vor der Neuausrichtung des Pfades war.
Editor: Vielen Dank an den Benutzer DeepSOIC für diese Erklärung.
Additional alignment modes and options introduced in v0.19
Original mode (the default) is the historic alignment mode as in version 0.18. It is not really the Frenet alignment. Original mode uses the normal parameter from Draft.getNormal (or the default) as a constant - it does not calculate curve normal. X follows the curve tangent, Y is the normal parameter, Z is X.Cross(Y).
Tangent mode is similar to Original, but includes a rotation to align the Base object's X to the TangentVector before placing copies. After the rotation, Tangent behaves the same as Original. In previous versions this rotation would be performed manually before invoking PathArray.
Frenet mode orients the copies to a coordinate system along the path. X is tangent to curve, Y is curve normal, Z is curve binormal. If a normal can not be computed (ex a straight line), the default is used.
The ForceVertical option applies to Original and Tangent modes. When this option is applied, the normal parameter from Draft.getNormal is ignored. X follows the curve tangent, Z is the VerticalVector property and Y is X.Cross(Z).
Version 18 cycle chain - Original mode
Railway cross ties (sleepers) - Tangent mode + ForceVertical
Frenet Modus
- Drafting: Line, Polyline, Fillet, Arc, Arc by 3 points, Circle, Ellipse, Rectangle, Polygon, B-spline, Cubic Bézier curve, Bézier curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation styles, Annotation scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar array, Circular array, Path array, Path link array, Point array, Point link array, Edit, Subelement highlight, Join, Split, Upgrade, Downgrade, Wire to B-spline, Draft to sketch, Set slope, Flip dimension, Shape 2D view
- Draft Tray: Select plane, Set style, Toggle construction mode, AutoGroup
- Snapping: Snap lock, Snap endpoint, Snap midpoint, Snap center, Snap angle, Snap intersection, Snap perpendicular, Snap extension, Snap parallel, Snap special, Snap near, Snap ortho, Snap grid, Snap working plane, Snap dimensions, Toggle grid
- Miscellaneous: Apply current style, Layer, Manage layers, Add a new named group, Move to group, Select group, Add to construction group, Toggle normal/wireframe display, Create working plane proxy, Heal, Show snap toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Layer container: Merge layer duplicates, Add new layer
- Layer: Activate this layer, Select layer contents
- Text: Open hyperlinks
- Wire: Flatten
- Working plane proxy: Write camera position, Write objects state
- Erste Schritte
- Installation: Herunterladen, Windows, Linux, Mac, Zusätzlicher Komponenten, Docker, AppImage, Ubuntu Snap
- Grundlagen: Über FreeCAD, Graphische Oberfläche, Mausbedienung, Auswahlmethoden, Objektname, Programmeinstellungen, Arbeitsbereiche, Dokumentstruktur, Objekteigenschaften, Hilf FreeCAD, Spende
- Hilfe: Tutorien, Video Tutorien
- Arbeitsbereiche: Std Base, Arch, Assembly, CAM, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web