Cara Melintasi Graf Adegan 3D dalam TypeScript

Graf adegan dalam Aspose.3D FOSS untuk TypeScript adalah pohon objek Node yang berakar pada scene.rootNode. Penelusuran bersifat rekursif: setiap node memperlihatkan iterable childNodes dan properti opsional entity. Panduan ini menunjukkan cara melintasi seluruh pohon, mengidentifikasi jenis entitas, dan mengumpulkan statistik mesh.

Prasyarat

• Node.js 18 atau yang lebih baru
• TypeScript 5.0 atau yang lebih baru
• @aspose/3d terpasang

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>

Tips dan Praktik Terbaik

• Selalu periksa null node.entity sebelum mengakses properti khusus entitas. Banyak node adalah node grup murni yang tidak membawa entitas.
• Gunakan instanceof daripada constructor.name untuk pemeriksaan tipe dalam jalur logika. instanceof aman untuk refaktor; perbandingan string pada constructor.name akan rusak dengan minifikasi.
• Lintasi melalui for...of pada childNodes: iterable menangani semua ukuran array dengan aman. Hindari pengindeksan numerik untuk kompatibilitas ke depan.
• Hindari mengubah pohon selama penelusuran: jangan menambahkan atau menghapus node di dalam panggilan rekursif. Kumpulkan hasil terlebih dahulu, kemudian modifikasi.
• Berikan array hasil sebagai parameter: ini menghindari alokasi array baru di setiap panggilan rekursif dan memudahkan penggabungan hasil subpohon.

Masalah Umum

Pertanyaan Umum

Apakah scene.rootNode sendiri membawa entitas? Tidak. Node root adalah wadah yang dibuat secara otomatis oleh pustaka. Node ini tidak memiliki entitas. Geometri Anda dan objek adegan lainnya berada pada node anak satu atau lebih level di bawah rootNode.

Apa perbedaan antara node.entity dan node.entities? node.entity menyimpan entitas utama tunggal (kasus umum). Beberapa file FBX dan COLLADA lama mungkin menghasilkan node dengan beberapa entitas yang dilampirkan; dalam kasus tersebut node.entities (jamak) menyediakan daftar lengkap.

Bisakah saya melintasi dalam urutan luas-pertama daripada kedalaman-pertama? Ya. Gunakan antrian daripada panggilan rekursif: push scene.rootNode ke dalam array, kemudian shift dan proses node sambil push setiap childNodes node ke ekor antrian.

Apakah scene.open() sinkron? Ya. scene.open() dan scene.openFromBuffer() keduanya memblokir thread pemanggil hingga file sepenuhnya diparsing. Bungkus keduanya dalam worker thread jika Anda perlu menjaga event loop tetap responsif.

Bagaimana cara mendapatkan posisi ruang dunia dari sebuah node? Baca node.globalTransform; ini mengembalikan GlobalTransform hanya-baca dengan matriks ruang dunia, yang terdiri dari semua transformasi ancestor. Untuk matematika matriks eksplisit, panggil node.evaluateGlobalTransform(false).

Jenis entitas apa yang mungkin selain Mesh? Camera, Light, dan entitas skeleton/tulang kustom. Periksa node.entity.constructor.name atau gunakan instanceof dengan kelas spesifik yang diimpor dari @aspose/3d.

Lihat Juga

• Cara Memuat Model 3D dalam TypeScript
• Cara Membangun Mesh 3D secara Programatik dalam TypeScript
• Panduan Pengembang: Graf Adegan
• npm: @aspose/3d