Jak procházet 3D scénový graf v TypeScriptu

Graf scény v Aspose.3D FOSS pro TypeScript je strom Node objektů s kořenem v scene.rootNode. Procházení je rekurzivní: každý uzel poskytuje childNodes iterable a volitelnou entity vlastnost. Tento průvodce ukazuje, jak projít celý strom, identifikovat typy entit a shromáždit statistiky mesh.

Požadavky

• Node.js 18 nebo novější
• TypeScript 5.0 nebo novější
• @aspose/3d nainstalováno

Průvodce krok za krokem

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 osvědčené postupy

• Vždy provádějte kontrolu null node.entity před přístupem k vlastnostem specifickým pro entitu. Mnoho uzlů jsou čisté skupinové uzly, které neobsahují žádnou entitu.
• Používejte instanceof místo constructor.name pro kontrolu typů v logických cestách. instanceof je bezpečný při refaktoringu; porovnání řetězců na constructor.name selže při minifikaci.
• Procházejte pomocí for...of místo childNodes: iterovatelný objekt bezpečně zvládá všechny velikosti polí. Vyhněte se číselnému indexování pro budoucí kompatibilitu.
• Vyhněte se mutaci stromu během procházení: nepřidávejte ani neodstraňujte uzly uvnitř rekurzivního volání. Nejprve shromážděte výsledky, pak upravte.
• Předávejte pole výsledků jako parametr: tím se zabrání alokaci nového pole při každém rekurzivním volání a usnadní se sloučení výsledků podstromů.

Časté problémy

Často kladené otázky

Nese scene.rootNode samotný entitu?
Ne. Kořenový uzel je kontejner vytvořený automaticky knihovnou. Nemá žádnou entitu. Vaše geometrie a další objekty scény jsou umístěny na podřízených uzlech o jednu nebo více úrovní níže než rootNode.

Jaký je rozdíl mezi node.entity a node.entities? node.entity obsahuje jedinou primární entitu (běžný případ). Některé starší soubory FBX a COLLADA mohou vytvářet uzly s více připojenými entitami; v takovém případě node.entities (množné číslo) poskytuje úplný seznam.

Mohu procházet v šířkovém pořadí místo hloubkového?
Ano. Použijte frontu místo rekurzivního volání: vložte scene.rootNode do pole, poté posuňte a zpracovávejte uzly při vkládání childNodes každého uzlu do konce fronty.

Je scene.open() synchronní? Ano. scene.open() a scene.openFromBuffer() blokují volající vlákno, dokud není soubor plně zpracován. Zabalte je do pracovního vlákna, pokud potřebujete udržet smyčku událostí responzivní.

Jak získám pozice ve světovém prostoru z uzlu? Přečtěte node.globalTransform; vrací jen pro čtení GlobalTransform s maticí ve světovém prostoru, složenou ze všech transformací předků. Pro explicitní maticové výpočty zavolejte node.evaluateGlobalTransform(false).

Jaké typy entit jsou možné kromě Mesh?
Camera, Light a vlastní entity kostry/kosti. Zkontrolujte node.entity.constructor.name nebo použijte instanceof se specifickou třídou importovanou z @aspose/3d.

Viz také

• Jak načíst 3D modely v TypeScriptu
• Jak programově vytvořit 3D síť v TypeScriptu
• Průvodce pro vývojáře: Scénový graf
• npm: @aspose/3d