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

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

Σκηνή

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

Σύνδεσμος

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

Οντότητα

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

SceneObject

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

Α3Προϊόν

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

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

Δαχτυλόγλυφος

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

Γεωμετρία

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

VertexElement

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

VertexElementNormal

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

VertexElementUV

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

VertexElementVertexColor

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

VertexElementType

Κατάλογος των τύπων καναλιών χαρακτηριστικών που είναι a VertexElement μπορεί να αντιπροσωπεύει (π.χ., NORMAL, UV, VERTEX_COLOR, TANGENT, BINORMAL).

MappingMode

Καταγραφή που ελέγχει τον τρόπο με τον οποίο τα στοιχεία των δεδομένων μετατρέπονται σε γεωμετρία: CONTROL_POINT, POLYGON_VERTEX, POLYGON, EDGE, ή ALL_SAME.

ReferenceMode

Καταγραφή που ελέγχει τον τρόπο με τον οποίο τα στοιχεία δείκτες δεδομένων αναφοράς: DIRECT (ένα προς ένα) ή INDEX_TO_DIRECT (μέσω πίνακα δείκτη).

TextureMapping

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

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

Μετατροπή

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

GlobalTransform

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

BoundingBox

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

Υλικά

Υλικό, LambertMaterial,PhongMaterial και PbrMaterial

Η κατηγορία υλικών είναι η αφηρημένη βασική για όλους τους τύπους υλών. Υπάρχουν τρεις συγκεκριμένες εφαρμογές:

  • LambertMaterial διαχέονται μόνο με περιβαλλοντικά, διάχυτα και εκπέμποντα χρωματικά κανάλια.
  • PhongMaterial επεκτείνεται LambertMaterial με ιδιότητες γυαλιστερότητας και χρώματος για τη σκιά Phong.
  • PbrMaterial υλικό αποτύπωσης με φυσική βάση, με κανάλια μεταλλικού, ακαμψίας, βασικού χρώματος και κανονικής χαρτογράφησης.

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

Καμερα

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

Φως

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

LightType

Κατάλογος των τύπων φωτισμού που υποστηρίζονται: POINT, DIRECTIONAL, SPOT, AREA, VOLUME.

ProjectionType

Κατάλογος των τρόπων προβολής της κάμερας: PERSPECTIVE και β) ORTHOGRAPHIC.

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

Εξαγωγέας 3

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

Vector4 (εξοδικό)

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

Βέκτωρ2

Δύο συστατικά διπλής ακρίβειας με: x και β) y Χρησιμοποιείται για συντεταγμένες υφής UV.

FVector3

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

Ματρίκη 4

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

Κουατερνιον

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

Ζωγραφισμοί

AnimationClip

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

AnimationNode

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

AnimationChannel

Ένα ενιαίο κανάλι περιουσιακής ζωγραφικής μέσα σε ένα AnimationNode. Κρατάει ένα KeyframeSequence των ζευγαριών χρόνου/τιμής.

KeyFrame

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

KeyframeSequence

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

Διασχέσεις

Ο κατάλογος των τρόπων διαστολής keyframe. Γνωστά μέλη περιλαμβάνουν: LINEAR και β) CONSTANT.Επαρχήντα μέλη όπως: BEZIER μπορεί να είναι διαθέσιμη.

Εκτάκτηση

Ορίζει συμπεριφορά εκτός της εμβέλειας του πλαισίου κλειδιού (πριν από το πρώτο και μετά το τελευταίο πλήκτρο). Ελέγχεται με την επιλογή “Αναπαυθεί” ή “Εξαιρέστες”. ExtrapolationType.

StepMode

Καταγραφή που ελέγχει τον τρόπο εφαρμογής της σταδιακής (σταθερής) διαστολής στα όρια.

WeightedMode

Καταγραφή για χειρισμό βάρους με τάντζεντα του Bezier: NONE, OUT_WEIGHT, NEXT_IN_WEIGHT, ή BOTH.

ExtrapolationType

Κατάλογος συμπεριφορών εκτός εμβέλειας: CONSTANT, GRADIENT, CYCLE, CYCLE_RELATIVE, και OSCILLATE.

Μορφή Ε/Ε

FileFormat

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

Εισαγωγέας

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

Εξαγωγέας

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

LoadOptions

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

