Load and Save Options

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

Enumerations

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

Enumerations: aspose.threed.formats

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

Enumerations

Enumerations LoadOptions и SaveOptions наследяват от IOConfig. Следните свойства са налични за всеки обект за опции.

EnumerationsEnumerationsEnumerations
file_format`FileFormatNone`
encoding`strNone`
file_system`FileSystemNone`
lookup_pathslist[str]Допълнителни директории за търсене при разрешаване на външни препратки
file_name`strNone`

LoadOptions

Базов клас за всички обекти с опции за зареждане.

Допълнително свойство (над IOConfig):

EnumerationsEnumerationsEnumerations
encoding`strNone`

SaveOptions

Базов клас за всички обекти с опции за запазване.

Допълнително свойство (над IOConfig):

EnumerationsEnumerationsEnumerations
export_texturesboolEnumerations 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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseОбръщане на координатната система при импортиране
enable_materialsboolTrueЗареждане на съпровождащия .mtl файл с материал
scalefloat1.0Униформален мащаб, приложен към цялата импортирана геометрия
normalize_normalboolTrueНормализиране на импортираните нормални вектори до единична дължина

ObjSaveOptions

Справка за класа GlobalTransform.

from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)
EnumerationsEnumerationsEnumerationsEnumerations
apply_unit_scaleboolFalseПрилагане на фактора за единичен мащаб на сцената към експортираните координати
point_cloudboolFalseЕкспортиране само на върхове (без полигонни лица)
verboseboolFalseВключване на допълнителни OBJ коментари в изхода
serialize_wboolFalseЗаписване на W компонента на контролните точки
enable_materialsboolTrueЗапиши .mtl файл с материал и го реферирайте от .obj
flip_coordinate_systemboolFalseОбръщане на координатната система при експортиране
axis_system`AxisSystemNone`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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_tex_coord_vboolTrueОбръщане на 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)
EnumerationsEnumerationsEnumerationsEnumerations
binary_modeboolFalseEnumerations True, записва самостоятелен двоичен GLB; когато False, записва JSON .gltf с външен буфер
flip_tex_coord_vboolTrueОбръщане на V координатите на текстурите при експортиране
export_texturesboolFalseКопиране на реферираните текстури в изходния пакет (наследено от 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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseОбръщане на координатната система при импортиране
scalefloat1.0Униформно мащабиране, приложено към импортирана геометрия

StlSaveOptions

Опции за запазване за изход STL.

from aspose.threed.formats import StlSaveOptions
opts = StlSaveOptions()
opts.binary_mode = True
scene.save("output.stl", opts)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseОбръщане на координатната система при експортиране
scalefloat1.0Униформно мащабиране, приложено към експортирана геометрия
binary_modeboolFalseЗаписване на бинарен 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)
EnumerationsEnumerationsEnumerationsEnumerations
keep_builtin_global_settingsboolFalseЗапазване на FBX GlobalSettings свойства в информацията за активите на сцената
compatible_modeboolFalseАктивиране на режим на съвместимост за FBX файлове от по-стари инструменти за създаване

FbxSaveOptions

Опции за запазване за изход FBX.

from aspose.threed.formats import FbxSaveOptions
opts = FbxSaveOptions()
opts.enable_compression = False
scene.save("output.fbx", opts)
EnumerationsEnumerationsEnumerationsEnumerations
export_texturesboolFalseКопиране на препратените текстури в изходната директория
reuse_primitive_meshboolFalseПремахване на дублираща се идентична мрежова геометрия в изхода
enable_compressionboolTrueАктивиране на вътрешно бинарно компресиране на FBX
fold_repeated_curve_dataEnumerationsNoneСъбиране на идентични сегменти от анимационни криви
export_legacy_material_propertiesboolTrueВключване на legacy Phong/Lambert възли за свойства на материал за съвместимост
video_for_textureboolFalseВграждане на данни за текстура във FBX видео възли
embed_texturesboolFalseВграждане на файлове с текстури в FBX бинарния файл
generate_vertex_element_materialboolFalseДобави VertexElementMaterial слой за присвояване на материал за всеки полигон

ColladaLoadOptions

Опции за зареждане на файлове COLLADA (.dae).

from aspose.threed.formats import ColladaLoadOptions
opts = ColladaLoadOptions()
opts.scale = 0.01
scene = Scene()
scene.open("model.dae", opts)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseОбръщане на координатната система при импортиране
enable_materialsboolTrueИмпортиране на дефинициите на материалите от COLLADA
scalefloat1.0Еднородно мащабиране, приложено към импортираната геометрия
normalize_normalboolTrueНормализиране на импортираните нормални вектори

ColladaSaveOptions

Опции за запазване за изход в COLLADA.

from aspose.threed.formats import ColladaSaveOptions
opts = ColladaSaveOptions()
opts.indented = False   # compact output
scene.save("output.dae", opts)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseОбръщане на координатната система при експортиране
enable_materialsboolTrueЗаписване на материалните дефиниции в COLLADA
indentedboolTrueФорматиране на 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 издание не са документирани допълнителни свойства, специфични за формата.


Вижте също

 Български