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. Следните свойства са налични за всеки обект за опции.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Допълнителни директории за търсене при разрешаване на външни препратки |
file_name | `str | None` |
LoadOptions
Базов клас за всички обекти с опции за зареждане.
Допълнително свойство (над IOConfig):
| Enumerations | Enumerations | Enumerations |
|---|---|---|
encoding | `str | None` |
SaveOptions
Базов клас за всички обекти с опции за запазване.
Допълнително свойство (над IOConfig):
| Enumerations | Enumerations | Enumerations |
|---|---|---|
export_textures | bool | Enumerations 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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
flip_coordinate_system | bool | False | Обръщане на координатната система при импортиране |
enable_materials | bool | True | Зареждане на съпровождащия .mtl файл с материал |
scale | float | 1.0 | Униформален мащаб, приложен към цялата импортирана геометрия |
normalize_normal | bool | True | Нормализиране на импортираните нормални вектори до единична дължина |
ObjSaveOptions
Справка за класа GlobalTransform.
from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
binary_mode | bool | False | Enumerations 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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
export_textures | bool | False | Копиране на препратените текстури в изходната директория |
reuse_primitive_mesh | bool | False | Премахване на дублираща се идентична мрежова геометрия в изхода |
enable_compression | bool | True | Активиране на вътрешно бинарно компресиране на FBX |
fold_repeated_curve_data | Enumerations | None | Събиране на идентични сегменти от анимационни криви |
export_legacy_material_properties | bool | True | Включване на legacy 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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
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 издание не са документирани допълнителни свойства, специфични за формата.