Aspose.3D FOSS
TypeScript
Οδηγοί Επίλυσης Προβλημάτων

Οδηγοί Επίλυσης Προβλημάτων

Αυτή η σελίδα καλύπτει τα πιο συχνά σφάλματα που προκύπτουν κατά τη χρήση @aspose/3d σε έργα TypeScript και Node.js, με εξηγήσεις της ρίζας του προβλήματος και επαληθευμένες διορθώσεις.

Σφάλματα Ανάλυσης Μονάδων

Error: Cannot find module '@aspose/3d/formats/obj'

Αιτία: Η στρατηγική επίλυσης μονάδων του TypeScript δεν υποστηρίζει εξαγωγές υπο-διαδρομών σε στυλ Node.js (exports σε package.json) εκτός εάν moduleResolution είναι ορισμένο σε node ή node16.

Διόρθωση: Ορίστε moduleResolution σε "node" στο tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node",
    "esModuleInterop": true,
    "strict": true
  }
}

Εάν χρησιμοποιείτε TypeScript 5.x με "module": "node16" ή "module": "nodenext", χρησιμοποιήστε "moduleResolution": "node16" για να ταιριάζει.

SyntaxError: Cannot use import statement in a module

Αιτία: Ο μεταγλωττισμένος JavaScript εκτελείται με require() σημασιολογία, αλλά η έξοδος περιέχει ES module import σύνταξη· αυτό συμβαίνει όταν module είναι ορισμένο σε es2020 ή esnext αλλά το runtime του Node.js αναμένει CommonJS.

Διόρθωση: Χρησιμοποιήστε "module": "commonjs" σε tsconfig.json και εκτελέστε το μεταγλωττισμένο .js αρχεία με node απευθείας:

{
  "compilerOptions": {
    "module": "commonjs",
    "outDir": "./dist"
  }
}

Στη συνέχεια, μεταγλωττίστε και εκτελέστε:

npx tsc
node dist/main.js

Error: Cannot find module '@aspose/3d'

Αιτία: Το πακέτο δεν είναι εγκατεστημένο ή node_modules είναι παλιό.

Διόρθωση:

npm install @aspose/3d

Επαληθεύστε την εγκατάσταση:

node -e "const { Scene } = require('@aspose/3d'); console.log('OK', new Scene().constructor.name);"

Κενή Σκηνή Μετά τη Φόρτωση

Η σκηνή φορτώνει αλλά rootNode.childNodes είναι κενή

Αιτία (1): Η μορφή αρχείου τοποθετεί όλη τη γεωμετρία απευθείας στο rootNode.entity αντί για κόμβους-παιδιά. Αυτό είναι κοινό σε αρχεία STL με ενιαίο πλέγμα.

Διάγνωση:

import { Scene, Mesh } from '@aspose/3d';

const scene = new Scene();
scene.open('model.stl');

// Check rootNode directly
if (scene.rootNode.entity) {
    console.log(`Root entity: ${scene.rootNode.entity.constructor.name}`);
}
console.log(`Child count: ${scene.rootNode.childNodes.length}`);

Διόρθωση: Διασχέστε ξεκινώντας από scene.rootNode : αυτού, όχι μόνο των παιδιών του:

function visit(node: any): void {
    if (node.entity instanceof Mesh) {
        const m = node.entity as Mesh;
        console.log(`Mesh: ${m.controlPoints.length} vertices`);
    }
    for (const child of node.childNodes) {
        visit(child);
    }
}
visit(scene.rootNode);

Αιτία (2): Η διαδρομή του αρχείου είναι λανθασμένη ή το αρχείο έχει μηδενικά byte. Ελέγξτε ότι το αρχείο υπάρχει και δεν είναι κενό πριν το καλέσετε open().

import * as fs from 'fs';

const path = 'model.obj';
if (!fs.existsSync(path)) throw new Error(`File not found: ${path}`);
const stat = fs.statSync(path);
if (stat.size === 0) throw new Error(`File is empty: ${path}`);

Η λίστα υλικών είναι κενή μετά τη φόρτωση OBJ

Αιτία: Η φόρτωση υλικού είναι απενεργοποιημένη εξ ορισμού στο ObjLoadOptions. Η βιβλιοθήκη φορτώνει τη γεωμετρία χωρίς να διαβάσει το .mtl αρχείο sidecar.

Διόρθωση: Ορίστε enableMaterials = true:

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

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

Επίσης βεβαιωθείτε ότι το .mtl αρχείο βρίσκεται στον ίδιο φάκελο με το .obj αρχείο, καθώς η βιβλιοθήκη το επιλύει σχετικά με το .obj μονοπάτι.

