Aspose.3D FOSS for .NET

Αναφορά API για Aspose.3D 26.1.0 (.NET 10.0+, άδεια MIT).

Όλες οι κλάσεις βρίσκονται στο Aspose.ThreeD ριζικό namespace. Η ριζική οδηγία using είναι:

using Aspose.ThreeD;

Συμβατική ονομασίας C#: Όλες οι ιδιότητες χρησιμοποιούν την τυπική σύνταξη ιδιοτήτων C#. Για παράδειγμα, χρησιμοποιήστε scene.RootNode αντί για scene.getRootNode(), και transform.Translation = ... αντί για transform.setTranslation(...).

Κεφαλοποίηση πεδίου διανύσματος: Η βιβλιοθήκη διαθέτει δύο σύνολα τύπων διανυσμάτων. Aspose.ThreeD.Utilities.Vector2/3/4 (χρησιμοποιείται από Mesh.ControlPoints, γεωμετρία, και τις περισσότερες μαθηματικές λειτουργίες) είναι διπλής ακρίβειας με πεζά δημόσια πεδία (v.x, v.y, v.z, v.w). Ο απλούστερος Aspose.ThreeD.Vector2/3/4 structs (in Vector.cs) είναι μονής ακρίβειας (float) με κεφαλαία δημόσια πεδία (v.X, v.Y, v.Z). FVector2/3/4 και Quaternion και Matrix4 χρησιμοποιήστε πρόσβαση πεδίου με κεφαλαία γράμματα. Aspose.ThreeD.Utilities τύποι για εργασία γεωμετρίας.


Κύριο Γράφημα Σκηνής

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

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

MethodsMethods
MeshΟντότητα πλέγματος πολυγώνου. Αποθηκεύει σημεία ελέγχου (θέσεις κορυφών ως Vector4), λίστες προσώπων πολυγώνων (λίστες δεικτών σημείων ελέγχου), και στρώματα στοιχείων κορυφής (normals, UVs, vertex colours).
GeometryΑφηρημένη βάση για τύπους γεωμετρίας τύπου πλέγματος. Ορίζει τον πίνακα σημείων ελέγχου και τη συλλογή των VertexElement στρωμάτων. Mesh κληρονομεί από Geometry.
VertexElementΑφηρημένη βάση για μια στρώση δεδομένων που συνδέεται με τη γεωμετρία (normals, UVs, colours, κ.λπ.). Μεταφέρει MappingMode, ReferenceMode, και μια λίστα δεδομένων.
VertexElementNormalΑποθηκεύει ένα διάνυσμα κανονικής ανά κορυφή ή ανά γωνία πολυγώνου, ανάλογα με τη λειτουργία αντιστοίχισης.
VertexElementUVΑποθηκεύει ζεύγη συντεταγμένων υφής (Vector2) ανά κορυφή ή ανά γωνία πολυγώνου.
VertexElementVertexColorΑποθηκεύει δεδομένα χρώματος RGBA ανά κορυφή ή ανά γωνία ως Vector4.

Ενσωματωμένα Πρωτότυπα

MethodsMethods
BoxΠαραμετρικό κουτί ευθυγραμμισμένο με τους άξονες με ρυθμιζόμενο πλάτος, ύψος και βάθος. Μπορεί να προσαρτηθεί σε ένα Node απευθείας ή μετατρεπόμενο σε Mesh μέσω ToMesh().
SphereΠαραμετρική σφαίρα με ρυθμιζόμενη ακτίνα. Υποστηρίζει ToMesh() μετατροπή.
CylinderΠαραμετρικός κύλινδρος με ρυθμιζόμενη άνω ακτίνα, κάτω ακτίνα και ύψος. Υποστηρίζει ToMesh() μετατροπή.

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

