Load and Save Options

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

Tüm içe ve dışa aktarma işlemleri, türetilen isteğe bağlı bir options object kabul eder LoadOptions veya SaveOptions. Uygun alt sınıfı şuraya gönderin Scene.open() veya Scene.save() format‑spesifik davranışı kontrol etmek için.

: aspose.threed.formats

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

LoadOptions ve SaveOptions şuradan miras alır IOConfig. Aşağıdaki özellikler her seçenek nesnesinde mevcuttur.


`file_format`	`FileFormat	None`
`encoding`	`str	None`
`file_system`	`FileSystem	None`
`lookup_paths`	`list[str]`	Harici referansları çözerken aranacak ek dizinler
`file_name`	`str	None`

LoadOptions

Tüm yükleme‑seçeneği nesneleri için temel sınıf.

Ek özellik (daha fazlası IOConfig):


`encoding`	`str	None`

SaveOptions

Tüm kaydetme‑seçeneği nesneleri için temel sınıf.

Ek özellik (daha ötesinde IOConfig):


`export_textures`	`bool`	`True`, sahne tarafından referans verilen dokular çıktıya kopyalanır. Varsayılan olarak `False`

ObjLoadOptions

Wavefront OBJ dosyaları için yükleme seçenekleri (.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`	İçe aktarırken koordinat sistemini ters çevir
`enable_materials`	`bool`	`True`	Eşlik edenini yükle `.mtl` malzeme dosyası
`scale`	`float`	`1.0`	İçe aktarılan tüm geometriye uygulanan tekdüze ölçek
`normalize_normal`	`bool`	`True`	İçe aktarılan normal vektörleri birim uzunluğa normalize et

ObjSaveOptions

Wavefront OBJ dosyaları için kaydetme seçenekleri.

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


`apply_unit_scale`	`bool`	`False`	Sahnenin birim ölçek faktörünü dışa aktarılan koordinatlara uygula
`point_cloud`	`bool`	`False`	Yalnızca köşeleri dışa aktar (poligon yüzleri yok)
`verbose`	`bool`	`False`	Çıktıya ek OBJ yorumları ekle
`serialize_w`	`bool`	`False`	Kontrol noktalarının W bileşenini yaz
`enable_materials`	`bool`	`True`	Yaz `.mtl` malzeme dosyasını ve ondan referans ver `.obj`
`flip_coordinate_system`	`bool`	`False`	Dışa aktarırken koordinat sistemini ters çevir
`axis_system`	`AxisSystem	None`	`None`

GltfLoadOptions

glTF 2.0 ve GLB dosyaları için yükleme seçenekleri (.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`	İçe aktarırken V doku koordinatlarını ters çevir (glTF üst‑sol kökeni kullanır; `True` alt‑sola dönüştürür)

GltfSaveOptions

glTF 2.0 çıktısı için kaydetme seçenekleri.

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`, kendi içinde bütünleşik ikili bir GLB yazar; ne zaman `False`, JSON yazar `.gltf` harici bir tamponla
`flip_tex_coord_v`	`bool`	`True`	Dışa aktarırken V doku koordinatlarını ters çevir
`export_textures`	`bool`	`False`	Referans verilen dokuları çıktı paketine kopyala (devralındığı `SaveOptions`)

StlLoadOptions

STL dosyaları için yükleme seçenekleri (.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`	İçe aktarırken koordinat sistemini ters çevir
`scale`	`float`	`1.0`	İçe aktarılan geometriye tekdüze ölçek uygulanır

StlSaveOptions

STL çıktısı için kaydetme seçenekleri.

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


`flip_coordinate_system`	`bool`	`False`	Dışa aktarırken koordinat sistemini ters çevir
`scale`	`float`	`1.0`	Dışa aktarılan geometriye tekdüze ölçek uygulanır
`binary_mode`	`bool`	`False`	ASCII STL yerine ikili STL yaz

FbxLoadOptions

FBX dosyaları için yükleme seçenekleri (.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`	FBX’i koru `GlobalSettings` sahne varlık bilgilerindeki özellikler
`compatible_mode`	`bool`	`False`	Eski oluşturma araçlarından gelen FBX dosyaları için uyumluluk modunu etkinleştir

FbxSaveOptions

FBX çıktısı için kaydetme seçenekleri.

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


`export_textures`	`bool`	`False`	Referans verilen dokuları çıktı dizinine kopyala
`reuse_primitive_mesh`	`bool`	`False`	Çıktıda aynı ağ geometrisini tekilleştir
`enable_compression`	`bool`	`True`	İkili FBX iç sıkıştırmasını etkinleştir
`fold_repeated_curve_data`		`None`	Aynı animasyon eğri bölümlerini birleştir
`export_legacy_material_properties`	`bool`	`True`	Eski sürümleri dahil et `Phong`/`Lambert` uyumluluk için malzeme özellik düğümleri
`video_for_texture`	`bool`	`False`	FBX video düğümlerine doku verisini göm
`embed_textures`	`bool`	`False`	FBX ikili dosyasına doku dosyalarını satır içinde göm
`generate_vertex_element_material`	`bool`	`False`	Bir ekle `VertexElementMaterial` çokgen başına malzeme atama katmanı

ColladaLoadOptions

COLLADA dosyaları için yükleme seçenekleri (.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`	İçe aktarırken koordinat sistemini ters çevir
`enable_materials`	`bool`	`True`	COLLADA malzeme tanımlarını içe aktar
`scale`	`float`	`1.0`	İçe aktarılan geometriye eşit ölçek uygulanır
`normalize_normal`	`bool`	`True`	İçe aktarılan normal vektörleri normalleştir

ColladaSaveOptions

COLLADA çıktısı için kaydetme seçenekleri.

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


`flip_coordinate_system`	`bool`	`False`	Dışa aktarırken koordinat sistemini ters çevir
`enable_materials`	`bool`	`True`	COLLADA malzeme tanımlarını yaz
`indented`	`bool`	`True`	XML çıktısını girintili olarak güzel biçimlendir

ThreeMfLoadOptions / ThreeMfSaveOptions

3MF dosyaları için yükleme ve kaydetme seçenekleri (.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)

Bu sınıflar temel özellikleri şuradan devralır LoadOptions / SaveOptions sırasıyla. Mevcut FOSS sürümü için ek format-specific özellikler belgelenmemiştir.