Load and Save Options

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

Alla import- och exportoperationer accepterar ett valfritt options‑objekt härlett från LoadOptions eller SaveOptions. Skicka den lämpliga subklassen till Scene.open() eller Scene.save() för att styra format‑specifikt beteende.

: aspose.threed.formats

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

LoadOptions och SaveOptions ärver från IOConfig. Följande egenskaper är tillgängliga på varje options‑objekt.


`file_format`	`FileFormat	None`
`encoding`	`str	None`
`file_system`	`FileSystem	None`
`lookup_paths`	`list[str]`	Ytterligare kataloger att söka i när externa referenser löses upp
`file_name`	`str	None`

LoadOptions

Basklass för alla laddningsalternativobjekt.

Ytterligare egenskap (utöver IOConfig):


`encoding`	`str	None`

SaveOptions

Basklass för alla sparalternativobjekt.

Ytterligare egenskap (utöver IOConfig):


`export_textures`	`bool`	`True`, texturer som refereras av scenen kopieras till utdata. Standard är `False`

ObjLoadOptions

Läsalternativ för Wavefront OBJ-filer (.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`	Vänd koordinatsystemet vid import
`enable_materials`	`bool`	`True`	Läs den medföljande `.mtl` materialfil
`scale`	`float`	`1.0`	Enhetlig skala tillämpas på all importerad geometri
`normalize_normal`	`bool`	`True`	Normalisera importerade normalvektorer till enhetslängd

ObjSaveOptions

Sparalternativ för Wavefront OBJ‑filer.

from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)


`apply_unit_scale`	`bool`	`False`	Applicera scenens enhetsskalfaktor på exporterade koordinater
`point_cloud`	`bool`	`False`	Exportera endast vertexar (inga polygonytor)
`verbose`	`bool`	`False`	Inkludera ytterligare OBJ-kommentarer i utdata
`serialize_w`	`bool`	`False`	Skriv W-komponenten för kontrollpunkterna
`enable_materials`	`bool`	`True`	Skriv en `.mtl` materialfil och referera till den från `.obj`
`flip_coordinate_system`	`bool`	`False`	Vänd koordinatsystemet vid export
`axis_system`	`AxisSystem	None`	`None`

GltfLoadOptions

Läsalternativ för glTF 2.0- och GLB-filer (.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`	Vänd V-texturkoordinater vid import (glTF använder ursprung i övre vänstra hörnet; `True` konverterar till nedre vänstra)

GltfSaveOptions

Sparalternativ för glTF 2.0‑utdata.

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`, skriver en fristående binär GLB; när `False`, skriver JSON `.gltf` med en extern buffert
`flip_tex_coord_v`	`bool`	`True`	Vänd V‑texturkoordinater vid export
`export_textures`	`bool`	`False`	Kopiera refererade texturer till utdata‑paketet (ärvt från `SaveOptions`)

StlLoadOptions

Läsalternativ för STL‑filer (.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`	Vänd koordinatsystemet vid import
`scale`	`float`	`1.0`	Enhetlig skala tillämpad på importerad geometri

StlSaveOptions

Sparalternativ för STL‑utdata.

from aspose.threed.formats import StlSaveOptions
opts = StlSaveOptions()
opts.binary_mode = True
scene.save("output.stl", opts)


`flip_coordinate_system`	`bool`	`False`	Vänd koordinatsystemet vid export
`scale`	`float`	`1.0`	Enhetlig skala tillämpad på exporterad geometri
`binary_mode`	`bool`	`False`	Skriv binär STL istället för ASCII STL

FbxLoadOptions

Läsalternativ för FBX-filer (.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`	Bevara FBX `GlobalSettings` egenskaper i scenens tillgångsinformation
`compatible_mode`	`bool`	`False`	Aktivera kompatibilitetsläge för FBX-filer från äldre författarverktyg

FbxSaveOptions

Spara alternativ för FBX-utdata.

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


`export_textures`	`bool`	`False`	Kopiera refererade texturer till utmatningskatalogen
`reuse_primitive_mesh`	`bool`	`False`	Avlägsna dubbletter av identisk mesh-geometri i utdata
`enable_compression`	`bool`	`True`	Aktivera intern binär FBX-komprimering
`fold_repeated_curve_data`		`None`	Sammanfoga identiska animationskurvsegment
`export_legacy_material_properties`	`bool`	`True`	Inkludera äldre `Phong`/`Lambert` materialegenskapsnoder för kompatibilitet
`video_for_texture`	`bool`	`False`	Bädda in texturdata i FBX-videonoder
`embed_textures`	`bool`	`False`	Inbädda texturfiler inline i FBX-binären
`generate_vertex_element_material`	`bool`	`False`	Lägg till en `VertexElementMaterial` lager för per-polygon materialtilldelning

ColladaLoadOptions

Läsalternativ för COLLADA-filer (.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`	Vänd koordinatsystemet vid import
`enable_materials`	`bool`	`True`	Importera COLLADA-materialdefinitioner
`scale`	`float`	`1.0`	Enhetlig skalning tillämpad på importerad geometri
`normalize_normal`	`bool`	`True`	Normalisera importerade normalvektorer

ColladaSaveOptions

Spara alternativ för COLLADA-utdata.

from aspose.threed.formats import ColladaSaveOptions
opts = ColladaSaveOptions()
opts.indented = False   # compact output
scene.save("output.dae", opts)


`flip_coordinate_system`	`bool`	`False`	Vänd koordinatsystemet vid export
`enable_materials`	`bool`	`True`	Skriv COLLADA-materialdefinitioner
`indented`	`bool`	`True`	Snyggt formatera XML-utdata med indrag

ThreeMfLoadOptions / ThreeMfSaveOptions

Läs- och sparaalternativ för 3MF-filer (.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)

Dessa klasser ärver basegenskaper från LoadOptions / SaveOptions respektive. Inga ytterligare format‑specifika egenskaper är dokumenterade för den aktuella FOSS‑utgåvan.