Node
Overview
The Node class represents a named element in the Aspose.3D scene graph. Each node can hold one Entity (such as a Mesh, Camera, or Light), maintains parent-child relationships with other nodes, and carries a local transform. Nodes are the primary way to organize 3D objects in a scene hierarchy.
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)Constructor
The Node constructor initializes a node with an optional name.
| Parameter | Type | Description |
|---|---|---|
name | str | Optional name for the node |
Properties
All node attributes below are properties; access them without parentheses.
| Name | Type | Description |
|---|---|---|
name | str | Human-readable identifier for the node |
entity | Entity | None | The primary entity attached to this node (e.g., Mesh, Camera, Light). Shortcut for the first element of entities. |
entities | list[Entity] | All entities attached to this node (read-only). A node may reference more than one entity. |
material | Material | None | The primary material assigned to this node. |
materials | list[Material] | All materials assigned to this node (read-only). |
child_nodes | list[Node] | List of child nodes. Use child_nodes: not children |
parent_node | Node | None | Immediate parent node in the scene hierarchy |
parent_nodes | list[Node] | All parent nodes (inherited from Entity; supports instancing) |
visible | bool | When False, the node and its subtree are hidden in viewers that respect visibility. |
excluded | bool | When True, this node is excluded from rendering |
transform | Transform | Local transform (translation, rotation, scale) |
global_transform | GlobalTransform | World-space transformation matrix |
asset_info | AssetInfo | None | Asset metadata attached to this node, if any. |
properties | PropertyCollection | Custom properties attached to this node |
Methods
| Method | Return Type | Description |
|---|---|---|
create_child_node(name) | Node | Creates and attaches a new child node with the given name |
create_child_node(name, entity) | Node | Creates a child node and assigns an entity to it |
add_child_node(node) | None | Adds an existing node as a child of this node |
get_child(name) | Optional[Node] | Finds a direct child node by name |
add_entity(entity) | None | Attaches an additional entity to this node |
merge(node) | None | Merges another node’s children and entities into this node |
evaluate_global_transform(with_geometric_transform) | Matrix4 | Returns the world-space transform matrix; pass True to include geometric offsets |
get_bounding_box() | BoundingBox | Computes the axis-aligned bounding box of the node in world space |
get_property(name) | Any | Gets a property value by name |
find_property(name) | Optional[Property] | Finds a property by name |
Example
Create a scene, attach a mesh to a node, and traverse the scene graph:
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}")