شروع کار

Aspose.3D FOSS برای Python

به Aspose.3D FOSS برای Python, یک کتابخانهٔ رایگان با مجوز MIT برای بارگذاری، ساخت و استخراج صحنه‌های سه‌بعدی از Python. این راهنما شما را از یک محیط تازه به یک صحنهٔ کارآمد در چند دقیقه می‌برد.

پیش‌نیازها

قبل از نصب، اطمینان حاصل کنید که محیط شما این الزامات را برآورده می‌کند:

نسخه Python

  • Python 3.7, 3.8, 3.9, 3.10, 3.11, or 3.12
  • CPython مفسر مرجع است؛ تمام شش نسخه در هر انتشار تست می‌شوند

مدیر بسته

  • pip (به‌همراه تمام نصب‌های مدرن Python)
  • هیچ ابزار ساخت، کامپایلر یا بستهٔ سیستمی دیگری مورد نیاز نیست

سیستم‌عامل

  • Windows، macOS و Linux همگی پشتیبانی می‌شوند
  • این کتابخانه کاملاً Python است: هیچ افزونهٔ بومی مخصوص پلتفرمی برای کامپایل وجود ندارد

نصب

نصب از PyPI با استفاده از pip:

pip install aspose-3d-foss

به راهنمای نصب برای تنظیم محیط مجازی، مراحل تأیید، و یک مثال کد سریع.

Aspose.3D FOSS برای Python

پس از نصب، می‌توانید بلافاصله:

  • بارگذاری فایل‌های OBJ (با پشتیبانی از مواد .mtl)، STL، glTF 2.0، GLB، COLLADA و 3MF
  • بازرسی سلسله‌مراتب صحنه: عبور از گره‌ها، خواندن مش‌ها، دسترسی به نرمال‌های راس و UVها
  • تبدیل صحنه‌ها: اعمال موقعیت‌ها، چرخش‌ها (از طریق Quaternion)، و مقیاس‌ها با استفاده از Transform
  • اعمال materials: کار با LambertMaterial و PhongMaterial روی گره‌های صحنه
  • صادرات به هر فرمت پشتیبانی‌شده با گزینه‌های ذخیره‌سازی برای هر فرمت
  • محاسبه هندسه: جستجوی جعبه‌های محدودکننده، تجمیع تبدیلات فضای جهانی با GlobalTransform
  • خواندن انیمیشن: دسترسی AnimationClip و KeyframeSequence داده‌ها از فایل‌های glTF و COLLADA بارگذاری‌شده

شروع سریع

کد زیر یک فایل صحنه را بارگذاری می‌کند، فرزندان گره ریشه را چاپ می‌کند، و صحنه را در قالب GLB دوباره ذخیره می‌نماید:

from aspose.threed import Scene

scene = Scene.from_file("input.obj")

print(f"Root node children: {len(scene.root_node.child_nodes)}")
for node in scene.root_node.child_nodes:
    entity_type = type(node.entity).__name__ if node.entity else "no entity"
    print(f"  {node.name} [{entity_type}]")

scene.save("output.glb")
print("Saved output.glb")

گام‌های بعدی

 فارسی