Load and Save Options — Aspose.3D FOSS for Python API Reference
ColladaSaveOptions
Todas as operações de importação e exportação aceitam um objeto de opções opcional derivado de LoadOptions ou SaveOptions. Passe a subclasse apropriada para Scene.open() ou Scene.save() para controlar o comportamento específico do 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 herdam de IOConfig. As propriedades a seguir estão disponíveis em cada objeto de opções.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Diretórios adicionais a serem pesquisados ao resolver referências externas |
file_name | `str | None` |
LoadOptions
Classe base para todos os objetos de opções de carregamento.
Propriedade adicional (além de IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
encoding | `str | None` |
SaveOptions
Classe base para todos os objetos de opções de salvamento.
Propriedade adicional (além de IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
export_textures | bool | ColladaSaveOptions True, texturas referenciadas pela cena são copiadas para a saída. O padrão é False |
ObjLoadOptions
Opções de carregamento para arquivos 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 | Inverter o sistema de coordenadas na importação |
enable_materials | bool | True | Carregar o arquivo acompanhante .mtl arquivo de material |
scale | float | 1.0 | Escala uniforme aplicada a toda a geometria importada |
normalize_normal | bool | True | Normalizar vetores normais importados para comprimento unitário |
ObjSaveOptions
Opções de salvamento para arquivos 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 | Aplicar o fator de escala unitária da cena às coordenadas exportadas |
point_cloud | bool | False | Exportar apenas vértices (sem faces de polígonos) |
verbose | bool | False | Incluir comentários OBJ adicionais na saída |
serialize_w | bool | False | Escrever o componente W dos pontos de controle |
enable_materials | bool | True | Escrever um .mtl arquivo de material e referenciá-lo a partir do .obj |
flip_coordinate_system | bool | False | Inverter o sistema de coordenadas na exportação |
axis_system | `AxisSystem | None` | None |
GltfLoadOptions
Carregar opções para arquivos 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 | Inverter coordenadas de textura V na importação (glTF usa origem no canto superior esquerdo; True converte para canto inferior esquerdo) |
GltfSaveOptions
Opções de salvamento para saída 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, grava um GLB binário autônomo; quando False, grava JSON .gltf com um buffer externo |
flip_tex_coord_v | bool | True | Inverter coordenadas de textura V na exportação |
export_textures | bool | False | Copiar texturas referenciadas para o pacote de saída (herdado de SaveOptions) |
StlLoadOptions
Opções de carregamento para arquivos 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 | Inverter o sistema de coordenadas na importação |
scale | float | 1.0 | Escala uniforme aplicada à geometria importada |
StlSaveOptions
Opções de salvamento para saída 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 | Inverter o sistema de coordenadas na exportação |
scale | float | 1.0 | Escala uniforme aplicada à geometria exportada |
binary_mode | bool | False | Gravar STL binário em vez de STL ASCII |
FbxLoadOptions
Carregar opções para arquivos 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 | Preservar FBX GlobalSettings propriedades nas informações de ativos da cena |
compatible_mode | bool | False | Habilitar modo de compatibilidade para arquivos FBX de ferramentas de autoria mais antigas |
FbxSaveOptions
Opções de salvamento para saída 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 | Copiar texturas referenciadas para o diretório de saída |
reuse_primitive_mesh | bool | False | Remover duplicatas de geometria de malha idêntica na saída |
enable_compression | bool | True | Habilitar compressão interna binária do FBX |
fold_repeated_curve_data | ColladaSaveOptions | None | Agrupar segmentos de curva de animação idênticos |
export_legacy_material_properties | bool | True | Incluir legado Phong/Lambert nós de propriedade de material para compatibilidade |
video_for_texture | bool | False | Incorporar dados de textura em nós de vídeo FBX |
embed_textures | bool | False | Incorporar arquivos de textura inline no binário FBX |
generate_vertex_element_material | bool | False | Adicionar um VertexElementMaterial camada para atribuição de material por polígono |
ColladaLoadOptions
Opções de carregamento para arquivos 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 | Inverter o sistema de coordenadas na importação |
enable_materials | bool | True | Importar definições de material COLLADA |
scale | float | 1.0 | Escala uniforme aplicada à geometria importada |
normalize_normal | bool | True | Normalizar vetores normais importados |
ColladaSaveOptions
Opções de salvamento para saída 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 | Inverter o sistema de coordenadas na exportação |
enable_materials | bool | True | Gravar definições de material COLLADA |
indented | bool | True | Formate a saída XML com recuo |
ThreeMfLoadOptions / ThreeMfSaveOptions
Opções de carregamento e gravação para arquivos 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)Essas classes herdam propriedades base de LoadOptions / SaveOptions respectivamente. Nenhuma propriedade adicional específica de formato está documentada para a versão FOSS atual.