Load and Save Options

Load and Save Options — Aspose.3D FOSS for Python API Reference

ColladaSaveOptions

تمام عملیات واردات و صادرات یک شیء گزینه‌های اختیاری می‌پذیرند که از LoadOptions یا SaveOptions. زیرکلاس مناسب را به Scene.open() یا Scene.save() برای کنترل رفتار خاص فرمت.

ColladaSaveOptions: aspose.threed.formats

from aspose.threed.formats import (
    LoadOptions, SaveOptions,
    ObjLoadOptions, ObjSaveOptions,
    GltfLoadOptions, GltfSaveOptions,
    StlLoadOptions, StlSaveOptions,
    FbxLoadOptions, FbxSaveOptions,
    ColladaLoadOptions, ColladaSaveOptions,
    ThreeMfLoadOptions, ThreeMfSaveOptions,
)

ColladaSaveOptions

ColladaSaveOptions LoadOptions و SaveOptions ارث‌بری می‌کنند از IOConfig. ویژگی‌های زیر در هر شیء گزینه‌ها موجود هستند.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
file_format`FileFormatNone`
encoding`strNone`
file_system`FileSystemNone`
lookup_pathslist[str]دایرکتوری‌های اضافی برای جستجو هنگام حل ارجاعات خارجی
file_name`strNone`

LoadOptions

کلاس پایه برای تمام اشیاء گزینه‌های بارگذاری.

ویژگی اضافی (فراتر از IOConfig):

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
encoding`strNone`

SaveOptions

کلاس پایه برای تمام اشیاء گزینه‌های ذخیره‌سازی.

ویژگی اضافی (فراتر از IOConfig):

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
export_texturesboolColladaSaveOptions True,، بافت‌های ارجاع‌شده توسط صحنه به خروجی کپی می‌شوند. به‌صورت پیش‌فرض False

ObjLoadOptions

گزینه‌های بارگذاری برای فایل‌های Wavefront OBJ (.obj).

