Aspose.3D FOSS
TypeScript
Kļūdu novēršanas rokasgrāmatas

Kļūdu novēršanas rokasgrāmatas

Šī lapa aptver visbiežāk sastaptās kļūdas, ar kurām saskaras, lietojot @aspose/3d TypeScript un Node.js projektos, sniedzot pamata cēloņu skaidrojumus un pārbaudītus risinājumus.

Moduļu izšķiršanas kļūdas

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

Pamatcēlonis: TypeScript moduļu izšķiršanas stratēģija neatbalsta Node.js stila apakšceļu eksportus (exports iekš package.json) ja vien moduleResolution ir iestatīts uz node vai node16.

Risinājums: Iestatiet moduleResolution uz "node" jūsu tsconfig.json:

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

Ja jūs lietojat TypeScript 5.x ar "module": "node16" vai "module": "nodenext", izmantojiet "moduleResolution": "node16" lai atbilstu.

SyntaxError: Cannot use import statement in a module

Pamatcēlonis: Kompilētais JavaScript tiek izpildīts ar require() semantiku, bet izvadē ir ES module import sintakse; tas notiek, kad module ir iestatīts uz es2020 vai esnext bet Node.js izpildlaiks sagaida CommonJS.

Labot: Izmantot "module": "commonjs" iekš tsconfig.json un palaidiet kompilēto .js failus ar node tieši:

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

Tad kompilējiet un palaidiet:

npx tsc
node dist/main.js

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

Pamatcēlonis: Pakete nav instalēta, vai node_modules ir novecojusi.

Labot:

npm install @aspose/3d

Pārbaudiet instalāciju:

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

Tukša aina pēc ielādes

Aina ielādējas, bet rootNode.childNodes ir tukša

Pamatcēlonis (1): Faila formāts novieto visu ģeometriju tieši uz rootNode.entity nevis kā bērna mezglus. Tas ir izplatīts ar viena tīkla STL failiem.

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

Labojums:Traversē sākot no scene.rootNode pašu, ne tikai tās bērnus:

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

Pamatcēlonis (2): Faila ceļš ir nepareizs vai fails ir nullbaiti. Pārbaudiet, vai fails pastāv un nav tukšs, pirms izsaukt 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}`);

Materiālu saraksts ir tukšs pēc OBJ ielādes

Pamatcēlonis: Materiālu ielāde pēc noklusējuma ir atspējota ObjLoadOptions. Bibliotēka ielādē ģeometriju, neizlasa .mtl piedevu failu.

Labojums: Iestatīt 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);

Arī pārliecinieties, ka .mtl fails atrodas tajā pašā direktorijā kā .obj fails, jo bibliotēka to atrisina relatīvi pret .obj ceļu.

Formāta un I/O kļūdas

openFromBuffer izsauc neatpazītu formāta kļūdu

Pamatcēlonis: Bufera saturs nav atpazīstams binārais formāts, vai buferis ir bojāts (apgriezts, nepareiza kodēšana vai base64 nevis neapstrādāti baiti).

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

Labojums: Teksta balstītiem formātiem (OBJ, COLLADA) nododiet atbilstošu opciju klasi, lai norādītu formātu:

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

Izvades GLB atveras kā JSON 3D skatītājos

Pamatcēlonis: GltfSaveOptions.binaryMode pēc noklusējuma ir false, radot .gltf JSON izvade pat tad, ja izvades faila nosaukums ir .glb.

Labojums: Eksplicitiski iestatīt binaryMode = true:

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

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

STL izvade slicerā nesatur krāsu vai materiālu datus

Pamatcēlonis: STL formāts neatbalsta materiālus vai krāsu savā standarta specifikācijā. Krāsu spējīgi sliceri izmanto īpašas paplašināšanas funkcijas, kas nav atbalstītas @aspose/3d.

Labojums: Eksportējiet uz 3MF, kas atbalsta krāsu un materiālu metadatus:

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

TypeScript kompilācijas kļūdas

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

Pamatcēlonis: Entity ir pamata klase; Mesh ir konkrētais tips ar ģeometrijas īpašībām. Jums vajag instanceof aizsargu pirms piekļūšanas režģa specifiskajiem locekļiem.

Izlabot:

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'

Pamatcēlonis: getChildNode() atgriež Node | null. TypeScript strict mode pieprasa, lai apstrādātu null gadījumu.

Labojums:

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

Cannot find name 'GltfSaveOptions'

Pamatcēlonis: GltfSaveOptions ir apakšceļā modulī @aspose/3d/formats/gltf, nevis pakotnes sakne.

Labot: Importēt no apakšceļa:

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

Atmiņas un veiktspējas problēmas

Processam beidzas atmiņa, strādājot ar lieliem FBX failiem

Pamatcēlonis: Ļoti lieli FBX faili (>200 MB) pieprasa ievērojamu kaudzes atmiņu. Node.js noklusējuma kaudze ir aptuveni 1,5 GB 64‑bit sistēmās, bet tas var nebūt pietiekami daudz vairāku ainu failiem.

Labot: Palielināt Node.js kaudzes lielumu:

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

Arī apstrādājiet failus secīgi, nevis paralēli, ja atmiņa ir ierobežota:

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
}

Skatīt arī

 Latviešu