Sketcher scripting/de



Erstellen eines Sketch-Objekts mit Python
So wird ein Sketch-Objekt erstellt:

Es werden der neu erstellten Skizze auch noch drei Linien hinzugefügt.



Erstellen einer Randbedingung mit Python
Die geometrischen Randbedingungen und können mit Makros und von der Python-Konsole aus durch Verwendung des folgenden Befehls erstellt werden:

Die maßlichen Randbedingungen        und die spezielle Randbedingung  Lichtbrechung (nach Snellius-Gesetz) festlegen können mit Makros und von der Python-Konsole aus durch Verwendung des folgenden Befehls erstellt werden:

z. B.

Das erste Argument wird weiter unten unter  Arten von Randbedingungen beschrieben.

Eine Randbedingung kann bis zu sechs Argumente besitzen; das können Kanten sein oder Angaben, welcher Bestandteil einer Kante von der Randbedingung verwendet wird. In den Dokumentationen der einzelnen Randbedingungen findet man Details zu den Kombinationen von Kanten und Bestandteilen von Kanten, die als Argumente übergeben werden können. Das Hauptproblem bei dieser Funktion besteht darin, die Liniennummer und die Knotennummer der zu bearbeitenden Linien korrekt zu identifizieren. Die folgenden Abschnitte beschreiben, wie man die Nummerierung einer Linie und die Nummerierung der Bestandteile einer Linie herausfindet.



Arten von Randbedingungen
Bei geometrischen Randbedingungen ist das erste Argument eines der folgenden. Die möglichen Kombinationen von Argumenten, die für jede Beschränkung zulässig sind, findet man auf der Referenzseite der zugehörigen Funktion.

Bei maßlichen Randbedingungen ist das erste Argument eines der folgenden. Die möglichen Kombinationen von Argumenten, die für jede Randbedingung zulässig sind, findet man auf der Referenzseite der zugehörigen Funktion.

Die Randbedingung Lichtbrechung (nach Snellius-Gesetz) festlegen verhält sich im Zusammenhang mit der Skripterstellung wie eine maßliche Randbedingung. Auch hier findet man auf der zugehörigen Referenzseite die möglichen Kombinationen von Argumenten, die für diese Randbedingung zulässig sind.

Die Randbedingung Sperren ist ein GUI-Befehl, der die Randbedingungen  Horizontalen Abstand festlegen und  Vertikalen Abstand festlegen erstellt; sie ist keine eigenständige Randbedingung.



Identifizierung der Nummerierung einer Linie
Ich habe drei Linien gezeichnet, wie in der folgenden Abbildung dargestellt.



Durch bewegen des Mauszeigers über die Linie, lässt sich die Liniennummer unten links im FreeCAD Fenster anzeigen, siehe nächste Abbildung.



Leider beginnt die im FreeCAD-Fenster angezeigte Nummerierung bei 1, während die Nummerierung der Linien, die für das Skript verwendet wird, bei 0 beginnt: Das bedeutet, dass jedes Mal eins abgezogen werden muss, wenn man auf eine Linie verweisen möchte.

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


 * bezeichnet die horizontale X-Achse
 * bezeichnet die vertikale Y-Achse
 * bezeichnet die Nummer des externen Geometrieelements (z. B. würde das externe Geometrieelement mit Index 0 in der reduzierten Liste  mit -3 bezeichnet, das folgende Element in der reduzierten Liste mit -4 usw.).



Identifizierung der Nummerierung der Bestandteile einer Linie
Um festzulegen, welcher Bestandteile einer Linie von einer Randbedingung betroffen ist, können die folgenden Werte verwendet werden:
 * , um anzugeben, dass die Randbedingung die gesamte Kante betrifft.
 * , um anzugeben, dass die Randbedingung den Anfangspunkt der Kante betrifft (ein Vollkreis hat keinen Anfangspunkt).
 * , um anzugeben, dass die Randbedingung den Endpunkt der Kante betrifft.
 * , um anzugeben, dass die Randbedingung den Mittelpunkt der Kante betrifft. Für Sketcher_CompCreateCircle.png Kreise und Sketcher_CompCreateConic.png Kegelschnitte (Ellipsen) ist dies der Mittelpunkt des Kreises bzw. das Zentrum (Schnittpunkt von Haupt- und Nebenachse) der Ellipse. Bei geraden Sketcher_CreateLine.svg Linien kann nicht zur Angabe des Mittelpunktes verwendet werden.
 * , um anzugeben, dass die Randbedingung den n-ten Kontrollpunkt eines Sketcher_CompCreateBSpline.png B-Splines betrifft.

Die mit 1 und 2 gekennzeichneten Knoten sind in der Reihenfolge ihrer Erstellung nummeriert. Um die Reihenfolge ihrer Erstellung herauszufinden (sind viele Linien vorhanden, kann es schwierig werden sich zu erinnern, welcher Knoten zuerst erstellt wurde), musst nur der Mauszeiger über die beiden Knoten einer Linie bewegt werden, siehe folgende Abbildung.



Liest man z. B. 4 und 5, 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 ihrer Knoten gemäß der Konvention für die Skripterstellung.



Der Befehl ergibt folgendes Ergebnis:



Der gesamte Kode zum Zeichnen der drei Linien und der Anwendung der Randbedingung "Coincident" auf zwei Punkte von zwei Linien sieht ungefähr so aus: