خلاصه
Leap Motion TOP تصویر را از دوربینهای کنترلر Leap Motion دریافت میکند. برای فعالسازی این قابلیت، باید گزینه Allow Images در پنل کنترل Leap Motion روشن باشد.
برای اتصال دستگاه، لازم است نرمافزار ردیابی Ultraleap را نصب کنید. برای بهترین عملکرد، توصیه میشود از نسخههای جدید درایور Gemini استفاده کنید:
ویندوز: نسخه 5.13.2 یا بالاتر
macOS: نسخه 5.14.0 یا بالاتر
این درایورها از این لینک قابل دانلود هستند:
https://developer.leapmotion.com/tracking-software-download
نسخههای قدیمیتر V2 و V4 Orion نیز پشتیبانی میشوند. برای جزئیات بیشتر به توضیحات پارامترهای API در ادامه مراجعه کنید.
علاوه بر نصب درایورها، باید TouchDesigner را نیز تنظیم کنید تا کتابخانهٔ ردیابی را پیدا کند. نحوهٔ تنظیم در سیستمعاملهای مختلف متفاوت است:
در ویندوز
میتوانید توسط پارامتر Library Folder مسیر فایل DLL را مشخص کنید:
برای Orion/Gemini: فایل LeapC.dll
برای نسخههای 2/3: فایل Leap.dll
این فایلها همراه LeapSDK نصب میشوند و مکان آنها بسته به نسخه ممکن است متفاوت باشد.
در macOS
مقدار Library Folder باید مسیر اپلیکیشن Ultraleap Tracking باشد. مسیر پیشفرض:/Applications/Ultraleap Hand Tracking.app
TouchDesigner بهصورت خودکار کتابخانههای لازم را از داخل این برنامه پیدا میکند.
نکته
اگر از Gemini V5 استفاده میکنید، Leap Motion فقط در یک جهت کار میکند. بهطور پیشفرض، دستها از پایین تصویر وارد میشوند، اما میتوانید در تنظیمات جهت را معکوس کنید. این تفاوت مهمی با نسخههای V2 و V4 است که در هر دو جهت کار میکردند.
توجه
TouchDesigner هیچ لایسنس استفاده از سختافزار یا نرمافزار Leap Motion را ارائه نمیدهد. قبل از استفاده، قوانین و لایسنسهای لازم را از وبسایت Ultraleap بررسی کنید.
(همچنین نگاه کنید به: Leap Motion، Leap Motion CHOP)
پارامترها – صفحه LeapMotion
Active — فعال
اگر روشن باشد، این TOP دادههای تصویری دوربینها را دریافت میکند.
API — نسخه API
انتخاب بین SDKهای Leap Motion نسخه V2 یا V4/V5 برای ردیابی.
V5 سریعترین و پایدارترین نسخه است.
V2 برخی قابلیتهای قدیمی مثل ژستها را دارد.
Library Folder — پوشه کتابخانه
باید مسیر فایل DLL مربوط به نسخه انتخابی API را مشخص کند.
در V2 فایل: Leap.dll
در V4/V5 فایل: LeapC.dll
برای Gemini V5 مسیر زیر را وارد کنید:C:\Program Files\Ultraleap\LeapSDK\lib\x64
Camera — انتخاب دوربین
یکی از دو دوربین موجود در کنترلر Leap Motion را انتخاب میکند.
Flip X — معکوسسازی افقی
تصویر را در جهت X معکوس میکند.
Flip Y — معکوسسازی عمودی
تصویر را در جهت Y معکوس میکند.
Image Correction — تصحیح تصویر
اعوجاج لنز را اصلاح میکند.
HMD Mode — حالت هدست
سوییچ به حالت قرارگیری روی هدست (Head Mounted Display).
پارامترها – صفحه Common
Output Resolution — رزولوشن خروجی
تنظیم سریع رزولوشن خروجی TOP.
Resolution — رزولوشن سفارشی
فقط زمانی فعال است که حالت Custom Resolution انتخاب شده باشد.
Resolution Menu — منوی رزولوشن
چند رزولوشن رایج برای انتخاب سریع.
Use Global Res Multiplier — استفاده از ضریب جهانی رزولوشن
تمام رزولوشنهای TOP را بر اساس مقدار Global Resolution Multiplier مقیاس میدهد.
Output Aspect — نسبت تصویر خروجی
تنظیم نسبت تصویر با امکان استفاده از نسبتهای غیرمربعی.
Aspect — نسبت سفارشی
زمانی استفاده میشود که Output Aspect روی Custom Aspect باشد.
Aspect Menu — منوی نسبت تصویر
چند نسبت تصویر رایج.
Input Smoothness — نرمی ورودی
فیلترگذاری پیکسل روی تصویر ورودی.
Fill Viewer — نحوه نمایش
نحوه نمایش تصویر در ویوئر.
نکته: برای فهم بهتر عملکرد TOPها، بهتر است آن را روی Native Resolution بگذارید.
Viewer Smoothness — نرمی نمایشگر
فیلترگذاری پیکسل در ویوئر.
Passes — تعداد پاسها
عملیات TOP را به تعداد مشخص تکرار میکند.
(در GLSL Compute رفتار متفاوت است.)
Channel Mask — ماسک کانالها
انتخاب اینکه کدام کانالها (R/G/B/A) پردازش شوند.
Pixel Format — فرمت پیکسلی
فرمت ذخیرهسازی داده تصویری برای هر کانال.
Info CHOP Channels
اطلاعات اضافه Leap Motion TOP از Info CHOP قابل دریافت است.
اطلاعات عمومی TOP
resx — رزولوشن افقی
resy — رزولوشن عمودی
aspectx — نسبت افقی
aspecty — نسبت عمودی
depth — تعداد لایهها در صورت وجود بافت 2D/3D
gpu_memory_used — میزان حافظه GPU استفادهشده
اطلاعات عمومی اپراتور
total_cooks — تعداد دفعات Cook شدن
cook_time — مدت Cook آخر (میلیثانیه)
cook_frame — شماره فریم Cook
cook_abs_frame — شماره فریم مطلق
cook_start_time — زمان شروع Cook
cook_end_time — زمان پایان Cook
cooked_this_frame — آیا در این فریم Cook شده است یا نه
warnings — تعداد هشدارها
errors — تعداد خطاها