Aspose.3D FOSS
TypeScript
Felsökningsguider

Felsökningsguider

Den här sidan täcker de vanligaste felen som uppstår när man använder @aspose/3d i TypeScript- och Node.js-projekt, med förklaringar av grundorsaken och verifierade lösningar.

Fel vid modulupplösning

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

Grundorsak: TypeScripts modullösningsstrategi stöder inte Node.js-stilens sub‑path‑export (exports i package.json) om inte moduleResolution är inställt på node eller node16.

Lösning: Sätt moduleResolution till "node" i din tsconfig.json:

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

Om du använder TypeScript 5.x med "module": "node16" eller "module": "nodenext", använd "moduleResolution": "node16" för att matcha.

SyntaxError: Cannot use import statement in a module

Grundorsak: Den kompilerade JavaScript körs med require() semantik men utdata innehåller ES module import syntax; detta händer när module är inställd på es2020 eller esnext men Node.js-körningsmiljön förväntar sig CommonJS.

Åtgärd: Använd "module": "commonjs" i tsconfig.json och kör den kompilerade .js filerna med node direkt:

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

Kompilera och kör sedan:

npx tsc
node dist/main.js

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

Grundorsak: Paketet är inte installerat, eller node_modules är föråldrat.

Åtgärd:

npm install @aspose/3d

Verifiera installationen:

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

Tom scen efter inläsning

Scenen laddas men rootNode.childNodes är tom

Grundorsak (1): Filformatet placerar all geometri direkt på rootNode.entity istället för som barnnoder. Detta är vanligt med enkla mesh STL-filer.

Diagnos:

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}`);

Åtgärd: Traversera med start från scene.rootNode : sig själv, inte bara dess barn:

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

: Grundorsak (2): Filvägen är felaktig eller filen är noll byte. Kontrollera att filen finns och inte är tom innan du anropar 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}`);

Materiallistan är tom efter OBJ-inläsning

: Grundorsak: Materialladdning är inaktiverad som standard i ObjLoadOptions. Biblioteket laddar geometrin utan att läsa .mtl sidecar-fil.

Lösning: Ställ in 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);

Se också till att .mtl filen är i samma katalog som .obj fil, eftersom biblioteket löser den relativt till .obj sökväg.

Format- och I/O-fel

openFromBuffer kastar ett fel för okänt format

Grundorsak: Bufferinnehållet är inte ett igenkännbart binärt format, eller så är bufferten korrupt (avkortad, fel kodning, eller base64 istället för råa byte).

Diagnos:

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

Åtgärd: För textbaserade format (OBJ, COLLADA), skicka den lämpliga options‑klassen för att ge en ledtråd om formatet:

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

Utdata-GLB öppnas som JSON i 3D-visare

Grundorsak: GltfSaveOptions.binaryMode standardvärde är false, producerar .gltf JSON-utdata även när utdatafilnamnet är .glb.

Lösning: Ange explicit binaryMode = true:

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

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

STL-utdata har ingen färg- eller materialdata i slicern

Grundorsak: STL-formatet stöder inte material eller färg i sin standardspecifikation. Färgkapabla slicers använder proprietära tillägg som inte stöds av @aspose/3d.

Lösning: Exportera till 3MF istället, vilket stöder färg- och materialmetadata:

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

TypeScript-kompilationsfel

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

Grundorsak: Entity är basklassen; Mesh är den konkreta typen med geometriegenskaper. Du behöver en instanceof guard innan du får åtkomst till mesh-specifika medlemmar.

Lösning:

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'

Grundorsak: getChildNode() returnerar Node | null. TypeScript strict mode kräver att du hanterar null-fallet.

Åtgärda:

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

Cannot find name 'GltfSaveOptions'

Grundorsak: GltfSaveOptions är i underkatalogmodulen @aspose/3d/formats/gltf, inte paketets rot.

Åtgärda: Importera från underkatalogen:

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

Minnes- och prestandaproblem

Processen får slut på minne med stora FBX-filer

Grundorsak: Mycket stora FBX-filer (>200 MB) allokerar betydande heap. Node.js standardheap är ~1,5 GB på 64‑bitssystem men kan vara otillräcklig för filer med flera scener.

Åtgärda: Öka Node.js heap‑storleken:

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

Processa också filer sekventiellt istället för parallellt när minnet är begränsat:

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
}

Se även

 Svenska