Aspose.3D FOSS
Python
راهنمای توسعه‌دهنده
Loading Models

بارگذاری فایل‌ها با Aspose.3D

بررسی کلی

Aspose.3D امکان بارگذاری فایل‌های 3D در Python را برای استفاده در تجسم 3d پایتون، بازی 3d پایتون، و جریان‌های کاری موتور 3d پایتون فراهم می‌کند. این کتابخانه کلاس‌های اصلی مانند Scene, Node, Mesh, و Entity برای نمایش محتوای 3D در حافظه.

کلاس Scene کلاس به عنوان مخزن ریشه برای اشیاء 3D عمل می‌کند، در حالی که Node نمونه‌ها ساختار scene سلسله‌مراتبی گراف. Mesh و Geometry داده‌های شکل را تعریف کنید، و Entity-اشیاء مشتق‌شده قابلیت مشاهده و سایه را پشتیبانی می‌کنند properties. این کلاس‌ها با FileFormat برای پشتیبانی از formats مانند WAVEFRONT_OBJ, GLTF2,، و FBX7400ASCII.

ویژگی‌های کلیدی

Aspose.3D برای Python امکان بارگذاری و دستکاری دارایی‌های 3D را از طریق یک سطح API متمرکز فراهم می‌کند. توسعه‌دهندگان می‌توانند با core entities مانند Scene, Node, Mesh,، و Entity,، و می‌توان متادیتا را از طریق AssetInfo و A3DObject.

  • پشتیبانی می‌کند از بارگذاری فرمت‌های رایج 3D شامل OBJ، glTF 2.0، 3MF و FBX از طریق FileFormat متدهای ایستا برای ادغام در جریان‌های کاری بازی سه‌بعدی پایتون و تجسم سه‌بعدی پایتون.
  • دسترسی برنامه‌نویسی به سلسله‌مراتب صحنه و ویژگی‌های اشیاء را از طریق Scene, Node,، و A3DObject کلاس‌هایی برای ساخت موتورهای بازی سه‌بعدی سفارشی پایتون.
  • قابلیت‌های بازرسی متادیتا را از طریق AssetInfo برای بازیابی عنوان، نویسنده و موضوع از فایل‌های سه‌بعدی بارگذاری‌شده بدون نیاز به ابزارهای خارجی.
  • اجازه می‌دهد تا به‌صورت مستقیم هندسه مش و ویژگی‌های موجودیت را با استفاده از Mesh, Geometry,، و Entity کلاس‌ها برای پشتیبانی از موارد استفاده پیشرفته کتابخانه 3d پایتون.
  • داده‌های تبدیل سراسری را از طریق GlobalTransform برای محاسبه ترجمه، چرخش و مقیاس جهت هم‌راستایی دقیق صحنه 3d پایتون.

پیش‌نیازها

برای استفاده از Aspose.3D برای بارگذاری فایل‌های 3D در Python، اطمینان حاصل کنید که Python 3.7 یا نسخهٔ بالاتر نصب شده باشد. نصب کنید library با استفاده از بستهٔ رسمی aspose-3d-foss از طریق pip.

pip install aspose-3d-foss
import aspose.threed
print('Installation successful')
  • Python 3.7 یا بالاتر
  • بسته aspose-3d-foss نصب‌شده از طریق pip
  • آشنایی پایه‌ای با مفاهیم سه‌بعدی (صحنه‌ها، گره‌ها، مش‌ها)

نمونه‌های کد

Aspose.3D امکان بارگذاری فایل‌های 3D در Python را برای تجسم، توسعهٔ بازی و یکپارچه‌سازی موتور فراهم می‌کند. استفاده کنید Scene.from_file() برای بارگذاری پشتیبانی‌شده‌ها formats مانند OBJ،, GLTF2,، و 3MF به‌صورت مستقیم از مسیرهای فایل.

from aspose.threed import Scene

scene = Scene.from_file("model.obj")
print(f"Loaded scene with {len(scene.root_node.child_nodes)} child nodes")

نکات و بهترین شیوه‌ها

هنگام بارگذاری فایل‌های 3D با Aspose.3D در Python، اطمینان حاصل کنید که محیط شما مسیر وارد کردن صحیح را استفاده می‌کند و فایل‌ها قابل دسترسی هستند. این Scene کلاس نقطه ورودی اصلی برای بارگذاری فایل‌ها از طریق است Scene.from_file(),، و FileFormat کمک می‌کند detect یا مشخص کنید formats. توسعه‌دهندگانی که python 3d game، python 3d engine یا python 3d visualization tools می‌سازند باید یکپارچگی فایل را قبل از پردازش اعتبارسنجی کنند تا از شکست‌های زمان اجرا جلوگیری شود.

  • استفاده کنید Scene.from_file() برای بارگذاری فایل‌ها؛ این روش static factory method پشتیبانی‌شده برای باز کردن فایل‌های 3D از دیسک است.
  • سازگاری قالب فایل را با استفاده از FileFormat قبل از بارگذاری برای جلوگیری از خطاهای قالب پشتیبانی‌نشده.
  • استثناهای مربوط به ورودی/خروجی فایل و تشخیص فرمت را مدیریت کنید، به‌ویژه هنگام پردازش فایل‌های ارائه‌شده توسط کاربر.
  • برای پروژه‌های بازی سه‌بعدی پایتون یا تجسم سه‌بعدی پایتون، ترجیحاً بارگذاری را از مسیرهای محلی یا جریان‌های با فرمت‌های شناخته‌شده انجام دهید تا از ابهام جلوگیری شود.

موارد مرتبط

 فارسی