Load and Save Options

Load and Save Options — Aspose.3D FOSS for Java

Properties

Усі операції імпорту та експорту приймають необов’язковий об’єкт options object, успадкований від LoadOptions або SaveOptions. Передайте відповідний підклас до Scene.open() або Scene.save() для керування поведінкою, специфічною для формату.

Properties: com.aspose.threed

import com.aspose.threed.*;

LoadOptions

Базовий клас для всіх об’єктів load-option. Розширює A3DObject.

Properties	Properties	Properties	Properties
`fileFormat`	`FileFormat`	`getFileFormat()`	Формат, з яким пов’язана ця конфігурація (лише для читання)

SaveOptions

Базовий клас для всіх об’єктів save-option. Розширює A3DObject.

Properties	Properties	Properties	Properties
`fileFormat`	`FileFormat`	`getFileFormat()`	Формат, з яким пов’язана ця конфігурація (тільки для читання)

ObjLoadOptions

Параметри завантаження для файлів Wavefront OBJ (.obj).

ObjLoadOptions opts = new ObjLoadOptions(); opts.setFlipCoordinateSystem(true); opts.setScale(0.01); Scene scene = new Scene(); scene.open(“model.obj”, opts);


| Properties             | Properties | Properties                  | Properties                         | Properties | Properties                                                             |
| ---------------------- | ---------- | --------------------------- | ---------------------------------- | ---------- | ---------------------------------------------------------------------- |
| `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);

Properties	Properties	Properties	Properties	Properties	Properties
`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);


| Properties             | Properties | Properties                  | Properties                         | Properties | Properties                                                   |
| ---------------------- | ---------- | --------------------------- | ---------------------------------- | ---------- | ------------------------------------------------------------ |
| `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);

Properties	Properties	Properties	Properties	Properties	Properties
`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);


| Properties             | Properties        | Properties                  | Properties                         | Properties | Properties                                       |
| ---------------------- | ----------------- | --------------------------- | ---------------------------------- | ---------- | ------------------------------------------------ |
| `flipCoordinateSystem` | `boolean`         | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false`    | Перевернути систему координат під час імпорту    |
| `recalculateNormal`    | `boolean`         | `getRecalculateNormal()`    | `setRecalculateNormal(boolean)`    | `false`    | Перерахувати нормалі з геометрії під час імпорту |
| `contentType`          | `FileContentType` | `getContentType()`          | `setContentType(FileContentType)`  | --         | Підказка для визначення бінарного чи ASCII STL   |

---

## StlSaveOptions

Параметри збереження для виводу STL.

StlSaveOptions opts = new StlSaveOptions();
opts.setContentType(FileContentType.BINARY);
scene.save("output.stl", opts);

Properties	Properties	Properties	Properties	Properties	Properties
`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);


| Properties             | Properties | Properties                  | Properties                         | Properties | Properties                                    |
| ---------------------- | ---------- | --------------------------- | ---------------------------------- | ---------- | --------------------------------------------- |
| `flipCoordinateSystem` | `boolean`  | `getFlipCoordinateSystem()` | `setFlipCoordinateSystem(boolean)` | `false`    | Перевернути систему координат під час імпорту |

---

## FbxSaveOptions

**Примітка:** Експорт FBX є **недоступний** у Java FOSS-версії. FBX підтримується лише для імпорту. The `FbxSaveOptions` Клас існує в API, але при використанні для збереження викличе помилку. Для експорту використовуйте OBJ, STL, glTF або GLB.

---

## Див. також

- [Довідка класу FileFormat.](/3d/java/file-format/)
- [Довідка щодо класу Scene](/3d/java/scene/)