خلاصه

کامپوننت Parameter این امکان را می‌دهد که دیالوگ پارامترهای هر اپراتوری (Operator) به‌صورت یک پنل با قابلیت تعامل کامل نمایش داده شود. شما مشخص می‌کنید پارامترهای کدام اپراتور در پنل ظاهر شوند.

به‌صورت اختیاری می‌توانید نمایش هدر و نام صفحات را فعال کنید و همچنین پارامترهای داخلی (Built-in) یا سفارشی (Custom) را در نمایش بگنجانید.

می‌توانید محدوده‌ای از صفحات یا پارامترهای خاص را برای نمایش مشخص کنید. برای مثال، دو صفحه کامل به‌همراه چهار پارامتر از صفحات دیگر. هنگام مشخص کردن تنها پارامترها، ترتیب نمایش آن‌ها همان ترتیبی است که شما تعیین می‌کنید.

می‌توانید رابط کاربری را کوچک کنید تا در یک پنل کوچک‌تر جا شود (با استفاده از پارامتر Compress).

می‌توانید تعیین کنید که آیا کاربران اجازه دارند پارامترها را برای ویرایش باز کنند یا خیر (با استفاده از + سمت چپ پارامتر و گزینه Allow Expansion). همچنین می‌توانید مانع ویرایش اکسپرشن‌ها توسط کاربران شوید.

نام صفحات یا پارامترها را می‌توان با الگو‌گذاری (Pattern Matching) مشخص کرد، مثل scale* یا ^tx. نام صفحات دارای فاصله باید در کوتیشن قرار بگیرند: 'Cue 1'، 'Cue 2'. همچنین می‌توانید از لیست پایتونی برای تعریف استفاده کنید.

صفحه پارامترها (Parameters – Parameter Page)

• Operator (op) – مسیر اپراتوری که پارامترهایش استفاده خواهند شد.

• Header (header) – نمایش هدر دیالوگ پارامتر (بخش نوع OP، نام و دکمه‌های راهنما).

• Page Names (pagenames) – نمایش تب‌های صفحات پارامتر.

• Separators (separators) – نمایش خطوط جداکننده بین بخش‌های مختلف پارامترها.

• Input Editor (inputeditor) – افزودن رابط ویرایش چندورودی. این بخش در انتهای دیالوگ پارامترهای چندورودی مثل Math CHOP یا Merge SOP ظاهر می‌شود.

• Allow Expansion (allowexpend) – تعیین می‌کند آیا پارامترها قابلیت باز شدن برای نمایش حالت‌ها و فیلدهای اکسپرشن را دارند یا نه.

• Built-In (builtin) – نمایش پارامترهای داخلی اپراتور.

• Custom (custom) – نمایش پارامترهای سفارشی اپراتور.

• Combine Scopes (combinescopes) – مشخص می‌کند پارامترهای انتخابی چطور ترکیب شوند.

  • Any (Or) – ترکیب با عملگر OR.

  • All (And) – ترکیب با عملگر AND.

• Page Scope (pagescope) – تعیین می‌کند کدام صفحات پارامتر نمایش داده شوند. از * برای انتخاب همه استفاده کنید.

• Parameter Scope (parscope) – تعیین می‌کند کدام پارامترها نمایش داده شوند. از * برای انتخاب همه استفاده کنید.

• Order by Scope (scopeorder) – نمایش پارامترها به ترتیب تعریف‌شده در فیلد Parameter Scope. (فقط وقتی که گزینه Page Name خاموش باشد در دسترس است).

• Compress (compress) – کوچک‌سازی رابط برای نمایش تعداد بیشتری پارامتر در همان ابعاد پنل. با افزایش مقدار، متن کوچک‌تر می‌شود و پارامترهای بیشتری همزمان دیده می‌شوند.

صفحه چیدمان (Parameters – Layout Page)

این بخش اندازه و موقعیت پنل را کنترل می‌کند:

• X / Y – تعیین موقعیت افقی و عمودی پنل نسبت به والد.

• Width / Height – تعیین عرض و ارتفاع پنل به پیکسل.

• Fixed Aspect (fixedaspect) – تنظیم نسبت تصویر ثابت:

  • Off – خاموش

  • Use Horizontal – استفاده از عرض برای محاسبه ارتفاع

  • Use Vertical – استفاده از ارتفاع برای محاسبه عرض

• Aspect Ratio (aspect) – نسبت تصویر (عرض/ارتفاع).

