Load and Save Options — Aspose.3D FOSS for Java
FbxSaveOptions
כל פעולות הייבוא והייצוא מקבלות אובייקט אפשרויות אופציונלי שמקורו ב LoadOptions או SaveOptions. העבירו את תת‑המחלקה המתאימה ל Scene.open() או Scene.save() כדי לשלוט בהתנהגות ספציפית לפורמט.
FbxSaveOptions: com.aspose.threed
import com.aspose.threed.*;LoadOptions
מחלקת בסיס לכל אובייקטי load-option. מרחיבה A3DObject.
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|
fileFormat | FileFormat | getFileFormat() | הפורמט שהגדרה זו משויכת אליו (קריאה בלבד) |
SaveOptions
מחלקת בסיס לכל אובייקטי save-option. מרחיבה A3DObject.
ObjLoadOptions
אפשרויות טעינה לקבצי Wavefront OBJ (.obj).
ObjLoadOptions opts = new ObjLoadOptions(); opts.setFlipCoordinateSystem(true); opts.setScale(0.01); Scene scene = new Scene(); scene.open(“model.obj”, opts);
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
| ---------------------- | -------------- | --------------------------- | ---------------------------------- | -------------- | -------------------------------------------- |
| `flipCoordinateSystem` | `boolean` | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false` | הפוך את מערכת הקואורדינטות בייבוא |
| `enableMaterials` | `boolean` | `getEnableMaterials()` | `setEnableMaterials(boolean)` | `true` | טען את הקובץ המלווה `.mtl` קובץ חומר |
| `scale` | `double` | `getScale()` | `setScale(double)` | `1.0` | קנה מידה אחיד המיושם על כל הגאומטריה המיובאת |
| `normalizeNormal` | `boolean` | `getNormalizeNormal()` | `setNormalizeNormal(boolean)` | `true` | נרמל וקטורי נורמל מיובאים לאורך יחידה |
---
## ObjSaveOptions
אפשרויות שמירה לקבצי Wavefront OBJ.
ObjSaveOptions opts = new ObjSaveOptions();
opts.setEnableMaterials(false);
scene.save("output.obj", opts);| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|---|---|
applyUnitScale | boolean | getApplyUnitScale() | setApplyUnitScale(boolean) | false | החל את גורם קנה המידה היחיד של הסצנה על הקואורדינטות המיוצאות |
pointCloud | boolean | getPointCloud() | setPointCloud(boolean) | false | ייצא קודקודים בלבד (ללא משטחי פוליגון) |
verbose | boolean | getVerbose() | setVerbose(boolean) | false | כלול הערות OBJ נוספות בפלט |
serializeW | boolean | getSerializeW() | setSerializeW(boolean) | false | כתוב את רכיב ה‑W של נקודות הבקרה |
enableMaterials | boolean | getEnableMaterials() | setEnableMaterials(boolean) | true | כתוב a .mtl קובץ חומר והפנה אליו מה .obj |
flipCoordinateSystem | boolean | getFlipCoordinateSystem() | setFlipCoordinateSystem(boolean) | false | הפוך את מערכת הקואורדינטות ביצוא |
GltfLoadOptions
אפשרויות טעינה לקבצי glTF 2.0 ו-GLB (.gltf, .glb).
GltfLoadOptions opts = new GltfLoadOptions(); opts.setFlipCoordinateSystem(true); Scene scene = new Scene(); scene.open(“model.gltf”, opts);
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
| ---------------------- | -------------- | --------------------------- | ---------------------------------- | -------------- | ------------------------------------------- |
| `flipCoordinateSystem` | `boolean` | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false` | הפוך את מערכת הקואורדינטות בייבוא |
| `prettyPrint` | `boolean` | `getPrettyPrint()` | `setPrettyPrint(boolean)` | `false` | עצב את פלט ה-JSON עם הזחה לקריאות טובה יותר |
---
## GltfSaveOptions
אפשרויות שמירה עבור פלט glTF 2.0 ו‑GLB.
```java
import com.aspose.threed.*;
import com.aspose.threed.FileContentType;
// Save as glTF JSON
GltfSaveOptions opts = new GltfSaveOptions();
scene.save("output.gltf", opts);
// Save as GLB (binary glTF)
GltfSaveOptions glbOpts = new GltfSaveOptions();
glbOpts.setContentType(FileContentType.BINARY);
scene.save("output.glb", glbOpts);| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|---|---|
contentType | FileContentType | getContentType() | setContentType(FileContentType) | FileContentType.ASCII | הגדר ל FileContentType.BINARY ליצור קובץ GLB עצמאי; הגדר ל FileContentType.ASCII ל-JSON .gltf עם מאגר חיצוני |
flipCoordinateSystem | boolean | getFlipCoordinateSystem() | setFlipCoordinateSystem(boolean) | false | הפוך את מערכת הקואורדינטות בייצוא |
prettyPrint | boolean | getPrettyPrint() | setPrettyPrint(boolean) | false | עצב את קובץ ה-JSON הפלט עם הזחה לשיפור קריאות |
bufferFilePrefix | String | getBufferFilePrefix() | setBufferFilePrefix(String) | null | קידומת לשמות קבצי מאגר חיצוני |
saveExtras | String | getSaveExtras() | setSaveExtras(String) | null | נתוני extras מותאמים להכללה בפלט glTF |
StlLoadOptions
אפשרויות טעינה לקבצי STL (.stl).
StlLoadOptions opts = new StlLoadOptions(); opts.setFlipCoordinateSystem(true); Scene scene = new Scene(); scene.open(“part.stl”, opts);
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
| ---------------------- | ----------------- | --------------------------- | ---------------------------------- | -------------- | ----------------------------------- |
| `flipCoordinateSystem` | `boolean` | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false` | הפוך את מערכת הקואורדינטות בייבוא |
| `recalculateNormal` | `boolean` | `getRecalculateNormal()` | `setRecalculateNormal(boolean)` | `false` | חשב מחדש נורמליות מהגאומטריה בייבוא |
| `contentType` | `FileContentType` | `getContentType()` | `setContentType(FileContentType)` | -- | רמז לזיהוי STL בינארי לעומת ASCII |
---
## StlSaveOptions
אפשרויות שמירה עבור פלט STL.
StlSaveOptions opts = new StlSaveOptions();
opts.setContentType(FileContentType.BINARY);
scene.save("output.stl", opts);| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
|---|---|---|---|---|---|
flipCoordinateSystem | boolean | getFlipCoordinateSystem() | setFlipCoordinateSystem(boolean) | false | הפוך את מערכת הקואורדינטות ביצוא |
axisSystem | AxisSystem | getAxisSystem() | setAxisSystem(AxisSystem) | – | עקוף את מערכת הצירים של היעד ביצוא |
contentType | FileContentType | getContentType() | setContentType(FileContentType) | FileContentType.BINARY | הגדר ל BINARY או ASCII לשלוט בפורמט הפלט |
FbxLoadOptions
טען אפשרויות לקבצי FBX (.fbx).
FbxLoadOptions opts = new FbxLoadOptions(); opts.setFlipCoordinateSystem(true); Scene scene = new Scene(); scene.open(“animation.fbx”, opts);
| FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions | FbxSaveOptions |
| ---------------------- | -------------- | --------------------------- | ---------------------------------- | -------------- | --------------------------------- |
| `flipCoordinateSystem` | `boolean` | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false` | הפוך את מערכת הקואורדינטות בייבוא |
---
## FbxSaveOptions
**הערה:** ייצוא FBX הוא **לא זמין** בגרסת Java FOSS. FBX נתמך רק לייבוא. ה `FbxSaveOptions` המחלקה קיימת ב‑API אך תגרום לשגיאה אם תשתמש בה לשמירה. השתמש ב‑OBJ, STL, glTF או GLB לייצוא במקום זאת.
---
## ראה גם
- [הפנייה למחלקת FileFormat](/3d/java/file-format/)
- [הפנייה למחלקת Scene](/3d/java/scene/)