Node – Aspose FOSS API Reference

Node

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

Node yra pavadintas elementas scenos grafiko hierarchijoje. Kiekvienas mazgas turi vietinį transformavimą, gali turėti vaikų mazgus ir neša nulį arba daugiau Entity objektų, tokių kaip tinklai, kameros arba šviesos.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

Sukurkite tėvo mazgą, prijunkite prie jo du vaikų mazgus ir pereikite visą hierarchiją pagal pavadinimą.

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)

Prideda esamą Node instance kaip tiesioginį šio mazgo vaiką.

addChildNode(node: Node): void

ImageRenderOptions

node Node

Mazgas, kurį reikia prijungti. Mazgas perkeliamas iš savo dabartinio tėvo į šį mazgą.

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

Sukuria naują `Node`, nebūtinai su pavadinimu, objektu ir medžiaga, ir prideda jį kaip šio mazgo vaiką.

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

ImageRenderOptions

name string (nebūtina)

Naujo vaiko mazgo pavadinimas.

entity Entity (nebūtina)

Objektas, kurį prijungti prie naujo mazgo, pavyzdžiui a Mesh instance.

material Material (nebūtina)

Medžiaga, susiejama su nauju mazgu.

ImageRenderOptions

Node

Naujai sukurtas vaiko mazgas.

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)

Apskaičiuoja ir grąžina pasaulio erdvės transformacijos matricą šiam mazgui. Pateikite true kad įtrauktumėte geometrinio transformacijos poslinkį, saugomą mazge (naudojama kai kurių FBX eksportuotojų).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, įtraukia geometrinį transformavimą į rezultatą.

ImageRenderOptions

Matrix4

4×4 pasaulio erdvės transformacijos matrica.

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

Apskaičiuoja šio mazgo ir visų jo palikuonių ašimis lygią ribų dėžutę pasaulio erdvėje.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

Ašimis lygią ribų dėžutę, apimančią visą geometriją po šiuo mazgu.

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)

Sujungia kito mazgo turinį (jo objektus, medžiagas ir vaikus) į šį mazgą ir pašalina šaltinio mazgą iš scenos.

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

ImageRenderOptions

node Node

Šaltinis mazgas, kurio turinys yra sujungiamas į šį mazgą.

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