Aspose.3D FOSS
TypeScript
トラブルシューティングガイド

トラブルシューティングガイド

このページでは、使用時に遭遇する最も一般的なエラーについて説明します @aspose/3d TypeScript および Node.js プロジェクトにおいて、根本原因の説明と検証済みの修正策を添えて.

モジュール解決エラー

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

根本原因: TypeScript のモジュール解決戦略は、Node.js スタイルのサブパスエクスポート (exports において package.json) ただし moduleResolution が設定されている場合は node または node16.

修正: 設定する moduleResolution を "node" あなたの tsconfig.json:

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

TypeScript 5.x を使用している場合は "module": "node16" または "module": "nodenext",、使用してください "moduleResolution": "node16" 一致させるには。.

SyntaxError: Cannot use import statement in a module

根本原因:：コンパイルされた JavaScript が実行されているのは require() セマンティクスですが、出力に ES モジュールが含まれています import 構文；これは次の場合に発生します module が設定されている場合 es2020 または esnext しかし、Node.jsランタイムはCommonJSを期待しています。.

修正: 使用 "module": "commonjs" で tsconfig.json そしてコンパイルされた .js ファイルを node 直接:

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

次にコンパイルして実行します:

npx tsc
node dist/main.js

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

根本原因: パッケージがインストールされていないか、 node_modules が古くなっています。.

修正:

npm install @aspose/3d

インストールを確認してください:

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

ロード後の空シーン

シーンはロードされますが rootNode.childNodes 空です

根本原因 (1): ファイル形式はすべてのジオメトリを直接配置します rootNode.entity 子ノードとしてではなく。これは単一メッシュの STL ファイルで一般的です。.

診断:

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

修正: から開始して走査します scene.rootNode それ自体、子ノードだけでなく：:

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

根本原因 (2): ファイルパスが間違っているか、ファイルがゼロバイトです。呼び出す前にファイルが存在し、空でないことを確認してください 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}`);

OBJ のロード後、マテリアルリストが空です

根本原因:：Material loadingはデフォルトで無効になっています ObjLoadOptions. ライブラリはジオメトリを読み込み、sidecar fileを読み取らずに .mtl sidecar file.

修正:：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);

また、 .mtl fileが同じディレクトリにあることを確認してください .obj file、ライブラリがそれを相対パスで解決するため .obj パス。.

フォーマットおよび I/O エラー

openFromBuffer 未認識のフォーマットエラーがスローされます

根本原因:：バッファの内容が認識可能なバイナリ形式ではないか、バッファが破損しています（切り捨てられた、エンコーディングが間違っている、または生バイトの代わりに base64 になっている）。.

診断:

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

修正:：テキストベースの形式（OBJ、COLLADA）の場合、適切なオプションクラスを渡して形式をヒントしてください：:

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

出力された GLB が 3D ビューアで JSON として開かれる

根本原因: GltfSaveOptions.binaryMode はデフォルトで false,、生成されるのは .gltf 出力ファイル名が何であっても JSON 出力になります .glb.

修正:：明示的に設定する binaryMode = true:

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

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

STL 出力にはスライサーで色やマテリアル データが含まれません

根本原因: STL形式は標準仕様では素材や色をサポートしていません。カラー対応スライサーは、サポートされていない独自拡張を使用します。 @aspose/3d.

修正: 代わりに3MFでエクスポートしてください。3MFはカラーと素材メタデータをサポートしています:

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

TypeScript コンパイル エラー

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

根本原因: Entity は基底クラスです; Mesh はジオメトリプロパティを持つ具体型です。あなたは instanceof メッシュ固有のメンバーにアクセスする前にガードが必要です。.

修正:

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'

根本原因: getChildNode() 返します Node | null. TypeScript strict mode では null ケースを処理する必要があります。.

修正:

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

Cannot find name 'GltfSaveOptions'

根本原因: GltfSaveOptions はサブパスモジュールにあります @aspose/3d/formats/gltf, パッケージのルートではありません。.

修正: サブパスからインポートしてください:

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

メモリとパフォーマンスの問題

大きな FBX ファイルでプロセスがメモリ不足になる

根本原因: 非常に大きな FBX ファイル（>200 MB）は大量のヒープを割り当てます。Node.js のデフォルトヒープは 64 ビットシステムで約 1.5 GB ですが、マルチシーンファイルには十分でない場合があります。.

修正: Node.js のヒープサイズを増やす:

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

メモリが制限されている場合は、ファイルを並列ではなく順次処理してください:

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
}

参照

 日本語