Ako prechádzať 3D graf scény v TypeScript

Scénový graf v Aspose.3D FOSS pre TypeScript je stromom Node objektov zakorenených v scene.rootNode. Prechádzanie je rekurzívne: každý uzol poskytuje childNodes iterovateľný a voliteľný entity vlastnosť. Tento sprievodca ukazuje, ako prejsť celý strom, identifikovať typy entít a zhromaždiť štatistiky mesh.

Požiadavky

• Node.js 18 alebo novší
• TypeScript 5.0 alebo novší
• @aspose/3d nainštalovaný

Postupný návod

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>

Tipy a osvedčené postupy

• Vždy kontrolujte null node.entity pred prístupom k špecifickým vlastnostiam entity. Mnoho uzlov sú čisté skupinové uzly, ktoré neobsahujú žiadnu entitu.
• Použite instanceof namiesto constructor.name pre kontrolu typov v logických vetvách. instanceof je bezpečný pri refaktorovaní; porovnanie reťazcov na constructor.name sa rozbije pri minifikácii.
• Prechádzať cez for...of nad childNodes: iterovateľný objekt bezpečne spracováva všetky veľkosti poľa. Vyhnite sa číselnému indexovaniu pre budúcu kompatibilitu.
• Vyhnite sa modifikácii stromu počas prechádzania: nepridávajte ani neodstraňujte uzly v rámci rekurzívneho volania. Najprv zozbierajte výsledky, potom ich upravte.
• Predajte pole výsledkov ako parameter: tým sa zabráni alokácii nového poľa pri každom rekurzívnom volaní a uľahčuje zlučovanie výsledkov podstromov.

Bežné problémy

Často kladené otázky

Robí scene.rootNode sám nesie entitu? Nie. Korenový uzol je kontajner vytvorený automaticky knižnicou. Nemá žiadnu entitu. Vaša geometria a ďalšie objekty scény sa nachádzajú na podriadených uzloch jeden alebo viac úrovní nižšie. rootNode.

Aký je rozdiel medzi node.entity a node.entities? node.entity obsahuje jedinú primárnu entitu (bežný prípad). Niektoré staršie súbory FBX a COLLADA môžu vytvárať uzly s viacerými pripojenými entitami; v takom prípade node.entities (množné číslo) poskytuje úplný zoznam.

Môžem prechádzať v poradí šírkového prehľadávania namiesto hĺbkového? Áno. Použite frontu namiesto rekurzívneho volania: push scene.rootNode do poľa, potom posunúť a spracovať uzly pri vkladaní každého uzla childNodes do konca fronty.

Je scene.open() synchrónny? Áno. scene.open() a scene.openFromBuffer() oba blokujú volajúce vlákno, kým nie je súbor úplne spracovaný. Zabaľte ich do pracovného vlákna, ak potrebujete, aby slučka udalostí zostala responzívna.

Ako získať pozície vo svetovom priestore z uzla? Čítať node.globalTransform; vráti len na čítanie GlobalTransform s maticou vo svetovom priestore, zostavenou zo všetkých transformácií predkov. Pre explicitné maticové výpočty zavolajte node.evaluateGlobalTransform(false).

Aké typy entít sú možné okrem Mesh? Camera, Light, a vlastných entít kostry/kosti. Skontrolujte node.entity.constructor.name alebo použite instanceof s konkrétnou triedou importovanou z @aspose/3d.

Pozri tiež

• How to Load 3D Models in TypeScript
• Ako programovo zostaviť 3D Mesh v TypeScript
• Vývojárska príručka: Scénový graf
• npm: @aspose/3d