SaveOptions

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

ImageRenderOptions (Αποδέκτης θέσης)

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

Φόρμα OBJ

Η OBJ υποστηρίζει τόσο τις εισαγωγές όσο και τις εξαγωγές..mtl) γράφεται αυτόματα δίπλα στο κείμενο “Προϊόντα που χρησιμοποιούνται για την παραγωγή” (βλέπε παράγραφο 1). .obj Φάκελο.

ObjImporter

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

ObjExporter

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

ObjLoadOptions

Επιλογές φόρτωσης για αρχεία OBJ. Κλειδικές ιδιότητες: enableMaterials (boolean, προεπιλεγμένη) true), flipCoordinateSystem (μπουλικός), normalizeNormal (boolean, προεπιλεγμένη) true), scale (αριθμός) Βλ. Επιλογές φόρτωσης και αποθήκευσης μορφοποίησης Για περισσότερες λεπτομέρειες.

ObjSaveOptions

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

ObjFormat

Σχεδιασμός του περιγραφικού μονότυπου για το OBJ. Και τα δύο. canImport και β) canExport είναι: true.

Φόρμα glTF

GltfImporter

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

GltfExporter

Γράφει την έξοδο glTF 2.0. GltfSaveOptions.binaryMode είναι: true, παράγει ένα αυτόνομο GLB, διαφορετικά γράφει ένα JSON. .gltf Με έναν σύντροφο. .bin - Το μπουφέρ.

GltfLoadOptions

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

GltfSaveOptions

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

GltfFormat

Μορφή περιγραφής singleton. GltfFormat.getInstance() και να περάσει σε: scene.save() ως δεύτερο επιχείρημα.

Σχήμα STL

StlImporter

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

StlExporter

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

StlLoadOptions

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

StlSaveOptions

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

StlFormat

Μορφή περιγραφής singleton. StlFormat.getInstance().

3MF Format

ThreeMfImporter

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

ThreeMfExporter

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

ThreeMfLoadOptions

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

ThreeMfSaveOptions

Αποθηκεύστε επιλογές για εξαγωγή 3MF.

ThreeMfFormat

Μορφή περιγραφής singleton. ThreeMfFormat.getInstance().

Φόρμα FBX

FbxImporter

Διαβάζει αρχεία ASCII FBX συμπεριλαμβανομένων γεωμετρίας, υλικών και κλιπ κινουμένων σχεδίων. Μόνο AS CII fbx; δυαδικό fbX δεν έχει ακόμη εφαρμοστεί. Σκελετό και εισαγωγή σχήματος μείγματος επίσης δεν έχουν εφαρμοσθεί στην τρέχουσα έκδοση.

FbxExporter

Γράφει ASCII FBX output μόνο από την τρέχουσα σκηνή. Η διπλή εξαγωγή FBx δεν είναι διαθέσιμη στην τρέχουσα έκδοση.

FbxLoadOptions

Επιλογές φόρτωσης για FBX. Στην τρέχουσα έκδοση, δεν είναι διαμορφώσιμες επιλογές φορτίου ειδικής μορφής (δεν εφαρμόζονται η εισαγωγή skin και blend-shape).

FbxSaveOptions

Διαθέτει επιλογές για την εξαγωγή FBX.: embedTextures (boolean, προεπιλεγμένη) false) Βλ. Επιλογές φόρτωσης και αποθήκευσης μορφοποίησης Για περισσότερες λεπτομέρειες.

FbxFormat

Μορφή περιγραφής singleton. FbxFormat.getInstance().

COLLADA Μορφή

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

ColladaImporter

Η COLLADA (.dae) XML αρχεία που χρησιμοποιούν xmldom.Ελέγχει γεωμετρία, υλικά, κάμερες, φώτα και κινούμενα σχέδια.

ColladaExporter

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

ColladaFormat

Μορφή περιγραφής singleton. ColladaFormat.getInstance().

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

ImageRenderOptions (Αποδέκτης θέσης)

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

PropertyCollection

Ένα παραγγελμένο δοχείο με… Property Επισκεπτόμενη σε οποιοδήποτε A3DObject μέσω του properties Ενεργοποιητής.

CustomObject

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

Πληροφορίες περιουσιακών στοιχείων

AssetInfo

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

ImageRenderOptions

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

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

 Ελληνικά