Aspose.3D FOSS
TypeScript
Sprievodcovia riešením problémov

Sprievodcovia riešením problémov

Táto stránka pokrýva najčastejšie chyby, ktoré sa vyskytujú pri používaní @aspose/3d v projektoch TypeScript a Node.js, s vysvetleniami príčiny a overenými opravami.

Chyby riešenia modulov

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

Príčina: Stratégia riešenia modulov v TypeScripte nepodporuje exporty podcest v štýle Node.js (exports v package.json) pokiaľ moduleResolution je nastavené na node alebo node16.

Oprava: Nastavte moduleResolution na "node" vo vašom tsconfig.json:

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

Ak používate TypeScript 5.x s "module": "node16" alebo "module": "nodenext", použite "moduleResolution": "node16" na zhodu.

SyntaxError: Cannot use import statement in a module

Príčina: Kompilovaný JavaScript sa spúšťa s require() semantikou, ale výstup obsahuje ES modul import syntax; toto sa stane, keď module je nastavené na es2020 alebo esnext ale runtime Node.js očakáva CommonJS.

Oprava: Použiť "module": "commonjs" v tsconfig.json a spustite skompilované .js súbory s node priamo:

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

Potom skompilujte a spustite:

npx tsc
node dist/main.js

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

Príčina: Balík nie je nainštalovaný, alebo node_modules je zastaraný.

Oprava:

npm install @aspose/3d

Overte inštaláciu:

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

Prázdna scéna po načítaní

Scéna sa načíta, ale rootNode.childNodes je prázdna

Príčina (1): Formát súboru umiestňuje všetku geometriu priamo na rootNode.entity namiesto ako podriadené uzly. Toto je bežné u STL súborov s jedným meshom.

Diagnóza:

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

Oprava: Prechádzať od scene.rootNode samotného, nie len jeho potomkov:

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

Príčina (2): Cesta k súboru je nesprávna alebo súbor má nulovú veľkosť. Skontrolujte, či súbor existuje a nie je prázdny pred volaním 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}`);

Zoznam materiálov je po načítaní OBJ prázdny

Príčina: Načítanie materiálu je predvolene vypnuté v ObjLoadOptions. Knižnica načíta geometriu bez čítania .mtl doplnkový súbor.

Oprava: Nastaviť 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);

Tiež zabezpečte, aby .mtl súbor je v rovnakom adresári ako .obj súbor, pretože knižnica ho rieši relatívne k .obj ceste.

Formátové a I/O chyby

openFromBuffer vyhadzuje chybu neznámyho formátu

Príčina: Obsah vyrovnávacej pamäte nie je rozpoznateľný binárny formát alebo je vyrovnávacia pamäť poškodená (skrátená, nesprávne kódovanie alebo base64 namiesto surových bajtov).

Diagnóza:

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

Oprava: Pre textové formáty (OBJ, COLLADA) odovzdajte príslušnú triedu možností, aby ste naznačili formát:

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

Výstupný GLB sa v 3D prehliadačoch otvára ako JSON

Príčina: GltfSaveOptions.binaryMode predvolene na false, produkuje .gltf JSON výstup aj keď je názov výstupného súboru .glb.

Oprava: Explicitne nastaviť binaryMode = true:

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

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

Výstup STL neobsahuje žiadne údaje o farbe alebo materiáli v sliceri

Príčina: Formát STL nepodporuje materiály ani farbu v štandardnej špecifikácii. Slicery s podporou farieb používajú proprietárne rozšírenia, ktoré nie sú podporované @aspose/3d.

Oprava: Exportujte namiesto toho do formátu 3MF, ktorý podporuje farbu a metadáta materiálu:

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

Chyby kompilácie TypeScript

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

Príčina: Entity je základná trieda; Mesh je konkrétny typ s geometrickými vlastnosťami. Potrebujete instanceof ochranu pred prístupom k špecifickým členom siete.

Oprava:

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'

Príčina: getChildNode() vracia Node | null. TypeScript strict mode vyžaduje, aby ste ošetrili prípad null.

Opraviť:

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

Cannot find name 'GltfSaveOptions'

Príčina problému: GltfSaveOptions je v podceste modulu @aspose/3d/formats/gltf, nie v koreňovom balíku.

Oprava: Importovať z podcesty:

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

Problémy s pamäťou a výkonom

Proces vyčerpá pamäť pri veľkých súboroch FBX

Koreňová príčina: Veľmi veľké FBX súbory (>200 MB) alokujú značnú haldu. Predvolená halda Node.js je ~1.5 GB na 64-bitových systémoch, ale pre viacscénové súbory nemusí byť dostatočná.

Oprava: Zvýšte veľkosť haldy Node.js:

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

Tiež spracovávajte súbory sekvenčne namiesto paralelne, keď je pamäť obmedzená:

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
}

Pozri tiež

 Slovenčina