Aspose.3D FOSS for Python

Αναφορά API για aspose-3d-foss 26.1.0 (Python 3.7 – 3.12, άδεια MIT).

Όλες οι κλάσεις εισάγονται από το aspose.threed πακέτο ή τα υποπακέτα του. Η ριζική εισαγωγή είναι:

import aspose.threed
##or selectively:
from aspose.threed import Scene, Node
from aspose.threed.entities import Mesh, Camera, Light
from aspose.threed.formats import ObjLoadOptions, StlSaveOptions, GltfSaveOptions
from aspose.threed.utilities import Vector3, Matrix4, BoundingBox
from aspose.threed.animation import AnimationClip, KeyFrame

Βασικό Γράφημα Σκηνής

Methods	Methods
`Scene`	Κοντέινερ ανώτερου επιπέδου για όλα τα δεδομένα σκηνής 3D. Περιέχει τον ριζικό κόμβο, τα μεταδεδομένα του περιουσιακού στοιχείου και τα κλιπ κίνησης. Εκθέτει `from_file()`, `open()`, και `save()` ως τα κύρια σημεία εισόδου/εξόδου.
`Node`	Ένας ονομασμένος κόμβος στην ιεραρχία της σκηνής. Κατέχει μια λίστα παιδικών κόμβων και μια λίστα προσαρτημένων `Entity` αντικειμένων όπως πλέγματα, κάμερες και φωτισμοί. Φέρει ένα τοπικό `Transform`.
`Entity`	Αφηρημένη βασική κλάση για όλα τα αντικείμενα που μπορούν να προσαρτηθούν σε ένα `Node`. Παρέχει όνομα και ταυτότητα αλλά δεν έχει δική του γεωμετρία.
`SceneObject`	Βασική κλάση κοινή για `Node` και `Entity`. Παρέχει τη διεπαφή συλλογής ιδιοτήτων που χρησιμοποιείται για μεταδεδομένα ορισμένα από τον χρήστη.
`A3DObject`	Βασική ριζική κλάση για όλα τα διαχειριζόμενα αντικείμενα Aspose.3D. Εκθέτει την ιδιότητα name και το `Properties` συλλογή.
`INamedObject`	Διεπαφή που εγγυάται ένα `name` ιδιότητα. Υλοποιείται από `Node`, `Entity`, και αρκετούς τύπους περιγραφέων ειδικών για μορφές.

Γεωμετρία και Πλέγμα

Methods	Methods
`Mesh`	Οντότητα πολυγωνικού πλέγματος. Αποθηκεύει σημεία ελέγχου (θέσεις κορυφών ως `Vector4`), λίστες προσώπων πολυγώνων (λίστες δεικτών σημείων ελέγχου) και στρώματα στοιχείων κορυφής (normals, UVs, vertex colours).
`Geometry`	Αφηρημένη βάση για τύπους γεωμετρίας τύπου πλέγματος. Ορίζει τον πίνακα σημείων ελέγχου και τη συλλογή των `VertexElement` στρωμάτων. `Mesh` κληρονομεί από `Geometry`.
`VertexElement`	Αφηρημένη βάση για ένα στρώμα δεδομένων που συνδέεται με τη γεωμετρία (normals, UVs, colours, κ.λπ.). Φέρει `mapping_mode`, `reference_mode`, και ένα `data` λίστα.
`VertexElementNormal`	Αποθηκεύει ένα διάνυσμα κανονικής ανά κορυφή ή ανά γωνία πολυγώνου, ανάλογα με `mapping_mode`. Οι τιμές δεδομένων είναι `FVector4` στιγμιότυπα (μονής ακρίβειας) με `w` αχρησιμοποίητα.
`VertexElementUV`	Αποθηκεύει δεδομένα συντεταγμένων υφής ως `FVector4` ανά κορυφή ή ανά γωνία πολυγώνου (μόνο `x` και `y` συστατικά χρησιμοποιούνται για UV). Ένα πλέγμα μπορεί να περιέχει πολλαπλά στρώματα UV για διαφορετικά κανάλια υφής.
`VertexElementVertexColor`	Αποθηκεύει δεδομένα χρώματος RGBA ανά κορυφή ή ανά γωνία ως `FVector4` (r, g, b, a στο εύρος 0–1).
`VertexElementSmoothingGroup`	Αποθηκεύει ακέραια IDs ομάδων εξομάλυνσης ανά πολύγωνο, που χρησιμοποιούνται από τον εισαγωγέα OBJ για την αναπαραγωγή των αρχικών αναθέσεων ομάδων εξομάλυνσης από το αρχείο προέλευσης.
`VertexElementType`	Απαρίθμηση που προσδιορίζει τον σημασιολογικό ρόλο του επιπέδου στοιχείου κορυφής: `NORMAL`, `UV`, `VERTEX_COLOR`, `SMOOTHING_GROUP`, και άλλα. Περνάτε τιμές σε `Mesh.get_element()`.
`MappingMode`	Απαρίθμηση που ελέγχει σε ποιο primitive αντιστοιχεί η τιμή ενός στοιχείου κορυφής: `CONTROL_POINT`, `POLYGON_VERTEX`, `POLYGON`, `EDGE`, ή `ALL_SAME`.
`ReferenceMode`	Απαρίθμηση που ελέγχει πώς ευρετηριάζονται οι τιμές: `DIRECT` (μία τιμή ανά primitive αντιστοίχισης) ή `INDEX_TO_DIRECT` (πίνακας τιμών συν ξεχωριστό πίνακα δεικτών).
`PolygonModifier`	Στατική βοηθητική κλάση με μεθόδους για τριγωνοποίηση `Mesh` αντικειμένων και ολόκληρων `Scene` γραφών.

