Sketcher scripting/de: Difference between revisions

From FreeCAD Documentation
(Created page with "* {{incode|-1}} bezeichnet die horizontale x Achse * {{incode|-2}} bezeichnet die vertikale y Achse * {{incode|-n}} bezeichnet die externe Geometrieelementnummer {{incode|n-3}...")
No edit summary
 
(47 intermediate revisions by 5 users not shown)
Line 2: Line 2:
{{TOCright}}
{{TOCright}}


<span id="Creating_a_SketchObject_using_Python"></span>
== Erstellen einer Beschränkung mit Python ==
==Erstellen eines Sketch-Objekts mit Python==


So wird ein Sketch-Objekt erstellt:
Eine geometrische Beschränkung
[[File:Sketcher_ConstrainCoincident.svg|24px]] [[File:Sketcher_ConstrainPointOnObject.svg|24px]] [[File:Sketcher_ConstrainVertical.svg|24px]] [[File:Sketcher_ConstrainHorizontal.svg|24px]] [[File:Sketcher_ConstrainParallel.svg|24px]] [[File:Sketcher_ConstrainPerpendicular.svg|24px]] [[File:Sketcher_ConstrainTangent.svg|24px]] [[File:Sketcher_ConstrainEqual.svg|24px]] [[File:Sketcher_ConstrainSymmetric.svg|24px]] [[File:Sketcher_ConstrainBlock.svg|24px]] und die spezielle
[[File:Sketcher_ConstrainInternalAlignment.svg|24px]] [[Sketcher_ConstrainInternalAlignment/de|InterneAusrichtung]]sbeschränkungen können von Makros und von der Python Konsole aus durch Verwendung des folgenden Befehls erstellt werden:


