Aspose.3D FOSS for Java

API リファレンス aspose-3d-foss 26.1.0 (Java 21+、MIT ライセンス)。.

すべてのクラスは com.aspose.threed ルートパッケージです。ルートインポートは次のとおりです:

import com.aspose.threed.*;

パッケージ構成: ほぼすべての公開クラスは com.aspose.threed.。通常使用される唯一のサブパッケージは com.aspose.threed.shading （for PbrMaterial）。 The com.aspose.threed.formats サブパッケージには内部のインポーター/エクスポーターが含まれ、通常は直接インポートされません。.

Java 命名規則: すべてのプロパティは getter/setter メソッドを使用します。例えば、次を使用します node.getTransform() の代わりに node.transform, および transform.setTranslation(...) の代わりに transform.translation = ....。なお、 Vector3, Vector4, Quaternion, Matrix4, および FVector 型は使用します public フィールド (v.x, v.y, v.z) を使用し、コンポーネントアクセスには getter を使用しません。.

コアシーングラフ

PropertiesProperties
Sceneすべての 3D シーンデータのトップレベルコンテナ。ルートノード、アセットメタデータ、アニメーションクリップを保持します。提供する fromFile(), open(),、および save() を主要な I/O エントリーポイントとして。.
Nodeシーン階層内の名前付きノード。子ノードのリストとアタッチされた Entity メッシュ、カメラ、ライトなどのオブジェクト。ローカルな Transform.
Entityアタッチ可能なすべてのオブジェクトの抽象基底クラス。 Node.。名前と識別子を提供しますが、独自のジオメトリは持ちません。.
SceneObjectが共有する基底クラス Node と Entity.。ユーザー定義メタデータに使用されるプロパティコレクションインターフェースを提供します。.
A3DObjectAspose.3D 管理オブジェクトすべてのルート基底クラス。name プロパティと Properties コレクション。.
INamedObject保証を提供するインターフェース getName() メソッド。実装されるのは Node, Entity, および複数のフォーマット固有の記述子タイプ。.

ジオメトリとメッシュ

PropertiesProperties
Meshポリゴンメッシュエンティティ。制御点（頂点位置としての）を格納します Vector4), ポリゴンフェイスリスト（制御点インデックスのリスト）、および頂点要素レイヤー（法線、UV、頂点カラー）を格納します。.
Geometryメッシュ状ジオメトリタイプの抽象基底。制御点配列と、以下のコレクションを定義します VertexElement レイヤー。. Mesh は以下から継承します Geometry.
VertexElementジオメトリに付随するデータレイヤー（法線、UV、カラー等）の抽象基底。以下を保持します getMappingMode(), getReferenceMode(), およびデータリスト。.
VertexElementNormalマッピングモードに応じて、頂点またはポリゴンコーナーごとに1つの法線ベクトルを格納します。データ値は Vector4 インスタンスが w 未使用。.
VertexElementUVテクスチャ座標ペアを格納します（Vector2）各頂点または各ポリゴンコーナーごとに。メッシュは異なるテクスチャチャンネル用に複数の UV レイヤーを持つことができます。.
VertexElementVertexColor各頂点または各コーナーの RGBA カラー データを次の形式で格納します Vector4 (r, g, b, a は 0〜1 の範囲です)。.
VertexElementType頂点要素レイヤーのセマンティックな役割を識別する列挙型: NORMAL, UV, VERTEX_COLOR,、その他。値を次に渡します Mesh.getElement().
MappingMode頂点要素の値がマッピングされるプリミティブを制御する列挙型: CONTROL_POINT, POLYGON_VERTEX,、または POLYGON.
ReferenceMode値がインデックス付けされる方法を制御する列挙型: DIRECT (マッピングプリミティブごとに1つの値) または INDEX_TO_DIRECT (values array と別個の indices array).

トランスフォームと空間

PropertiesProperties
Transformローカル変換が付随する Node. 平行移動、回転（として Quaternion), スケール成分、さらにオイラー角の便利メソッド。.
GlobalTransformすべての祖先変換を合成した後のノードのワールド空間変換の読み取り専用ビュー。次の方法でアクセスできます： node.getGlobalTransform().
AssetInfoメタデータブロックが付属する Scene.作成アプリケーション名、単位名、単位スケール係数、座標系軸定義、作成/変更タイムスタンプを格納します。.

マテリアルとシェーディング

PropertiesProperties
Materialすべてのマテリアルタイプの抽象基底クラス。名前と数値およびカラー パラメータ用のプロパティコレクションを提供します。.
PbrMaterial物理ベースレンダリング（PBR）マテリアル。アルベド、金属係数、粗さ係数、放射色、透明度、および関連テクスチャを格納します。glTF 2.0 やその他の PBR 対応フォーマットで使用されます。インポート：: com.aspose.threed.shading.PbrMaterial.

Properties

PropertiesProperties
Cameraカメラエンティティ。継承元は Entity. Java FOSS エディションでは、継承された名前とプロパティコレクション以外のフォーマット固有のプロパティは公開されていません。に添付されます Node 視点変換を定義するために。.

注: Properties Light クラスは Java エディションの Aspose.3D FOSS では利用できません。インポートされたファイルからのシーン照明データは汎用として保存されます Entity オブジェクト。.

数学ユーティリティ