Μετασχηματισμός και Χώρος

Methods	Methods
`Transform`	Τοπικός μετασχηματισμός προσαρτημένος σε ένα `Node`. Παρέχει μετάφραση, περιστροφή (ως `Quaternion`), και συνιστώσες κλίμακας, καθώς και ιδιότητες ευκολίας για γωνίες Euler.
`GlobalTransform`	Προβολή μόνο για ανάγνωση του μετασχηματισμού σε παγκόσμιο χώρο ενός κόμβου μετά τη σύνθεση όλων των μετασχηματισμών προγόνων. Πρόσβαση μέσω `Node.global_transform`.
`AssetInfo`	Μπλοκ μεταδεδομένων προσαρτημένο σε ένα `Scene`. Αποθηκεύει το όνομα της εφαρμογής δημιουργίας, το όνομα μονάδας, τον συντελεστή κλίμακας μονάδας, τους ορισμούς αξόνων του συστήματος συντεταγμένων, και τις χρονικές σημάνσεις δημιουργίας/τροποποίησης.

Υλικά και Σκίαση

Methods	Methods
`Material`	Αφηρημένη βασική κλάση για όλους τους τύπους υλικού. Παρέχει ένα όνομα και μια συλλογή ιδιοτήτων για αριθμητικές και χρωματικές παραμέτρους.
`LambertMaterial`	Μοντέλο υλικού μόνο διασκορπισμού. Αποθηκεύει το περιβάλλον χρώμα, το χρώμα διασκορπισμού, το εκπεμπόμενο χρώμα και τη διαφάνεια. Φορτώνεται από αρχεία OBJ που χρησιμοποιούν βασικές `Ka`/`Kd`/`Ke` δηλώσεις.
`PhongMaterial`	Methods `LambertMaterial` με καθρεπτικό χρώμα και λάμψη (εξάπλωση καθρεπτικού). Φορτώνεται από αρχεία OBJ που χρησιμοποιούν `Ks`/`Ns` δηλώσεις.
`PbrMaterial`	Υλικό Physically Based Rendering. Αποθηκεύει το άλμπεντο, τον μεταλλικό παράγοντα, τον παράγοντα τραχύτητας και τις σχετικές υφές. Χρησιμοποιείται από το glTF 2.0 και άλλες μορφές που υποστηρίζουν PBR.

Κάμερα και Φωτισμός

Methods	Methods
`Camera`	Οντότητα κάμερας. Μόνο `projection_type` και `name` λειτουργούν σε αυτήν την έκδοση· όλες οι άλλες αριθμητικές ιδιότητες (`near_plane`, `far_plane`, `field_of_view`, `aspect_ratio`) είναι ψευδο-συναρτήσεις που επιστρέφουν προεπιλεγμένες τιμές. Συνδεδεμένο με ένα `Node` για τον ορισμό των μετασχηματισμών του σημείου θέασης.
`Light`	Οντότητα πηγής φωτός. Κληρονομεί από `Camera` ως κλάση ψευδο-συνάρτησης· η `Light` η ίδια κλάση δεν εκθέτει πρόσθετες ιδιότητες σε αυτήν την έκδοση.
`LightType`	Απαρίθμηση των υποστηριζόμενων κατηγοριών φωτός: `POINT`, `DIRECTIONAL`, `SPOT`, `AREA`, `VOLUME`.
`ProjectionType`	Απαρίθμηση των τρόπων προβολής της κάμερας: `PERSPECTIVE` και `ORTHOGRAPHIC`.

