Sådan traverserer du en 3D‑scengraf i TypeScript

Scenegrafen i Aspose.3D FOSS for TypeScript er et træ af Node‑objekter med roden i scene.rootNode. Traversering er rekursiv: hver node eksponerer en childNodes‑iterabel og en valgfri entity‑egenskab. Denne vejledning viser, hvordan man gennemløber 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

• Foretag altid null‑tjek node.entity før du får adgang til entitet‑specifikke egenskaber. Mange noder er rene gruppenoder, der ikke indeholder nogen entitet.
• Brug instanceof i stedet for constructor.name til typekontrol i logiske forløb. instanceof er refaktor‑sikker; strengsammenligning på constructor.name går i stykker ved minificering.
• Traversér via for...of i stedet for childNodes: den iterable håndterer alle array‑størrelser sikkert. Undgå numerisk indeksering for fremtidig kompatibilitet.
• Undgå at mutere træet under traversering: tilføj eller fjern ikke noder inde i det rekursive kald. Indsaml resultater først, og modificér derefter.
• Send et resultatarray som parameter: dette undgår at allokere et nyt array ved hvert rekursivt kald og gør det nemt at sammenlægge undertræ‑resultater.

Almindelige problemer

Ofte stillede spørgsmål

Bærer scene.rootNode selv en entity?
Nej. Rodnoden er en container, der oprettes automatisk af biblioteket. Den har ingen entity. Din geometri og andre scene‑objekter lever på undernoder et eller flere niveauer under rootNode.

Hvad er forskellen mellem node.entity og node.entities? node.entity indeholder den enkelte primære enhed (det almindelige tilfælde). Nogle ældre FBX- og COLLADA-filer kan producere noder med flere tilknyttede enheder; i så fald giver node.entities (flertal) den fulde liste.

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

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

Hvordan får jeg verdensrumpositioner fra en node? Læs node.globalTransform; den returnerer en skrivebeskyttet GlobalTransform med verdensrummatricen, sammensat af alle forfædres transformationer. For eksplicit matrixmatematik, kald node.evaluateGlobalTransform(false).

Hvilke entitetstyper er mulige udover Mesh?
Camera, Light og brugerdefinerede skelet/ben‑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 et 3D-mesh programmatisk i TypeScript
• Udviklerguide: Scene Graph
• npm: @aspose/3d