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

Aspose.3D FOSS for TypeScript یک کتابخانه منبع باز، مجوز MIT است که به توسعه دهندگان Node.js اجازه می دهد به بارگذاری، ساخت، تبدیل و صادرات صحنه های 3D با امنیت کامل نوع TypeScript. آیا شما یک خطوط دارایی، یک سرویس تبدیل فرم، یک ابزار تایید جغرافیایی، یا یک کتابخانه 3D نوشتن محتوای، این کتابخانه ارائه می دهد یک API خالص و متعادل با پشتیبانی از یک مدل صحنه گراف که نشان می دهد مفهوم های استاندارد صنعت 3D.

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

آنچه در این بخش خواهید یافت

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

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

  • پشتیبانی از فرمت‌ها: OBJ (با مواد .mtl)، glTF 2.0 / GLB باینری، STL (باینری و ASCII)، COLLADA (DAE)، 3MF، و FBX، همراه با کلاس‌های گزینهٔ بارگذاری و ذخیره‌سازی برای هر فرمت شامل ObjLoadOptions و GltfSaveOptions.
  • Scene graph: چگونه Scene, Node, Entity, Transform, و SceneObject ترکیب می‌شوند به یک سلسله‌مراتب کامل صحنه، شامل الگوهای عبور از گره‌های فرزند.
  • API هندسه و مش: کار با Mesh, Geometry, VertexElementNormal, VertexElementUV, VertexElementVertexColor, MappingMode, و ReferenceMode برای پردازش هندسه.
  • سیستم متریال: اعمال LambertMaterial, PhongMaterial, و PbrMaterial (PBR برای glTF) به گره‌های صحنه، و خواندن ویژگی‌های متریال بارگذاری‌شده از فایل‌های .mtl.
  • ابزارهای ریاضی: استفاده از Vector3, Vector4, Matrix4, Quaternion, و BoundingBox برای تبدیلات، پرس‌و‌جوهای جعبه‌محاطی، و محاسبات هندسی.
  • انیمیشن: ساخت و خواندن AnimationClip, AnimationNode, AnimationChannel, KeyFrame, KeyframeSequence, Interpolation, و Extrapolation داده‌ها.
  • پشتیبانی از جریان و بافر: بارگذاری صحنه‌های 3D از حافظه درون‌حافظه‌ای Buffer اشیاء از طریق scene.openFromBuffer() برای موارد استفاده بدون سرور و استریمینگ.
  • نمونه‌های کامل استفاده: اسکریپت‌های TypeScript انتها به انتها برای بارگذاری OBJ، خروجی GLB، تبدیل دورانی STL و پیمایش گراف‌های صحنه.
  • نکات، مشکلات رایج و سؤالات متداول: راهنمایی عملی برای جلوگیری از مشکلات رایج در استفادهٔ تولیدی.
  • خلاصهٔ مرجع API: فهرست مرجع سریع از تمام کلاس‌های کلیدی و متدهای اصلی آن‌ها.

مفاهیم کلیدی

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

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

تایپینگ قوی TypeScript: کتابخانه با تنظیمات سختگیرانهٔ کامپایلر عرضه می‌شود (noImplicitAny, strictNullChecks) و تعاریف کامل نوع. هر کلاس، متد و ویژگی گزینه به‌طور کامل تایپ شده است، که تکمیل خودکار IDE و ایمنی در زمان کامپایل را در سراسر کد پردازش 3D شما فراهم می‌کند.

یک وابستگی تنها: تنها وابستگی زمان اجرا xmldom,، که به‌صورت خودکار توسط npm نصب می‌شود. هیچ افزونهٔ بومی برای کامپایل وجود ندارد و هیچ بستهٔ سیستمی برای نصب نیست.

شروع کار

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

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

 فارسی