Sketcher scripting/de

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:

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:


 * e.g.

Das erste Argument 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.

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.

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.

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.

The Lock constraint is a GUI command which creates a  Horizontal distance and a  Vertical distance constraint, it is not a constraint of its own.

Identifizierung der Nummerierung einer Linie
I have drawn three lines as shown in the following figure.



By moving the cursor of the mouse above the line you can see the line number at the bottom left of the FreeCAD windows, see next figure.



Unfortunately the numbering displayed on the FreeCAD windows start from 1 whereas the numbering of the line used to script start from 0: this means that you have to subtract one each time you want to refer to a line.

Positive numbers indicate sketch edges (straight lines, circles, conics, B-splines, and so on). The following values can be used to denote elements that are not sketch edges:


 * denotes the horizontal x axis
 * denotes the vertical y axis
 * denotes the external geometry element number (e.g. the external geometry element with index 0 in the flattened list  would be denoted by -3, the following element in the flattened list would be -4 and so on).

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:
 * to indicate that the constraint affects the entire edge.
 * to indicate that the constraint affects the starting point of the edge (a full circle has no starting point).
 * to indicate that the constraint affects the end point of the edge.
 * to indicate that the constraint affects the center point of the edge. For Sketcher_CompCreateCircle.pnges and Sketcher_CompCreateConic.pngs (ellipses), this is the center of the circle or center (intersection of major and minor axes) of the ellipse. For straight Sketcher_CreateLine.svg, cannot be used to indicate the center point.
 * to indicate that the constraint affects the n-th pole of a Sketcher_CompCreateBSpline.png-Spline.

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.



If you read e.g. 4 and 5, it means that the vertex with the lower number (4 in this example) will be referenced by using the number 1 (first in the script command and the vertex with the higher number (5 in this example) will be referenced by using the number 2 in the script command.

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.



Der Befehl ergibt folgendes Ergebnis:



Der Befehl  ergibt folgendes Ergebnis: