FileFormat — Aspose.3D FOSS for Python API Reference
Example
FileFormat slúži ako opisovač formátu aj ako register všetkých podporovaných 3D súborových formátov. Každý formát je reprezentovaný ako FileFormat inštancia prístupná ako atribút triedy alebo prostredníctvom statických továrenských metód. Posielate FileFormat inštancie do Scene.save() na vynútenie konkrétneho formátu, alebo použite FileFormat.detect() na identifikáciu formátu neznámeho súboru.
Example: aspose.threed
from aspose.threed import FileFormatPodporované konštanty formátov
Konštanty formátu, ktoré sú aktívne podporované (importéri a/alebo exportéri registrovaní) vo vydaní FOSS, sú uvedené nižšie. Konštanty uvedené ako None v zdrojovom kóde sú rezervované názvy pre formáty, ktoré ešte nie sú implementované.
Aktívne podporované (FOSS vydanie)
| Example | Example | Example |
|---|---|---|
FileFormat.WAVEFRONT_OBJ() | .obj | Statická metóda vracajúca ObjFormat inštanciu |
FileFormat.GLTF2() | .gltf / .glb | glTF 2.0; statická metóda vracajúca GltfFormat inštanciu |
FileFormat.FBX7400ASCII() | .fbx | FBX 7.4 ASCII; statická metóda |
FileFormat.MICROSOFT_3MF | .3mf | 3MF (set at module load) |
FileFormat.COLLADA | .dae | Example |
FileFormat.STL_BINARY | .stl | STL binárny (nastavený pri načítaní modulu) |
FileFormat.STLASCII | .stl | STL ASCII |
Example
Verzie FBX 6100–7700 (binárne), Maya ASCII/Binárne, Discreet 3DS, Universal 3D, GLTF 1.0, GLTF binárne, PDF, Blender, DXF, PLY, X (binárne/textové), Draco, RVM, ASE, IFC, Siemens JT, AMF, VRML, HTML5, ZIP, USD/USDA/USDZ, XYZ, PCD, PCD binárne.
Statické metódy
| Example | Návratový typ | Example |
|---|---|---|
FileFormat.detect(stream, file_name) | `FileFormat | None` |
FileFormat.get_format_by_extension(ext) | `FileFormat | None` |
Vlastnosti inštancie
| Example | Example | Example |
|---|---|---|
extension | str | Primárna prípona súboru (bez úvodnej bodky) |
extensions | list[str] | Všetky prípony podporované týmto formátom |
content_type | str | Reťazec typu MIME |
can_export | bool | Či je export do tohto formátu podporovaný |
can_import | bool | Či je import z tohto formátu podporovaný |
version | str | Reťazec verzie formátu |
Inštančné metódy
| Example | Návratový typ | Example |
|---|---|---|
create_load_options() | LoadOptions | Vytvára príslušný formátovo špecifický LoadOptions podtrieda |
create_save_options() | SaveOptions | Vytvára príslušný formátovo špecifický SaveOptions podtrieda |
Example
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__)