Node
Paket: @aspose/3d (v24.12.0)
Čvor predstavlja imenovani element u hijerarhiji grafika scene. Svaki čvor ima lokalnu transformaciju, može da sadrži podčvorove i nosi nula ili više Entity objekata kao što su mreže, kamere ili svetla.
export class Node extends SceneObjectA3DObject ← SceneObject ← Node
Kreirajte roditeljski čvor, prikačite dva čvora‑deca na njega i pređite kompletnu hijerarhiju po imenu.
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
| 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 |
addChildNode(node)
Dodaje postojeći Node instancu kao direktno dete ovog čvora.
addChildNode(node: Node): voidnode Node
Čvor koji se prikači. Čvor se premesti iz svog trenutnog roditelja u ovaj čvor.
void
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?)
Kreira novi `Node`, po želji sa imenom, entitetom i materijalom, i dodaje ga kao dete ovom čvoru.
```typescript
createChildNode(name?: string, entity?: Entity, material?: Material): Nodename string (opciono)
Ime za novi čvor‑dete.
entity Entity (opciono)
Entitet koji se prikači na novi čvor, na primer a Mesh instanca.
material Material (opciono)
Materijal koji se povezuje sa novim čvorom.
Node
Novokreirani podčvor.
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)
Izračunava i vraća matricu transformacije u svetskom prostoru za ovaj čvor. Proslijedite true da uključi geometrijski pomeraj transformacije pohranjen na čvoru (koristi ga neki FBX izvoznici).
evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4withGeometricTransform boolean
Matrix4
4×4 matrica transformacije u svetskom prostoru.
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()
Izračunava osovinski poravnatu granicu (bounding box) ovog čvora i svih njegovih potomaka u svetskom prostoru.
getBoundingBox(): BoundingBoxBoundingBox
Osovinski poravnata granica (bounding box) koja obuhvata svu geometriju ispod ovog čvora.
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)
Spaja sadržaj drugog čvora (njegove entitete, materijale i podčvorove) u ovaj čvor i uklanja izvorni čvor iz scene.
```typescript
merge(node: Node): voidnode Node
Izvorni čvor čiji se sadržaj spaja u ovaj čvor.
void
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});
}