Cara Menelusuri Graf Adegan 3D dalam TypeScript

Graf adegan dalam Aspose.3D FOSS untuk TypeScript adalah pokok objek Node yang berakar pada scene.rootNode. Penelusuran bersifat rekursif: setiap nod memperlihatkan iterable childNodes dan sifat pilihan entity. Panduan ini menunjukkan cara melintasi seluruh pokok, mengenal pasti jenis entiti, dan mengumpul statistik mesh.

Prasyarat

• Node.js 18 atau versi lebih baru
• TypeScript 5.0 atau versi lebih baru
• @aspose/3d dipasang

Panduan Langkah demi Langkah

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>

Petua dan Amalan Terbaik

• Sentiasa periksa null node.entity sebelum mengakses sifat khusus entiti. Banyak nod adalah nod kumpulan tulen yang tidak membawa entiti.
• Gunakan instanceof berbanding constructor.name untuk pemeriksaan jenis dalam laluan logik. instanceof selamat untuk refaktor; perbandingan rentetan pada constructor.name akan rosak dengan minifikasi.
• Lalui melalui for...of berbanding childNodes: iterable mengendalikan semua saiz tatasusunan dengan selamat. Elakkan penomboran indeks secara numerik untuk keserasian ke hadapan.
• Elakkan mengubah pokok semasa penelusuran: jangan menambah atau membuang nod dalam panggilan rekursif. Kumpulkan keputusan terlebih dahulu, kemudian ubah.
• Hantar satu tatasusunan keputusan sebagai parameter: ini mengelakkan peruntukan tatasusunan baru pada setiap panggilan rekursif dan memudahkan menggabungkan keputusan subpokok.

Isu Umum

Soalan Lazim

Adakah scene.rootNode itu sendiri membawa entiti?
Tidak. Nod akar ialah kontena yang dicipta secara automatik oleh perpustakaan. Ia tidak mempunyai entiti. Geometri anda dan objek‑objek adegan lain berada pada nod anak satu atau lebih tahap di bawah rootNode.

Apakah perbezaan antara node.entity dan node.entities?
node.entity menyimpan entiti utama tunggal (kes biasa). Beberapa fail FBX dan COLLADA lama mungkin menghasilkan nod dengan pelbagai entiti yang dilampirkan; dalam kes itu node.entities (jamak) menyediakan senarai penuh.

Bolehkah saya menelusuri dalam susunan lebar-pertama dan bukannya dalam susunan dalam-pertama?
Ya. Gunakan queue dan bukannya panggilan rekursif: push scene.rootNode ke dalam array, kemudian shift dan proses nod sambil push setiap childNodes nod ke ekor queue.

Adakah scene.open() segerak?
Ya. scene.open() dan scene.openFromBuffer() kedua-duanya menyekat thread pemanggil sehingga fail selesai diparse. Balutkan mereka dalam thread pekerja jika anda perlu mengekalkan gelung peristiwa responsif.

Bagaimana saya dapat kedudukan ruang-dunia dari nod?
Baca node.globalTransform; ia mengembalikan GlobalTransform yang hanya‑baca dengan matriks ruang-dunia, yang terdiri daripada semua transformasi nenek moyang. Untuk matematik matriks eksplisit, panggil node.evaluateGlobalTransform(false).

Apakah jenis entiti yang mungkin selain Mesh?
Camera, Light, dan entiti rangka/tulang khusus. Semak node.entity.constructor.name atau gunakan instanceof dengan kelas khusus yang diimport dari @aspose/3d.

Lihat Juga

• Cara Memuatkan Model 3D dalam TypeScript
• Cara Membina Mesh 3D secara Programatik dalam TypeScript
• Panduan Pembangun: Graf Adegan
• npm: @aspose/3d