خلاصه

کامپوننت Container هر تعداد از کامپوننت‌های پنل مانند دکمه، اسلایدر، فیلد، Container و دیگر پنل‌ها را گروه‌بندی می‌کند تا یک رابط کاربری ایجاد شود. برای مثال، از Container COMP برای شروع ساخت پنل کنترل استفاده می‌شود. داخل آن می‌توانید همه اسلایدرها، دکمه‌ها و پنل‌های نمایشگر را قرار دهید. همچنین می‌تواند برای گروه‌بندی چندین اسلایدر و دکمه در یک پنل استفاده شود که به صورت یکجا قابل حرکت و مقیاس‌دهی باشند، مانند ۳ اسلایدر RGB برای یک Color Picker در پنل کنترل شما.


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

صفحه Layout برای کنترل اندازه و موقعیت پنل استفاده می‌شود.

  • X x – موقعیت افقی پنل نسبت به والد (parent) بر حسب پیکسل.

  • Y y – موقعیت عمودی پنل نسبت به والد بر حسب پیکسل.

  • Width w – عرض پنل بر حسب پیکسل.

  • Height h – ارتفاع پنل بر حسب پیکسل.

  • Fixed Aspect fixedaspect – ایجاد پنل با نسبت ابعاد مشخص (Aspect Ratio). فقط کافیست عرض یا ارتفاع را تعیین کنید، بعدی بر اساس نسبت ابعاد محاسبه می‌شود.

    • Off – غیرفعال

    • Use Horizontal – استفاده از عرض

    • Use Vertical – استفاده از ارتفاع

  • Aspect Ratio aspect – نسبت عرض به ارتفاع زمانی که Fixed Aspect فعال است.

  • Depth Layer layer – ترتیب رسم پنل‌ها، مشابه لایه‌ها در Photoshop. مقدار بالاتر روی پنل‌هایی با مقدار کمتر کشیده می‌شود.

  • Horizontal Mode hmode – تعیین نحوه تعیین عرض پنل:

    • Fixed Width – استفاده از پارامتر Width

    • Fill – عرض پنل برابر عرض والد

    • Anchors – عرض پنل با استفاده از Left و Right Anchor تعیین می‌شود و با تغییر والد قابل تغییر است

  • Left Anchor leftanchor / Right Anchor rightanchor – موقعیت انکرها نسبت به والد (۰ تا ۱).

  • Left/Right Offset – آفست انکرها بر حسب پیکسل.

  • Horizontal Origin horigin – تعیین مبدا افقی پنل (پیش‌فرض گوشه پایین-چپ).

  • Horizontal Fill Weight hfillweight – تنظیم اولویت هنگام پر کردن فضای افقی برای چند پنل.

  • Vertical Mode vmode – تعیین نحوه تعیین ارتفاع پنل:

    • Fixed Height – استفاده از پارامتر Height

    • Fill – ارتفاع پنل برابر ارتفاع والد

    • Anchors – ارتفاع پنل با استفاده از Bottom و Top Anchor تعیین می‌شود

  • Bottom/Top Anchor و Offset – مشابه افقی برای ارتفاع.

  • Vertical Origin vorigin – تعیین مبدا عمودی پنل.

  • Vertical Fill Weight vfillweight – اولویت پر کردن فضای عمودی هنگام چند پنل.

  • Parent Alignment alignallow – نحوه تراز شدن نسبت به والد:

    • Allow – تراز با توجه به والد

    • Ignore – نادیده گرفتن تراز والد

    • Ignore and Ignore Margins – نادیده گرفتن تراز و حاشیه‌ها

  • Align Order alignorder – ترتیب تراز هنگام استفاده از Align والد.

  • Post Offset postoffset – آفست نهایی بعد از اعمال همه موقعیت‌ها و ترازها.

  • Size from Window sizefromwindow – تعیین عرض و ارتفاع پنل با تغییر اندازه پنجره نمایشگر.


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

صفحه Panel برای کنترل نمایش، فعال بودن و تعامل با موس استفاده می‌شود.

  • Display display – نمایش یا مخفی بودن پنل.

  • Enable enable – فعال یا غیر فعال کردن تعامل با پنل.

  • Help DAT helpdat – مسیر یک Text DAT که متن راهنما را هنگام Hover نشان می‌دهد.

  • Cursor cursor – تغییر نشانگر موس هنگام Hover: Normal, Link, Text, Precision, Busy, Activate, Invisible.

  • Multi-Touch multitouch – فعال کردن لمس چندگانه.

  • Constrain Cursor constraincursor – محدود کردن موس به داخل پنل.

  • Click Through clickthrough – نادیده گرفتن کلیک موس روی پنل.

  • Use Mouse Wheel mousewheel – فعال کردن واکنش به چرخ موس.

  • Mouse UV Buttons uvbuttons – تعیین دکمه‌های موس برای تغییر مقادیر UV.

  • Relative UV mouserel – فعال کردن مقادیر UV نسبی با حرکت موس.

  • Drag Edges to Resize resize – فعال کردن تغییر اندازه پنل با کشیدن لبه‌ها.

  • W Range / H Range – محدود کردن محدوده تغییر اندازه عرض و ارتفاع.

  • Drag to Reposition reposition – فعال کردن جابجایی پنل با موس (Off, Window, Component).

  • Anchor Drag anchordrag – تعیین اینکه جابجایی، انکرها یا آفست را تغییر دهد.

  • Scroll Overlay scrolloverlay – تعیین تاثیر اسکرول‌بار روی پنل (Off, Ignore, Ignore and Draw Over).


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

