Aspose.3D FOSS for Python

APIリファレンス aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, MITライセンス).

すべてのクラスは次の場所からインポートされます aspose.threed パッケージまたはそのサブパッケージです。ルートインポートは次のとおりです:

import aspose.threed
##or selectively:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh, Camera, Light
from aspose.threed.formats import ObjLoadOptions, StlSaveOptions, GltfSaveOptions
from aspose.threed.utilities import Vector3, Matrix4, BoundingBox
from aspose.threed.animation import AnimationClip, KeyFrame

コアシーングラフ

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

ジオメトリとメッシュ

MethodsMethods
Meshポリゴンメッシュエンティティ。制御点（頂点位置としての Vector4）、ポリゴンフェイスリスト（制御点インデックスのリスト）、および頂点要素レイヤー（法線、UV、頂点カラー）を格納します。.
Geometryメッシュ状ジオメトリタイプの抽象基底です。コントロールポイント配列とコレクションの VertexElement レイヤー。. Mesh から継承 Geometry.
VertexElementジオメトリに付随するデータレイヤー（法線、UV、カラーなど）の抽象基底です。保持します mapping_mode, reference_mode,、および data リスト。.
VertexElementNormal頂点ごとまたはポリゴンコーナーごとに1つの法線ベクトルを格納します、 mapping_mode.。データ値は FVector4 インスタンス（単精度）で w 未使用です。.
VertexElementUVテクスチャ座標データをとして格納します FVector4 頂点ごとまたはポリゴンのコーナーごと（ただし x および y コンポーネントはUVに使用されます）。メッシュは異なるテクスチャチャンネル用に複数のUVレイヤーを保持できる場合があります。.
VertexElementVertexColor頂点ごとまたはコーナーごとのRGBAカラー データを次の形式で格納します FVector4 (r, g, b, a は 0–1 の範囲です)。.
VertexElementSmoothingGroupポリゴンごとのスムージンググループ整数IDを格納します。これはOBJインポーターが元ファイルからの元のスムージンググループ割り当てを再現するために使用されます。.
VertexElementType頂点要素レイヤーのセマンティックな役割を識別する列挙型: NORMAL, UV, VERTEX_COLOR, SMOOTHING_GROUP,、その他。値を以下に渡します Mesh.get_element().
MappingMode頂点要素の値がマッピングされるプリミティブを制御する列挙型: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE,、または ALL_SAME.
ReferenceMode値がインデックス付けされる方法を制御する列挙型: DIRECT (マッピングプリミティブごとに1つの値) または INDEX_TO_DIRECT (値の配列と別個のインデックス配列)。.
PolygonModifier三角測量を行うメソッドを持つ静的ユーティリティクラス Mesh オブジェクトと全体 Scene グラフ。.

変換と空間

MethodsMethods
Transformローカル変換が添付された Node.。平行移動、回転（として Quaternion）、スケール成分、さらにオイラー角用の便利なプロパティを提供します。.
GlobalTransformすべての祖先変換を合成した後のノードのワールド空間変換の読み取り専用ビュー。次を介してアクセスします。 Node.global_transform.
AssetInfoメタデータブロックが添付された Scene.。作成アプリケーション名、単位名、単位スケール係数、座標系軸定義、作成/変更タイムスタンプを格納します。.

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

MethodsMethods
Materialすべての material タイプの抽象基底クラスです。名前と、数値および colour パラメータ用のプロパティコレクションを提供します。.
LambertMaterial拡散のみの material モデルです。ambient colour、diffuse colour、emissive colour、そして透明度を格納します。basic を使用する OBJ ファイルからロードされます。 Ka/Kd/Ke 宣言です。.
PhongMaterialMethods LambertMaterial specular colour と shininess（specular exponent）を備えています。これらを使用する OBJ ファイルからロードされます。 Ks/Ns 宣言です。.
PbrMaterialPhysically Based Rendering material です。albedo、metallic factor、roughness factor、そして関連テクスチャを格納します。glTF 2.0 およびその他の PBR 対応フォーマットで使用されます。.

カメラとライティング

MethodsMethods
CameraCamera エンティティです。Only projection_type and name このエディションで機能するのはこれだけです; 他のすべての numeric プロパティ (near_plane, far_plane, field_of_view, aspect_ratio) はデフォルト値を返すスタブです。Attached to a Node viewpoint transforms を定義するための.
Light光源エンティティ。継承元は Camera スタブクラスとして；その Light クラス自体はこのリリースで追加のプロパティを公開しません。.
LightTypeサポートされている光カテゴリの列挙: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.
ProjectionTypeカメラ投影モードの列挙: PERSPECTIVE および ORTHOGRAPHIC.

数学ユーティリティ

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

Methods

