1. Προϊόντα
  2.   Aspose.3D
  3.   Aspose.3D FOSS for TypeScript

Aspose.3D FOSS for TypeScript

Φορτώστε, δημιουργήστε, μετασχηματίστε και εξάγετε 3D σκηνές από το Node.js — πλήρως τυποποιημένο, ανοιχτού κώδικα και έτοιμο για παραγωγή με μία εντολή npm install.

Aspose.3D FOSS for TypeScript Aspose.3D FOSS
for TypeScript

Τεκμηρίωση GitHub

Λειτουργία TypeScript ανοικτής πηγής για επεξεργασία αρχείων 3D

Aspose.3D FOSS για TypeScript είναι μια βιβλιοθήκη αδειοδοτημένη με MIT για εργασία με μορφές αρχείων 3D σε εφαρμογές Node.js. Εγκαταστήστε την με μια εντολή npm install @aspose/3d και ξεκινήστε να διαβάζετε, να δημιουργείτε και να γράφετε σκηνές 3D σε TypeScript αμέσως, χωρίς να χρειάζεται να μεταγλωττίσετε native addons, χωρίς εξωτερικά SDKs για εγκατάσταση και χωρίς απαιτούμενο renderer.

Η βιβλιοθήκη εκθέτει ένα πλήρως τυποποιημένο γράφημα σκηνής API που είναι χτισμένο γύρω από Scene, Node, Entity, Mesh, Camera, Light και Transform, το ίδιο εννοιολογικό μοντέλο που χρησιμοποιείται από επαγγελματικά εργαλεία 3D. Η υποστήριξη μορφών περιλαμβάνει OBJ (Wavefront, με φόρτωση υλικού .mtl), glTF 2.0 και GLB binary (υλικά PBR), STL (binary και ASCII, πλήρης κυκλική μετατροπή), COLLADA (DAE), 3MF και FBX. Κλάσεις επιλογών ανά μορφή όπως ObjLoadOptions και GltfSaveOptions σας δίνουν ακριβή έλεγχο πάνω στην προσανατολισμό του συστήματος συντεταγμένων, την κλίμακα, την κανονικοποίηση των κανονικών, την έξοδο binary vs. JSON, και τη φόρτωση υλικού.

Aspose.3D FOSS στοχεύει σε Node.js 18, 20 και 22+ με TypeScript 5.0+ και μεταγλωττίζεται σε CommonJS. Η βιβλιοθήκη διανέμεται με αυστηρές ρυθμίσεις του μεταγλωττιστή TypeScript (noImplicitAny, strictNullChecks) ώστε το IDE σας να παρέχει πλήρη αυτόματη συμπλήρωση και ασφάλεια χρόνου μεταγλώττισης. Η μοναδική εξάρτηση χρόνου εκτέλεσης, xmldom, εγκαθίσταται αυτόματα. Για την οικογένεια προϊόντων επιχειρήσεων, δείτε Aspose.3D — Enterprise Product Family.

Υποστήριξη 3D Format και API τύπου Scene-Graph

  • ** OBJ / MTL:** Φορτώστε τα αρχεία Wavefront OB J με τους συνοδευτικούς ορισμούς υλικών.
  • glTF 2.0 / GLB: Φορτίο υλικού PBR και διπλή έξοδος από το GDB μέσω GltfSaveOptions.
  • ** STL:** Διαβάστε και γράψτε τόσο binary όσο και ASCII ST L με πλήρη εξακρίβωση στροφής.
  • COLLADA, 3MF, FBX: Επιπλέον υποστήριξη μορφότυπων με τάξεις επιλογών ανά μορφή.
  • Πλήρεις τύποι TypeScript: Κάθε τάξη, μέθοδος και επιλογή είναι έντονα τυποποιημένη με noImplicitAny και strictNullChecks.

Πού μπορεί να χρησιμοποιηθεί το Aspose.3D FOSS

  • Διαγωγές στοιχείων του Node.js: Εισαγωγή αρχείων OBJ, επικύρωση και επαναπροσανατολισμός γεωμετρίας και εξαγωγή ως GLB στο CI.
  • Προϊόντα παιχνιδιού: 3D πλέγματα με διαδικασία παρτίδας χωρίς εγγενή μηχανή ή εκτύπωση.
  • Προοδικές ροές εργασίας για την τρισδιάστατη εκτύπωση: Διαβάστε, επικυρώστε και επανεκφέρετε αρχεία STL και 3MF.
  • Συστηματοποιημένα backends: Εκτελέστε 3D τελικά σημεία μετατροπής σε Lambda ή Cloud Functions.
  • ** Μετανάστευση περιεχομένου:** Μετατροπή μεταξύ οικογενειών μορφοτήτων σε κλίμακα από ένα ενιαίο σενάριο.

Επιλογές προδιαγραφής και έλεγχος συντονισμού

  • ** Προσανατολισμός του συστήματος συντεταγμένων:** Αξόνες μετατροπής και προσαρμογής κλίμακας ανά μορφή με επιλογές κλάσεων.
  • Κανονική εξομάλυνση: Ομαλοποιηθεί αυτόματα η ορθοψηφία των κανονικών κατά την φόρτωση ή τη διατήρηση.
  • Δυαδική κατά JSON έξοδος: Επιλέξτε συμπαγές GLB ή αναγνώσιμο glTF μέσω GltfSaveOptions.
  • ** Ελέγχος φόρτωσης υλικού:** Ενισχύστε ή απενεργοποιήστε την φορτίωση MTL/texture για ταχύτερη ανάλυση.
  • Πιστότητα στρογγυλής επιστροφής: Οι άγνωστοι κόμβοι γραφικού σκηνικού διατηρούνται κυριολεκτικά κατά την επανεκκίνηση.

