Aspose.3D szabad és nyílt forráskódú
TypeScript
Hibakeresési útmutatók

Hibakeresési útmutatók

Ez az oldal lefedi a leggyakoribb hibákat, amelyek a használat során merülnek fel @aspose/3d TypeScript és Node.js projektekben, a kiváltó okok magyarázatával és ellenőrzött javításokkal.

Modulfeloldási hibák

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

Gyökér ok: A TypeScript modul feloldási stratégiája nem támogatja a Node.js-stílusú alútvonal exportokat (exports ban package.json) hacsak moduleResolution be van állítva node vagy node16.

Javítás: Állítsa be moduleResolution erre "node" az tsconfig.json:

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

Ha TypeScript 5.x-et használ a "module": "node16" vagy "module": "nodenext", használja "moduleResolution": "node16" a megfelelő beállításhoz.

SyntaxError: Cannot use import statement in a module

Gyökér ok: A lefordított JavaScript-et a következővel futtatják require() szemantika, de a kimenet ES modul import szintaxis; ez akkor fordul elő, amikor module be van állítva es2020 vagy esnext de a Node.js futtatókörnyezet CommonJS-t vár.

Javítás: Használja "module": "commonjs" ban tsconfig.json és futtassa a lefordított .js fájlokat a node közvetlenül:

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

Ezután fordítsa le és futtassa:

npx tsc
node dist/main.js

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

Gyökér ok: A csomag nincs telepítve, vagy node_modules elavult.

Javítás:

npm install @aspose/3d

Ellenőrizze a telepítést:

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

Üres jelenet betöltés után

A jelenet betölt, de rootNode.childNodes üres

Gyökér ok (1): A fájlformátum az összes geometriát közvetlenül a rootNode.entity ahelyett, hogy gyermekcsomópontokként lenne. Ez gyakori az egyetlen háló STL fájloknál.

Diagnózis:

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

Javítás: Bejárás a következőtől kezdve scene.rootNode : magától, nem csak a gyermekeit:

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

Gyökér ok (2): A fájl útvonala hibás vagy a fájl nulla bájt. Ellenőrizze, hogy a fájl létezik és nem üres, mielőtt meghívná 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}`);

Az anyaglista üres az OBJ betöltése után

Gyökér ok: Az anyag betöltése alapértelmezés szerint le van tiltva a ObjLoadOptions. A könyvtár betölti a geometriát anélkül, hogy olvasná a .mtl mellékfájl.

Javítás: Állítsa be 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);

Győződjön meg arról is, hogy a .mtl fájl ugyanabban a könyvtárban van, mint a .obj fájl, mivel a könyvtár a relatív útvonal alapján oldja fel a .obj útvonalat.

Formátum- és I/O hibák

openFromBuffer dob egy ismeretlen formátumú hibát

Gyökér ok: A puffer tartalma nem felismerhető bináris formátum, vagy a puffer sérült (levágott, rossz kódolású, vagy base64 a nyers bájtok helyett).

Diagnózis:

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

Javítás: Szöveges formátumok (OBJ, COLLADA) esetén adja át a megfelelő opciók osztályt a formátum jelzéséhez:

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

A kimeneti GLB JSON-ként nyílik meg 3D nézőkben

Alapvető ok: GltfSaveOptions.binaryMode alapértelmezés szerint false, előállítva .gltf JSON kimenet akkor is, ha a kimeneti fájlnév .glb.

Javítás: Kifejezetten állítsa be binaryMode = true:

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

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

Az STL kimenet nem tartalmaz szín- vagy anyagadatot a szeletelőben

Alapvető ok: Az STL formátum a szabványos specifikációjában nem támogatja az anyagokat vagy a színt. A színt kezelő szeletelők olyan tulajdonosi kiterjesztéseket használnak, amelyeket a @aspose/3d.

Javítás: Exportáljon inkább 3MF formátumba, amely támogatja a szín- és anyagmetaadatokat:

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

TypeScript fordítási hibák

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

Alapvető ok: Entity az alaposztály; Mesh az a konkrét típus geometriai tulajdonságokkal. Szüksége van egy instanceof védelmi ellenőrzésre a háló-specifikus tagok elérése előtt.

Javítás:

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'

Alapvető ok: getChildNode() visszatér Node | null. A TypeScript szigorú módja megköveteli, hogy kezeld a null esetet.

Javítás:

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

Cannot find name 'GltfSaveOptions'

Alapvető ok: GltfSaveOptions az alútvonal modulban van @aspose/3d/formats/gltf, nem a csomag gyökere.

Javítás:Importálás az alútvonalról:

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

Memória- és teljesítményproblémák

A folyamat memóriahiányba ütközik nagy FBX fájlok esetén

Gyökér ok: Nagyon nagy FBX fájlok (>200 MB) jelentős heapet foglalnak le. A Node.js alapértelmezett heap körülbelül 1,5 GB 64-bites rendszereken, de több jelenetet tartalmazó fájlok esetén lehet, hogy nem elegendő.

Javítás: Növelje a Node.js heap méretét:

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

Ezenkívül dolgozza fel a fájlokat sorban, ne párhuzamosan, ha a memória korlátozott:

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
}

Lásd még

 Magyar