Struktura danych LinkSubList

From FreeCAD Documentation
Revision as of 12:40, 19 March 2024 by Kaktus (talk | contribs) (Created page with "Nowy obiekt utworzony skryptem może przyjąć LinkSubList, dodając odpowiednią właściwość.")
Other languages:

Opis

LinkSubList to struktura danych, która jest używana jako wejście dla różnych funkcji i obiektów. Jej celem jest przekazanie obiektu podrzędnego lub elementu podrzędnego (wierzchołka, krawędzi lub ściany) z obiektu do innego obiektu, który będzie używał lub przekształcał tę geometrię.

Lista LinkSubList składa się z listy krotek.

sublist = [tuple1, tuple2, tuple3, ...]

Każda krotka zawiera co najmniej dwa elementy: pierwszy element to odwołanie do obiektu dokumentu, a drugi element to ciąg tekstowy wskazujący wewnętrzną nazwę elementu podrzędnego. Ta nazwa ma numer od jednego do całkowitej liczby tych elementów podrzędnych.

tuple1 = (obj1, "Vertex1")
tuple2 = (obj2, "Face1")
tuple3 = (obj3, "Edge1")

Drugi element krotki może być listą ciągów znaków, wskazujących różne elementy podrzędne tego samego obiektu dokumentu.

tuple1 = (obj1, ["Vertex1", "Vertex2"])
tuple2 = (obj2, ["Face1", "Face3", "Face5"])
tuple3 = (obj3, ["Vertex1", "Face5", "Edge1", "Edge2"])

Można zauważyć, że LinkSubList to lista struktur LinkSub. Każda krotka jest faktycznie obiektem LinkSub.

Tworzenie skryptów

Zapoznaj się z treścią: Podstawy tworzenia skryptów FreeCAD, LinkSub.

Nowy obiekt utworzony skryptem może przyjąć LinkSubList, dodając odpowiednią właściwość.

It is important to recompute the objects before their subelements are used as input for other objects, otherwise an error may be produced as the geometry may not contain a valid Shape.

doc = App.newDocument()

cube = doc.addObject("Part::Box", "Cube")
cyl = doc.addObject("Part::Cylinder", "Cylinder")
doc.recompute()

new_obj = doc.addObject("App::FeaturePython", "New")

new_obj.addProperty("App::PropertyLinkSubList", "Geometry")
new_obj.Geometry = [(cube, ["Vertex1", "Vertex2"]),
                    (cyl, "Edge1")]
doc.recompute()

The subelement can then be extracted from the assigned property, and can be manipulated to do something.

>>> new_obj.Geometry
[(<Part::PartFeature>, ('Vertex1', 'Vertex2')), (<Part::PartFeature>, ('Edge1',))]

>>> new_obj.Geometry[0]
(<Part::PartFeature>, ('Vertex1', 'Vertex2'))

>>> new_obj.Geometry[0][1]
('Vertex1', 'Vertex2')

>>> new_obj.Geometry[0][1][1]
'Vertex2'

>>> new_obj.Geometry[0][1][1].strip("Vertex")
'2'

>>> int(new_obj.Geometry[0][1][1].strip("Vertex"))
2