راهنمای توسعه‌دهنده

Aspose.3D FOSS برای Python یک کتابخانه منبع باز با مجوز MIT است که به توسعه‌دهندگان Python امکان بارگذاری، ساخت، تبدیل و استخراج صحنه‌های سه‌بعدی را بدون هیچ وابستگی زمان اجرا خارجی می‌دهد. چه در حال ساخت یک خط لوله دارایی، یک ابزار اعتبارسنجی، یک اسکریپت پردازش هندسه، یا یک سرویس تبدیل فرمت باشید، این کتابخانه یک API تمیز و سازگار ارائه می‌دهد که توسط مدل گراف صحنه‌ای پشتیبانی می‌شود و مفاهیم سه‌بعدی استاندارد صنعت را بازتاب می‌دهد.

این راهنمای توسعه‌دهنده تمام مواردی را که برای پیشرفت فراتر از نصب سریع و نوشتن کد پردازش سه‌بعدی با کیفیت تولیدی نیاز دارید، پوشش می‌دهد.

آنچه در این بخش پیدا خواهید کرد

ویژگی‌ها و عملکردها

این ویژگی‌ها صفحه مرجع اصلی برای کار با Aspose.3D FOSS برای Python است. شامل موارد زیر می‌شود:

  • پشتیبانی از فرمت‌ها: OBJ (با مواد .mtl)، STL (دودویی و ASCII)، glTF 2.0 / GLB، COLLADA (DAE)، 3MF، و توکنایزر FBX در حال پیشرفت، با کلاس‌های گزینه بارگذاری و ذخیره‌سازی برای هر فرمت.
  • گراف صحنه: چگونه Scene, Node, Entity, Transform, و GlobalTransform به یک سلسله‌مراتب کامل صحنه ترکیب کنید، شامل الگوهای پیمایش گره‌های فرزند.
  • Mesh API: کار با control_points, VertexElementNormal, VertexElementUV, VertexElementVertexColor, و VertexElementSmoothingGroup برای پردازش هندسی.
  • سیستم مواد: اعمال LambertMaterial و PhongMaterial به گره‌های صحنه، و خواندن ویژگی‌های مواد بارگذاری‌شده از فایل‌های .mtl.
  • ابزارهای ریاضی: استفاده از Vector2, Vector3, Vector4, FVector3, Quaternion, Matrix4, و BoundingBox برای تبدیلات، پرس‌و‌جوهای جعبه‌محاطی، و محاسبات هندسی.
  • انیمیشن: ساخت و خواندن AnimationClip, AnimationNode, KeyFrame, و KeyframeSequence داده‌ها.
  • گزینه‌های بارگذاری و ذخیره‌سازی: کلاس‌های گزینه Per-format مانند ObjLoadOptions (flip_coordinate_system, scale, enable_materials, normalize_normal) and StlSaveOptions.
  • نمونه‌های کامل استفاده: اسکریپت‌های Python انتها به انتها برای بارگذاری OBJ، خروجی به STL، تبدیل دورانی glTF، و پیمایش گراف‌های صحنه.
  • نکات، مشکلات رایج و سؤالات متداول: راهنمای عملی برای اجتناب از مشکلات رایج در استفادهٔ تولیدی.
  • خلاصهٔ مرجع API: فهرست مرجع سریع از تمام کلاس‌های کلیدی.

مفاهیم کلیدی

گراف صحنه: تمام محتوای 3D در Aspose.3D FOSS به صورت درختی از Node اشیائی که ریشهٔ آن‌ها scene.root_node. هر گره می‌تواند یک Entity (مانند یک Mesh, Camera,، یا Light) و یک Transform که آن را در سلسله‌مراتب قرار می‌دهد.

API مستقل از فرمت: شما هر فرمت پشتیبانی‌شده‌ای را از طریق Scene.open() یا Scene.from_file() و به هر فرمت پشتیبانی‌شده‌ای از طریق ذخیره می‌کنید Scene.save(). همان اشیای گراف صحنه صرف‌نظر از فرمت منبع یا مقصد استفاده می‌شوند.

بدون وابستگی: کتابخانه کاملاً Python است. هیچ افزونه بومی برای کامپایل وجود ندارد، هیچ بسته سیستمی برای نصب نیست و هیچ کتابخانه شخص ثالثی برای مدیریت وجود ندارد.

شروع کار

اگر هنوز کتابخانه را نصب نکرده‌اید، به بخش شروع کار بخش و نصب راهنما قبل از ادامهٔ خواندن.

موضوعات موجود

 فارسی