Node – Aspose FOSS API Reference

Node

بسته: @aspose/3d (v24.12.0)

گره نمایانگر یک عنصر نام‌دار در سلسله‌مراتب گراف صحنه است. هر گره یک تبدیل محلی دارد، می‌تواند گره‌های فرزند را نگه دارد و صفر یا بیشتر Entity اشیائی مانند مش‌ها، دوربین‌ها یا نورها.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

یک گره والد ایجاد کنید، دو گره فرزند را به آن متصل کنید و کل سلسله‌مراتب را بر اساس نام پیمایش کنید.

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)

یک موجود موجود را اضافه می‌کند Node نمونه به‌عنوان فرزند مستقیم این گره.

addChildNode(node: Node): void

ImageRenderOptions

node Node

گره‌ای که باید متصل شود. این گره از والد فعلی خود به این گره منتقل می‌شود.

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

یک مورد جدید ایجاد می‌کند `Node`,، به‌صورت اختیاری با یک نام، یک موجودیت و یک ماده، و آن را به‌عنوان فرزند این گره اضافه می‌کند.

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

ImageRenderOptions

name string (اختیاری)

نام گره فرزند جدید.

entity Entity (اختیاری)

یک موجودیت برای اتصال به گره جدید، برای مثال یک Mesh نمونه.

material Material (اختیاری)

یک material برای ارتباط با گرهٔ جدید.

ImageRenderOptions

Node

گرهٔ فرزند تازه ایجاد شده.

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)

ماتریس تبدیل فضای جهانی برای این گره را محاسبه و برمی‌گرداند. Pass true برای شامل کردن جابجایی تبدیل هندسی ذخیره‌شده در گره (که توسط برخی صادرکنندگان FBX استفاده می‌شود).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, شامل تبدیل هندسی در نتیجه است.

ImageRenderOptions

Matrix4

ماتریس تبدیل فضای جهانی ۴×۴.

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

جعبهٔ محدود‌کنندهٔ axis-aligned این گره و تمام فرزندان آن را در فضای جهانی محاسبه می‌کند.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

جعبهٔ محدود‌کنندهٔ axis-aligned که تمام هندسه‌های زیر این گره را در بر می‌گیرد.

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)

محتویات یک گرهٔ دیگر (نهادها، materialها و فرزندان آن) را در این گره ادغام می‌کند و گرهٔ منبع را از صحنه حذف می‌نماید.

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

ImageRenderOptions

node Node

گره منبعی که محتوا در این گره ادغام می‌شود.

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