Com recórrer un gràfic de escena 3D en TypeScript

El graf de l’escena a Aspose.3D FOSS per a TypeScript és un arbre d’objectes Node amb arrel a scene.rootNode. El recorregut és recursiu: cada node exposa un iterable childNodes i una propietat opcional entity. Aquesta guia mostra com recórrer tot l’arbre, identificar els tipus d’entitat i recopilar estadístiques de malla.

Requisits previs

• Node.js 18 o posterior
• TypeScript 5.0 o posterior
• @aspose/3d instal·lat

Guia pas a 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>

Consells i bones pràctiques

• Comproveu sempre que no sigui nul node.entity abans d’accedir a les propietats específiques de l’entitat. Molts nodes són nodes de grup purs que no contenen cap entitat.
• Utilitzeu instanceof en comptes de constructor.name per a comprovacions de tipus en rutes lògiques. instanceof és segur per a refactoritzacions; la comparació de cadenes amb constructor.name es trenca amb la minificació.
• Recorreu via for...of en comptes de childNodes: l’iterable gestiona totes les mides d’array de manera segura. Eviteu l’indexació numèrica per a una compatibilitat futura.
• Eviteu mutar l’arbre durant el recorregut: no afegiu ni elimineu nodes dins de la crida recursiva. Recolliu els resultats primer, després modifiqueu.
• Passeu una matriu de resultats com a paràmetre: això evita assignar una nova matriu en cada crida recursiva i facilita la fusió dels resultats dels subarbres.

Problemes comuns

Preguntes freqüents

Porta scene.rootNode en si mateixa una entitat?
No. El node arrel és un contenidor creat automàticament per la biblioteca. No té cap entitat. La teva geometria i altres objectes de l’escena viuen en nodes fills un o més nivells per sota de rootNode.

Quina és la diferència entre node.entity i node.entities? node.entity conté l’entitat primària única (el cas comú). Alguns fitxers FBX i COLLADA més antics poden generar nodes amb diverses entitats adjuntes; en aquest cas node.entities (plural) proporciona la llista completa.

Puc recórrer en ordre d’amplada en lloc d’ordre de profunditat?
Sí. Utilitzeu una cua en lloc d’una crida recursiva: empenyeu scene.rootNode a una matriu, després desplaceu i processeu els nodes mentre empenyeu el childNodes de cada node al final de la cua.

És scene.open() sincrònic?
Sí. scene.open() i scene.openFromBuffer() bloquegen el fil d’execució que els crida fins que el fitxer estigui completament analitzat. Envolta’ls en un fil de treball si necessites mantenir el bucle d’esdeveniments responsiu.

Com puc obtenir posicions en l’espai mundial d’un node?
Llegeix node.globalTransform; retorna un GlobalTransform només de lectura amb la matriu en l’espai mundial, composta per totes les transformacions dels avantpassats. Per a càlculs explícits de matrius, crida node.evaluateGlobalTransform(false).

Quins tipus d’entitat són possibles a més de Mesh? Camera, Light i entitats personalitzades d’esquelet/os. Consulteu node.entity.constructor.name o utilitzeu instanceof amb la classe específica importada des de @aspose/3d.

Vegeu també

• Com carregar models 3D en TypeScript
• Com crear una malla 3D programàticament en TypeScript
• Guia del desenvolupador: gràfic d’escena
• npm: @aspose/3d