Node – Aspose FOSS API Reference

Node

חבילה: @aspose/3d (v24.12.0)

צומת מייצג אלמנט בעל שם במבנה גרף הסצנה. לכל צומת יש שינוי מקומי, הוא יכול להכיל צמתים ילדים, ונושא אפס או יותר Entity אובייקטים כגון רשתות, מצלמות או תאורות.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

צור node הורה, חבר שני node ילדים אליו, ועבור על כל ההיררכיה לפי שם.

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

ה‑node לצירוף. ה‑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 (אופציונלי)

ישות לצרף לצומת החדש, לדוגמה a Mesh מופע.

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)

מחשב ומחזיר את מטריצת ההמרה במרחב העולם עבור צומת זה. העבר true כדי לכלול את הסטיית ההמרה הגאומטרית השמורה בצומת (משמשת על ידי כמה מייצאי FBX).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, כולל את הטרנספורמציה הגאומטרית בתוצאה.

ImageRenderOptions

Matrix4

מטריצת ההמרה במרחב העולם בגודל 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()

מחשב את תיבת הגבול המיושרת לציר של צומת זה וכל הצאצאים שלו במרחב העולם.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

תיבת הגבול המיושרת לציר המכילה את כל הגאומטריה תחת צומת זה.

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)

ממזג את תוכן של צומת אחר (היישויות, החומרים והילדים שלו) לתוך צומת זה ומסיר את צומת המקור מהסצנה.

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