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

Aspose.3D FOSS για TypeScript

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

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

Τεκμηρίωση GitHub

Βιβλιοθήκη TypeScript ανοιχτού κώδικα για επεξεργασία 3D αρχείων

Aspose.3D FOSS for 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 (δυαδικό και ASCII, πλήρης κυκλική μετατροπή), COLLADA (DAE), 3MF και FBX. Οι κλάσεις επιλογών ανά μορφή όπως ObjLoadOptions και GltfSaveOptions σας δίνουν ακριβή έλεγχο πάνω στην προσανατολισμό του συστήματος συντεταγμένων, την κλίμακα, την κανονικοποίηση των κανονικών, το δυαδικό έναντι JSON έξοδο, και τη φόρτωση υλικού.

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

Υποστήριξη μορφών 3D και τυποποιημένο API γραφήματος σκηνής

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

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

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

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

  • Προσανατολισμός συστήματος συντεταγμένων: Αντιστρέψτε τους άξονες και προσαρμόστε την κλίμακα ανά μορφή με τις κλάσεις επιλογών.
  • Κανονικοποίηση κανονικών: Αυτόματη κανονικοποίηση των κανονικών κορυφών κατά τη φόρτωση ή αποθήκευση.
  • Δυαδικό vs. 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-licensed με ανοιχτό σύστημα παρακολούθησης θεμάτων στο GitHub.

Φόρτωση σκηνής OBJ και εξαγωγή ως glTF

Εγκαταστήστε με npm, στη συνέχεια χρησιμοποιήστε scene.open() με ObjLoadOptions για να φορτώσετε το πλέγμα μαζί με το αρχείο υλικού MTL. Και τα open() και save() είναι συγχρονισμένα — δεν απαιτείται await ή αλυσίδωση Promise. Η κλήση του 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. Κάθε μορφή διαθέτει μια αφιερωμένη κλάση typed options.

Απαιτεί εγγενείς πρόσθετα Node.js;

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

Πώς το εγκαθιστώ;

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

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

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

Παρέχεται με ορισμούς τύπων TypeScript;

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

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

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

Πού μπορώ να βρω τον πηγαίο κώδικα;

Η βιβλιοθήκη είναι αδειοδοτημένη υπό MIT και φιλοξενείται στο GitHub. Οι αναφορές σφαλμάτων και τα pull requests είναι ευπρόσδεκτα.

  

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

 Ελληνικά