RenderStream In CHOP

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

خلاصه (Summary)

نکته (NOTE)
لایسنس: فقط در TouchDesigner Pro در دسترس است.

این نود، نود اصلی برای کنترل و پیکربندی اتصال با پروتکل RenderStream از شرکت Disguise است.
علاوه بر این‌که نقطه‌ی همگام‌سازی (sync-point) برای شروع رندر شدن هر فریم محسوب می‌شود، تمام کانال‌های کنترلی را نیز وارد می‌کند و همچنین یک DAT شامل اطلاعات اسکیما (Schema) دریافت می‌کند تا پارامترهای قابل کنترل داخل Disguise ساخته شوند.

معمولاً هنگام استفاده از این نود بهتر است گزینه‌ی Real-Time در بالای رابط کاربری TouchDesigner خاموش باشد، تا پیشروی فریم‌ها توسط این نود انجام شود و نه توسط سیستم پیش‌فرض زمان‌بندی TouchDesigner.

برای اطلاعات بیشتر، مقاله‌ی RenderStream را ببینید.

همچنین ببینید:
RenderStream Out TOP، RenderStream In TOP، RenderStream


فهرست مطالب (Contents)

  1. خلاصه

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

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

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


پارامترها – صفحه RenderStream In

Active (active)
کنترل می‌کند که آیا سشن RenderStream فعال باشد یا نه.

Timeout (timeout)
هنگام انتظار برای دریافت سیگنال همگام‌سازی (sync) برای شروع یک فریم، مشخص می‌کند این نود چه مدت (بر حسب میلی‌ثانیه) متوقف بماند، قبل از این‌که از انتظار صرف‌نظر کند.

Stream Index (streamindex)
مشخص می‌کند این نود با کدام ایندکس استریم همگام شود و کانال‌ها را از آن دریافت کند.

Schema DAT (schemadat)
یک DAT است که شامل یک جدول با اطلاعات اسکیما می‌باشد و برای ساخت پارامترهای قابل سکوئنس شدن (sequencable) در Disguise استفاده می‌شود.

Schema DAT از ستون‌های زیر پشتیبانی می‌کند:
group، label، name، type، default، min، max، step

ستون‌های group، label، name و type الزامی هستند.

مقدار ستون type باید یکی از موارد زیر باشد:

  • float

  • image

  • text

داده‌های Float از طریق کانال‌های اصلی این نود وارد می‌شوند.
داده‌های Image را می‌توان با استفاده از RenderStream In TOP دریافت کرد.
داده‌های Text را می‌توان از طریق یک Info DAT که به این نود اشاره می‌کند به دست آورد.


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

Time Slice (timeslice)
با فعال کردن این گزینه، کانال‌ها به حالت Time Sliced در می‌آیند.
Time Slice یعنی بازه‌ی زمانی بین آخرین فریم cook شده و فریم فعلی.

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

Sample Rate Match (srselect)
مدیریت حالتی که چند CHOP ورودی نرخ نمونه‌برداری متفاوتی دارند.
وقتی Resampling انجام شود، منحنی‌ها طبق Interpolation Method یا در صورت نبود آن، به‌صورت Linear درون‌یابی می‌شوند.

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

Export Root (autoexportroot)
این مسیر به نود ریشه‌ای اشاره می‌کند که تمام مسیرهایی که با روش «Export بر اساس نام کانال» انجام می‌شوند، نسبت به آن تعریف می‌گردند.

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

Rename From (commonrenamefrom)
الگوی نام کانال‌هایی که باید تغییر نام داده شوند.
به Pattern Matching مراجعه کنید.

Rename To (commonrenameto)
الگوی جایگزین برای نام‌ها.
پارامترهای پیش‌فرض تغییری در نام کانال‌ها ایجاد نمی‌کنند.
به Pattern Replacement مراجعه کنید.

مثال:

نام کانال‌ها:
c[1-10:2] ambient

Rename From:
c* ambient

Rename To:
b[1-5] amb

در این مثال، کانال‌های c1، c3، c5، c7، c9 و ambient انتخاب می‌شوند
و سپس به b1، b2، b3، b4، b5 و amb تغییر نام می‌دهند.

برای توضیح بیشتر درباره الگوهای تغییر نام، Rename CHOP را ببینید.


کانال‌های Info CHOP

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

کانال‌های اطلاعاتی اختصاصی RenderStream CHOP

num_streams
تعداد استریم‌های RenderStream که برای انتخاب در دسترس هستند.

last_sync_wait
مدت زمانی (بر حسب میلی‌ثانیه) که این نود برای دریافت سیگنال sync از RenderStream منتظر مانده است.

num_timeouts
تعداد دفعاتی که نود تا پایان زمان Timeout منتظر مانده ولی هیچ سیگنال sync‌ای از RenderStream دریافت نکرده است.


کانال‌های اطلاعاتی عمومی 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
تعداد خطاهای موجود در این اپراتور (در صورت وجود).