Aspose.3D FOSS for Java

Αναφορά API για: αψόζης-3d-foss 26.1.0 (Java 21+, άδεια MIT).

Όλες οι τάξεις βρίσκονται στο com.aspose.threed Το πακέτο ρίζας.:

import 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) παρά για την πρόσβαση σε στοιχεία.


Γράφιο Κεντρικής Σκηνής

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

Γεωμετρία και Δαχτυλόπλεγμα

ΤάξηΠεριγραφή:
MeshΠολυγωνική οντότητα πλέγματος. Αποθηκεύει σημεία ελέγχου (τοποθεσίες κορυφών ως Vector4), λίστες προσώπων πολυγώνων (λίστας δείκτων σημείων ελέγχου) και στρώματα στοιχείων κορυφής (κανονικά, υπεριώδη φασόλια, χρώμα κορύφου).
GeometryΑπεκτελώς βάση για τύπους γεωμετρίας που μοιάζουν με πλέγματα. Ορίζει τον φάκελο σημείων ελέγχου και τη συλλογή των VertexElement στρώματα. Mesh κληρονομεί από: Geometry.
VertexElementΑπεκτευτική βάση για ένα επίπεδο δεδομένων που συνδέεται με τη γεωμετρία (κανονικά, υπεριώδη ακτινοβολία, χρώματα κλπ.). 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Καταγραφή που ελέγχει ποια πρωτόγονη τιμή ενός στοιχείου κορυφής αντιστοιχεί σε: CONTROL_POINT, POLYGON_VERTEX, ή POLYGON.
ReferenceModeΚαταγραφή που ελέγχει τον τρόπο κατάρτισης των τιμών: DIRECT (μία τιμή ανά πρωτόγονη χαρτογράφησης) ή INDEX_TO_DIRECT (αριθμός τιμών συν ένα ξεχωριστό δείκτη πίνακα).

Μετασχηματισμός και χωροταξικότητα

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

Υλικά και Σκιές

ΤάξηΠεριγραφή:
MaterialΑπεκτελεσμένη βασική τάξη για όλους τους τύπους υλικών. Παρέχει όνομα και συλλογή ιδιότητες για αριθμητικές και χρωματικές παραμέτρους.
PbrMaterialΧρησιμοποιείται από το glTF 2.0 και άλλες μορφές που είναι ικανές για PBR. Εισαγωγή: com.aspose.threed.shading.PbrMaterial.

Καμερα

ΤάξηΠεριγραφή:
CameraΚληρονομιά από την… Entity.Δεν υπάρχουν συγκεκριμένες ιδιότητες μορφότυπου στην έκδοση Java FOSS πέρα από την κληρονομιά του ονόματος και τη συλλογή ιδιοτήτων. Node να ορίσουμε μετασχηματισμούς από άποψη.

Σημείωση: Η Light Η κατηγορία δεν είναι διαθέσιμη στην έκδοση Java του Aspose.3D FOSS. Τα δεδομένα φωτισμού σκηνής από εισαγόμενα αρχεία αποθηκεύονται ως γενικά Entity αντικείμενα.


Εφαρμογές μαθηματικών