MethodsMethods
TransformΤοπικός μετασχηματισμός προσαρτημένος σε ένα Node. Παρέχει Translation (FVector3), Rotation (Quaternion), Scale (FVector3), και Matrix (Matrix4) ιδιότητες.
GlobalTransformΠροβολή μόνο για ανάγνωση του πίνακα μετασχηματισμού του κόμβου σε παγκόσμιο χώρο μετά τη σύνθεση όλων των μετασχηματισμών προγόνων. Πρόσβαση μέσω node.GlobalTransform. Εκθέτει ένα μόνο Matrix ιδιότητα.
AssetInfoΜπλοκ μεταδεδομένων προσαρτημένο σε ένα Scene. Κληρονομεί από A3DObject παρέχοντας Name και Properties. Δεν ορίζονται πρόσθετες ιδιότητες σε αυτήν την έκδοση.

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

MethodsMethods
MaterialΑφηρημένη βασική κλάση για όλους τους τύπους υλικού. Παρέχει ένα όνομα και μια συλλογή ιδιοτήτων.
LambertMaterialΚλασικό υλικό μόνο διασκορπισμού με Ambient, Diffuse, Emissive, Reflective, Transparency, και Texture ιδιότητες. Namespace: Aspose.ThreeD.Shading.
PhongMaterialΕπεκτείνει το Lambert με Specular, Shininess, και SpecularPower ιδιότητες. Namespace: Aspose.ThreeD.Shading.
PbrMaterialΥλικό Physically Based Rendering με BaseColor, Metallic, Roughness, Occlusion, και ιδιότητες θέσης υφής. Namespace: Aspose.ThreeD.Shading.

Methods

MethodsMethods
CameraΟντότητα κάμερας. Κληρονομεί από Frustum. Συνδεδεμένο με ένα Node για τον ορισμό μετασχηματισμών οπτικού σημείου. Δεν εκτίθενται ιδιότητες ειδικές για μορφή σε αυτήν την έκδοση.

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

MethodsMethods
Vector2Διπλή ακρίβεια 2-component vector (lowercase fields: x, y). Χώρος ονομάτων: Aspose.ThreeD.Utilities. Χρησιμοποιείται για συντεταγμένες υφής UV.
Vector3Διπλή ακρίβεια 3-component vector (lowercase fields: x, y, z). Χώρος ονομάτων: Aspose.ThreeD.Utilities. Γενικού σκοπού διανύσματος χώρου για γεωμετρία.
Vector4Διπλή ακρίβεια 4-component vector (lowercase fields: x, y, z, w). Χώρος ονομάτων: Aspose.ThreeD.Utilities. Χρησιμοποιείται για Mesh.ControlPoints και κανονικά δεδομένα.
FVector3Μονοακρίβεια 3-συστατικό float διάνυσμα (κεφαλαία πεδία: X, Y, Z). Χρησιμοποιείται από Transform.Translation και Transform.Scale.
FVector4Διάνυσμα float 4-συστατικών μονής ακρίβειας (κεφαλαία πεδία: X, Y, Z, W).
QuaternionΜονάδα τετραδόνιο για την αναπαράσταση περιστροφών (W, X, Y, Z). Χρησιμοποιείται από Transform.Rotation.
Matrix44x4 transformation matrix. Used for world/local transform computations and by GlobalTransform.Matrix.
BoundingBoxΠλαίσιο περιβάλλουσας ευθυγραμμισμένο με τους άξονες ορισμένο από Minimum και Maximum FVector3 γωνίες.

Methods

MethodsMethods
AnimationClipΟνομασμένο δοχείο για ένα εύρος κίνησης. A Scene μπορεί να περιέχει πολλαπλά κλιπ. Πρότυπο δήλωσης — τα δεδομένα keyframe και η αναπαραγωγή δεν έχουν ακόμη υλοποιηθεί.

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

