Hur man traverserar ett 3D‑scengraf i TypeScript

Scengrafen i Aspose.3D FOSS för TypeScript är ett träd av Node objekt med rot i scene.rootNode. Traversering är rekursiv: varje nod exponerar en childNodes itererbar och en valfri entity egenskap. Denna guide visar hur man traverserar hela trädet, identifierar entitetstyper och samlar mesh-statistik.

Förutsättningar

• Node.js 18 eller senare
• TypeScript 5.0 eller senare
• @aspose/3d installerad

Steg-för-steg-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 och bästa praxis

• Kontrollera alltid null node.entity innan du får åtkomst till entitetsspecifika egenskaper. Många noder är rena gruppnoder som inte har någon entitet.
• Använd instanceof över constructor.name för typkontroller i logikvägar. instanceof är refaktor-säker; strängjämförelse på constructor.name går sönder vid minifiering.
• Traversera via for...of över childNodes: den itererbara hanterar alla arraystorlekar säkert. Undvik numerisk indexering för framtida kompatibilitet.
• Undvik att mutera trädet under traversering: lägg inte till eller ta bort noder inom det rekursiva anropet. Samla resultat först, modifiera sedan.
• Skicka en resultatarray som parameter: detta undviker att allokera en ny array vid varje rekursivt anrop och gör det enkelt att slå ihop delträdresultat.

Vanliga problem

Vanliga frågor

Gör scene.rootNode bär den själv en entitet? Nej. Rotnoden är en behållare som skapas automatiskt av biblioteket. Den har ingen entitet. Din geometri och andra scenobjekt finns på barnnoder en eller flera nivåer nedanför rootNode.

Vad är skillnaden mellan node.entity och node.entities? node.entity innehåller den enda primära entiteten (det vanliga fallet). Vissa äldre FBX- och COLLADA-filer kan skapa noder med flera bifogade entiteter; i så fall node.entities (plural) ger den fullständiga listan.

Kan jag gå igenom i bredd-först-ordning istället för djup-först? Ja. Använd en kö istället för ett rekursivt anrop: push scene.rootNode till en array, sedan skifta och bearbeta noder medan varje nods childNodes in i kösvansen.

Är scene.open() synkron? Ja. scene.open() och scene.openFromBuffer() båda blockerar den anropande tråden tills filen är helt parsad. Packa in dem i en arbetstråd om du behöver hålla händelseslingan responsiv.

Hur får jag världsrumspositioner från en nod? Läs node.globalTransform; den returnerar en skrivskyddad GlobalTransform med världsrumsmatrisen, sammansatt från alla förfäders transformationer. För explicit matrisberäkning, anropa node.evaluateGlobalTransform(false).

Vilka entitetstyper är möjliga förutom Mesh? Camera, Light, och anpassade skelett-/benentiteter. Kontrollera node.entity.constructor.name eller använd instanceof med den specifika klassen importerad från @aspose/3d.

Se även

• How to Load 3D Models in TypeScript
• Hur man bygger ett 3D-mesh programatiskt i TypeScript
• Utvecklarguide: Scengraf
• npm: @aspose/3d