Instalcja

Instalacja Aspose.3D FOSS dla Python

Aspose.3D FOSS dla Python jest dystrybuowany jako czysty pakiet Python na PyPI. Nie ma natywnych rozszerzeń do kompilacji, żadnych bibliotek systemowych do instalacji oraz nie wymaga Microsoft Office ani innych środowisk uruchomieniowych firm trzecich.

Wymagania wstępne

1. Install via pip (Recommended)

Najprostszym sposobem instalacji Aspose.3D FOSS jest bezpośrednio z PyPI:

pip install aspose-3d-foss

pip pobierze i zainstaluje pakiet oraz zapisze go w twoim środowisku. Nie jest wymagana żadna konfiguracja po instalacji.

Aby zainstalować określoną wersję dla powtarzalnych kompilacji:

pip install aspose-3d-foss==26.1.0

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

Użycie wirtualnego środowiska utrzymuje bibliotekę odizolowaną od innych projektów Python i zapobiega konfliktom wersji.

Utwórz i aktywuj wirtualne środowisko:

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

Zainstaluj bibliotekę wewnątrz aktywowanego środowiska:

pip install aspose-3d-foss

Zapisz zależności dla powtarzalności:

pip freeze > requirements.txt

Aby odtworzyć środowisko na innym komputerze:

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

3. Verify the Installation

Po instalacji zweryfikuj, czy biblioteka importuje się poprawnie:

from aspose.threed import Scene

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

Oczekiwany wynik:

Aspose.3D FOSS installed successfully
Root node name:

Uwaga: Węzeł główny nie ma domyślnej nazwy — scene.root_node.name zwraca pusty ciąg znaków.

Możesz także sprawdzić zainstalowaną wersję przy pomocy pip:

pip show aspose-3d-foss

To wypisze wersję, autora oraz licencję (MIT).

Szybki start: Załaduj scenę i zbadaj ją

Poniższy skrypt ładuje plik 3D, wypisuje informacje o każdym węźle siatki i ponownie eksportuje scenę do formatu 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")

Jeśli nie masz jeszcze pliku OBJ, biblioteka może także utworzyć scenę od podstaw:

from aspose.threed import Scene

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

Uwagi dotyczące platformy

Windows, macOS, Linux: Biblioteka jest identyczna na wszystkich platformach. Nie ma specyficznych dla platform ścieżek kodu ani rozszerzeń binarnych.

Docker / serverless: Ponieważ nie ma zależności od pakietów systemowych, biblioteka działa w lekkich obrazach Docker (takich jak python:3.12-slim) bez instalowania dodatkowych pakietów apt lub yum.

CI/CD: Dodaj pip install aspose-3d-foss do kroku zależności w Twoim potoku CI. Nie wymaga dodatkowej konfiguracji.

Conda: Jeśli Twój projekt używa Conda, zainstaluj bibliotekę z PyPI wewnątrz środowiska Conda:

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

Dodatkowe zasoby

• Strona produktu: Przegląd, podsumowanie funkcji i opinie
• Przewodnik programisty: Kompletny opis API z przykładami kodu
• Funkcje i funkcjonalności: Obsługa formatów, graf scen, materiały, narzędzia matematyczne i więcej