Πώς να φορτώσετε 3D μοντέλα σε TypeScript

Το @aspose/3d πακέτο παρέχει στις εφαρμογές TypeScript και Node.js ένα απλό API για το άνοιγμα αρχείων 3D σκηνών. Το Scene είναι το αντικείμενο ρίζας: καλέστε το scene.open() με διαδρομή αρχείου και προαιρετικές επιλογές φόρτωσης ειδικές για τη μορφή, στη συνέχεια περιηγηθείτε στο scene.rootNode για πρόσβαση στη γεωμετρία, τα υλικά και τους μετασχηματισμούς.

Οδηγός βήμα προς βήμα

npm install @aspose/3d

##tsconfig.json: minimum required settings
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "strict": true
  }
}

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

import { GltfLoadOptions } from '@aspose/3d/formats/gltf';
import { FbxLoadOptions } from '@aspose/3d/formats/fbx';
import { StlLoadOptions } from '@aspose/3d/formats/stl';

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
const options = new ObjLoadOptions();
options.enableMaterials = true;

scene.open('model.obj', options);
console.log('Scene loaded successfully');

import * as fs from 'fs';
import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const buffer = fs.readFileSync('model.obj');
const scene = new Scene();
scene.openFromBuffer(buffer, new ObjLoadOptions());

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

function visitNode(node: any, depth: number = 0): void {
    const indent = '  '.repeat(depth);
    console.log(`${indent}Node: ${node.name}`);
    if (node.entity) {
        console.log(`${indent}  Entity type: ${node.entity.constructor.name}`);
    }
    for (const child of node.childNodes) {
        visitNode(child, depth + 1);
    }
}

visitNode(scene.rootNode);

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const scene = new Scene();
scene.open('model.obj', new ObjLoadOptions());

for (const node of scene.rootNode.childNodes) {
    if (!node.entity) continue;
    const entity = node.entity;
    // Check if the entity is a Mesh by duck-typing controlPoints
    if ('controlPoints' in entity) {
        const mesh = entity as any;
        console.log(`Mesh "${node.name}": ${mesh.controlPoints.length} vertices`);
        // Print first three vertices
        for (let i = 0; i < Math.min(3, mesh.controlPoints.length); i++) {
            const v = mesh.controlPoints[i];
            console.log(`  v[${i}]: x=${v.x.toFixed(4)}, y=${v.y.toFixed(4)}, z=${v.z.toFixed(4)}`);
        }
    }
}

import { Scene } from '@aspose/3d';
import { ObjLoadOptions } from '@aspose/3d/formats/obj';

const options = new ObjLoadOptions();
options.enableMaterials = true;   // parse .mtl file if present

const scene = new Scene();
scene.open('model.obj', options);

// Inspect materials attached to nodes
for (const node of scene.rootNode.childNodes) {
    if (node.material) {
        console.log(`Material on "${node.name}": ${node.material.constructor.name}`);
    }
}

Κοινά προβλήματα και διορθώσεις

Σφάλμα: Δεν είναι δυνατή η εύρεση του module ‘@aspose/3d/formats/obj’
Οι υπο-διαδρομές μορφής απαιτούν εξαγωγές πακέτου Node.js 12.7+. Βεβαιωθείτε ότι χρησιμοποιείτε Node.js 18 ή νεότερο. Εάν χρησιμοποιείτε TypeScript, ορίστε "moduleResolution": "node16" ή "bundler" στο tsconfig.json.

scene.rootNode.childNodes είναι κενό μετά το open()
Ορισμένα αρχεία OBJ χρησιμοποιούν μη‑τυπικά τέλη γραμμής ή λείπουν το τελικό newline. Επαληθεύστε ότι το αρχείο είναι έγκυρο OBJ ανοίγοντάς το σε έναν επεξεργαστή κειμένου. Επίσης, βεβαιωθείτε ότι περάσατε ObjLoadOptions και όχι ένα γενικό LoadOptions: οι επιλογές ειδικές για τη μορφή απαιτούνται για τη σωστή διανομή.

controlPoints array has zero length
Το πλέγμα μπορεί να έχει φορτωθεί αλλά δεν περιέχει γεωμετρία (π.χ., μια κενή ομάδα στο OBJ). Χρησιμοποιήστε mesh.polygonCount για να ελέγξετε πριν διασχίσετε τις κορυφές.

Η χρήση μνήμης είναι υψηλή για μεγάλα αρχεία
Η φόρτωση από buffer με scene.openFromBuffer() δεν μειώνει τη μέγιστη μνήμη: πρέπει να αναλυθεί ολόκληρο το αρχείο. Για μεγάλα αρχεία (> 100 MB), βεβαιωθείτε ότι η διαδικασία Node.js σας διαθέτει επαρκή heap: node --max-old-space-size=4096 yourScript.js.

Σφάλματα τύπου: ’entity’ είναι τύπου ‘unknown’
Η ιδιότητα entity είναι ευρέως τυποποιημένη. Κάντε μετατροπή σε any ή σε συγκεκριμένη κλάση (Mesh, Camera, κ.λπ.) ανάλογα με το τι αναμένετε στη σκηνή σας.

Συχνές ερωτήσεις (FAQ)

Ποιοι μορφότυποι μπορούν να φορτωθούν με scene.open();
OBJ, glTF 2.0 (.gltf + .bin), GLB, STL, 3MF, FBX και COLLADA (.dae) υποστηρίζονται όλα για εισαγωγή. Περνάτε την αντίστοιχη *LoadOptions κλάση για κάθε μορφότυπο.

Μπορώ να φορτώσω ένα αρχείο χωρίς να καθορίσω επιλογές;
Ναι. scene.open('model.glb') λειτουργεί χωρίς επιλογές για μορφές που δεν απαιτούν ειδική διαμόρφωση. Η παροχή επιλογών συνιστάται για OBJ επειδή η ανάλυση του υλικού εξαρτάται από enableMaterials.

Τρέχει η φόρτωση ασύγχρονα;
Όχι. scene.open() και scene.openFromBuffer() είναι συγχρονισμένα. Τυλίξτε τα σε νήμα εργασίας ή setImmediate εάν χρειάζεται να διατηρήσετε έναν βρόχο γεγονότων ανταποκρινόμενο.

Υποστηρίζεται η εξαγωγή OBJ;
Ναι. Η εξαγωγή OBJ υποστηρίζεται μέσω scene.save('output.obj'). Το αρχείο υλικού .mtl γράφεται αυτόματα μαζί με το αρχείο .obj.

Πού αναμένεται το αρχείο .mtl κατά τη φόρτωση του OBJ; Από προεπιλογή, ο parser αναζητά το αρχείο .mtl που αναφέρεται μέσα στο OBJ (οδηγία mtllib) σχετικά με τον φάκελο του αρχείου OBJ. Βεβαιωθείτε ότι και τα δύο αρχεία βρίσκονται στον ίδιο φάκελο.

Δείτε επίσης

• Πώς να εξάγετε 3D σκηνές σε glTF/GLB με TypeScript
• Αναφορά API: Scene
• Αναφορά API: ObjLoadOptions
• npm: @aspose/3d