FileFormat
Methods
FileFormat служить як описом формату, так і реєстром усіх підтримуваних 3D‑файлових форматів. Кожен формат представлений як FileFormat екземпляр, доступний як атрибут класу або через статичні фабричні методи. Ви передаєте FileFormat екземпляри до Scene.save() щоб примусово задати конкретний формат, або використати FileFormat.detect() для визначення формату невідомого файлу.
Methods: aspose.threed
from aspose.threed import FileFormatПідтримувані константи форматів
Константи форматів, які активно підтримуються (зареєстровані імпортери та/або експортери) у випуску FOSS, показані нижче. Константи, зазначені як None у вихідному коді, є зарезервованими іменами для форматів, які ще не реалізовані.
Активно підтримувані (випуск FOSS)
| Methods | Methods | Methods |
|---|---|---|
FileFormat.WAVEFRONT_OBJ() | .obj | Статичний метод, що повертає ObjFormat екземпляр |
FileFormat.GLTF2() | .gltf / .glb | glTF 2.0; статичний метод, що повертає GltfFormat екземпляр |
FileFormat.FBX7400ASCII() | .fbx | FBX 7.4 ASCII; статичний метод |
FileFormat.MICROSOFT_3MF | .3mf | 3MF (set at module load) |
FileFormat.COLLADA | .dae | Methods |
FileFormat.STL_BINARY | .stl | STL binary (встановлюється під час завантаження модуля) |
FileFormat.STLASCII | .stl | STL ASCII |
Methods
FBX версії 6100–7700 (бінарний), Maya ASCII/бінарний, Discreet 3DS, Universal 3D, GLTF 1.0, GLTF бінарний, PDF, Blender, DXF, PLY, X (бінарний/текстовий), Draco, RVM, ASE, IFC, Siemens JT, AMF, VRML, HTML5, ZIP, USD/USDA/USDZ, XYZ, PCD, PCD бінарний.
Статичні методи
| Methods | Тип повернення | Methods |
|---|---|---|
FileFormat.detect(stream, file_name) | `FileFormat | None` |
FileFormat.get_format_by_extension(ext) | `FileFormat | None` |
Властивості екземпляра
| Methods | Methods | Methods |
|---|---|---|
extension | str | Основне розширення файлу (без початкової крапки) |
extensions | list[str] | Усі розширення, підтримувані цим форматом |
content_type | str | Рядок типу MIME |
can_export | bool | Чи підтримується експорт у цей формат |
can_import | bool | Чи підтримується імпорт з цього формату |
version | str | Рядок версії формату |
Методи екземпляра
| Methods | Тип повернення | Methods |
|---|---|---|
create_load_options() | LoadOptions | Створює відповідний, специфічний для формату LoadOptions підклас |
create_save_options() | SaveOptions | Створює відповідний, специфічний для формату SaveOptions підклас |
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__)