Εμπειρία προγραμματιστή

Aspose.3D FOSS για εγκαταστάσεις TypeScript με μία εντολή npm install @aspose/3d. Δεν υπάρχουν εγγενείς πρόσθετα για μεταγλώττιση. Η βιβλιοθήκη είναι καθαρά TypeScript/JavaScript με μία αυτόματα εγκατεστημένη εξάρτηση (xmldom).

Το ισχυρά τυποποιημένο API παρέχει πλήρη αυτόματη συμπλήρωση IDE για κάθε κλάση γραφήματος σκηνής και επιλογή μορφής. Η βιβλιοθήκη στοχεύει στο Node.js 18–22+ και TypeScript 5.0+, λειτουργεί ταυτόσημα σε Linux CI runners και σταθμούς εργασίας προγραμματιστών, και είναι αδειοδοτημένη υπό MIT με ανοιχτό σύστημα παρακολούθησης θεμάτων στο GitHub.

Εισάγετε μια σκηνή OBJ και εξάγει ως glTF

Τοποθετήστε με npm, στη συνέχεια χρησιμοποιήστε scene.open() με ObjLoadOptions για να φορτώσετε το πλέγμα μαζί με το αρχείο υλικού MTL. Τόσο το open() όσο και τοsave() είναι συγχρονισμένα δεν χρειάζεται η αλυσιδωτή σύνδεση του await ή της υπόσχεσης. Η κλήση στο scene.save() μέσω μιας επέκτασης .gltf γράφει τη τυποποιημένη glTF 2.0 JSON ∙ ο μορφότυπος προκύπτει αυτόματα από την επέμβαση αρχείου.

npm install @aspose/3d

import { Scene } from "@aspose/3d";
import { ObjLoadOptions } from "@aspose/3d/formats/obj";
const scene = new Scene();
scene.open("model.obj", new ObjLoadOptions());
// Export as glTF 2.0 JSON
scene.save("model.gltf");

Μετατρέψτε STL σε Binary GLB

Για να δημιουργήσετε ένα συμπαγές δυαδικό GLB αντί του προεπιλεγμένου JSON glTF, περάστε το GltfSaveOptions με το binaryMode = true. Και τα open() και save() είναι συγχρονισμένα — δεν απαιτείται await.

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";
const scene = new Scene();
scene.open("mesh.stl");
// Save as compact binary GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

Συχνές Ερωτήσεις

Τι είναι το Aspose.3D FOSS για TypeScript;

Είναι μια δωρεάν βιβλιοθήκη TypeScript/Node.js με άδεια MIT για φορτώσεις, χειραγώγηση και αποθήκευση 3D σκηνών χωρίς να εγκαταστήσετε οποιοδήποτε εγγενές πρόσθετο ή εξωτερικό SDK .

Ποιες 3D μορφές υποστηρίζονται;

Ο OBJ (με .mtl), glTF 2.0 και GLB, STL (διπλό και ASCII), COLLADA (DAE), 3MF και FBX. Κάθε μορφή έχει μια ειδική τάξη επιλογών τύπου.

Χρειάζεται ντόπιο Node.js προσθήκες;

Οχι. Aspose.3D Το FOSS για το TypeScript είναι καθαρό JavaScript/TypeScript. Δεν απαιτεί βήμα σύνταξης και έχει μια μοναδική εξάρτηση runtime (xmldom) εγκατεστημένη αυτόματα από npm.

Πώς το εγκαταστήσω;

Εκτελέστε npm install @aspose/3d. Δεν απαιτούνται πρόσθετα πακέτα συστήματος ή εγγενείς πρόσθετα.

Ποιες εκδόσεις Node.js και TypeScript υποστηρίζονται;

Το Node.js 18, 20 και 22+. TypeScript 5.0+. Η βιβλιοθήκη συντάσσει στο CommonJS και λειτουργεί με αυστηρές ρυθμίσεις του Type Script.

Συμπεριλαμβάνει ορισμούς τύπου TypeScript;

Ναι. Όλες οι τάξεις, μέθοδοι, enums και τύποι επιλογών πληκτρολογούνται πλήρως με το noImplicitAny και τοstrictNullChecks ενεργοποιημένα.

Μπορώ να ελέγξω την προσανατολισμό του συστήματος συντεταγμένων;

Ναι. Κλάσες επιλογών ανά μορφή όπως ObjLoadOptions και GltfSaveOptions σας επιτρέπουν να μετατρέψετε άξονες, να προσαρμόζετε κλίμακα και να εξομάλυνσετε κανονικά χωρίς προδιαγραμμένο κωδικό αναλύσεως.

Πού μπορώ να βρω τον κώδικα προέλευσης;

Η βιβλιοθήκη είναι με άδεια του MIT και φιλοξενείται στο GitHub.

  

Υποστήριξη και Πόροι Μάθησης

 Ελληνικά