開発者ガイド

Aspose.3D FOSS for TypeScript は、オープンソースで MIT ライセンスのライブラリであり、Node.js 開発者が 3D シーンをロード、構築、変換、エクスポートでき、完全な TypeScript 型安全性を提供します。アセットパイプライン、フォーマット変換サービス、ジオメトリ検証ツール、あるいは 3D コンテンツ作成スクリプトを構築する場合でも、このライブラリは業界標準の 3D 概念を反映したシーングラフモデルに基づくクリーンで一貫した API を提供します。.

この開発者ガイドは、クイックスタートのインストールを超えて、プロダクション品質の 3D 処理コードを書くために必要なすべてをカバーしています。.

このセクションで見つけられるもの

機能と特長

その 機能 ページは Aspose.3D FOSS for TypeScript の作業に関する主要なリファレンスです。以下をカバーしています：:

  • フォーマットのサポート:：OBJ（.mtl マテリアル付き）、glTF 2.0 / GLB バイナリ、STL（バイナリおよび ASCII）、COLLADA（DAE）、3MF、そして FBX、各フォーマットごとのロードおよびセーブオプションクラスを含む ObjLoadOptions および GltfSaveOptions.
  • シーン グラフ:：どのように Scene, Node, Entity, Transform, SceneObject 完全なシーン階層に構成され、子ノードのトラバーサルパターンを含みます。.
  • ジオメトリおよびメッシュ API: 使用 Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, および ReferenceMode ジオメトリ処理用。.
  • マテリアルシステム: 適用 LambertMaterial, PhongMaterial, および PbrMaterial (PBR for glTF) をシーンノードに適用し、.mtl ファイルから読み込まれたマテリアルプロパティを取得します。.
  • 数学ユーティリティ: 使用 Vector3, Vector4, Matrix4, Quaternion, および BoundingBox 変換、バウンディングボックスクエリ、ジオメトリ計算に使用。.
  • アニメーション: 構築と読み取り AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation,、および Extrapolation データ。.
  • ストリームとバッファのサポート: メモリ内から3Dシーンをロード Buffer オブジェクトを介して scene.openFromBuffer() サーバーレスおよびストリーミングのユースケース向け。.
  • 完全な使用例: OBJ のロード、GLB のエクスポート、STL のラウンドトリップ、シーングラフのトラバースを行うエンドツーエンドの TypeScript スクリプト。.
  • ヒント、一般的な問題、FAQ: 実運用での一般的な落とし穴を回避するための実践的なガイダンス。.
  • APIリファレンス概要: 主要クラスとその主なメソッドのクイックリファレンス一覧。.

主要概念

シーングラフ: Aspose.3D FOSS のすべての3Dコンテンツは、ツリー構造として表現されます。 Node オブジェクトは、～をルートとします scene.rootNode. 各ノードは、 Entity (例えば、 Mesh, Camera, または Light) Transform 階層内でそれを配置するもの。.

フォーマット非依存 API: 任意のサポートされているフォーマットを次の方法で開きます scene.open() または scene.openFromBuffer() そして、任意のサポートされているフォーマットへ次の方法で保存します scene.save(). 同じシーングラフオブジェクトが、ソースフォーマットでも宛先フォーマットでも使用されます。.

強力な TypeScript 型付け: ライブラリは厳格なコンパイラ設定（noImplicitAny, strictNullChecks) と完全な型定義が同梱されています。すべてのクラス、メソッド、オプションプロパティは完全に型付けされており、IDE のオートコンプリートとコンパイル時の安全性が 3D 処理コード全体で提供されます。.

単一の依存関係: 唯一のランタイム依存関係は xmldom, npm によって自動的にインストールされます。コンパイルするネイティブアドオンも、インストールするシステムパッケージもありません。.

はじめに

まだライブラリをインストールしていない場合は、 はじめに セクションと インストール ガイドをご覧になってから、先に進んでください。.

利用可能なトピック

  • 機能と特長: 主要な機能領域ごとにコード例を含む完全な API リファレンス。.
 日本語