RealSense CHOP

پرش به ناوبری | پرش به جستجو

خلاصه (Summary)

منسوخ شده (DEPRECATED): قابلیت‌های رهگیری اسکلت (Skeleton Tracking) دیگر توسط Cubemos قابل صدور لایسنس نیستند.
RealSense یک دستگاه رهگیری از شرکت Intel است.
اپراتور RealSense CHOP به یک دوربین RealSense TOP ارجاع می‌دهد و داده‌های رهگیری را از آن دریافت می‌کند.
RealSense CHOP از رهگیری اسکلت از طریق Cubemos Skeleton Tracking API پشتیبانی می‌کند.
Cubemos فقط روی ویندوز قابل استفاده است. برای استفاده از رهگیری اسکلت، داشتن لایسنس Cubemos الزامی است.


راه‌اندازی رهگیری اسکلت (Skeleton Tracking Setup)

RealSense CHOP از رهگیری اسکلت از طریق Cubemos RealSense Skeleton Tracking API پشتیبانی می‌کند.
برای استفاده از API شرکت Cubemos در TouchDesigner، داشتن لایسنس ضروری است.

  • امکان خرید لایسنس کامل وجود دارد و همچنین لایسنس آزمایشی نیز در دسترس است.

  • برای تنظیم فایل لایسنس، نصب SDK آن‌ها الزامی است.

  • پس از نصب SDK، می‌توان لایسنس را با اجرای اسکریپت
    post_installation.bat
    در مسیر زیر تنظیم کرد:

    C:/Program Files/Cubemos/SkeletonTracking/scripts
  • برای رهگیری اسکلت، به یک فایل مدل با پسوند (.cubemos) نیز نیاز است.
    دو فایل مدل به‌صورت پیش‌فرض همراه با Cubemos Skeleton Tracking SDK ارائه شده‌اند و در مسیر زیر قرار دارند:

    Cubemos/SkeletonTracking/models/skeleton-tracking

نکته:
به نظر می‌رسد SDK به نام librealsense نسخه 2.50.0 برای Apple Silicon به‌روزرسانی نخواهد شد، بنابراین امکان اضافه شدن آن به این بیلدها وجود ندارد.

همچنین ببینید:
RealSense، RealSense TOP


محتویات (Contents)

  1. خلاصه
     1.1 راه‌اندازی رهگیری اسکلت

  2. پارامترها – صفحه Setup

  3. پارامترها – صفحه Common

  4. کانال‌های Info CHOP
     4.1 کانال‌های اطلاعات عمومی CHOP
     4.2 کانال‌های اطلاعات عمومی Operator


پارامترها – صفحه Setup

Active (active)
وقتی فعال باشد، به‌صورت فعال داده‌های رهگیری اسکلت را از RealSense TOP دریافت می‌کند.

RealSense TOP (top)
دوربین RealSense TOP که داده‌های اسکلت از آن گرفته می‌شود.

Skeletons (skeletons)
در صورت فعال بودن، کانال‌های مربوط به اسکلت را نمایش می‌دهد.

Max Players (maxplayers)
حداکثر تعداد افرادی که می‌توانند هم‌زمان رهگیری شوند را مشخص می‌کند.

Image Position Pixels (pos)
در صورت فعال بودن، موقعیت هر لندمارک را به‌صورت مختصات پیکسلی تصویر در قالب کانال‌های x/y نمایش می‌دهد.

Image Positions Normalized (norm)
در صورت فعال بودن، موقعیت نرمال‌شده‌ی هر لندمارک را به‌صورت کانال‌های u/v نمایش می‌دهد.

Confidence (confidence)
در صورت فعال بودن، مقدار اطمینان (Confidence) هر لندمارک را نمایش می‌دهد.
اگر مقدار کانال Confidence برابر 0 باشد، آن لندمارک رهگیری نشده است.


پارامترها – صفحه Common

Time Slice (timeslice)
فعال کردن این گزینه باعث می‌شود کانال‌ها به‌صورت «Time Sliced» پردازش شوند.
Time Slice بازه‌ی زمانی بین آخرین فریم Cook شده و فریم فعلی است.

Scope (scope)
برای تعیین اینکه کدام کانال‌ها تحت تأثیر قرار بگیرند، برخی CHOPها از رشته Scope در صفحه Common استفاده می‌کنند.

Sample Rate Match (srselect)
برای مدیریت حالتی که نرخ نمونه‌برداری (Sample Rate) چند CHOP ورودی با هم متفاوت است استفاده می‌شود.
در صورت Resampling، منحنی‌ها بر اساس روش Interpolation انتخاب‌شده، یا به‌صورت پیش‌فرض Linear، میان‌یابی می‌شوند.

Export Method (exportmethod)
مشخص می‌کند کانال CHOP چگونه به یک پارامتر متصل شود.
برای اطلاعات بیشتر به مقاله Export مراجعه کنید.

Export Root (autoexportroot)
این مسیر به نود ریشه‌ای اشاره دارد که تمام مسیرهایی که با روش «Channel Name is Path:Parameter» اکسپورت می‌شوند نسبت به آن تعریف می‌شوند.

Export Table (exporttable)
یک DAT که هنگام استفاده از روش‌های Export مبتنی بر جدول DAT برای نگهداری اطلاعات اکسپورت استفاده می‌شود.


کانال‌های Info CHOP

اطلاعات اضافی مربوط به RealSense CHOP از طریق یک Info CHOP قابل دسترسی است.

کانال‌های اطلاعات عمومی CHOP

  • start – شروع بازه CHOP بر حسب سمپل

  • length – تعداد سمپل‌ها در CHOP

  • sample_rate – نرخ نمونه‌برداری کانال‌ها بر حسب فریم بر ثانیه

  • num_channels – تعداد کانال‌ها در CHOP

  • time_slice – اگر Time Slice فعال باشد 1 و در غیر این صورت 0

  • export_sernum – تعداد دفعاتی که اتصال‌های Export به‌روزرسانی شده‌اند

کانال‌های اطلاعات عمومی Operator

  • total_cooks – تعداد دفعاتی که اپراتور از زمان شروع پردازش Cook شده است

  • cook_time – مدت زمان آخرین Cook بر حسب میلی‌ثانیه

  • cook_frame – شماره فریمی که اپراتور آخرین بار نسبت به تایم‌لاین کامپوننت Cook شده است

  • cook_abs_frame – شماره فریمی که اپراتور آخرین بار نسبت به زمان مطلق Cook شده است

  • cook_start_time – زمان شروع Cook اپراتور در آن فریم (بر حسب میلی‌ثانیه)

  • cook_end_time – زمان پایان Cook اپراتور در آن فریم (بر حسب میلی‌ثانیه)

  • cooked_this_frame – اگر اپراتور در این فریم Cook شده باشد مقدار 1

  • warnings – تعداد هشدارهای اپراتور (در صورت وجود)

  • errors – تعداد خطاهای اپراتور (در صورت وجود)