Aspose.3D FOSS
Python
Ξεκινώντας
Εγκατάσταση

Εγκατάσταση

Εισαγωγή Aspose.3D FOSS για Python

Το Aspose.3D FOSS για Python διανέμεται ως ένα καθαρό πακέτο Pythona στο PyPI. Δεν υπάρχουν εγχώριες επέκτασης που να συντάσσονται, δεν υπάρχουν βιβλιοθήκες συστήματος που θα εγκατασταθούν και δεν απαιτείται Microsoft Office ή άλλος χρόνος εκτέλεσης τρίτων μερών.

Προϋποθέσεις

ΑΠΑΙΤΗΣΕΙΣΛεπτομέρειες
Πιθανική έκδοση3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
Διαχειριστής πακέτωνPip (συνδεδεμένο με CPython)
λειτουργικό σύστημαWindows, macOS, Linux (κάθε πλατφόρμα που εκτελεί το CPython)
Επαναφορά / εργαλείων κατασκευήςΚανένα απαιτείται
Σύστημα πακέτωνΚανένα απαιτείται

1. Install via pip (Recommended)

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

asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.

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

Για να εγκαταστήσετε μια επιφανειακή έκδοση για αναπαραγωγικές δομές:

asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.

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

Χρησιμοποιώντας ένα εικονικό περιβάλλον, η βιβλιοθήκη απομονώθηκε από άλλα έργα 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

Εισάγετε τη βιβλιοθήκη μέσα στο ενεργοποιημένο περιβάλλον:

asposefoss/3d is not yet published — build from source until it ships. See the project README for build instructions.

Αξιολόγηση για την αναπαραγωγικότητα:

pip freeze > requirements.txt

Για να αναδημιουργήσετε το περιβάλλον σε άλλη μηχανή:

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

3. Verify the Installation

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

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

Γρήγορη έναρξη: Κατεβάστε μια σκηνή και ελέγξτε την

Το ακόλουθο σενάριο φορτώνει ένα αρχείο 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, η βιβλιοθήκη μπορεί επίσης να δημιουργήσει μια σκηνή από το scratch:

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

Ετικέτες / serverless: Επειδή δεν υπάρχουν εξαρτήσεις συστημάτων-πακέτο, η βιβλιοθήκη λειτουργεί μέσα σε λεπτές εικόνες Docker (όπως: python:3.12-slimχωρίς την εγκατάσταση πρόσθετων πακέτων apt ή yum.

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

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

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

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

 Ελληνικά