Hoe een 3D‑scènegraph te doorlopen in TypeScript

De scene graph in Aspose.3D FOSS voor TypeScript is een boom van Node objecten met scene.rootNode als wortel. Traversal is recursief: elke node exposeert een childNodes iterable en een optionele entity property. Deze gids laat zien hoe je de volledige boom doorloopt, entiteitstypen identificeert en mesh‑statistieken verzamelt.

Voorvereisten

• Node.js 18 of hoger
• TypeScript 5.0 of hoger
• @aspose/3d geïnstalleerd

Stapsgewijze handleiding

npm install @aspose/3d

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { Mesh } from '@aspose/3d/entities';

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

console.log(`Root node: "${scene.rootNode.name}"`);
console.log(`Top-level children: ${scene.rootNode.childNodes.length}`);

function traverse(node: any, depth = 0): void {
    const indent = '  '.repeat(depth);
    const entityType = node.entity ? node.entity.constructor.name : '-';
    console.log(`${indent}[${entityType}] ${node.name}`);
    for (const child of node.childNodes) {
        traverse(child, depth + 1);
    }
}

traverse(scene.rootNode);

[-] RootNode
  [Mesh] Cube

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

import { Mesh } from '@aspose/3d/entities';

function visitWithTypeCheck(node: any, depth = 0): void {
    const indent = '  '.repeat(depth);
    if (node.entity instanceof Mesh) {
        const mesh = node.entity as Mesh;
        console.log(`${indent}MESH "${node.name}": ${mesh.controlPoints.length} vertices`);
    } else if (node.entity) {
        console.log(`${indent}${node.entity.constructor.name} "${node.name}"`);
    } else {
        console.log(`${indent}GROUP "${node.name}"`);
    }
    for (const child of node.childNodes) {
        visitWithTypeCheck(child, depth + 1);
    }
}

visitWithTypeCheck(scene.rootNode);

import { Mesh } from '@aspose/3d/entities';

function collectMeshes(
    node: any,
    results: Array<{ name: string; mesh: Mesh }> = []
): Array<{ name: string; mesh: Mesh }> {
    if (node.entity instanceof Mesh) {
        results.push({ name: node.name, mesh: node.entity as Mesh });
    }
    for (const child of node.childNodes) {
        collectMeshes(child, results);
    }
    return results;
}

const meshNodes = collectMeshes(scene.rootNode);
console.log(`Found ${meshNodes.length} mesh node(s)`);

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';
import { Mesh } from '@aspose/3d/entities';

function collectMeshes(node: any, results: Array<{name: string, mesh: Mesh}> = []) {
    if (node.entity instanceof Mesh) {
        results.push({ name: node.name, mesh: node.entity as Mesh });
    }
    for (const child of node.childNodes) {
        collectMeshes(child, results);
    }
    return results;
}

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

const meshes = collectMeshes(scene.rootNode);
for (const { name, mesh } of meshes) {
    console.log(`${name}: ${mesh.controlPoints.length} vertices, ${mesh.polygonCount} polygons`);
}

Cube: 8 vertices, 6 polygons
Sphere: 482 vertices, 480 polygons

<div class="copy-icon group-[.copied]/copybtn:hx-hidden hx-pointer-events-none hx-h-4 hx-w-4"></div>
<div class="success-icon hx-hidden group-[.copied]/copybtn:hx-block hx-pointer-events-none hx-h-4 hx-w-4"></div>

Tips en Best Practices

• Controleer altijd op null node.entity voordat u entiteit‑specifieke eigenschappen benadert. Veel knooppunten zijn zuivere groepsknooppunten die geen entiteit dragen.
• Gebruik instanceof in plaats van constructor.name voor typecontroles in logische paden. instanceof is refactor‑veilig; tekenreeksvergelijking op constructor.name breekt bij minificatie.
• Traverseer via for...of in plaats van childNodes: de iterable behandelt alle arraygroottes veilig. Vermijd numerieke indexering voor toekomstige compatibiliteit.
• Vermijd het muteren van de boom tijdens traverseren: voeg geen knooppunten toe of verwijder ze niet binnen de recursieve oproep. Verzamel eerst de resultaten, wijzig daarna.
• Geef een resultatenarray als parameter door: dit voorkomt het toewijzen van een nieuwe array bij elke recursieve oproep en maakt het eenvoudig om subboomresultaten samen te voegen.

Veelvoorkomende problemen

Veelgestelde vragen

Draagt scene.rootNode zelf een entiteit? Nee. Het root‑knooppunt is een container die automatisch door de bibliotheek wordt aangemaakt. Het heeft geen entiteit. Uw geometrie en andere scène‑objecten bevinden zich op kind‑knooppunten één of meer niveaus onder rootNode.

Wat is het verschil tussen node.entity en node.entities?
node.entity bevat de enkele primaire entiteit (het gebruikelijke geval). Sommige oudere FBX- en COLLADA‑bestanden kunnen knooppunten produceren met meerdere gekoppelde entiteiten; in dat geval biedt node.entities (meervoud) de volledige lijst.

Kan ik in breedte‑eerst volgorde traverseren in plaats van diepte‑eerst?
Ja. Gebruik een queue in plaats van een recursieve aanroep: push scene.rootNode in een array, verschuif vervolgens en verwerk knooppunten terwijl je elke knooppunt‑childNodes naar de queue‑tail pusht.

Is scene.open() synchroon? Ja. scene.open() en scene.openFromBuffer() blokkeren beide de aanroepende thread totdat het bestand volledig is geparseerd. Plaats ze in een worker thread als je de event loop responsief wilt houden.

Hoe krijg ik wereldruimteposities van een knooppunt?
Lees node.globalTransform; het retourneert een alleen‑lezen GlobalTransform met de wereldruimtematrix, samengesteld uit alle vooroudertransformaties. Voor expliciete matrixberekeningen, roep node.evaluateGlobalTransform(false) aan.

Welke entiteitstypen zijn mogelijk naast Mesh?
Camera, Light, en aangepaste skelet/bot‑entiteiten. Controleer node.entity.constructor.name of gebruik instanceof met de specifieke klasse geïmporteerd uit @aspose/3d.

Zie ook

• Hoe 3D-modellen te laden in TypeScript
• Hoe een 3D-mesh programmatisch te bouwen in TypeScript
• Ontwikkelaarsgids: Scene Graph
• npm: @aspose/3d