Aspose.3D FOSS
TypeScript
Przewodnik do rozwiązywania problemów

Przewodnik do rozwiązywania problemów

Ta strona zawiera najczęstsze błędy, które pojawiają się podczas korzystania z @aspose/3d w projektach TypeScript i Node.js, z wyjaśnieniami przyczyny korzeniowej i sprawdzonymi poprawkami.

Moduł rozwiązywania błędów

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

Przyczyny korzeniowe: Strategia rozdzielczości modułu TypeScript nie obsługuje eksportu podwykonań w stylu Node.js (exports w package.jsona) chyba że moduleResolution Został ustawiony na node lub node16.

Fixy:• Set moduleResolution do "node" W Twoim tsconfig.json:

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

Jeśli używasz typografii 5.x z "module": "node16" lub "module": "nodenext", używać "moduleResolution": "node16" do meczu.

SyntaxError: Cannot use import statement in a module

Przyczyny korzeniowe: Złożony JavaScript jest w toku z require() Semantyczne, ale wyjście zawiera moduł ES import Syntax – zdarza się to, gdy module Został ustawiony na es2020 lub esnext Ale czas pracy Node.js czeka na CommonJS.

Fixy:• Używanie "module": "commonjs" w tsconfig.json i wypełnić zbiórkę .js Archiwum z node bezpośrednio :

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

Następnie wypełnij i uruchom:

npx tsc
node dist/main.js

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

Przyczyny korzeniowe:Pakiet nie jest zainstalowany, lub node_modules Jest stale.

Fixy:

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

Sprawdź instalację:

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

Puste miejsce po ładowaniu

Scena jest ciężka, ale rootNode.childNodes jest pusty

Przyczyny korzeniowe (1):Format pliku umieszcza całą geometrię bezpośrednio na rootNode.entity Zamiast jako węzły dzieci. To jest powszechne z pojedynczymi plikami STL.

Diagnoza:

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

Fixy:Przejście od początku scene.rootNode Nie tylko dla siebie, ale także dla swoich dzieci:

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

Przyczyny korzeniowe (2):Później strona pliku jest niewłaściwa lub strumień jest zerowy. sprawdź, czy istnieje i że nie ma pustego miejsca przed wezwaniem 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}`);

Lista materiałów jest pusta po obciążeniu OBJ

Przyczyny korzeniowe: Materiał ładowania jest nieupoważniony przez default w ObjLoadOptions.Biblioteka ładuje geometrii bez czytania .mtl Zbiórka plików.

Fixy:• Set 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);

Zapewniamy również, że .mtl Artykuły znajdują się w tym samym katalogu, co .obj w bibliotece, jak to jest z tym, że biblioteka rozstrzyga się na .obj W drodze .

Błędy i I/O

openFromBuffer Wyrzuca nieznany błąd formatowy

Przyczyny korzeniowe:Zawartość buffer nie jest rozpoznawalnym formatem binarnym, lub bufer jest zepsuty (złamany, błędne kodowanie lub baz64 zamiast surowych bajtów).

Diagnoza:

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

Fixy:W przypadku formatów opartych na tekście (OBJ, COLLADA) przejdź do odpowiedniej klasy opcji, aby wskazać format:

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

Wyjście GLB otwiera się jako JSON w widzach 3D

Przyczyny korzeniowe: GltfSaveOptions.binaryMode Defaulty do false, produkować .gltf JSON wyjście nawet wtedy, gdy nazwa filenatu wyjścia jest .glb.

Fixy:• wyraźnie określony binaryMode = true:

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

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

Wydajność STL nie ma danych kolorowych ani materiałów w ślizgowcu

Przyczyny korzeniowe: Format STL nie obsługuje materiałów ani kolorów w standardowej specyfikacji. kolory zdolne do barw używają własnych rozszerzeń, które nie są obsługiwane przez @aspose/3d.

Fixy:Eksport do 3MF zamiast, który wspiera metadane koloru i materiału:

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

Błędy w kompilacji typów

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

Przyczyny korzeniowe: Entity jest klasą podstawową; Mesh jest konkretny typ z geometrycznymi właściwościami. potrzebujesz instanceof - straż przed przystąpieniem do specjalnych członków.

Fixy:

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'

Przyczyny korzeniowe: getChildNode() Powrót Node | null.Tryb typografii wymagają, aby zająć się przypadkiem zero.

Fixy:

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

Cannot find name 'GltfSaveOptions'

Przyczyny korzeniowe: GltfSaveOptions W podwodnym modułie @aspose/3d/formats/gltf,Nie jest to korzeń pakietu.

Fixy:Wprowadzenie z podróży:

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

Pamięć i wydajność

Proces wyłącza pamięć z dużych plików FBX

Przyczyny korzeniowe:Bardzo duże pliki FBX (>200 MB) przypisują znaczącą liczbę. standardowe liczeby Node.js wynoszą ~1.5 GB na 64-bitowych systemach, ale mogą nie wystarczyć dla plików wielokątnych.

Fixy:Zwiększ rozmiar nagłówka Node.js:

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

Również przetwarza pliki sekwencjonalnie, a nie równolegle, gdy pamięć jest ograniczona:

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
}

Zobacz również

 Polski