خلاصه
Analyze TOP هر تصویر ورودی را می‌گیرد و ویژگی‌های مختلفی از آن را محاسبه می‌کند؛ مثل میانگین رنگ پیکسل‌ها، پیکسل با بیشترین روشنایی (Luminance) یا کمترین و بیشترین مقدار در هر کانال رنگی. نتیجه بسته به محدوده‌ی انتخاب‌شده (Scope) به‌صورت تصویر 1×1، 1xN یا Nx1 ذخیره می‌شود. این مقادیر محاسبه‌شده را می‌توان با استفاده از نود TOP to CHOP به CHOPها منتقل کرد.
نکته: هنگام استفاده از عملگرهای حداقل (Minimum) و حداکثر (Maximum)، رفتار پیش‌فرض این است که پیکسلی انتخاب می‌شود که در کانال مشخص‌شده در پارامتر Analyze Channel بیشترین مقدار را دارد. برای مثال، اگر Luminance انتخاب شود، خروجی مقادیر RGBA همان پیکسلی خواهد بود که بیشترین روشنایی را دارد (نه خود مقدار روشنایی). همچنین، اگر فقط یک کانال (مثلاً Red، Green یا Blue) انتخاب شود، خروجی پیکسل با بیشترین مقدار در آن کانال است، نه بیشترین مقدار در همه کانال‌ها. برای اینکه کمترین یا بیشترین مقدار هر کانال جداگانه به دست بیاید، باید پارامتر Analyze Channel روی RGBA Independent تنظیم شود.
نکته: وقتی عملگر روی Count Pixels یا Sum تنظیم شود، فرمت خروجی تصویر به‌صورت پیش‌فرض شناور 32 بیتی (32-bit float) خواهد بود تا بتواند داده‌ها را درست ذخیره کند. در سایر عملیات، فرمت خروجی مطابق ورودی است. فرمت تصویر را می‌توان به‌صورت دستی در صفحه Common تنظیم کرد.
نکته: فعال کردن گزینه‌های Exclude NaNs یا Mask باعث کند شدن عملکرد نود می‌شود و فقط در صورت نیاز باید استفاده شوند.
پارامترها – صفحه Analyze
Operation (عملیات):
نوع عملیاتی که روی تصویر ورودی انجام می‌شود:
Average (میانگین): میانگین مقدار در هر کانال محاسبه می‌شود. (کندتر است اگر NaN یا ماسک فعال باشد، چون دو بار پردازش لازم دارد.)
Minimum Pixel: پیکسل با کمترین مقدار، بر اساس کانال انتخاب‌شده در Analyze Channel.
Maximum Pixel: پیکسل با بیشترین مقدار، بر اساس کانال انتخاب‌شده.
Count Pixels: شمارش تعداد پیکسل‌های معتبر. (با NaN یا ماسک، فقط پیکسل‌های معتبر شمرده می‌شوند.) خروجی پیش‌فرض به‌صورت 32bit float است.
Sum: جمع مقادیر تمام پیکسل‌ها. خروجی پیش‌فرض 32bit float است.
Minimum in RGB: کمترین مقدار از بین کانال‌های R، G، B (خروجی در همه کانال‌ها برابر است).
Minimum in RGBA: کمترین مقدار از بین کانال‌های RGBA.
Maximum in RGB: بیشترین مقدار از بین کانال‌های RGB.
Maximum in RGBA: بیشترین مقدار از بین کانال‌های RGBA.
Analyze Channel (کانال تحلیل):
تعیین می‌کند عملیات روی چه مقداری انجام شود:
Luminance: بر اساس روشنایی پیکسل. (خروجی RGBA همان پیکسل با بیشترین/کمترین روشنایی است.)
Red / Green / Blue / Alpha: محاسبات فقط بر اساس یکی از کانال‌ها.
RGB Average: بر اساس میانگین کانال‌های RGB.
RGBA Average: بر اساس میانگین کانال‌های RGBA.
RGBA Independent: جداگانه برای هر کانال.
RGB Maximum / RGBA Maximum
Scope (محدوده):
نحوه گروه‌بندی پیکسل‌ها برای محاسبات:
Full Image: کل تصویر به یک مقدار تبدیل می‌شود.
Rows: برای هر ردیف محاسبه جداگانه انجام می‌شود (خروجی یک پیکسل عرض دارد و به تعداد ردیف‌های ورودی ارتفاع دارد).
Columns: برای هر ستون محاسبه جداگانه انجام می‌شود (خروجی یک پیکسل ارتفاع دارد و به تعداد ستون‌های ورودی عرض دارد).
Exclude NaNs (حذف NaN): پیکسل‌هایی که مقدارشان NaN است نادیده گرفته می‌شوند.
Mask (ماسک): انتخاب پیکسل‌ها بر اساس کانال مشخص:
None: همه پیکسل‌ها استفاده می‌شوند.
Red / Green / Blue / Alpha: فقط پیکسل‌های غیر صفر در کانال انتخاب‌شده.
RGBA Independent: هر کانال جداگانه به‌عنوان ماسک.
پارامترها – صفحه Common
Output Resolution: تعیین رزولوشن خروجی (ورودی، نصف، یک‌چهارم، سفارشی و …).
Resolution: فقط در حالت Custom فعال است.
Use Global Res Multiplier: استفاده از ضریب سراسری رزولوشن (برای هماهنگی در سیستم‌های سخت‌افزاری مختلف).
Output Aspect: نسبت تصویر خروجی (ورودی، رزولوشن، یا سفارشی).
Input Smoothness: نوع فیلترینگ پیکسل ورودی (Nearest, Linear, Mipmap).
Fill Viewer: نحوه نمایش تصویر در ویوئر (Fill, Fit, Native Resolution و …).
Viewer Smoothness: فیلترینگ پیکسل‌ها در ویوئر.
Passes: تکرار عملیات چند بار پشت سر هم.
Channel Mask: انتخاب کانال‌هایی که عملیات روی آن‌ها انجام شود.
Pixel Format: فرمت داده هر کانال (8 بیت، 16 بیت، 32 بیت، Float، Mono، RG، Alpha و ترکیب‌های مختلف).
ورودی‌های اپراتور
Input 0: تصویر ورودی.
Info CHOP Channels
اطلاعات اضافه از طریق یک Info CHOP قابل دسترسی است.
Common TOP Info Channels:
resx / resy: رزولوشن افقی و عمودی.
aspectx / aspecty: نسبت ابعاد.
depth: عمق آرایه.
gpu_memory_used: میزان حافظه GPU مصرفی.
Common Operator Info Channels:
total_cooks: تعداد دفعات پردازش.
cook_time: زمان آخرین پردازش (میلی‌ثانیه).
cook_frame / cook_abs_frame: فریم آخر پردازش در تایم‌لاین کامپوننت یا تایم مطلق.
cook_start_time / cook_end_time: زمان شروع و پایان پردازش.
cooked_this_frame: آیا در همین فریم پردازش شده (1 یا 0).
warnings / errors: تعداد هشدارها و خطاها.