Keyboard In DAT

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

خلاصه (Summary)

اپراتور Keyboard In DAT جدیدترین رویدادهای کیبورد را در جدول FIFO (First In / First Out) خود نگه می‌دارد.

• یک ردیف برای هر فشردن کلید (Key Down) و رها کردن کلید (Key Up) ایجاد می‌شود، شامل کلیدهای Shift، Ctrl و Alt، با تفکیک بین سمت چپ و راست.

• برای راحتی، با هر فشردن کلید، یک ستون نشان می‌دهد که آیا کلیدهای Shift، Ctrl و Alt در زمان فشردن کلید نگه داشته شده بودند یا خیر.

کلیدهای فشرده شده حتی زمانی که نشانگر موس خارج از پنجره‌های TouchDesigner باشد نیز ثبت می‌شوند، اعم از کنترل پنل‌ها، Perform Mode یا پنجره ویرایش شبکه (Network Editor).
استثنا: هنگام وارد کردن متن در پنجره ویرایشگر.

می‌توانید یک فیلتر تنظیم کنید تا فقط برخی کلیدها را مشاهده کند.
می‌توان میانبرهای سفارشی تعریف کرد و با یک callback پایتون در اسکریپت متصل مدیریت شوند.

keyboardinDAT_Class

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

1. Summary

2. Parameters – Keyboard In Page

3. Parameters – Log Page

4. Parameters – Common Page

5. Notes

6. Operator Inputs

7. Info CHOP Channels
   7.1. Common DAT Info Channels
   7.2. Common Operator Info Channels

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

Active (active)

• فعال/غیرفعال کردن افزودن پیام‌ها به لاگ.

Perform Window Only (perform)

• وقتی فعال باشد، رویدادهای کلید فقط در حالت Perform Mode شناسایی می‌شوند.

Keys (keys)

• فهرست کلیدهایی که از فیلتر عبور داده می‌شوند. فقط کاراکترها را با فاصله وارد کنید، مثلاً '1 2 g h' برای کلیدهای 1، 2، g و h.

• فقط این کلیدها به لاگ اضافه می‌شوند و رویداد ایجاد می‌کنند.

• اگر خالی باشد، فیلترینگ انجام نمی‌شود.

• فهرست کلیدهای قابل قبول: Keyboard UI

Shortcuts (shortcuts)

• فهرست میانبرهایی که باید نظارت شوند.

• برای تعریف میانبرها به بخش Notes مراجعه کنید.

Panels (panels)

• فهرست اختیاری پنل‌ها برای شناسایی رویدادها.

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

Left/Right Modifiers (lrmodifiers)

• وقتی فعال باشد، وضعیت کلیدهای Modifier چپ و راست (به Notes مراجعه شود) به جدول اضافه می‌شود.

• تغییر وضعیت این پارامتر محتوای جدول را ریست می‌کند.

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

Callbacks DAT (callbacks)

• مسیر به DAT شامل callback برای هر رویداد کیبورد دریافت شده.

Execute from (executeloc) ⊞

• تعیین محل اجرای اسکریپت.

From Operator (fromop)

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

Clamp Output (clamp)

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

Maximum Lines (maxlines)

• تعداد پیام‌ها را محدود می‌کند، پیام‌های قدیمی‌تر ابتدا حذف می‌شوند.

Clear Output (clear)

• همه خطوط به جز عنوان حذف می‌شوند.

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

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

Language (language) ⊞

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

Edit/View Extension (extension) ⊞

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

Custom Extension (customext)

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

Word Wrap (wordwrap) ⊞

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

یادداشت‌ها (Notes)

میانبرها (Shortcuts) با لیستی از کلیدهای Modifier (کلیدهای کمکی) و یک کلید Trigger تعریف می‌شوند که با نقطه از هم جدا شده‌اند.

مثال:

• کلیدهای Modifier: ctrl و shift

• کلید Trigger: a

• این میانبر زمانی فعال می‌شود که یکی از کلیدهای ctrl و shift فشار داده شده و کلید a نیز فشار داده شود.

• اگر کلید Modifier دیگری فشار داده شود، میانبر شناسایی نمی‌شود.

کلیدهای Modifier معتبر (Modifier Keys):

• lalt – کلید Alt چپ

• ralt – کلید Alt راست

• alt – هر یک از کلیدهای Alt چپ یا راست

• lctrl – کلید Ctrl چپ

• rctrl – کلید Ctrl راست

• ctrl – هر یک از کلیدهای Ctrl چپ یا راست

• lshift – کلید Shift چپ

• rshift – کلید Shift راست

• shift – هر یک از کلیدهای Shift چپ یا راست

ورودی‌های اپراتور (Operator Inputs)

Input 0: –

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

اطلاعات اضافی برای Keyboard 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 – تعداد خطاهای موجود در این اپراتور در صورت وجود