Installation

Python 3.7 à 3.12 : Installez avec ‘pip install aspose-3d-foss’.

Aspose.3D FOSS pour Python est distribué comme un paquet pure-Python sur PyPI. Il n’y a aucune extension native à compiler, aucune bibliothèque système à installer, et aucun Microsoft Office ou autre environnement d’exécution tiers requis.

Prérequis

1. Install via pip (Recommended)

La façon la plus simple d’installer Aspose.3D FOSS est directement depuis PyPI :

pip install aspose-3d-foss

pip téléchargera et installera le paquet et l’enregistrera dans votre environnement. Aucune configuration post‑installation n’est nécessaire.

Pour installer une version figée pour des builds reproductibles :

pip install aspose-3d-foss==26.1.0

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

Utiliser un environnement virtuel maintient la bibliothèque isolée des autres projets Python et évite les conflits de version.

Créez et activez un environnement virtuel :

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

Installez la bibliothèque dans l’environnement activé :

pip install aspose-3d-foss

Enregistrez les dépendances pour la reproductibilité :

pip freeze > requirements.txt

Pour recréer l’environnement sur une autre machine :

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

3. Verify the Installation

Après l’installation, vérifiez que la bibliothèque s’importe correctement :

from aspose.threed import Scene

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

La production attendue :

Aspose.3D FOSS installed successfully
Root node name: RootNode

Vous pouvez également vérifier la version installée avec pip :

pip show aspose-3d-foss

Cela affichera la version, l’auteur et la licence (MIT).

Démarrage rapide : charger une scène et l’inspecter

Le script suivant charge un fichier 3D, affiche les informations sur chaque nœud de maillage et réexporte la scène au format 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")

Si vous n’avez pas encore de fichier OBJ, la bibliothèque peut également créer une scène à partir de zéro :

from aspose.threed import Scene

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

Notes sur la plateforme

Windows, macOS, Linux: La bibliothèque est identique sur toutes les plateformes. Il n’existe aucun chemin de code spécifique à une plateforme ni d’extensions binaires.

Docker / serverless: Comme il n’y a aucune dépendance de paquets système, la bibliothèque fonctionne à l’intérieur d’images Docker allégées (comme python:3.12-slim) sans installer de paquets apt ou yum supplémentaires.

CI/CD: Ajoutez pip install aspose-3d-foss à l’étape de dépendances de votre pipeline CI. Aucun paramétrage supplémentaire n’est requis.

Conda: Si votre projet utilise Conda, installez la bibliothèque depuis PyPI dans un environnement Conda :

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

Ressources supplémentaires

• Page produit: Aperçu, résumé des fonctionnalités et témoignages
• Guide du développeur: Référence complète de l’API avec des exemples de code
• Fonctionnalités et capacités: Prise en charge des formats, graphe de scène, matériaux, utilitaires mathématiques, et plus