🧭 خلاصه (Summary)
مجوز: این CHOP فقط در نسخه TouchDesigner Pro در دسترس است.
MoSys CHOP دادهها را از سیستم ردیابی دوربین MoSys دریافت میکند.
کانالهای تولیدشده توسط این CHOP میتوانند برای کنترل یک دوربین مجازی استفاده شوند یا برای اعمال اعوجاج لنز (Lens Distortion) از طریق MoSys TOP در یک سیستم تولید مجازی (Virtual Production) بهکار بروند.
(برای اطلاعات برنامهنویسی، میتوان از کلاس پایتون mosysCHOP استفاده کرد.)
⚙️ پارامترها — صفحه MoSys
| پارامتر | توضیح |
|---|---|
| Active (active) | وقتی روشن باشد، CHOP دادههای ارسالی به پورت شبکه را دریافت میکند. در حالت خاموش، هیچ بهروزرسانی انجام نمیشود و دادههای دریافتی از دست میروند. |
| Protocol (protocol) | ⊞ نوع پروتکل شبکه برای دریافت دادهها (مطابق مقاله Network Protocols): • Messaging (UDP) – دریافت پیامها از طریق UDP. • Multi-Cast Messaging (UDP) – دریافت دادهها از طریق UDP چندپخشی (Multicast). |
| Network Address (netaddress) | در حالت Multicast، آدرس IP گروهی که بستهها از آن دریافت میشوند. |
| Network Port (port) | شماره پورتی که MoSys CHOP روی آن بستهها را دریافت میکند. |
| Local Address (localaddress) | تعیین آدرس IP محلی برای دریافت داده، زمانی که سیستم چند کارت شبکه (NIC) دارد و باید یکی را مشخص کرد. |
| Camera ID (cameraid) | برای فیلتر کردن دادههای ناخواسته از چند دوربین. فقط دادههایی پذیرفته میشوند که شناسهٔ آنها با این مقدار مطابقت دارد. اگر خالی بماند، جدیدترین دادهٔ دریافتی (از هر دوربین) در هر فریم نمایش داده میشود. |
| Screen Width (screenwidth) | عرض تصویر دوربین بر حسب پیکسل. از این مقدار برای تبدیل فاصلهٔ کانونی (Focal Distance) به مقدار زاویه دید (FOV) استفاده میشود. |
⚙️ پارامترها — صفحه Common
| پارامتر | توضیح |
|---|---|
| Time Slice (timeslice) | در حالت فعال، CHOP فقط دادههای بین دو فریم cook متوالی را پردازش میکند. |
| Scope (scope) | تعیین محدودهٔ کانالهایی که تحت تأثیر قرار میگیرند. (الگوی نام) |
| Sample Rate Match (srselect) | ⊞ در صورت متفاوت بودن نرخ نمونهبرداری بین چند ورودی، یکی از روشهای زیر را انتخاب میکند: • Resample At First Input’s Rate – با نرخ ورودی اول. • Resample At Maximum Rate – با بیشترین نرخ. • Resample At Minimum Rate – با کمترین نرخ. • Error If Rates Differ – اگر نرخها متفاوت باشند، خطا بده. |
| Export Method (exportmethod) | ⊞ تعیین روش اتصال خروجیهای CHOP به پارامترها: • DAT Table by Index / by Name – از جدول DAT متصلشده استفاده میکند. • Channel Name is Path:Parameter – نام کامل مقصد در قالب مسیر/پارامتر (مثل geo1/transform1:tx). |
| Export Root (autoexportroot) | مسیر ریشهای که همهٔ خروجیها نسبت به آن تعریف میشوند. |
| Export Table (exporttable) | DAT جدول خروجیها (در روشهای Export مبتنی بر DAT). |
📊 کانالهای Info CHOP
MoSys CHOP اطلاعات اضافی را از طریق Info CHOP در اختیار قرار میدهد.
Common Operator Info Channels
| نام کانال | توضیح |
|---|---|
| total_cooks | تعداد دفعاتی که اپراتور از زمان شروع اجرا «پخت» (cook) شده است. |
| cook_time | مدت زمان آخرین cook (میلیثانیه). |
| cook_frame | شمارهٔ فریم در تایملاین کامپوننت که آخرین cook در آن انجام شده. |
| cook_abs_frame | شماره فریم مطلق در زمان کل پروژه. |
| cook_start_time / cook_end_time | زمان شروع و پایان cook در همان فریم (بر حسب میلیثانیه). |
| cooked_this_frame | اگر در این فریم cook شده باشد، مقدار ۱ دارد. |
| warnings / errors | تعداد هشدارها و خطاهای فعلی این اپراتور. |
🎬 کاربرد در تولید مجازی (Virtual Production)
MoSys CHOP یکی از اجزای کلیدی برای اتصال دوربین فیزیکی مجهز به ردیاب MoSys به صحنهی مجازی TouchDesigner است.
از دادههای آن برای موارد زیر استفاده میشود:
کنترل موقعیت و چرخش یک دوربین مجازی در محیط سهبعدی؛
محاسبه و تطبیق اعوجاج لنز (Lens Distortion) از طریق MoSys TOP؛
همگامسازی بین دنیای واقعی و مجازی در سیستمهای LED Wall یا XR Stage.