Πώς να διασχίσετε ένα 3D γράφημα σκηνής σε TypeScript

Το γράφημα σκηνής στο 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>

Συμβουλές και βέλτιστες πρακτικές

• Πάντα ελέγχετε για 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 (πληθυντικός) παρέχει τη πλήρη λίστα.

Μπορώ να διασχίσω με σειρά κατά πλάτος αντί για βάθος;
Ναι. Χρησιμοποιήστε μια queue αντί για μια recursive call: push scene.rootNode σε ένα array, μετά shift και process nodes ενώ push το childNodes του κάθε node στην queue tail.

Είναι το 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