{{Code|code=
{{Code|code=Sketch.addConstraint(Sketcher.Constraint(ConstraintType, EdgeOrPartOfEdge…)) }}
import FreeCAD as App
import Part
import Sketcher


doc = App.newDocument()
Eine maßliche Beschränkung [[File:Sketcher_ConstrainLock.svg|24px]] [[File:Sketcher_ConstrainDistanceX.svg|24px]] [[File:Sketcher_ConstrainDistanceY.svg|24px]] [[File:Sketcher_ConstrainDistance.svg|24px]] [[File:Sketcher_ConstrainRadius.svg|24px]] [[File:Sketcher_ConstrainDiameter.svg|24px]] [[File:Sketcher_ConstrainAngle.svg|24px]] und die spezielle Beschränkung [[File:Sketcher_ConstrainSnellsLaw.svg|24px]] [[Sketcher_ConstrainSnellsLaw/de|Snelliusches Gesetz]] kann von Makros und von der Python Konsole aus durch Verwendung des folgenden Befehls erstellt werden:


sketch = doc.addObject("Sketcher::SketchObject", "Sketch")
{{Code|code=Sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge…, App.Units.Quantity('float_value unit'))) }}
sketch.addGeometry(Part.LineSegment(App.Vector(1.2, 1.8, 0),
: e.g.
App.Vector(5.2, 5.3, 0)), False)
{{Code|code=Sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge…, App.Units.Quantity('123.0 mm'))) }}
sketch.addGeometry(Part.LineSegment(App.Vector(6.5, 1.5, 0),
App.Vector(10.2, 5.0, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(12.2, 1.0, 0),
App.Vector(15.4, 5.0, 0)), False)


doc.recompute()
Das erste Argument {{incode|Beschränkungstyp}} wird weiter unten in [[#Beschränkungstypen|Beschränkungstypen]] beschrieben.
}}


Es werden der neu erstellten Skizze auch noch drei [[Topological_data_scripting/de#Linie|Linien]] hinzugefügt.
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 [[#Identifizierung der Nummerierung einer Linie|Identifiziere die Nummerierung einer Linie]]) und wie man [[#Identifizierung der Nummerierung der Abschnittsteile einer Linie|Identifiziere die Nummerierung der Unterteile einer Linie]]).


<span id="Creating_a_constraint_using_Python"></span>
== Beschränkungstypen ==
==Erstellen einer Randbedingung mit Python==


Die geometrischen Randbedingungen
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.
[[File:Sketcher_ConstrainCoincident.svg|24px]] [[File:Sketcher_ConstrainPointOnObject.svg|24px]] [[File:Sketcher_ConstrainVertical.svg|24px]] [[File:Sketcher_ConstrainHorizontal.svg|24px]] [[File:Sketcher_ConstrainParallel.svg|24px]] [[File:Sketcher_ConstrainPerpendicular.svg|24px]] [[File:Sketcher_ConstrainTangent.svg|24px]] [[File:Sketcher_ConstrainEqual.svg|24px]] [[File:Sketcher_ConstrainSymmetric.svg|24px]] und [[File:Sketcher_ConstrainBlock.svg|24px]] können mit Makros und von der Python-Konsole aus durch Verwendung des folgenden Befehls erstellt werden:

{{Code|code=sketch.addConstraint(Sketcher.Constraint(ConstraintType, EdgeOrPartOfEdge…)) }}

Die maßlichen Randbedingungen [[File:Sketcher_ConstrainLock.svg|24px]] [[File:Sketcher_ConstrainDistanceX.svg|24px]] [[File:Sketcher_ConstrainDistanceY.svg|24px]] [[File:Sketcher_ConstrainDistance.svg|24px]] [[File:Sketcher_ConstrainRadius.svg|24px]] [[File:Sketcher_ConstrainDiameter.svg|24px]] [[File:Sketcher_ConstrainAngle.svg|24px]] und die spezielle Randbedingung [[File:Sketcher_ConstrainSnellsLaw.svg|24px]] [[Sketcher_ConstrainSnellsLaw/de|Lichtbrechung (nach Snellius-Gesetz) festlegen]] können mit Makros und von der Python-Konsole aus durch Verwendung des folgenden Befehls erstellt werden:

{{Code|code=sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge…, App.Units.Quantity("float_value unit"))) }}

z. B.

{{Code|code=sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge…, App.Units.Quantity("123.0 mm"))) }}

Das erste Argument {{incode|ConstraintType}} wird weiter unten unter [[#Arten_von_Randbedingungen|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 [[#Identifizierung der Nummerierung einer Linie|Nummerierung einer Linie]] und die [[#Identifizierung der Nummerierung der Abschnittsteile einer Linie|Nummerierung der Bestandteile einer Linie]] herausfindet.

<span id="Constraint_types"></span>
==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.


{| class="wikitable"
{| class="wikitable"
|-
|-
! Code !! Icon !! Feature
! Schlüsselwort !! Symbol !! Funktion
|-
|-
| {{incode|'Coincident'}} || [[File:Sketcher_ConstrainCoincident.svg|24px]] || [[Sketcher_ConstrainCoincident|Coincident]]
| {{incode|"Coincident"}} || [[File:Sketcher_ConstrainCoincident.svg|24px]] || [[Sketcher_ConstrainCoincident/de|Koinzidenz festlegen]]
|-
|-
| {{incode|'PointOnObject'}} || [[File:Sketcher_ConstrainPointOnObject.svg|24px]] || [[Sketcher_ConstrainPointOnObject|Point On Object]]
| {{incode|"PointOnObject"}} || [[File:Sketcher_ConstrainPointOnObject.svg|24px]] || [[Sketcher_ConstrainPointOnObject/de|Punkt auf Objekt festlegen]]
|-
|-
| {{incode|'Vertical'}} || [[File:Sketcher_ConstrainVertical.svg|24px]] || [[Sketcher_ConstrainVertical|Vertical]]
| {{incode|"Vertical"}} || [[File:Sketcher_ConstrainVertical.svg|24px]] || [[Sketcher_ConstrainVertical/de|Vertikal festlegen]]
|-
|-
| {{incode|'Horizontal'}} || [[File:Sketcher_ConstrainHorizontal.svg|24px]] || [[Sketcher_ConstrainHorizontal|Horizontal]]
| {{incode|"Horizontal"}} || [[File:Sketcher_ConstrainHorizontal.svg|24px]] || [[Sketcher_ConstrainHorizontal/de|Horizontal festlegen]]
|-
|-
| {{incode|'Parallel'}} || [[File:Sketcher_ConstrainParallel.svg|24px]] || [[Sketcher_ConstrainParallel|Parallel]]
| {{incode|"Parallel"}} || [[File:Sketcher_ConstrainParallel.svg|24px]] || [[Sketcher_ConstrainParallel/de|Parallel festlegen]]
|-
|-
| {{incode|'Perpendicular'}} || [[File:Sketcher_ConstrainPerpendicular.svg|24px]] || [[Sketcher_ConstrainPerpendicular|Perpendicular]]
| {{incode|"Perpendicular"}} || [[File:Sketcher_ConstrainPerpendicular.svg|24px]] || [[Sketcher_ConstrainPerpendicular/de|Rechtwinklig festlegen]]
|-
|-
| {{incode|'Tangent'}} || [[File:Sketcher_ConstrainTangent.svg|24px]] || [[Sketcher_ConstrainTangent|Tangent]]
| {{incode|"Tangent"}} || [[File:Sketcher_ConstrainTangent.svg|24px]] || [[Sketcher_ConstrainTangent/de|Tangential festlegen]]
|-
|-
| {{incode|'Equal'}} || [[File:Sketcher_ConstrainEqual.svg|24px]] || [[Sketcher_ConstrainEqual|Equal]]
| {{incode|"Equal"}} || [[File:Sketcher_ConstrainEqual.svg|24px]] || [[Sketcher_ConstrainEqual/de|Gleichheit festlegen]]
|-
|-
| {{incode|'Symmetric'}} || [[File:Sketcher_ConstrainSymmetric.svg|24px]] || [[Sketcher_ConstrainSymmetric|Symmetric]]
| {{incode|"Symmetric"}} || [[File:Sketcher_ConstrainSymmetric.svg|24px]] || [[Sketcher_ConstrainSymmetric/de|Symmetrie festlegen]]
|-
|-
| {{incode|'Block'}} || [[Image:Sketcher_ConstrainBlock.svg|24px]] || [[Sketcher_ConstrainBlock|Block]]
| {{incode|"Block"}} || [[Image:Sketcher_ConstrainBlock.svg|24px]] || [[Sketcher_ConstrainBlock/de|Fixieren]]
|}
|}


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 [[Image:Sketcher_ConstrainInternalAlignment.svg|24px]] [[Sketcher_ConstrainInternalAlignment/de|InterneAusrichtung]]sbeschrä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.


{| class="wikitable"
{| class="wikitable"
|-
|-
! Code !! Icon !! Feature
! Schlüsselwort !! Symbol !! Funktion
|-
|-
| {{incode|'InternalAlignment:EllipseMajorDiameter'}} || [[Image:Sketcher_ConstrainInternalAlignment.svg|24px]] || [[Sketcher_ConstrainInternalAlignment|InternalAlignment]]
| {{incode|"DistanceX"}} || [[File:Sketcher_ConstrainDistanceX.svg|24px]] || [[Sketcher_ConstrainDistanceX/de|Horizontalen Abstand festlegen]]
|-
|-
| {{incode|'InternalAlignment:EllipseMinorDiameter'}} || [[Image:Sketcher_ConstrainInternalAlignment.svg|24px]] || [[Sketcher_ConstrainInternalAlignment|InternalAlignment]]
| {{incode|"DistanceY"}} || [[File:Sketcher_ConstrainDistanceY.svg|24px]] || [[Sketcher_ConstrainDistanceY/de|Vertikalen Abstand festlegen]]
|-
|-
| {{incode|'InternalAlignment:EllipseFocus1'}} || [[Image:Sketcher_ConstrainInternalAlignment.svg|24px]] || [[Sketcher_ConstrainInternalAlignment|InternalAlignment]]
| {{incode|"Distance"}} || [[File:Sketcher_ConstrainDistance.svg|24px]] || [[Sketcher_ConstrainDistance/de|Abstand festlegen]]
|-
|-
| {{incode|'InternalAlignment:EllipseFocus2'}} || [[Image:Sketcher_ConstrainInternalAlignment.svg|24px]] || [[Sketcher_ConstrainInternalAlignment|InternalAlignment]]
| {{incode|"Radius"}} || [[File:Sketcher_ConstrainRadius.svg|24px]] || [[Sketcher_ConstrainRadius/de|Radius oder Gewicht festlegen]]
|}

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.

{| class="wikitable"
|-
|-
| {{incode|"Diameter"}} || [[File:Sketcher_ConstrainDiameter.svg|24px]] || [[Sketcher_ConstrainDiameter/de|Durchmesser festlegen]]
! Code !! Icon !! Feature
|-
|-
| {{incode|'DistanceX'}} || [[File:Sketcher_ConstrainDistanceX.svg|24px]] || [[Sketcher_ConstrainDistanceX|Horizontal distance]]
| {{incode|"Angle"}} || [[File:Sketcher_ConstrainAngle.svg|24px]] || [[Sketcher_ConstrainAngle/de|Winkel festlegen]]
|-
|-
| {{incode|'DistanceY'}} || [[File:Sketcher_ConstrainDistanceY.svg|24px]] || [[Sketcher_ConstrainDistanceY|Vertical distance]]
| {{incode|"AngleViaPoint"}} || [[File:Sketcher_ConstrainAngle.svg|24px]] || [[Sketcher_ConstrainAngle/de|Winkel festlegen]]
|-
| {{incode|'Distance'}} || [[File:Sketcher_ConstrainDistance.svg|24px]] || [[Sketcher_ConstrainDistance|Distance]]
|-
| {{incode|'Radius'}} || [[File:Sketcher_ConstrainRadius.svg|24px]] || [[Sketcher_ConstrainRadius|Radius]]
|-
| {{incode|'Diameter'}} || [[File:Sketcher_ConstrainDiameter.svg|24px]] || [[Sketcher_ConstrainDiameter|Diameter]]
|-
| {{incode|'Angle'}} || [[File:Sketcher_ConstrainAngle.svg|24px]] || [[Sketcher_ConstrainAngle|Angle]]
|-
| {{incode|'AngleViaPoint'}} || [[File:Sketcher_ConstrainAngle.svg|24px]] || [[Sketcher_ConstrainAngle|Angle]]
|}
|}


Die [[File:Sketcher_ConstrainSnellsLaw.svg|24px]] [[Sketcher_ConstrainSnellsLaw/de|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.
Die Randbedingung [[File:Sketcher_ConstrainSnellsLaw.svg|24px]] [[Sketcher_ConstrainSnellsLaw/de|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.


{| class="wikitable"
{| class="wikitable"
|-
|-
! Code !! Icon !! Feature
! Schlüsselwort !! Symbol !! Funktion
|-
|-
| {{incode|'SnellsLaw'}} || [[File:Sketcher_ConstrainSnellsLaw.svg|24px]] || [[Sketcher_ConstrainSnellsLaw|Snell's law]]
| {{incode|"SnellsLaw"}} || [[File:Sketcher_ConstrainSnellsLaw.svg|24px]] || [[Sketcher_ConstrainSnellsLaw/de|Lichtbrechung (nach Snellius-Gesetz) festlegen]]
|}
|}


Die [[File:Sketcher_ConstrainLock.svg|24px]] [[Sketcher_ConstrainLock/de|Schloss]] Beschränkung ist ein GUI Befehl, der eine [[File:Sketcher_ConstrainDistanceX.svg|24px]] [[Sketcher_ConstrainDistanceX/de|Horizontaler Abstand]] und eine [[File:Sketcher_ConstrainDistanceY.svg|24px]] [[Sketcher_ConstrainDistanceY/de|Vertikaler Abstand]]sbeschränkung erzeugt, es ist keine eigene Beschränkung.
Die Randbedingung [[File:Sketcher_ConstrainLock.svg|24px]] [[Sketcher_ConstrainLock/de|Sperren]] ist ein GUI-Befehl, der die Randbedingungen [[File:Sketcher_ConstrainDistanceX.svg|24px]] [[Sketcher_ConstrainDistanceX/de|Horizontalen Abstand festlegen]] und [[File:Sketcher_ConstrainDistanceY.svg|24px]] [[Sketcher_ConstrainDistanceY/de|Vertikalen Abstand festlegen]] erstellt; sie ist keine eigenständige Randbedingung.


<span id="Identifying_the_numbering_of_a_line"></span>
==Identifizierung der Nummerierung einer Linie==
==Identifizierung der Nummerierung einer Linie==


Line 104: Line 118:
[[File:PartDesignConstraintPointOnPointScriptingFigure1.jpg|600px]]
[[File:PartDesignConstraintPointOnPointScriptingFigure1.jpg|600px]]


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


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


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.
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, Kegel, B-Splines usw.). Die folgenden Werte können verwendet werden, um Elemente zu kennzeichnen, die keine Skizzenkanten sind:
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:


* {{incode|-1}} bezeichnet die horizontale x Achse
* {{incode|-1}} bezeichnet die horizontale X-Achse
* {{incode|-2}} bezeichnet die vertikale y Achse
* {{incode|-2}} bezeichnet die vertikale Y-Achse
* {{incode|-n}} bezeichnet die externe Geometrieelementnummer {{incode|n-3}} (z. B. würde das externe Geometrieelement mit Index 0 in der reduzierten Liste {{incode|App.ActiveDocument.Sketch.ExternalGeometry}} mit -3 bezeichnet, das folgende Element in der reduzierten Liste mit -4 usw.).
* {{incode|-n}} bezeichnet die Nummer des externen Geometrieelements {{incode|n-3}} (z. B. würde das externe Geometrieelement mit Index 0 in der reduzierten Liste {{incode|Sketch.ExternalGeometry}} mit -3 bezeichnet, das folgende Element in der reduzierten Liste mit -4 usw.).


<span id="Identifying_the_numbering_of_the_sub-parts_of_a_line"></span>
==Identifizierung der Nummerierung der Abschnittsteile einer Linie==
==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:
When qualifying which part of a line is affected by a constraint, the following values can be used:
* {{incode|0}} to indicate that the constraint affects the entire edge.
* {{incode|0}}, um anzugeben, dass die Randbedingung die gesamte Kante betrifft.
* {{incode|1}} to indicate that the constraint affects the starting point of the edge (a full circle has no starting point).
* {{incode|1}}, um anzugeben, dass die Randbedingung den Anfangspunkt der Kante betrifft (ein Vollkreis hat keinen Anfangspunkt).
* {{incode|2}} to indicate that the constraint affects the end point of the edge.
* {{incode|2}}, um anzugeben, dass die Randbedingung den Endpunkt der Kante betrifft.
* {{incode|3}} to indicate that the constraint affects the center point of the edge. For [[File:Sketcher_CompCreateCircle.png|24px]][[Sketcher CompCreateCircle|Circles]] and [[File:Sketcher_CompCreateConic.png|24px]][[Sketcher CompCreateConic|Conics]] (ellipses), this is the center of the circle or center (intersection of major and minor axes) of the ellipse. For straight [[File:Sketcher_CreateLine.svg|24px]][[Sketcher CreateLine|Lines]], {{incode|3}} cannot be used to indicate the center point.
* {{incode|3}}, um anzugeben, dass die Randbedingung den Mittelpunkt der Kante betrifft. Für [[File:Sketcher_CompCreateCircle.png|x24px]] [[Sketcher_CompCreateCircle/de|Kreise]] und [[File:Sketcher_CompCreateConic.png|x24px]] [[Sketcher_CompCreateConic/de|Kegelschnitte]] (Ellipsen) ist dies der Mittelpunkt des Kreises bzw. das Zentrum (Schnittpunkt von Haupt- und Nebenachse) der Ellipse. Bei geraden [[File:Sketcher_CreateLine.svg|x24px]] [[Sketcher_CreateLine/de|Linien]] kann {{incode|3}} nicht zur Angabe des Mittelpunktes verwendet werden.
* {{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}}, um anzugeben, dass die Randbedingung den n-ten Kontrollpunkt eines [[File:Sketcher_CompCreateBSpline.png|x24px]] [[Sketcher_CompCreateBSpline/de|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.
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]]


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.
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.


<span id="Example"></span>
==Beispiel==
==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.
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.


[[Image:PartDesignConstraintPointOnPointScriptingFigure3Bis.jpg|600px]]
[[Image:PartDesignConstraintPointOnPointScriptingFigure3Bis.jpg|600px]]
{{Caption|<b>blauer Text:</b> Nummerierung der Linie, <b>svhwarzer Text:</b> Nummerierung der Knoten}}


{{Caption|<b>blauer Text:</b> Nummerierung der Linie, <b>schwarzer Text:</b> Nummerierung der Knoten}}
Der Befehl {{incode|Sketch.addConstraint(Sketcher.Constraint('Coincident',1,2,2,1))}} ergibt folgendes Ergebnis:

Der Befehl {{incode|sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1))}} ergibt folgendes Ergebnis:


[[Image:PartDesignConstraintPointOnPointScriptingFigure4.jpg|600px]]
[[Image:PartDesignConstraintPointOnPointScriptingFigure4.jpg|600px]]


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:
Der Befehl {{incode|Sketch.addConstraint(Sketcher.Constraint('Coincident',0,2,2,2))}} ergibt folgendes Ergebnis:

{{Code|code=
import FreeCAD as App
import Part
import Sketcher

doc = App.newDocument()

sketch = doc.addObject("Sketcher::SketchObject", "Sketch")
sketch.addGeometry(Part.LineSegment(App.Vector(1.2, 1.8, 0),
App.Vector(5.2, 5.3, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(6.5, 1.5, 0),
App.Vector(10.2, 5.0, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(12.2, 1.0, 0),
App.Vector(15.4, 5.0, 0)), False)
sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1))


doc.recompute()
[[Image:PartDesignConstraintPointOnPointScriptingFigure5.jpg|600px]]
}}





Latest revision as of 13:58, 13 October 2023

Erstellen eines Sketch-Objekts mit Python

So wird ein Sketch-Objekt erstellt:

import FreeCAD as App
import Part
import Sketcher

doc = App.newDocument()  

sketch = doc.addObject("Sketcher::SketchObject", "Sketch")
sketch.addGeometry(Part.LineSegment(App.Vector(1.2, 1.8, 0),
                                    App.Vector(5.2, 5.3, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(6.5, 1.5, 0),
                                    App.Vector(10.2, 5.0, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(12.2, 1.0, 0),
                                    App.Vector(15.4, 5.0, 0)), False)

doc.recompute()

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:

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

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:

sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge, App.Units.Quantity("float_value unit")))

z. B.

sketch.addConstraint(Sketcher.Constraint(DimensionalConstraintType, EdgeOrPartOfEdge, App.Units.Quantity("123.0 mm")))

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

Schlüsselwort Symbol Funktion
"Coincident" Koinzidenz festlegen
"PointOnObject" Punkt auf Objekt festlegen
"Vertical" Vertikal festlegen
"Horizontal" Horizontal festlegen
"Parallel" Parallel festlegen
"Perpendicular" Rechtwinklig festlegen
"Tangent" Tangential festlegen
"Equal" Gleichheit festlegen
"Symmetric" Symmetrie festlegen
"Block" Fixieren

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.

Schlüsselwort Symbol Funktion
"DistanceX" Horizontalen Abstand festlegen
"DistanceY" Vertikalen Abstand festlegen
"Distance" Abstand festlegen
"Radius" Radius oder Gewicht festlegen
"Diameter" Durchmesser festlegen
"Angle" Winkel festlegen
"AngleViaPoint" Winkel festlegen

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.

Schlüsselwort Symbol Funktion
"SnellsLaw" Lichtbrechung (nach Snellius-Gesetz) festlegen

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:

  • -1 bezeichnet die horizontale X-Achse
  • -2 bezeichnet die vertikale Y-Achse
  • -n bezeichnet die Nummer des externen Geometrieelements n-3 (z. B. würde das externe Geometrieelement mit Index 0 in der reduzierten Liste Sketch.ExternalGeometry 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:

  • 0, um anzugeben, dass die Randbedingung die gesamte Kante betrifft.
  • 1, um anzugeben, dass die Randbedingung den Anfangspunkt der Kante betrifft (ein Vollkreis hat keinen Anfangspunkt).
  • 2, um anzugeben, dass die Randbedingung den Endpunkt der Kante betrifft.
  • 3, um anzugeben, dass die Randbedingung den Mittelpunkt der Kante betrifft. Für Kreise und Kegelschnitte (Ellipsen) ist dies der Mittelpunkt des Kreises bzw. das Zentrum (Schnittpunkt von Haupt- und Nebenachse) der Ellipse. Bei geraden Linien kann 3 nicht zur Angabe des Mittelpunktes verwendet werden.
  • n, um anzugeben, dass die Randbedingung den n-ten Kontrollpunkt eines 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.

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

Der Befehl sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1)) 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:

import FreeCAD as App
import Part
import Sketcher

doc = App.newDocument()  

sketch = doc.addObject("Sketcher::SketchObject", "Sketch")
sketch.addGeometry(Part.LineSegment(App.Vector(1.2, 1.8, 0),
                                    App.Vector(5.2, 5.3, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(6.5, 1.5, 0),
                                    App.Vector(10.2, 5.0, 0)), False)
sketch.addGeometry(Part.LineSegment(App.Vector(12.2, 1.0, 0),
                                    App.Vector(15.4, 5.0, 0)), False)
sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1))

doc.recompute()