خلاصه

نکته:
مجوز: فقط در نسخه TouchDesigner Pro موجود است.

BlackTrax CHOP داده‌های رهگیری حرکت را از سیستم‌های رهگیری حرکت BlackTrax فراهم می‌کند. این سیستم رهگیری مبتنی بر بینایی و بلادرنگ توسط شرکت CAST Software توسعه داده شده و در اجراهای بزرگ‌مقیاس تخصص دارد.
بی‌کِن‌های BlackTrax (BTBeacons) به اجراکنندگان یا اجسام صلب متصل می‌شوند و سیستم BlackTrax موقعیت، چرخش، سرعت و شتاب این بی‌کِن‌ها را به‌طور دقیق رهگیری می‌کند.

این CHOP داده‌های رهگیری را از سیستم BlackTrax دریافت می‌کند. (نگاه کنید به BlackTrax).

BlackTrax CHOP همراه با سیستم BlackTrax کار می‌کند. این سیستم تا ۸۵ بی‌کِن BlackTrax را رهگیری کرده و داده‌های مربوط به موقعیت، چرخش، سرعت و شتاب آن‌ها را در قالب بسته‌های RTTrPM به TouchDesigner ارسال می‌کند. هر بی‌کِن می‌تواند تا ۳ LED متصل داشته باشد که به صورت مستقل نیز در TouchDesigner قابل رهگیری هستند.

هر بی‌کِن یک شناسه (ID) دارد که در نرم‌افزار BlackTrax مشخص می‌شود و این شناسه باید به‌درستی به کانال‌های CHOP در TouchDesigner از طریق جدول نگاشت (Mapping Table) متصل شود.
در غیر این صورت، اگر شناسه‌ها به صورت افزایشی باشند، می‌توان از گزینه “From Max Beacons” در بخش Output Format استفاده کرد.

تنظیمات سرور

  • نرم‌افزار سرور باید طوری تنظیم شود که داده‌ها را در سیستم مختصات WYSIWYG ارسال کند (که حالت پیش‌فرض است).

  • چرخش‌ها باید در قالب زاویه‌های اویلر (Euler angles) ارسال شوند، نه کواترنیون‌ها (Quaternions).

  • TouchDesigner باید از هر دو حالت اندین (endian) پشتیبانی کند، اما بهتر است مقادیر در حالت پیش‌فرض باقی بمانند.

همچنین ببینید:

  • BlackTrax

  • PosiStageNet CHOP

کلاس پایتون

blacktraxCHOP_Class

محتوای سند

  1. خلاصه
    1.1. تنظیمات سرور

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

  3. پارامترها – صفحه مشترک (Common)

  4. کانال‌های Info CHOP
    4.1. کانال‌های Info مشترک CHOP
    4.2. کانال‌های Info مشترک اپراتور

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

  • Active (active): وقتی روشن باشد، CHOP داده‌های ارسالی به پورت شبکه را دریافت می‌کند. وقتی خاموش باشد، هیچ به‌روزرسانی انجام نمی‌شود.

  • Port (port): پورتی که بسته‌ها را دریافت می‌کند.

  • Protocol (protocol – ⊞): پروتکل شبکه‌ای که استفاده می‌شود. (به مقاله Network Protocols مراجعه کنید.)

  • Network Address (netaddress): هنگام استفاده از Multicast، آدرسی است که برای دریافت بسته‌ها گوش می‌دهد.

  • Sample Rate (samplerate): نرخ نمونه‌برداری این CHOP را تعیین می‌کند.

  • Output Format (outputformat – ⊞): قالب کانال‌های CHOP را مشخص می‌کند (تعداد بی‌کِن‌ها).

    • From Mapping Table (fromtable): به ازای هر سطر در جدول نگاشت یک بی‌کِن به CHOP اضافه می‌شود.

    • From Max Beacons (frombeacons): تعداد بی‌کِن‌ها مطابق با پارامتر Max Beacons اضافه می‌شود.

  • Max Beacons (maxbeacons): تعیین می‌کند چند بی‌کِن به CHOP اضافه شود. همراه با قالب خروجی From Max Beacons استفاده می‌شود.

  • Centroid (centroid): در صورت فعال بودن، کانال‌های انتقال (translation) و چرخش بی‌کِن اضافه می‌شوند.

  • Velocity (velocity): در صورت فعال بودن، کانال‌های سرعت بی‌کِن اضافه می‌شوند.

  • Acceleration (acceleration): در صورت فعال بودن، کانال‌های شتاب بی‌کِن اضافه می‌شوند.

  • LEDs (leds): در صورت فعال بودن، کانال‌های موقعیت برای هر LED متصل به بی‌کِن اضافه می‌شوند.

  • Reset Channels (reset): هنگام فعال بودن، همه بی‌کِن‌های ذخیره‌شده پاک شده و داده‌های منقضی حذف می‌شوند.

  • Reset Pulse (resetpulse): بی‌درنگ همه بی‌کِن‌های ذخیره‌شده و داده‌های منقضی را پاک می‌کند.

  • Mapping Table (mappingtable): یک جدول DAT که شناسه‌های بی‌کِن را به کانال‌های CHOP (مانند beacon0، beacon1 و غیره) نگاشت می‌دهد.

    • سطر اول به beacon0 نگاشت می‌شود، سطر دوم به beacon1 و …

    • شناسه بی‌کِن یک عدد صحیح غیرمنفی یکتا است که در نرم‌افزار BlackTrax مشخص می‌شود.

