Οδηγός Προγραμματιστή
Το Aspose.3D FOSS για το TypeScript είναι μια βιβλιοθήκη ανοικτού κώδικα, με άδεια MIT που επιτρέπει στους προγραμματιστές του Node.js να φορτώνουν, να κατασκευάζουν, να μετασχηματίζουν και να εξάγουν 3D σκηνές με πλήρη ασφάλεια τύπου TypeScript. Είτε δημιουργείτε έναν αγωγό στοιχείων ενεργητικού, μια υπηρεσία μετατροπής μορφής, ένα εργαλείο επικύρωσης γεωμετρίας ή ένα σενάριο δημιουργίας 3D περιεχομένου, αυτή η βιβλιοθήκη παρέχει ένα καθαρό, συνεπή API που υποστηρίζεται από ένα μοντέλο σκηνής-γραφογράφησης που αντανακλά τις τυποποιημένες έννοιες 3D.
Αυτός ο οδηγός για τους προγραμματιστές καλύπτει όλα όσα χρειάζεστε για να ξεπεράσετε την εγκατάσταση γρήγορης εκκίνησης και να γράψετε κώδικα επεξεργασίας 3D ποιότητας παραγωγής.
Τι θα βρείτε σε αυτή την ενότητα
Χαρακτηριστικά και λειτουργίες
Το Χαρακτηριστικά η σελίδα είναι η κύρια αναφορά για εργασία με Aspose.3D FOSS για TypeScript. Καλύπτει:
- Υποστήριξη μορφών: OBJ (με υλικά .mtl), glTF 2.0 / GLB δυαδικό, STL (δυαδικό και ASCII), COLLADA (DAE), 3MF και FBX, με κλάσεις επιλογών φόρτωσης και αποθήκευσης ανά μορφή που περιλαμβάνουν
ObjLoadOptionsκαιGltfSaveOptions. - Γράφημα σκηνής: Πώς
Scene,Node,Entity,Transform, καιSceneObjectσυντίθενται σε μια πλήρη ιεραρχία σκηνής, συμπεριλαμβανομένων των προτύπων διάσχισης παιδικών κόμβων. - API γεωμετρίας και πλέγματος: Εργασία με
Mesh,Geometry,VertexElementNormal,VertexElementUV,VertexElementVertexColor,MappingMode,ReferenceModeγια επεξεργασία γεωμετρίας. - Σύστημα υλικών: Εφαρμογή
LambertMaterial,PhongMaterial, καιPbrMaterial(PBR για glTF) σε κόμβους σκηνής, και ανάγνωση ιδιοτήτων υλικού που φορτώνονται από αρχεία .mtl. - Εργαλεία μαθηματικών: Χρήση
Vector3,Vector4,Matrix4,Quaternion, καιBoundingBoxγια μετασχηματισμούς, ερωτήματα περιοριστικού πλαισίου και γεωμετρικούς υπολογισμούς. - Κίνηση: Κατασκευή και ανάγνωση
AnimationClip,AnimationNode,AnimationChannel,KeyFrame,KeyframeSequence,Interpolation, καιExtrapolationδεδομένα. - Υποστήριξη ροής και buffer: Φόρτωση 3D σκηνών από μνήμη
Bufferαντικείμενα μέσωscene.openFromBuffer()για περιπτώσεις χρήσης serverless και streaming. - Πλήρη παραδείγματα χρήσης: Σενάρια TypeScript από άκρη σε άκρη για φόρτωση OBJ, εξαγωγή GLB, round-tripping STL και περιήγηση σε γραφήματα σκηνών.
- Συμβουλές, κοινά προβλήματα και Συχνές Ερωτήσεις: Πρακτικές οδηγίες για την αποφυγή κοινών παγίδων στην παραγωγική χρήση.
- Σύνοψη αναφοράς API: Λίστα γρήγορης αναφοράς όλων των βασικών κλάσεων και των κύριων μεθόδων τους.
Βασικές Έννοιες
Γράφημα σκηνής: Όλο το 3D περιεχόμενο στο Aspose.3D FOSS αναπαρίσταται ως ένα δέντρο των Node αντικειμένων με ρίζα στο scene.rootNode. Κάθε κόμβος μπορεί να μεταφέρει ένα Entity (όπως ένα Mesh, Camera, ή Light) Transform που το τοποθετεί στην ιεραρχία.
API ανεξάρτητο από μορφή: Ανοίγετε οποιαδήποτε υποστηριζόμενη μορφή μέσω scene.open() ή scene.openFromBuffer() και αποθηκεύετε σε οποιαδήποτε υποστηριζόμενη μορφή μέσω scene.save(). Τα ίδια αντικείμενα γραφήματος σκηνής χρησιμοποιούνται ανεξάρτητα από τη μορφή προέλευσης ή προορισμού.
Ισχυρή τυποποίηση TypeScript: Η βιβλιοθήκη διανέμεται με αυστηρές ρυθμίσεις μεταγλωττιστή (noImplicitAny, strictNullChecks) και πλήρεις ορισμούς τύπων. Κάθε κλάση, μέθοδος και ιδιότητα επιλογής είναι πλήρως τυποποιημένη, παρέχοντάς σας αυτόματη συμπλήρωση IDE και ασφάλεια χρόνου μεταγλώττισης σε όλο τον κώδικα επεξεργασίας 3D.
Μία εξάρτηση: Η μοναδική εξάρτηση χρόνου εκτέλεσης είναι xmldom, η οποία εγκαθίσταται αυτόματα από το npm. Δεν υπάρχουν εγγενείς πρόσθετα για μεταγλώττιση και δεν απαιτούνται πακέτα συστήματος για εγκατάσταση.
Ξεκινώντας
Αν δεν έχετε ακόμη εγκαταστήσει τη βιβλιοθήκη, δείτε το Ξεκινώντας ενότητα και το Εγκατάσταση οδηγός πριν διαβάσετε περαιτέρω.
Διαθέσιμα θέματα
- Χαρακτηριστικά και λειτουργίες: Πλήρης αναφορά API με παραδείγματα κώδικα για κάθε κύρια περιοχή λειτουργίας.