Node – Aspose FOSS API Reference

Node

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

Node representerer et navngitt element i scenegrafens hierarki. Hver node har en lokal transformasjon, kan inneholde undernoder, og bærer null eller flere Entity objekter som meshes, kameraer eller lys.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

Opprett en overordnet node, fest to underordnede noder til den, og traverser hele hierarkiet etter navn.

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

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`

ImageRenderOptions

addChildNode(node)

Legger til en eksisterende Node instans som et direkte barn av denne noden.

addChildNode(node: Node): void

ImageRenderOptions

node Node

Noden som skal festes. Noden blir reparentet fra sin nåværende forelder til denne noden.

ImageRenderOptions

void

ImageRenderOptions

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

Oppretter en ny `Node`, eventuelt med et navn, en enhet og et materiale, og legger den til som et barn av denne noden.

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

ImageRenderOptions

name string (valgfritt)

Navnet på den nye underordnede noden.

entity Entity (valgfritt)

En enhet som skal festes til den nye noden, for eksempel en Mesh instans.

material Material (valgfritt)

Et materiale å knytte til den nye noden.

ImageRenderOptions

Node

Den nyopprettede undernoden.

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)

Beregn og returner verdensromtransformasjonsmatrisen for denne noden. Send true for å inkludere den geometriske transformasjonsforskyvningen lagret på noden (brukt av noen FBX-eksportører).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, inkluderer den geometriske transformasjonen i resultatet.

ImageRenderOptions

Matrix4

Den 4×4 verdensromtransformasjonsmatrisen.

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

Beregner den aksejusterte omsluttende boksen for denne noden og alle dens etterkommere i verdensrommet.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

Den aksejusterte omsluttende boksen som omfatter all geometri under denne noden.

ImageRenderOptions

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)

Fletter inn innholdet fra en annen node (dens enheter, materialer og barn) inn i denne noden og fjerner kilde‑noden fra scenen.

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

ImageRenderOptions

node Node

Kildenoden hvis innhold er slått sammen med denne noden.

ImageRenderOptions

void

ImageRenderOptions

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