TypeScript में 3D सीन ग्राफ़ को कैसे ट्रैवर्स करें

Aspose.3D FOSS for 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>

सलाह और सर्वोत्तम प्रथाएँ

• Always null-check node.entity entity‑specific properties तक पहुँचने से पहले करें। कई नोड्स शुद्ध समूह नोड्स होते हैं जिनमें कोई entity नहीं होती।
• Use instanceof over constructor.name logic paths में type checks के लिए। instanceof refactor‑safe है; constructor.name पर string comparison मिनिफिकेशन से टूट जाता है।
• Traverse via for...of over childNodes: iterable सभी array आकारों को सुरक्षित रूप से संभालता है। आगे की संगतता के लिए numeric indexing से बचें।
• Avoid mutating the tree during traversal: recursive call के भीतर नोड्स को जोड़ें या हटाएँ नहीं। पहले परिणाम एकत्र करें, फिर संशोधित करें।
• Pass a results array as a parameter: इससे प्रत्येक recursive call पर नई array आवंटित करने से बचा जा सकता है और subtree परिणामों को मर्ज करना आसान हो जाता है।

सामान्य समस्याएँ

अक्सर पूछे जाने वाले प्रश्न

क्या scene.rootNode स्वयं में कोई इकाई रखता है?
नहीं। रूट नोड लाइब्रेरी द्वारा स्वचालित रूप से बनाया गया एक कंटेनर है। इसका कोई इकाई नहीं है। आपका ज्यामिति और अन्य सीन ऑब्जेक्ट्स एक या अधिक स्तर नीचे rootNode के चाइल्ड नोड्स पर स्थित होते हैं।

node.entity और node.entities के बीच क्या अंतर है?
node.entity एकल प्राथमिक इकाई रखता है (सामान्य मामला)। कुछ पुराने FBX और COLLADA फ़ाइलें कई संलग्न इकाइयों वाले नोड्स उत्पन्न कर सकती हैं; ऐसे में node.entities (बहुवचन) पूरी सूची प्रदान करता है।

क्या मैं गहराई‑प्रथम के बजाय चौड़ाई‑प्रथम क्रम में यात्रा कर सकता हूँ?
हाँ। पुनरावर्ती कॉल के बजाय एक कतार (queue) का उपयोग करें: scene.rootNode को एक एरे में पुश करें, फिर शिफ्ट करें और नोड्स को प्रोसेस करें जबकि प्रत्येक नोड के childNodes को कतार के टेल में पुश किया जाए।

क्या scene.open() सिंक्रोनस है? हाँ। scene.open() और scene.openFromBuffer() दोनों कॉलिंग थ्रेड को तब तक ब्लॉक कर देते हैं जब तक फ़ाइल पूरी तरह से पार्स नहीं हो जाती। यदि आपको इवेंट लूप को प्रतिक्रियाशील रखना है तो उन्हें एक वर्कर थ्रेड में रैप करें।

मैं नोड से world-space स्थितियां कैसे प्राप्त करूँ?
node.globalTransform पढ़ें; यह एक read‑only GlobalTransform लौटाता है जिसमें world-space मैट्रिक्स होता है, जो सभी पूर्वज ट्रांसफ़ॉर्म्स से निर्मित होता है। स्पष्ट मैट्रिक्स गणना के लिए, node.evaluateGlobalTransform(false) को कॉल करें।

Mesh के अलावा कौन से एंटिटी प्रकार संभव हैं?
Camera, Light, और कस्टम स्केलेटन/बोन एंटिटीज़। node.entity.constructor.name देखें या instanceof का उपयोग करें, जिसमें @aspose/3d से आयात किया गया विशिष्ट क्लास हो।

संबंधित देखें

• TypeScript में 3D मॉडल कैसे लोड करें
• TypeScript में प्रोग्रामेटिक रूप से 3D मेष कैसे बनाएं
• डेवलपर गाइड: सीन ग्राफ
• npm: @aspose/3d