Sådan traverserer du en 3D Scene Graph i TypeScript

Scenegrafen i Aspose.3D FOSS for TypeScript er et træ af Node objekter rodfæstet ved scene.rootNode. Traversering er rekursiv: hver node eksponerer en childNodes iterabel og en valgfri entity egenskab. Denne guide viser, hvordan man traverserer hele træet, identificerer entitetstyper og indsamler mesh-statistik.

Forudsætninger

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

Trin-for-trin 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 bedste praksis

• Kontroller altid for null node.entity før du får adgang til entitetsspecifikke egenskaber. Mange noder er rene gruppenoder, der ikke indeholder nogen entitet.
• Brug instanceof over constructor.name til typekontrol i logikstier. instanceof er refaktor-sikker; strengsammenligning på constructor.name går i stykker ved minificering.
• Traversér via for...of over childNodes: den itererbare håndterer alle array-størrelser sikkert. Undgå numerisk indeksering for fremadkompatibilitet.
• Undgå at mutere træet under traversering: tilføj eller fjern ikke noder inde i det rekursive kald. Saml resultater først, og modificér derefter.
• Videregiv et resultatarray som parameter: dette undgår at allokere et nyt array ved hvert rekursivt kald og gør det nemt at flette undertræresultater.

Almindelige problemer

Ofte stillede spørgsmål

Gør scene.rootNode bærer den selv en entitet? Nej. Rodnoden er en container, der oprettes automatisk af biblioteket. Den har ingen entitet. Din geometri og andre sceneobjekter lever på undernoder én eller flere niveauer nedenunder rootNode.

Hvad er forskellen mellem node.entity og node.entities? node.entity holder den eneste primære entitet (det almindelige tilfælde). Nogle ældre FBX- og COLLADA-filer kan producere noder med flere vedhæftede entiteter; i så fald node.entities (flertal) giver den fulde liste.

Kan jeg traversere i bredde-først rækkefølge i stedet for dybde-først? Ja. Brug en kø i stedet for et rekursivt kald: push scene.rootNode til en array, derefter forskyd og behandl noder, mens du skubber hver nodes childNodes til køens hale.

Er scene.open() synkron? Ja. scene.open() og scene.openFromBuffer() begge blokerer den kaldende tråd, indtil filen er fuldt analyseret. Pak dem ind i en worker-tråd, hvis du har brug for at holde event‑loopet responsivt.

Hvordan får jeg verdensrum‑positioner fra en node? Læs node.globalTransform; den returnerer en skrivebeskyttet GlobalTransform med verdensrum‑matricen, sammensat af alle forældre‑transformeringer. For eksplicit matrix‑matematik, kald node.evaluateGlobalTransform(false).

Hvilke entitetstyper er mulige udover Mesh? Camera, Light, og brugerdefinerede skelet-/knogle‑entiteter. Tjek node.entity.constructor.name eller brug instanceof med den specifikke klasse importeret fra @aspose/3d.

Se også

• Sådan indlæses 3D-modeller i TypeScript
• Sådan bygges en 3D‑mesh programmatisk i TypeScript
• Udviklerguide: Scene‑graf
• npm: @aspose/3d