Node
Methods
Methods Node classe representa um elemento nomeado no grafo de cena Aspose.3D. Cada nó pode conter um Entity (como um Mesh, Camera, ou Light), mantém relacionamentos pai‑filho com outros nós e carrega uma transformação local. Nós são a forma principal de organizar objetos 3D em uma hierarquia de cena.
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 construtor inicializa um nó com um nome opcional.
| Methods | Methods | Methods |
|---|---|---|
name | str | Nome opcional para o nó |
Methods
Todos os atributos do nó abaixo são propriedades; acesse-os sem parênteses.
| Methods | Methods | Methods |
|---|---|---|
name | str | Identificador legível por humanos para o nó |
entity | `Entity | None` |
entities | list[Entity] | Todas as entidades anexadas a este nó (somente leitura). Um nó pode referenciar mais de uma entidade. |
material | `Material | None` |
materials | list[Material] | Todos os materiais atribuídos a este nó (somente leitura). |
child_nodes | list[Node] | Lista de nós filhos. Use child_nodes:não children |
parent_node | `Node | None` |
parent_nodes | list[Node] | Todos os nós pais (herdados de Entity; suporta instanciação) |
visible | bool | Methods False, o nó e sua subárvore são ocultados em visualizadores que respeitam a visibilidade. |
excluded | bool | Methods True, este nó é excluído da renderização |
transform | Transform | Transformação local (translação, rotação, escala) |
global_transform | GlobalTransform | Matriz de transformação em espaço mundial |
asset_info | `AssetInfo | None` |
properties | PropertyCollection | Propriedades personalizadas anexadas a este nó |
Methods
| Methods | Tipo de Retorno | Methods |
|---|---|---|
create_child_node(name) | Node | Cria e anexa um novo nó filho com o nome fornecido |
create_child_node(name, entity) | Node | Cria um nó filho e atribui uma entidade a ele |
add_child_node(node) | None | Adiciona um nó existente como filho deste nó |
get_child(name) | Optional[Node] | Encontra um nó filho direto pelo nome |
add_entity(entity) | None | Anexa uma entidade adicional a este nó |
merge(node) | None | Mescla os filhos e entidades de outro nó neste nó |
evaluate_global_transform(with_geometric_transform) | Matrix4 | Retorna a matriz de transformação no espaço mundial; passe True para incluir deslocamentos geométricos |
get_bounding_box() | BoundingBox | Calcula o axis-aligned bounding box do nó no espaço mundial |
get_property(name) | Any | Obtém o valor de uma propriedade pelo nome |
find_property(name) | Optional[Property] | Encontra uma propriedade pelo nome |
Methods
Crie uma cena, anexe um mesh a um nó e percorra o grafo de cena:
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}")