Aspose.3D FOSS
TypeScript
Fejlfindingsvejledninger

Fejlfindingsvejledninger

Denne side dækker de mest almindelige fejl, der opstår ved brug af @aspose/3d i TypeScript- og Node.js-projekter, med forklaringer på årsagerne og verificerede rettelser.

Modulopløsningsfejl

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

Root cause: TypeScripts modulopløsningsstrategi understøtter ikke Node.js‑stil sub‑path‑eksport (exports i package.json), medmindre moduleResolution er sat til node eller node16.

Rettelse: Sæt moduleResolution til "node" i din tsconfig.json:

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

Hvis du bruger TypeScript 5.x med "module": "node16" eller "module": "nodenext", skal du bruge "moduleResolution": "node16" for at matche.

SyntaxError: Cannot use import statement in a module

Root cause: Den kompilerede JavaScript køres med require() semantik, men outputtet indeholder ES-modul import syntaks; dette sker, når module er indstillet til es2020 eller esnext, men Node.js-runtime forventer CommonJS.

Fix: Brug "module": "commonjs" i tsconfig.json og kør de kompilerede .js filer med node direkte:

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

Kompilér derefter og kør:

npx tsc
node dist/main.js

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

Årsag: Pakken er ikke installeret, eller node_modules er forældet.

Rettelse:

npm install @aspose/3d

Bekræft installationen:

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

Tom scene efter indlæsning

Scenen indlæses, men rootNode.childNodes er tom

Årsag (1): Filformatet placerer al geometri direkte på rootNode.entity i stedet for som underordnede noder. Dette er almindeligt for enkelt-mesh STL-filer.

Diagnosis:

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

Rettelse: Traversér startende fra scene.rootNode selv, ikke kun dets børn:

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

Årsag (2): Filstien er forkert, eller filen er nul bytes. Kontroller, at filen findes, og at den ikke er tom, før du kalder 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}`);

Materialelisten er tom efter OBJ-indlæsning

Årsag: Materialindlæsning er deaktiveret som standard i ObjLoadOptions. Biblioteket indlæser geometrien uden at læse .mtl sidecar-filen.

Rettelse: Indstil 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);

Sørg også for, at .mtl-filen er i samme mappe som .obj-filen, da biblioteket løser den i forhold til .obj-stien.

Format- og I/O-fejl

openFromBuffer kaster en ikke-genkendt formatfejl

Årsag: Bufferindholdet er ikke i et genkendeligt binært format, eller bufferet er korrupt (afkortet, forkert kodning eller base64 i stedet for rå bytes).

Diagnosis:

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

Rettelse: For tekstbaserede formater (OBJ, COLLADA) skal du videregive den relevante options‑klasse for at angive formatet:

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

Output GLB åbnes som JSON i 3D‑fremvisere

Årsag: GltfSaveOptions.binaryMode har standardværdien false, hvilket producerer .gltf JSON-output selv når outputfilnavnet er .glb.

Rettelse: Angiv eksplicit binaryMode = true:

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

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

STL-output har ingen farve- eller materialedata i sliceren

Årsag: STL-formatet understøtter ikke materialer eller farve i sin standardspecifikation. Farveunderstøttende slicere bruger proprietære udvidelser, som ikke understøttes af @aspose/3d.

Fix: Eksporter til 3MF i stedet, som understøtter farve- og materialmetadata:

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

TypeScript-kompilationsfejl

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

Årsag: Entity er grundklassen; Mesh er den konkrete type med geometrieegenskaber. Du har brug for en instanceof-vagt, før du får adgang til mesh‑specifikke medlemmer.

Rettelse:

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'

Årsag: getChildNode() returnerer Node | null. TypeScript strict mode kræver, at du håndterer null‑tilfældet.

Rettelse:

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

Cannot find name 'GltfSaveOptions'

Årsag: GltfSaveOptions er i understi-modulet @aspose/3d/formats/gltf, ikke i pakkens rod.

Fix: Importér fra understien:

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

Hukommelses- og ydeevneproblemer

Processen løber tør for hukommelse med store FBX-filer

Årsag: Meget store FBX-filer (>200 MB) allokerer en betydelig heap. Node.js standard heap er ~1.5 GB på 64-bit systemer, men kan muligvis ikke være tilstrækkelig for filer med flere scener.

Løsning: Øg Node.js heap‑størrelsen:

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

Behandl også filer sekventielt i stedet for parallelt, når hukommelsen er begrænset:

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 også

 Dansk