Βοηθητικά Μαθηματικά

Methods	Methods
`Vector2`	Διπλής ακρίβειας δι-συστατικό διάνυσμα (`x`, `y`). Χρησιμοποιείται για συντεταγμένες UV υφής.
`Vector3`	Διπλής ακρίβειας τρι-συστατικό διάνυσμα (`x`, `y`, `z`). Χρησιμοποιείται για θέσεις, κατευθύνσεις και κλίμακα.
`Vector4`	Διπλής ακρίβειας 4-συστατικό διάνυσμα (`x`, `y`, `z`, `w`). Χρησιμοποιείται για σημεία ελέγχου (ομογενείς θέσεις) και normal data.
`FVector2`	Μονο-ακρίβειας 2-συστατικό float διάνυσμα. Χρησιμοποιείται εσωτερικά για συμπαγή αποθήκευση σε vertex element data arrays.
`FVector3`	Μονο-ακρίβειας 3-συστατικό float διάνυσμα. Εμφανίζεται σε vertex element data arrays για normals και tangents.
`FVector4`	Διάνυσμα float 4-συστατικών μονής ακρίβειας. Ο τύπος αποθήκευσης του `VertexElementFVector.data`.
`Quaternion`	Μονάδα quaternion για την αναπαράσταση περιστροφών (`w`, `x`, `y`, `z`). Χρησιμοποιείται από `Transform.rotation`.
`Matrix4`	4×4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
`BoundingBox`	Πλαίσιο περιέλιξης ευθυγραμμισμένο με τους άξονες, ορισμένο από `minimum` και `maximum` `Vector3` γωνίες. Χρησιμοποιείται για χωρικά ερωτήματα και βοηθητικά εργαλεία αποκοπής του φραστού.

Methods

Methods	Methods
`AnimationClip`	Ονομαστικό κοντέινερ για ένα σύνολο αναπνεόμενων καναλιών που καλύπτουν μία περιοχή αναπαραγωγής. Ένα `Scene` μπορεί να περιέχει πολλαπλά κλιπ (π.χ., “Walk”, “Run”).
`AnimationNode`	Δέσμευση ενός `AnimationClip` σε έναν συγκεκριμένο κόμβο σκηνής ή ιδιότητα. Λειτουργεί ως γέφυρα μεταξύ των δεδομένων του κλιπ και των αντικειμένων του γραφήματος σκηνής.
`AnimationChannel`	Μία ενιαία ροή αναπνεόμενης ιδιότητας μέσα σε ένα κλιπ, που στοχεύει σε μια ονομασμένη ιδιότητα σε ένα αντικείμενο (π.χ., `Transform.translation.x`).
`KeyFrame`	Ένα ενιαίο δείγμα χρόνου‑τιμής μέσα σε ένα `KeyframeSequence`. Αποθηκεύει το χρόνο (σε δευτερόλεπτα) και την τιμή εκείνη τη στιγμή.
`KeyframeSequence`	Μια διατεταγμένη λίστα από `KeyFrame` αντικείμενα για ένα scalar κανάλι, μαζί με ρυθμίσεις παρεμβολής και εξωπαρεμβολής.
`Interpolation`	Απαρίθμηση των τρόπων παρεμβολής μεταξύ βασικών καρέ: `CONSTANT`, `LINEAR`, `BEZIER`, `B_SPLINE`, `CARDINAL_SPLINE`, `TCB_SPLINE`.
`ExtrapolationType`	Απαρίθμηση των συμπεριφορών πέρα από το πρώτο και το τελευταίο keyframe: `CONSTANT`, `GRADIENT`, `CYCLE`, `CYCLE_RELATIVE`, `OSCILLATE`.

Είσοδος/Έξοδος Μορφής

