Sketcher scripting/de: Difference between revisions

From FreeCAD Documentation
(Created page with "Wenn du z. B. 4 und 5 liest, bedeutet dies, dass der Knoten mit der niedrigeren Nummer (4 in diesem Beispiel) mit der Nummer 1 (zuerst im Skriptbefehl) und der Knoten mit der...")
(Created page with "Die mit 1 und 2 gekennzeichneten Knoten sind in der Reihenfolge ihrer Erstellung nummeriert. Um die Reihenfolge ihrer Erstellung herauszufinden (wenn du viele Linien hast, kan...")
Line 125: Line 125:
* {{incode|n}} to indicate that the constraint affects the n-th pole of a [[File:Sketcher_CompCreateBSpline.png|24px]][[Sketcher CompCreateBSpline|B-Spline]].
* {{incode|n}} to indicate that the constraint affects the n-th pole of a [[File:Sketcher_CompCreateBSpline.png|24px]][[Sketcher CompCreateBSpline|B-Spline]].


Die mit 1 und 2 gekennzeichneten Knoten sind in der Reihenfolge ihrer Erstellung nummeriert. Um die Reihenfolge ihrer Erstellung herauszufinden (wenn du viele Linien hast, kannst du dich nicht erinnern, welchen Knoten du zuerst erstellt hast), musst du nur den Mauszeiger über die beiden Knoten einer Linie bewegen, siehe folgende Abbildung.
The vertices indicated by 1 and 2 are numbered according to their order of creation. To find out the order of their creation (If you have a lot of lines, you cannot remember which vertex you have created first), you just have to move the cursor of your mouse above the two vertices of one line, see following figure.


[[File:PartDesignConstraintPointOnPointScriptingFigure3.jpg|600px]]
[[File:PartDesignConstraintPointOnPointScriptingFigure3.jpg|600px]]

Revision as of 22:51, 20 February 2021

Erstellen einer Beschränkung mit Python

Eine geometrische Beschränkung und die spezielle InterneAusrichtungsbeschränkungen können von Makros und von der Python Konsole aus durch Verwendung des folgenden Befehls erstellt werden:

Sketch.addConstraint(Sketcher.Constraint(ConstraintType, EdgeOrPartOfEdge))

Eine maßliche Beschränkung und die spezielle Beschränkung Snelliusches Gesetz kann von Makros und von der Python Konsole aus durch Verwendung des folgenden Befehls erstellt werden:

Sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge, App.Units.Quantity('float_value unit')))
e.g.
Sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge, App.Units.Quantity('123.0 mm')))

Das erste Argument Beschränkungstyp wird weiter unten in Beschränkungstypen beschrieben.

Eine Beschränkung kann bis zu sechs Argumente annehmen, die Kanten sind oder angeben, welches Abschnittsteil einer Kante von der Beschränkung verwendet wird. In der Dokumentation der einzelnen Beschränkungen findest du Details darüber, welche Kombinationen von Kanten und Unterteilen von Kanten als Argumente übergeben werden können. Das Hauptproblem bei dieser Funktion besteht darin, die Zeilennummer und die Knotennummer der zu bearbeitenden Linien korrekt zu identifizieren. Die folgenden Abschnitte beschreiben, wie man Identifiziere die Nummerierung einer Linie) und wie man Identifiziere die Nummerierung der Unterteile einer Linie).

Beschränkungstypen

Bei geometrischen Beschränkungen ist das erste Argument eines der folgenden. Die möglichen Kombinationen von Argumenten, die für jede Beschränkung zulässig sind, findest du auf der entsprechenden Funktionsseite.

Code Icon Feature
'Coincident' Coincident
'PointOnObject' Point On Object
'Vertical' Vertical
'Horizontal' Horizontal
'Parallel' Parallel
'Perpendicular' Perpendicular
'Tangent' Tangent
'Equal' Equal
'Symmetric' Symmetric
'Block' Block

Die InterneAusrichtungsbeschränkungen verhalten sich für die Zwecke der Skripterstellung wie geometrische Beschränkungen. Auch hier findest du auf der entsprechenden Funktionsseite die möglichen Kombinationen von Argumenten, die für jede Beschränkung zulässig sind.

Code Icon Feature
'InternalAlignment:EllipseMajorDiameter' InternalAlignment
'InternalAlignment:EllipseMinorDiameter' InternalAlignment
'InternalAlignment:EllipseFocus1' InternalAlignment
'InternalAlignment:EllipseFocus2' InternalAlignment

