چگونه یک گراف صحنه 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>

نکات و بهترین شیوه‌ها

• همیشه بررسی نال 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 استفاده کنید.

همچنین ببینید

• نحوه بارگذاری مدل‌های سه‌بعدی در TypeScript
• نحوه ساخت یک مش سه‌بعدی به‌صورت برنامه‌نویسی در TypeScript
• راهنمای توسعه‌دهنده: گراف صحنه
• npm: @aspose/3d