Aspose.3D FOSS
Python
Başlarken
Kurulum

Kurulum

Kurulum: Aspose.3D FOSS for Python

Aspose.3D FOSS for Python, PyPI’da saf-Python paketi olarak dağıtılmaktadır. Derlenecek yerel uzantı yok, kurulacak sistem kütüphanesi yok ve Microsoft Office ya da başka bir üçüncü‑taraf çalışma zamanı gerekmemektedir.

Ön Koşullar

GereksinimDetay
Python sürümü3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
Paket yöneticisipip (CPython ile birlikte gelir)
İşletim sistemiWindows, macOS, Linux (CPython çalışan herhangi bir platform)
Derleyici / derleme araçlarıGerek yok
Sistem paketleriGerek yok

1. Install via pip (Recommended)

En basit kurulum yöntemi, Aspose.3D FOSS’ı doğrudan PyPI’dan yüklemektir:

pip install aspose-3d-foss

pip paketi indirip kuracak ve ortamınıza kaydedecek. Kurulum sonrası yapılandırma gerekmez.

Tekrarlanabilir derlemeler için sabitlenmiş bir sürüm kurmak için:

pip install aspose-3d-foss==26.1.0

2. Set Up a Virtual Environment (Recommended for Projects)

Sanal ortam kullanmak, kütüphaneyi diğer Python projelerinden izole eder ve sürüm çakışmalarını önler.

Sanal ortam oluşturun ve etkinleştirin:

##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

Etkinleştirilmiş ortam içinde kütüphaneyi kurun:

pip install aspose-3d-foss

Tekrarlanabilirlik için bağımlılıkları kaydedin:

pip freeze > requirements.txt

Ortamı başka bir makinede yeniden oluşturmak için:

python -m venv .venv
source .venv/bin/activate   # or the Windows equivalent
pip install -r requirements.txt

3. Verify the Installation

Kurulumdan sonra, kütüphanenin doğru şekilde içe aktarıldığını doğrulayın:

from aspose.threed import Scene

scene = Scene()
print("Aspose.3D FOSS installed successfully")
print(f"Root node name: {scene.root_node.name}")

Beklenen çıktı:

Aspose.3D FOSS installed successfully
Root node name:

Not: Kök düğümün varsayılan adı yok — scene.root_node.name boş bir dize döndürür.

pip ile yüklü sürümü de kontrol edebilirsiniz:

pip show aspose-3d-foss

Bu, sürümü, yazarı ve lisansı (MIT) yazdıracaktır.

Hızlı Başlangıç: Bir Sahneyi Yükleyin ve İnceleyin

Aşağıdaki betik bir 3D dosyasını yükler, her bir ağ (mesh) düğümü hakkında bilgi yazdırır ve sahneyi GLB formatına yeniden dışa aktarır:

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")

Henüz bir OBJ dosyanız yoksa, kütüphane aynı zamanda sıfırdan bir sahne oluşturabilir:

from aspose.threed import Scene

##Create an empty scene and save it as glTF
scene = Scene()
scene.save("empty.gltf")
print("Created empty.gltf")

Platform Notları

Windows, macOS, Linux: Kütüphane tüm platformlarda aynıdır. Platforma özgü kod yolları veya ikili uzantılar yoktur.

Docker / sunucusuz: Sistem paketi bağımlılıkları olmadığından, kütüphane ince Docker görüntüleri içinde (örneğin python:3.12-slim) ek bir apt veya yum paketi kurmadan çalışır.

CI/CD: Ekle pip install aspose-3d-foss CI boru hattınızın bağımlılık adımına. Ek bir kurulum gerekmiyor.

Conda: Projeniz Conda kullanıyorsa, kütüphaneyi PyPI’dan bir Conda ortamı içinde kurun:

conda create -n my-env python=3.12
conda activate my-env
pip install aspose-3d-foss

Ek Kaynaklar

 Türkçe