Node – Aspose FOSS API Reference

Node

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

Mezgls pārstāv nosauktu elementu ainas grafika hierarhijā. Katram mezglam ir lokāla transformācija, tas var saturēt bērna mezglus un nes nulles vai vairākas Entity objektus, piemēram, režģus, kameras vai gaismas.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

Izveidojiet vecāku mezglu, pievienojiet tam divus bērna mezglus un pārlūkojiet visu hierarhiju pēc nosaukuma.

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)

Pievieno esošu Node instanci kā tiešu bērnu šim mezglam.

addChildNode(node: Node): void

ImageRenderOptions

node Node

Mezgls, ko pievienot. Mezgls tiek pārcelts no savas pašreizējās vecāka uz šo mezglu.

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

Izveido jaunu `Node`, pēc izvēles ar nosaukumu, entītiju un materiālu, un pievieno to kā bērnu šim mezglam.

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

ImageRenderOptions

name string (pēc izvēles)

Nosaukums jaunajam bērna mezglam.

entity Entity (pēc izvēles)

Entītija, ko pievienot jaunajam mezglam, piemēram, Mesh instanci.

material Material (pēc izvēles)

Materiāls, ko saistīt ar jauno mezglu.

ImageRenderOptions

Node

Jaunizveidotais bērna mezgls.

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)

Aprēķina un atgriež pasaules telpas transformācijas matricu šim mezglam. Padod true lai iekļautu mezglā saglabāto ģeometriskā transformācijas nobīdi (izmanto dažas FBX eksportētājas).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, iekļauj ģeometrisko transformāciju rezultātā.

ImageRenderOptions

Matrix4

4×4 pasaules telpas transformācijas matrica.

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

Aprēķina šī mezgla un visus tā pēcnācējus pasaules telpā esošo as‑izlīdzināto robežkasti.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

As‑izlīdzinātā robežkaste, kas aptver visu ģeometriju zem šī mezgla.

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)

Apvieno cita mezgla saturu (tā elementus, materiālus un bērnus) ar šo mezglu un noņem avota mezglu no ainas.

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

ImageRenderOptions

node Node

Avota mezgls, kura saturs tiek apvienots šajā mezglā.

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