from aspose.threed.formats import ObjLoadOptions
opts = ObjLoadOptions()
opts.flip_coordinate_system = True
opts.scale = 0.01
scene = Scene()
scene.open("model.obj", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
flip_coordinate_systemboolFalseمعکوس کردن سیستم مختصات هنگام وارد کردن
enable_materialsboolTrueبارگذاری فایل همراه .mtl فایل متریال
scalefloat1.0مقیاس یکنواخت بر تمام هندسه‌های وارد شده اعمال می‌شود
normalize_normalboolTrueنرمال‌سازی بردارهای نرمال وارد شده به طول واحد

ObjSaveOptions

گزینه‌های ذخیره‌سازی برای فایل‌های Wavefront OBJ.

from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
apply_unit_scaleboolFalseضریب مقیاس واحد صحنه را بر مختصات خروجی اعمال کنید
point_cloudboolFalseصدور فقط رئوس (بدون سطوح چندضلعی)
verboseboolFalseشامل نظرات اضافی OBJ در خروجی
serialize_wboolFalseنوشتن مؤلفه W نقاط کنترل
enable_materialsboolTrueنوشتن یک .mtl فایل material و ارجاع به آن از .obj
flip_coordinate_systemboolFalseمعکوس کردن سیستم مختصات در زمان صدور
axis_system`AxisSystemNone`None

GltfLoadOptions

گزینه‌های بارگذاری برای فایل‌های glTF 2.0 و GLB (.gltf, .glb).

from aspose.threed.formats import GltfLoadOptions
opts = GltfLoadOptions()
opts.flip_tex_coord_v = False
scene = Scene()
scene.open("model.gltf", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
flip_tex_coord_vboolTrueدر هنگام وارد کردن، مختصات بافت V را معکوس کنید (glTF از مبدأ بالا‑چپ استفاده می‌کند؛; True به پایین‑چپ تبدیل می‌شود)

GltfSaveOptions

گزینه‌های ذخیره‌سازی برای خروجی glTF 2.0.

from aspose.threed.formats import GltfSaveOptions
opts = GltfSaveOptions()
opts.binary_mode = True   # produce a .glb file
scene.save("output.glb", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
binary_modeboolFalseColladaSaveOptions True,، یک GLB باینری خودکفا می‌نویسد؛ وقتی False,، JSON می‌نویسد .gltf با یک بافر خارجی
flip_tex_coord_vboolTrueمعکوس کردن مختصات بافت V در زمان خروجی
export_texturesboolFalseکپی کردن بافت‌های ارجاع‌شده به بسته خروجی (ارث‌بری از SaveOptions)

StlLoadOptions

گزینه‌های بارگذاری برای فایل‌های STL (.stl).

from aspose.threed.formats import StlLoadOptions
opts = StlLoadOptions()
opts.scale = 0.001   # convert millimetres to metres
scene = Scene()
scene.open("part.stl", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
flip_coordinate_systemboolFalseمعکوس کردن سیستم مختصات هنگام وارد کردن
scalefloat1.0مقیاس یکنواخت بر روی هندسه وارد شده اعمال می‌شود

StlSaveOptions

BooleanOperation.

from aspose.threed.formats import StlSaveOptions
opts = StlSaveOptions()
opts.binary_mode = True
scene.save("output.stl", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
flip_coordinate_systemboolFalseمعکوس کردن سیستم مختصات هنگام خروجی گرفتن
scalefloat1.0مقیاس یکنواخت بر روی هندسه خروجی اعمال می‌شود
binary_modeboolFalseنوشتن STL باینری به جای STL متنی (ASCII)

FbxLoadOptions

گزینه‌های بارگذاری برای فایل‌های FBX (.fbx).

from aspose.threed.formats import FbxLoadOptions
opts = FbxLoadOptions()
opts.keep_builtin_global_settings = True
scene = Scene()
scene.open("animation.fbx", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
keep_builtin_global_settingsboolFalseحفظ FBX GlobalSettings ویژگی‌ها در اطلاعات دارایی صحنه
compatible_modeboolFalseحالت سازگاری را برای فایل‌های FBX از ابزارهای نویسندگی قدیمی فعال کنید

FbxSaveOptions

گزینه‌های ذخیره‌سازی برای خروجی FBX.

from aspose.threed.formats import FbxSaveOptions
opts = FbxSaveOptions()
opts.enable_compression = False
scene.save("output.fbx", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
export_texturesboolFalseتکسچرهای ارجاع‌شده را به پوشه خروجی کپی کنید
reuse_primitive_meshboolFalseدر خروجی، هندسه مش‌های یکسان را حذف تکرار کنید
enable_compressionboolTrueفشرده‌سازی داخلی باینری FBX را فعال کنید
fold_repeated_curve_dataColladaSaveOptionsNoneبخش‌های منحنی انیمیشن یکسان را ترکیب کنید
export_legacy_material_propertiesboolTrueشامل سازگاری قدیمی Phong/Lambert گره‌های ویژگی متریال برای سازگاری
video_for_textureboolFalseداده‌های تکسچر را در گره‌های ویدئویی FBX جاسازی کنید
embed_texturesboolFalseجاسازی فایل‌های بافت به‌صورت درون‌خطی در باینری FBX
generate_vertex_element_materialboolFalseیک مورد اضافه کنید VertexElementMaterial لایه برای تخصیص material به‌صورت هر چندضلعی

ColladaLoadOptions

گزینه‌های بارگذاری برای فایل‌های COLLADA (.dae).

from aspose.threed.formats import ColladaLoadOptions
opts = ColladaLoadOptions()
opts.scale = 0.01
scene = Scene()
scene.open("model.dae", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
flip_coordinate_systemboolFalseمعکوس کردن سیستم مختصات هنگام وارد کردن
enable_materialsboolTrueوارد کردن تعاریف materialهای COLLADA
scalefloat1.0مقیاس یکنواخت بر هندسه وارد شده اعمال می‌شود
normalize_normalboolTrueنرمال‌سازی بردارهای نرمال وارد شده

ColladaSaveOptions

گزینه‌های ذخیره‌سازی برای خروجی COLLADA.

from aspose.threed.formats import ColladaSaveOptions
opts = ColladaSaveOptions()
opts.indented = False   # compact output
scene.save("output.dae", opts)
ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
flip_coordinate_systemboolFalseدر زمان خروجی، سیستم مختصات را معکوس کنید
enable_materialsboolTrueتعاریف مواد COLLADA را بنویسید
indentedboolTrueخروجی XML را با تورفتگی به‌صورت زیبا قالب‌بندی کنید

ThreeMfLoadOptions / ThreeMfSaveOptions

گزینه‌های بارگذاری و ذخیره‌سازی برای فایل‌های 3MF (.3mf).

from aspose.threed.formats import ThreeMfLoadOptions, ThreeMfSaveOptions

# Load
load_opts = ThreeMfLoadOptions()
scene = Scene()
scene.open("part.3mf", load_opts)

# Save
save_opts = ThreeMfSaveOptions()
scene.save("output.3mf", save_opts)

این کلاس‌ها ویژگی‌های پایه را از LoadOptions / SaveOptions به ترتیب. هیچ ویژگی خاص فرمت دیگری برای نسخه فعلی منبع باز مستند نشده است.


همچنین ببینید

 فارسی