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. ویژگیهای زیر در هر شیء گزینهها موجود هستند.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
file_format | `FileFormat | None` |
encoding | `str | None` |
file_system | `FileSystem | None` |
lookup_paths | list[str] | دایرکتوریهای اضافی برای جستجو هنگام حل ارجاعات خارجی |
file_name | `str | None` |
LoadOptions
کلاس پایه برای تمام اشیاء گزینههای بارگذاری.
ویژگی اضافی (فراتر از IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
encoding | `str | None` |
SaveOptions
کلاس پایه برای تمام اشیاء گزینههای ذخیرهسازی.
ویژگی اضافی (فراتر از IOConfig):
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
export_textures | bool | ColladaSaveOptions 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)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | معکوس کردن سیستم مختصات هنگام وارد کردن |
enable_materials | bool | True | بارگذاری فایل همراه .mtl فایل متریال |
scale | float | 1.0 | مقیاس یکنواخت بر تمام هندسههای وارد شده اعمال میشود |
normalize_normal | bool | True | نرمالسازی بردارهای نرمال وارد شده به طول واحد |
ObjSaveOptions
گزینههای ذخیرهسازی برای فایلهای Wavefront OBJ.
from aspose.threed.formats import ObjSaveOptions
opts = ObjSaveOptions()
opts.enable_materials = False
scene.save("output.obj", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
apply_unit_scale | bool | False | ضریب مقیاس واحد صحنه را بر مختصات خروجی اعمال کنید |
point_cloud | bool | False | صدور فقط رئوس (بدون سطوح چندضلعی) |
verbose | bool | False | شامل نظرات اضافی OBJ در خروجی |
serialize_w | bool | False | نوشتن مؤلفه W نقاط کنترل |
enable_materials | bool | True | نوشتن یک .mtl فایل material و ارجاع به آن از .obj |
flip_coordinate_system | bool | False | معکوس کردن سیستم مختصات در زمان صدور |
axis_system | `AxisSystem | None` | 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)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_tex_coord_v | bool | True | در هنگام وارد کردن، مختصات بافت 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)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
binary_mode | bool | False | ColladaSaveOptions True,، یک GLB باینری خودکفا مینویسد؛ وقتی False,، JSON مینویسد .gltf با یک بافر خارجی |
flip_tex_coord_v | bool | True | معکوس کردن مختصات بافت V در زمان خروجی |
export_textures | bool | False | کپی کردن بافتهای ارجاعشده به بسته خروجی (ارثبری از 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)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | معکوس کردن سیستم مختصات هنگام وارد کردن |
scale | float | 1.0 | مقیاس یکنواخت بر روی هندسه وارد شده اعمال میشود |
StlSaveOptions
BooleanOperation.
from aspose.threed.formats import StlSaveOptions
opts = StlSaveOptions()
opts.binary_mode = True
scene.save("output.stl", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | معکوس کردن سیستم مختصات هنگام خروجی گرفتن |
scale | float | 1.0 | مقیاس یکنواخت بر روی هندسه خروجی اعمال میشود |
binary_mode | bool | False | نوشتن 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)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
keep_builtin_global_settings | bool | False | حفظ FBX GlobalSettings ویژگیها در اطلاعات دارایی صحنه |
compatible_mode | bool | False | حالت سازگاری را برای فایلهای FBX از ابزارهای نویسندگی قدیمی فعال کنید |
FbxSaveOptions
گزینههای ذخیرهسازی برای خروجی FBX.
from aspose.threed.formats import FbxSaveOptions
opts = FbxSaveOptions()
opts.enable_compression = False
scene.save("output.fbx", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
export_textures | bool | False | تکسچرهای ارجاعشده را به پوشه خروجی کپی کنید |
reuse_primitive_mesh | bool | False | در خروجی، هندسه مشهای یکسان را حذف تکرار کنید |
enable_compression | bool | True | فشردهسازی داخلی باینری FBX را فعال کنید |
fold_repeated_curve_data | ColladaSaveOptions | None | بخشهای منحنی انیمیشن یکسان را ترکیب کنید |
export_legacy_material_properties | bool | True | شامل سازگاری قدیمی Phong/Lambert گرههای ویژگی متریال برای سازگاری |
video_for_texture | bool | False | دادههای تکسچر را در گرههای ویدئویی FBX جاسازی کنید |
embed_textures | bool | False | جاسازی فایلهای بافت بهصورت درونخطی در باینری FBX |
generate_vertex_element_material | bool | False | یک مورد اضافه کنید VertexElementMaterial لایه برای تخصیص material بهصورت هر چندضلعی |
ColladaLoadOptions
گزینههای بارگذاری برای فایلهای COLLADA (.dae).
from aspose.threed.formats import ColladaLoadOptions
opts = ColladaLoadOptions()
opts.scale = 0.01
scene = Scene()
scene.open("model.dae", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | معکوس کردن سیستم مختصات هنگام وارد کردن |
enable_materials | bool | True | وارد کردن تعاریف materialهای COLLADA |
scale | float | 1.0 | مقیاس یکنواخت بر هندسه وارد شده اعمال میشود |
normalize_normal | bool | True | نرمالسازی بردارهای نرمال وارد شده |
ColladaSaveOptions
گزینههای ذخیرهسازی برای خروجی COLLADA.
from aspose.threed.formats import ColladaSaveOptions
opts = ColladaSaveOptions()
opts.indented = False # compact output
scene.save("output.dae", opts)| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
flip_coordinate_system | bool | False | در زمان خروجی، سیستم مختصات را معکوس کنید |
enable_materials | bool | True | تعاریف مواد COLLADA را بنویسید |
indented | bool | True | خروجی 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 به ترتیب. هیچ ویژگی خاص فرمت دیگری برای نسخه فعلی منبع باز مستند نشده است.