Load and Save Options

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.

EnumerationsEnumerationsEnumerations
file_format`FileFormatNone`
encoding`strNone`
file_system`FileSystemNone`
lookup_pathslist[str]Directoris addicionals a cercar en resoldre referències externes
file_name`strNone`

LoadOptions

Classe base per a tots els objectes d’opcions de càrrega.

Propietat addicional (més enllà IOConfig):

EnumerationsEnumerationsEnumerations
encoding`strNone`

SaveOptions

Classe base per a tots els objectes d’opcions de desament.

Propietat addicional (més enllà IOConfig):

EnumerationsEnumerationsEnumerations
export_texturesboolEnumerations 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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseInverteix el sistema de coordenades en importar
enable_materialsboolTrueCarrega el fitxer adjunt .mtl fitxer de material
scalefloat1.0Escala uniforme aplicada a tota la geometria importada
normalize_normalboolTrueNormalitza 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)
EnumerationsEnumerationsEnumerationsEnumerations
apply_unit_scaleboolFalseAplica el factor d’escala d’unitat de l’escena a les coordenades exportades
point_cloudboolFalseExporta només vèrtexs (sense cares de polígon)
verboseboolFalseInclou comentaris addicionals d’OBJ a la sortida
serialize_wboolFalseEscriu el component W dels punts de control
enable_materialsboolTrueEscriu un .mtl fitxer de material i referència’l des del .obj
flip_coordinate_systemboolFalseInverteix el sistema de coordenades en exportar
axis_system`AxisSystemNone`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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_tex_coord_vboolTrueInverteix 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)
EnumerationsEnumerationsEnumerationsEnumerations
binary_modeboolFalseEnumerations True, escriu un GLB binari autònom; quan False, escriu JSON .gltf amb una memòria intermèdia externa
flip_tex_coord_vboolTrueInverteix les coordenades de textura V en exportar
export_texturesboolFalseCopia 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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseInverteix el sistema de coordenades en importar
scalefloat1.0Escala 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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseInverteix el sistema de coordenades en exportar
scalefloat1.0Escala uniforme aplicada a la geometria exportada
binary_modeboolFalseEscriu 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)
EnumerationsEnumerationsEnumerationsEnumerations
keep_builtin_global_settingsboolFalseConserva FBX GlobalSettings propietats a la informació d’actiu de l’escena
compatible_modeboolFalseActiva 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)
EnumerationsEnumerationsEnumerationsEnumerations
export_texturesboolFalseCopia les textures referenciades al directori de sortida
reuse_primitive_meshboolFalseDesduplica la geometria de malla idèntica a la sortida
enable_compressionboolTrueActiva la compressió interna binària de FBX
fold_repeated_curve_dataEnumerationsNoneAgrupa segments de corba d’animació idèntics
export_legacy_material_propertiesboolTrueInclou llegat Phong/Lambert nodes de propietat de material per a compatibilitat
video_for_textureboolFalseIncrusta les dades de textura en els nodes de vídeo FBX
embed_texturesboolFalseIncrusta els fitxers de textura en línia al binari FBX
generate_vertex_element_materialboolFalseAfegeix 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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseInverteix el sistema de coordenades en la importació
enable_materialsboolTrueImporta les definicions de material COLLADA
scalefloat1.0Escala uniforme aplicada a la geometria importada
normalize_normalboolTrueNormalitza 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)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseInverteix el sistema de coordenades en l’exportació
enable_materialsboolTrueEscriu les definicions de material COLLADA
indentedboolTrueFormateja 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.


Vegeu també

 Català