Sketcher scripting/pl: Difference between revisions

From FreeCAD Documentation
(Created page with "Pełny kod do narysowania trzech linii i dodania wiązania zbieżności dla dwóch punktów z dwóch linii wygląda następująco:")
No edit summary
 
(10 intermediate revisions by 2 users not shown)
Line 25: Line 25:
}}
}}


Dodaje również trzy linie w nowo utworzonym Szkicu.
Dodaje również trzy [[Topological_data_scripting/pl#Linia|linie]] w nowo utworzonym Szkicu.


<span id="Creating_a_constraint_using_Python"></span>
<span id="Creating_a_constraint_using_Python"></span>
Line 132: Line 132:
==Rozpoznawanie numeracji części składowych linii==
==Rozpoznawanie numeracji części składowych linii==


Podczas określania, na którą część linii ma wpływ wiązanie, można użyć następujących wartości:
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}}, aby wskazać, że wiązanie wpływa na całą krawędź.
* {{incode|1}} to indicate that the constraint affects the starting point of the edge (a full circle has no starting point).
* {{incode|1}}, aby wskazać, że wiązanie wpływa na punkt początkowy krawędzi ''(pełny okrąg nie ma punktu początkowego)''.
* {{incode|2}} to indicate that the constraint affects the end point of the edge.
* {{incode|2}}, aby wskazać, że wiązanie wpływa na punkt końcowy krawędzi.
* {{incode|3}} to indicate that the constraint affects the center point of the edge. For [[File:Sketcher_CompCreateCircle.png|x24px]][[Sketcher_CompCreateCircle|Circles]] and [[File:Sketcher_CompCreateConic.png|x24px]][[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}}, aby wskazać, że wiązanie wpływa na punkt środkowy krawędzi. Dla [[File:Sketcher_CompCreateCircle.png|x24px]][[Sketcher_CompCreateCircle/pl|Okręgu]] i [[File:Sketcher_CompCreateConic.png|x24px]][[Sketcher_CompCreateConic/pl|Stożka]] ''(elipsy)'', jest to środek okręgu lub środek ''(przecięcie osi głównej i pomocniczej)'' elipsy. Dla prostych [[File:Sketcher_CreateLine.svg|24px]] [[Sketcher_CreateLine/pl|Linii]], {{incode|3}} nie może być użyty do wskazania punktu środkowego.
* {{incode|n}} to indicate that the constraint affects the n-th pole of a [[File:Sketcher_CompCreateBSpline.png|x24px]][[Sketcher_CompCreateBSpline|B-Spline]].
* {{incode|n}} do wskazania, że wiązanie wpływa na n-ty biegun [[File:Sketcher_CompCreateBSpline.png|x24px]] [[Sketcher_CompCreateBSpline/pl|krzywej złożonej]].


Wierzchołki oznaczone numerami 1 i 2 są ponumerowane zgodnie z kolejnością ich utworzenia. Aby sprawdzić kolejność ich utworzenia ''(jeśli masz wiele linii, nie pamiętasz, który wierzchołek utworzyłeś jako pierwszy)'', wystarczy przesunąć kursor myszki nad dwa wierzchołki jednej linii, patrz poniższy rysunek.
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]]


4 i 5, oznacza to, że do wierzchołka o niższym numerze ''(4 w tym przykładzie)'' odwołamy się za pomocą numeru 1 ''(pierwszego w poleceniu skryptu)'', a do wierzchołka o wyższym numerze ''(5 w tym przykładzie)'' odwołamy się za pomocą numeru 2 w poleceniu skryptu.
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>
<span id="Example"></span>
==Przykład==
==Przykład==


Weźmy przykład z poprzednich trzech linijek. Kolejna cyfra wskazuje numerację każdej linii i ich wierzchołków zgodnie z konwencją dotyczącą skryptów.
Let us take the previous example of the three lines. The subsequent figure indicates the numbering of each line and their vertices according to the convention for scripting.


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


{{Caption|<b>blue text:</b> numbering of line, <b>black text:</b> numbering of vertices}}
{{Caption|<b>niebieski tekst:</b> numeracja linii, <b>czarny tekst:</b> numeracja wierzchołków}}


The command {{incode|sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1))}} yields following result:
Polecenie {{incode|sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1))}} daje następujący wynik:


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

Latest revision as of 07:05, 15 October 2023

Tworzenie obiektu Szkicu przy użyciu środowiska Python

Tworzymy obiekt Szkic w następujący sposób:

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()

Dodaje również trzy linie w nowo utworzonym Szkicu.

Tworzenie wiązań przy użyciu środowiska Python

Wiązania geometryczne oraz można tworzyć z poziomu makropoleceń oraz z poziomu konsoli Python za pomocą następującego polecenia:

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

Wiązania wymiarowe oraz specjalne wiązanie prawo Snell'a można tworzyć z poziomu makropoleceń oraz konsoli Python za pomocą poniższego polecenia:

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

na przykład

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

Pierwszy argument ConstraintType jest opisany poniżej w akapicie Rodzaje wiązań.