ΤάξηΠεριγραφή:
Vector2Δύο-συμπεριεχόμενο δρομολόγιο διπλής ακρίβειας (x, yΧρησιμοποιείται για συντεταγμένες υφής UV.
Vector3Δύο-κρίσιμος 3-συμπεριεχόμενος διανυσματικός φορέας (x, y, zΓενικά χρησιμοποιείται για θέσεις, κατευθύνσεις και κλίμακα.
Vector4Δύο-κρίβεια τετρατροπικός διανυσματικός φορέας (x, y, z, w) Χρησιμοποιείται για σημεία ελέγχου (ομοιόμορφα σημεί­ματα) και κανονικά δεδομένα.
FVector3Μονοτεκτικό 3-συμπεριεχόμενο πλωτό διανυσματικό. εμφανίζεται σε συστοιχίες δεδομένων στοιχείων κορυφής για κανονικές και τσιγγάντιες.
FVector4Ο τύπος αποθήκευσης του αλκοολούχου οχήματος είναι: VertexElementFVector δεδομένα.
QuaternionΕνότητα τεταρτηρίου για την εκτέλεση περιστροφών (w, x, y, z) Χρησιμοποιείται από: Transform.getRotation().
Matrix44x4 double-precision transformation matrix. Used for world/local transform computations and can be constructed from TRS decompositions.
BoundingBoxΟρισμός του οριακού πλαισίου σε ευθυγράμμιση με τον άξονα: getMinimum() και β) getMaximum() ΟρβηγίαVector3 Χρησιμοποιούνται για χωρικές ερωτήσεις και βοηθά στην απομάκρυνση του φρούστου.

Ζωγραφισμοί

ΤάξηΠεριγραφή:
AnimationClipΟνομασμένος δοχείο για μια σειρά κινούμενων σχεδίων. Scene μπορεί να περιέχει πολλαπλές κολλητικές συσκευές (π.χ., “Walk”, “Run”). Κεφάλαιο της δήλωσης τα δεδομένα keyframe και η αναπαραγωγή δεν έχουν ακόμη εφαρμοστεί.

Μορφή Ε/Ε

ΣύμβολοΠεριγραφή:
Scene.fromFile(path)Στατική μέθοδος. Ανοίγει το αρχείο στο path, εντοπίζει τη μορφή από την επέκταση, και επιστρέφει ένα συμπληρωμένο Scene. Ρίχνει σε αρχείο που δεν βρέθηκε ή όχι υποστηριζόμενο.
Scene.open(path, options)Μέθοδος Instance. Ανοίγει ένα αρχείο σε υπάρχον αρχεία Scene Η εν λόγω παραγωγή είναι διαθέσιμη σε όλες τις συσκευές. LoadOptions Υποκλάση.
Scene.save(path, options)Μεθοδος παραδείγματος. path χρησιμοποιώντας τη μορφή που προκύπτει από την επέκταση, κατά επιλογή με χρήση συγκεκριμένου μορφότυπου SaveOptions Υποκλάση.
FileFormatΜητρώο υποστηριζόμενων μορφών αρχείων. Περιέχει καταχωρίσεις όπως: FileFormat.WAVEFRONTOBJ, FileFormat.GLTF2, FileFormat.FBX7400ASCII.
IOServiceΕσωτερική απογραφή I/O που χρησιμοποιείται από τους εισαγωγείς και εξαγωγείς μορφότυπου. Δεν χρησιμοποιούνται συνήθως απευθείας από τον κώδικα εφαρμογής.
LoadOptionsΒασική τάξη για όλα τα αντικείμενα επιλογής φόρτωσης ειδικής μορφής. Υποταξιολογείται από: ObjLoadOptions, StlLoadOptions, GltfLoadOptions, FbxLoadOptions.
SaveOptionsΒασική τάξη για όλα τα αντικείμενα επιλογής αποθήκευσης ειδικής μορφής. Υποταξία από: ObjSaveOptions, StlSaveOptions, GltfSaveOptions.

Φόρμα OBJ

ΤάξηΠεριγραφή:
ObjImporterΕσωτερική κλάση εισαγωγέα που αναλύει τα αρχεία Wavefront OBJ και MTL. Καλείται αυτόματα από το Scene.fromFile() για το .obj παρατάσεις.
ObjLoadOptionsΕπιλογές φόρτωσης για τα αρχεία Wavefront OBJ. Κλειδικές ιδιότητες: setFlipCoordinateSystem(), setScale(), setEnableMaterials(), setNormalizeNormal().
ObjSaveOptionsΔιατηρεί επιλογές για την έξοδο Wavefront OBJ. Ελέγχει τα φυσιολογικά, UVs, αναφορές υλικών και λειτουργία point-cloud.
ObjFormatΠεριγραφή μορφότυπου για Wavefront OBJ. Διαθέσιμη ως FileFormat.WAVEFRONTOBJ.

Σχήμα STL

ΤάξηΠεριγραφή:
StlImporterΕσωτερικός εισαγωγέας που διαβάζει και τα δύο αρχεία STL binary και ASCII. Επιλέγεται αυτόματα με επέκταση.
StlExporterΕσωτερικός εξαγωγέας που γράφεται STL.
StlLoadOptionsΕπιλογές φόρτωσης για αρχεία STL. Υποστηρίζει setFlipCoordinateSystem(), setRecalculateNormal(), και setContentType().
StlSaveOptionsΑποθηκεύστε επιλογές για την έξοδο STL. Ελέγχοι setFlipCoordinateSystem(), setAxisSystem(), και setContentType().
StlFormatΠεριγραφή μορφότυπου για STL.

Φόρμα glTF

ΤάξηΠεριγραφή:
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.

ΤάξηΠεριγραφή:
FbxLoadOptionsΕπιλογές φόρτωσης για τα αρχεία FBX. Κλειδί ιδιοκτησία: setFlipCoordinateSystem().
FbxFormatΠεριγραφή μορφότυπου για FBX. Διαθέσιμη ως FileFormat.FBX7400ASCII.

Καταγραφές

ΚαταγραφήΠεριγραφή:
AxisΑναγνωρίζει άξονα συντεταγμένων: X_AXIS, Y_AXIS, Z_AXIS.Χρησιμοποιείται στις επιλογές επανασχεδιασμού συστημάτων συντεταγμένων.
CoordinateSystemΕιδική σύμβαση χειροκίνησης: RIGHT_HANDED ή LEFT_HANDED.
TextureMappingΑναγνωρίζει πώς μια υφή χαρτογραφείται στη γεωμετρία: DIFFUSE, SPECULAR, EMISSIVE, NORMAL, AMBIENT, κλπ.
BooleanOperationCSG Τύπος λειτουργίας του Boolean: UNION, DIFFERENCE, INTERSECTION.

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

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

Εικόνα και Αντιστοιχία

ΤάξηΠεριγραφή:
ImageRenderOptionsΕπιλογές για ραστερίωση λογισμικού κατά την απεικόνιση μιας σκηνής σε ένα μπουφέ εικόνας. Αποθηκεύει χρώμα φόντου, διαστάσεις εικαστικής και αναφορά της κάμερας. Σημείωση: Όλες οι μέθοδοι αναπαραγωγής πετάγονται UnsupportedOperationException στην έκδοση FOSS· η απεικόνιση δεν είναι διαθέσιμη.

Βλέπε επίσης:

 Ελληνικά