خلاصه (Summary)

نکته (NOTE)
سیستم‌عامل: این اپراتور فقط روی سیستم‌عامل Microsoft Windows پشتیبانی می‌شود.

Pangolin CHOP با نرم‌افزار Beyond از شرکت Pangolin ارتباط برقرار می‌کند. Beyond یک نرم‌افزار حرفه‌ای برای کنترل شوهای لیزری و چندرسانه‌ای است. زمانی که Beyond در حال اجرا باشد، Pangolin CHOP فریم‌های تصویری لیزر را به آن ارسال می‌کند.
این فریم‌های تصویری می‌توانند از یک POP، CHOP یا SOP ساخته شوند.
برای آشنایی کلی با لیزرها در TouchDesigner، به بخش Lasers مراجعه کنید.

Pangolin CHOP باید با تمام نسخه‌های Beyond کار کند، اما توصیه می‌شود حداقل از Beyond نسخه 5.1 استفاده شود.

لایسنس Non-Commercial نرم‌افزار TouchDesigner فقط با نسخه دمو Beyond کار می‌کند.
برای ارتباط با نسخه‌های لایسنس‌دار Beyond، نیاز به لایسنس Commercial، Educational یا Pro از TouchDesigner است.


استفاده از ورودی SOP

در صورت استفاده از SOP، نقاط ورودی بر اساس Primitive گروه‌بندی می‌شوند.
موقعیت نقاط و همچنین ویژگی‌های رنگ (Color) که می‌توانند از Vertex، Point یا Primitive گرفته شوند، برای ساخت نقاطی که به Beyond ارسال می‌شوند استفاده خواهند شد.


استفاده از ورودی CHOP

در ورودی CHOP، کانال‌ها بر اساس نامشان شناسایی می‌شوند:
x، y، z، r، g، b، id، zone

فقط کانال‌های x و y الزامی هستند.
هر سمپل به‌عنوان یک نقطه برای رسم در نظر گرفته می‌شود.

نقاط می‌توانند با استفاده از کانال id در قالب شکل‌های مختلف گروه‌بندی شوند.
اگر از کانال id استفاده نشود، همه نقاط به‌عنوان بخشی از یک شکل واحد در نظر گرفته می‌شوند.

کانال zone می‌تواند مقدار پارامتر Zone را برای هر سمپل بازنویسی کند و این امکان را بدهد که کنترل دقیق‌تری داشته باشید که هر نقطه یا سمپل به کدام Zone در Beyond ارسال شود.


استفاده از ورودی POP

مشابه SOP، نقاط ورودی بر اساس Primitive گروه‌بندی می‌شوند.
ویژگی موقعیت نقطه (P) الزامی است و ویژگی رنگ (Color) اختیاری می‌باشد.
اگر Color مشخص نشده باشد، رنگ نقطه به‌صورت پیش‌فرض سفید در نظر گرفته می‌شود.

همچنین می‌توان از ویژگی Zone در Primitive استفاده کرد تا مشخص شود هر Primitive به کدام Zone در Beyond ارسال شود.


همچنین ببینید:
Laser CHOP، Lasers


محتویات (Contents)

  1. خلاصه

  2. نحوه استفاده (Usage)

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

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

  5. کانال‌های Info CHOP
      5.1 کانال‌های اطلاعات اختصاصی Pangolin CHOP
      5.2 کانال‌های اطلاعات مشترک CHOP
      5.3 کانال‌های اطلاعات مشترک اپراتور


نحوه استفاده (Usage)

برای استفاده از Pangolin CHOP، نرم‌افزار Beyond باید باز باشد.

Pangolin CHOP یک تصویر لیزری از نقاط SOP یا سمپل‌های CHOP می‌سازد و آن را به Beyond ارسال می‌کند.
زمانی که Beyond باز باشد و Pangolin CHOP فعال (و دارای ورودی) باشد، تصویر لیزری بلافاصله در Zone مربوطه در Zone Viewer نرم‌افزار Beyond قابل مشاهده خواهد بود.

در مثال زیر، یک دایره از طریق Pangolin CHOP به Zone شماره ۱ در Beyond ارسال شده است.


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

