FileFormat — Aspose.3D FOSS for Python API Reference
Properties
FileFormat đóng vai trò vừa là bộ mô tả định dạng vừa là một kho đăng ký của tất cả các định dạng tệp 3D được hỗ trợ. Mỗi định dạng được biểu diễn dưới dạng một FileFormat đối tượng có thể truy cập như một thuộc tính lớp hoặc thông qua các phương thức tĩnh của nhà máy. Bạn truyền FileFormat các đối tượng tới Scene.save() để ép buộc một định dạng cụ thể, hoặc sử dụng FileFormat.detect() để xác định định dạng của tệp không xác định.
Properties: aspose.threed
from aspose.threed import FileFormatCác Hằng Số Định Dạng Được Hỗ Trợ
Các hằng số định dạng đang được hỗ trợ tích cực (các bộ nhập và/hoặc xuất đã đăng ký) trong bản phát hành FOSS được hiển thị bên dưới. Các hằng số được liệt kê là None trong mã nguồn là các tên được dành riêng cho các định dạng chưa được triển khai.
Được Hỗ Trợ Tích Cực (bản phát hành FOSS)
| Properties | Properties | Properties |
|---|---|---|
FileFormat.WAVEFRONT_OBJ() | .obj | Phương thức tĩnh trả về một ObjFormat đối tượng |
FileFormat.GLTF2() | .gltf / .glb | glTF 2.0; phương thức tĩnh trả về một GltfFormat đối tượng |
FileFormat.FBX7400ASCII() | .fbx | FBX 7.4 ASCII; phương thức tĩnh |
FileFormat.MICROSOFT_3MF | .3mf | 3MF (set at module load) |
FileFormat.COLLADA | .dae | Properties |
FileFormat.STL_BINARY | .stl | STL binary (được đặt khi tải mô-đun) |
FileFormat.STLASCII | .stl | STL ASCII |
Properties
FBX phiên bản 6100–7700 (binary), Maya ASCII/Binary, Discreet 3DS, Universal 3D, GLTF 1.0, GLTF binary, PDF, Blender, DXF, PLY, X (binary/text), Draco, RVM, ASE, IFC, Siemens JT, AMF, VRML, HTML5, ZIP, USD/USDA/USDZ, XYZ, PCD, PCD binary.
Phương thức tĩnh
| Properties | Kiểu trả về | Properties |
|---|---|---|
FileFormat.detect(stream, file_name) | `FileFormat | None` |
FileFormat.get_format_by_extension(ext) | `FileFormat | None` |
Thuộc Tính Thể Hiện
| Properties | Properties | Properties |
|---|---|---|
extension | str | Phần mở rộng tệp chính (không có dấu chấm đầu) |
extensions | list[str] | Tất cả các phần mở rộng được hỗ trợ bởi định dạng này |
content_type | str | Chuỗi loại MIME |
can_export | bool | Có hỗ trợ xuất sang định dạng này hay không |
can_import | bool | Có hỗ trợ nhập từ định dạng này hay không |
version | str | Chuỗi phiên bản định dạng |
Các phương thức của đối tượng
| Properties | Kiểu trả về | Properties |
|---|---|---|
create_load_options() | LoadOptions | Tạo ra định dạng‑cụ thể thích hợp LoadOptions lớp con |
create_save_options() | SaveOptions | Tạo ra định dạng‑cụ thể thích hợp SaveOptions lớp con |
Properties
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__)