PropertiesProperties
Vector2倍精度 2 成分ベクトル (x, y). UV テクスチャ座標に使用されます。.
Vector3倍精度 3 成分ベクトル (x, y, z). 位置、方向、スケールに使用されます。.
Vector4倍精度 4 成分ベクトル (x, y, z, w). 制御点（同次座標）および法線データに使用されます。.
FVector3単精度3成分浮動小数点ベクトル。法線と接線の頂点要素データ配列に出現します。.
FVector4単精度4成分浮動小数点ベクトル。データの格納タイプは VertexElementFVector データ。.
Quaternion回転を表す単位クォータニオン (w, x, y, z). 使用される Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBox軸に平行なバウンディングボックスは次によって定義されます getMinimum() と getMaximum() Vector3 コーナー。空間クエリや視錐台カリングの補助に使用されます。.

Properties

PropertiesProperties
AnimationClipアニメーション範囲の名前付きコンテナ。A Scene は複数のクリップ（例: “Walk”, “Run”）を保持できます。. 宣言スタブ — キーフレームデータと再生はまだ実装されていません。.

フォーマット I/O

PropertiesProperties
Scene.fromFile(path)静的メソッド。以下の場所にあるファイルを開きます path,、拡張子からフォーマットを検出し、初期化された Scene.。ファイルが見つからない場合やサポートされていないフォーマットの場合は例外をスローします。.
Scene.open(path, options)インスタンスメソッド。既存の Scene インスタンスにファイルを開きます。オプションでフォーマット固有の LoadOptions サブクラス。.
Scene.save(path, options)インスタンスメソッド。シーンを path 拡張子から推測されたフォーマットを使用し、オプションでフォーマット固有の SaveOptions サブクラス。.
FileFormatサポートされているファイル形式のレジストリ。次のようなエントリが含まれます FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII().
IOServiceフォーマットのインポーターとエクスポーターが使用する内部 I/O 抽象化。通常、アプリケーションコードから直接使用されることはありません。.
LoadOptionsすべてのフォーマット固有のロードオプションオブジェクトの基底クラス。サブクラスは次のものです ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsすべてのフォーマット固有のセーブオプションオブジェクトの基底クラス。サブクラスは次のものです ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

OBJ フォーマット

PropertiesProperties
ObjImporterWavefront OBJ および MTL ファイルを解析する内部インポータークラス。自動的に次によって呼び出されます Scene.fromFile() 対象 .obj 拡張子。.
ObjLoadOptionsWavefront OBJ ファイルのロードオプション。主なプロパティ: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsWavefront OBJ 出力のセーブオプション。法線、UV、マテリアル参照、ポイントクラウドモードを制御します。.
ObjFormatWavefront OBJ のフォーマット記述子。次のようにアクセスできます FileFormat.WAVEFRONT_OBJ().

STL フォーマット

PropertiesProperties
StlImporterバイナリと ASCII の STL ファイルの両方を読み取る内部インポーター。拡張子に応じて自動的に選択されます。.
StlExporterSTLを書き込む内部エクスポーターです。.
StlLoadOptionsSTLファイルのロードオプションです。サポートするのは setFlipCoordinateSystem(), setRecalculateNormal(),、および setContentType().
StlSaveOptionsSTL出力の保存オプションです。制御項目は setFlipCoordinateSystem(), setAxisSystem(),、および setContentType().
StlFormatSTLのフォーマット記述子です。.

glTF フォーマット

PropertiesProperties
GltfLoadOptionsglTF 2.0 および GLB ファイルのロードオプションです。主なプロパティは：: setFlipCoordinateSystem(), setPrettyPrint().
GltfSaveOptionsglTF 2.0 および GLB 出力の保存オプションです。使用するのは setContentType(FileContentType.BINARY) 自己完結型の .glb パッケージです。.
GltfFormatglTF 2.0 / GLB のフォーマット記述子です。次としてアクセス可能です FileFormat.GLTF2().

FBX フォーマット

FBX はサポートされています インポートのみ. Java FOSS エディションでは FBX へのエクスポートは利用できません。.

PropertiesProperties
FbxLoadOptionsFBX ファイルのロードオプション。キー プロパティ: setFlipCoordinateSystem().
FbxFormatFBX のフォーマット記述子。次のようにアクセス可能 FileFormat.FBX7400ASCII().

Properties

PropertiesProperties
Axis座標軸を識別します: X_AXIS, Y_AXIS, Z_AXIS. 座標系リマッピングオプションで使用されます。.
CoordinateSystem右手系/左手系の規約を指定します: RIGHT_HANDED または LEFT_HANDED.
TextureMappingテクスチャがジオメトリにどのようにマッピングされるかを識別します: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT,、など。.
BooleanOperationCSG ブール演算タイプ: UNION, DIFFERENCE, INTERSECTION.

プロパティシステム

PropertiesProperties
Property単一の名前付き型プロパティ A3DObject.。 プロパティ名、型記述子、現在の値を格納します。.
PropertyCollection反復可能なコレクション Property オブジェクトが添付された A3DObject.。 名前による検索と、定義されたすべてのプロパティの反復をサポートします。.
CustomObject軽量な A3DObject 名前と任意のものだけを保持するサブクラス PropertyCollection.。 シーンオブジェクト上のユーザー定義メタデータを格納するために使用されます。.

画像とレンダリング

PropertiesProperties
ImageRenderOptionsシーンを画像バッファにレンダリングする際のソフトウェアラスタライズのオプション。背景色、画像サイズ、カメラ参照を格納します。この機能はサポートされている構成で利用可能です。.

参照

 日本語