インストール
Aspose.3D FOSS for Python のインストール
Aspose.3D FOSS for Python は PyPI 上で pure-Python パッケージとして配布されています。コンパイルすべきネイティブ拡張はなく、インストールすべきシステムライブラリもなく、Microsoft Office やその他サードパーティのランタイムも必要ありません。.
前提条件
| 要件 | 詳細 |
|---|---|
| Python バージョン | 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12 |
| パッケージマネージャー | pip (CPython に同梱) |
| オペレーティングシステム | Windows、macOS、Linux（CPython が動作するすべてのプラットフォーム） |
| コンパイラ / ビルドツール | 不要 |
| システムパッケージ | 不要 |
1. Install via pip (Recommended)
最も簡単な Aspose.3D FOSS のインストール方法は、直接 PyPI からです：:
pip install aspose-3d-fosspip がパッケージをダウンロードしてインストールし、環境に記録します。インストール後の設定は不要です。.
再現性のあるビルドのために固定バージョンをインストールするには：:
pip install aspose-3d-foss==26.1.02. Set Up a Virtual Environment (Recommended for Projects)
仮想環境を使用することで、ライブラリが他の Python プロジェクトと分離され、バージョン競合を回避できます。.
仮想環境を作成し、アクティブ化します：:
##Create the environment
python -m venv .venv
##Activate on Linux / macOS
source .venv/bin/activate
##Activate on Windows (Command Prompt)
.venv\Scripts\activate.bat
##Activate on Windows (PowerShell)
.venv\Scripts\Activate.ps1アクティブ化された環境内にライブラリをインストールします：:
pip install aspose-3d-foss再現性のために依存関係を記録します：:
pip freeze > requirements.txt別のマシンで環境を再現するには：:
python -m venv .venv
source .venv/bin/activate # or the Windows equivalent
pip install -r requirements.txt3. Verify the Installation
インストール後、ライブラリが正しくインポートできるか確認します：:
from aspose.threed import Scene
scene = Scene()
print("Aspose.3D FOSS installed successfully")
print(f"Root node name: {scene.root_node.name}")期待される出力：:
Aspose.3D FOSS installed successfully
Root node name:注: ルートノードにはデフォルト名がありません — scene.root_node.name 空文字列を返します。.
pip を使ってインストールされているバージョンを確認することもできます:
pip show aspose-3d-fossこれによりバージョン、作者、ライセンス (MIT) が表示されます。.
クイックスタート: シーンをロードして検査する
以下のスクリプトは 3D ファイルを読み込み、各メッシュノードの情報を出力し、シーンを GLB 形式で再エクスポートします:
from aspose.threed import Scene
from aspose.threed.formats import ObjLoadOptions
##Load an OBJ file with material support
options = ObjLoadOptions()
options.enable_materials = True
options.flip_coordinate_system = False
scene = Scene()
scene.open("model.obj", options)
##Print the scene hierarchy
print(f"Top-level nodes: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
if node.entity is None:
continue
mesh = node.entity
print(f" Node: {node.name}")
print(f" Vertices: {len(mesh.control_points)}")
print(f" Polygons: {len(mesh.polygons)}")
if node.material:
print(f" Material: {type(node.material).__name__}")
##Re-export to GLB (binary glTF)
scene.save("output.glb")
print("Saved output.glb")まだ OBJ ファイルをお持ちでない場合、ライブラリはゼロからシーンを作成することもできます:
from aspose.threed import Scene
##Create an empty scene and save it as glTF
scene = Scene()
scene.save("empty.gltf")
print("Created empty.gltf")プラットフォームに関する注意点
Windows、macOS、Linux: このライブラリはすべてのプラットフォームで同一です。プラットフォーム固有のコードパスやバイナリ拡張はありません。.
Docker / サーバーレス：: システムパッケージの依存関係がないため、ライブラリはスリムな Docker イメージ（例えば python:3.12-slim）追加の apt や yum パッケージをインストールせずに動作します。.
CI/CD: 追加する pip install aspose-3d-foss CI パイプラインの依存ステップに追加してください。追加のセットアップは不要です。.
Conda：: プロジェクトで Conda を使用している場合は、Conda 環境内で PyPI からライブラリをインストールしてください:
conda create -n my-env python=3.12
conda activate my-env
pip install aspose-3d-foss