Πώς να ξεκινήσετε με το Aspose.3D FOSS για TypeScript
@aspose/3d για το TypeScript είναι ένα δωρεάν, MIT-υποδεκτό πακέτο για φόρτιση, χειρισμό και Αποθηκεύστε 3D αρχεία στο Node.js - δεν απαιτούνται εγχώριες δυαδικές, εγκατεστημένες από npm.
Βήμα προς βήμα οδηγός
Βήμα 1: Εγκατάσταση του πακέτου
Εγκατάσταση από npm (Node.js 18 ή αργότερα απαιτείται):
npm install @aspose/3d@24.12.0Ελέγξτε την εγκατάσταση φορτωμένη σωστά:
import { Scene } from "@aspose/3d";
console.log("@aspose/3d loaded.");Βήμα 2: Εισαγωγή απαιτούμενων τάξεων
Εισαγωγή των τάξεων που χρειάζεστε από το πακέτο:
import { Scene, Node } from "@aspose/3d";Βήμα 3: Κατεβάστε ένα αρχείο 3D
Χρησιμοποιήστε scene.open() να φορτώσει οποιαδήποτε υποστηριζόμενη μορφή. η βιβλιοθήκη ανιχνεύει τη μορφοποίηση Αυτόματα από την επέκταση αρχείου:
import { Scene } from "@aspose/3d";
const scene = new Scene();
scene.open("model.obj");
console.log(`Loaded scene. Root node: ${scene.rootNode.name}`);Χρησιμοποιήστε τη στατική μέθοδο εργοστασίου:
const scene = Scene.fromFile("model.glb");Βήμα 4: Περπατήστε το γραφείο σκηνής
Μια σκηνή φορτισμένη είναι ένα δέντρο Node αντικείμενα που ριζώνουν σε scene.rootNode:
import { Scene, Node } from "@aspose/3d";
function walk(node: Node, depth: number = 0): void {
const indent = " ".repeat(depth * 2);
console.log(`${indent}Node: ${node.name}`);
for (const child of node.childNodes) {
walk(child, depth + 1);
}
}
const scene = Scene.fromFile("model.obj");
walk(scene.rootNode);Βήμα 5: Αποθηκεύστε σε διαφορετικό μορφότυπο
Χρησιμοποιήστε scene.save() να εξάγει σε οποιαδήποτε μορφή έκδοσης που υποστηρίζεται. η βιβλιοθήκη εντοπίζει την Η μορφή εξόδου από την επέκταση αρχείου:
import { Scene } from "@aspose/3d";
const scene = Scene.fromFile("model.obj");
scene.save("output.glb");
console.log("Saved as GLB.");Κοινά προβλήματα και τακτοποιήσεις
Error: ENOENT Όταν καλείται scene.open() Ο δρόμος που πέρασες δεν υπάρχει. χρησιμοποιήστε ένα απόλυτο μονοπάτι ή path.resolve() Για να εξασφαλιστεί Η πορεία του αρχείου είναι σωστή.
Απίστευτο σφάλμα μορφής Βεβαιωθείτε ότι η επέκταση αρχείου ταιριάζει με την πραγματική μορφή.Η βιβλιοθήκη ανακαλύπτει τη μορφοποίηση από το Η επέκταση για open() και fromFile().Πάρτε μια σαφή παραμέτρους μορφής για να υπερβαίνει.
Αδειά σκηνή μετά την φόρτιση Ορισμένες δυαδικές μορφές μπορεί να απαιτούν συγκεκριμένες επιλογές φόρτωσης. δοκιμάστε τη χρήση της ρητής υπερφόρτωση με επιλογές ειδικής μορφής, εάν η προεπιλεγμένη φόρτιση παράγει μια κενή σκηνή.
Εισαγωγικά λάθη TypeScript Οι ορισμοί τύπου συνδέονται με το πακέτο.Εγγυηθείτε "moduleResolution": "bundler" ή "node16" Είναι εγκατεστημένο στο δικό σας tsconfig.json.
Συχνές ερωτήσεις
@aspose/3d απαιτεί οποιαδήποτε ιθαγενείς δυαδικές;?
Το πακέτο είναι καθαρό JavaScript/TypeScript χωρίς εγχώρια εξάρτηση. τρέχει σε οποιαδήποτε πλατφόρμα που υποστηρίζει το Node.js 18 ή αργότερα.
Ποια εκδόσεις Node.js υποστηρίζονται;?
Node.js 18 ή αργότερα. το πακέτο λειτουργεί στα Windows, macOS και Linux.
Είναι η βιβλιοθήκη ελεύθερη για εμπορική χρήση;?
Μπορείτε να το χρησιμοποιήσετε, να τροποποιήσουν και να αναδιανέμουν για οποιονδήποτε σκοπό, συμπεριλαμβανομένων των εμπορικών εφαρμογών.
Ποια 3D μορφή μπορώ να διαβάσω και να γράψω;?
Το πακέτο υποστηρίζει OBJ, STL, glTF 2.0 / GLB, FBX, COLLADA και PLY για τόσο την ανάγνωση και γράψτε. χρησιμοποιήστε την επέκταση-με βάση scene.save() να εξάγεται σε οποιαδήποτε υποστηριζόμενη μορφή.
Μπορώ να δημιουργήσω μια σκηνή 3D από το scratch;?
Ναι. Δημιουργία A Scene χωρίς λόγους, προσθέστε τα παιδικά κόμβα στο scene.rootNode,και Συσκευή στο επιθυμητό σχήμα.