DAT

خلاصه

عملگرهای 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 استفاده کنید:

---

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

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

---

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: ذخیره با راست‌کلیک.