Methods	Methods
`Scene.from_file(path)`	Στατική μέθοδος. Ανοίγει το αρχείο στο `path`, εντοπίζει τη μορφή από την επέκταση και επιστρέφει ένα γεμισμένο `Scene`. Εγείρει σφάλμα όταν το αρχείο δεν βρεθεί ή η μορφή δεν υποστηρίζεται.
`Scene.open(path, options=None)`	Instance method. Ανοίγει ένα αρχείο σε ένα υπάρχον `Scene` στιγμιότυπο, προαιρετικά χρησιμοποιώντας ένα μορφο-συγκεκριμένο `LoadOptions` υποκλάση.
`Scene.save(path, options=None)`	Instance method. Σειριοποιεί τη σκηνή σε `path` χρησιμοποιώντας τη μορφή που προκύπτει από την επέκταση, προαιρετικά χρησιμοποιώντας ένα μορφο-συγκεκριμένο `SaveOptions` υποκλάση.
`FileFormat`	Κατάλογος υποστηριζόμενων μορφών αρχείων. Περιέχει εγγραφές όπως `FileFormat.WAVEFRONT_OBJ`, `FileFormat.GLTF`, `FileFormat.FBX7400ASCII`, `FileFormat.MICROSOFT_3MF`. Οι μορφο-συγκεκριμένες παραλλαγές προσπελάζονται μέσω κλάσεων επιλογών (π.χ., `ColladaSaveOptions`, `GltfSaveOptions`).
`IOService`	Εσωτερική αφαίρεση I/O που χρησιμοποιείται από εισαγωγείς και εξαγωγείς μορφών. Συνήθως δεν χρησιμοποιείται άμεσα από τον κώδικα της εφαρμογής.
`LoadOptions`	Base class for all format-specific load-option objects. Υποκλάση από `ObjLoadOptions`, `StlLoadOptions`, `GltfLoadOptions`, `FbxLoadOptions`, `ColladaLoadOptions`, `ThreeMfLoadOptions`.
`SaveOptions`	Base class for all format-specific save-option objects. Υποκλάση από `ObjSaveOptions`, `StlSaveOptions`, `GltfSaveOptions`, `FbxSaveOptions`, `ColladaSaveOptions`, `ThreeMfSaveOptions`.

Μορφή OBJ

Methods	Methods
`ObjImporter`	Εσωτερική κλάση εισαγωγέα που αναλύει αρχεία Wavefront OBJ και MTL. Καλείται αυτόματα από `Scene.from_file()` για `.obj` επεκτάσεις.
`ObjLoadOptions`	Επιλογές φόρτωσης για αρχεία Wavefront OBJ. Κύρια χαρακτηριστικά: `flip_coordinate_system`, `scale`, `enable_materials`, `normalize_normal`.
`ObjSaveOptions`	Αποθήκευση επιλογών για έξοδο Wavefront OBJ. Ελέγχει τις κανονικές, τα UV, τις αναφορές υλικού και τη λειτουργία point‑cloud.
`ObjFormat`	Περιγραφέας μορφής για Wavefront OBJ. Προσβάσιμο ως `FileFormat.WAVEFRONT_OBJ()`.

Μορφή STL

Methods	Methods
`StlImporter`	Εσωτερικός εισαγωγέας που διαβάζει τόσο δυαδικά όσο και ASCII αρχεία STL. Επιλέγεται αυτόματα με βάση την επέκταση.
`StlExporter`	Εσωτερικός εξαγωγέας που γράφει STL.
`StlLoadOptions`	Επιλογές φόρτωσης για αρχεία STL. Υποστηρίζει `flip_coordinate_system` και `scale`.
`StlSaveOptions`	Επιλογές αποθήκευσης για έξοδο STL. Ελέγχει `binary_mode`, `scale`, και `flip_coordinate_system`.
`StlFormat`	Περιγραφέας μορφής για STL.

Μορφή glTF

Methods	Methods
`GltfLoadOptions`	Επιλογές φόρτωσης για αρχεία glTF 2.0 και GLB. Κύρια ιδιότητα: `flip_tex_coord_v`.
`GltfSaveOptions`	Επιλογές αποθήκευσης για έξοδο glTF 2.0. Χρησιμοποιήστε `binary_mode=True` για ένα αυτόνομο πακέτο GLB.
`GltfFormat`	Περιγραφέας μορφής για glTF 2.0 / GLB. Προσβάσιμο ως `FileFormat.GLTF2()`.

Μορφή FBX

