Aspose.3D FOSS for TypeScript

Αναφορά API για @aspose/3d έκδοση 24.12.0. Εγκατάσταση μέσω:

npm install @aspose/3d

Περιβάλλον εκτέλεσης: Node.js 18, 20, 22+ · Γλώσσα: TypeScript 5.0+ / JavaScript (CommonJS) · Άδεια: MIT

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

ImageRenderOptions

Το ριζικό κοντέινερ για μια 3Δ σκηνή. Κλήση scene.open() ή scene.openFromBuffer() για φόρτωση αρχείου, και scene.save() για εγγραφή εξόδου. Εκθέτει scene.rootNode ως το σημείο εισόδου στην ιεραρχία κόμβων.

ImageRenderOptions

Ένας ονομασμένος κόμβος στο δέντρο σκηνής. Κρατά ένα Transform, ένα προαιρετικό entity (πλέγμα, κάμερα, φως ή άλλο SceneObject), και μηδέν ή περισσότερους υποκόμβους προσβάσιμους μέσω childNodes.

ImageRenderOptions

Βασική κλάση για όλα τα αντικείμενα που μπορούν να προσαρτηθούν σε ένα Node ως κύρια οντότητα. Υποκλάση από Mesh, Camera, Light, και άλλα.

SceneObject

Αφηρημένη βάση για ονομασμένα αντικείμενα που ανήκουν σε σκηνή. Παρέχει το name παρακολούθηση ιδιοτήτων και συμμετοχής σε σκηνή που μοιράζεται από κόμβους, οντότητες και αντικείμενα επιπέδου περιουσιακών στοιχείων.

A3DObject

Κύρια βασική κλάση για όλα τα αντικείμενα Aspose.3D. Παρέχει το σύστημα ιδιοτήτων (getProperty, setProperty) και το name πεδίο που κληρονομείται από κάθε δημόσια κλάση.

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

ImageRenderOptions

Αντιπροσωπεύει ένα πλέγμα πολυγώνων. Περιέχει ένα controlPoints πίνακα των Vector4 κορυφών και ορισμών πολυγώνων που δημιουργούνται μέσω createPolygon(). Κλήση triangulate() για να μετατρέψετε όλα τα πολύγωνα σε τρίγωνα πριν από την εξαγωγή.

ImageRenderOptions

Βασική κλάση για όλους τους τύπους γεωμετρίας. Κρατά controlPoints και τη συλλογή των στοιχείων κορυφής (κανονικές, UV, χρώματα) που συνδέονται με τη γεωμετρία.

VertexElement

Βασική κλάση για κανάλια χαρακτηριστικών ανά κορυφή που συνδέονται με ένα Geometry. Οι υποκλάσεις περιέχουν πίνακες δεδομένων με τύπο και mappingMode / referenceMode μεταδεδομένα.

VertexElementNormal

Ένα VertexElement υποκλάση που αποθηκεύει τις κανονικές επιφάνειας. Τα δεδομένα αποθηκεύονται εσωτερικά ως FVector4[] (κληρονομείται από VertexElementFVector). Απαιτείται από τους περισσότερους renderers για σωστό φωτισμό.

VertexElementUV

Ένα VertexElement υποκλάση που αποθηκεύει 2D συντεταγμένες υφής. Ένα μόνο πλέγμα μπορεί να έχει πολλαπλά σύνολα UV για διαφορετικά στρώματα υφής.

VertexElementVertexColor

Ένα VertexElement υποκλάση που αποθηκεύει τιμές χρώματος RGBA ανά κορυφή.

VertexElementType

