Load and Save Options — Aspose.3D FOSS for Python API Reference
ColladaSaveOptions
Tutte le operazioni di importazione ed esportazione accettano un oggetto opzioni facoltativo derivato da LoadOptions o SaveOptions. Passa la sottoclasse appropriata a Scene.open() o Scene.save() per controllare il comportamento specifico del formato.
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 e SaveOptions ereditano da IOConfig.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Directory aggiuntive da cercare durante la risoluzione dei riferimenti esterni |
file_name | `str | None` |
LoadOptions
Classe base per tutti gli oggetti di opzioni di caricamento.
Proprietà aggiuntiva (oltre a IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
encoding | `str | None` |
SaveOptions
Classe base per tutti gli oggetti di opzioni di salvataggio.
Proprietà aggiuntiva (oltre a IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
export_textures | bool | ColladaSaveOptions True, le texture referenziate dalla scena vengono copiate nell’output. Il valore predefinito è False |
ObjLoadOptions
Carica opzioni per i file 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 | Inverti il sistema di coordinate all’importazione |
enable_materials | bool | True | Carica il file associato .mtl file materiale |
scale | float | 1.0 | Scala uniforme applicata a tutta la geometria importata |
normalize_normal | bool | True | Normalizza i vettori normali importati a lunghezza unitaria |
ObjSaveOptions
Opzioni di salvataggio per i file 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 | Applica il fattore di scala unitario della scena alle coordinate esportate |
point_cloud | bool | False | Esporta solo i vertici (nessuna faccia poligonale) |
verbose | bool | False | Includi commenti OBJ aggiuntivi nell’output |
serialize_w | bool | False | Scrivi la componente W dei punti di controllo |
enable_materials | bool | True | Scrivi un .mtl file materiale e riferiscilo da .obj |
flip_coordinate_system | bool | False | Inverti il sistema di coordinate durante l’esportazione |
axis_system | `AxisSystem | None` | None |
GltfLoadOptions
Opzioni di caricamento per file glTF 2.0 e 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 | Inverti le coordinate V della texture all’importazione (glTF usa l’origine in alto a sinistra; True converte in basso a sinistra) |
GltfSaveOptions
Opzioni di salvataggio per l’output glTF 2.0 e GLB.
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, scrive un GLB binario autonomo; quando False, scrive JSON .gltf con un buffer esterno |
flip_tex_coord_v | bool | True | Capovolgi le coordinate V della texture durante l’esportazione |
export_textures | bool | False | Copia le texture di riferimento nel pacchetto di output (eredita da SaveOptions) |
StlLoadOptions
Carica opzioni per i file 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 | Inverti il sistema di coordinate all’importazione |
scale | float | 1.0 | Scala uniforme applicata alla geometria importata |
StlSaveOptions
Salva le opzioni per l’output 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 | Inverti il sistema di coordinate all’esportazione |
scale | float | 1.0 | Scala uniforme applicata alla geometria esportata |
binary_mode | bool | False | Scrivi STL binario invece di STL ASCII |
FbxLoadOptions
Opzioni di caricamento per file 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 | Preserva FBX GlobalSettings proprietà nelle informazioni dell’asset della scena |
compatible_mode | bool | False | Abilita la modalità di compatibilità per file FBX provenienti da strumenti di authoring più vecchi |
FbxSaveOptions
Opzioni di salvataggio per l’output 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 | Copia le texture referenziate nella directory di output |
reuse_primitive_mesh | bool | False | Elimina i duplicati della geometria mesh identica nell’output |
enable_compression | bool | True | Abilita la compressione interna binaria FBX |
fold_repeated_curve_data | ColladaSaveOptions | None | Unisci segmenti di curve di animazione identici |
export_legacy_material_properties | bool | True | Includi legacy Phong/Lambert nodi di proprietà del materiale per compatibilità |
video_for_texture | bool | False | Incorpora i dati della texture nei nodi video FBX |
embed_textures | bool | False | Incorpora i file di texture inline nel binario FBX |
generate_vertex_element_material | bool | False | Aggiungi un VertexElementMaterial livello per l’assegnazione di materiale per poligono |
ColladaLoadOptions
Opzioni di caricamento per i file 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 | Capovolgi il sistema di coordinate durante l’importazione |
enable_materials | bool | True | Importa le definizioni dei materiali COLLADA |
scale | float | 1.0 | Scala uniforme applicata alla geometria importata |
normalize_normal | bool | True | Normalizza i vettori normali importati |
ColladaSaveOptions
Opzioni di salvataggio per l’output 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 | Capovolgi il sistema di coordinate durante l’esportazione |
enable_materials | bool | True | Scrivi le definizioni dei materiali COLLADA |
indented | bool | True | Formattazione leggibile dell’output XML con rientro |
ThreeMfLoadOptions / ThreeMfSaveOptions
Opzioni di caricamento e salvataggio per i file 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)Queste classi ereditano le proprietà di base da LoadOptions / SaveOptions rispettivamente. Nessuna proprietà aggiuntiva specifica del formato è documentata per l’attuale versione FOSS.
