Load and Save Options — Aspose.3D FOSS for Python API Reference
ColladaSaveOptions
Wszystkie operacje importu i eksportu akceptują opcjonalny obiekt opcji pochodzący z LoadOptions lub SaveOptions. Przekaż odpowiednią podklasę do Scene.open() lub Scene.save() aby kontrolować zachowanie specyficzne dla formatu.
ColladaSaveOptions: aspose.threed.formats
from aspose.threed.formats import (
LoadOptions, SaveOptions,
ObjLoadOptions, ObjSaveOptions,
GltfLoadOptions, GltfSaveOptions,
StlLoadOptions, StlSaveOptions,
FbxLoadOptions, FbxSaveOptions,
ColladaLoadOptions, ColladaSaveOptions,
ThreeMfLoadOptions, ThreeMfSaveOptions,
)ColladaSaveOptions
ColladaSaveOptions LoadOptions i SaveOptions dziedziczą po IOConfig. Następujące właściwości są dostępne w każdym obiekcie opcji.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Dodatkowe katalogi do przeszukania podczas rozwiązywania odwołań zewnętrznych |
file_name | `str | None` |
LoadOptions
Klasa bazowa dla wszystkich obiektów opcji ładowania.
Dodatkowa właściwość (poza IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
encoding | `str | None` |
SaveOptions
Klasa bazowa dla wszystkich obiektów opcji zapisu.
Dodatkowa właściwość (poza IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
export_textures | bool | ColladaSaveOptions True, tekstury odwoływane przez scenę są kopiowane do wyjścia. Domyślnie False |
ObjLoadOptions
Opcje ładowania dla plików 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)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | Odwróć układ współrzędnych przy imporcie |
enable_materials | bool | True | Wczytaj dołączający .mtl plik materiału |
scale | float | 1.0 | Jednolita skala stosowana do całej importowanej geometrii |
normalize_normal | bool | True | Normalizuj importowane wektory normalne do długości jednostkowej |
ObjSaveOptions
Opcje zapisu dla plików Wavefront OBJ.
from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
apply_unit_scale | bool | False | Zastosuj współczynnik skali jednostkowej sceny do wyeksportowanych współrzędnych |
point_cloud | bool | False | Eksportuj tylko wierzchołki (bez wielokątów) |
verbose | bool | False | Dołącz dodatkowe komentarze OBJ do wyjścia |
serialize_w | bool | False | Zapisz komponent W punktów kontrolnych |
enable_materials | bool | True | Zapisz a .mtl plik materiału i odwołaj się do niego z .obj |
flip_coordinate_system | bool | False | Odwróć układ współrzędnych przy eksporcie |
axis_system | `AxisSystem | None` | None |
GltfLoadOptions
Opcje ładowania dla plików glTF 2.0 i GLB (.gltf, .glb).
from aspose.threed.formats import GltfLoadOptions
opts = GltfLoadOptions()
opts.flip_tex_coord_v = False
scene = Scene()
scene.open("model.gltf", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_tex_coord_v | bool | True | Odwróć współrzędne tekstury V przy imporcie (glTF używa pochodzenia w lewym górnym rogu; True konwertuje na lewy dolny) |
GltfSaveOptions
Opcje zapisu dla wyjścia glTF 2.0.
from aspose.threed.formats import GltfSaveOptions
opts = GltfSaveOptions()
opts.binary_mode = True # produce a .glb file
scene.save("output.glb", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
binary_mode | bool | False | ColladaSaveOptions True, zapisuje samodzielny binarny GLB; gdy False, zapisuje JSON .gltf z zewnętrznym buforem |
flip_tex_coord_v | bool | True | Odwróć współrzędne tekstury V przy eksporcie |
export_textures | bool | False | Skopiuj odwołane tekstury do pakietu wyjściowego (dziedziczone z SaveOptions) |
StlLoadOptions
Opcje ładowania dla plików 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)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | Odwróć system współrzędnych przy imporcie |
scale | float | 1.0 | Jednolita skala zastosowana do importowanej geometrii |
StlSaveOptions
Opcje zapisu dla wyjścia STL.
from aspose.threed.formats import StlSaveOptions
opts = StlSaveOptions()
opts.binary_mode = True
scene.save("output.stl", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | Odwróć system współrzędnych przy eksporcie |
scale | float | 1.0 | Jednolita skala zastosowana do eksportowanej geometrii |
binary_mode | bool | False | Zapisz binarny STL zamiast ASCII STL |
FbxLoadOptions
Opcje ładowania dla plików FBX (.fbx).
from aspose.threed.formats import FbxLoadOptions
opts = FbxLoadOptions()
opts.keep_builtin_global_settings = True
scene = Scene()
scene.open("animation.fbx", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
keep_builtin_global_settings | bool | False | Zachowaj FBX GlobalSettings właściwości w informacjach zasobu sceny |
compatible_mode | bool | False | Włącz tryb zgodności dla plików FBX pochodzących ze starszych narzędzi autorskich |
FbxSaveOptions
Opcje zapisu dla wyjścia FBX.
from aspose.threed.formats import FbxSaveOptions
opts = FbxSaveOptions()
opts.enable_compression = False
scene.save("output.fbx", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
export_textures | bool | False | Skopiuj odwołane tekstury do katalogu wyjściowego |
reuse_primitive_mesh | bool | False | Usuń duplikaty identycznej geometrii siatki w wyjściu |
enable_compression | bool | True | Włącz wewnętrzną kompresję binarnego FBX |
fold_repeated_curve_data | ColladaSaveOptions | None | Zwiń identyczne segmenty krzywych animacji |
export_legacy_material_properties | bool | True | Dołącz legacy Phong/Lambert węzły właściwości material property nodes dla zgodności |
video_for_texture | bool | False | Osadź dane tekstury w węzłach wideo FBX |
embed_textures | bool | False | Osadź pliki tekstur w linii w binarze FBX |
generate_vertex_element_material | bool | False | Dodaj VertexElementMaterial warstwę do przypisywania materiału per-polygon |
ColladaLoadOptions
Opcje ładowania dla plików COLLADA (.dae).
from aspose.threed.formats import ColladaLoadOptions
opts = ColladaLoadOptions()
opts.scale = 0.01
scene = Scene()
scene.open("model.dae", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | Odwróć układ współrzędnych przy imporcie |
enable_materials | bool | True | Importuj definicje materiałów COLLADA |
scale | float | 1.0 | Jednolita skala zastosowana do importowanej geometrii |
normalize_normal | bool | True | Normalizuj importowane wektory normalne |
ColladaSaveOptions
Opcje zapisu dla wyjścia COLLADA.
from aspose.threed.formats import ColladaSaveOptions
opts = ColladaSaveOptions()
opts.indented = False # compact output
scene.save("output.dae", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | Odwróć układ współrzędnych przy eksporcie |
enable_materials | bool | True | Zapisz definicje materiałów COLLADA |
indented | bool | True | Sformatuj ładnie wyjście XML z wcięciami |
ThreeMfLoadOptions / ThreeMfSaveOptions
Opcje ładowania i zapisywania dla plików 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)Te klasy dziedziczą podstawowe właściwości z LoadOptions / SaveOptions odpowiednio. Żadne dodatkowe właściwości specyficzne dla formatu nie są udokumentowane w bieżącej wersji FOSS.