Class Node

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

Node mewakili elemen bernama dalam hierarki grafik adegan. Setiap node memiliki transformasi lokal, dapat menampung node anak, dan membawa nol atau lebih Entity objek seperti mesh, kamera, atau lampu.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

Buat sebuah node induk, lampirkan dua node anak padanya, dan telusuri seluruh hierarki berdasarkan nama.

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`	Nama node ini. Digunakan untuk mengidentifikasi node dalam grafik adegan.
`parentNode`	`Node	null`
`childNodes`	`Node[]`	Array dari node anak langsung yang terpasang pada node ini.
`entities`	`Entity[]`	Daftar entitas (mesh, kamera, lampu, dll.) yang terpasang pada node ini.
`materials`	`Material[]`	Daftar material yang terkait dengan node ini.
`transform`	`Transform`	Transformasi lokal node ini, dengan `translation: Vector3`, `rotation: Quaternion`, dan `scaling: Vector3` komponen.
`globalTransform`	`GlobalTransform`	Hanya-baca. Transformasi ruang dunia, dihitung dengan mengalikan semua transformasi nenek moyang hingga akar.
`visible`	`boolean`	Apakah node ini dan subtree-nya dirender. Defaultnya adalah `true`.
`excluded`	`boolean`	ImageRenderOptions `true`, node dan subtree-nya dikecualikan dari ekspor. Defaultnya adalah `false`.
`entity`	`Entity	undefined`

ImageRenderOptions

addChildNode(node)

Menambahkan yang ada Node instance sebagai anak langsung dari node ini.

addChildNode(node: Node): void

ImageRenderOptions

node Node

Node yang akan dilampirkan. Node tersebut dipindahkan orang tuanya dari parent saat ini ke node ini.

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

Membuat yang baru Node, secara opsional dengan nama, entitas, dan material, dan menambahkannya sebagai anak dari node ini.

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

ImageRenderOptions

name string (opsional)

Nama untuk node anak baru.

entity Entity (opsional)

Entitas untuk dilampirkan ke node baru, misalnya sebuah Mesh instance.

material Material (opsional)

Sebuah material untuk dihubungkan dengan node baru.

ImageRenderOptions

Node

Node anak yang baru dibuat.

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)

Menghitung dan mengembalikan matriks transformasi ruang-dunia untuk node ini. Berikan true untuk menyertakan offset transformasi geometris yang disimpan pada node (digunakan oleh beberapa pengekspor FBX).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, menyertakan transformasi geometris dalam hasil.

ImageRenderOptions

Matrix4

Matriks transformasi ruang-dunia 4×4.

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

Menghitung bounding box yang sejajar sumbu untuk node ini dan semua keturunannya dalam ruang dunia.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

Bounding box yang sejajar sumbu yang melingkupi semua geometri di bawah node ini.

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)

Menggabungkan konten dari node lain (entitas, material, dan anak‑anaknya) ke dalam node ini dan menghapus node sumber dari adegan.

merge(node: Node): void

ImageRenderOptions

node Node

Node sumber yang isinya digabungkan ke dalam node ini.

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