Come attraversare un grafo di scena 3D in TypeScript

Il grafo della scena in Aspose.3D FOSS per TypeScript è un albero di Node oggetti radicato in scene.rootNode. L’attraversamento è ricorsivo: ogni nodo espone un iterabile childNodes e una proprietà opzionale entity. Questa guida mostra come percorrere l’intero albero, identificare i tipi di entità e raccogliere le statistiche della mesh.

Prerequisiti

• Node.js 18 o versioni successive
• TypeScript 5.0 o versioni successive
• @aspose/3d installato

Guida passo-passo

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>

Consigli e migliori pratiche

• Controlla sempre il valore null di node.entity prima di accedere alle proprietà specifiche dell’entità. Molti nodi sono nodi di gruppo puri che non contengono alcuna entità.
• Usa instanceof invece di constructor.name per i controlli di tipo nei percorsi logici. instanceof è sicuro durante il refactoring; il confronto di stringhe su constructor.name si rompe con la minificazione.
• Attraversa tramite for...of invece di childNodes: l’iterabile gestisce in modo sicuro tutte le dimensioni dell’array. Evita l’indicizzazione numerica per garantire la compatibilità futura.
• Evita di modificare l’albero durante l’attraversamento: non aggiungere o rimuovere nodi all’interno della chiamata ricorsiva. Raccogli prima i risultati, poi modifica.
• Passa un array di risultati come parametro: questo evita di allocare un nuovo array ad ogni chiamata ricorsiva e facilita l’unione dei risultati dei sottoalberi.

Problemi comuni

Domande Frequenti

scene.rootNode porta da sé un’entità?
No. Il nodo radice è un contenitore creato automaticamente dalla libreria. Non ha alcuna entità. La tua geometria e gli altri oggetti della scena vivono su nodi figli uno o più livelli sotto rootNode.

Qual è la differenza tra node.entity e node.entities?
node.entity contiene l’entità primaria singola (il caso più comune). Alcuni file FBX e COLLADA più vecchi possono generare nodi con più entità collegate; in tal caso node.entities (plurale) fornisce l’elenco completo.

Posso attraversare in ordine a larghezza anziché in ordine di profondità?
Sì. Usa una coda invece di una chiamata ricorsiva: push scene.rootNode in un array, poi shift e processa i nodi mentre push childNodes di ogni nodo nella coda.

È scene.open() sincrono?
Sì. scene.open() e scene.openFromBuffer() bloccano entrambi il thread chiamante fino a quando il file non è completamente analizzato. Avvolgili in un thread di lavoro se devi mantenere il ciclo di eventi reattivo.

Come ottengo le posizioni nello spazio mondiale da un nodo? Leggi node.globalTransform; restituisce un GlobalTransform di sola lettura con la matrice nello spazio mondiale, composta da tutte le trasformazioni dei genitori. Per calcoli espliciti di matrici, chiama node.evaluateGlobalTransform(false).

Quali tipi di entità sono possibili oltre Mesh?
Camera, Light e entità personalizzate di scheletro/osso. Controlla node.entity.constructor.name o usa instanceof con la classe specifica importata da @aspose/3d.

Vedi anche

• Come caricare modelli 3D in TypeScript
• Come creare una mesh 3D programmaticamente in TypeScript
• Guida per sviluppatori: Scene Graph
• npm: @aspose/3d