Aspose.3D FOSS - Aspose.3D TypeScript 用 FOSS
Node.js から 3D シーンを読み込み、構築、変換、エクスポートします — 完全に型付けされ、オープンソースで、単一の npm インストールだけで本番環境に対応できます。
3D ファイル処理のためのオープンソース TypeScript ライブラリ
Aspose.3D FOSS for TypeScript は、Node.js アプリケーションで 3D ファイル形式を扱うための MIT ライセンスのライブラリです。npm install @aspose/3d コマンドを 1 回実行するだけでインストールでき、ネイティブアドオンのコンパイルや外部 SDK のインストール、レンダラは不要で、TypeScript ですぐに 3D シーンの読み取り、構築、書き込みを開始できます。
このライブラリは、Scene、Node、Entity、Mesh、Camera、Light、およびTransformを中心に構築された、完全に型付けされたシーングラフ API を提供します。これは、プロの 3D ツールで使用されているのと同じ概念モデルです。サポートされているフォーマットには、OBJ（Wavefront、.mtl マテリアルのロード対応）、glTF 2.0 と GLB バイナリ（PBR マテリアル）、STL（バイナリおよび ASCII、フルラウンドトリップ）、COLLADA（DAE）、3MF、そして FBX が含まれます。ObjLoadOptions や GltfSaveOptions などのフォーマット別オプションクラスにより、座標系の向き、スケール、法線の正規化、バイナリ vs. JSON 出力、マテリアルのロードを正確に制御できます。
Aspose.3D FOSS は Node.js 18、20、22+ を対象にし、TypeScript 5.0+ で CommonJS にコンパイルします。ライブラリは厳格な TypeScript コンパイラ設定（noImplicitAny、strictNullChecks）と共に提供されるため、IDE がフルオートコンプリートとコンパイル時の安全性を提供します。その単一のランタイム依存関係である xmldom は自動的にインストールされます。エンタープライズ製品ファミリーについては、Aspose.3D — Enterprise Product Family を参照してください。
3D フォーマットのサポートと型付けされたシーングラフ API
- OBJ / MTL: Wavefront OBJ ファイルとそれに付随するマテリアル定義をロードします。
- glTF 2.0 / GLB: PBR マテリアルのロードとバイナリ GLB 出力を
GltfSaveOptions経由で。 - STL: バイナリとASCIIの両方のSTLを読み書きし、完全なラウンドトリップ検証を行います。
- COLLADA, 3MF, FBX: 各フォーマットごとのオプションクラスによる追加のフォーマットサポート。
- 完全な TypeScript 型: すべてのクラス、メソッド、オプションは
noImplicitAnyとstrictNullChecksで強く型付けされています。
Aspose.3D FOSS が使用できる場所
- Node.js asset pipelines: OBJ ファイルをインポートし、ジオメトリを検証および再配置し、CI で GLB としてエクスポートします。
- ゲームツール: ネイティブエンジンやレンダラーがなくても3Dメッシュをバッチ処理する。
- 3Dプリンティングワークフロー: STL と 3MF ファイルを読み取り、検証し、再エクスポートします。
- Serverless backends: 3D変換エンドポイントをLambdaまたはCloud Functionsで実行します。
- コンテンツの移行: 単一スクリプトでスケールにわたってフォーマットファミリー間を変換します。
フォーマット別オプションと座標制御
- Coordinate-system orientation: 軸を反転し、フォーマットごとにオプションクラスでスケールを調整します。
- Normal normalization: 読み込みまたは保存時に頂点法線を自動的に正規化します。
- Binary vs. JSON output: コンパクトな GLB または 読みやすい glTF を
GltfSaveOptionsで選択してください。 - マテリアル読み込み制御: MTL/テクスチャの読み込みを有効または無効にして、解析を高速化します。
- Round-trip fidelity: 不明なシーングラフノードは、再保存時に文字通りそのまま保持されます。
開発者体験
Aspose.3D FOSS for TypeScript は、単一の npm install @aspose/3d コマンドでインストールできます。コンパイルするネイティブアドオンはありません。ライブラリは純粋な TypeScript/JavaScript で、1 つの自動インストールされる依存関係（xmldom）があります。
強く型付けされた API は、すべてのシーングラフクラスとフォーマットオプションに対して完全な IDE オートコンプリートを提供します。ライブラリは Node.js 18–22+ と TypeScript 5.0+ を対象とし、Linux CI ランナーおよび開発者のワークステーションで同一に動作し、MIT-licensed で、GitHub のオープンなイシュー トラッカーが付属しています。
OBJシーンをロードし、glTFとしてエクスポート
npmでインストールし、scene.open()をObjLoadOptionsと共に使用して、メッシュとそのMTLマテリアルファイルをロードします。open()とsave()はどちらも同期的です — awaitやPromiseチェーンは不要です。scene.save()を.gltf拡張子で呼び出すと、標準のglTF 2.0 JSONが書き込まれます — フォーマットはファイル拡張子から自動的に推測されます。
npm install @aspose/3d
import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");
STL を Binary GLB に変換
デフォルトの JSON glTF の代わりにコンパクトなバイナリ GLB を生成するには、GltfSaveOptions に binaryMode = true を渡します。open() と save() はどちらも同期的です — await は不要です。
import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);
よくある質問
TypeScript 用の Aspose.3D FOSS とは何ですか？
これは、ネイティブアドオンや外部 SDK をインストールせずに 3D シーンの読み込み、操作、保存を行うための、無料で MIT ライセンスの TypeScript/Node.js ライブラリです。
サポートされている 3D フォーマットはどれですか？
OBJ（.mtl を含む）、glTF 2.0 と GLB、STL（バイナリおよび ASCII）、COLLADA（DAE）、3MF、そして FBX。各フォーマットには専用の型付きオプションクラスがあります。
ネイティブな Node.js アドオンが必要ですか？
No. Aspose.3D FOSS for TypeScript は純粋な JavaScript/TypeScript です。コンパイル工程は不要で、単一のランタイム依存関係 (xmldom) が npm によって自動的にインストールされます。
インストール方法は？
npm install @aspose/3d を実行してください。追加のシステムパッケージやネイティブアドオンは必要ありません。
サポートされている Node.js と TypeScript のバージョンはどれですか？
Node.js 18、20、22+。TypeScript 5.0+。このライブラリは CommonJS にコンパイルされ、厳格な TypeScript 設定でも動作します。
TypeScript の型定義が同梱されていますか？
はい。すべてのクラス、メソッド、列挙型、オプション型は noImplicitAny と strictNullChecks が有効な状態で完全に型付けされています。
座標系の向きを制御できますか？
はい。ObjLoadOptions や GltfSaveOptions などのフォーマット別オプションクラスを使用すれば、カスタムパーシングコードなしで軸の反転、スケール調整、法線の正規化が可能です。
ソースコードはどこで見つけられますか？
このライブラリは MIT ライセンスで、GitHub にホストされています。バグ報告やプルリクエストは歓迎します。
