Cum să parcurgi un grafic de scenă 3D în TypeScript

Graful de scenă în Aspose.3D FOSS pentru TypeScript este un arbore de obiecte Node cu rădăcina la scene.rootNode. Traversarea este recursivă: fiecare nod expune un iterabil childNodes și o proprietate opțională entity. Acest ghid arată cum să parcurgi întregul arbore, să identifici tipurile de entități și să colectezi statistici despre mesh-uri.

Cerințe preliminare

• Node.js 18 sau o versiune ulterioară
• TypeScript 5.0 sau o versiune ulterioară
• @aspose/3d instalat

Ghid pas cu pas

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>

Sfaturi și cele mai bune practici

• Verificați întotdeauna nulitatea node.entity înainte de a accesa proprietățile specifice entității. Multe noduri sunt noduri de grup pure care nu conțin nicio entitate.
• Utilizați instanceof în loc de constructor.name pentru verificări de tip în căile logice. instanceof este sigur la refactorizare; compararea șirurilor pe constructor.name se rupe la minificare.
• Parcurgeți prin for...of în loc de childNodes: iteratorul gestionează în siguranță toate dimensiunile de array. Evitați indexarea numerică pentru compatibilitate viitoare.
• Evitați modificarea arborelui în timpul parcurgerii: nu adăugați sau eliminați noduri în interiorul apelului recursiv. Colectați rezultatele mai întâi, apoi modificați.
• Transmiteți un tablou de rezultate ca parametru: aceasta evită alocarea unui nou tablou la fiecare apel recursiv și facilitează îmbinarea rezultatelor subarborelui.

Probleme comune

Întrebări frecvente

Are scene.rootNode în sine o entitate?
Nu. Nodul rădăcină este un container creat automat de bibliotecă. Nu are entitate. Geometria și alte obiecte ale scenei trăiesc pe noduri copil la unul sau mai multe niveluri sub rootNode.

Care este diferența dintre node.entity și node.entities?
node.entity conține entitatea principală unică (cazul obișnuit). Unele fișiere FBX și COLLADA mai vechi pot genera noduri cu mai multe entități atașate; în acest caz node.entities (plural) furnizează lista completă.

Pot să parcurg în ordine breadth-first în loc de depth-first?
Da. Folosește o coadă în loc de un apel recursiv: împinge scene.rootNode într-un array, apoi efectuează shift și procesează nodurile în timp ce împingi childNodes fiecărui nod în coada de la coadă.

Este scene.open() sincron?
Da. scene.open() și scene.openFromBuffer() blochează firul de execuție apelant până când fișierul este complet analizat. Înfășurați-le într-un fir de lucru dacă trebuie să mențineți bucla de evenimente receptivă.

Cum pot obține poziții în spațiul mondial de la un nod? Citește node.globalTransform; returnează un GlobalTransform numai în citire cu matricea în spațiul mondial, compusă din toate transformările strămoșilor. Pentru matematică explicită a matricelor, apelează node.evaluateGlobalTransform(false).

Ce tipuri de entități sunt posibile în afară de Mesh?
Camera, Light și entități personalizate de schelet/os. Verificați node.entity.constructor.name sau utilizați instanceof cu clasa specifică importată din @aspose/3d.

Vezi și

• Cum să încărcați modele 3D în TypeScript
• Cum să construiți un mesh 3D programatic în TypeScript
• Ghid pentru dezvoltatori: Scene Graph
• npm: @aspose/3d