Load and Save Options — Aspose.3D FOSS for Java
Properties
Все операции импорта и экспорта принимают необязательный объект параметров, производный от LoadOptions или SaveOptions. Передайте соответствующий подкласс в Scene.open() или Scene.save() для управления поведением, специфичным для формата.
Properties: com.aspose.threed
import com.aspose.threed.*;LoadOptions
Базовый класс для всех объектов параметров загрузки. Наследует A3DObject.
| Properties | Properties | Properties | Properties |
|---|---|---|---|
fileFormat | FileFormat | getFileFormat() | Формат, с которым связана эта конфигурация (только для чтения) |
SaveOptions
Базовый класс для всех объектов параметров сохранения. Наследует A3DObject.
| Properties | Properties | Properties | Properties |
|---|---|---|---|
fileFormat | FileFormat | getFileFormat() | Формат, с которым связан этот конфиг (только для чтения) |
ObjLoadOptions
Параметры загрузки файлов Wavefront OBJ (.obj).
import com.aspose.threed.*;
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.
import com.aspose.threed.*;
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).
import com.aspose.threed.*;
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.
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).
import com.aspose.threed.*;
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) | – | Подсказка для определения бинарного vs ASCII STL |
StlSaveOptions
Параметры сохранения для вывода STL.
import com.aspose.threed.*;
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).
import com.aspose.threed.*;
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 поддерживается только для импорта. FbxSaveOptions Класс существует в API, но при попытке сохранить вызовет ошибку. Вместо этого используйте OBJ, STL, glTF или GLB для экспорта.