Kuinka käydä läpi 3D-skenegraafi TypeScriptissä

Kohtausgrafi Aspose.3D FOSS for TypeScript -kirjastossa on puu Node-objekteista, jonka juuri on scene.rootNode. Traversointi on rekursiivista: jokainen solmu tarjoaa childNodes-iteroinnin ja valinnaisen entity-ominaisuuden. Tämä opas näyttää, miten käydään läpi koko puu, tunnistetaan entiteettityypit ja kerätään verkkojen tilastot.

Edellytykset

• Node.js 18 tai uudempi
• TypeScript 5.0 tai uudempi
• @aspose/3d asennettu

Vaiheittainen opas

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>

Vinkkejä ja parhaita käytäntöjä

• Tarkista aina null node.entity ennen kuin käytät entiteettiin liittyviä ominaisuuksia. Monet solmut ovat puhtaita ryhmäsolmuja, jotka eivät sisällä entiteettiä.
• Käytä instanceof sen sijaan, että käyttäisit constructor.name tyyppitarkistuksiin loogisissa poluissa. instanceof on refaktorointiturvallinen; merkkijonojen vertailu constructor.name:ssa rikkoutuu minifioinnissa.
• Kulje for...of:n kautta childNodes:n sijaan: iteroitava käsittelee kaikki taulukon koot turvallisesti. Vältä numeerista indeksointia tulevaisuuden yhteensopivuuden vuoksi.
• Vältä puun muokkaamista kulun aikana: älä lisää tai poista solmuja rekursiivisen kutsun sisällä. Kerää tulokset ensin, sitten muokkaa.
• Välitä tuloslista parametrina: tämä estää uuden taulukon varaamisen jokaisessa rekursiivisessa kutsussa ja tekee alipuiden tulosten yhdistämisestä helppoa.

Yleiset ongelmat

Usein kysytyt kysymykset

Sisältääkö scene.rootNode itse entiteetin?
Ei. Juurisolmu on kirjastoautomaatisesti luotu säiliö. Sillä ei ole entiteettiä. Geometriasi ja muut kohtausobjektit sijaitsevat lapsisolmuissa yhden tai useamman tason alapuolella rootNode.

Mikä on ero node.entity ja node.entities välillä? node.entity sisältää yhden ensisijaisen entiteetin (yleinen tapa). Jotkut vanhemmat FBX- ja COLLADA-tiedostot saattavat tuottaa solmuja, joissa on useita liitettyjä entiteettejä; siinä tapauksessa node.entities (monikko) tarjoaa koko luettelon.

Voinko kulkea leveyssuuntaisesti syvyysjärjestyksen sijaan? Kyllä. Käytä queuea rekursiivisen kutsun sijaan: push scene.rootNode arrayen, sitten shift ja käsittele solmut samalla kun push jokaisen solmun childNodes queue:n hännän.

Onko scene.open() synkroninen? Kyllä. scene.open() ja scene.openFromBuffer() estävät kutsuvan säikeen toiminnan, kunnes tiedosto on täysin jäsennetty. Kääri ne työntekijäsäikeeseen, jos sinun täytyy pitää tapahtumasilmukka reagoivana.

Miten saan maailmanavaruuden sijainnit solmusta?
Lue node.globalTransform; se palauttaa vain‑luku GlobalTransform, jossa on maailmanavaruuden matriisi, koostettuna kaikista esivanhempien muunnoksista. Jos haluat tehdä eksplisiittistä matriisilaskentaa, kutsu node.evaluateGlobalTransform(false).

Mitä entiteettityyppejä on mahdollista käyttää Meshn lisäksi?
Camera, Light ja mukautetut luuranko/luu‑entiteetit. Tarkista node.entity.constructor.name tai käytä instanceof yhdessä erityisen luokan kanssa, joka on tuotu @aspose/3dsta.

Katso myös

• Kuinka ladata 3D-malleja TypeScriptissä
• Kuinka rakentaa 3D-verkko ohjelmallisesti TypeScriptissä
• Kehittäjän opas: Scene Graph
• npm: @aspose/3d