Load and Save Options

Load and Save Options — Aspose.3D FOSS for Python API Reference

Enumerations

Alle Import- und Exportvorgänge akzeptieren ein optionales Optionsobjekt, das abgeleitet ist von LoadOptions oder SaveOptions. Übergeben Sie die passende Unterklasse an Scene.open() oder Scene.save() um formatabhängiges Verhalten zu steuern.

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 und SaveOptions erben von IOConfig. Die folgenden Eigenschaften stehen in jedem Optionsobjekt zur Verfügung.

EnumerationsEnumerationsEnumerations
file_format`FileFormatNone`
encoding`strNone`
file_system`FileSystemNone`
lookup_pathslist[str]Zusätzliche Verzeichnisse, die bei der Auflösung externer Referenzen durchsucht werden
file_name`strNone`

LoadOptions

Basisklasse für alle Ladeoptionsobjekte.

Zusätzliche Eigenschaft (über IOConfig):

EnumerationsEnumerationsEnumerations
encoding`strNone`

SaveOptions

Basisklasse für alle Speicheroptionsobjekte.

Zusätzliche Eigenschaft (über IOConfig):

EnumerationsEnumerationsEnumerations
export_texturesboolEnumerations True, von der Szene referenzierte Texturen werden in die Ausgabe kopiert. Standard ist False

ObjLoadOptions

Ladeoptionen für Wavefront-OBJ-Dateien (.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_systemboolFalseKoordinatensystem beim Import umkehren
enable_materialsboolTrueLade die begleitende .mtl Materialdatei
scalefloat1.0Einheitlicher Maßstab, der auf alle importierte Geometrie angewendet wird
normalize_normalboolTrueNormalisiere importierte Normalenvektoren auf Einheitslänge

ObjSaveOptions

Physically Based Rendering material, das von glTF 2.0 und anderen PBR‑fähigen Formaten verwendet wird.

from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)
EnumerationsEnumerationsEnumerationsEnumerations
apply_unit_scaleboolFalseWende den Einheitsskalierungsfaktor der Szene auf exportierte Koordinaten an
point_cloudboolFalseExportiere nur Scheitelpunkte (keine Polygonflächen)
verboseboolFalseFüge zusätzliche OBJ-Kommentare in die Ausgabe ein
serialize_wboolFalseSchreibe die W‑Komponente der Kontrollpunkte
enable_materialsboolTrueSchreibe ein .mtl Materialdatei und referenziere sie von der .obj
flip_coordinate_systemboolFalseSpiegle das Koordinatensystem beim Export
axis_system`AxisSystemNone`None

GltfLoadOptions

Ladeoptionen für glTF 2.0- und GLB-Dateien (.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_vboolTrueSpiegle V-Texturkoordinaten beim Import (glTF verwendet Ursprung oben links; True konvertiert zu unten‑links)

GltfSaveOptions

Speicheroptionen für glTF 2.0-Ausgabe.

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, schreibt ein eigenständiges binäres GLB; wenn False, schreibt JSON .gltf mit einem externen Puffer
flip_tex_coord_vboolTrueV-Texturkoordinaten beim Export umkehren
export_texturesboolFalseKopiere referenzierte Texturen in das Ausgabepaket (geerbt von SaveOptions)

StlLoadOptions

Ladeoptionen für STL-Dateien (.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_systemboolFalseKoordinatensystem beim Import umkehren
scalefloat1.0Einheitliche Skalierung auf importierte Geometrie angewendet

StlSaveOptions

Speicheroptionen für STL‑Ausgabe.

from aspose.threed.formats import StlSaveOptions
opts = StlSaveOptions()
opts.binary_mode = True
scene.save("output.stl", opts)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseKoordinatensystem beim Export umkehren
scalefloat1.0Einheitliche Skalierung auf exportierte Geometrie angewendet
binary_modeboolFalseBinäres STL schreiben anstelle von ASCII STL

FbxLoadOptions

Ladeoptionen für FBX-Dateien (.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_settingsboolFalseFBX beibehalten GlobalSettings Eigenschaften in den Szenen-Asset-Informationen
compatible_modeboolFalseKompatibilitätsmodus für FBX-Dateien von älteren Authoring-Tools aktivieren

FbxSaveOptions

Speicheroptionen für FBX‑Ausgabe.

from aspose.threed.formats import FbxSaveOptions
opts = FbxSaveOptions()
opts.enable_compression = False
scene.save("output.fbx", opts)
EnumerationsEnumerationsEnumerationsEnumerations
export_texturesboolFalseReferenzierte Texturen in das Ausgabeverzeichnis kopieren
reuse_primitive_meshboolFalseDuplizierte identische Mesh-Geometrie in der Ausgabe entfernen
enable_compressionboolTrueBinäre interne FBX-Kompression aktivieren
fold_repeated_curve_dataEnumerationsNoneIdentische Animationskurvensegmente zusammenfassen
export_legacy_material_propertiesboolTrueLegacy einbeziehen Phong/Lambert Materialeigenschaftsknoten für Kompatibilität
video_for_textureboolFalseTexturdaten in FBX-Video-Knoten einbetten
embed_texturesboolFalseTexturdateien inline in die FBX-Binärdatei einbetten
generate_vertex_element_materialboolFalseFüge ein VertexElementMaterial Ebene für pro-Polygon-Materialzuweisung

ColladaLoadOptions

Ladeoptionen für COLLADA-Dateien (.dae).

from aspose.threed.formats import ColladaLoadOptions
opts = ColladaLoadOptions()
opts.scale = 0.01
scene = Scene()
scene.open("model.dae", opts)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseKoordinatensystem beim Import umkehren
enable_materialsboolTrueCOLLADA-Materialdefinitionen importieren
scalefloat1.0Einheitliche Skalierung auf importierte Geometrie angewendet
normalize_normalboolTrueImportierte Normalenvektoren normalisieren

ColladaSaveOptions

Speicheroptionen für COLLADA-Ausgabe.

from aspose.threed.formats import ColladaSaveOptions
opts = ColladaSaveOptions()
opts.indented = False   # compact output
scene.save("output.dae", opts)
EnumerationsEnumerationsEnumerationsEnumerations
flip_coordinate_systemboolFalseKoordinatensystem beim Export umkehren
enable_materialsboolTrueCOLLADA-Materialdefinitionen schreiben
indentedboolTrueXML-Ausgabe mit Einrückungen formatieren

ThreeMfLoadOptions / ThreeMfSaveOptions

Lade- und Speicheroptionen für 3MF-Dateien (.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)

Diese Klassen erben Basiseigenschaften von LoadOptions / SaveOptions bzw. Keine zusätzlichen format-spezifischen Eigenschaften sind für die aktuelle FOSS-Version dokumentiert.


Siehe auch

 Deutsch