Aspose.3D FOSS
TypeScript
Průvodci řešením problémů

Průvodci řešením problémů

Tato stránka popisuje nejčastější chyby, se kterými se setkáváte při používání @aspose/3d v projektech TypeScript a Node.js, s vysvětlením příčiny a ověřenými opravami.

Chyby při řešení modulů

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

Příčina: Strategie řešení modulů v TypeScriptu nepodporuje exporty podcest ve stylu Node.js (exports v package.json) pokud ne moduleResolution je nastaveno na node nebo node16.

Oprava: Nastavte moduleResolution na "node" ve vašem tsconfig.json:

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

Pokud používáte TypeScript 5.x s "module": "node16" nebo "module": "nodenext", použijte "moduleResolution": "node16" pro shodu.

SyntaxError: Cannot use import statement in a module

Kořenová příčina: Zkompilovaný JavaScript je spouštěn s require() semantikou, ale výstup obsahuje ES module import syntax; to se stane, když module je nastaveno na es2020 nebo esnext ale runtime Node.js očekává CommonJS.

Oprava: Použijte "module": "commonjs" v tsconfig.json a spusťte zkompilované .js soubory s node přímo:

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

Poté zkompilujte a spusťte:

npx tsc
node dist/main.js

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

Příčina: Balíček není nainstalován, nebo node_modules je zastaralý.

Oprava:

npm install @aspose/3d

Ověřte instalaci:

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

Prázdná scéna po načtení

Scéna se načte, ale rootNode.childNodes je prázdná

Příčina (1):Formát souboru umisťuje veškerou geometrii přímo na rootNode.entity místo jako podřízené uzly. To je běžné u souborů STL s jedním meshem.

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: Procházet od scene.rootNode : samotného, ne jen jeho potomků:

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

Kořenová příčina (2): Cesta k souboru je špatná nebo je soubor nulových bajtů. Zkontrolujte, že soubor existuje a není prázdný, před jeho volání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}`);

Seznam materiálů je po načtení OBJ prázdný

Kořenová příčina: Načítání materiálu je ve výchozím nastavení zakázáno v ObjLoadOptions. Knihovna načítá geometrii bez čtení .mtl doprovodného souboru.

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

Také zajistěte, aby .mtl soubor je ve stejném adresáři jako .obj soubor, protože knihovna jej řeší relativně k .obj cestě.

Chyby formátu a I/O

openFromBuffer vyvolá chybu neznámého formátu

Kořenová příčina: Obsah bufferu není rozpoznatelný binární formát, nebo je buffer poškozený (zkrácený, špatné kódování nebo base64 místo surových bajtů).

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: Pro textové formáty (OBJ, COLLADA) předávejte odpovídající třídu možností, aby naznačila formát:

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

Výstupní GLB se v 3D prohlížečích otevírá jako JSON

Kořenová příčina: GltfSaveOptions.binaryMode má výchozí hodnotu false, vytváří .gltf JSON výstup i když je název výstupního souboru .glb.

Oprava: Explicitně nastavit 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 žádná data o barvě ani materiálu ve sliceru

Kořenová příčina: Formát STL nepodporuje materiály ani barvu ve své standardní specifikaci. Slicery podporující barvy používají proprietární rozšíření, která nejsou podporována @aspose/3d.

Oprava: Exportujte místo toho do 3MF, který podporuje metadata o barvě a materiálu:

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

Chyby kompilace TypeScript

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

Kořenová příčina: Entity je základní třída; Mesh je konkrétní typ s geometrickými vlastnostmi. Potřebujete instanceof ochranu před přístupem k členům specifickým pro mesh.

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'

Kořenová příčina: getChildNode() vrací Node | null. Režim přísného TypeScriptu vyžaduje, abyste ošetřili případ null.

Opravit:

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

Cannot find name 'GltfSaveOptions'

Kořenová příčina: GltfSaveOptions se nachází v podcestě modulu @aspose/3d/formats/gltf, nikoli v kořeni balíčku.

Oprava: Import z podcesty:

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

Problémy s pamětí a výkonem

Proces dochází k nedostatku paměti u velkých souborů FBX

Kořenová příčina: Velmi velké soubory FBX (>200 MB) alokují značnou haldu. Výchozí halda Node.js je ~1,5 GB na 64‑bitových systémech, ale pro soubory s více scénami nemusí být dostatečná.

Oprava: Zvyšte velikost haldy Node.js:

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

Také zpracovávejte soubory sekvenčně místo paralelně, když je paměť omezená:

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
}

Viz také

 Čeština