Bei Bemaßungsbeschränkungen ist das erste Argument eines der folgenden. Die möglichen Kombinationen von Argumenten, die für jede Beschränkung zulässig sind, findest du auf der entsprechenden Funktionsseite.

Code Icon Feature
'DistanceX' Horizontal distance
'DistanceY' Vertical distance
'Distance' Distance
'Radius' Radius
'Diameter' Diameter
'Angle' Angle
'AngleViaPoint' Angle

Die Snelliusches Gesetz Beschränkungen verhalten sich für die Zwecke der Skripterstellung wie Bemaßungsbeschränkungen. Auch hier findest du auf der entsprechenden Funktionsseite die möglichen Kombinationen von Argumenten, die für jede Beschränkung zulässig sind.

Code Icon Feature
'SnellsLaw' Snell's law

Die Schloss Beschränkung ist ein GUI Befehl, der eine Horizontaler Abstand und eine Vertikaler Abstandsbeschränkung erzeugt, es ist keine eigene Beschränkung.

Identifizierung der Nummerierung einer Linie

Ich habe drei Linien gezeichnet, wie in der folgenden Abbildung dargestellt.

Durch bewegen des Mauszeigers über die Linie, kannst du die Zeilennummer unten links im FreeCAD Fenster sehen, siehe nächste Abbildung.

Leider beginnt die angezeigte Nummerierung in den FreeCAD Fenstern bei 1, während die Nummerierung der Linie, die für das Skript verwendet wird, bei 0 beginnt: Das bedeutet, dass du jedes Mal, wenn du dich auf eine Zeile beziehen willst, eine Zahl abziehen musst.

Positive Zahlen bezeichnen Skizzenkanten (Geraden, Kreise, Kegel, B-Splines usw.). Die folgenden Werte können verwendet werden, um Elemente zu kennzeichnen, die keine Skizzenkanten sind:

  • -1 bezeichnet die horizontale x Achse
  • -2 bezeichnet die vertikale y Achse
  • -n bezeichnet die externe Geometrieelementnummer n-3 (z. B. würde das externe Geometrieelement mit Index 0 in der reduzierten Liste App.ActiveDocument.Sketch.ExternalGeometry mit -3 bezeichnet, das folgende Element in der reduzierten Liste mit -4 usw.).

Identifizierung der Nummerierung der Abschnittsteile einer Linie

When qualifying which part of a line is affected by a constraint, the following values can be used:

  • 0 to indicate that the constraint affects the entire edge.
  • 1 to indicate that the constraint affects the starting point of the edge (a full circle has no starting point).
  • 2 to indicate that the constraint affects the end point of the edge.
  • 3 to indicate that the constraint affects the center point of the edge. For Circles and Conics (ellipses), this is the center of the circle or center (intersection of major and minor axes) of the ellipse. For straight Lines, 3 cannot be used to indicate the center point.
  • n to indicate that the constraint affects the n-th pole of a B-Spline.

Die mit 1 und 2 gekennzeichneten Knoten sind in der Reihenfolge ihrer Erstellung nummeriert. Um die Reihenfolge ihrer Erstellung herauszufinden (wenn du viele Linien hast, kannst du dich nicht erinnern, welchen Knoten du zuerst erstellt hast), musst du nur den Mauszeiger über die beiden Knoten einer Linie bewegen, siehe folgende Abbildung.

Wenn du z. B. 4 und 5 liest, bedeutet dies, dass der Knoten mit der niedrigeren Nummer (4 in diesem Beispiel) mit der Nummer 1 (zuerst im Skriptbefehl) und der Knoten mit der höheren Nummer (5 in diesem Beispiel) mit der Nummer 2 im Skriptbefehl referenziert wird.

Beispiel

Nehmen wir das vorherige Beispiel der drei Linien. Die nachfolgende Abbildung zeigt die Nummerierung der einzelnen Linien und deren Knoten gemäß der Konvention für die Skripterstellung.

blauer Text: Nummerierung der Linie, svhwarzer Text: Nummerierung der Knoten

Der Befehl Sketch.addConstraint(Sketcher.Constraint('Coincident',1,2,2,1)) ergibt folgendes Ergebnis:

Der Befehl Sketch.addConstraint(Sketcher.Constraint('Coincident',0,2,2,2)) ergibt folgendes Ergebnis: