خلاصه (Summary)

نکته
لایسنس: فقط در TouchDesigner Pro در دسترس است.

اپراتور MoSys TOP با سیستم‌های ترکینگ دوربین MoSys کار می‌کند و با استفاده از کانال‌هایی که از یک MoSys CHOP متصل دریافت می‌شوند، اعوجاج (Distortion) لنز را به‌صورت شبیه‌سازی‌شده اعمال می‌کند.

PythonIcon.png mosysTOP_Class

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

  1. خلاصه

  2. پارامترها – صفحه MoSys

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

  4. ورودی‌های اپراتور

  5. کانال‌های Info CHOP
     5.1 کانال‌های اطلاعات مشترک اپراتور

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

CHOP Node (chop)

مسیر یک MoSys CHOP که شامل داده‌های کانالی مورد استفاده برای محاسبه اعوجاج لنز است.

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

Output Resolution (outputresolution) ⊞

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

  • Use Input (useinput)
    استفاده از رزولوشن ورودی.

  • Eighth (eighth)
    ضرب رزولوشن ورودی در 1/8.

  • Quarter (quarter)
    ضرب رزولوشن ورودی در 1/4.

  • Half (half)
    ضرب رزولوشن ورودی در 1/2.

  • 2X (2x)
    دو برابر کردن رزولوشن ورودی.

  • 4X (4x)
    چهار برابر کردن رزولوشن ورودی.

  • 8X (8x)
    هشت برابر کردن رزولوشن ورودی.

  • Fit Resolution (fit)
    تطبیق عرض و ارتفاع با رزولوشن تعیین‌شده در پایین، با حفظ نسبت تصویر.

  • Limit Resolution (limit)
    محدود کردن عرض و ارتفاع به مقدار مشخص‌شده. اگر یکی از ابعاد از حد مجاز بیشتر باشد، تصویر با حفظ نسبت، کوچک می‌شود.

  • Custom Resolution (custom)
    فعال‌سازی پارامتر Resolution برای کنترل مستقیم عرض و ارتفاع.

Resolution (resolution) ⊞

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

  • W (resolutionw) – عرض

  • H (resolutionh) – ارتفاع

Resolution Menu (resmenu)

منوی کشویی شامل چند رزولوشن رایج.

Use Global Res Multiplier (resmult)

استفاده از Global Resolution Multiplier موجود در
Edit > Preferences > TOPs

این گزینه تمام رزولوشن‌های TOP را در یک ضریب مشخص ضرب می‌کند.
برای مثال اگر پروژه روی سیستم قوی طراحی شده باشد ولی روی لپ‌تاپ با VRAM محدود اجرا شود، می‌توان ضریب را روی نصف یا یک‌چهارم گذاشت تا عملکرد قابل‌قبولی داشته باشد.
با فعال بودن این گزینه، این TOP تحت تأثیر ضریب سراسری قرار می‌گیرد.

Output Aspect (outputaspect) ⊞

تنظیم نسبت تصویر خروجی، برای نمایش تکسچرها در هر اندازه‌ای.
هنگام کامپوزیت TOPهایی با نسبت تصویر متفاوت، مراقب نتایج غیرمنتظره باشید.

  • Use Input (useinput)
    استفاده از نسبت تصویر ورودی.

  • Resolution (resolution)
    استفاده از نسبت تصویر بر اساس رزولوشن تعریف‌شده (مثلاً 512×256 یعنی 2:1).

  • Custom Aspect (custom)
    تعریف دستی نسبت تصویر در پارامتر Aspect.

Aspect (aspect) ⊞

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

  • Aspect1 (aspect1)

  • Aspect2 (aspect2)

Aspect Menu (armenu)

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

Input Smoothness (inputfiltertype) ⊞

کنترل فیلتر پیکسلی تصویر ورودی TOP.

  • Nearest Pixel (nearest)
    استفاده از نزدیک‌ترین پیکسل؛ تصویر در بزرگ‌نمایی‌های غیر Native دندانه‌دار دیده می‌شود.

  • Interpolate Pixels (linear)
    فیلتر خطی بین پیکسل‌ها؛ برای نمایش نرم تصویر در زوم‌های مختلف.

  • Mipmap Pixels (mipmap)
    استفاده از mipmap هنگام تغییر مقیاس؛ کاهش آرتیفکت و لرزش در تصاویر پرجزئیات.

Fill Viewer (fillmode) ⊞

نحوه نمایش تصویر TOP در Viewer.

نکته:
برای درک بهتر عملکرد TOPها، هنگام شروع کار این گزینه را روی Native Resolution بگذارید.

  • Use Input (useinput)
    استفاده از تنظیمات Fill Viewer ورودی.

  • Fill (fill)
    کشیدن تصویر تا لبه‌های Viewer.

  • Fit Horizontal (width)
    تطبیق افقی تصویر با Viewer.

  • Fit Vertical (height)
    تطبیق عمودی تصویر با Viewer.

  • Fit Best (best)
    تغییر مقیاس بدون برش تصویر.

  • Fit Outside (outside)
    پر کردن Viewer با حفظ نسبت تصویر (ممکن است برش ایجاد شود).

  • Native Resolution (nativeres)
    نمایش تصویر با رزولوشن واقعی.

Viewer Smoothness (filtertype) ⊞

کنترل فیلتر پیکسلی در Viewer.

  • Nearest Pixel

  • Interpolate Pixels

  • Mipmap Pixels

Passes (npasses)

تکرار عملیات TOP به تعداد مشخص‌شده.
اگر مقدار بیشتر از 1 باشد، خروجی هر مرحله دوباره به ورودی اول نود فرستاده می‌شود و فرآیند تکرار می‌گردد.

Channel Mask (chanmask)

انتخاب کانال‌هایی که TOP روی آن‌ها اعمال می‌شود (R، G، B، A).
به‌صورت پیش‌فرض همه فعال هستند.

Pixel Format (format) ⊞

فرمت ذخیره داده برای هر کانال تصویر.
(برای جزئیات بیشتر به Pixel Formats مراجعه کنید)

  • Use Input

  • RGBA 8-bit fixed

  • sRGB 8-bit fixed

  • RGBA 16-bit float

  • RGBA 32-bit float

  • RGB10A2 fixed

  • RGBA 16-bit fixed

  • RGBA11 float (RGB فقط، بدون آلفا واقعی)

  • RGB 16-bit float

  • RGB 32-bit float

  • Mono 8/16-bit fixed & float

  • RG 8/16/32-bit

  • Alpha-only formats

  • Mono + Alpha formats

(تمام توضیحات هر فرمت دقیقاً مطابق متن اصلی حفظ شده‌اند)

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

Input 0: –

کانال‌های Info CHOP

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

کانال‌های مشترک اپراتور (Common Operator Info Channels)

  • total_cooks – تعداد دفعات Cook شدن اپراتور از شروع.

  • cook_time – مدت زمان آخرین Cook (میلی‌ثانیه).

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

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

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

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

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

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

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