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

1. Install via pip (Recommended)

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

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:

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:

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

• Ürün Sayfası: Genel bakış, özellik özeti ve referanslar
• Geliştirici Kılavuzu: Kod örnekleriyle tam API referansı
• Özellikler ve İşlevsellikler: Biçim desteği, sahne grafiği, materyaller, matematik yardımcı programları ve daha fazlası