خلاصه:
در TouchDesigner، Button Component برای ساخت دکمه‌های تعاملی (Interactive) استفاده می‌شود.
این دکمه‌ها می‌توانند به شکل‌های مختلف باشند:
Toggle Button (روشن/خاموش شونده)
Momentary Button (لحظه‌ای، فقط هنگام فشار فعال است)
Radio Buttons (گزینه‌های گروهی که یکی فعال می‌شود)
Exclusive Buttons (مانند رادیو ولی می‌توانند همه خاموش باشند)
گروه‌بندی این دکمه‌ها می‌تواند با Button Group Label یا از طریق یک جدول Button Group DAT انجام شود.
این قابلیت در پروژه‌های nocturnix و ورکشاپ‌های bobinyx برای طراحی رابط کاربری تعاملی یا کنترل پارامترهای زنده بسیار پرکاربرد است.
ویژگی‌های کلیدی Button COMP
Label: نوشته‌ای که روی دکمه نمایش داده می‌شود.
Value: وضعیت فعلی دکمه (روشن/خاموش).
Button Type: تعیین رفتار دکمه (لحظه‌ای، سوئیچی، رادیویی یا انحصاری).
Button Group Label / DAT: ابزارهای گروه‌بندی دکمه‌ها.
Color: رنگ پایه (RGB) برای نمایش دکمه.
پارامترها – Button Page
Momentary: روشن شدن فقط هنگام فشار یا رها کردن.
Toggle: روشن/خاموش شونده هنگام کلیک.
Radio: بخشی از یک گروه، فقط یکی روشن می‌شود.
Exclusive: شبیه رادیو ولی می‌تواند همه خاموش باشند.
پارامترها – Layout Page
X / Y: موقعیت افقی و عمودی دکمه نسبت به والد.
Width / Height: ابعاد دکمه.
Aspect Ratio: نسبت تصویر ثابت.
Depth Layer: ترتیب نمایش روی سایر پنل‌ها (مثل لایه در فتوشاپ).
Horizontal / Vertical Mode: تنظیم نحوه پرکردن فضا یا کشسان بودن دکمه نسبت به والد.
پارامترها – Panel Page
Display: نمایش یا مخفی‌سازی دکمه.
Enable: فعال یا غیرفعال کردن تعامل.
Help DAT: نمایش راهنمای شناور (Tooltip).
Cursor: تغییر شکل نشانگر هنگام قرار گرفتن روی دکمه.
Multi-Touch: پشتیبانی از لمس چندنقطه‌ای (مانند ورودی از Multi Touch In DAT).
Resize / Reposition: امکان تغییر اندازه یا جابه‌جایی دکمه با ماوس.
پارامترها – Look Page
Background Color / Alpha: رنگ و شفافیت پس‌زمینه.
Background TOP: امکان استفاده از یک تصویر یا ویدیو به‌عنوان بک‌گراند.
Border A / B: تنظیم رنگ و شفافیت حاشیه‌ها.
Opacity: شفافیت کلی دکمه.
Composite: تعیین روش ترکیب با سایر پنل‌ها (Over, Add, Multiply و غیره).
پارامترها – Children Page
Align: چینش فرزندان داخل دکمه (چپ، راست، بالا، پایین یا شبکه‌ای).
Spacing: فاصله بین فرزندان.
Margin: فاصله داخلی (حاشیه).
Justify: تراز افقی/عمودی فرزندان.
Fit & Scale: تغییر مقیاس فرزندان برای پرکردن فضا.
Scrollbars: افزودن اسکرول افقی یا عمودی در صورت نیاز.
پارامترها – Drag & Drop Page
پشتیبانی از Drag & Drop برای دکمه‌ها:
Dragging: امکان کشیدن دکمه یا جلوگیری از آن.
Drop Destination Script: اجرای اسکریپت هنگام انداختن آیتم روی دکمه.
Drop Types: تعیین نوع داده‌هایی که دکمه می‌تواند بپذیرد (COMP, TOP, CHOP, SOP و غیره).
پارامترها – Extensions Page
افزودن اکستنشن‌های پایتون برای شخصی‌سازی رفتار Button.
پارامترها – Common Page
Parent Shortcut / Global OP Shortcut: میانبرهای دسترسی سریع.
Clone Master: پشتیبانی از کلون‌سازی.
External .tox: بارگذاری محتوا از فایل خارجی.
Reload Parameters: مدیریت ری‌لود پارامترهای داخلی یا سفارشی.
Info CHOP Channels
با اتصال Info CHOP می‌توان اطلاعات دکمه را دریافت کرد:
num_children: تعداد فرزندان داخل کامپوننت.
cook_time: مدت زمان اجرای آخرین محاسبه.
errors / warnings: خطاها یا هشدارها.
🔹 جمع‌بندی:
Button COMP یکی از ابزارهای اصلی برای ساخت رابط‌های کاربری تعاملی در TouchDesigner است.
با آن می‌توان کنترل‌های ساده (مثل یک کلید روشن/خاموش) یا سیستم‌های پیچیده (مثل گروه‌های دکمه رادیویی یا Exclusive در یک پروژه nocturnix) را طراحی کرد.
در ورکشاپ‌های bobinyx این نود اغلب برای ایجاد پنل‌های کنترلی پویا به‌کار می‌رود.