Aspose.3D FOSS
TypeScript
Probleemoplossingsgidsen

Probleemoplossingsgidsen

Deze pagina behandelt de meest voorkomende fouten die optreden bij het gebruik van @aspose/3d in TypeScript- en Node.js-projecten, met verklaringen van de oorzaken en geverifieerde oplossingen.

Fouten bij module‑resolutie

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

Oorzaak: De module‑resolutie‑strategie van TypeScript ondersteunt geen Node.js‑stijl sub‑pad‑exports (exports in package.json) tenzij moduleResolution is ingesteld op node of node16.

Oplossing: Stel moduleResolution in op "node" in uw tsconfig.json:

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

Als je TypeScript 5.x gebruikt met "module": "node16" of "module": "nodenext", gebruik dan "moduleResolution": "node16" om te matchen.

SyntaxError: Cannot use import statement in a module

Root cause: De gecompileerde JavaScript wordt uitgevoerd met require()-semantiek, maar de output bevat ES-module import-syntaxis; dit gebeurt wanneer module is ingesteld op es2020 of esnext, maar de Node.js-runtime verwacht CommonJS.

Fix: Gebruik "module": "commonjs" in tsconfig.json en voer de gecompileerde .js‑bestanden direct uit met node:

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

Compileer en voer vervolgens uit:

npx tsc
node dist/main.js

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

Oorzaak: Het pakket is niet geïnstalleerd, of node_modules is verouderd.

Oplossing:

npm install @aspose/3d

Controleer de installatie:

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

Lege scène na laden

Scene laadt maar rootNode.childNodes is leeg

Oorzaak (1): Het bestandsformaat plaatst alle geometrie direct op rootNode.entity in plaats van als kindknooppunten. Dit komt vaak voor bij STL‑bestanden met één mesh.

Diagnose:

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

Fix: Doorloop beginnend bij scene.rootNode zelf, niet alleen de kinderen:

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

Root cause (2): Het bestandspad is onjuist of het bestand heeft nul bytes. Controleer of het bestand bestaat en niet leeg is voordat u open() aanroept.

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

Materialenlijst is leeg na OBJ-lading

Oorzaak: Materiaal laden is standaard uitgeschakeld in ObjLoadOptions. De bibliotheek laadt de geometrie zonder het .mtl sidecar‑bestand te lezen.

Fix: Stel enableMaterials = true in:

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

Zorg er ook voor dat het .mtl‑bestand zich in dezelfde map bevindt als het .obj‑bestand, aangezien de bibliotheek het oplost ten opzichte van het .obj‑pad.

Formaat- en I/O-fouten

openFromBuffer gooit een niet-herkende formaatfout

Oorzaak: De bufferinhoud is geen herkenbaar binair formaat, of de buffer is corrupt (afgekapt, verkeerde codering, of base64 in plaats van ruwe bytes).

Diagnose:

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

Oplossing: Voor tekstgebaseerde formaten (OBJ, COLLADA) moet u de juiste optiesklasse doorgeven om het formaat aan te geven:

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

Uitvoer GLB wordt geopend als JSON in 3D‑viewers

Oorzaak: GltfSaveOptions.binaryMode standaard naar false, produceert .gltf JSON‑uitvoer zelfs wanneer de uitvoerbestandsnaam .glb is.

Oplossing: Stel expliciet binaryMode = true in:

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

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

STL-uitvoer bevat geen kleur- of materiaalgegevens in de slicer

Root cause: Het STL-formaat ondersteunt geen materialen of kleur in de standaard specificatie. Kleurondersteunende slicers gebruiken propriëtaire extensies die niet worden ondersteund door @aspose/3d.

Fix: Exporteer naar 3MF in plaats daarvan, wat kleur- en materiaalmmetadata ondersteunt:

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

TypeScript‑compilatiefouten

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

Oorzaak: Entity is de basisklasse; Mesh is het concrete type met geometrie‑eigenschappen. Je hebt een instanceof guard nodig voordat je mesh‑specifieke leden benadert.

Oplossing:

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'

Oorzaak: getChildNode() returns Node | null. TypeScript strict mode vereist dat je het null‑geval afhandelt.

Oplossing:

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

Cannot find name 'GltfSaveOptions'

Oorzaak: GltfSaveOptions bevindt zich in de sub‑padmodule @aspose/3d/formats/gltf, niet de pakket‑root.

Fix: Importeer vanuit het subpad:

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

Geheugen- en prestatieproblemen

Proces raakt zonder geheugen bij grote FBX‑bestanden

Oorzaak: Zeer grote FBX-bestanden (>200 MB) reserveren een aanzienlijke heap. De standaardheap van Node.js is ~1,5 GB op 64‑bitsystemen, maar is mogelijk niet voldoende voor bestanden met meerdere scènes.

Oplossing: Verhoog de heapgrootte van Node.js:

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

Verwerk bestanden ook sequentieel in plaats van parallel wanneer het geheugen beperkt is:

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
}

Zie ook

 Nederlands