Active (active)
در صورت غیرفعال بودن، CHOP دیگر داده‌ای به Beyond ارسال نمی‌کند.
تصویر متناظر در Beyond نیز پاک خواهد شد.

Source (source)
انتخاب اپراتور منبع.

SOP (sop)
مسیر SOP.

CHOP (chop)
مسیر CHOP.
CHOP ورودی باید دارای کانال‌های x و y برای موقعیت نقاط باشد.
علاوه بر این، کانال‌های z، r، g، b و id نیز پشتیبانی می‌شوند.
کانال id برای گروه‌بندی نقاط به‌عنوان یک شکل واحد استفاده می‌شود.
در حالت پیش‌فرض، اگر کانال id وجود نداشته باشد، هر نقطه به‌صورت جداگانه و بدون اتصال در نظر گرفته می‌شود.

POP (pop)
مسیر POP.

Zone (zone)
اندیس Zone‌ای که داده‌ها به آن در Beyond ارسال می‌شوند.

Rate Mode (ratemode)
انتخاب حالت محاسبه نرخ تصویر در Beyond.
⚠️ توجه: این نرخ، نرخ CHOP نیست.

Percent (percent)
تعیین نرخ نمونه‌برداری به‌صورت درصدی از نرخ پیش‌فرض پروژکتور.

Sample Rate (rate)
تعیین نرخ نمونه‌برداری تصویر در Beyond.

Vertex Repeat (repeat)
تعداد دفعات تکرار هر نقطه در تصویر (به‌جز نقاط Blanked).

Vector Frame (vector)
در صورت فعال بودن، تصویر به‌صورت Vector Frame به Beyond ارسال می‌شود.
در Vector Frame، پردازش‌های اضافی در Beyond انجام می‌شود، مانند اضافه شدن نقاط Blanking.

در صورت غیرفعال بودن، تصویر مستقیماً به‌صورت نقاط خام به DAC ارسال می‌شود، بدون پردازش اضافه.

Resend Image (resend)
ارسال مجدد تصویر به Beyond.

Enable Laser Output (enableout)
خروجی لیزر را در Beyond فعال می‌کند.
عملکردی مشابه فشردن دکمه «Enable Laser Output» در Beyond دارد.

Disable Laser Output (disableout)
خروجی لیزر را در Beyond غیرفعال می‌کند.
معادل فشردن دکمه «Disable Laser Output» در Beyond است.

Blackout (blackout)
دستور Blackout را به Beyond ارسال می‌کند.
معادل فشردن دکمه «Blackout» در Beyond است.


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

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

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

Sample Rate Match (srselect)
مدیریت اختلاف نرخ نمونه‌برداری بین چند CHOP ورودی.
در هنگام Resample شدن، منحنی‌ها بر اساس روش Interpolation انتخاب‌شده یا به‌صورت خطی (Linear) میان‌یابی می‌شوند.

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

Export Root (autoexportroot)
مسیر نود ریشه‌ای که تمام مسیرهای Export نسبت به آن تعریف می‌شوند.

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


کانال‌های Info CHOP

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

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

  • beyond_dll_loaded

  • beyond_dll_version

  • beyond_started

  • beyond_ready

  • beyond_version

  • beyond_projector_count

  • beyond_zone_count

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

  • start – شروع بازه CHOP بر حسب سمپل

  • length – تعداد سمپل‌ها

  • sample_rate – نرخ نمونه‌برداری (فریم بر ثانیه)

  • num_channels – تعداد کانال‌ها

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

  • export_sernum – تعداد دفعات به‌روزرسانی اتصال‌های Export

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

  • total_cooks – تعداد دفعات Cook شدن اپراتور از شروع

  • cook_time – مدت زمان آخرین Cook (میلی‌ثانیه)

  • cook_frame – شماره فریم نسبت به تایم‌لاین کامپوننت

  • cook_abs_frame – شماره فریم نسبت به زمان مطلق

  • cook_start_time – زمان شروع Cook در آن فریم

  • cook_end_time – زمان پایان Cook در آن فریم

  • cooked_this_frame – اگر در این فریم Cook شده باشد مقدار 1

  • warnings – تعداد هشدارها

  • errors – تعداد خطاها