Load and Save Options

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

ColladaSaveOptions

Все операции импорта и экспорта принимают необязательный объект параметров, полученный из LoadOptions или SaveOptions. Передайте соответствующий подкласс в Scene.open() или Scene.save() для управления поведением, специфичным для формата.

ColladaSaveOptions: aspose.threed.formats

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

ColladaSaveOptions

ColladaSaveOptions LoadOptions и SaveOptions наследуются от IOConfig. Следующие свойства доступны в каждом объекте параметров.

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

LoadOptions

Базовый класс для всех объектов параметров загрузки.

Дополнительное свойство (за пределами IOConfig):

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`encoding`	`str	None`

SaveOptions

Базовый класс для всех объектов параметров сохранения.

Дополнительное свойство (за пределами IOConfig):

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`export_textures`	`bool`	ColladaSaveOptions `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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`apply_unit_scale`	`bool`	`False`	Применить коэффициент масштабирования единицы сцены к экспортированным координатам
`point_cloud`	`bool`	`False`	Экспортировать только вершины (без полигональных граней)
`verbose`	`bool`	`False`	Включить дополнительные комментарии OBJ в вывод
`serialize_w`	`bool`	`False`	Записать компонент W контрольных точек
`enable_materials`	`bool`	`True`	Записать a `.mtl` material file и сослаться на него из `.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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`binary_mode`	`bool`	`False`	ColladaSaveOptions `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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`keep_builtin_global_settings`	`bool`	`False`	Сохранять FBX `GlobalSettings` свойства в информации об asset сцены
`compatible_mode`	`bool`	`False`	Включить режим совместимости для файлов FBX из старых инструментов авторинга

FbxSaveOptions

Параметры сохранения для вывода FBX.

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

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`export_textures`	`bool`	`False`	Скопировать используемые текстуры в каталог вывода
`reuse_primitive_mesh`	`bool`	`False`	Устранить дублирование идентичной геометрии меша в выводе
`enable_compression`	`bool`	`True`	Включить бинарное внутреннее сжатие FBX
`fold_repeated_curve_data`	ColladaSaveOptions	`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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`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)

ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions	ColladaSaveOptions
`flip_coordinate_system`	`bool`	`False`	Перевернуть систему координат при экспорте
`enable_materials`	`bool`	`True`	Записать определения материалов COLLADA
`indented`	`bool`	`True`	Отформатировать XML-вывод с отступами

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‑релиза не задокументированы дополнительные свойства, специфичные для формата.

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

ColladaSaveOptions

ColladaSaveOptions

LoadOptions

SaveOptions

ObjLoadOptions

ObjSaveOptions

GltfLoadOptions

GltfSaveOptions

StlLoadOptions

StlSaveOptions

FbxLoadOptions

FbxSaveOptions

ColladaLoadOptions

ColladaSaveOptions

ThreeMfLoadOptions / ThreeMfSaveOptions

См. также