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 import Σύνταξη: Αυτό συμβαίνει όταν module Ορίζεται για es2020 ή esnext Αλλά ο χρόνος εκτέλεσης του 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 Είναι σταθερή.

ΦΙΛΕΞΗ:

asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.

Ελέγξτε την εγκατάσταση:

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

Απαλλαγή σκηνής μετά την φόρτιση

Η σκηνή χτυπάει, αλλά rootNode.childNodes Είναι άδειο

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

Διαγνωστική:

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): Η διαδρομή αρχείου είναι λάθος ή το αρχείο είναι μηδενικό bytes. ελέγξτε ότι το file υπάρχει και δεν είναι άδειο πριν καλέσετε 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 Σελίδα του ΕΣΔ.

ΦΙΛΕΞΗ:ΣΕΤΙΔΑ 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 Εξέτασε ένα μη αναγνωρισμένο σφάλμα μορφής

ρίζα αιτία: Το περιεχόμενο του buffer δεν είναι αναγνωρίσιμο δυαδικό μορφότυπο, ή το buffers είναι διαφθορά (σπάστη, λάθος κρυπτογράφηση, και base64 αντί για ξηρούς byte).

Διαγνωστική:

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 δεν έχει χρώμα ή υλικό δεδομένα στο σαλιζάρι

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

ΦΙΛΕΞΗ: Εξαγωγή στο 3MF αντί, το οποίο υποστηρίζει τα μεταδεδομένα χρώματος και υλικού:

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

Εξαιρετικά σφάλματα σύνταξης τύπου

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

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

ΦΙΛΕΞΗ:

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 αυστηρή απαιτεί να χειριστείτε το μηδενικό ζήτημα.

ΦΙΛΕΞΗ:

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 Στο υποδρόμιο του Μοντέλου @aspose/3d/formats/gltf,Όχι το ρίζα του πακέτου.

ΦΙΛΕΞΗ:Εισαγωγή από το υποδρόμιο:

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

Σχετικά με τη μνήμη και την απόδοση

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

ρίζα αιτία: Πολύ μεγάλα αρχεία FBX (>200 MB) κατατάσσουν σημαντική εμβέλεια. Node.js προεπιλεγμένη εβέλτιση είναι ~1.5 GB σε 64-bit συστήματα, αλλά μπορεί να μην αρκεί για τα πολυ-scene αρχείων.

ΦΙΛΕΞΗ:• Αυξήστε το μέγεθος του 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
}

Δείτε επίσης

 Ελληνικά