Aspose.3D FOSS for TypeScript
Node.js から 3D シーンをロード、構築、変換、エクスポート — 完全に型付けされ、オープンソースで、単一の npm インストールで本番環境対応。
3D ファイル処理のためのオープンソースのタイプスクリプトライブラリー
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素材のロードと
GltfSaveOptionsによる二次GLB出力. - STL: バイナリおよびASCII STLの両方を読み書きする.
- COLLADA, 3MF, FBX: フォーマットごとにオプションクラスを含む追加形式サポート.
- タイプは,
noImplicitAnyとstrictNullChecksで強く入力されます.
FOSS が使用できる Aspose.3D 場所
- Node.js アセットパイプライン: OBJ ファイルをインポートし,幾何学を検証して再指向し CI で GLB として輸出します.
- ゲームツール:本来のエンジンやレンダリングなしでバッチ処理の3Dメッシュ.
- 3Dプリンティングのワークフロー: STLと3MFファイルを読み,検証し,再輸出する.
- サーバレスバックエンド: 3D変換のエンディングポイントをランバダやクラウド・ファンクションで実行します.
- コンテンツ移行: 単一のスクリプトからスケールでフォーマットファミリー間で変換します.
形式の選択と調整制御
- 座標系指向: 軸を転覆し,オプションクラスで格式ごとにスケール調整します.
- 正常化: 負荷または保存時に自動で頂点の正規値を標準化する.
- バイナリー対JSON出力:
GltfSaveOptionsを使ってコンパクトGLBまたは読みやすいglTFを選択します. - 素材のロード制御: より速い解析のために MTL/テクスチャ・ロードを有効または無効にする.
- 戻り回りの信頼性: 未知のシーンのグラフノードは,再保存時に文字どおり保存されます.
開発者経験
Aspose.3D FOSS for TypeScriptは,単一のnpm install @aspose/3dコマンドでインストールされます.コンパイルするネイティブアドオンはありません.ライブラリーは純粋なタイプスクリプト/JavaScriptであり,1つの自動インストール依存度 (xmldom) があります.
強くタイプされたAPIは,すべてのシーングラフクラスとフォーマットオプションに完全なIDE自動完了を提供します.このライブラリーはNode.js 1822+およびTypeScript 5.0+,Linux CIランナーや開発者ワークステーションで同一的に実行され,GitHub上のオープンエシュートラッカーを搭載したMITライセンスがあります.
画面をロードして 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 を二元 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 とは何ですか？
3Dシーンをインストールせずに,ロードし,操作し保存するための無料のMITライセンス付きTypeScript/Node.jsライブラリです.
どの3Dフォーマットがサポートされていますか?
OBJ (mtl),glTF 2.0 と GLB,STL (バイナリーとASCII),COLLADA (DAE),3MF,およびFBX.各フォーマットは専用のタイプオプションクラスを持っています.
Node.js アドオンが必要ですか?
ありません.Aspose.3D FOSS for TypeScriptは純粋なJavaScript/TypeScriptです.コンパイルステップを必要とせず,npmで自動的にインストールされる単一の実行時間依存性 (xmldom) を有しています.
どうやってインストールする?
Run npm install @aspose/3d を実行してください。追加のシステムパッケージやネイティブアドオンは必要ありません。
Node.js と TypeScript のバージョンはサポートされていますか?
Node.js 18, 20, 22+. TypeScript 5.0+ . 図書館はCommonJSにコンパイルされ,厳格なTypeScript設定で動作します.
タイプスクリプトの定義が付属していますか?
はい.すべてのクラス,メソッド,エンウムおよびオプションタイプは noImplicitAny と strictNullChecks が有効で完全に入力されます.
座標系を制御できる?
はい。ObjLoadOptions や GltfSaveOptions などのフォーマット別オプションクラスを使用すると、カスタムパーシングコードなしで軸の反転、スケールの調整、法線の正規化が可能です。
ソースコードはどこで見つけられるの?
図書館はMITライセンスでGitHubにホストされています.バグレポートやプルリクエストが歓迎されます.
