Как да обходим 3D граф на сцена в TypeScript

Сценичният граф в Aspose.3D FOSS за TypeScript е дърво от Node обекти, чиито корен е scene.rootNode. Обхождането е рекурсивно: всеки възел предоставя childNodes итеративен и незадължителен 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: итераторът обработва безопасно всички размери на масиви. Избягвайте числово индексиране за бъдеща съвместимост.
• Избягвайте модифицирането на дървото по време на обхождане: не добавяйте или премахвайте възли в рамките на рекурсивното извикване. Събирайте резултатите първо, след това модифицирайте.
• Подайте масив с резултати като параметър: това избягва създаването на нов масив при всяко рекурсивно извикване и улеснява сливането на резултатите от поддърветата.

Чести проблеми

Често задавани въпроси

Дали scene.rootNode само съдържа ли обект? Не. Кореновият възел е контейнер, създаден автоматично от библиотеката. Той няма обект. Вашата геометрия и други обекти от сцената се намират в дъщерни възли един или повече нива под него rootNode.

Каква е разликата между node.entity и node.entities? node.entity съдържа единствения основен обект (обичайният случай). Някои по-стари FBX и COLLADA файлове могат да създадат възли с множество прикрепени обекти; в такъв случай node.entities (множ. число) предоставя пълния списък.

Мога ли да обхождам в breadth‑first ред вместо в depth‑first? Да. Използвайте опашка вместо рекурсивно извикване: push scene.rootNode в масив, след това shift и обработвайте възлите, докато push‑вате всеки възел childNodes в края на опашката.

Е scene.open() синхронен? Да. scene.open() и scene.openFromBuffer() и двете блокират извикващата нишка, докато файлът не бъде напълно анализиран. Обвийте ги в работна нишка, ако трябва да запазите отзивчивостта на цикъла на събитията.

Как да получа позиции в световното пространство от възел? Прочетете node.globalTransform; връща само за четене GlobalTransform с матрица в световното пространство, съставена от всички трансформации на предците. За изрично матрично изчисление, извикайте node.evaluateGlobalTransform(false).

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

Вижте също

• Как да заредим 3D модели в TypeScript
• Как да създадем 3D мрежа (Mesh) програмно в TypeScript
• Ръководство за разработчици: Граф на сцената
• npm: @aspose/3d