خلاصه
Add TOP تصاویر ورودی را با هم جمع می‌کند.
فرمول خروجی به شکل زیر است:
اگر مقدار یک کانال رنگ بیشتر از ۱ شود، نتیجه Clamp (سقف‌گذاری) می‌شود.
این نود در ورکشاپ‌های bobinyx برای ساخت افکت‌های نوری و ویدئویی و در پروژه‌های nocturnix برای ایجاد لایه‌های ترکیبی پویا استفاده می‌شود.
پارامترها – Transform Page
Fixed Layer Size: انتخاب لایه‌ی ثابت. ورودی انتخاب‌شده به‌عنوان لایه ثابت در نظر گرفته می‌شود و لایه دیگر به‌عنوان Overlay (لایه پوشاننده) روی آن اعمال می‌گردد.
رزولوشن و نسبت تصویر لایه ثابت به‌عنوان خروجی در نظر گرفته می‌شود.
Pre-Fit Overlay: نحوه جای‌گیری لایه Overlay:
Fill: کشیده یا فشرده می‌شود تا لایه ثابت را کامل پر کند.
Fit Horizontal: تناسب افقی را حفظ می‌کند.
Fit Vertical: تناسب عمودی را حفظ می‌کند.
Fit Best: بهترین تناسب بدون کراپ.
Fit Outside: حالت برعکس Best Fit.
Native Resolution: حفظ رزولوشن اصلی Overlay.
Justify Horizontal: تراز افقی Overlay → Left / Center / Right.
Justify Vertical: تراز عمودی Overlay → Bottom / Center / Top.
Extend Overlay: رفتار لبه‌ها → Hold / Zero / Repeat / Mirror.
🔹 پارامترهای Transform (فقط روی Overlay تأثیر می‌گذارند):
Rotate: چرخش.
Translate (X, Y): جابجایی.
Scale (X, Y): مقیاس‌دهی.
Pivot (X, Y): مرکز چرخش و مقیاس.
پارامترها – Common Page
Output Resolution: تنظیم سریع رزولوشن خروجی.
Use Input, Half, 2X, 4X, Custom و …
Aspect Ratio: نسبت تصویر → Use Input / Resolution / Custom.
Input Smoothness: نوع فیلتر پیکسل ورودی → Nearest / Linear / Mipmap.
Fill Viewer: نحوه نمایش در Viewer → Fill / Fit / Native Resolution و غیره.
Viewer Smoothness: فیلتر در Viewer → Nearest / Linear / Mipmap.
Passes: تعداد دفعات اجرای نود.
Channel Mask: انتخاب کانال‌ها (R, G, B, A).
Pixel Format: انتخاب فرمت پیکسلی → 8bit / 16bit / 32bit / Mono / RG / Alpha.
ورودی‌ها (Operator Inputs)
Input 0
Input 1
Info CHOP Channels
اطلاعات اضافی Add TOP از طریق Info CHOP در دسترس است.
Common TOP Info Channels
resx / resy: رزولوشن افقی و عمودی.
aspectx / aspecty: نسبت افقی و عمودی.
depth: عمق بافت.
gpu_memory_used: میزان حافظه GPU مصرف‌شده.
Common Operator Info Channels
total_cooks: تعداد Cookها از زمان شروع.
cook_time: مدت Cook آخر (ms).
cook_frame / cook_abs_frame: فریم Cook شده.
cooked_this_frame: آیا در این فریم Cook شده؟
warnings / errors: تعداد هشدارها و خطاها.
🔹 جمع‌بندی:
Add TOP یکی از ابزارهای اصلی برای ترکیب تصاویر در TouchDesigner است.
این نود با جمع پیکسل‌ها امکان ساخت جلوه‌های تصویری مانند بلندینگ نوری، افکت‌های تکرارشونده و لایه‌گذاری ویدئو را فراهم می‌کند.
در پروژه‌های nocturnix از آن برای Blend زنده تصاویر و در ورکشاپ‌های bobinyx برای آموزش مفاهیم Composite به‌کار می‌رود.