Load and Save Options — Aspose.3D FOSS for Python API Reference
ColladaSaveOptions
Toutes les opérations d’importation et d’exportation acceptent un objet d’options facultatif dérivé de LoadOptions ou SaveOptions. Passez la sous‑classe appropriée à Scene.open() ou Scene.save() pour contrôler le comportement spécifique au format.
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 et SaveOptions héritent de IOConfig. Les propriétés suivantes sont disponibles sur chaque objet d’options.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | Répertoires supplémentaires à rechercher lors de la résolution des références externes |
file_name | `str | None` |
LoadOptions
Classe de base pour tous les objets d’options de chargement.
Propriété supplémentaire (au‑delà de IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
encoding | `str | None` |
SaveOptions
Classe de base pour tous les objets d’options d’enregistrement.
Propriété supplémentaire (au‑delà de IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
export_textures | bool | ColladaSaveOptions True, les textures référencées par la scène sont copiées vers la sortie. La valeur par défaut est False |
ObjLoadOptions
Options de chargement pour les fichiers 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 | Inverser le système de coordonnées lors de l’importation |
enable_materials | bool | True | Charger le fichier accompagnant .mtl fichier de matériau |
scale | float | 1.0 | Échelle uniforme appliquée à toute la géométrie importée |
normalize_normal | bool | True | Normaliser les vecteurs normaux importés à une longueur unitaire |
ObjSaveOptions
Enregistrer les options pour les fichiers 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 | Appliquer le facteur d’échelle unitaire de la scène aux coordonnées exportées |
point_cloud | bool | False | Exporter uniquement les sommets (pas de faces polygonales) |
verbose | bool | False | Inclure des commentaires OBJ supplémentaires dans la sortie |
serialize_w | bool | False | Écrire le composant W des points de contrôle |
enable_materials | bool | True | Écrire un .mtl fichier de matériau et le référencer depuis le .obj |
flip_coordinate_system | bool | False | Inverser le système de coordonnées lors de l’exportation |
axis_system | `AxisSystem | None` | None |
GltfLoadOptions
Options de chargement pour les fichiers glTF 2.0 et 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 | Inverser les coordonnées de texture V à l’importation (glTF utilise l’origine en haut à gauche ; True convertit en bas à gauche) |
GltfSaveOptions
Enregistrer les options pour la sortie 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, écrit un GLB binaire autonome ; lorsque False, écrit du JSON .gltf avec un tampon externe |
flip_tex_coord_v | bool | True | Inverser les coordonnées de texture V lors de l’exportation |
export_textures | bool | False | Copier les textures référencées dans le paquet de sortie (hérité de SaveOptions) |
StlLoadOptions
Options de chargement pour les fichiers 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 | Inverser le système de coordonnées à l’importation |
scale | float | 1.0 | Échelle uniforme appliquée à la géométrie importée |
StlSaveOptions
Enregistrer les options pour la sortie 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 | Inverser le système de coordonnées à l’exportation |
scale | float | 1.0 | Échelle uniforme appliquée à la géométrie exportée |
binary_mode | bool | False | Écrire le STL binaire au lieu du STL ASCII |
FbxLoadOptions
Options de chargement pour les fichiers 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 | Conserver FBX GlobalSettings propriétés dans les informations d’actif de la scène |
compatible_mode | bool | False | Activer le mode de compatibilité pour les fichiers FBX provenant d’outils d’authoring plus anciens |
FbxSaveOptions
Enregistrer les options pour la sortie 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 | Copier les textures référencées dans le répertoire de sortie |
reuse_primitive_mesh | bool | False | Dédupliquer la géométrie de maillage identique dans la sortie |
enable_compression | bool | True | Activer la compression interne binaire FBX |
fold_repeated_curve_data | ColladaSaveOptions | None | Regrouper les segments de courbe d’animation identiques |
export_legacy_material_properties | bool | True | Inclure l’héritage Phong/Lambert nœuds de propriétés de matériau pour la compatibilité |
video_for_texture | bool | False | Intégrer les données de texture dans les nœuds vidéo FBX |
embed_textures | bool | False | Intégrer les fichiers de texture en ligne dans le binaire FBX |
generate_vertex_element_material | bool | False | Ajouter un VertexElementMaterial couche pour l’attribution de matériau par polygone |
ColladaLoadOptions
Options de chargement pour les fichiers 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 | Inverser le système de coordonnées lors de l’importation |
enable_materials | bool | True | Importer les définitions de matériau COLLADA |
scale | float | 1.0 | Échelle uniforme appliquée à la géométrie importée |
normalize_normal | bool | True | Normaliser les vecteurs normaux importés |
ColladaSaveOptions
Options d’enregistrement pour la sortie 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 | Inverser le système de coordonnées lors de l’exportation |
enable_materials | bool | True | Écrire les définitions de matériau COLLADA |
indented | bool | True | Formatez joliment la sortie XML avec indentation |
ThreeMfLoadOptions / ThreeMfSaveOptions
Options de chargement et d’enregistrement pour les fichiers 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)Ces classes héritent des propriétés de base de LoadOptions / SaveOptions respectivement. Aucune propriété spécifique au format supplémentaire n’est documentée pour la version FOSS actuelle.
