MIDI In DAT
پرش به ناوبری | پرش به جستجو
خلاصه (Summary)
اپراتور MIDI In DAT تمامی پیامهای MIDI که از یک دستگاه MIDI مشخص به TouchDesigner وارد میشوند را ثبت میکند.
خروجی به صورت جدول است، با ستونهای: message (پیام)، type (نوع)، channel (کانال)، index (شاخص)، value (مقدار).
راهاندازی کلی ساده است: پس از تنظیم MIDI از طریق Dialogs → MIDI Device Mapper، TouchDesigner آماده دریافت MIDI از طریق Select CHOPها است که به مسیر /local/maps/map1 برای دستگاه ۱ و غیره اشاره میکنند.
ارجاعات مرتبط: MIDI Event DAT، MIDI In Map CHOP، MIDI In CHOP، MIDI Out CHOP، دستور Tscript midi()، پنجره MIDI Device Mapper.
midiinDAT_Class
فهرست مطالب (Contents)
-
Summary
-
Parameters – Connect Page
-
Parameters – Filter Page
-
Parameters – Received Messages Page
-
Parameters – Common Page
-
Info CHOP Channels
6.1. Common DAT Info Channels
6.2. Common Operator Info Channels
پارامترها – صفحه Connect (Parameters – Connect Page)
Active (active)
-
هنگام روشن بودن، رویدادهای MIDI را ثبت میکند.
Device Table (device)
-
مسیر به جدول DAT مربوط به دستگاه MIDI
Device ID (id)
-
مسیر به جدول DAT مربوط به دستگاه MIDI
14 Bit Values (value14)
-
فعال کردن ثبت رویدادهای 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، مقادیر از ۰ تا ۱۲۷ هستند
پارامترها – صفحه Received Messages (Parameters – Received Messages Page)
Callbacks DAT (callbacks)
-
این اسکریپت یک بار برای هر ردیفی که به جدول اضافه میشود اجرا میشود (یعنی هر رویداد MIDI دریافتی).
-
برای جزئیات بیشتر، به midiinDAT_Class مراجعه کنید.
Execute from (executeloc) ⊞
-
تعیین میکند اسکریپت از کجا اجرا شود
From Operator (fromop)
-
اپراتوری که تغییر وضعیت آن باعث اجرای اسکریپت DAT میشود، اگر پارامتر Execute From روی 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 In 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 – تعداد خطاهای موجود در این اپراتور در صورت وجود