Aspose.3D FOSS
TypeScript
Příručky k řešení problémů

Příručky k řešení problémů

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

Chyby při rozlišení modulu

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

Příčina:: Strategie řešení modulů TypeScript nepodporuje export podcestu ve stylu Node.js (exports v . package.json) s výjimkou případů, kdy: moduleResolution je nastaven na: node nebo: node16.

Opravy:Sestava: moduleResolution na … "node" ve své 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žití "moduleResolution": "node16" aby se shodovala.

SyntaxError: Cannot use import statement in a module

Příčina::Kompilovaný JavaScript je spuštěn pomocí: require() Semantika, ale výstup obsahuje ES modul. import syntaxe; to se stane, když module je nastaven na: es2020 nebo: esnext ale runtime Node.js očekává CommonJS.

Opravy:Použití: "module": "commonjs" v . tsconfig.json a spustí sestavené .js soubory s node přímo:

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

Pak kompilovat a spustit:

npx tsc
node dist/main.js

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

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

Opravy:

asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.

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 je plná, ale… rootNode.childNodes je prázdný.

Základní příčina (1):Formát souboru umisťuje celou geometrii přímo na: rootNode.entity Je to běžné u souborů STL s jedním mečem.

Diagnostika:

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

Opravy: Přechodní od: scene.rootNode sama sebe, nejen své děti:

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

Základní příčina (2): Směrnice souboru je špatná nebo soubor má nulové bajty. Před voláním zkontrolujte, zda soubory existují a nejsou prázdné 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ý.

Příčina:: V případě, že je v systému nastavení zařízení vyřazeno: ObjLoadOptions.Knihovna načte geometrii bez přečtení . .mtl Soubor náklaďáků.

Opravy:Sestava: 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);

Rovněž zajistit, aby se v rámci .mtl soubor je ve stejném adresáři jako .obj soubor, jak knihovna řeší ve vztahu ke .obj cesta.

Zpráva o formátu a I/O chybách

openFromBuffer vypustí nepoznatelný chybový formát

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

Diagnostika:

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

Opravy: U textových formátů (OBJ, COLLADA) přejděte příslušnou třídu možností k uvedení formátu:

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

Výstup GLB se otevírá jako JSON v 3D zobrazení

Příčina:: GltfSaveOptions.binaryMode Způsoby, které jsou v rozporu s false, produkce .gltf Výstup JSON i když je výstupní název souboru: .glb.

Opravy: výslovně stanoveno binaryMode = true:

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

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

Výstup STL nemá v řezítku žádné údaje o barvě nebo materiálu.

Příčina::Formát STL nepodporuje materiály ani barvy ve své standardní specifikaci. Barvově schopné řezače používají vlastnické rozšíření, které nejsou podporovány formátem STl. @aspose/3d.

Opravy: Export na 3MF, který podporuje barvové a materiální metadatá:

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

Chyby při kompilaci typografu

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

Příčina:: Entity je základní třída; Mesh je betónový typ s geometrickými vlastnostmi. Potřebujete instanceof před přístupem k specifickým členům sítě.

Opravy:

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'

Příčina:: getChildNode() výnosy Node | null. TypScript přísný režim vyžaduje, abyste zvládli nulový případ.

Opravy:

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

Cannot find name 'GltfSaveOptions'

Příčina:: GltfSaveOptions je v podcestu. @aspose/3d/formats/gltf, ne kořen balíčku.

Opravy: Import z podcestu:

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

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

Proces vyčerpá paměť s velkými soubory FBX

Příčina::Velmi velké soubory FBX (> 200 MB) přidělují významný heap. Node.js je standardní heav ~ 1.5 GB na 64-bitových systémech, ale nemusí být dostatečný pro multi-scénové soubory .

Opravy:Zvyšování velikosti Node.js:

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

Také zpracovávání souborů postupně spíše než 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