Load and Save Options — Aspose.3D FOSS for Python API Reference
Enumerations
Totes les operacions d’importació i exportació accepten un objecte d’opcions opcional derivat de LoadOptions o SaveOptions. Passa la subclasse apropiada a Scene.open() o Scene.save() per controlar el comportament específic del format.
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 i SaveOptions hereten de IOConfig. Les propietats següents estan disponibles en cada objecte d’opcions.
| Enumerations | Enumerations | Enumerations |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Directoris addicionals a cercar en resoldre referències externes |
file_name | `str | None` |
LoadOptions
Classe base per a tots els objectes d’opcions de càrrega.
Propietat addicional (més enllà IOConfig):
| Enumerations | Enumerations | Enumerations |
|---|---|---|
encoding | `str | None` |
SaveOptions
Classe base per a tots els objectes d’opcions de desament.
Propietat addicional (més enllà IOConfig):
| Enumerations | Enumerations | Enumerations |
|---|---|---|
export_textures | bool | Enumerations True, les textures referenciades per l’escena es copien a la sortida. Per defecte a False |
ObjLoadOptions
Opcions de càrrega per a fitxers 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 | Inverteix el sistema de coordenades en importar |
enable_materials | bool | True | Carrega el fitxer adjunt .mtl fitxer de material |
scale | float | 1.0 | Escala uniforme aplicada a tota la geometria importada |
normalize_normal | bool | True | Normalitza els vectors normals importats a una longitud unitària |
ObjSaveOptions
Referència de classes base.
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 | Aplica el factor d’escala d’unitat de l’escena a les coordenades exportades |
point_cloud | bool | False | Exporta només vèrtexs (sense cares de polígon) |
verbose | bool | False | Inclou comentaris addicionals d’OBJ a la sortida |
serialize_w | bool | False | Escriu el component W dels punts de control |
enable_materials | bool | True | Escriu un .mtl fitxer de material i referència’l des del .obj |
flip_coordinate_system | bool | False | Inverteix el sistema de coordenades en exportar |
axis_system | `AxisSystem | None` | None |
GltfLoadOptions
Opcions de càrrega per a fitxers 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)| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
flip_tex_coord_v | bool | True | Inverteix les coordenades de textura V en importar (glTF utilitza origen a dalt-esquerra; True converteix a la part inferior esquerra) |
GltfSaveOptions
Opcions de desament per a la sortida 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, escriu un GLB binari autònom; quan False, escriu JSON .gltf amb una memòria intermèdia externa |
flip_tex_coord_v | bool | True | Inverteix les coordenades de textura V en exportar |
export_textures | bool | False | Copia les textures referenciades al paquet de sortida (heretat de SaveOptions) |
StlLoadOptions
Carrega opcions per a fitxers 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 | Inverteix el sistema de coordenades en importar |
scale | float | 1.0 | Escala uniforme aplicada a la geometria importada |
StlSaveOptions
Opcions de desament per a la sortida 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 | Inverteix el sistema de coordenades en exportar |
scale | float | 1.0 | Escala uniforme aplicada a la geometria exportada |
binary_mode | bool | False | Escriu STL binari en lloc d’STL ASCII |
FbxLoadOptions
Carrega opcions per a fitxers 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 | Conserva FBX GlobalSettings propietats a la informació d’actiu de l’escena |
compatible_mode | bool | False | Activa el mode de compatibilitat per a fitxers FBX d’eines d’autoria més antigues |
FbxSaveOptions
Opcions de desament per a la sortida 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 | Copia les textures referenciades al directori de sortida |
reuse_primitive_mesh | bool | False | Desduplica la geometria de malla idèntica a la sortida |
enable_compression | bool | True | Activa la compressió interna binària de FBX |
fold_repeated_curve_data | Enumerations | None | Agrupa segments de corba d’animació idèntics |
export_legacy_material_properties | bool | True | Inclou llegat Phong/Lambert nodes de propietat de material per a compatibilitat |
video_for_texture | bool | False | Incrusta les dades de textura en els nodes de vídeo FBX |
embed_textures | bool | False | Incrusta els fitxers de textura en línia al binari FBX |
generate_vertex_element_material | bool | False | Afegeix un VertexElementMaterial capa per a l’assignació de material per polígon |
ColladaLoadOptions
Opcions de càrrega per a fitxers 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 | Inverteix el sistema de coordenades en la importació |
enable_materials | bool | True | Importa les definicions de material COLLADA |
scale | float | 1.0 | Escala uniforme aplicada a la geometria importada |
normalize_normal | bool | True | Normalitza els vectors normals importats |
ColladaSaveOptions
Opcions de desament per a la sortida 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 | Inverteix el sistema de coordenades en l’exportació |
enable_materials | bool | True | Escriu les definicions de material COLLADA |
indented | bool | True | Formateja la sortida XML amb sagnat |
ThreeMfLoadOptions / ThreeMfSaveOptions
Opcions de càrrega i desament per a fitxers 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)Aquestes classes hereten propietats base de LoadOptions / SaveOptions respectivament. No s’han documentat propietats addicionals específiques del format per a l’actual versió FOSS.