Load and Save Options

Load and Save Options — Aspose.3D FOSS for Python API Reference

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

: aspose.threed.formats

from aspose.threed.formats import (
    LoadOptions, SaveOptions,
    ObjLoadOptions, ObjSaveOptions,
    GltfLoadOptions, GltfSaveOptions,
    StlLoadOptions, StlSaveOptions,
    FbxLoadOptions, FbxSaveOptions,
    ColladaLoadOptions, ColladaSaveOptions,
    ThreeMfLoadOptions, ThreeMfSaveOptions,
)

LoadOptions і SaveOptions успадковують від IOConfig. Наступні властивості доступні в кожному options object.


`file_format`	`FileFormat	None`
`encoding`	`str	None`
`file_system`	`FileSystem	None`
`lookup_paths`	`list[str]`	Додаткові каталоги для пошуку під час розв’язання зовнішніх посилань
`file_name`	`str	None`

LoadOptions

Базовий клас для всіх об’єктів параметрів завантаження.

Додаткова властивість (крім IOConfig):


`encoding`	`str	None`

SaveOptions

Базовий клас для всіх об’єктів параметрів збереження.

Додаткова властивість (крім IOConfig):


`export_textures`	`bool`	`True`, текстури, на які посилається сцена, копіюються у вихідний файл. За замовчуванням `False`

ObjLoadOptions

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

from aspose.threed.formats import ObjLoadOptions
opts = ObjLoadOptions()
opts.flip_coordinate_system = True
opts.scale = 0.01
scene = Scene()
scene.open("model.obj", opts)


`flip_coordinate_system`	`bool`	`False`	Перевернути систему координат під час імпорту
`enable_materials`	`bool`	`True`	Завантажити супровідний `.mtl` файл матеріалу
`scale`	`float`	`1.0`	Уніфіковане масштабування, застосоване до всієї імпортованої геометрії
`normalize_normal`	`bool`	`True`	Нормалізувати імпортовані нормальні вектори до одиничної довжини

ObjSaveOptions

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

from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)


`apply_unit_scale`	`bool`	`False`	Застосувати коефіцієнт одиничного масштабу сцени до експортованих координат
`point_cloud`	`bool`	`False`	Експортувати лише вершини (без полігонних граней)
`verbose`	`bool`	`False`	Включити додаткові коментарі OBJ у вихідний файл
`serialize_w`	`bool`	`False`	Записати компоненту W контрольних точок
`enable_materials`	`bool`	`True`	Записати `.mtl` файл матеріалу і посилатися на нього з `.obj`
`flip_coordinate_system`	`bool`	`False`	Перевернути систему координат при експорті
`axis_system`	`AxisSystem	None`	`None`

GltfLoadOptions

Параметри завантаження для файлів glTF 2.0 та GLB (.gltf, .glb).

from aspose.threed.formats import GltfLoadOptions
opts = GltfLoadOptions()
opts.flip_tex_coord_v = False
scene = Scene()
scene.open("model.gltf", opts)


`flip_tex_coord_v`	`bool`	`True`	Перевернути координати текстури V при імпорті (glTF використовує початок у верхньому лівому куті; `True` перетворює на нижній лівий)

GltfSaveOptions

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

from aspose.threed.formats import GltfSaveOptions
opts = GltfSaveOptions()
opts.binary_mode = True   # produce a .glb file
scene.save("output.glb", opts)


`binary_mode`	`bool`	`False`	`True`, записує самодостатній бінарний GLB; коли `False`, записує JSON `.gltf` з зовнішнім буфером
`flip_tex_coord_v`	`bool`	`True`	Перевернути координати текстури V при експорті
`export_textures`	`bool`	`False`	Скопіювати посилані текстури у вихідний пакет (успадковано від `SaveOptions`)

StlLoadOptions

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

from aspose.threed.formats import StlLoadOptions
opts = StlLoadOptions()
opts.scale = 0.001   # convert millimetres to metres
scene = Scene()
scene.open("part.stl", opts)


