Class Node

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

Node mewakili elemen bernama dalam hierarki graf adegan. Setiap node mempunyai transformasi tempatan, boleh memegang node anak, dan membawa sifar atau lebih Entity objek seperti meshes, kamera, atau lampu.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

Cipta node induk, lampirkan dua node anak kepadanya, dan lalui keseluruhan hierarki mengikut 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 mengenal pasti node dalam graf adegan.
`parentNode`	`Node	null`
`childNodes`	`Node[]`	Satu tatasusunan node anak langsung yang dipautkan kepada node ini.
`entities`	`Entity[]`	Senarai entiti (meshes, kamera, lampu, dll.) yang dipautkan kepada node ini.
`materials`	`Material[]`	Senarai bahan yang berkaitan dengan nod ini.
`transform`	`Transform`	Transformasi setempat nod ini, dengan `translation: Vector3`, `rotation: Quaternion`, dan `scaling: Vector3` komponen.
`globalTransform`	`GlobalTransform`	Baca-sahaja. Transformasi ruang-dunia, dikira dengan mendarab semua transformasi nenek moyang sehingga akar.
`visible`	`boolean`	Sama ada nod ini dan subpokoknya dipaparkan. Lalai ialah `true`.
`excluded`	`boolean`	ImageRenderOptions `true`, nod dan subpokoknya dikecualikan daripada eksport. Lalai ialah `false`.
`entity`	`Entity	undefined`

ImageRenderOptions

addChildNode(node)

Menambah satu yang sedia ada Node instance sebagai anak langsung node ini.

addChildNode(node: Node): void

ImageRenderOptions

node Node

Node yang akan dilampirkan. Node tersebut dipindahkan ibu bapa daripada ibu bapa semasanya 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?)

Mencipta satu baru Node, secara pilihan dengan nama, entity, dan material, dan menambahkannya sebagai anak node ini.

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

ImageRenderOptions

name string (pilihan)

Nama untuk node anak baru.

entity Entity (pilihan)

Sebuah entity untuk dilampirkan kepada node baru, contohnya sebuah Mesh instance.

material Material (pilihan)

Bahan untuk dikaitkan dengan nod baru.

ImageRenderOptions

Node

Nod anak yang baru dicipta.

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)

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

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, menyertakan transformasi geometri 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()

Mengira kotak sempadan berpaksi bagi nod ini dan semua keturunannya dalam ruang dunia.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

Kotak sempadan berpaksi yang meliputi semua geometri di bawah nod 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 kandungan nod lain (entiti, bahan, dan anaknya) ke dalam nod ini dan mengeluarkan nod sumber daripada adegan.

merge(node: Node): void

ImageRenderOptions

node Node

Node sumber yang kandungannya 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}`);
}