MethodsMethods
AnimationClip1つの再生範囲をカバーするアニメーションチャンネルのセットのための名前付きコンテナ。A Scene 複数のクリップ（例: “Walk”, “Run”）を保持できる。.
AnimationNodeバインドする AnimationClip 特定のシーンノードまたはプロパティにバインドします。クリップデータとシーングラフオブジェクト間の橋渡しとして機能します。.
AnimationChannelクリップ内の単一のアニメーションプロパティストリームで、オブジェクト上の名前付きプロパティを対象とします（例:., Transform.translation.x).
KeyFrame単一の時間–値サンプル KeyframeSequence.。時間（秒）とその時点の値を格納します。.
KeyframeSequence順序付けられたリスト KeyFrame 1つのスカラー チャネル用のオブジェクトと、補間および外挿設定を含みます。.
Interpolationキー フレーム間の補間モードの列挙: CONSTANT, LINEAR, BEZIER, B_SPLINE, CARDINAL_SPLINE, TCB_SPLINE.
ExtrapolationType最初および最後のキー フレームを超える動作の列挙: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, OSCILLATE.

フォーマット I/O

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

OBJ フォーマット

MethodsMethods
ObjImporterWavefront OBJ と MTL ファイルを解析する内部インポータークラス。自動的に呼び出されるのは Scene.from_file() 対象 .obj 拡張子。.
ObjLoadOptionsWavefront OBJ ファイルのロードオプション。主なプロパティ: flip_coordinate_system, scale, enable_materials, normalize_normal.
ObjSaveOptionsWavefront OBJ 出力の保存オプション。法線、UV、マテリアル参照、ポイントクラウドモードを制御します。.
ObjFormatWavefront OBJ のフォーマット記述子。次のようにアクセス可能: FileFormat.WAVEFRONT_OBJ().

STL フォーマット

MethodsMethods
StlImporterバイナリおよび ASCII STL ファイルの両方を読み取る内部インポーター。拡張子により自動的に選択されます。.
StlExporterSTL を書き出す内部エクスポーター。.
StlLoadOptionsSTL ファイルのロードオプション。サポート: flip_coordinate_system および scale.
StlSaveOptionsSTL 出力の保存オプション。コントロール binary_mode, scale,、および flip_coordinate_system.
StlFormatSTL のフォーマット記述子。.

glTF フォーマット

MethodsMethods
GltfLoadOptionsglTF 2.0 および GLB ファイルの読み込みオプション。キー プロパティ: flip_tex_coord_v.
GltfSaveOptionsglTF 2.0 出力の保存オプション。使用 binary_mode=True 自己完結型 GLB パッケージ用に。.
GltfFormatglTF 2.0 / GLB のフォーマット記述子。アクセス可能なものは FileFormat.GLTF2().

FBX フォーマット

MethodsMethods
FbxLoadOptionsFBX ファイルの読み込みオプション。キー プロパティ: keep_builtin_global_settings, compatible_mode.
FbxSaveOptionsFBX 出力の保存オプション。FBX エクスポートは無条件に NotImplementedError 無条件に；; FbxSaveOptions 存在しますが、エクスポートは実装されていません。.
FbxFormatFBX のフォーマット記述子。次のようにアクセスできます。 FileFormat.FBX7400ASCII().

COLLADA フォーマット

MethodsMethods
ColladaLoadOptionsCOLLADA のロードオプション（.dae）ファイル。インポート時に軸のリマッピングと単位スケールを制御します。.
ColladaSaveOptionsCOLLADA 出力の保存オプション。制御 indented, flip_coordinate_system,、およびマテリアルのエクスポート。.
ColladaFormatCOLLADA のフォーマット記述子。自動的に次から解決されます .dae ファイル拡張子。.

3MF Format

MethodsMethods
ThreeMfLoadOptions3MF のロードオプション（.3mf）ファイル。.
ThreeMfSaveOptions3MF 出力の保存オプション。3MF は 3D プリントワークフローに推奨されるフォーマットです。.
ThreeMfFormat3MF のフォーマット記述子。次のようにアクセス可能です FileFormat.MICROSOFT_3MF_FORMAT().

Methods

MethodsMethods
TextureMappingテクスチャがジオメトリにどのようにマッピングされるかを識別します：: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT,、等。.
BooleanOperationCSG ブール演算タイプ：: UNION, DIFFERENCE, INTERSECTION.

プロパティシステム

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

画像とレンダリング

MethodsMethods
ImageRenderOptionsシーンをイメージバッファにレンダリングする際のソフトウェアラスタライズオプションです。背景色、画像サイズ、カメラ参照を保存します。. Scene.render() 例外を送出する NotImplementedError; このリリースではレンダリングは実装されていません。.

関連項目

 日本語