Node – Aspose FOSS API Reference

Node

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

Solmu edustaa nimettyä elementtiä kohtakaavion hierarkiassa. Jokaisella solmulla on paikallinen muunnos, se voi sisältää alisolmuja ja kantaa nolla tai useampia Entity objekteja, kuten verkkoja, kameroita tai valoja.

export class Node extends SceneObject

ImageRenderOptions

A3DObject ← SceneObject ← Node

ImageRenderOptions

Luo vanhempi node, liitä siihen kaksi alisolmua ja kulje koko hierarkia läpi nimen perusteella.

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)

Lisää olemassa olevan Node instanssin suoraan tämän solmun lapsena.

addChildNode(node: Node): void

ImageRenderOptions

node Node

Liitettävä node. Node siirretään nykyiseltä vanhemmaltaan tälle nodelle.

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

Luo uuden `Node`, valinnaisesti nimellä, entiteetillä ja materiaalilla, ja lisää sen tämän solmun lapsena.

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

ImageRenderOptions

name string (valinnainen)

Uuden alisolmun nimi.

entity Entity (valinnainen)

Entiteetti, joka liitetään uuteen solmuun, esimerkiksi Mesh instanssi.

material Material (valinnainen)

Materiaali, joka liitetään uuteen solmuun.

ImageRenderOptions

Node

Äskettäin luotu alisolmu.

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)

Laskee ja palauttaa tämän solmun maailmanavaruuden muunnosmatriisin. Anna true sisällyttääksesi solmussa tallennetun geometrisen muunnospoikkeaman (joita jotkut FBX-vientiohjelmat käyttävät).

evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4

ImageRenderOptions

withGeometricTransform boolean

ImageRenderOptions true, sisällyttää geometrisen muunnoksen tulokseen.

ImageRenderOptions

Matrix4

4×4 maailmanavaruuden muunnosmatriisi.

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

Laskee tämän solmun ja kaikkien sen jälkeläisten akselikohtaisen raja-alueen maailmanavaruudessa.

getBoundingBox(): BoundingBox

ImageRenderOptions

BoundingBox

Akselikohtainen raja-alue, joka ympäröi kaikki tämän solmun alla oleva geometria.

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)

Yhdistää toisen solmun sisällön (sen entiteetit, materiaalit ja alisolmut) tähän solmuun ja poistaa lähdesolmun kohtauksesta.

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

ImageRenderOptions

node Node

Lähdesolmu, jonka sisältö yhdistetään tähän solmuun.

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