MIDI Event DAT

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

خلاصه (Summary)

اپراتور MIDI Event DAT تمامی پیام‌های MIDI که به TouchDesigner وارد یا از آن خارج می‌شوند را از طریق همه اپراتورهای MIDI In/Out ثبت می‌کند.
نکته: اگر هیچ اپراتور فعال MIDI In یا Out برای دریافت پیام‌ها تنظیم نشده باشد، هیچ پیامی ثبت نخواهد شد.

این اپراتور خروجی را در قالب جدول ارائه می‌دهد، با ستون‌های:
message (پیام)، type (نوع)، channel (کانال)، index (شاخص)، value (مقدار).

جدول از نوع FIFO (اولین وارد، اولین خارج) است و به تعداد خطوط مشخص‌شده در پارامتر محدود می‌شود.
همچنین می‌توان اسکریپت اختیاری برای هر بسته دریافتی اجرا کرد.

ارجاعات مرتبط: MIDI In DAT، MIDI In Map CHOP، MIDI In CHOP، MIDI Out CHOP، دستور Tscript midi().

midieventDAT_Class

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

1. Summary

2. Parameters – Connect Page

3. Parameters – Filter Page

4. Parameters – Received Messages Page

5. Parameters – Common Page

6. Info CHOP Channels
   6.1. Common DAT Info Channels
   6.2. Common Operator Info Channels

پارامترها – صفحه Connect (Parameters – Connect Page)

Active (active)

• هنگام روشن بودن، رویدادهای MIDI را ثبت می‌کند.

پارامترها – صفحه Filter (Parameters – Filter Page)

Skip Sense (skipsense)

• اگر فعال باشد، پیام‌های Sense ثبت نمی‌شوند.

Skip Timing (skiptiming)

• اگر فعال باشد، پیام‌های Timing ثبت نمی‌شوند.

Filter Messages (filter)

• فعال کردن این گزینه، پارامترهای فیلتر پیام‌ها را فعال می‌کند.

Message (message)

• فیلتر بر اساس محتوای پیام MIDI. مثال: “Control Change”

Channel (channel)

• فیلتر بر اساس کانال MIDI. کانال‌ها از ۱ تا ۱۶ هستند.

Index (index)

• فیلتر بر اساس شاخص پیام MIDI. شاخص‌ها از ۱ تا ۱۲۸ هستند.

Value (value)

• فیلتر بر اساس مقدار پیام MIDI. مقادیر از ۰ تا ۱۲۷ هستند.

Dir (dir)

• فیلتر بر اساس جهت پیام، “input” یا “output”.

پارامترها – صفحه Received Messages (Parameters – Received Messages Page)

Callbacks DAT (callbacks)

• این اسکریپت یک بار برای هر ردیفی که به جدول اضافه می‌شود اجرا می‌شود (یعنی هر رویداد MIDI دریافتی).

• برای جزئیات بیشتر، به midieventDAT_Class مراجعه کنید.

Execute from (executeloc) ⊞

• تعیین می‌کند اسکریپت از کجا اجرا شود.

From Operator (fromop)

• اپراتوری که تغییر وضعیت آن باعث اجرای اسکریپت DAT می‌شود، اگر پارامتر Execute روی Specified Operator تنظیم شده باشد.

• همچنین مسیر اجرای اسکریپت از همین اپراتور خواهد بود اگر Execute From روی Specified Operator باشد.

Clamp Output (clamp)

• به طور پیش‌فرض، DAT محدود به ۱۰۰ پیام است، اما با فعال کردن Clamp Output می‌توان این محدودیت را به هر عددی از جمله نامحدود تغییر داد.

Maximum Lines (maxlines)

• محدودیت تعداد پیام‌ها؛ پیام‌های قدیمی‌تر ابتدا از لیست حذف می‌شوند.

Clear Output (clear)

• حذف همه خطوط به جز سرفصل.

• برای پاک کردن از طریق اسکریپت پایتون:

Bytes Column (bytes)

• خروجی بایت‌های خام پیام را در یک ستون جداگانه نمایش می‌دهد.

پارامترها – صفحه Common (Parameters – Common Page)

Language (language) ⊞

• انتخاب زبان اسکریپت برای اجرای DAT

Edit/View Extension (extension) ⊞

• انتخاب پسوند فایلی که DAT برای ویرایشگرهای خارجی نمایش دهد

Custom Extension (customext)

• تعیین پسوند سفارشی

Word Wrap (wordwrap) ⊞

• فعال کردن شکستن خطوط (Word Wrap) برای نمایش نود

کانال‌های Info CHOP (Info CHOP Channels)

اطلاعات اضافی برای MIDI Event DAT از طریق Info CHOP قابل دسترسی است.

کانال‌های اطلاعات مشترک DAT (Common DAT Info Channels)

• num_rows – تعداد ردیف‌ها در این DAT

• num_cols – تعداد ستون‌ها در این DAT

کانال‌های اطلاعات مشترک اپراتور (Common Operator Info Channels)

• 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 شده باشد

• warnings – تعداد هشدارهای موجود در این اپراتور در صورت وجود

• errors – تعداد خطاهای موجود در این اپراتور در صورت وجود