Node
Methods
Methods Node המחלקה מייצגת אלמנט בעל שם בגרף הסצנה Aspose.3D. כל צומת יכול להכיל אחד Entity (כגון Mesh, Camera, או Light), משמרת יחסי הורה‑צאצא עם צמתים אחרים, ונושאת טרנספורם מקומי. צמתים הם הדרך העיקרית לארגן אובייקטים תלת‑ממדיים במבנה סצנה.
from aspose.threed import Scene, Node
scene = Scene()
# Access the root node: root_node is a property on Scene
root = scene.root_node
# Create a child node
child = root.create_child_node("my_node")
# child_nodes is a property: access without parentheses
for node in root.child_nodes:
print(node.name)Methods
Methods Node הקונסטרקטור מאתחל צומת עם שם אופציונלי.
| Methods | Methods | Methods |
|---|---|---|
name | str | שם אופציונלי לצומת |
Methods
כל המאפיינים של הצומת למטה הם מאפיינים; גישה אליהם ללא סוגריים.
| Methods | Methods | Methods |
|---|---|---|
name | str | מזהה קריא לבן אדם עבור הצומת |
entity | `Entity | None` |
entities | list[Entity] | כל הישויות המחוברות לצומת זה (קריאה בלבד). צומת עשויה להתייחס ליותר מישות אחת. |
material | `Material | None` |
materials | list[Material] | כל החומרים שהוקצו לצומת זה (קריאה בלבד). |
child_nodes | list[Node] | רשימת צמתים צאצאים. השתמש ב‑ child_nodes: לא children |
parent_node | `Node | None` |
parent_nodes | list[Node] | כל הצמתים ההורים (יורשים מ Entity; תומך ביצירת מופעים) |
visible | bool | Methods False, הצומת ותת‑עץ שלו מוסתרים במציגים שמכבדים נראות. |
excluded | bool | Methods True, צומת זה מוחרג מהצגה |
transform | Transform | טרנספורמציה מקומית (תרגום, סיבוב, קנה מידה) |
global_transform | GlobalTransform | מטריצת טרנספורמציה במרחב העולם |
asset_info | `AssetInfo | None` |
properties | PropertyCollection | מאפיינים מותאמים אישית המצורפים לצומת זה |
Methods
| Methods | סוג החזרה | Methods |
|---|---|---|
create_child_node(name) | Node | יוצר ומצמיד צומת בן חדש עם השם הנתון |
create_child_node(name, entity) | Node | יוצר צומת בן ומקצה לו ישות |
add_child_node(node) | None | מוסיף צומת קיים כבן של צומת זה |
get_child(name) | Optional[Node] | מחפש צומת בן ישיר לפי שם |
add_entity(entity) | None | מצרף ישות נוספת לצומת זה |
merge(node) | None | ממזג את הילדים והיישויות של צומת אחר לתוך צומת זה |
evaluate_global_transform(with_geometric_transform) | Matrix4 | מחזיר את מטריצת הטרנספורמציה במרחב העולם; העבר True כדי לכלול הסטות גאומטריות |
get_bounding_box() | BoundingBox | מחשב את תיבת הגבול המיושרת לצירים של הצומת במרחב העולם |
get_property(name) | Any | מקבל ערך של נכס לפי שם |
find_property(name) | Optional[Property] | מוצא נכס לפי שם |
Methods
צור סצנה, חבר mesh לצומת, ועבור על גרף הסצנה:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh
from aspose.threed.utilities import Vector4
scene = Scene()
mesh = Mesh()
# Use _control_points to mutate the backing list (control_points returns a copy)
mesh._control_points.append(Vector4(0, 0, 0, 1))
mesh._control_points.append(Vector4(1, 0, 0, 1))
mesh._control_points.append(Vector4(0.5, 1, 0, 1))
mesh.create_polygon(0, 1, 2)
# Attach mesh to a child node
node = scene.root_node.create_child_node("triangle", mesh)
# Traverse child_nodes (property, not a method)
for child in scene.root_node.child_nodes:
entity = child.entity
if entity is not None:
print(f"Node '{child.name}': {type(entity).__name__}")
# excluded is a property
print(f" Excluded: {entity.excluded}")