FileFormat — Aspose.3D FOSS for Python API Reference
Example
FileFormat به عنوان توصیفگر فرمت و همچنین رجیستری از تمام فرمتهای فایل 3D پشتیبانیشده عمل میکند. هر فرمت بهعنوان یک FileFormat نمونهای که بهعنوان ویژگی کلاس یا از طریق متدهای استاتیک کارخانهای قابل دسترسی است. شما پاس میدهید FileFormat نمونهها را به Scene.save() برای اعمال یک فرمت خاص، یا از FileFormat.detect() برای شناسایی فرمت یک فایل ناشناخته استفاده کنید.
Example: aspose.threed
from aspose.threed import FileFormatثابتهای فرمت پشتیبانیشده
ثابتهای فرمت که بهطور فعال در نسخهٔ متنباز (FOSS) پشتیبانی میشوند (واردکنندهها و/یا صادرکنندههای ثبتشده) در زیر نشان داده شدهاند. ثابتهایی که بهعنوان None در منبع بهعنوان نامهای رزرو شده برای فرمتهایی که هنوز پیادهسازی نشدهاند، هستند.
پشتیبانی فعال (نسخهٔ متنباز)
| Example | Example | Example |
|---|---|---|
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 | Example |
FileFormat.STL_BINARY | .stl | STL باینری (در زمان بارگذاری ماژول تنظیم میشود) |
FileFormat.STLASCII | .stl | STL ASCII |
Example
نسخههای FBX 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.
متدهای ایستا
| Example | نوع بازگشت | Example |
|---|---|---|
FileFormat.detect(stream, file_name) | `FileFormat | None` |
FileFormat.get_format_by_extension(ext) | `FileFormat | None` |
ویژگیهای نمونه
| Example | Example | Example |
|---|---|---|
extension | str | پسوند اصلی فایل (بدون نقطه پیشرو) |
extensions | list[str] | تمام پسوندهای پشتیبانیشده توسط این قالب |
content_type | str | رشتهٔ نوع MIME |
can_export | bool | آیا صادرات به این فرمت پشتیبانی میشود |
can_import | bool | آیا وارد کردن از این فرمت پشتیبانی میشود |
version | str | رشته نسخه فرمت |
متدهای نمونه
| Example | نوع بازگشت | Example |
|---|---|---|
create_load_options() | LoadOptions | ایجاد میکند فرمتخاص مناسب LoadOptions زیرکلاس |
create_save_options() | SaveOptions | ایجاد میکند فرمتخاص مناسب SaveOptions زیرکلاس |
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__)