Χαρακτηριστικά και λειτουργίες
Χαρακτηριστικά και λειτουργίες
Αυτή η σελίδα καλύπτει κάθε κύριο χαρακτηριστικό πεδίο της Σημειώνεται ότι το ASPOSE-3D-FOSS 26.1.0 Με παράδειγμα Java.
Κατεβάστε και αποθηκεύσετε σκηνές
scene.open() Κατεβάστε ένα αρχείο.; scene.save() Εξαγωγή του:
import com.aspose.threed.Scene;
Scene scene = new Scene();
scene.open("input.obj");
scene.save("output.glb");Εναλλακτικές στατικές εργοστασιακές λύσεις:
Scene scene = Scene.fromFile("input.fbx");
scene.save("output.stl");ΕΠΙΛΟΓΙΚΕΣ ΑΡΘΡΟΤΕΣ
ΠΑΣΟΚ LoadOptions ή SaveOptions Υποκλάσεις για τον έλεγχο των λεπτών σπόρων:
import com.aspose.threed.*;
Scene scene = new Scene();
ObjLoadOptions opts = new ObjLoadOptions();
opts.setFlipCoordinateSystem(true);
scene.open("model.obj", opts);
GltfSaveOptions saveOpts = new GltfSaveOptions();
saveOpts.setFlipCoordinateSystem(true);
scene.save("model.glb", saveOpts);Σημείωση : Το FBX υποστηρίζεται μόνο για εισαγωγές. το FBx εξαγωγή δεν εφαρμόζεται στην έκδοση FOSS. Δυοδυναμική FBX Τα αρχεία υποστηρίζονται για εισαγωγή — ASCII FBX ρίχνει
ImportException.
Δημιουργία σκηνικού γραφείου
Δημιουργήστε κόμβους και προσθέστε οντότητες:
Scene scene = new Scene();
Node root = scene.getRootNode();
Mesh mesh = new Mesh("myMesh");
mesh.getControlPoints().add(new Vector4(0, 0, 0));
mesh.getControlPoints().add(new Vector4(10, 0, 0));
mesh.getControlPoints().add(new Vector4(10, 10, 0));
mesh.createPolygon(0, 1, 2);
Node meshNode = root.createChildNode("triangle", mesh);Δραστηριότητες Mesh
Δημιουργία A Mesh Προγραμματισμένα με σημεία ελέγχου και πολυγόνους:
Mesh mesh = new Mesh("custom");
mesh.getControlPoints().add(new Vector4(0, 0, 0));
mesh.getControlPoints().add(new Vector4(10, 0, 0));
mesh.getControlPoints().add(new Vector4(10, 10, 0));
mesh.getControlPoints().add(new Vector4(0, 10, 0));
mesh.createPolygon(0, 1, 2, 3);Μετασχηματισμός
ΟΛΟΙ Node Παρουσιάζει A Transform:
Node node = scene.getRootNode().createChildNode("moved", new Mesh());
node.getTransform().setTranslation(10, 0, 5);
node.getTransform().setScale(2, 2, 2);Διαβάστε το World-Space μέσω node.getGlobalTransform().getMatrix().
Υλικά
Αναθέστε υλικά σε κόμβους:
import com.aspose.threed.*;
PbrMaterial mat = new PbrMaterial("shiny");
mat.setAlbedo(new Vector4(0.8, 0.2, 0.2, 1.0));
mat.setMetallicFactor(0.5);
mat.setRoughnessFactor(0.3);
scene.getRootNode().createChildNode("red_mesh", mesh, mat);Τύποι υλικού: Material και στη βάση, PbrMaterial (Προσωπικά με μεταλλικό σκληρότητα).
Συμβουλές και βέλτιστες πρακτικές
- Χρησιμοποιήστε
Scene.fromFile()για φορτία μονοπώρου όταν δεν απαιτούνται προσαρμοσμένες επιλογές - Δημιουργήστε τα προγράμματα με προγραμματισμό
createPolygon()Για την κανονική γεωμετρία - Χρησιμοποιήστε
.glbΕπεκταση για το compact δυαδικό glTF εξαγωγή - Ελέγξτε
node.getEntity() != nullΠριν το casting - Η ΕΣΤΕΕ ΕΞΑΓΩΓΗ Όχι Η διμερή εξαγωγή STL γράφει μόνο τις πρώτες 3 κατώτερες γραμμές κάθε πολυσύχναστης - τα πρόσωπα τετράγωνου ή n-gon είναι σιωπηλά κρυμμένα. η εξάπλωση ASCII ST L γράφει όλους τους δεξιότητες, οι οποίοι παράγουν παρερμηνευμένους μπλοκ φακέλων για μη τριγώνια πρόσωπά. Πάντα περάσει προ-τριγόνια μάζες (όλα τριγαριά πρόσωπο) στην εξήπευση STl για να αποφευχθεί απώλεια δεδομένων ή ανεπιθύμητη παραγωγή.
κοινά ζητήματα
| Θέμα | Αιτία | ΦΙΛΕΞΗ |
|---|---|---|
| Εκτός από το φορτίο | Απαράδεκτο ή διαφθορισμένο αρχείο | Ελέγξτε το αρχείο ανοίγει σε 3D προβολή |
| Απεβίβαση υλικού μετά το φορτίο OBJ | .mtl αρχείο δεν βρέθηκε | Τόπος .mtl Πέρα από το .obj;• Να εξασφαλιστεί ότι τα υλικά είναι διαθέσιμα |
| Η διαφορά μετά την εισαγωγή | Διαφορετικά συστήματα μονάδων | Εφαρμόστε A Transform Στάδιο μετά την φόρτιση |
FAQ
Πώς μπορώ να αναγνωρίσω τη μορφή ενός αρχείου;?
FileFormat format = FileFormat.detect("unknown.bin");
System.out.println(format.getExtension());Μπορώ να φορτώσω από ένα ρεύμα;?
Ναι . scene.open() Αποδέχεται ένα InputStream.
Ποια μορφή υποστηρίζει τόσο τις εισαγωγές όσο και τις εξαγωγικές πηγές;?
Ο OBJ, STL και η glTF/GLB υποστηρίζουν τις δύο κατευθύνσεις. το FBX εισάγεται μόνο· οι εξαγωγές δεν εφαρμόζονται στην έκδοση FOSS.
Συνοπτική αναφορά API
| Κλάση / Μέθοδος | Περιγραφή |
|---|---|
Scene | Πρώτο επίπεδο 3D σκηνή δοχείο |
scene.open() | Κατεβάστε ένα αρχείο 3D με πορεία ή ροή |
scene.save() | Εξαγωγή σκηνής σε αρχείο ή ροή |
Scene.fromFile() | Στατικό εργοστάσιο για φόρτιση και επιστροφή σε ένα Scene |
Node | Η ιεραρχία του κόμβου |
node.createChildNode() | Δημιουργία και προσθήκη παιδικού κόμβου |
Mesh | Πολυγώνια με σημεία ελέγχου και λίστας προσώπου |
mesh.createPolygon() | Ορισμός ενός πολυσύχναστου προσώπου |
Mesh.toMesh() | Μετατροπή ή κλωνοποίηση γεωμετρία |
Transform | Η τοπική μετάφραση, η περιστροφή και η κλίμακα |
FileFormat | Μητρώο και ανιχνευτής για μορφές |