مثال:
جدولی که ۳ بی‌کِن با شناسه‌های 10، 11 و 12 را رهگیری می‌کند:

  • 10 → beacon0

  • 11 → beacon1

  • 12 → beacon2

پارامترها – صفحه مشترک (Common)

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

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

  • Sample Rate Match (srselect – ⊞): مدیریت اختلاف نرخ نمونه‌برداری ورودی‌های مختلف:

    • Resample At First Input’s Rate (first): نرخ ورودی اول برای بقیه اعمال می‌شود.

    • Resample At Maximum Rate (max): resample به بالاترین نرخ.

    • Resample At Minimum Rate (min): resample به پایین‌ترین نرخ.

    • Error If Rates Differ (err): نرخ‌های متضاد پذیرفته نمی‌شوند.

  • Export Method (exportmethod – ⊞): مشخص می‌کند کانال CHOP چگونه به پارامتر متصل شود:

    • DAT Table by Index (datindex): ارجاع با اندیس کانال در جدول DAT.

    • DAT Table by Name (datname): ارجاع با نام کانال در جدول DAT.

    • Channel Name is Path:Parameter (autoname): نام کانال مسیر کامل مقصد را مشخص می‌کند (مثل geo1/transform1:tx).

  • Export Root (autoexportroot): مسیری که ریشه همه مسیرها برای export به آن وابسته هستند.

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

کانال‌های Info CHOP

اطلاعات اضافه برای BlackTrax CHOP از طریق Info CHOP قابل دسترسی است.

کانال‌های Info مشترک CHOP

  • start: آغاز بازه CHOP (بر حسب نمونه).

  • length: تعداد نمونه‌ها در CHOP.

  • sample_rate: نرخ نمونه‌برداری کانال‌ها (فریم بر ثانیه).

  • num_channels: تعداد کانال‌ها.

  • time_slice: اگر فعال باشد 1، در غیر این صورت 0.

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

کانال‌های Info مشترک اپراتور

  • total_cooks: تعداد دفعات cook شدن اپراتور از زمان شروع.

  • cook_time: مدت زمان آخرین cook (میلی‌ثانیه).

  • cook_frame: شماره فریم آخرین cook نسبت به timeline کامپوننت.

  • cook_abs_frame: شماره فریم آخرین cook نسبت به زمان مطلق.

  • cook_start_time: زمان شروع cook (میلی‌ثانیه).

  • cook_end_time: زمان پایان cook (میلی‌ثانیه).

  • cooked_this_frame: اگر اپراتور در این فریم cook شده باشد 1.

  • warnings: تعداد هشدارها در اپراتور (در صورت وجود).

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