خلاصه

عملگرهای DAT (یا DATs) برای نگهداری داده‌های متنی مانند رشته‌ها، اسکریپت‌ها و XML استفاده می‌شوند.
DATها می‌توانند شامل چندین خط متن مانند یک اسکریپت باشند، یا یک جدول شامل سطرها و ستون‌هایی از سلول‌ها، که هر کدام یک رشته متنی دارند.
شما می‌توانید محتوای یک DAT را مستقیماً در DAT Viewer ویرایش کنید.

  • دسترسی به یک DAT حاوی متن معمولی:

    op('text1').text

  • دسترسی به یک سلول در DAT جدول:

    op('table1')[1,2]
    op('table1')['rowname', 'colname']

⚠️ نکته مهم:
op('table1')[1,2] یک شیء سلول پایتون است که معمولاً خودش به رشته داخل سلول تبدیل می‌شود. برای اطمینان بیشتر از .val استفاده کنید:

op('table1')[1,2].val

شانزده DAT پرکاربرد (“Sweet Sixteen”)

این 16 DAT بیشتر استفاده می‌شوند، پیشنهاد می‌شود با آن‌ها آشنا شوید:

DAT کاربرد DAT مرتبط
Text جایی برای ویرایش و نگهداری هر داده متنی –
Table ویرایش جدول‌ها شامل سطر و ستون از سلول‌های متنی Convert
Merge ادغام جدول‌ها یا متن‌های مختلف در یک DAT Switch
Select انتخاب ستون‌ها یا سطرهای خاص از یک DAT Substitute
Reorder مرتب‌سازی یا تکرار سطرها و ستون‌ها Transpose
Insert افزودن یک سطر یا ستون جدید به جدول –
Evaluate ارزیابی عبارت‌ها در DATها Script
CHOP to تبدیل کانال‌های CHOP به DAT SOP to
CHOP Execute اجرای اسکریپت هنگام تغییر CHOP –
Panel Execute اجرای اسکریپت هنگام تغییر یک پنل –
DAT Execute اجرای اسکریپت هنگام تغییر یک DAT دیگر Execute
OSC In / UDP In دریافت داده از برنامه‌های دیگر (OSC/UDP) OSC Out / UDP Out
Web دریافت یک صفحه اینترنت از طریق URL XML
Render Pick انتخاب اشیاء و سطوح سه‌بعدی با ماوس Info
Multi Touch In دریافت ورودی از دستگاه‌های چندلمسی ویندوز 7+ –
MIDI In دریافت داده‌های کنترلر MIDI Serial

DATها برای اسکریپت‌نویسی

  • می‌توان DATها را به هم متصل کرد تا داده‌ها و عبارت‌ها انتخاب، مرتب یا ارزیابی شوند → ابزار قدرتمند اسکریپت‌نویسی رویه‌ای.

  • اسکریپت‌های DAT می‌توانند توسط رویدادهایی مثل کلیک ماوس یا تغییر ابزارهای پنل اجرا شوند.

  • همچنین تغییرات در CHOPها می‌توانند اجرای اسکریپت‌ها را تحریک کنند.

📌 مثال: ساخت دکمه‌ای که صدا پخش کند:

  1. ساخت Button COMP → داخل آن یک Audio Play CHOP بسازید.

  2. یک Panel Execute DAT بسازید.

  3. در کد آن تابع offToOn() را تغییر دهید:

    def offToOn(panelValue):
    op('audioplay1').par.trigger.pulse()
    return

  4. دکمه را Momentary کنید و فعالش کنید. با کلیک باید صدا پخش شود.

همچنین می‌توانید از دستور run در Text DAT یا از DAT دیگری اسکریپت‌ها را اجرا کنید.

DATها برای جدول‌ها

  • جدول‌های DAT شامل سطر و ستون‌های سلول‌های متنی هستند.

  • Table DAT برای ایجاد جدول‌های جدید استفاده می‌شود.

  • با کلیک راست روی جدول (وقتی Viewer Active روشن است) می‌توان سطر و ستون اضافه/حذف کرد.

  • عملگرهایی مثل Select, Evaluate, Merge, Switch, Sort روی جدول‌ها کار می‌کنند.

  • جدول‌ها می‌توانند به پارامترها خروجی داده شوند (DAT Export).

  • دستورات مانند tabcell برای تغییر سلول‌ها و توابع tab(), tabr(), tabc(), tabrc() برای خواندن استفاده می‌شوند.

📌 مثال جدول:

  • یک Table DAT بسازید و آن را ۳ سطر × ۲ ستون کنید.

  • در سلول‌ها نام، سن، joe/9، jane/21 وارد کنید.

  • سپس یک Text TOP بسازید و در پارامتر Text عبارت زیر را بنویسید:

    tabc("table1", $OD, "name")

  • در text1 باید joe و در text2 jane نمایش داده شود.

DATها برای داده‌های وب و XML

  • Web Client DAT داده‌های HTML یا دیگر فرمت‌ها را از اینترنت می‌گیرد.

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

DATها برای متن خام

  • می‌توانند متن خام نگهداری کنند و توسط Text TOP یا Text SOP در کامپوزیت یا سه‌بعدی استفاده شوند.

  • همچنین می‌توانند برای کامنت‌ها یا پیام‌های کمکی در شبکه‌ها کاربرد داشته باشند.

ویرایش DATها

  • محتوای DAT مستقیماً در Viewer قابل ویرایش است (با فعال کردن Viewer Active Flag).

  • یا می‌توان با راست‌کلیک و انتخاب Edit Contents in Textport آن‌ها را در Textport ویرایش کرد.

  • بسیاری از DATها که ورودی دارند قابل ویرایش مستقیم نیستند (رنگ متن محوتر است). در این حالت می‌توان با Lock Flag محتوا را موقتاً تغییر داد.

به‌طور پیش‌فرض:

  • DATهای متنی شماره خطوط نمایش می‌دهند.

  • DATهای جدولی شماره سطر/ستون نمایش می‌دهند.

  • این تنظیمات در Preferences قابل تغییر است.

ویرایش متن DAT در ویرایشگر خارجی

  • با راست‌کلیک و انتخاب Edit Contents… می‌توانید متن DAT را در ادیتور خارجی ویرایش کنید.

  • در ویندوز پیش‌فرض Notepad است.

  • برای تغییر به Notepad++، Vim، Sublime و غیره باید مسیر اجرایی آن‌ها را در Preferences (بخش DATs) وارد کنید.

استفاده از DATها

  • نگهداری داده متنی (Text و Table – جداشده با Tab).

  • استفاده برای اسکریپت‌ها، دستورات، ذخیره مقادیر و آرایه‌ها.

  • قابل ویرایش در Viewer، Textport یا هر ادیتور خارجی.

  • Import: Text DAT، Table DAT، Web DAT.

  • Export: ذخیره با راست‌کلیک.