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

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

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

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

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

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

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

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

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

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

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

Φορτώστε μια σκηνή OBJ και εξάγετε ως glTF

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

// Εξαγωγή ως glTF 2.0 JSON
scene.save("model.gltf");

Μετατρέψτε το STL σε δυαδικό GLB

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

import { Scene } from "@aspose/3d";
import { GltfSaveOptions } from "@aspose/3d/formats/gltf";

const scene = new Scene();
scene.open("mesh.stl");

// Αποθήκευση ως συμπαγές δυαδικό GLB
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save("mesh.glb", opts);

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

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

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

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

OBJ (με .mtl), glTF 2.0 και GLB, STL (δυαδικό και ASCII), COLLADA (DAE), 3MF και FBX. Κάθε μορφή διαθέτει μια αφιερωμένη κλάση typed options.

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

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

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

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

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

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

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

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

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

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

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

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

  

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

 Ελληνικά