Αναφορά API για aspose-3d-foss 26.1.0 (Java 21+, άδεια MIT).
Όλες οι κλάσεις βρίσκονται στο com.aspose.threed βασικό πακέτο. Η βασική εισαγωγή είναι:
Διάταξη πακέτου: Σχεδόν όλες οι δημόσιες κλάσεις βρίσκονται στο com.aspose.threed. Το μόνο υπο-πακέτο που χρησιμοποιείται συνήθως είναι com.aspose.threed.shading (για PbrMaterial). Το com.aspose.threed.formats υπο-πακέτο περιέχει εσωτερικούς εισαγωγείς/εξαγωγείς και δεν εισάγεται συνήθως άμεσα.
Σύμβαση ονοματοδοσίας Java: Όλες οι ιδιότητες χρησιμοποιούν μεθόδους getter/setter. Για παράδειγμα, χρησιμοποιήστε node.getTransform() αντί για node.transform, και transform.setTranslation(...) αντί για transform.translation = .... Σημειώστε ότι Vector3, Vector4, Quaternion, Matrix4, και FVector τύποι χρησιμοποιούν δημόσια πεδία (v.x, v.y, v.z) αντί για getters για πρόσβαση σε στοιχεία.
Κύριο Γράφημα Σκηνής
| Enumerations | Enumerations |
|---|
Scene | Κύριο δοχείο για όλα τα δεδομένα σκηνής 3D. Περιέχει τον ριζικό κόμβο, τα μεταδεδομένα του περιουσιακού στοιχείου και τα κλιπ κίνησης. Εκθέτει fromFile(), open(), και save() ως τα κύρια σημεία εισόδου/εξόδου. |
Node | Ένας ονομασμένος κόμβος στην ιεραρχία της σκηνής. Κατέχει μια λίστα παιδικών κόμβων και μια λίστα προσαρτημένων Entity αντικειμένων όπως πλέγματα, κάμερες και φωτισμοί. Φέρει ένα τοπικό Transform. |
Entity | Αφηρημένη βασική κλάση για όλα τα αντικείμενα που μπορούν να προσαρτηθούν σε ένα Node. Παρέχει όνομα και ταυτότητα αλλά δεν έχει δική του γεωμετρία. |
SceneObject | Βασική κλάση κοινή για Node και Entity. |
A3DObject | Βασική κλάση ρίζας για όλα τα διαχειριζόμενα αντικείμενα Aspose.3D. Εκθέτει την ιδιότητα name και το Properties σύνολο. |
INamedObject | Διεπαφή που εγγυάται ένα getName() μέθοδο. Υλοποιείται από Node, Entity, και αρκετούς τύπους περιγραφέων ειδικών για μορφές. |
Γεωμετρία και Πλέγμα
| Enumerations | Enumerations |
|---|
Mesh | Οντότητα πλέγματος πολυγώνου. Αποθηκεύει σημεία ελέγχου (θέσεις κορυφών ως Vector4), λίστες προσώπων πολυγώνων (λίστες δεικτών σημείων ελέγχου), και στρώματα στοιχείων κορυφής (κανονικές, UVs, χρώματα κορυφής). |
Geometry | Αφηρημένη βάση για τύπους γεωμετρίας τύπου πλέγματος. Ορίζει τον πίνακα σημείων ελέγχου και τη συλλογή των VertexElement στρωμάτων. Mesh κληρονομεί από Geometry. |
VertexElement | Αφηρημένη βάση για μια στρώση δεδομένων που συνδέεται με τη γεωμετρία (normals, UVs, colours, κ.λπ.). Μεταφέρει getMappingMode(), getReferenceMode(), και μια λίστα δεδομένων. |
VertexElementNormal | Αποθηκεύει ένα διάνυσμα κανονικής ανά κορυφή ή ανά γωνία πολυγώνου, ανάλογα με τη λειτουργία αντιστοίχισης. Οι τιμές δεδομένων είναι Vector4 παραδείγματα με w αχρησιμοποίητα. |
VertexElementUV | Αποθηκεύει ζεύγη συντεταγμένων υφής (Vector2) ανά κορυφή ή ανά γωνία πολυγώνου. Ένα πλέγμα μπορεί να περιέχει πολλαπλές στρώσεις UV για διαφορετικά κανάλια υφής. |
VertexElementVertexColor | Αποθηκεύει δεδομένα χρώματος RGBA ανά κορυφή ή ανά γωνία ως Vector4 (r, g, b, a στο εύρος 0–1). |
VertexElementType | Απαρίθμηση που προσδιορίζει τον σημασιολογικό ρόλο μιας στρώσης στοιχείου κορυφής: NORMAL, UV, VERTEX_COLOR, και άλλα. Περνάτε τιμές στο Mesh.getElement(). |
MappingMode | Απαρίθμηση που ελέγχει σε ποιο primitive αντιστοιχεί μια τιμή στοιχείου κορυφής: CONTROL_POINT, POLYGON_VERTEX, ή POLYGON. |
ReferenceMode | Απαρίθμηση που ελέγχει πώς ευρετηριάζονται οι τιμές: DIRECT (μία τιμή ανά primitive αντιστοίχισης) ή INDEX_TO_DIRECT (πίνακας τιμών συν ξεχωριστό πίνακα δεικτών). |
Μετασχηματισμός και Χώρος
| Enumerations | Enumerations |
|---|
Transform | Τοπικός μετασχηματισμός προσαρτημένος σε ένα Node. Παρέχει μετάφραση, περιστροφή (ως Quaternion), και συνιστώσες κλίμακας, συν μεθόδους ευκολίας για γωνίες Euler. |
GlobalTransform | Προβολή μόνο για ανάγνωση του μετασχηματισμού του κόμβου σε παγκόσμιο χώρο μετά τη σύνθεση όλων των μετασχηματισμών προγόνων. Πρόσβαση μέσω node.getGlobalTransform(). |
AssetInfo | Μπλοκ μεταδεδομένων προσαρτημένο σε ένα Scene. Αποθηκεύει το όνομα της εφαρμογής δημιουργίας, το όνομα της μονάδας, τον συντελεστή κλίμακας της μονάδας, τους ορισμούς των αξόνων του συστήματος συντεταγμένων και τις χρονικές σφραγίδες δημιουργίας/τροποποίησης. |
Υλικά και Σκίαση
| Enumerations | Enumerations |
|---|
Material | Αφηρημένη βασική κλάση για όλους τους τύπους υλικών. Παρέχει ένα όνομα και μια συλλογή ιδιοτήτων για αριθμητικές και χρωματικές παραμέτρους. |
PbrMaterial | Υλικό Φυσικής Βάσης Σχεδίασης. Αποθηκεύει την αλμπέδο, τον μεταλλικό συντελεστή, τον συντελεστή τραχύτητας, το εκπεμπόμενο χρώμα, τη διαφάνεια και τις σχετικές υφές. Χρησιμοποιείται από το glTF 2.0 και άλλες μορφές που υποστηρίζουν PBR. Εισαγωγή: com.aspose.threed.shading.PbrMaterial. |
Enumerations
| Enumerations | Enumerations |
|---|
Camera | Οντότητα κάμερας. Κληρονομεί από Entity. Δεν εκτίθενται ιδιότητες ειδικές για μορφές στην έκδοση Java FOSS πέραν του κληρονομημένου ονόματος και της συλλογής ιδιοτήτων. Προσαρτάται σε ένα Node για τον ορισμό των μετασχηματισμών του σημείου θέασης. |
Σημείωση: Enumerations Light η κλάση δεν είναι διαθέσιμη στην έκδοση Java του Aspose.3D FOSS. Τα δεδομένα φωτισμού σκηνής από εισαγόμενα αρχεία αποθηκεύονται ως γενικά Entity αντικείμενα.
Μαθηματικά Εργαλεία
| Enumerations | Enumerations |
|---|
Vector2 | Διπλής ακρίβειας δι-συστατικό διάνυσμα (x, y). Χρησιμοποιείται για συντεταγμένες υφής UV. |
Vector3 | Διπλής ακρίβειας τρι-συστατικό διάνυσμα (x, y, z). Χρησιμοποιείται για θέσεις, κατευθύνσεις και κλίμακα. |
Vector4 | Διπλής ακρίβειας τετρα-συστατικό διάνυσμα (x, y, z, w). Χρησιμοποιείται για σημεία ελέγχου (ομογενείς θέσεις) και δεδομένα κανονικών. |
FVector3 | Διάνυσμα float μονής ακρίβειας με 3 συνιστώσες. Εμφανίζεται σε πίνακες δεδομένων στοιχείων κορυφής για κανονικές και εφαπτόμενες. |
FVector4 | Διάνυσμα float μονής ακρίβειας με 4 συνιστώσες. Ο τύπος αποθήκευσης του VertexElementFVector δεδομένα. |
Quaternion | Μονάδα τετραδίου για την αναπαράσταση περιστροφών (w, x, y, z). Χρησιμοποιείται από Transform.getRotation(). |
Matrix4 | 4x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions. |
BoundingBox | Πλαίσιο περιβάλλουσας ευθυγραμμισμένο με τους άξονες ορισμένο από getMinimum() και getMaximum() Vector3 γωνίες. Χρησιμοποιείται για χωρικά ερωτήματα και βοηθητικά εργαλεία αποκοπής οπτικού πεδίου. |
Enumerations
| Enumerations | Enumerations |
|---|
AnimationClip | Ονομαστικό δοχείο για μια περιοχή κίνησης. Ένα Scene μπορεί να περιέχει πολλαπλά κλιπ (π.χ., “Walk”, “Run”). Απόσπασμα δήλωσης — τα δεδομένα κλειδιών-πλαισίων και η αναπαραγωγή δεν έχουν ακόμη υλοποιηθεί. |
Είσοδος/Έξοδος Μορφής
| Enumerations | Enumerations |
|---|
Scene.fromFile(path) | Στατική μέθοδος. Ανοίγει το αρχείο στο path, εντοπίζει τη μορφή από την επέκταση και επιστρέφει ένα γεμάτο Scene. Εξαίρεση όταν το αρχείο δεν βρεθεί ή η μορφή δεν υποστηρίζεται. |
Scene.open(path, options) | Μέθοδος στιγμιοτύπου. Ανοίγει ένα αρχείο σε ένα υπάρχον Scene στιγμιότυπο, προαιρετικά χρησιμοποιώντας ένα μορφο-συγκεκριμένο LoadOptions υποκλάση. |
Scene.save(path, options) | Μέθοδος στιγμιοτύπου. Σειριοποιεί τη σκηνή σε path χρησιμοποιώντας τη μορφή που προκύπτει από την επέκταση, προαιρετικά χρησιμοποιώντας μια μορφή-συγκεκριμένη SaveOptions υποκλάση. |
FileFormat | Κατάλογος υποστηριζόμενων μορφών αρχείων. Περιέχει εγγραφές όπως FileFormat.WAVEFRONT_OBJ(), FileFormat.GLTF2(), FileFormat.FBX7400ASCII(). |
IOService | Εσωτερική αφαίρεση I/O που χρησιμοποιείται από εισαγωγείς και εξαγωγείς μορφών. Συνήθως δεν χρησιμοποιείται άμεσα από τον κώδικα της εφαρμογής. |
LoadOptions | Βασική κλάση για όλα τα αντικείμενα επιλογών φόρτωσης ειδικών για μορφές. Υποκλάση από ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions. |
SaveOptions | Βασική κλάση για όλα τα αντικείμενα επιλογών αποθήκευσης ειδικών για μορφές. Υποκλάση από ObjSaveOptions, StlSaveOptions, GltfSaveOptions. |
Μορφή OBJ
| Enumerations | Enumerations |
|---|
ObjImporter | Εσωτερική κλάση εισαγωγέα που αναλύει αρχεία Wavefront OBJ και MTL. Καλείται αυτόματα από Scene.fromFile() για .obj επεκτάσεις. |
ObjLoadOptions | Επιλογές φόρτωσης για αρχεία Wavefront OBJ. Κύρια χαρακτηριστικά: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal(). |
ObjSaveOptions | Επιλογές αποθήκευσης για έξοδο Wavefront OBJ. Ελέγχει τις κανονικές, τις UV, τις αναφορές υλικού και τη λειτουργία point‑cloud. |
ObjFormat | Περιγραφέας μορφής για Wavefront OBJ. Προσβάσιμο ως FileFormat.WAVEFRONT_OBJ(). |
Μορφή STL
| Enumerations | Enumerations |
|---|
StlImporter | Εσωτερικός εισαγωγέας που διαβάζει τόσο δυαδικά όσο και ASCII αρχεία STL. Επιλέγεται αυτόματα με βάση την επέκταση. |
StlExporter | Εσωτερικός εξαγωγέας που γράφει STL. |
StlLoadOptions | Επιλογές φόρτωσης για αρχεία STL. Υποστηρίζει setFlipCoordinateSystem(), setRecalculateNormal(), και setContentType(). |
StlSaveOptions | Επιλογές αποθήκευσης για έξοδο STL. Ελέγχει setFlipCoordinateSystem(), setAxisSystem(), και setContentType(). |
StlFormat | Περιγραφέας μορφής για STL. |
Μορφή glTF
| Enumerations | Enumerations |
|---|
GltfLoadOptions | Φόρτωση επιλογών για αρχεία glTF 2.0 και GLB. Κύρια χαρακτηριστικά: setFlipCoordinateSystem(), setPrettyPrint(). |
GltfSaveOptions | Αποθήκευση επιλογών για έξοδο glTF 2.0 και GLB. Χρησιμοποιήστε setContentType(FileContentType.BINARY) για να δημιουργήσετε ένα αυτόνομο .glb πακέτο. |
GltfFormat | Περιγραφέας μορφής για glTF 2.0 / GLB. Προσβάσιμο ως FileFormat.GLTF2(). |
Μορφή FBX
Το FBX υποστηρίζεται για μόνο εισαγωγή. Η εξαγωγή σε FBX δεν είναι διαθέσιμη στην έκδοση Java FOSS.
| Enumerations | Enumerations |
|---|
FbxLoadOptions | Επιλογές φόρτωσης για αρχεία FBX. Κύρια ιδιότητα: setFlipCoordinateSystem(). |
FbxFormat | Περιγραφέας μορφής για FBX. Προσβάσιμο ως FileFormat.FBX7400ASCII(). |
Enumerations
| Enumerations | Enumerations |
|---|
Axis | Αναγνωρίζει έναν άξονα συντεταγμένων: X_AXIS, Y_AXIS, Z_AXIS. Χρησιμοποιείται στις επιλογές επαναχαρτογράφησης του συστήματος συντεταγμένων. |
CoordinateSystem | Καθορίζει τη σύμβαση δεξιόχειρας/αριστερόχειρας: RIGHT_HANDED ή LEFT_HANDED. |
TextureMapping | Αναγνωρίζει πώς απεικονίζεται μια υφή στη γεωμετρία: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, κλπ. |
BooleanOperation | Τύπος λογικής λειτουργίας CSG: UNION, DIFFERENCE, INTERSECTION. |
Σύστημα Ιδιοτήτων
| Enumerations | Enumerations |
|---|
Property | Μία μόνο ονομασμένη ιδιότητα τύπου σε ένα A3DObject. Αποθηκεύει το όνομα της ιδιότητας, τον περιγραφέα τύπου και την τρέχουσα τιμή. |
PropertyCollection | Επανάξιμη συλλογή των Property αντικείμενα προσαρτημένα σε ένα A3DObject. Υποστηρίζει αναζήτηση κατά όνομα και επανάληψη σε όλες τις ορισμένες ιδιότητες. |
CustomObject | Ένα ελαφρύ A3DObject υποκλάση που φέρει μόνο ένα όνομα και ένα αυθαίρετο PropertyCollection. Χρησιμοποιείται για την αποθήκευση μεταδεδομένων που ορίζονται από τον χρήστη σε αντικείμενα σκηνής. |
Εικόνα και Απόδοση
| Enumerations | Enumerations |
|---|
ImageRenderOptions | Επιλογές για software rasterisation κατά την απόδοση μιας σκηνής σε image buffer. Αποθηκεύει το χρώμα φόντου, τις διαστάσεις της εικόνας και την αναφορά της κάμερας. Αυτή η λειτουργία είναι διαθέσιμη σε υποστηριζόμενες ρυθμίσεις. |
Δείτε επίσης
