Як обходити 3D граф сцени у TypeScript

Граф сцени у Aspose.3D FOSS для TypeScript — це дерево, що складається з Node об’єктів, коренем яких є scene.rootNode. Обхід є рекурсивним: кожен вузол надає childNodes iterable та необов’язковий entity властивість. Цей посібник показує, як пройти все дерево, визначити типи сутностей і зібрати статистику сітки.

Передумови

• Node.js 18 або новіший
• TypeScript 5.0 або новіший
• @aspose/3d встановлено

Покроковий посібник

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>

Поради та найкращі практики

• Завжди перевіряйте на null node.entity перед доступом до властивостей, специфічних для сутності. Багато вузлів є чисто груповими вузлами, які не містять сутності.
• Використовуйте instanceof закінчено constructor.name для перевірок типу в логічних шляхах. instanceof є безпечним при рефакторингу; порівняння рядків на constructor.name порушується при мініфікації.
• Перебрати за допомогою for...of по childNodes: iterable безпечно обробляє всі розміри масивів. Уникайте числового індексування для забезпечення сумісності в майбутньому.
• Уникайте мутування дерева під час обходу: не додавайте та не видаляйте вузли всередині рекурсивного виклику. Спочатку зберіть результати, потім модифікуйте.
• Передайте масив результатів як параметр: це запобігає створенню нового масиву при кожному рекурсивному виклику і спрощує об’єднання результатів піддерев.

Типові проблеми

Часті запитання

Виконує scene.rootNode саме містить сутність? Ні. Кореневий вузол — це контейнер, створений бібліотекою автоматично. Він не має сутності. Ваша геометрія та інші об’єкти сцени розташовані у дочірніх вузлах на один або кілька рівнів нижче rootNode.

У чому різниця між node.entity і node.entities? node.entity містить єдину первинну сутність (зазвичай). Деякі старі файли FBX та COLLADA можуть створювати вузли з кількома приєднаними сутностями; у цьому випадку node.entities (множина) надає повний список.

Чи можу я обходити в порядку breadth‑first замість depth‑first? Так. Використовуйте чергу замість рекурсивного виклику: push scene.rootNode у масив, потім зсуваємо та обробляємо вузли, додаючи кожен вузол childNodes у кінець черги.

Чи scene.open() синхронний? Так. scene.open() і scene.openFromBuffer() обидва блокують викликаючий потік, доки файл повністю не буде проаналізовано. Обгорніть їх у worker thread, якщо потрібно, щоб event loop залишався чутливим.

Як отримати позиції у світовому просторі з вузла? Читати node.globalTransform; він повертає лише для читання GlobalTransform з world-space matrix, складеною з усіх трансформацій предків. Для явних matrix math викличте node.evaluateGlobalTransform(false).

Які типи сутностей можливі, крім Mesh? Camera, Light, і користувацькі скелет/кісткові сутності. Перевірте node.entity.constructor.name або використати instanceof з конкретним класом, імпортованим з @aspose/3d.

Див. також

• Як завантажити 3D‑моделі у TypeScript
• Як програмно створити 3D Mesh у TypeScript
• Посібник розробника: граф сцени
• npm: @aspose/3d