Class Node

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

Node vertegenwoordigt een benoemd element in de hiërarchie van de scènegrafiek. Elke node heeft een lokale transformatie, kan kindnodes bevatten en draagt nul of meer Entity objecten zoals meshes, camera’s of lichten.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

Maak een bovenliggende node, koppel twee kindnodes eraan, en doorloop de volledige hiërarchie op naam.

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

ImageRenderOptions

ImageRenderOptions	ImageRenderOptions	ImageRenderOptions
`name`	`string`	De naam van deze node. Wordt gebruikt om de node binnen de scènegrafiek te identificeren.
`parentNode`	`Node	null`
`childNodes`	`Node[]`	Een array van directe kindnodes die aan deze node zijn gekoppeld.
`entities`	`Entity[]`	De lijst van entiteiten (meshes, camera’s, lichten, enz.) die aan deze node zijn gekoppeld.
`materials`	`Material[]`	De lijst van materialen die aan deze node zijn gekoppeld.
`transform`	`Transform`	De lokale transformatie van deze node, met `translation: Vector3`, `rotation: Quaternion`, en `scaling: Vector3` componenten.
`globalTransform`	`GlobalTransform`	Alleen-lezen. De wereldruimte-transformatie, berekend door alle vooroudertransformaties tot de root te vermenigvuldigen.
`visible`	`boolean`	Of deze node en zijn subboom worden gerenderd. Standaard is `true`.
`excluded`	`boolean`	ImageRenderOptions `true`, de knoop en zijn subboom worden uitgesloten van export. Standaard is `false`.
`entity`	`Entity	undefined`

ImageRenderOptions

addChildNode(node)

Voegt een bestaande toe Node instance als direct kind van dit knooppunt.

addChildNode(node: Node): void

ImageRenderOptions

node Node

De node om toe te voegen. De node wordt van zijn huidige ouder naar deze node verplaatst.

ImageRenderOptions

void

ImageRenderOptions

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?)

Maakt een nieuwe Node, eventueel met een naam, een entiteit en een materiaal, en voegt het toe als kind van dit knooppunt.

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

ImageRenderOptions

name string (optioneel)

De naam voor de nieuwe kindnode.

entity Entity (optioneel)

Een entiteit om aan het nieuwe knooppunt te koppelen, bijvoorbeeld een Mesh instance.

material Material (optioneel)

Een materiaal om te koppelen aan het nieuwe knooppunt.

ImageRenderOptions

Node

Het nieuw aangemaakte kindknooppunt.

ImageRenderOptions

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)

Berekent en retourneert de wereldruimtetransformatie-matrix voor dit knooppunt. Geef true om de geometrische transformatie-offset die op het knooppunt is opgeslagen op te nemen (gebruikt door sommige FBX-exporteurs).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, omvat de geometrische transformatie in het resultaat.

ImageRenderOptions

Matrix4

De 4×4 wereldruimtetransformatie‑matrix.

ImageRenderOptions

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()

Berekent de asgeoriënteerde begrenzingsdoos van dit knooppunt en al zijn afstammelingen in de wereldruimte.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

De asgeoriënteerde begrenzingsdoos die alle geometrie onder dit knooppunt omsluit.

ImageRenderOptions

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)

Voegt de inhoud van een ander knooppunt (zijn entiteiten, materialen en kinderen) samen met dit knooppunt en verwijdert het bronknooppunt uit de scène.

merge(node: Node): void

ImageRenderOptions

node Node

De bronknooppunt waarvan de inhoud wordt samengevoegd met dit knooppunt.

ImageRenderOptions

void

ImageRenderOptions

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