FileFormat — Aspose.3D FOSS for Python API Reference
Methods
FileFormat sert à la fois de descripteur de format et de registre de tous les formats de fichiers 3D pris en charge. Chaque format est représenté comme un FileFormat instance accessible en tant qu’attribut de classe ou via des méthodes de fabrique statiques. Vous passez FileFormat des instances à Scene.save() pour forcer un format spécifique, ou utilisez FileFormat.detect() pour identifier le format d’un fichier inconnu.
Methods: aspose.threed
from aspose.threed import FileFormatConstantes de format prises en charge
Les constantes de format qui sont activement prises en charge (importateurs et/ou exportateurs enregistrés) dans la version FOSS sont affichées ci-dessous. Les constantes listées comme None dans le code source sont des noms réservés pour des formats pas encore implémentés.
Pris en charge activement (version FOSS)
| Methods | Methods | Methods |
|---|---|---|
FileFormat.WAVEFRONT_OBJ() | .obj | Méthode statique renvoyant un ObjFormat instance |
FileFormat.GLTF2() | .gltf / .glb | glTF 2.0 ; méthode statique renvoyant un GltfFormat instance |
FileFormat.FBX7400ASCII() | .fbx | FBX 7.4 ASCII; méthode statique |
FileFormat.MICROSOFT_3MF | .3mf | 3MF (set at module load) |
FileFormat.COLLADA | .dae | Methods |
FileFormat.STL_BINARY | .stl | STL binaire (défini lors du chargement du module) |
FileFormat.STLASCII | .stl | STL ASCII |
Methods
FBX versions 6100–7700 (binaire), Maya ASCII/Binaire, Discreet 3DS, Universal 3D, GLTF 1.0, GLTF binaire, PDF, Blender, DXF, PLY, X (binaire/texte), Draco, RVM, ASE, IFC, Siemens JT, AMF, VRML, HTML5, ZIP, USD/USDA/USDZ, XYZ, PCD, PCD binaire.
Méthodes statiques
| Methods | Type de retour | Methods |
|---|---|---|
FileFormat.detect(stream, file_name) | `FileFormat | None` |
FileFormat.get_format_by_extension(ext) | `FileFormat | None` |
Propriétés d’instance
| Methods | Methods | Methods |
|---|---|---|
extension | str | Extension de fichier principale (sans le point initial) |
extensions | list[str] | Toutes les extensions prises en charge par ce format |
content_type | str | Chaîne de type MIME |
can_export | bool | Indique si l’exportation vers ce format est prise en charge |
can_import | bool | Indique si l’importation depuis ce format est prise en charge |
version | str | Chaîne de version du format |
Méthodes d’instance
| Methods | Type de retour | Methods |
|---|---|---|
create_load_options() | LoadOptions | Crée le format spécifique approprié LoadOptions sous‑classe |
create_save_options() | SaveOptions | Crée le format spécifique approprié SaveOptions sous‑classe |
Methods
from aspose.threed import Scene, FileFormat
# Auto-detect and load
scene = Scene.from_file("model.obj")
# Save with explicit format (force GLB binary)
from aspose.threed.formats import GltfSaveOptions
opts = GltfSaveOptions()
opts.binary_mode = True
scene.save("output.glb", opts)
# Get format by extension
fmt = FileFormat.get_format_by_extension(".fbx")
if fmt:
print(fmt.can_import) # True
print(fmt.can_export) # True
# Create options from a format instance
fmt_obj = FileFormat.get_format_by_extension(".obj")
load_opts = fmt_obj.create_load_options() # ObjLoadOptions
save_opts = fmt_obj.create_save_options() # ObjSaveOptions
# Detect format from file stream
with open("unknown_file.bin", "rb") as f:
detected = FileFormat.detect(f, "unknown_file.bin")
if detected:
print(type(detected).__name__)