Aspose.3D FOSS
TypeScript
Class Node

Class 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

EnumerationsEnumerationsEnumerations
namestringНазва цього вузла. Використовується для ідентифікації вузла в графі сцени.
parentNode`Nodenull`
childNodesNode[]Масив безпосередніх дочірніх вузлів, приєднаних до цього вузла.
entitiesEntity[]Список сутностей (meshes, cameras, lights, etc.) приєднаних до цього вузла.
materialsMaterial[]Список матеріалів, пов’язаних з цим вузлом.
transformTransformЛокальне перетворення цього вузла, з translation: Vector3, rotation: Quaternion, і scaling: Vector3 компонентами.
globalTransformGlobalTransformТільки для читання. Перетворення у глобальному просторі, обчислене шляхом множення всіх перетворень предків до кореня.
visiblebooleanЧи буде цей вузол і його піддерево відображатися. За замовчуванням — true.
excludedbooleanEnumerations true, вузол і його піддерево виключаються з експорту. За замовчуванням — false.
entity`Entityundefined`

Enumerations

addChildNode(node)

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

addChildNode(node: Node): void

Enumerations

node Node

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

Enumerations

void

Enumerations 

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

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

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 

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)

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

merge(node: Node): void

Enumerations

node Node

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

Enumerations

void

Enumerations 

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}`);
}
 Українська