Σφάλματα Μορφής και I/O

openFromBuffer εμφανίζει σφάλμα μη αναγνωρισμένης μορφής

Αιτία: Το περιεχόμενο της ενδιάμεσης μνήμης δεν είναι αναγνωρίσιμη δυαδική μορφή, ή η ενδιάμεση μνήμη είναι κατεστραμμένη (κομμένη, λανθασμένη κωδικοποίηση ή base64 αντί για ακατέργαστα bytes).

Διάγνωση:

const buffer = fs.readFileSync('model.glb');
console.log('Buffer size:', buffer.length, 'bytes');
console.log('First 4 bytes (hex):', buffer.slice(0, 4).toString('hex'));
// GLB magic: 676c5446 ("glTF")
// STL binary starts with 80 bytes of header; no fixed magic
// OBJ is text: openFromBuffer may not detect format

Διόρθωση: Για μορφές κειμένου (OBJ, COLLADA), περάστε την κατάλληλη κλάση επιλογών για να υποδείξετε τη μορφή:

import { ObjLoadOptions } from '@aspose/3d/formats/obj';
scene.openFromBuffer(buffer, new ObjLoadOptions());

Το παραγόμενο GLB ανοίγει ως JSON σε προβολείς 3D

Βασική αιτία: GltfSaveOptions.binaryMode προεπιλογή είναι false, παράγοντας .gltf Έξοδος JSON ακόμη και όταν το όνομα αρχείου εξόδου είναι .glb.

Διόρθωση: Ορίστε ρητά binaryMode = true:

import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save('output.glb', opts);

Η έξοδος STL δεν περιέχει δεδομένα χρώματος ή υλικού στον slicer

Βασική αιτία: Η μορφή STL δεν υποστηρίζει υλικά ή χρώμα στην τυπική της προδιαγραφή. Τα slicers που υποστηρίζουν χρώμα χρησιμοποιούν ιδιόκτητες επεκτάσεις που δεν υποστηρίζονται από @aspose/3d.

Διόρθωση: Εξαγωγή σε 3MF αντί αυτού, το οποίο υποστηρίζει χρώμα και μεταδεδομένα υλικού:

scene.save('output.3mf');

Σφάλματα Συγκόμισης TypeScript

Property 'controlPoints' does not exist on type 'Entity'

Βασική αιτία: Entity είναι η βασική κλάση; Mesh είναι ο συγκεκριμένος τύπος με ιδιότητες γεωμετρίας. Χρειάζεστε ένα instanceof προστασία πριν την πρόσβαση σε μέλη ειδικά για το πλέγμα.

Διόρθωση:

import { Mesh } from '@aspose/3d';

if (node.entity instanceof Mesh) {
    const mesh = node.entity as Mesh;
    console.log(mesh.controlPoints.length);
}

Type 'null' is not assignable to type 'Node'

Βασική αιτία: getChildNode() επιστρέφει Node | null. Η αυστηρή λειτουργία του TypeScript απαιτεί να χειριστείτε την περίπτωση null.

Διόρθωση:

const child = node.getChildNode('wheel');
if (!child) throw new Error('Node "wheel" not found');
// child is now Node, not null

Cannot find name 'GltfSaveOptions'

Βασική αιτία: GltfSaveOptions είναι στο υπο-διαδρομή module @aspose/3d/formats/gltf, όχι στη ρίζα του πακέτου.

Διόρθωση: Εισαγωγή από την υπο-διαδρομή:

import { GltfSaveOptions } from '@aspose/3d/formats/gltf';

Θέματα Μνήμης και Απόδοσης

Η διαδικασία εξαντλεί τη μνήμη με μεγάλα αρχεία FBX

Βασική αιτία: Πολύ μεγάλα αρχεία FBX (>200 MB) καταλαμβάνουν σημαντικό heap. Η προεπιλεγμένη heap του Node.js είναι περίπου 1,5 GB σε 64‑bit συστήματα, αλλά μπορεί να μην είναι επαρκής για αρχεία πολλαπλών σκηνών.

Διόρθωση: Αύξηση του μεγέθους heap του Node.js:

node --max-old-space-size=8192 dist/convert.js

Επίσης, επεξεργαστείτε τα αρχεία διαδοχικά αντί για παράλληλα όταν η μνήμη είναι περιορισμένη:

for (const file of files) {
    const scene = new Scene();
    scene.open(file);
    scene.save(file.replace('.fbx', '.glb'));
    // scene goes out of scope; GC can reclaim
}

Δείτε επίσης

 Ελληνικά