Load and Save Options — Aspose.3D FOSS for Python API Reference
Enumerations
Všechny operace importu a exportu přijímají volitelný objekt možností odvozený z LoadOptions nebo SaveOptions. Předávejte vhodnou podtřídu do Scene.open() nebo Scene.save() pro řízení chování specifického pro formát.
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 a SaveOptions dědí z IOConfig. Následující vlastnosti jsou k dispozici v každém objektu možností.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Další adresáře, které se mají prohledávat při řešení externích odkazů |
file_name | `str | None` |
LoadOptions
Základní třída pro všechny objekty načítacích možností.
Další vlastnost (mimo IOConfig):
| Enumerations | Enumerations | Enumerations |
|---|---|---|
encoding | `str | None` |
SaveOptions
Základní třída pro všechny objekty ukládacích možností.
Další vlastnost (mimo IOConfig):
| Enumerations | Enumerations | Enumerations |
|---|---|---|
export_textures | bool | Enumerations True, textury odkazované scénou jsou zkopírovány do výstupu. Výchozí je False |
ObjLoadOptions
Načíst možnosti pro soubory 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 | Převrátit souřadnicový systém při importu |
enable_materials | bool | True | Načíst přidružený .mtl soubor materiálu |
scale | float | 1.0 | Jednotné měřítko aplikované na veškerou importovanou geometrii |
normalize_normal | bool | True | Normalizovat importované normálové vektory na jednotkovou délku |
ObjSaveOptions
Materiál Physically Based Rendering používaný ve formátu glTF 2.0 a dalších formátech podporujících PBR.
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 | Použít faktor jednotkového měřítka scény na exportované souřadnice |
point_cloud | bool | False | Exportovat pouze vrcholy (žádné polygonální plochy) |
verbose | bool | False | Zahrnout další OBJ komentáře do výstupu |
serialize_w | bool | False | Zapsat komponentu W řídicích bodů |
enable_materials | bool | True | Zapsat a .mtl soubor materiálu a odkazovat na něj z .obj |
flip_coordinate_system | bool | False | Převrátit souřadnicový systém při exportu |
axis_system | `AxisSystem | None` | None |
GltfLoadOptions
Možnosti načítání pro soubory 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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
flip_tex_coord_v | bool | True | Převrátit V texturové souřadnice při importu (glTF používá počátek v levém horním rohu; True převádí na levý dolní roh) |
GltfSaveOptions
Možnosti ukládání pro 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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
binary_mode | bool | False | Enumerations True, zapisuje samostatný binární GLB; když False, zapisuje JSON .gltf s externím bufferem |
flip_tex_coord_v | bool | True | Převrátit V souřadnice textury při exportu |
export_textures | bool | False | Zkopírovat odkazované textury do výstupního balíčku (zděděno z SaveOptions) |
StlLoadOptions
Načíst možnosti pro soubory 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 | Převrátit souřadnicový systém při importu |
scale | float | 1.0 | Jednotné měřítko aplikované na importovanou geometrii |
StlSaveOptions
Možnosti ukládání pro výstup 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 | Převrátit souřadnicový systém při exportu |
scale | float | 1.0 | Jednotné měřítko aplikované na exportovanou geometrii |
binary_mode | bool | False | Zapsat binární STL místo ASCII STL |
FbxLoadOptions
Možnosti načítání pro soubory 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 | Zachovat FBX GlobalSettings vlastnosti v informacích o assetu scény |
compatible_mode | bool | False | Povolit režim kompatibility pro soubory FBX ze starších autorovacích nástrojů |
FbxSaveOptions
Možnosti ukládání pro výstup 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 | Zkopírovat odkazované textury do výstupního adresáře |
reuse_primitive_mesh | bool | False | Odstranit duplicitní identickou síťovou geometrii ve výstupu |
enable_compression | bool | True | Povolit interní binární kompresi FBX |
fold_repeated_curve_data | Enumerations | None | Složit identické segmenty animačních křivek |
export_legacy_material_properties | bool | True | Zahrnout legacy Phong/Lambert uzly vlastností materiálu pro kompatibilitu |
video_for_texture | bool | False | Vložit data textury do video uzlů FBX |
embed_textures | bool | False | Zabudovat soubory textur přímo do binárního souboru FBX |
generate_vertex_element_material | bool | False | Přidat VertexElementMaterial vrstvu pro přiřazení materiálu po jednotlivých polygonech |
ColladaLoadOptions
Možnosti načítání pro soubory 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 | Převrátit souřadnicový systém při importu |
enable_materials | bool | True | Importovat definice materiálů COLLADA |
scale | float | 1.0 | Jednotné měřítko aplikované na importovanou geometrii |
normalize_normal | bool | True | Normalizovat importované normálové vektory |
ColladaSaveOptions
Možnosti ukládání pro výstup 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 | Převrátit souřadnicový systém při exportu |
enable_materials | bool | True | Zapsat definice materiálů COLLADA |
indented | bool | True | Hezky formátovat výstup XML s odsazením |
ThreeMfLoadOptions / ThreeMfSaveOptions
Načíst a uložit možnosti pro soubory 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)Tyto třídy dědí základní vlastnosti z LoadOptions / SaveOptions odpovídajícím způsobem. Pro aktuální FOSS vydání nejsou zdokumentovány žádné další formátově specifické vlastnosti.