Node – Aspose FOSS API Reference

Node

Paquete: @aspose/3d (v24.12.0)

Node representa un elemento con nombre en la jerarquía del grafo de escena. Cada nodo tiene una transformación local, puede contener nodos hijos y lleva cero o más Entity objetos como mallas, cámaras o luces.

export class Node extends SceneObject

Examples

A3DObject ← SceneObject ← Node

Examples

Crea un nodo padre, adjunta dos nodos hijos a él y recorre toda la jerarquía por nombre.

import { Scene, Node } from '@aspose/3d';

const scene = new Scene();
const root = scene.rootNode;

const vehicle = root.createChildNode('vehicle');
const body = vehicle.createChildNode('body');
const wheel = vehicle.createChildNode('wheel_front_left');

function traverse(node: Node, depth = 0): void {
  console.log(' '.repeat(depth * 2) + node.name);
  for (const child of node.childNodes) {
    traverse(child, depth + 1);
  }
}

traverse(root);
// Output:
//   vehicle
//     body
//     wheel_front_left

Examples

Name	Type	Access	Description
`parentNode`	`Node	null`	Read/Write
`childNodes`	`Node[]`	Read	Gets the child nodes.
`entities`	`Entity[]`	Read	Gets the entities.
`entity`	`Entity	undefined`	Read/Write
`materials`	`Material[]`	Read	Gets the materials.
`material`	`Material	null`	Read/Write
`transform`	`Transform`	Read	Gets the transform.
`globalTransform`	`GlobalTransform`	Read	Gets the global transform.
`visible`	`boolean`	Read/Write	Gets the visible.
`excluded`	`boolean`	Read/Write	Gets the excluded.
`assetInfo`	`any`	Read/Write	Gets the asset info.
`metaDatas`	`any[]`	Read	Gets the meta datas.

Signature	Description
`constructor(name: string, entity: Entity)`	Creates a node with the specified name and initial entity
`addEntity(entity: Entity)`	Attaches the given entity to the node’s entity collection
`removeEntity(entity: Entity)`	Detaches the specified entity from the node
`clearEntities()`	Removes all entities from the node
`addChildNode(node: Node)`	Adds an existing node as a child of this node
`createChildNode(nodeName: string, entity: Entity, material: Material)` → `Node`	Creates a new child node with name, entity, and material, and returns it
`getChild(indexOrName: number	string) `→` Node
`merge(node: Node)`	Incorporates the contents of another node into this node
`evaluateGlobalTransform(withGeometricTransform: boolean)` → `Matrix4`	Computes the node’s global transform matrix, optionally including geometric transform
`getBoundingBox()` → `BoundingBox`	Returns the bounding box.
`selectSingleObject(_path: string)` → `any`	Not implemented in the FOSS edition — throws at runtime. Selects a single object in the node hierarchy using the provided path
`selectObjects(_path: string)` → `any[]`	Not implemented in the FOSS edition — throws at runtime. Selects all objects matching the given path and returns them as an array
`toString()` → `string`

Examples

addChildNode(node)

Añade un existente Node instancia como hijo directo de este nodo.

addChildNode(node: Node): void

Examples

node Node

El nodo a adjuntar. El nodo se vuelve a asignar de su padre actual a este nodo.

Examples

void

Examples

const scene = new Scene(); const parent = scene.rootNode.createChildNode(‘parent’); const child = new Node(‘child’); parent.addChildNode(child); console.log(Children of parent: ${parent.childNodes.length}); // 1


---

### createChildNode(name?, entity?, material?)

Crea un nuevo `Node`, opcionalmente con un nombre, una entidad y un material, y lo agrega como hijo de este nodo.

```typescript
createChildNode(name?: string, entity?: Entity, material?: Material): Node

Examples

name string (opcional)

El nombre para el nuevo nodo hijo.

entity Entity (opcional)

Una entidad para adjuntar al nuevo nodo, por ejemplo un Mesh instancia.

material Material (opcional)

Un material para asociar con el nuevo nodo.

Examples

Node

El nodo hijo recién creado.

Examples

import { Scene } from '@aspose/3d';
import { Mesh } from '@aspose/3d/entities';

const scene = new Scene();
const mesh = new Mesh();
// ... populate mesh ...
const meshNode = scene.rootNode.createChildNode('geometry', mesh);
console.log(`Node name: ${meshNode.name}`);
console.log(`Entities attached: ${meshNode.entities.length}`);

evaluateGlobalTransform(withGeometricTransform)

Calcula y devuelve la matriz de transformación en espacio mundial para este nodo. Pase true para incluir el desplazamiento de transformación geométrica almacenado en el nodo (utilizado por algunos exportadores FBX).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

Examples

withGeometricTransform boolean

Examples true, incluye la transformación geométrica en el resultado.

Examples

Matrix4

La matriz de transformación en espacio mundial 4×4.

Examples

import { Scene } from '@aspose/3d';

const scene = new Scene();
scene.open('model.fbx');
const node = scene.rootNode.childNodes[0];
const matrix = node.evaluateGlobalTransform(false);
console.log('World transform matrix computed.');

getBoundingBox()

Calcula el cuadro delimitador alineado a los ejes de este nodo y todos sus descendientes en espacio mundial.

getBoundingBox(): BoundingBox

Examples

BoundingBox

El cuadro delimitador alineado a los ejes que envuelve toda la geometría bajo este nodo.

Examples

const scene = new Scene(); scene.open(‘model.obj’); const bbox = scene.rootNode.getBoundingBox(); console.log(Min: ${JSON.stringify(bbox.minimum)}); console.log(Max: ${JSON.stringify(bbox.maximum)});


---

### merge(node)

Fusiona el contenido de otro nodo (sus entidades, materiales y hijos) en este nodo y elimina el nodo fuente de la escena.

```typescript
merge(node: Node): void

Examples

node Node

El nodo fuente cuyo contenido se fusiona en este nodo.

Examples

void

Examples

const scene = new Scene(); scene.open(‘multi_part.fbx’);

const root = scene.rootNode; if (root.childNodes.length >= 2) { root.childNodes[0].merge(root.childNodes[1]); console.log(Children after merge: ${root.childNodes.length}); }