Draft PathArray/de: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
(2 intermediate revisions by one other user not shown)
Line 44: Line 44:
==Eigenschaften==
==Eigenschaften==


* {{PropertyData|Base}}: specifies the object to duplicate in the path.
* {{PropertyData/de|Grundlage}}: gibt das zu duplizierende Objekt im Pfad an.
* {{PropertyData|PathObj}}: specifies the path object.
* {{PropertyData/de|PfadObj}}: gibt das Pfadobjekt an.
* {{PropertyData|PathSubs}}: specifies the sub-elements (edges) of the path object. This property does not yet appear in the [[property editor|property editor]].
* {{PropertyData/de|PfadUnter}}}: gibt die Unterelemente (Kanten) des Pfadobjekts an. Diese Eigenschaft erscheint noch nicht im [[property editor/de|Eigenschaftseditor]].
* {{PropertyData|Count}}: specifies the number of copies of the base object.
* {{PropertyData/de|Zähle}}: gibt die Anzahl der Kopien des Basisobjekts an.
* {{PropertyData|Align}}: if it is {{TRUE}} the copies are aligned to the path; otherwise they are left in their default orientation.
* {{{PropertyData/de|Ausrichten}}: wenn sie {{TRUE}} ist, werden die Kopien am Pfad ausgerichtet; andernfalls werden sie in ihrer Standardausrichtung belassen.
:{{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.
:{{Emphasis|Hinweis:}} in bestimmten Fällen erscheint die Form flach, in Wirklichkeit kann sie sich im 3D Raum bewegt haben, ändere also statt einer flachen Ansicht die Ansicht auf axonometrisch.
* {{PropertyData|Xlate}}: specifies a translation vector (x, y, z) to displace each copy along the path.
* {{PropertyData/de|Xlate}}: gibt einen Translationsvektor (x, y, z) an, um jede Kopie entlang des Pfades zu verschieben.
:{{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.
:{{Emphasis|Hinweis:}} wenn {{PropertyData/de|Ausrichten}} {{TRUE}} ist, ist der Vektor relativ zu den lokalen Tangenten-, Normal- oder Binormalkoordinaten; andernfalls ist der Vektor relativ zu den globalen Koordinaten.


==Skripten==
==Skripten==
Line 61: Line 61:
}}
}}


* Creates a {{incode|PathArray}} object from the {{incode|baseobject}}, by placing as many as {{incode|count}} copies along {{incode|pathobject}}.
* Erstellt eine {{incode|Pfad Anordnungs}} Objekt aus dem {{incode|baseobject}}, indem bis zu {{incode|Anzahl}} Kopien entlang des {{incode/de|Pfadobjekt}} platziert werden.
** If {{incode|pathobjsubs}} is given, it is a list of sub-objects of {{incode|pathobject}}, and the copies are created along this shorter path.
** 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.
* If {{incode|xlate}} is given, it is a {{incode|FreeCAD.Vector}} that indicates an additional displacement to move the base point of the copies.
* 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.
* 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.
* 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.


Beispiel:
Beispiel:
Line 113: Line 113:


{{Emphasis|Editor:}} Vielen Dank an den Benutzer DeepSOIC für diese Erklärung.
{{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 Mode
[[Image:patharray_FrenetMode.png|600px|left|Align false]]
{{clear}}



{{Docnav/de
{{Docnav/de

Revision as of 20:41, 22 May 2020

Draft PathArray

Menüeintrag
Entwurf → PfadAnordnung
Arbeitsbereich
Entwurf, Arch
Standardtastenkürzel
Keiner
Eingeführt in Version
-
Siehe auch
Entwurf PfadVerknüpfeAnordnung, Entwurf Anordnung, Entwurf VerknüpfeAnordnung, Entwurf PunktAnordnung

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 2D Formen verwendet werden, die mit der Entwurf Arbeitsbereich erstellt wurden, aber auch auf vielen Arten von 3D Objekten, wie sie mit der Part Arbeitsbereich, PartDesign Arbeitsbereich oder Arch Arbeitsbereichen erstellt wurden.

Um Kopien in einem orthogonalen Anordnung zu positionieren, verwende Entwurf Anordnung; um Kopien an bestimmten Punkten zu positionieren, verwende Entwurf PunktAnordnung; um Kopien oder Klone zu erstellen und diese manuell zu platzieren, verwende Entwurf Bewegen, Entwurf Drehung und Entwurf Klon.

Objekt entlang einer Bahn angeordnet

Anwendung

  1. Wähle ein Objekt aus, das du verteilen möchten.
  2. Wähle ein Pfadobjekt oder einige Kanten aus, entlang derer das Objekt verteilt werden soll.
  3. Drücke die Entwurf PfadAnordnung Taste.
  4. 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.

Das Basisobjekt sollte um den Ursprung zentriert sein, auch wenn die Bahn irgendwo anders beginnt.

Optionen

Es gibt keine Optionen für dieses Werkzeug. Entweder funktioniert es mit den ausgewählten Objekten oder nicht.

Eigenschaften

  • Daten-EigenschaftGrundlage: gibt das zu duplizierende Objekt im Pfad an.
  • Daten-EigenschaftPfadObj: gibt das Pfadobjekt an.
  • Daten-EigenschaftPfadUnter}: gibt die Unterelemente (Kanten) des Pfadobjekts an. Diese Eigenschaft erscheint noch nicht im Eigenschaftseditor.
  • Daten-EigenschaftZähle: gibt die Anzahl der Kopien des Basisobjekts an.
  • {Daten-EigenschaftAusrichten: wenn sie true ist, werden die Kopien am Pfad ausgerichtet; andernfalls werden sie in ihrer Standardausrichtung belassen.
Hinweis: in bestimmten Fällen erscheint die Form flach, in Wirklichkeit kann sie sich im 3D Raum bewegt haben, ändere also statt einer flachen Ansicht die Ansicht auf axonometrisch.
  • Daten-EigenschaftXlate: gibt einen Translationsvektor (x, y, z) an, um jede Kopie entlang des Pfades zu verschieben.
Hinweis: wenn Daten-EigenschaftAusrichten true ist, ist der Vektor relativ zu den lokalen Tangenten-, Normal- oder Binormalkoordinaten; andernfalls ist der Vektor relativ zu den globalen Koordinaten.

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:

PathArray = makePathArray(baseobject, pathobject, count, xlate=None, align=False, pathobjsubs=[])
  • Erstellt eine Pfad Anordnungs Objekt aus dem baseobject, indem bis zu Anzahl Kopien entlang des Template:Incode/de platziert werden.
  • Wenn xlate angegeben wird, handelt es sich um einen FreeCAD.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,Draft

p1 = FreeCAD.Vector(500, -1000, 0)
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)

PathArray = Draft.makePathArray(object, spline, 6)

Technische Erklärung für die Ausrichteigenschaft

Wenn DatenAlign false ist, ist die Platzierung der kopierten Formen leicht zu verstehen; sie werden einfach an eine andere Position in ihrer ursprünglichen Ausrichtung verschoben.

Align false
Align false

Objekt, das entlang eines geschlossenen Pfades in der ursprünglichen Ausrichtung angeordnet ist.

Wenn DatenAlign true ist, wird die Positionierung der Formen etwas komplexer:

  1. Zuerst werden Frenet Koordinatensysteme auf dem Pfad aufgebaut: X ist tangential, Z ist normal, Y ist binormal.
  2. 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

Align false
Align false

Railway cross ties (sleepers) - Tangent mode + ForceVertical

Align false
Align false

Frenet Mode

Align false
Align false