آموزش Rectangle TOP در نرم افزار Touchdesigner

ویدئوی آموزشی youtube

ویدئو آموزشی Aparat

پرش به ناوبری
پرش به جستجو

خلاصه (Summary)

Rectangle TOP برای ایجاد مستطیل‌ها با گوشه‌های گرد استفاده می‌شود.

شکل‌ها را می‌توان با اندازه‌های مختلف، چرخش و موقعیت‌دهی سفارشی کرد. می‌توان یک حاشیه (Border) اختیاری به شکل اضافه کرد. رنگ پس‌زمینه، حاشیه و پر شدن (Fill) را می‌توان به‌صورت مستقل تنظیم کرد. همچنین امکان فعال یا غیرفعال کردن Anti-Aliasing وجود دارد.

PythonIcon.pngrectangleTOP_Class


فهرست مطالب (Contents)

  1. Summary

  2. Parameters – Rectangle Page

  3. Parameters – Output Page

  4. Parameters – Common Page

  5. Operator Inputs

  6. Info CHOP Channels
     6.1 Common TOP Info Channels
     6.2 Common Operator Info Channels


پارامترها – صفحه Rectangle

Size (size) ⊞

عرض و ارتفاع مستطیل را تعیین می‌کند.

Size Unit (sizeunit)

واحد اندازه‌گیری برای این پارامتر را انتخاب کنید:

  • Pixels

  • Fraction (0-1)

  • Fraction Aspect (0-1 با در نظر گرفتن نسبت تصویر)

Rotate (rotate)

چرخش شکل به میزان درجه مشخص‌شده.

Center (center) ⊞

مختصات مرکز شکل. (0,0) به معنای مرکز دقیق شکل است.

Center Unit (centerunit)

واحد مختصات مرکز: Pixels، Fraction (0-1)، یا Fraction Aspect (0-1)

Justify Horizontal (justifyh) ⊞

تراز افقی مستطیل را مشخص می‌کند.

Justify Vertical (justifyv) ⊞

تراز عمودی مستطیل را مشخص می‌کند.

Fill Color (fillcolor) ⊞

رنگ پر شدن شکل را مشخص می‌کند.

Fill Alpha (fillalpha)

شفافیت رنگ پر شدن.

Border Color (border) ⊞

رنگ حاشیه شکل.

Border Alpha (borderalpha)

شفافیت حاشیه شکل.

Background Color (bgcolor) ⊞

رنگ پس‌زمینه شکل.

Background Alpha (bgalpha)

شفافیت پس‌زمینه.

Multiply RGB by Alpha (multrgbbyalpha)

مقادیر RGB را در Alpha ضرب می‌کند.

Border Width (borderwidth)

عرض حاشیه شکل.

Border Width Unit (borderwidthunit)

واحد اندازه‌گیری عرض حاشیه: Pixels، Fraction، Fraction Aspect

Border Offset (borderoffset)

مقدار بین 0 تا 1 که مشخص می‌کند چه بخش از حاشیه از شعاع شکل فراتر رود.
مقدار موثر: radius + borderoffset * borderwidth

Corner Radius (cornerradius)

شعاع گوشه‌ها برای گرد کردن مستطیل.

Corner Radius Unit (cornerradiusunit)

واحد اندازه‌گیری شعاع گوشه‌ها: Pixels، Fraction، Fraction Aspect

Anti-Alias (antialias)

در صورت فعال بودن، شکل Anti-Aliased خواهد بود.

Softness (softness)

میزان ترکیب رنگ پس‌زمینه با شکل را مشخص می‌کند.

Softness Unit (softnessunit)

واحد اندازه‌گیری Softness: Pixels، Fraction، Fraction Aspect


پارامترها – صفحه Output

Comp Over Input (compoverinput)

با فعال کردن، ورودی با تصویر ترکیب (Composite) می‌شود.

Operation (operand) ⊞

نوع عملیات Composite را انتخاب کنید. برای جزئیات بیشتر می‌توانید عبارت blend modes را جستجو کنید.

Swap Order (swaporder)

ترتیب ترکیب با ورودی را جابه‌جا می‌کند.


پارامترها – صفحه Common

Output Resolution (outputresolution) ⊞

