Πώς να διορθώσετε σφάλματα 3D μοντέλου σε TypeScript

Βήμα 1: Επαλήθευση εγκατάστασης και εκδόσεων

Βεβαιωθείτε ότι χρησιμοποιείτε μια υποστηριζόμενη έκδοση του Node.js (18, 20 ή 22) και ότι το πακέτο είναι εγκατεστημένο:

node --version          # Must be v18 or later
npm list @aspose/3d     # Should show the installed version

Αν το πακέτο δεν βρεθεί, επανεγκαταστήστε:

npm install @aspose/3d

Βήμα 2: Διόρθωση Σφαλμάτων Επίλυσης Μονάδας

Σφάλμα: Cannot find module '@aspose/3d/formats/obj'

Οι εισαγωγές υποδιαδρομής απαιτούν εξαγωγές πακέτου Node.js 12.7+. Στην TypeScript, ορίστε τη σωστή επίλυση μονάδας:

// tsconfig.json
{
  "compilerOptions": {
    "target": "ES2020",
    "module": "commonjs",
    "moduleResolution": "node16",
    "strict": true
  }
}

Για έργα ESM, χρησιμοποιήστε "module": "ES2022" και "moduleResolution": "bundler".

Βήμα 3: Ανίχνευση σφαλμάτων σε κενή σκηνή μετά τη φόρτωση

Αν scene.rootNode.childNodes είναι κενό μετά το scene.open():

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

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

console.log(`Child nodes: ${scene.rootNode.childNodes.length}`);

Κοινές αιτίες:

1. Λανθασμένες επιλογές μορφής: για OBJ, πάντα περάστε new ObjLoadOptions(). Η χρήση γενικών επιλογών μπορεί να εμποδίσει την ανίχνευση μορφής.

2. Η διαδρομή του αρχείου είναι λανθασμένη: η βιβλιοθήκη φορτώνει σιωπηρά μια κενή σκηνή εάν το αρχείο δεν βρεθεί:

import * as fs from 'fs';

const filePath = 'model.obj';
if (!fs.existsSync(filePath)) {
    throw new Error(`File not found: ${filePath}`);
}
const scene = new Scene();
scene.open(filePath, new ObjLoadOptions());

3. Το αρχείο OBJ χρησιμοποιεί μη τυπικές λήξεις γραμμών: ανοίξτε το σε έναν επεξεργαστή κειμένου και βεβαιωθείτε ότι το αρχείο είναι έγκυρο.

Βήμα 4: Διόρθωση προβλημάτων συστήματος συντεταγμένων

Τα μοντέλα ενδέχεται να εμφανίζονται περιστραμμένα, κατοπτρισμένα ή κλιμακωμένα λανθασμένα λόγω διαφορών στο σύστημα συντεταγμένων μεταξύ μορφών.

Δεξιόχειρο vs αριστερόχειρο, Y-up vs Z-up:

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

const options = new ObjLoadOptions();
options.flipCoordinateSystem = true;  // Swap Y and Z axes

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

Προβλήματα κλίμακας (π.χ., STL σε χιλιοστά vs glTF σε μέτρα):

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

const options = new ObjLoadOptions();
options.scale = 0.001;  // Convert millimeters to meters

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

Βήμα 5: Διαχείριση προβλημάτων μνήμης με μεγάλα αρχεία

Για αρχεία μεγαλύτερα από 100 MB, αυξήστε το μέγεθος της στοίβας Node.js:

node --max-old-space-size=4096 convert.js

Ή ορίστε το στο package.json:

{
  "scripts": {
    "convert": "node --max-old-space-size=4096 dist/convert.js"
  }
}

Επεξεργαστείτε μεγάλα αρχεία ένα προς ένα αντί για παράλληλη επεξεργασία, ώστε να αποφύγετε προβλήματα κορυφαίας μνήμης.