Как да обходим 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 (множество) предоставя пълния списък.

Мога ли да обхождам в широчинен ред вместо в дълбочинен?
Да. Използвайте опашка вместо рекурсивно извикване: поставете scene.rootNode в масив, след това shift‑нете и обработете възлите, като поставяте 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 мрежа програмно в TypeScript
• Ръководство за разработчици: Граф на сцената
• npm: @aspose/3d