تغییر سریع رزولوشن داده‌های TOP.

Resolution (resolution) ⊞

فقط زمانی فعال است که Resolution روی Custom Resolution باشد. برخی Generatorها مانند Constant و Ramp ورودی ندارند و فقط از این مقدار برای تعیین اندازه استفاده می‌کنند.

Resolution Menu (resmenu)

منوی کشویی شامل رزولوشن‌های پرکاربرد.

Use Global Res Multiplier (resmult)

از Global Resolution Multiplier در Edit > Preferences > TOPs استفاده می‌کند.
رزولوشن همه TOPها در یک ضریب مشخص ضرب می‌شود.

Output Aspect (outputaspect) ⊞

نسبت تصویر خروجی را تنظیم می‌کند.

Aspect (aspect) ⊞

زمانی استفاده می‌شود که Output Aspect روی Custom Aspect تنظیم شده باشد.

Aspect Menu (armenu)

منوی کشویی شامل نسبت‌های تصویر متداول.

Input Smoothness (inputfiltertype) ⊞

کنترل فیلتر شدن پیکسل‌های تصویر ورودی TOP.

Fill Viewer (fillmode) ⊞

نحوه‌ی نمایش تصویر TOP در Viewer.
نکته: هنگام شروع کار، روی Native Resolution قرار دهید تا تغییر اندازه خودکار اعمال نشود.

Viewer Smoothness (filtertype) ⊞

کنترل فیلتر شدن پیکسل‌ها در Viewer.

Passes (npasses)

عملیات TOP را به تعداد مشخص‌شده تکرار می‌کند.
استثنا: GLSL TOP هنگام استفاده از Compute Shader، ورودی همچنان تصویر TOP متصل باقی می‌ماند.

Channel Mask (chanmask)

مشخص می‌کند TOP روی کدام کانال‌ها (R، G، B یا A) اعمال شود.

Pixel Format (format) ⊞

فرمت ذخیره‌سازی داده برای هر کانال تصویر.


پارامترهای فضای رنگ (Parameter Color Space)

Parameter Color Space (parmcolorspace) ⊞

تعیین می‌کند تمام پارامترهای رنگی روی این نود چگونه تفسیر شوند.
مقادیر رنگ در فضای رنگ انتخاب‌شده تفسیر شده و قبل از استفاده به Working Color Space تبدیل می‌شوند.

Parameter Reference White (parmreferencewhite) ⊞

هنگام تبدیل مقدار رنگ به Working Color Space، میزان Reference White کنترل می‌شود.
اگر Working Color Space همان Reference White باشد، تغییری اعمال نمی‌شود.
در غیر این صورت سطح روشنایی رنگ متناسب با Working Color Space تنظیم می‌شود.
مثال:

  • SDR Reference White = 120 nits

  • HDR Reference White = 80 nits

  • رنگ (1,1,1) در SDR (120 nits) → تبدیل به (1.5,1.5,1.5) در HDR Working Color Space


ورودی اپراتور (Operator Inputs)

Input 0: Composite Input

کنترل عملیات Composite از طریق پارامترهای صفحه Output.


کانال‌های Info CHOP

اطلاعات اضافی Rectangle TOP از طریق Info CHOP در دسترس است.

Common TOP Info Channels

  • resx – رزولوشن افقی (پیکسل)

  • resy – رزولوشن عمودی (پیکسل)

  • aspectx – نسبت افقی

  • aspecty – نسبت عمودی

  • depth – عمق آرایه 2D یا 3D

  • gpu_memory_used – کل حافظه GPU مصرف‌شده توسط TOP

Common Operator Info Channels

  • total_cooks – تعداد Cookها از شروع اجرا

  • cook_time – مدت زمان آخرین Cook (ms)

  • cook_frame – شماره فریم Cook نسبت به تایم‌لاین

  • cook_abs_frame – شماره فریم Cook نسبت به زمان مطلق

  • cook_start_time – زمان شروع Cook (ms)

  • cook_end_time – زمان پایان Cook (ms)

  • cooked_this_frame – 1 اگر در این فریم Cook شده باشد

  • warnings – تعداد هشدارها

  • errors – تعداد خطاها