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 هو abstract base class ولا يتم إنشاء مثيل له مباشرة. استخدم concrete subclass مثل Mesh.
Methods
| Methods | Methods | Methods |
|---|---|---|
parent_nodes | list[Node] (قراءة فقط) | جميع العقد الأب التي يتم إرفاق هذا الكيان بها. يدعم instancing (نفس الكيان المشار إليه من عدة عقد). |
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}")