برای تنظیم رنگ، بک‌گراند و حاشیه‌ها:

  • Background Color bgcolor – رنگ پس‌زمینه (RGB).

  • Background Alpha bgalpha – مقدار آلفا پس‌زمینه.

  • Background TOP top – استفاده از TOP به عنوان پس‌زمینه.

  • TOP Fill topfill – نحوه پر کردن پس‌زمینه با TOP.

  • TOP Smoothness topsmoothness – تعیین کیفیت تصویر TOP.

  • Border A/B – رنگ و آلفا حاشیه‌ها.

  • Border Over Children borderover – رسم حاشیه روی تمام پنل‌های فرزند.

  • Disable Color disablecolor – رنگ هنگام غیرفعال بودن پنل.

  • Multiply RGB by Alpha multrgb – ضرب RGB در آلفا.

  • Composite composite – نحوه ترکیب پنل با پنل‌های هم‌رده.

  • Opacity opacity – شفافیت پنل.


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

کنترل نحوه تراز، اندازه و موقعیت فرزندان پنل:

  • Align align – نحوه چینش فرزندان (Left to Right, Right to Left, Top to Bottom, Bottom to Top, Grid, Match Nodes).

  • Spacing spacing – فاصله بین فرزندان.

  • Max per Line alignmax – حداکثر تعداد فرزندان در یک ردیف یا ستون.

  • Margin margin – حاشیه اطراف پنل.

  • Justify Method justifymethod – تراز گروهی یا فردی فرزندان.

  • Justify Horizontal/Vertical justifyh/justifyv – تراز افقی و عمودی فرزندان.

  • Fit fit – تغییر مقیاس فرزندان برای جای‌گیری بهتر.

  • Scale scale – مقیاس‌دهی یکنواخت فرزندان.

  • Offset offset – آفست فرزندان.

  • Crop crop – برش فرزندانی که خارج از پنل هستند.

  • Horizontal/Vertical Scrollbar phscrollbar/pvscrollbar – نمایش اسکرول‌بارها و ضخامت آن‌ها.


پارامترها – صفحه Drag/Drop

کنترل عملکرد کشیدن و رها کردن (Drag & Drop):

  • When Dragging This drag – فعال کردن کشیدن پنل.

  • Drag Script dragscript – اسکریپت اجرا شده هنگام شروع Drag.

  • Drop Destination Script dropdestscript – اسکریپت اجرا شده هنگام رها کردن.

  • Drop Types droptypescript – نوع داده‌هایی که رها کردن می‌تواند منتقل کند.

  • Dropped Operator paneldragop – مشخص کردن اپراتور جایگزین هنگام رها کردن.

  • On Dropping Into drop – فعال یا غیرفعال کردن دریافت موارد رها شده.

  • Drop Script dropscript – اسکریپت اجرا شده هنگام دریافت Drop.


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

تنظیم افزونه‌های Python برای این کامپوننت:

  • Extension ext – ایجاد و مدیریت افزونه‌ها.

  • Object ext0object – نمونه‌های کلاس قابل الصاق به کامپوننت.

  • Name ext0name – نام اختیاری برای جستجو.

  • Promote ext0promote – کنترل دسترسی مستقیم به افزونه‌ها یا از طریق .ext.

  • Re-Init Extensions reinitextensions – بازکامپایل همه افزونه‌ها.


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

کنترل Viewer و رابطه Clone:

  • Parent Shortcut parentshortcut – نام دسترسی به این کامپوننت درون شبکه.

  • Global OP Shortcut opshortcut – نام دسترسی سراسری به کامپوننت.

  • Internal OP iop / Shortcut / OP – مدیریت اپراتورهای داخلی.

  • Node View nodeview – نمایشگر Node Viewer.

  • Keep in Memory keepmemory – نگه داشتن در حافظه.

  • Enable Cloning enablecloning – فعال کردن Clone.

  • Enable Cloning Pulse enablecloningpulse – Clone فوری محتوا.

  • Clone Master clone – مسیر به کامپوننت Master Clone.

  • Load on Demand loadondemand – بارگذاری فقط هنگام نیاز.

  • Enable External .tox enableexternaltox – بارگذاری فایل .tox خارجی.

  • External .tox Path externaltox – مسیر فایل .tox خارجی.

  • Reload Custom/Built-in Parameters – بازخوانی پارامترها هنگام Reload .tox.

  • Save Backup of External savebackup – ذخیره نسخه پشتیبان در .toe.

  • Sub-Component to Load subcompname – انتخاب Sub-COMP از فایل .tox.

  • Relative File Path Behavior relpath – مسیرهای نسبی فایل‌ها.


کانال‌های Info CHOP

اطلاعات اضافی کامپوننت از طریق Info CHOP قابل دسترسی است:

  • Common COMP Info Channels

    • num_children – تعداد فرزندان

  • Common Operator Info Channels

    • total_cooks – تعداد بارهای Cook

    • cook_time – مدت زمان آخرین Cook بر حسب میلی‌ثانیه

    • cook_frame – شماره فریم آخرین Cook نسبت به زمان کامپوننت

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

    • cook_start_time / cook_end_time – زمان شروع و پایان Cook

    • cooked_this_frame – ۱ اگر Cook انجام شده باشد

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

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