Load and Save Options — Aspose.3D FOSS for Python API Reference
Všetky operácie importu a exportu akceptujú voliteľný objekt nastavení odvodený od LoadOptions alebo SaveOptions. Odovzdajte vhodnú podtriedu do Scene.open() alebo Scene.save() na riadenie správania špecifického pre formát.
: aspose.threed.formats
from aspose.threed.formats import (
LoadOptions, SaveOptions,
ObjLoadOptions, ObjSaveOptions,
GltfLoadOptions, GltfSaveOptions,
StlLoadOptions, StlSaveOptions,
FbxLoadOptions, FbxSaveOptions,
ColladaLoadOptions, ColladaSaveOptions,
ThreeMfLoadOptions, ThreeMfSaveOptions,
)LoadOptions a SaveOptions dedia od IOConfig. Nasledujúce vlastnosti sú k dispozícii v každom objekte nastavení.file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Ďalšie adresáre na prehľadávanie pri riešení externých odkazov |
file_name | `str | None` |
LoadOptions
Základná trieda pre všetky objekty načítacích možností.
Ďalšia vlastnosť (nad IOConfig):
encoding | `str | None` |
SaveOptions
Základná trieda pre všetky objekty ukladacích možností.
Ďalšia vlastnosť (nad IOConfig):
export_textures | bool | True, textúry odkazované scénou sa skopírujú do výstupu. Predvolene na False |
ObjLoadOptions
Možnosti načítania pre súbory 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 | Preklopiť súradnicový systém pri importe |
enable_materials | bool | True | Načítať pripojený .mtl súbor materiálu |
scale | float | 1.0 | Jednotná mierka aplikovaná na všetku importovanú geometriu |
normalize_normal | bool | True | Normalizovať importované normálové vektory na jednotkovú dĺžku |
ObjSaveOptions
Možnosti ukladania pre súbory Wavefront OBJ.
from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)apply_unit_scale | bool | False | Použiť faktor jednotkovej mierky scény na exportované súradnice |
point_cloud | bool | False | Exportovať iba vrcholy (žiadne polygonové plochy) |
verbose | bool | False | Zahrnúť ďalšie OBJ komentáre do výstupu |
serialize_w | bool | False | Zapísať komponentu W riadiacich bodov |
enable_materials | bool | True | Zapísať a .mtl súbor materiálu a odkazovať naň z .obj |
flip_coordinate_system | bool | False | Preklopiť súradnicový systém pri exporte |
axis_system | `AxisSystem | None` | None |
GltfLoadOptions
Možnosti načítania pre súbory glTF 2.0 a 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 | Preklopiť V textúrové súradnice pri importe (glTF používa pôvod vľavo hore; True konvertuje na dolný ľavý) |
GltfSaveOptions
Možnosti ukladania pre výstup 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, zapisuje samostatný binárny GLB; keď False, zapisuje JSON .gltf s externým bufferom |
flip_tex_coord_v | bool | True | Preklopiť V textúrové súradnice pri exporte |
export_textures | bool | False | Skopírovať odkazované textúry do výstupného balíka (zdedené z SaveOptions) |
StlLoadOptions
Načítanie možností pre súbory 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 | Preklopiť súradnicový systém pri importe |
scale | float | 1.0 | Jednotná mierka aplikovaná na importovanú geometriu |
StlSaveOptions
Možnosti ukladania pre výstup STL.
from aspose.threed.formats import StlSaveOptions
opts = StlSaveOptions()
opts.binary_mode = True
scene.save("output.stl", opts)flip_coordinate_system | bool | False | Preklopiť súradnicový systém pri exporte |
scale | float | 1.0 | Jednotná mierka aplikovaná na exportovanú geometriu |
binary_mode | bool | False | Zapísať binárny STL namiesto ASCII STL |
FbxLoadOptions
Možnosti načítania pre súbory 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 | Zachovať FBX GlobalSettings vlastnosti v informáciách o scéne |
compatible_mode | bool | False | Povoliť režim kompatibility pre súbory FBX zo starších autorizačných nástrojov |
FbxSaveOptions
Možnosti ukladania pre výstup FBX.
from aspose.threed.formats import FbxSaveOptions
opts = FbxSaveOptions()
opts.enable_compression = False
scene.save("output.fbx", opts)export_textures | bool | False | Skopírovať odkazované textúry do výstupného adresára |
reuse_primitive_mesh | bool | False | Odstrániť duplicitnú identickú sieťovú geometriu v výstupe |
enable_compression | bool | True | Povoliť internú binárnu kompresiu FBX |
fold_repeated_curve_data | None | Zložiť identické segmenty animačných kriviek | |
export_legacy_material_properties | bool | True | Zahrnúť zastaralé Phong/Lambert uzly vlastností materiálu pre kompatibilitu |
video_for_texture | bool | False | Vložiť dáta textúry do video uzlov FBX |
embed_textures | bool | False | Vložiť textúrovacie súbory priamo do binárneho súboru FBX |
generate_vertex_element_material | bool | False | Pridať VertexElementMaterial vrstva pre priradenie materiálu po jednotlivých polygónoch |
ColladaLoadOptions
Možnosti načítania pre súbory 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 | Preklopiť súradnicový systém pri importe |
enable_materials | bool | True | Importovať definície materiálov COLLADA |
scale | float | 1.0 | Jednotná mierka aplikovaná na importovanú geometriu |
normalize_normal | bool | True | Normalizovať importované normálové vektory |
ColladaSaveOptions
Možnosti ukladania pre výstup COLLADA.
from aspose.threed.formats import ColladaSaveOptions
opts = ColladaSaveOptions()
opts.indented = False # compact output
scene.save("output.dae", opts)flip_coordinate_system | bool | False | Preklopiť súradnicový systém pri exporte |
enable_materials | bool | True | Zapísať definície materiálov COLLADA |
indented | bool | True | Formátovať výstup XML s odsadením |
ThreeMfLoadOptions / ThreeMfSaveOptions
Možnosti načítania a ukladania pre súbory 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)Tieto triedy dedičia základné vlastnosti od LoadOptions / SaveOptions príslušne. Žiadne ďalšie špecifické vlastnosti formátu nie sú zdokumentované pre aktuálne vydanie FOSS.