Class Node
Paket: @aspose/3d (v24.12.0)
Node representerar ett namngivet element i scengrafens hierarki. Varje nod har en lokal transformation, kan innehålla barnnoder och bär noll eller fler Entity objekt såsom meshar, kameror eller ljus.
export class Node extends SceneObjectImageRenderOptions
A3DObject ← SceneObject ← Node
ImageRenderOptions
Skapa en föräldranod, fäst två barnnoder på den och traversera hela hierarkin efter namn.
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
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
name | string | Namnet på denna nod. Används för att identifiera noden inom scengrafen. |
parentNode | `Node | null` |
childNodes | Node[] | En array av direkta barnnoder som är fästa vid denna nod. |
entities | Entity[] | Listan över enheter (meshar, kameror, ljus osv.) som är fästa vid denna nod. |
materials | Material[] | Listan över material som är associerade med denna nod. |
transform | Transform | Den lokala transformationen för denna nod, med translation: Vector3, rotation: Quaternion, och scaling: Vector3 komponenter. |
globalTransform | GlobalTransform | Skrivskyddad. Världsrymdstransformationen, beräknad genom att multiplicera alla förfäders transformationer upp till roten. |
visible | boolean | Om denna nod och dess underträd renderas. Standard är true. |
excluded | boolean | ImageRenderOptions true, noden och dess underträd exkluderas från export. Standard är false. |
entity | `Entity | undefined` |
ImageRenderOptions
addChildNode(node)
Lägger till en befintlig Node instance som ett direkt barn till den här noden.
addChildNode(node: Node): voidImageRenderOptions
node Node
Noden som ska fästas. Noden omplaceras från sin nuvarande förälder till denna nod.
ImageRenderOptions
void
ImageRenderOptions
import { Scene, Node } from '@aspose/3d';
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?)
Skapar en ny Node, valfritt med ett namn, en entity, och ett material, och lägger till den som ett barn till den här noden.
createChildNode(name?: string, entity?: Entity, material?: Material): NodeImageRenderOptions
name string (valfritt)
Namnet för den nya barnnoden.
entity Entity (valfritt)
En entity att fästa på den nya noden, till exempel en Mesh instance.
material Material (valfritt)
Ett material att associera med den nya noden.
ImageRenderOptions
Node
Den nyss skapade barnnoden.
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)
Beräknar och returnerar transformationsmatrisen i världsrummet för den här noden. Skicka true för att inkludera den geometriska transformoffseten som lagras på noden (används av vissa FBX-exportörer).
evaluateGlobalTransform(withGeometricTransform: boolean): Matrix4ImageRenderOptions
withGeometricTransform boolean
ImageRenderOptions true, inkluderar den geometriska transformen i resultatet.
ImageRenderOptions
Matrix4
Den 4×4 transformationsmatrisen i världsrummet.
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()
Beräknar den axeljusterade begränsningsboxen för denna nod och alla dess underordnade i världsrummet.
getBoundingBox(): BoundingBoxImageRenderOptions
BoundingBox
Den axeljusterade begränsningsboxen som omsluter all geometri under denna nod.
ImageRenderOptions
import { Scene } from '@aspose/3d';
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)
Slår samman innehållet från en annan nod (dess enheter, material och barn) med denna nod och tar bort källnoden från scenen.
merge(node: Node): voidImageRenderOptions
node Node
Källnod vars innehåll slås samman med i denna nod.
ImageRenderOptions
void
ImageRenderOptions
import { Scene } from '@aspose/3d';
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}`);
}