MethodsMethods
Scene.Open(path)Ανοίγει ένα αρχείο, εντοπίζει τη μορφή από την επέκταση και συμπληρώνει τη σκηνή.
Scene.Open(path, options)Ανοίγει ένα αρχείο με μορφή-συγκεκριμένο LoadOptions.
Scene.Open(stream)Ανοίγει από ροή, ανιχνεύοντας αυτόματα τη μορφή από το περιεχόμενο.
Scene.Open(stream, options)Ανοίγει από ροή με μορφή-συγκεκριμένο LoadOptions.
Scene.Save(path)Αποθηκεύει τη σκηνή σε αρχείο· η μορφή προκύπτει από την επέκταση.
Scene.Save(path, options)Αποθηκεύει με μορφή-συγκεκριμένο SaveOptions.
Scene.Save(stream, options)Αποθηκεύει σε ροή με μορφή-συγκεκριμένο SaveOptions.
FileFormatΚατάλογος υποστηριζόμενων μορφών αρχείων. Χρησιμοποιήστε FileFormat.Formats (ένα IList<FileFormat>) για την απαρίθμηση όλων των υποστηριζόμενων μορφών, ή FileFormat.Detect(fileName) για την ανίχνευση μιας μορφής με βάση το όνομα αρχείου. Οι ονομαστικές σταθερές (ObjFormat, GltfFormat, FbxFormat, κ.λπ.) είναι internal και δεν είναι προσβάσιμος από τον κώδικα του χρήστη.
IOServiceΕσωτερική αφαίρεση I/O. Παρέχει DetectFormat() για ανίχνευση μορφής με βάση τη ροή.
LoadOptionsΒασική κλάση για επιλογές φόρτωσης ειδικές για μορφή.
SaveOptionsΒασική κλάση για επιλογές αποθήκευσης ειδικές για μορφή.

Μορφή OBJ

MethodsMethods
ObjLoadOptionsΦόρτωση επιλογών για αρχεία Wavefront OBJ.
ObjSaveOptionsΑποθήκευση επιλογών για έξοδο Wavefront OBJ.

Μορφή STL

MethodsMethods
StlLoadOptionsΦόρτωση επιλογών για αρχεία STL.
StlSaveOptionsΑποθήκευση επιλογών για έξοδο STL.

Μορφή glTF

MethodsMethods
GltfLoadOptionsΦόρτωση επιλογών για αρχεία glTF 2.0 και GLB.
GltfSaveOptionsΕπιλογές αποθήκευσης για έξοδο glTF 2.0 και GLB. Δεν εκτίθενται ιδιότητες ειδικές για τη μορφή σε αυτήν την έκδοση· χρησιμοποιήστε .glb επέκταση για δυαδική έξοδο.

Μορφή FBX

MethodsMethods
FbxLoadOptionsΕπιλογές φόρτωσης για αρχεία FBX.
FbxSaveOptionsΕπιλογές αποθήκευσης για έξοδο FBX. Η εξαγωγή FBX παράγει πάντα δυαδική έξοδο· η εξαγωγή FBX σε ASCII δεν είναι ενεργή σε αυτήν την έκδοση.

3MF Format

MethodsMethods
TmfLoadOptionsΕπιλογές φόρτωσης για αρχεία 3MF.
TmfSaveOptionsΕπιδιόρθωση επιλογών αποθήκευσης για έξοδο 3MF.

Methods

MethodsMethods
FileContentTypeΠεριγραφέας τύπου περιεχομένου: ASCII, Binary. Διαθέσιμο ως ιδιότητα σε FileFormat.
AxisΑναγνωρίζει έναν άξονα συντεταγμένων: XAxis, YAxis, ZAxis.
CoordinateSystemΚαθορίζει τη σύμβαση αριστερό/δεξιόχειρας: RightHand ή LeftHand.

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

MethodsMethods
PropertyΜία μόνο ονομασμένη ιδιότητα τύπου σε ένα A3DObject.
PropertyCollectionΕπανάξιμη συλλογή από Property αντικείμενα προσαρτημένα σε ένα A3DObject.

Δείτε επίσης

 Ελληνικά