Εγκατάσταση

Εγκατάσταση του Aspose.3D FOSS για Python

Το Aspose.3D FOSS για Python διανέμεται ως καθαρό πακέτο Python στο PyPI. Δεν υπάρχουν native extensions για μεταγλώττιση, δεν υπάρχουν system libraries για εγκατάσταση, και δεν απαιτείται Microsoft Office ή άλλο third‑party runtime.

Προαπαιτούμενα

1. Εγκατάσταση μέσω pip (Συνιστάται)

Ο πιο απλός τρόπος για να εγκαταστήσετε το Aspose.3D FOSS είναι απευθείας από το PyPI:

pip install aspose-3d-foss

Το pip θα κατεβάσει και θα εγκαταστήσει το πακέτο και θα το καταγράψει στο περιβάλλον σας. Δεν απαιτείται καμία διαμόρφωση μετά την εγκατάσταση.

Για την εγκατάσταση μιας σταθερής έκδοσης για επαναλήψιμες κατασκευές:

pip install aspose-3d-foss==26.1.0

2. Δημιουργία εικονικού περιβάλλοντος (Συνιστάται για έργα)

Η χρήση ενός εικονικού περιβάλλοντος διατηρεί τη βιβλιοθήκη απομονωμένη από άλλα έργα 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.txt

3. Επαλήθευση της εγκατάστασης

Μετά την εγκατάσταση, επαληθεύστε ότι η βιβλιοθήκη εισάγεται σωστά:

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

Γρήγορη έναρξη: Φόρτωση σκηνής και επιθεώρηση

Το παρακάτω script φορτώνει ένα αρχείο 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 / serverless: Επειδή δεν υπάρχουν εξαρτήσεις συστημικών πακέτων, η βιβλιοθήκη λειτουργεί μέσα σε ελαφριές εικόνες Docker (όπως python:3.12-slim) χωρίς την εγκατάσταση επιπλέον πακέτων apt ή yum.

CI/CD: Προσθέστε pip install aspose-3d-foss στο βήμα εξαρτήσεων του CI pipeline σας. Δεν απαιτείται πρόσθετη ρύθμιση.

Conda: Εάν το έργο σας χρησιμοποιεί Conda, εγκαταστήστε τη βιβλιοθήκη από το PyPI μέσα σε ένα περιβάλλον Conda:

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

Πρόσθετοι Πόροι

• Product Page: Επισκόπηση, σύνοψη χαρακτηριστικών και μαρτυρίες
• Developer Guide: Πλήρης αναφορά API με παραδείγματα κώδικα
• Features and Functionalities: Υποστήριξη μορφών, γράφημα σκηνής, υλικά, μαθηματικά βοηθήματα και άλλα