• Depth Layer (layer) – تعیین ترتیب نمایش لایه‌ها (مشابه فتوشاپ). عدد بزرگ‌تر جلوتر نمایش داده می‌شود.

• Horizontal Mode (hmode) – سه حالت عرض پنل:

  • Fixed Width – عرض ثابت

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

  • Anchors – بر اساس انکرهای چپ/راست نسبت به والد (۰ تا ۱، مشابه UV).

• Left Anchor / Right Anchor – موقعیت انکر چپ/راست نسبت به والد.

• Left Offset / Right Offset – جابجایی انکرها بر اساس پیکسل.

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

• Horizontal Fill Weight (hfillweight) – وزن پرشدگی افقی در حالت Fill.

• Vertical Mode (vmode) – سه حالت ارتفاع پنل:

  • Fixed Height – ارتفاع ثابت

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

  • Anchors – بر اساس انکرهای بالا/پایین نسبت به والد.

• Bottom Anchor / Top Anchor – موقعیت انکر پایین/بالا نسبت به والد.

• Bottom Offset / Top Offset – جابجایی انکرها بر اساس پیکسل.

• Vertical Origin (vorigin) – نقطه مبدأ عمودی پنل.

• Vertical Fill Weight (vfillweight) – وزن پرشدگی عمودی در حالت Fill.

• Parent Alignment (alignallow) – تعیین اینکه پنل با تنظیمات والد هماهنگ شود یا نه:

  • Allow – هماهنگ شود.

  • Ignore – نادیده گرفتن ولی با حفظ مارجین‌ها.

  • Ignore and Ignore Margins – نادیده گرفتن کامل.

• Align Order (alignorder) – ترتیب چیدمان فرزندها در والد (اعداد پایین‌تر اول قرار می‌گیرند).

• Post Offset (postoffset) – جابجایی اضافه پس از همه تنظیمات مکان. (X / Y).

• Size from Window (sizefromwindow) – وقتی فعال باشد، اندازه پنل بر اساس تغییر اندازه پنجره شناور تنظیم می‌شود.

صفحه پنل (Parameters – Panel Page)

ویژگی‌های عمومی پنل مانند نمایش، فعال بودن، کمک، و تعامل با موس/لمس را کنترل می‌کند:

• Display (display) – نمایش یا پنهان کردن پنل.

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

• Help DAT (helpdat) – تعیین مسیر یک Text DAT برای نمایش راهنمای شناور.

• Cursor (cursor) – تغییر شکل نشانگر موس هنگام ورود به پنل.

• Multi-Touch (multitouch) – مدیریت رویدادهای چند لمسی:

  • Use Parent’s Settings

  • Use Built-in

  • Disable Built-in

• 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 – جابجایی کامپوننت

• Component (repocomp) – مسیر کامپوننتی که باید جابجا شود.

• X Range / Y Range – محدوده مجاز جابجایی افقی و عمودی.

• Anchor Drag (anchordrag) – تعیین اینکه در حالت Anchors، جابجایی موس مقدار Anchor را تغییر دهد یا Offset.

• Scroll Overlay (scrolloverlay) – تعیین اینکه اسکرول بار روی پنل تأثیر بگذارد یا نه:

  • Off – تحت تأثیر قرار می‌گیرد.

  • Ignore – نادیده گرفتن اسکرول.

  • Ignore and Draw Over – نادیده گرفتن اسکرول و رسم روی اسکرول و همسایه‌ها.

صفحه ظاهر (Parameters – Look Page)

کنترل رنگ پس‌زمینه، حاشیه و حالت غیرفعال پنل:

• Background Color (bgcolor) – مقدار RGB پس‌زمینه (پیش‌فرض: سیاه).

• Background Alpha (bgalpha) – مقدار شفافیت پس‌زمینه.

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

• TOP Fill (topfill) – نحوه پر کردن پس‌زمینه با TOP: Stretch، Fill Width، Fill Height، Best، Native Resolution، Fill Outside.

• TOP Smoothness (topsmoothness) – تنظیم نوع فیلتر تصویر: Nearest Pixel، Interpolate Pixels، Mipmap Pixels.

• Border A (bordera) – رنگ مرز A (RGB).

• Border A Alpha (borderaalpha) – شفافیت مرز A.

