Entity
Methods
Methods Entity class є абстрактним базовим класом для об’єктів, які можуть бути приєднані до Node у Aspose.3D графі сцени. Конкретні підкласи включають Mesh, Camera, Light, і Geometry. Entity надає доступ до ієрархії батьківських вузлів і розкриває excluded властивість для керування видимістю.
Усі атрибути, перелічені нижче, є властивостями; доступайтеся до них без дужок.
from aspose.threed import Scene
from aspose.threed.entities import Mesh
scene = Scene.from_file("model.obj")
for node in scene.root_node.child_nodes:
entity = node.entity
if entity is not None:
# excluded is a property, not a method call
if not entity.excluded:
# parent_node is a property, not a method call
parent = entity.parent_node
print(f"Active entity '{entity.name}', parent: {parent.name if parent else 'None'}")Methods
A3DObject → SceneObject → Entity
Підкласи: Geometry → Mesh, Camera, Light, та інші.
Methods
Entity є абстрактним базовим класом і не створюється безпосередньо. Використайте конкретний підклас, наприклад Mesh.
Methods
| Methods | Methods | Methods |
|---|---|---|
parent_nodes | list[Node] (лише для читання) | Усі батьківські вузли, до яких прикріплено цю сутність. Підтримує інстанціювання (одна й та сама сутність посилається з кількох вузлів). |
parent_node | Optional[Node] (читання/запис) | Основний батьківський вузол, або None якщо сутність не прикріплена. |
excluded | bool (читання/запис) | Methods True, ця сутність виключена з рендерингу. Доступ і встановлення як властивість: entity.excluded = True. |
name | str (читання/запис) | Людсько-читабельна назва цієї сутності. |
properties | PropertyCollection (тільки читання) | Колекція користувацьких властивостей. |
Methods
| Methods | Тип повернення | Methods |
|---|---|---|
get_property(name) | Any | Отримує значення властивості за назвою. |
find_property(name) | Optional[Property] | Знаходить властивість за назвою. |
Важливо: parent_node, parent_nodes, і excluded є властивості, не методи. Не викликайте їх з дужками. Правильні шаблони такі:
# CORRECT
is_excluded = entity.excluded
parent = entity.parent_node
parents = entity.parent_nodes
# WRONG: do not do this
is_excluded = entity.excluded() # TypeError
parent = entity.parent_node() # TypeErrorЩоб встановити parent_node, присвоїти властивості:
entity.parent_node = some_node # CORRECTMethods
Перевірте стан сутності після завантаження сцени:
from aspose.threed import Scene
from aspose.threed.entities import Mesh
scene = Scene.from_file("model.stl")
for node in scene.root_node.child_nodes:
entity = node.entity
if entity is None:
continue
# Properties accessed without parentheses
print(f"Entity: {entity.name or '(unnamed)'}")
print(f" Type: {type(entity).__name__}")
print(f" Excluded: {entity.excluded}")
print(f" Parent node: {entity.parent_node.name if entity.parent_node else 'None'}")
if isinstance(entity, Mesh):
print(f" Vertices: {len(entity.control_points)}")
print(f" Polygons: {entity.polygon_count}")