Kaip perkelti 3D sceno grafiją TypeScript

Sceno grafikas Aspose.3D FOSS TypeScript yra medžio Node Objektas, įsikūręs scene.rootNode.Kelionė yra pakartotinė: kiekvienas mazgas atskleidžia childNodes Neįtikėtina ir pasirinktinė entity Šis vadovas rodo, kaip vaikščioti visą medį, nustatyti subjektų tipus ir rinkti mesh statistiką.

Priešpriešiniai reikalavimai

• Node.js 18 arba vėliau
• TipScript 5.0 arba vėliau
• @aspose/3d Įdiegta

Žingsnis po žingsnio vadovėlis

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>

Patarimai ir geriausios praktikos

• Visada nulinis tikrinimas node.entity daugelis mazgų yra grynos grupės mazgai, kurie nešioja jokią subjektą.
• Naudojimas instanceof per viršų constructor.name Įrodymai, kaip tikrinti loginius kelius. instanceof yra refaktorius-saugus; srauto palyginimas constructor.name Sumažėja su miniatiūriniais.
• Perėjimas per for...of per viršų childNodes: neterabilus tvarko visus grandinės dydžius saugiai. vengti numerinio indeksavimo, kad būtų galima suderinti priekinį ryšį.
• Venkite medžio perėjimo metu:• Nenaudokite arba nepašalinkite mazgų per atkūrimo skambučius. pirmiausia surinkti rezultatus, tada keisti.
• Paspauskite rezultatus kaip parametrą:Tai vengia kiekvieno atkuriamojo skambučio naujo rato paskirstymo ir palengvina substrato rezultatų derinimą.

Bendros problemos

Dažnai užduodami klausimai

Arba scene.rootNode Ar pati turi subjektą? Ne. Šaknis yra konteineris, kurį automatiškai sukūrė biblioteka. neturi subjekto. Jūsų geometrija ir kiti scenos objektai gyvena ant vaiko mazgų viename ar daugiau lygių žemiau rootNode.

Koks skirtumas tarp node.entity ir node.entities? node.entity kai kurie vyresni FBX ir COLLADA failai gali gaminti mazgas su keliomis prijungtomis subjektais; šiuo atveju node.entities (Plural) pateikia visą sąrašą.

Ar galiu peržengti plačiajuosčio pirmuoju tvarka, o ne giliuojuosius? Naudokite švirkštą vietoj atnaujinimo skambučio: spauskite scene.rootNode į eilę, tada perkelti ir apdoroti mazgas, o kiekvieno mazgo slėpimas childNodes Į kišenę į kištuką.

yra scene.open() Ar tai sinchroninė? Taip ir. scene.open() ir scene.openFromBuffer() Abu blokuoja skambučių juostą, kol failas yra visiškai išdžiovintas. Įpilkite juos į darbininkų juostoje, jei reikia palaikyti renginio ratas atsiliepimą.

Kaip aš gaunu pasaulinės erdvės pozicijas iš mazgo? Skaityti → node.globalTransform;Jis grąžina tik skaitymo GlobalTransform su pasaulio-templiu matrizu, sudaryta iš visų protėvių transformacijų. node.evaluateGlobalTransform(false).

Kokios rūšies subjektai yra įmanomi be Mesh? Camera, Light, ir pritaikytos skeletonų / kaulų subjektų. patikrinti node.entity.constructor.name arba naudojimas instanceof Į importuojamą klasę įtraukiama specialios klasės. @aspose/3d.

Taip pat žiūrėkite

• Kaip įkrovti 3D modelius TypeScript
• Kaip sukurti 3D Mesh programuojamai TypeScript
• Parengėjas: Scene Graph
• NPM: @aspose / 3d