`flip_coordinate_system`	`bool`	`False`	Перевернути систему координат при імпорті
`scale`	`float`	`1.0`	Однорідне масштабування застосовано до імпортованої геометрії

StlSaveOptions

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

from aspose.threed.formats import StlSaveOptions
opts = StlSaveOptions()
opts.binary_mode = True
scene.save("output.stl", opts)


`flip_coordinate_system`	`bool`	`False`	Перевернути систему координат при експорті
`scale`	`float`	`1.0`	Однорідне масштабування застосовано до експортованої геометрії
`binary_mode`	`bool`	`False`	Записувати бінарний STL замість ASCII STL

FbxLoadOptions

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

from aspose.threed.formats import FbxLoadOptions
opts = FbxLoadOptions()
opts.keep_builtin_global_settings = True
scene = Scene()
scene.open("animation.fbx", opts)


`keep_builtin_global_settings`	`bool`	`False`	Зберігати FBX `GlobalSettings` властивості в інформації про активи сцени
`compatible_mode`	`bool`	`False`	Увімкнути режим сумісності для файлів FBX зі старих інструментів створення

FbxSaveOptions

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

from aspose.threed.formats import FbxSaveOptions
opts = FbxSaveOptions()
opts.enable_compression = False
scene.save("output.fbx", opts)


`export_textures`	`bool`	`False`	Скопіювати посилані текстури у вихідний каталог
`reuse_primitive_mesh`	`bool`	`False`	Видалити дублікати ідентичної геометрії сітки у вихідних даних
`enable_compression`	`bool`	`True`	Увімкнути бінарне внутрішнє стиснення FBX
`fold_repeated_curve_data`		`None`	Об’єднати ідентичні сегменти кривих анімації
`export_legacy_material_properties`	`bool`	`True`	Включити застарілі `Phong`/`Lambert` вузли властивостей матеріалу для сумісності
`video_for_texture`	`bool`	`False`	Вбудувати дані текстур у відео‑вузли FBX
`embed_textures`	`bool`	`False`	Вбудувати файли текстур безпосередньо у бінарний файл FBX
`generate_vertex_element_material`	`bool`	`False`	Додати `VertexElementMaterial` шар для призначення матеріалів на рівні полігонів

ColladaLoadOptions

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

from aspose.threed.formats import ColladaLoadOptions
opts = ColladaLoadOptions()
opts.scale = 0.01
scene = Scene()
scene.open("model.dae", opts)


`flip_coordinate_system`	`bool`	`False`	Перевернути систему координат під час імпорту
`enable_materials`	`bool`	`True`	Імпорт визначень матеріалів COLLADA
`scale`	`float`	`1.0`	Уніфіковане масштабування, застосоване до імпортованої геометрії
`normalize_normal`	`bool`	`True`	Нормалізувати імпортовані вектори нормалей

ColladaSaveOptions

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

from aspose.threed.formats import ColladaSaveOptions
opts = ColladaSaveOptions()
opts.indented = False   # compact output
scene.save("output.dae", opts)


`flip_coordinate_system`	`bool`	`False`	Перевернути систему координат при експорті
`enable_materials`	`bool`	`True`	Записати визначення матеріалів COLLADA
`indented`	`bool`	`True`	Виводити XML у форматі pretty‑print з відступами

ThreeMfLoadOptions / ThreeMfSaveOptions

Параметри завантаження та збереження для файлів 3MF (.3mf).

from aspose.threed.formats import ThreeMfLoadOptions, ThreeMfSaveOptions

# Load
load_opts = ThreeMfLoadOptions()
scene = Scene()
scene.open("part.3mf", load_opts)

# Save
save_opts = ThreeMfSaveOptions()
scene.save("output.3mf", save_opts)

Ці класи успадковують базові властивості від LoadOptions / SaveOptions відповідно. Жодних додаткових специфічних для формату властивостей не задокументовано у поточному випуску FOSS.