Kako preći 3D Scene Graph u TypeScript-u

Scenograf u Aspose.3D FOSS za TypeScript je drvo ‘Node’ objekata usmjerenih na ‘scene.rootNote’. Traversal je recursivna: svaki čvor izloži ‘childNodes’ iterabil i opcionalnu ’entity’ svojstvo.Ovaj vodič pokazuje kako hodati cijelo drvce, identificirati vrste entiteta, i prikupiti statistiku mesh.

Preduvjeti

• Node.js 18 ili kasnije
• Tipografski 5.0 ili noviji
• ‘@aspose/3d’ instalirano

Kratak korak vodič

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>

Savjeti i najbolje prakse

• Uvijek null-check ’node.entity’ prije pristupa entitet specifičnim svojstvima. mnogi čvorovi su čiste grupne čvore koje ne nose entiteta.
• Koristite ‘instanceof’ preko ‘constructor.name’ za tipove provjere u logskim putovima. ’ instanceoff’ je refactor-safe; red usporedba na ‘Constructors.nam’ prekida s minifikacijom.
• Prekrijte preko ‘za’ na ‘ChildNodes’: iterabilni upravlja svim veličinama rasporeda sigurno. izbjegavajte brojno indeksiranje za naprednu kompatibilnost.
• Izbjegavajte mutaciju drveta tijekom prolaza: ne dodajte ili uklanjajte čvorove unutar recursivnog poziva. Prvo prikupite rezultate, a zatim izmijenite.
• Prođite rezultatni red kao parametar: to izbjegava dodjelu novog redova na svakom ponovnom pozivu i olakšava spajanje rezultata poddrvnog drveta.

Zajednički problemi

Često postavljana pitanja

Ne. Korištenje korijena je kontejner koji automatski stvara knjižnica. nema entiteta. vaša geometrija i drugi objekti scene žive na dječjim čvorovima jedan ili više razina ispod ‘korištaja’.

Koja je razlika između ’node.entity’ i ‘Node-entities’? ’ node, entity` drži jedinstvenu primarnu entitet (običan slučaj). Neki stariji FBX i COLLADA datoteke mogu proizvesti čvorove s više povezanih entiteta; u tom slučaju ’noode (plural) pruža pun popis.

Da, koristite kutiju umjesto recursivnog poziva: pritisnite ‘scene.rootNode’ u redoslijed, a zatim promijenite i obrađujete čvorove dok priti ‘childNodes’ svakog čvora u kućni vrat.

‘scene.open()’ je sinhroniziran? da. scena.op() i `cene .openFromBuffer()’ oboje blokiraju pozivni vijek sve dok datoteka ne bude potpuno parsed.

Kako dobijem svjetsko-svemirske pozicije iz čvorova? pročitajte ’node.globalTransform’; vraća samo čitanje ‘GlobalTransforma’ s svjetskim prostorom, sastojom od svih predaka transformacija. za eksplicitnu matričnu matematiku nazovite ‘Node .evaluateGlobalna transforma (false)’.

Koje su vrste subjekata moguće osim ‘Mesh’? ‘Kamera’, ‘Light’ i prilagođene skeletonske/bone entitete. provjerite ’node.entity.constructor.name’ ili koristite `instanceof’ s određenom klasom uvezenom iz ‘@aspose/3d’.

Vidjeti također

• Kako preuzeti 3D modela u tipografiji
• Kako napraviti 3D Mesh programski u TypeScript-u
• Tagovi: Scene Graph
• Sljedeći članak: @aspose/3d