🧭 خلاصه (Summary)

LTC In CHOP داده‌های SMPTE Timecode را که به‌صورت سیگنال صوتی رمزگذاری شده‌اند، می‌خواند.
(برای توضیحات عمومی، به مقاله‌ی Linear Timecode در ویکی‌پدیا مراجعه کنید.)

برای استفاده:

  1. ابتدا سیگنال صوتی را با Audio Device In CHOP وارد تاچ‌دیزاینر کن.

  2. سپس خروجی آن را به ورودی LTC In CHOP وصل کن تا تایم‌کد خوانده شود.

در TouchDesigner، تایم‌کد می‌تواند برای هماهنگی و سینک بین ویدیو، صوت، نور و سیستم‌های خارجی استفاده شود.

🔹 برای خروجی‌گرفتن از LTC، از LTC Out CHOP استفاده کن.


⚙️ پارامترها – صفحه LTC (Parameters – LTC Page)

پارامتر توضیح
Input Frame Rate (inputrate) نرخ فریم سیگنال LTC را مشخص می‌کند (تعداد پیام‌های کامل در هر ثانیه). معمولاً بین 24 تا 30 فریم در ثانیه است.
Discrete Channels (discrete) اگر فعال باشد، چهار کانال جداگانه برای Frame, Second, Minute, Hour به خروجی اضافه می‌شود.
Total LTC Frames (totalframes) اگر فعال باشد، یک کانال اضافه می‌کند که تعداد کل فریم‌های LTC سپری‌شده را گزارش می‌دهد (با درنظرگرفتن upsampling به FPS تایم‌لاین).
Total Seconds (totalsec) اگر فعال باشد، تعداد کل ثانیه‌های سپری‌شده را خروجی می‌دهد.
Up-sample to Timeline FPS (upsample) خروجی را به نرخ فریم پروژه (Project FPS) بازنمونه‌برداری می‌کند.
User Fields (userfields) کانال‌هایی برای فیلدهای کاربری سفارشی که ممکن است در سیگنال صوتی رمزگذاری شده باشند، فعال می‌کند.
Debug Channels (debugchans) در حالت فعال، کانال‌های اشکال‌زدایی زیر اضافه می‌شوند:
quantized → سیگنال خامِ کوانتایز‌شده (روشن/خاموش).
bits → بیت‌های رمزگشایی‌شده از سیگنال کوانتایز‌شده (هر بیت از دنباله‌های خاص لبه‌ها خوانده می‌شود).
ones_count → تعداد بیت‌های پشت‌سر‌هم ۱ را نشان می‌دهد (۱۲ عدد ۱ متوالی نشانه‌ی پایان پیام است).
decode_count → تعداد پیام‌های فریم رمزگشایی‌شده‌ی موفق را گزارش می‌دهد.

⚙️ پارامترهای مشترک – صفحه Common (Parameters – Common Page)

پارامتر توضیح
Time Slice (timeslice) فقط داده‌های بازه‌ی زمانی بین دو cook را می‌خواند.
Scope (scope) تعیین می‌کند کدام کانال‌ها تحت تأثیر باشند.
Sample Rate Match (srselect) روش همگام‌سازی نرخ نمونه‌برداری بین ورودی‌ها.
Export Method (exportmethod) روش ارسال کانال‌ها به پارامترها یا DATها.
Export Root (autoexportroot) مسیر پایه برای export.
Export Table (exporttable) DAT مخصوص نگهداری اطلاعات export.

🔌 ورودی‌ها (Operator Inputs)

ورودی توضیح
Input 0 سیگنال صوتی حامل تایم‌کد SMPTE (معمولاً از Audio Device In CHOP).

📊 Info CHOP Channels

🔹 Common CHOP Info Channels

پارامتر توضیح
start نقطه‌ی شروع در نمونه‌ها.
length تعداد نمونه‌ها.
sample_rate نرخ نمونه‌برداری (fps).
num_channels تعداد کانال‌ها.
time_slice فعال بودن Time Slice (۱ یا ۰).
export_sernum شمار دفعات به‌روزرسانی export.

🔹 Common Operator Info Channels

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