Node – Aspose FOSS API Reference

Node

Пакет: @aspose/3d (v24.12.0)

Вузол представляє іменований елемент у ієрархії графа сцени. Кожен вузол має локальне перетворення, може містити дочірні вузли та несе нуль або більше Entity об’єктів, таких як меші, камери або світильники.

export class Node extends SceneObject

Enumerations

A3DObject ← SceneObject ← Node

Enumerations

Створіть батьківський вузол, приєднайте до нього два дочірні вузли та пройдіться по всій ієрархії за назвою.

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

Enumerations

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`

Enumerations

addChildNode(node)

Додає існуючий Node екземпляр як прямий дочірній елемент цього вузла.

addChildNode(node: Node): void

Enumerations

node Node

Вузол для приєднання. Вузол перепризначається від свого поточного батька до цього вузла.

Enumerations

void

Enumerations

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

Створює новий `Node`, за бажанням з ім'ям, сутністю та матеріалом, і додає його як дочірній елемент цього вузла.

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

Enumerations

name string (необов’язково)

Назва нового дочірнього вузла.

entity Entity (необов’язково)

Сутність для приєднання до нового вузла, наприклад a Mesh екземпляр.

material Material (необов’язково)

Матеріал, який слід пов’язати з новим вузлом.

Enumerations

Node

Новостворений дочірній вузол.

Enumerations

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)

Обчислює та повертає матрицю перетворення у світовому просторі для цього вузла. Передайте true щоб включити зсув геометричного перетворення, збережений у вузлі (використовується деякими експортерами FBX).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

Enumerations

withGeometricTransform boolean

Enumerations true, включає геометричне перетворення у результат.

Enumerations

Matrix4

4×4 матриця перетворення у світовому просторі.

Enumerations

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

Обчислює вісі-орієнтовану обмежувальну коробку цього вузла та всіх його нащадків у світовому просторі.

getBoundingBox(): BoundingBox

Enumerations

BoundingBox

Вісі-орієнтована обмежувальна коробка, що охоплює всю геометрію під цим вузлом.

Enumerations

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)

Об’єднує вміст іншого вузла (його сутності, матеріали та дочірні елементи) з цим вузлом і видаляє вихідний вузол зі сцени.

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

Enumerations

node Node

Вихідний вузол, вміст якого об’єднується в цей вузол.

Enumerations

void

Enumerations

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