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

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

Requisits

• 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 la nul·litat node.entity abans d’accedir a propietats específiques de l’entitat. Molts nodes són nodes de grup purs que no contenen cap entitat.
• Utilitzeu instanceof sobre constructor.name per a comprovacions de tipus en rutes lògiques. instanceof és segur per a refactoritzacions; comparació de cadenes a constructor.name es trenca amb la minificació.
• Recorre via for...of sobre childNodes: l’iterable gestiona totes les mides d’array de manera segura. Evita l’indexació numèrica per a una compatibilitat futura.
• Evita mutar l’arbre durant el recorregut: no afegeixis ni eliminis nodes dins la crida recursiva. Recull els resultats primer, després modifica.
• Passa un array de resultats com a paràmetre: això evita assignar un array nou en cada crida recursiva i facilita la fusió dels resultats del subarbre.

Problemes comuns

Preguntes freqüents

Fa scene.rootNode porta ell mateix una entitat? No. El node arrel és un contenidor creat automàticament per la biblioteca. No té cap entitat. La vostra geometria i altres objectes de l’escena viuen en nodes fills un o més nivells més avall 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 cada node’s childNodes al final de la cua.

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

Com puc obtenir les posicions en l’espai mundial d’un node? Llegeix node.globalTransform; retorna una només de lectura GlobalTransform amb la matriu d’espai mundial, composta a partir de 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 d’esquelet/os personalitzades. Comprova node.entity.constructor.name o utilitza instanceof amb la classe específica importada des de @aspose/3d.

Vegeu també

• Com carregar models 3D en TypeScript
• Com crear un Mesh 3D programàticament en TypeScript
• Guia del desenvolupador: Graf de l’escena
• npm: @aspose/3d