🧭 خلاصه (Summary)

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

Ncam CHOP داده‌های ردیابی دوربین (Camera Tracking Data) را از سیستم خارجی Ncam Reality دریافت می‌کند تا در تولیدات مجازی (Virtual Production) استفاده شود.

این داده‌ها از طریق شبکه و با استفاده از پروتکل TCP به TouchDesigner ارسال می‌شوند و شامل اطلاعات زیر هستند:

  • موقعیت (Position)

  • چرخش (Orientation / Rotation)

  • ویژگی‌های اپتیکی (Optical Properties) مانند فاصله کانونی، زوم و فوکوس

با این داده‌ها می‌توان یک دوربین مجازی (Camera COMP) را در محیط سه‌بعدی کنترل کرد تا کاملاً با حرکات دوربین واقعی همگام شود.
همچنین با استفاده از Ncam TOP می‌توان تصویر دوربین واقعی را دریافت کرد و آن را با صحنه‌ی رندرشده‌ی مجازی کامپوزیت (Composite) کرد.

برای سیستم‌های ردیابی مشابه، به Stype CHOP و FreeD CHOP نیز مراجعه کنید.


⚙️ پارامترها — صفحه Network

پارامترتوضیح
Active (active)روشن بودن این گزینه باعث دریافت داده‌ها از سیستم Ncam می‌شود. اگر خاموش باشد، اتصال و دریافت داده متوقف می‌شود.
Protocol (protocol)⊞ گزینه‌ی انتخاب پروتکل شبکه (در حال حاضر فقط TCP پشتیبانی می‌شود).
Network Address (netaddress)آدرس IP یا نام سرور Ncam که داده‌ها را ارسال می‌کند.
Network Port (port)شماره پورت شبکه‌ای که Ncam CHOP برای دریافت داده به آن متصل می‌شود.

⚙️ پارامترها — صفحه Channels

این تنظیمات مشخص می‌کنند که داده‌های دریافتی از Ncam چگونه در قالب کانال‌های CHOP نمایش داده شوند.

پارامترتوضیح
Camera View (cameraview)⊞ نحوه‌ی خروجی گرفتن از موقعیت و جهت دوربین:
Translation & Rotation (TR) – موقعیت و چرخش به‌صورت جداگانه خروجی می‌شوند.
Matrix – کل ماتریس تبدیل (Transform Matrix) خروجی می‌شود.
TR & Matrix – هر دو نوع خروجی داده می‌شوند.
Off – غیرفعال.
Camera Projection (cameraproj)⊞ نحوه‌ی خروجی گرفتن از تنظیمات پرسپکتیو (Projection) دوربین:
Field of View (FOV) – فقط زاویه دید.
Matrix – ماتریس پرسپکتیو کامل.
FOV & Matrix – هر دو را خروجی می‌دهد.
Off – خاموش.
Camera Properties (cameraprops)⊞ کنترل نحوه‌ی خروجی ویژگی‌های اپتیکی مانند Zoom و Focus:
Normalized – مقادیر در بازه‌ی ۰ تا ۱ نرمال شده‌اند.
Physical – مقادیر واقعی فیزیکی (مثلاً میلی‌متر).
Both – هر دو حالت را خروجی می‌دهد.
Off – غیرفعال.
Timecode (timecode)⊞ نحوه‌ی نمایش تایم‌کد در داده‌های Ncam:
HH:MM:SS:FF – خروجی به‌صورت ساعت، دقیقه، ثانیه و فریم.
Timecode – شمارنده‌ی یک‌پارچه.
Both – هر دو نوع خروجی.
Off – غیرفعال.

⚙️ پارامترها — صفحه 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)⊞ نحوه‌ی اتصال کانال‌ها به پارامترها برای Export:
DAT Table by Index / by Name
Channel Name is Path:Parameter
Export Root (autoexportroot)مسیر ریشه برای خروجی‌های مبتنی بر مسیر.
Export Table (exporttable)جدول DAT برای روش‌های Export مبتنی بر جدول.

📊 Info CHOP Channels

داده‌های اضافی از طریق Info CHOP در دسترس هستند.

🔹 Specific Ncam CHOP Info Channels

کانالتوضیح
tracking_packetsتعداد بسته‌های دریافتی مربوط به داده‌های ردیابی حرکتی دوربین.
optical_packetsتعداد بسته‌های مربوط به داده‌های اپتیکی (لنز، فوکوس و زوم).
distort_packetsتعداد بسته‌های مربوط به داده‌های اعوجاج لنز.
film_packetsبسته‌های مرتبط با تنظیمات فیلم و حسگر (sensor).
depth_packetsبسته‌های داده‌ی عمق (Depth).
packets_droppedتعداد بسته‌های از دست رفته.
incomplete_packetsبسته‌های ناقص دریافت‌شده.
packets_skippedبسته‌های ردشده یا نادیده‌گرفته‌شده.

🔹 Common CHOP Info Channels

کانالتوضیح
startشروع بازه داده‌ها بر اساس نمونه.
lengthطول CHOP بر حسب تعداد نمونه‌ها.
sample_rateنرخ نمونه‌برداری بر حسب فریم در ثانیه.
num_channelsتعداد کانال‌ها.
time_sliceمقدار ۱ در صورت فعال بودن Time Slice.
export_sernumشمار دفعات به‌روزرسانی ارتباط‌های Export.

🔹 Common Operator Info Channels

کانالتوضیح
total_cooksتعداد دفعاتی که اپراتور cook شده است.
cook_timeزمان آخرین cook (میلی‌ثانیه).
cook_frame / cook_abs_frameشماره فریم‌های cook نسبی و مطلق.
cook_start_time / cook_end_timeزمان شروع و پایان cook در فریم فعلی.
cooked_this_frameاگر در فریم جاری cook شده باشد → مقدار ۱.
warnings / errorsتعداد هشدارها و خطاها.

🎬 کاربرد در سیستم‌های تولید مجازی (Virtual Production)

Ncam CHOP در قلب سیستم‌های Camera Tracking برای Virtual Set و XR Stage قرار دارد.
این اپراتور، داده‌های دقیق موقعیت و لنز دوربین را از سخت‌افزار Ncam Reality دریافت می‌کند تا بتواند صحنه‌های مجازی را دقیقاً با حرکات دوربین واقعی هماهنگ کند.

کاربردهای اصلی:

  • همگام‌سازی دوربین مجازی (Camera COMP) با دوربین فیزیکی در صحنه

  • اعمال اعوجاج لنز و عمق میدان واقعی با کمک Ncam TOP

  • ثبت دقیق حرکت برای تولید زنده (Live Broadcast) یا فیلم‌برداری XR/LED Wall

  • ترکیب تصویر واقعی با دنیای سه‌بعدی به‌صورت بلادرنگ