• Border B (borderb) – رنگ مرز B (RGBA).

  ادامه صفحه ظاهر (Look Page)

  • Border B Alpha (borderbalpha) – مقدار آلفا (شفافیت) رنگ مرز B.

  • Left Border (leftborder) – رنگ دو پیکسل لبه چپ را مشخص می‌کند. گزینه‌ها:

    • 0 (بدون تغییر)،

    • Border A (استفاده از رنگ تعیین‌شده در Border A)،

    • Border B (استفاده از رنگ تعیین‌شده در Border B).

  • Left Border Inside (leftborderi) – مشابه مورد بالا، اما برای مرز داخلی.

  • Right Border (rightborder) – رنگ دو پیکسل لبه راست. همان گزینه‌ها مثل بالا.

  • Right Border Inside (rightborderi) – مشابه مورد بالا، اما برای مرز داخلی.

  • Bottom Border (bottomborder) – رنگ دو پیکسل لبه پایین. همان گزینه‌ها.

  • Bottom Border Inside (bottomborderi) – مشابه مورد بالا، برای مرز داخلی.

  • Top Border (topborder) – رنگ دو پیکسل لبه بالا. همان گزینه‌ها.

  • Top Border Inside (topborderi) – مشابه مورد بالا، برای مرز داخلی.

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

  • Disable Color (dodisablecolor) – فعال‌سازی استفاده از رنگ خاص برای حالت غیرفعال (زمانی که پارامتر Enable = Off باشد).

  • Disable Color (disablecolor) – مقدار RGB رنگ غیرفعال (پیش‌فرض: مشکی 0,0,0).

    • Red (disablecolorr) – کانال قرمز

    • Green (disablecolorg) – کانال سبز

    • Blue (disablecolorb) – کانال آبی

  • Disable Alpha (disablealpha) – مقدار آلفا برای رنگ غیرفعال.

  • Multiply RGB by Alpha (multrgb) – ضرب کانال‌های RGB در کانال آلفا.

  • Composite (composite) – تعیین نحوه ترکیب پنل با پنل‌های هم‌سطح. مشابه Composite TOP. گزینه‌ها:

    • Over

    • Under

    • Inside

    • Outside

    • Add

    • Subtract

    • Multiply

  • Opacity (opacity) – کنترل شفافیت پنل.

  ---

  صفحه فرزندان (Parameters – Children Page)

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

  • Align (align) – تعیین می‌کند فرزندان چگونه در پنل چیدمان شوند:

    • None – بدون چیدمان خاص

    • Left to Right – از چپ به راست

    • Right to Left – از راست به چپ

    • Top to Bottom – از بالا به پایین

    • Bottom to Top – از پایین به بالا

    • Grid Rows – شبکه‌ای به صورت ردیف

    • Grid Columns – شبکه‌ای به صورت ستون

    • Match Network Nodes – مطابقت با ترتیب نودهای شبکه

  • Spacing (spacing) – فاصله بین فرزندان (وقتی Align غیر از None یا Match Network باشد).

  • Max per Line (alignmax) – بیشترین تعداد فرزند در هر ردیف یا ستون.

  • Margin (margin) – فاصله دور پنل. چهار فیلد برای چپ (L)، راست (R)، پایین (B) و بالا (T). این مقادیر بر حسب پیکسل مطلق هستند.

  • Justify Method (justifymethod) – نحوه تراز کردن فرزندان:

    • Individual – هر کدام جداگانه

    • Group – به‌صورت یک گروه درون یک جعبه محاسبه می‌شوند.

  • Justify Horizontal (justifyh) – ترازبندی افقی: Off, Left, Center, Right.

  • Justify Vertical (justifyv) – ترازبندی عمودی: Off, Top, Center, Bottom.

  • Fit (fit) – تغییر مقیاس فرزندان پنل: Off, Fit Width, Fit Height, Fit Best.

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

  • Offset (offset) – جابه‌جایی فرزندان (X/Y). تحت تأثیر Align و Justify قرار می‌گیرد.

  • Crop (crop) – برش پنل‌های فرزندی که خارج از ابعاد والد باشند: Off (Use Parent)، On، Never.

  • Horizontal Scrollbar (phscrollbar) – اسکرول‌بار افقی: Off, On, Automatic.

  • Vertical Scrollbar (pvscrollbar) – اسکرول‌بار عمودی: Off, On, Automatic.

  • Thickness (scrollbarthickness) – ضخامت اسکرول‌بارها (پیکسل).

  ---

  صفحه Drag/Drop (Parameters – Drag/Drop Page)

  این صفحه عملکرد Drag & Drop پنل را کنترل می‌کند.

  • When Dragging This (drag) – آیا این پنل قابل کشیدن است؟

    • Use Parent’s Drag Settings – تبعیت از والد

    • Legacy Drag System – فعال‌سازی سیستم قدیمی (استفاده از اسکریپت‌ها)

    • Do Not Allow Drag – غیرفعال کردن

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

  • Drop Destination Script (dropdestscript) – اسکریپتی که هنگام رها کردن اجرا می‌شود. یک شبکه موقت ساخته شده و اپراتور داخل آن کپی می‌شود.

  • Drop Types (droptypescript) – جدول DAT برای مشخص‌کردن انواع داده‌هایی که اسکریپت Drop برمی‌گرداند (مثلاً COMP, TOP, CHOP…).

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

  • On Dropping Into (drop) – آیا پنل آیتم‌های Drop شده را قبول می‌کند؟

    • Use Parent’s Drop Settings

    • Legacy Drop System

    • Do Not Allow Drop

  • Drop Script (dropscript) – اسکریپت اجراشده هنگام رها شدن یک کامپوننت یا فایل. می‌تواند یک Text DAT یا یک جدول DAT با ستون نوع داده و نام Text DAT باشد.

  ---

  صفحه Extensions (Parameters – Extensions Page)

  این صفحه مربوط به اکستنشن‌های پایتون است.

  • Extension (ext) – اطلاعات مربوط به ایجاد اکستنشن روی کامپوننت.

  • Object (ext0object) – نمونه کلاس‌هایی که می‌توان به کامپوننت متصل کرد.

  • Name (ext0name) – نام اختیاری برای جستجو به‌جای نام کلاس.

  • Promote (ext0promote) – آیا اکستنشن‌ها مستقیم در سطح کامپوننت در دسترس باشند یا فقط از طریق .ext.

  • Re-Init Extensions (reinitextensions) – بازکامپایل تمام اکستنشن‌ها.

  ---

  صفحه Common (Parameters – Common Page)

  تنظیمات عمومی شامل نمایش نود، کلون‌ها و فایل‌های خارجی:

  • Parent Shortcut (parentshortcut) – نام میانبر برای مسیر والد.

  • Global OP Shortcut (opshortcut) – نام میانبر سراسری برای مسیر.

  • Internal OP (iop) – تعریف اپراتورهای داخلی.

  • Node View (nodeview) – مشخص می‌کند در ویو نود چه چیزی نشان داده شود:

    • Default Viewer

    • Operator Viewer

  • Operator Viewer (opviewer) – انتخاب اپراتور برای نمایش در ویو.

  • Keep in Memory (keepmemory) – نگهداری در حافظه.

  • Enable Cloning (enablecloning) – فعال/غیرفعال کردن کلون.

  • Enable Cloning Pulse (enablecloningpulse) – اجرای فوری کلون.

  • Clone Master (clone) – مسیر مستر کلون.

  • Load on Demand (loadondemand) – بارگذاری تنها هنگام نیاز.

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

  • Enable External .tox Pulse (enableexternaltoxpulse) – ری‌لود دستی .tox.

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

  • Reload Custom Parameters (reloadcustom) – ری‌لود پارامترهای سفارشی هنگام بارگذاری دوباره .tox.

  • Reload Built-In Parameters (reloadbuiltin) – ری‌لود پارامترهای داخلی.

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

  • Sub-Component to Load (subcompname) – لود کردن یک زیرکامپوننت خاص از .tox.

  • Relative File Path Behavior (relpath) – مشخص می‌کند مسیرهای فرزند نسبت به .toe باشند یا .tox.

  ---

  Info CHOP Channels

  اطلاعات اضافی Parameter COMP را می‌توان از طریق Info CHOP دسترسی داشت.

  • Specific Channels: select, lselect, mselect, rselect, reposition, resize, dragout, ldragout, mdragout, rdragout, ctrl, alt, shift, cmd, u, v, trueu, truev, rollover, inside…

  • Common COMP Info:

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

  • Common Operator Info:

    • total_cooks – تعداد Cookها

    • cook_time – مدت Cook

    • cook_frame – فریم آخرین Cook

    • cook_abs_frame – فریم مطلق آخرین Cook

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

    • cook_end_time – زمان پایان Cook

    • cooked_this_frame – آیا این فریم Cook شده

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

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