FileFormat
Methods
FileFormat به عنوان توصیفگر فرمت و همچنین رجیستری از تمام فرمتهای فایل 3D پشتیبانیشده عمل میکند. هر فرمت بهعنوان یک FileFormat نمونهای که بهعنوان ویژگی کلاس یا از طریق متدهای استاتیک کارخانهای قابل دسترسی است. شما پاس میدهید FileFormat نمونهها را به Scene.save() برای اعمال یک فرمت خاص، یا از FileFormat.detect() برای شناسایی فرمت یک فایل ناشناخته استفاده کنید.
Methods: aspose.threed
from aspose.threed import FileFormatثابتهای فرمت پشتیبانیشده
ثابتهای فرمت که بهطور فعال در نسخهٔ متنباز (FOSS) پشتیبانی میشوند (واردکنندهها و/یا صادرکنندههای ثبتشده) در زیر نشان داده شدهاند. ثابتهایی که بهعنوان None در منبع هستند، نامهای رزرو شده برای فرمتهایی هستند که هنوز پیادهسازی نشدهاند.
پشتیبانی فعال (نسخهٔ متنباز)
| 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 باینری (در زمان بارگذاری ماژول تنظیم میشود) |
FileFormat.STLASCII | .stl | STL ASCII |
Methods
نسخههای FBX 6100–7700 (باینری)، Maya ASCII/Binary، Discreet 3DS، Universal 3D، GLTF 1.0، GLTF binary، PDF، Blender، DXF، PLY، X (باینری/متن)، Draco، RVM، ASE، IFC، Siemens JT، AMF، VRML، HTML5، ZIP، USD/USDA/USDZ، XYZ، PCD، PCD binary.
متدهای استاتیک
| 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__)