Load and Save Options — Aspose.3D FOSS for Python API Reference
ColladaSaveOptions
Todas las operaciones de importación y exportación aceptan un objeto de opciones opcional derivado de LoadOptions o SaveOptions. Pase la subclase apropiada a Scene.open() o Scene.save() para controlar el comportamiento específico 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 y SaveOptions heredan de IOConfig. Las siguientes propiedades están disponibles en cada objeto de opciones.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Directorios adicionales para buscar al resolver referencias externas |
file_name | `str | None` |
LoadOptions
Identifica el canal de textura al que está vinculado un elemento UV.
Propiedad adicional (más allá IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
encoding | `str | None` |
SaveOptions
Clase base para todos los objetos de opciones de guardado.
Propiedad adicional (más allá IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
export_textures | bool | ColladaSaveOptions True, las texturas referenciadas por la escena se copian a la salida. El valor predeterminado es False |
ObjLoadOptions
Opciones de carga para archivos 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 | Invertir el sistema de coordenadas al importar |
enable_materials | bool | True | Cargar el archivo adjunto .mtl archivo de material |
scale | float | 1.0 | Escala uniforme aplicada a toda la geometría importada |
normalize_normal | bool | True | Normalizar los vectores normales importados a longitud unitaria |
ObjSaveOptions
Opciones de guardado para archivos 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 el factor de escala unitario de la escena a las coordenadas exportadas |
point_cloud | bool | False | Exportar solo vértices (sin caras de polígonos) |
verbose | bool | False | Incluir comentarios OBJ adicionales en la salida |
serialize_w | bool | False | Escribir el componente W de los puntos de control |
enable_materials | bool | True | Escribir un .mtl archivo de material y referenciarlo desde el .obj |
flip_coordinate_system | bool | False | Invertir el sistema de coordenadas al exportar |
axis_system | `AxisSystem | None` | None |
GltfLoadOptions
Opciones de carga para archivos glTF 2.0 y 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 | Invertir las coordenadas de textura V al importar (glTF usa origen en la esquina superior izquierda; True convierte a la esquina inferior izquierda) |
GltfSaveOptions
Opciones de guardado para la salida 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, escribe un GLB binario autónomo; cuando False, escribe JSON .gltf con un buffer externo |
flip_tex_coord_v | bool | True | Voltear coordenadas de textura V al exportar |
export_textures | bool | False | Copiar texturas referenciadas al paquete de salida (heredado de SaveOptions) |
StlLoadOptions
Opciones de carga para archivos 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 | Voltear el sistema de coordenadas al importar |
scale | float | 1.0 | Escala uniforme aplicada a la geometría importada |
StlSaveOptions
Opciones de guardado para la salida 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 | Voltear el sistema de coordenadas al exportar |
scale | float | 1.0 | Escala uniforme aplicada a la geometría exportada |
binary_mode | bool | False | Escribir STL binario en lugar de STL ASCII |
FbxLoadOptions
Cargar opciones para archivos 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 propiedades en la información de activos de la escena |
compatible_mode | bool | False | Habilitar modo de compatibilidad para archivos FBX de herramientas de autoría más antiguas |
FbxSaveOptions
Referencia de VertexElement, VertexElementNormal, VertexElementUV.
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 al directorio de salida |
reuse_primitive_mesh | bool | False | Desduplicar geometría de malla idéntica en la salida |
enable_compression | bool | True | Habilitar compresión interna binaria de FBX |
fold_repeated_curve_data | ColladaSaveOptions | None | Combinar segmentos idénticos de curvas de animación |
export_legacy_material_properties | bool | True | Incluir legado Phong/Lambert nodos de propiedades de material para compatibilidad |
video_for_texture | bool | False | Incrustar datos de textura en nodos de video FBX |
embed_textures | bool | False | Incrustar archivos de textura en línea en el binario FBX |
generate_vertex_element_material | bool | False | Agregar un VertexElementMaterial capa para asignación de material por polígono |
ColladaLoadOptions
Opciones de carga para archivos 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 | Invertir el sistema de coordenadas al importar |
enable_materials | bool | True | Importar definiciones de material COLLADA |
scale | float | 1.0 | Escala uniforme aplicada a la geometría importada |
normalize_normal | bool | True | Normalizar vectores normales importados |
ColladaSaveOptions
Opciones de guardado para la salida 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 | Invertir el sistema de coordenadas al exportar |
enable_materials | bool | True | Escribir definiciones de material COLLADA |
indented | bool | True | Formatear la salida XML con sangría |
ThreeMfLoadOptions / ThreeMfSaveOptions
Opciones de carga y guardado para archivos 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)Estas clases heredan propiedades base de LoadOptions / SaveOptions respectivamente. No se documentan propiedades específicas de formato adicionales para la versión actual de FOSS.