FileFormat
Methods
FileFormat serveix tant com a descriptor de format com a registre de tots els formats de fitxer 3D compatibles. Cada format es representa com a FileFormat instància accessible com a atribut de classe o mitjançant mètodes de fàbrica estàtics. Passeu FileFormat instàncies a Scene.save() per forçar un format específic, o utilitzeu FileFormat.detect() per identificar el format d’un fitxer desconegut.
Methods: aspose.threed
from aspose.threed import FileFormatConstants de format compatibles
Les constants de format que estan activament suportades (importadors i/o exportadors registrats) a la versió FOSS es mostren a continuació. Les constants enumerades com a None al codi font són noms reservats per a formats encara no implementats.
Compatibles activament (versió FOSS)
| Methods | Methods | Methods |
|---|---|---|
FileFormat.WAVEFRONT_OBJ() | .obj | Mètode estàtic que retorna una ObjFormat instància |
FileFormat.GLTF2() | .gltf / .glb | glTF 2.0; mètode estàtic que retorna una GltfFormat instància |
FileFormat.FBX7400ASCII() | .fbx | FBX 7.4 ASCII; mètode estàtic |
FileFormat.MICROSOFT_3MF | .3mf | 3MF (set at module load) |
FileFormat.COLLADA | .dae | Methods |
FileFormat.STL_BINARY | .stl | STL binari (establert en carregar el mòdul) |
FileFormat.STLASCII | .stl | STL ASCII |
Methods
FBX versions 6100–7700 (binari), Maya ASCII/Binari, Discreet 3DS, Universal 3D, GLTF 1.0, GLTF binari, PDF, Blender, DXF, PLY, X (binari/text), Draco, RVM, ASE, IFC, Siemens JT, AMF, VRML, HTML5, ZIP, USD/USDA/USDZ, XYZ, PCD, PCD binari.
Mètodes estàtics
| Methods | Tipus de retorn | Methods |
|---|---|---|
FileFormat.detect(stream, file_name) | `FileFormat | None` |
FileFormat.get_format_by_extension(ext) | `FileFormat | None` |
Propietats d’instància
| Methods | Methods | Methods |
|---|---|---|
extension | str | Extensió de fitxer principal (sense punt inicial) |
extensions | list[str] | Totes les extensions compatibles amb aquest format |
content_type | str | Cadena del tipus MIME |
can_export | bool | Si s’admet l’exportació a aquest format |
can_import | bool | Si s’admet la importació des d’aquest format |
version | str | Cadena de versió del format |
Mètodes d’instància
| Methods | Tipus de retorn | Methods |
|---|---|---|
create_load_options() | LoadOptions | Crea el format específic adequat LoadOptions subclasse |
create_save_options() | SaveOptions | Crea el format específic adequat SaveOptions subclasse |
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__)