Methods	Methods
`FbxLoadOptions`	Επιλογές φόρτωσης για αρχεία FBX. Κύριες ιδιότητες: `keep_builtin_global_settings`, `compatible_mode`.
`FbxSaveOptions`	Επιλογές αποθήκευσης για έξοδο FBX. Η εξαγωγή FBX προκαλεί `NotImplementedError` ανεξάρτητα; `FbxSaveOptions` υπάρχει αλλά η εξαγωγή δεν έχει υλοποιηθεί.
`FbxFormat`	Περιγραφέας μορφής για FBX. Προσβάσιμο ως `FileFormat.FBX7400ASCII()`.

Μορφή COLLADA

Methods	Methods
`ColladaLoadOptions`	Επιλογές φόρτωσης για COLLADA (`.dae`) αρχεία. Ελέγχει την επανασχεδίαση αξόνων και την κλίμακα μονάδων κατά την εισαγωγή.
`ColladaSaveOptions`	Αποθήκευση επιλογών εξόδου COLLADA. Έλεγχοι `indented`, `flip_coordinate_system`, και εξαγωγή υλικού.
`ColladaFormat`	Περιγραφέας μορφής για COLLADA. Λύνεται αυτόματα από `.dae` επέκταση αρχείου.

3MF Format

Methods	Methods
`ThreeMfLoadOptions`	Φόρτωση επιλογών για 3MF (`.3mf`) αρχεία.
`ThreeMfSaveOptions`	Αποθήκευση επιλογών για έξοδο 3MF. Το 3MF είναι η προτιμώμενη μορφή για ροές εργασίας 3D εκτύπωσης.
`ThreeMfFormat`	Περιγραφέας μορφής για 3MF. Προσβάσιμο ως `FileFormat.MICROSOFT_3MF_FORMAT()`.

Methods

Methods	Methods
`TextureMapping`	Καθορίζει πώς απεικονίζεται μια υφή στη γεωμετρία: `DIFFUSE`, `SPECULAR`, `EMISSIVE`, `NORMAL`, `AMBIENT`, κλπ.
`BooleanOperation`	Τύπος λογικής πράξης CSG: `UNION`, `DIFFERENCE`, `INTERSECTION`.

Σύστημα Ιδιοτήτων

Methods	Methods
`Property`	Μία μοναδική ονομαστική ιδιότητα τύπου σε ένα `A3DObject`. Αποθηκεύει το όνομα της ιδιότητας, τον περιγραφέα τύπου και την τρέχουσα τιμή.
`PropertyCollection`	Επανάξιμη συλλογή από `Property` αντικείμενα συνδεδεμένα σε ένα `A3DObject`. Υποστηρίζει αναζήτηση κατά όνομα και επανάληψη σε όλες τις ορισμένες ιδιότητες.
`CustomObject`	Μια ελαφριά `A3DObject` υποκατηγορία που μεταφέρει μόνο ένα όνομα και ένα αυθαίρετο `PropertyCollection`. Χρησιμοποιείται για την αποθήκευση μεταδεδομένων ορισμένων από τον χρήστη σε αντικείμενα σκηνής.

Εικόνα και Απόδοση

Methods Methods

ImageRenderOptions Επιλογές λογισμικού ραστεροποίησης κατά την απόδοση μιας σκηνής σε buffer εικόνας. Αποθηκεύει το χρώμα φόντου, τις διαστάσεις της εικόνας και την αναφορά της κάμερας. Scene.render() εγείρει NotImplementedError; η απόδοση δεν έχει υλοποιηθεί σε αυτήν την έκδοση.

Methods	Methods
`ImageRenderOptions`	Επιλογές λογισμικού ραστεροποίησης κατά την απόδοση μιας σκηνής σε buffer εικόνας. Αποθηκεύει το χρώμα φόντου, τις διαστάσεις της εικόνας και την αναφορά της κάμερας. `Scene.render()` εγείρει `NotImplementedError`; η απόδοση δεν έχει υλοποιηθεί σε αυτήν την έκδοση.

Aspose.3D FOSS for Python

Βασικό Γράφημα Σκηνής

Γεωμετρία και Πλέγμα

Μετασχηματισμός και Χώρος

Υλικά και Σκίαση

Κάμερα και Φωτισμός

Βοηθητικά Μαθηματικά

Methods

Είσοδος/Έξοδος Μορφής

Μορφή OBJ

Μορφή STL

Μορφή glTF

Μορφή FBX

Μορφή COLLADA

3MF Format

Methods

Σύστημα Ιδιοτήτων

Εικόνα και Απόδοση

Δείτε επίσης