Aspose.3D FOSS
TypeScript
Vodiči za rješavanje problema

Vodiči za rješavanje problema

Ova stranica pokriva najčešće pogreške s kojima se susreću pri korištenju @aspose/3d u TypeScript i Node.js projektima, s objašnjenjima korijenskog uzroka i provjerenim rješenjima.

Greške u razrješavanju modula

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

Korijenski uzrok: Strategija razrješavanja modula u TypeScriptu ne podržava Node.js‑stil pod‑putnih izvoza (exports u package.json) osim ako moduleResolution je postavljeno na node ili node16.

Rješenje: Postavite moduleResolution na "node" u vašem tsconfig.json:

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

Ako koristite TypeScript 5.x s "module": "node16" ili "module": "nodenext", koristite "moduleResolution": "node16" za podudaranje.

SyntaxError: Cannot use import statement in a module

Uzrok: Kompilirani JavaScript se izvršava s require() semantikom, ali izlaz sadrži ES modul import sintaksom; ovo se događa kada module je postavljeno na es2020 ili esnext ali Node.js runtime očekuje CommonJS.

Ispravi: Koristi "module": "commonjs" u tsconfig.json i pokreni kompajlirane .js datoteke s node izravno:

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

Zatim kompilirajte i pokrenite:

npx tsc
node dist/main.js

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

Uzrok: Paket nije instaliran, ili node_modules je zastario.

Ispravi:

npm install @aspose/3d

Provjerite instalaciju:

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

Prazna scena nakon učitavanja

Scena se učitava, ali rootNode.childNodes je prazna

Uzrok (1):Format datoteke postavlja svu geometriju izravno na rootNode.entity umjesto kao podčvorove. To je uobičajeno kod single-mesh STL datoteka.

Dijagnoza:

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

Popravak: Prođite počevši od scene.rootNode : samog, a ne samo njegove podređene:

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

Uzrok (2): Putanja do datoteke je pogrešna ili je datoteka nula bajtova. Provjerite da datoteka postoji i da nije prazna prije poziva 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}`);

Popis materijala je prazan nakon učitavanja OBJ-a

Uzrok: Učitavanje materijala je prema zadanim postavkama onemogućeno u ObjLoadOptions. Biblioteka učitava geometriju bez čitanja .mtl prateće datoteke.

Ispravak: Postavi 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);

Također osigurajte da .mtl datoteka se nalazi u istom direktoriju kao .obj datoteka, jer biblioteka rješava putanju relativno na .obj putanju.

Greške formata i I/O

openFromBuffer baca pogrešku neprepoznatog formata

Uzrok: Sadržaj međuspremnika nije prepoznatljiv binarni format ili je međuspremnik oštećen (skraćen, pogrešno kodiranje ili base64 umjesto sirovih bajtova).

Dijagnoza:

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

Popravak: Za formate temeljene na tekstu (OBJ, COLLADA), proslijedite odgovarajuću klasu opcija kako biste naznačili format:

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

Izlazni GLB otvara se kao JSON u 3D preglednicima

Uzrok problema: GltfSaveOptions.binaryMode zadano je false, stvarajući .gltf JSON izlaz čak i kada je naziv izlazne datoteke .glb.

Popravak: Izričito postaviti binaryMode = true:

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

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

STL izlaz nema podatke o boji ili materijalu u sliceru

Uzrok problema: STL format ne podržava materijale ili boju u svojoj standardnoj specifikaciji. Sliceri koji podržavaju boju koriste vlasničke ekstenzije koje ne podržava by @aspose/3d.

Popravak: Izvezi u 3MF umjesto toga, koji podržava boju i metapodatke o materijalu:

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

TypeScript pogreške pri kompilaciji

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

Uzrok problema: Entity je osnovna klasa; Mesh je konkretni tip s geometrijskim svojstvima. Trebate instanceof zaštitu prije pristupa članovima specifičnim za mrežu.

Popravak:

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'

Uzrok problema: getChildNode() vraća Node | null. TypeScript strict mode zahtijeva da obradite slučaj s null vrijednošću.

Ispravi:

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

Cannot find name 'GltfSaveOptions'

Osnovni uzrok: GltfSaveOptions je u podputu modula @aspose/3d/formats/gltf, a ne u korijenu paketa.

Ispravak: Uvoz iz podputa:

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

Problemi s memorijom i performansama

Proces ostaje bez memorije pri velikim FBX datotekama

Uzrok: Vrlo velike FBX datoteke (>200 MB) zauzimaju značajnu memoriju na hrpi. Zadana veličina hrpe u Node.js je ~1,5 GB na 64‑bitnim sustavima, ali možda nije dovoljna za datoteke s više scena.

Ispravak: Povećajte veličinu hrpe Node.js-a:

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

Također obrađujte datoteke sekvencijalno, a ne paralelno kada je memorija ograničena:

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
}

Vidi također

 Hrvatski