Aspose.3D FOSS
TypeScript
מדריכי פתרון בעיות

מדריכי פתרון בעיות

דף זה מכסה את השגיאות הנפוצות ביותר שנפגשות בעת השימוש ב @aspose/3d בפרויקטים של TypeScript ו‑Node.js, עם הסברים על root-cause ותיקונים מאומתים.

שגיאות פתרון מודול

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 היא מיושנת.

תיקון:

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): נתיב הקובץ שגוי או שהקובץ בגודל אפס בתים. בדוק שהקובץ קיים ולא ריק לפני הקריאה 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 הנתיב.

שגיאות פורמט וקלט/פלט

openFromBuffer זורק שגיאת פורמט לא מוכרת

סיבת השורש: תוכן החוצץ אינו בפורמט בינארי מזוהה, או שהחוצץ פגום (קצוץ, קידוד שגוי, או base64 במקום בתים גולמיים).

אבחון:

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');

שגיאות הידור ב‑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 נמצא במודול תת‑נתיב @aspose/3d/formats/gltf, ולא בשורש החבילה.

תיקון: ייבא מתת‑הנתיב:

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

בעיות בזיכרון ובביצועים

התהליך נגמר מזיכרון עם קבצי FBX גדולים

סיבת השורש: קבצי FBX גדולים מאוד (>200 MB) מקצים ערמת זיכרון משמעותית. ערמת ברירת המחדל של Node.js היא כ‑1.5 GB במערכות 64‑ביט, אך ייתכן שהיא לא מספיקה לקבצים עם מספר סצנות.

תיקון: הגדל את גודל ערמת ה‑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
}

ראה גם

 עברית