Aspose.3D FOSS
TypeScript
Class Node

Class 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

ExamplesExamplesExamples
namestringEl nombre de este nodo. Se usa para identificar el nodo dentro del grafo de escena.
parentNode`Nodenull`
childNodesNode[]Una matriz de nodos hijos directos adjuntos a este nodo.
entitiesEntity[]La lista de entidades (mallas, cámaras, luces, etc.) adjuntas a este nodo.
materialsMaterial[]La lista de materiales asociados a este nodo.
transformTransformLa transformación local de este nodo, con translation: Vector3, rotation: Quaternion, y scaling: Vector3 componentes.
globalTransformGlobalTransformSolo lectura. La transformación en espacio mundial, calculada multiplicando todas las transformaciones de los ancestros hasta la raíz.
visiblebooleanIndica si este nodo y su subárbol se renderizan. El valor predeterminado es true.
excludedbooleanExamples true, el nodo y su subárbol se excluyen de la exportación. El valor predeterminado es false.
entity`Entityundefined`

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 

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

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.

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 

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

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.

merge(node: Node): void

Examples

node Node

El nodo fuente cuyo contenido se fusiona en este nodo.

Examples

void

Examples 

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

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}`);
}
 Español