Hvordan traversere en 3D-scengraf i TypeScript

Scenegrafen i Aspose.3D FOSS for TypeScript er et tre av Node‑objekter med roten scene.rootNode. Traversering er rekursiv: hver node eksponerer en childNodes‑iterabel og en valgfri entity‑egenskap. Denne guiden viser hvordan du går gjennom hele treet, identifiserer entitetstyper og samler inn mesh‑statistikk.

Forutsetninger

• Node.js 18 eller nyere
• TypeScript 5.0 eller nyere
• @aspose/3d installert

Trinn-for-trinn guide

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 og beste praksis

• Alltid null‑sjekk node.entity før du får tilgang til entitetsspesifikke egenskaper. Mange noder er rene gruppenoder som ikke har noen entitet.
• Bruk instanceof over constructor.name for typekontroller i logiske veier. instanceof er refaktor‑sikker; strengsammenligning på constructor.name bryter ved minifisering.
• Traverser via for...of over childNodes: den iterable håndterer alle array‑størrelser trygt. Unngå numerisk indeksering for fremtidig kompatibilitet.
• Unngå å mutere treet under traversering: ikke legg til eller fjern noder inne i det rekursive kallet. Samle resultater først, deretter endre.
• Pass en resultarray som parameter: dette unngår å allokere en ny array ved hvert rekursivt kall og gjør det enkelt å slå sammen deltreresultater.

Vanlige problemer

Ofte stilte spørsmål

Bærer scene.rootNode selv en enhet?
Nei. Rotnoden er en beholder som opprettes automatisk av biblioteket. Den har ingen enhet. Geometrien din og andre scenobjekter ligger på undernoder ett eller flere nivåer under rootNode.

Hva er forskjellen mellom node.entity og node.entities? node.entity inneholder den eneste primære enheten (det vanlige tilfellet). Noen eldre FBX- og COLLADA-filer kan generere noder med flere tilknyttede enheter; i så fall gir node.entities (flertall) den fullstendige listen.

Kan jeg traversere i breadth-first rekkefølge i stedet for depth-first?
Ja. Bruk en queue i stedet for en recursive call: push scene.rootNode inn i en array, så shift og prosesser noder mens du push hver nodes childNodes inn i queue‑tail.

Er scene.open() synkron? Ja. scene.open() og scene.openFromBuffer() blokkerer begge den påkallende tråden til filen er fullstendig analysert. Pakk dem inn i en arbeidstråd hvis du trenger å holde hendelsesløkken responsiv.

Hvordan får jeg verdensromsposisjoner fra en node?
Les node.globalTransform; den returnerer en skrivebeskyttet GlobalTransform med verdensromsmatrisen, sammensatt fra alle foreldertransformasjoner. For eksplisitt matrisematematikk, kall node.evaluateGlobalTransform(false).

Hvilke entitetstyper er mulige i tillegg til Mesh?
Camera, Light, og egendefinerte skjelett-/bein‑entiteter. Sjekk node.entity.constructor.name eller bruk instanceof med den spesifikke klassen importert fra @aspose/3d.

Se også

• Slik laster du 3D-modeller i TypeScript
• Slik bygger du et 3D-mesh programmatisk i TypeScript
• Utviklerguide: Scenegraph
• npm: @aspose/3d