Απαρίθμηση των τύπων καναλιών χαρακτηριστικού που ένα VertexElement μπορεί να αντιπροσωπεύσει (π.χ., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

Απαρίθμηση που ελέγχει πώς τα δεδομένα στοιχείου αντιστοιχούν στη γεωμετρία: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, ή ALL_SAME.

ReferenceMode

Απαρίθμηση που ελέγχει πώς οι δείκτες στοιχείου αναφέρονται σε δεδομένα: DIRECT (one-to-one) ή INDEX_TO_DIRECT (μέσω ενός πίνακα δεικτών).

TextureMapping

Απαρίθμηση των σημασιολογιών καναλιού υφής: DIFFUSE, SPECULAR, NORMAL, EMISSIVE, BUMP, και άλλα.

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

ImageRenderOptions

Κρατά τη τοπική θέση (translation), περιστροφή (rotation ως Quaternion), και κλίμακα (scaling) ενός Node. Οι αλλαγές εδώ επηρεάζουν τον κόμβο και όλα τα παιδιά του.

GlobalTransform

Προβολή μόνο για ανάγνωση του μετασχηματισμού του κόμβου σε παγκόσμιο χώρο, υπολογιζόμενη με τη συσσώρευση όλων των προγόνων Transform τιμών. Πρόσβαση μέσω node.globalTransform.

BoundingBox

Ένα πλαίσιο οριοθέτησης ευθυγραμμισμένο με τους άξονες, ορισμένο από ένα minimum και maximum Vector3 γωνία. Χρησιμοποιείται για να περιγράψει την χωρική έκταση ενός πλέγματος ή μιας σκηνής.

ImageRenderOptions

Material, LambertMaterial, PhongMaterial, PbrMaterial

Το Material είναι η αφηρημένη βασική κλάση για όλους τους τύπους υλικών. Διατίθενται τρεις συγκεκριμένες υλοποιήσεις:

  • LambertMaterial — μόνο διασκορπισμού με κανάλια χρώματος περιβάλλοντος, διασκορπισμού και εκπομπής. Κατάλληλο για μη-κατοπτρικές επιφάνειες.
  • PhongMaterial — επεκτείνει LambertMaterial με ιδιότητες καθρεπτικού χρώματος και λαμπρότητας για σκίαση Phong.
  • PbrMaterial — υλικό απόδοσης βασισμένο στη φυσική με κανάλια metallic, roughness, base-color και normal-map. Αντιστοιχεί άμεσα στο μοντέλο υλικού glTF 2.0 PBR.

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

ImageRenderOptions

Μια οντότητα κόμβου οπτικού σημείου με τύπο προβολής, πεδίο όρασης, αποστάσεις αποκοπής κοντινής/μακρινής και ιδιότητες λόγου διαστάσεων.

ImageRenderOptions

Μια οντότητα κόμβου πηγής φωτός. Ο τύπος ελέγχεται από το LightType απαρίθμηση.

LightType

Απαρίθμηση των υποστηριζόμενων τύπων φωτός: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

Απαρίθμηση των τρόπων προβολής της κάμερας: PERSPECTIVE και ORTHOGRAPHIC.

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

ImageRenderOptions

Ένα τρι-συστατικό διάνυσμα floating-point με x, y, z πεδία και κοινές αριθμητικές μεθόδους (dot, cross, normalize, minus, times). Εξάγεται από @aspose/3d/utilities.

ImageRenderOptions

Ένα τετρα-συστατικό διάνυσμα floating-point με x, y, z, w πεδία. Χρησιμοποιείται ως τύπος καταχωρίσεων σε Mesh.controlPoints.

ImageRenderOptions

Ένα διπλό-συστατικό διάνυσμα double-precision με x και y πεδία. Χρησιμοποιείται για συντεταγμένες υφής UV.

FVector3

Ένα συμπαγές τρι-συστατικό διάνυσμα float μονής ακρίβειας που χρησιμοποιείται σε πίνακες δεδομένων στοιχείων κορυφών για κανονικές και εφαπτόμενες.

ImageRenderOptions

Ένας πίνακας μετασχηματισμού 4×4. Υποστηρίζει συνένωση, αντιστροφή, μεταθετική και αποσύνθεση σε συνιστώσες μετάφρασης, περιστροφής και κλίμακας. Εξάγεται από @aspose/3d/utilities.

ImageRenderOptions

Ένα μοναδιαίο quaternion για την αναπαράσταση περιστροφών χωρίς gimbal lock. Παρέχει slerp() για ομαλή παρεμβολή και μετατροπή προς/από γωνίες Euler και Matrix4. Εξάγεται από @aspose/3d/utilities.

ImageRenderOptions

AnimationClip

Μια ονομαστική, χρονικά περιορισμένη συλλογή από AnimationNode κομματιών. Ο κύριος δοχείο για δεδομένα κινούμενων καρέ που φορτώνονται από αρχεία FBX ή COLLADA.

AnimationNode

Μια ονομαστική λωρίδα κίνησης που στοχεύει σε συγκεκριμένη διαδρομή ιδιότητας σε ένα αντικείμενο σκηνής. Περιέχει ένα ή περισσότερα AnimationChannel αντικείμενα.

AnimationChannel

Ένα μοναδικό κανάλι κινούμενης ιδιότητας μέσα σε ένα AnimationNode. Περιέχει ένα KeyframeSequence σύνολο ζευγών χρόνος/τιμή.

KeyFrame

Ένα μοναδικό δείγμα χρόνος/τιμή σε ένα KeyframeSequence. Μεταφέρει τη χρονική σήμανση (σε δευτερόλεπτα), την τιμή και τις πληροφορίες εφαπτομένης για παρεμβολή.

KeyframeSequence

Μια διατεταγμένη λίστα από KeyFrame δείγματα για ένα κανάλι ιδιότητας, μαζί με το Interpolation και Extrapolation ρυθμίσεις που ελέγχουν την αναπαραγωγή.

ImageRenderOptions

Απαρίθμηση των τρόπων παρεμβολής των κλειδιών καρέ. Γνωστά μέλη περιλαμβάνουν LINEAR και CONSTANT. Πρόσθετα μέλη όπως BEZIER μπορεί να είναι διαθέσιμο.

ImageRenderOptions

Ορίζει τη συμπεριφορά εκτός του εύρους των keyframe (πριν το πρώτο κλειδί και μετά το τελευταίο κλειδί). Ελέγχεται από ExtrapolationType.

StepMode

Απαρίθμηση που ελέγχει πώς εφαρμόζεται η βηματική (σταθερή) παρεμβολή στα όρια.

WeightedMode

Απαρίθμηση για τη διαχείριση βάρους εφαπτομένης Bezier: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, ή BOTH.

ExtrapolationType

Απαρίθμηση των συμπεριφορών εκτός εύρους: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, και OSCILLATE.

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

FileFormat

Βασική περιγραφή για μια μορφή αρχείου 3D. Κάθε υποστηριζόμενη μορφή παρέχει ένα συγκεκριμένο singleton μέσω getInstance().

ImageRenderOptions

Βασική κλάση για υλοποιήσεις εισαγωγής ειδικές για μορφή. Δεν δημιουργείται άμεσα· καλείται εσωτερικά από scene.open().

ImageRenderOptions

Βασική κλάση για υλοποιήσεις εξαγωγής ειδικές για μορφή. Δεν δημιουργείται άμεσα· καλείται εσωτερικά από scene.save().

LoadOptions

Βασική κλάση για αντικείμενα επιλογών φόρτωσης ειδικές για μορφή. Περνάτε μια παρουσία υποκλάσης στο scene.open() ή scene.openFromBuffer().

SaveOptions

Βασική κλάση για αντικείμενα επιλογών αποθήκευσης ειδικές για μορφή. Περνάτε μια παρουσία υποκλάσης στο scene.save().

IOService

Εσωτερική διεπαφή υπηρεσίας που αφαιρεί την πολυπλοκότητα του συστήματος αρχείων και των εισόδων/εξόδων buffer για εισαγωγείς και εξαγωγείς.

Μορφή OBJ

Το OBJ υποστηρίζει τόσο εισαγωγή όσο και εξαγωγή. Κατά την αποθήκευση ως OBJ, η βιβλιοθήκη υλικών (.mtl) γράφεται αυτόματα μαζί με το .obj αρχείο.

ObjImporter

Εσωτερικός εισαγωγέας που διαβάζει αρχεία Wavefront OBJ, επιλύει .mtl βιβλιοθήκες υλικών και γεμίζει ένα Scene. Καλείται αυτόματα όταν ObjLoadOptions περνιέται στο scene.open().

ObjExporter

Εσωτερικός εξαγωγέας που γράφει αρχεία Wavefront OBJ. Ένας σύντροφος .mtl η βιβλιοθήκη υλικών γράφεται αυτόματα. Καλείται όταν scene.save() στοχεύει ένα .obj διαδρομή.

ObjLoadOptions

Φόρτωση επιλογών για αρχεία OBJ. Κύρια χαρακτηριστικά: enableMaterials (boolean, προεπιλογή true), flipCoordinateSystem (boolean), normalizeNormal (boolean, προεπιλογή true), scale (number). Δείτε Επιλογές Φόρτωσης και Αποθήκευσης Μορφής για πλήρεις λεπτομέρειες.

ObjSaveOptions

Αποθήκευση επιλογών για εξαγωγή OBJ. Περάστε στο scene.save() για έλεγχο της συμπεριφοράς εξόδου OBJ. Δείτε Επιλογές Φόρτωσης και Αποθήκευσης Μορφής για πλήρεις λεπτομέρειες.

ObjFormat

Μοναδικός περιγραφέας μορφής για OBJ. Και canImport και canExport είναι true.

Μορφή glTF

GltfImporter

Διαβάζει glTF 2.0 JSON (.gltf) και δυαδικό GLB (.glb) αρχεία. Διαχειρίζεται ενσωματωμένες και εξωτερικές αναφορές buffer, υλικά PBR, δέρματα και αποσπάσματα κίνησης.

GltfExporter

Γράφει έξοδο glTF 2.0. Όταν GltfSaveOptions.binaryMode είναι true, παράγει ένα αυτόνομο GLB; διαφορετικά γράφει ένα JSON .gltf με ένα συνοδευτικό .bin buffer.

GltfLoadOptions

Επιλογές φόρτωσης για αρχεία glTF/GLB. Ελέγχει την ανάλυση του buffer και τη συμπεριφορά φόρτωσης υφών.

GltfSaveOptions

Αποθήκευση επιλογών για εξαγωγή glTF/GLB. Σημαντικές ιδιότητες: binaryMode (boolean, true → GLB, προεπιλογή false), flipTexCoordV (boolean, αντιστρέφει τον κατακόρυφο άξονα UV, προεπιλογή true). Δείτε Επιλογές Φόρτωσης και Αποθήκευσης Μορφής για πλήρεις λεπτομέρειες.

GltfFormat

Μοναδικό αντικείμενο περιγραφέα μορφής. Λάβετε μέσω GltfFormat.getInstance() και περάστε στο scene.save() ως δεύτερο όρισμα.

Μορφή STL

StlImporter

Διαβάζει τόσο αρχεία ASCII όσο και δυαδικά αρχεία STL σε ένα Scene που περιέχει ένα μόνο Mesh οντότητα.

StlExporter

Γράφει δυαδικό STL. Η έξοδος περιέχει το τριγωνοποιημένο πλέγμα από τη σκηνή· τα πολύγωνα που δεν είναι τρίγωνα τριγωνοποιούνται αυτόματα.

StlLoadOptions

Επιλογές φόρτωσης για STL. Ελέγχει αν ο εισαγωγέας αντιστρέφει τις κανονικές κατά τη διάρκεια της εισαγωγής.

StlSaveOptions

Επιλογές αποθήκευσης για εξαγωγή STL. Κύρια ιδιότητα: binaryMode (boolean, προεπιλογή false). Ελέγχει αν η έξοδος είναι ASCII ή δυαδική STL. Δείτε Επιλογές Φόρτωσης και Αποθήκευσης Μορφής για πλήρεις λεπτομέρειες.

StlFormat

Μοναδικό αντικείμενο περιγραφέα μορφής. Λάβετε μέσω StlFormat.getInstance().

3MF Format

ThreeMfImporter

Διαβάζει αρχεία 3MF του Open Packaging Convention και γεμίζει ένα Scene με αντικείμενα πλέγματος, χρώματα και ιδιότητες υλικού.

ThreeMfExporter

Γράφει ένα έγκυρο αρχείο 3MF από την τρέχουσα σκηνή. Κατάλληλο για ροές εργασίας 3D εκτύπωσης.

ThreeMfLoadOptions

Επιλογές φόρτωσης για αρχεία 3MF.

ThreeMfSaveOptions

Επιλογές αποθήκευσης για εξαγωγή 3MF.

ThreeMfFormat

Μοναδικό αντικείμενο περιγραφέα μορφής. Αποκτήστε το μέσω ThreeMfFormat.getInstance().

Μορφή FBX

FbxImporter

Αναγνάει δυαδικά και ASCII αρχεία FBX, συμπεριλαμβανομένων της γεωμετρίας, των υλικών, των σκελετών, των blend shapes και των animation clips.

FbxExporter

Γράφει αρχεία FBX από τη τρέχουσα σκηνή. Υποστηρίζεται τόσο δυαδική όσο και ASCII έξοδο FBX, ανάλογα με τις επιλογές.

FbxLoadOptions

Επιλογές φόρτωσης για FBX. Ελέγχει αν η animation, τα skins και τα blend shapes εισάγονται.

FbxSaveOptions

Επιλογές αποθήκευσης για εξαγωγή FBX. Κύρια ιδιότητα: embedTextures (boolean, προεπιλογή false). Δείτε Επιλογές Φόρτωσης και Αποθήκευσης Μορφής για πλήρεις λεπτομέρειες.

FbxFormat

Περιγραφέας μορφής singleton. Λάβετε μέσω FbxFormat.getInstance().

Μορφή COLLADA

η εισαγωγή και εξαγωγή COLLADA απαιτούν το xmldom εξάρτηση-συνοδός, η οποία εγκαθίσταται αυτόματα με @aspose/3d.

ColladaImporter

Διαβάζει COLLADA (.dae) αρχεία XML χρησιμοποιώντας xmldom. Διαχειρίζεται γεωμετρία, υλικά, κάμερες, φωτισμούς και animation.

ColladaExporter

Γράφει έξοδο XML COLLADA από τη τρέχουσα σκηνή. Κατάλληλο για ανταλλαγή με εργαλεία DCC (Blender, Maya κ.λπ.).

ColladaFormat

Περιγραφέας μορφής singleton. Λάβετε μέσω ColladaFormat.getInstance().

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

ImageRenderOptions

Ένα τυποποιημένο ζεύγος όνομα/τιμή που μπορεί να προσαρτηθεί σε οποιοδήποτε A3DObject. Υποστηρίζει τύπους τιμών scalar και vector.

PropertyCollection

Ένα διατεταγμένο κοντέινερ από Property αντικείμενα. Προσβάσιμο σε οποιοδήποτε A3DObject μέσω του properties accessor.

CustomObject

Μια ελεύθερης μορφής τσάντα ιδιοτήτων που επεκτείνει A3DObject. Χρησιμοποιείται για την αποθήκευση αυθαίρετων μεταδεδομένων που δεν αντιστοιχούν σε τυπική κλάση.

Πληροφορίες Περιουσιακού

AssetInfo

Μεταφέρει μεταδεδομένα επιπέδου σκηνής που φορτώνονται από το αρχείο προέλευσης: συγγραφέας, όνομα εφαρμογής, ημερομηνία δημιουργίας, κλίμακα μονάδας και πληροφορίες άξονα συντεταγμένων.

ImageRenderOptions

Επιλογές που ελέγχουν πώς οι υφές και οι εικόνες επιλύονται και κωδικοποιούνται κατά την αποθήκευση σε μορφές που ενσωματώνουν δεδομένα εικόνας (π.χ., GLB με binaryMode: true).

Δείτε επίσης

 Ελληνικά