Wiązanie może przyjąć do sześciu argumentów, które są krawędziami lub wskazują, która część krawędzi jest używana przez wiązanie. Szczegóły dotyczące tego, jakie kombinacje krawędzi i ich części mogą być przekazane jako argumenty, znajdują się w dokumentacji poszczególnych wiązań. Głównym problemem w przypadku tej funkcji jest poprawne określenie numeru linii i numeru wierzchołka linii, które chcemy przetworzyć. Poniższe akapity opisują jak identyfikować numerację linii oraz jak identyfikować numerację części podrzędnych linii.

Rodzaje wiązań

W przypadku wiązań geometrycznych pierwszym argumentem jest jeden z poniższych. Aby uzyskać informacje na temat możliwych kombinacji argumentów dozwolonych dla każdego wiązania, zobacz odpowiednią stronę funkcji.

Kod Ikonka Funkcja
"Coincident" Zbieżność
"PointOnObject" Punkt na obiekcie
"Vertical" Pionowo
"Horizontal" Poziomo
"Parallel" Równolegle
"Perpendicular" Prostopadle
"Tangent" Stycznie
"Equal" Zrównane
"Symmetric" Symetrycznie
"Block" Zablokowanie

W przypadku wiązań wymiarowych pierwszym argumentem jest jeden z poniższych. Zobacz odpowiednią stronę funkcji dla możliwych kombinacji argumentów dozwolonych dla każdego wiązania

Kod Ikonka Funkcja
"DistanceX" Długość w poziomie
"DistanceY" Długość w pionie
"Distance" Odległości
"Radius" Promień
"Diameter" Średnica
"Angle" Kąt
"AngleViaPoint" Kąt

Wiązanie prawo Snell'a w kontekście skryptów zachowuje się jak wiązanie wymiarowe. Ponownie, zobacz odpowiednią stronę funkcji dla możliwych kombinacji argumentów dozwolonych dla każdego wiązania.

Kod Ikonka Funkcja
"SnellsLaw" prawo Snell'a

Wiązanie Lock to polecenie GUI, które tworzy więz . Odległości poziomej i , czyli nie jest wiązaniem samym w sobie.

Rozpoznawanie numeracji linii

Narysowałem trzy linie, jak pokazano na poniższym rysunku.

Przesuwając kursor myszy nad linią jej numer można zobaczyć w lewym dolnym rogu okna programu FreeCAD, patrz następny rysunek.

Niestety numeracja wyświetlana w oknach programu FreeCAD zaczyna się od 1, podczas gdy numeracja linii użytej w skrypcie zaczyna się od 0: oznacza to, że musisz odjąć jeden za każdym razem, gdy chcesz odwołać się do linii.

Liczby dodatnie oznaczają krawędzie szkicu (linie proste, okręgi, stożki, krzywe itd.). Następujące wartości mogą być używane do oznaczania elementów, które nie są krawędziami szkicu:

  • -1 oznacza poziomą oś x
  • -2 oznacza pionową oś y
  • -n oznacza numer elementu geometrii zewnętrznej n-3 (np. element geometrii zewnętrznej o indeksie 0 na spłaszczonej liście n-3) (np. element geometrii zewnętrznej o indeksie 0 na spłaszczonej liście sketch.ExternalGeometry byłby oznaczony przez -3, kolejny element na spłaszczonej liście byłby oznaczony -4 i tak dalej).

Rozpoznawanie numeracji części składowych linii

Podczas określania, na którą część linii ma wpływ wiązanie, można użyć następujących wartości:

  • 0, aby wskazać, że wiązanie wpływa na całą krawędź.
  • 1, aby wskazać, że wiązanie wpływa na punkt początkowy krawędzi (pełny okrąg nie ma punktu początkowego).
  • 2, aby wskazać, że wiązanie wpływa na punkt końcowy krawędzi.
  • 3, aby wskazać, że wiązanie wpływa na punkt środkowy krawędzi. Dla Okręgu i Stożka (elipsy), jest to środek okręgu lub środek (przecięcie osi głównej i pomocniczej) elipsy. Dla prostych Linii, 3 nie może być użyty do wskazania punktu środkowego.
  • n do wskazania, że wiązanie wpływa na n-ty biegun krzywej złożonej.

Wierzchołki oznaczone numerami 1 i 2 są ponumerowane zgodnie z kolejnością ich utworzenia. Aby sprawdzić kolejność ich utworzenia (jeśli masz wiele linii, nie pamiętasz, który wierzchołek utworzyłeś jako pierwszy), wystarczy przesunąć kursor myszki nad dwa wierzchołki jednej linii, patrz poniższy rysunek.

4 i 5, oznacza to, że do wierzchołka o niższym numerze (4 w tym przykładzie) odwołamy się za pomocą numeru 1 (pierwszego w poleceniu skryptu), a do wierzchołka o wyższym numerze (5 w tym przykładzie) odwołamy się za pomocą numeru 2 w poleceniu skryptu.

Przykład

Weźmy przykład z poprzednich trzech linijek. Kolejna cyfra wskazuje numerację każdej linii i ich wierzchołków zgodnie z konwencją dotyczącą skryptów.

niebieski tekst: numeracja linii, czarny tekst: numeracja wierzchołków

Polecenie sketch.addConstraint(Sketcher.Constraint("Coincident", 1, 2, 2, 1)) daje następujący wynik:

Pełny kod do narysowania trzech linii i dodania wiązania zbieżności dla dwóch punktów z dwóch linii wygląda następująco:

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()