خلاصه (Summary)

اپراتور MPCDI TOP به شما اجازه می‌دهد داده‌های کالیبراسیون ذخیره‌شده در فرمت MPCDI را بارگذاری کنید. برای راهنمای کامل درباره‌ی نحوه‌ی یکپارچه‌سازی TouchDesigner با استاندارد MPCDI، لطفاً به مدخل MPCDI مراجعه کنید.

برای استفاده از اطلاعات دوربین موجود در فایل پیکربندی، از اعضای پایتونی projection و cameraTransform این نود در یک Camera COMP استفاده کنید.

PythonIcon.png
mpcdiTOP_Class

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

  1. خلاصه

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

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

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

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

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

Configuration File (file)

محل فایل .mpcdi را مشخص می‌کند.

Reload Pulse (reloadpulse)

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

Output by (outputformat) ⊞

این منو تعیین می‌کند نواحی خروجی چگونه چیده شوند: به‌صورت تکی یا شبکه‌ای.

  • Single Region (single) – یک ناحیه‌ی تکی

  • Grid Rows (gridrows) – شبکه بر اساس ردیف‌ها

  • Grid Columns (gridcols) – شبکه بر اساس ستون‌ها

Buffer ID (bufferid)

شناسه‌ی بافری که خروجی از آن گرفته می‌شود.

Region ID (regionid)

شناسه‌ی ناحیه‌ای که خروجی داده می‌شود.

Layout Grid Size (layoutmax) ⊞

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

  • layoutmaxw – حداکثر عرض شبکه

  • layoutmaxh – حداکثر ارتفاع شبکه

Near (near)

مقدار near (نزدیک‌ترین فاصله‌ی برش دوربین) را تنظیم می‌کند.

Far (far)

مقدار far (دورترین فاصله‌ی برش دوربین) را تنظیم می‌کند.

Alpha Beta Blending (alphabeta)

فعال/غیرفعال‌سازی ترکیب Alpha-Beta Blending.

Gamma Encoding (gamma)

فعال/غیرفعال‌سازی Gamma Encoding.

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

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) ⊞

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

  • W (resolutionw) – عرض

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

Resolution Menu (resmenu)

منوی کشویی شامل رزولوشن‌های رایج.

Use Global Res Multiplier (resmult)

از Global Resolution Multiplier موجود در مسیر
Edit > Preferences > TOPs
استفاده می‌کند. این گزینه رزولوشن تمام TOPها را در یک ضریب مشخص ضرب می‌کند. این قابلیت هنگام کار روی سیستم‌هایی با توان سخت‌افزاری متفاوت بسیار مفید است.
مثلاً اگر پروژه روی یک ورک‌استیشن قوی طراحی شده باشد، کاربری با لپ‌تاپ و فقط 64MB حافظه‌ی گرافیکی می‌تواند ضریب را روی نصف یا یک‌چهارم بگذارد تا پروژه با سرعت قابل قبول اجرا شود. با فعال بودن این گزینه، این TOP تحت تأثیر ضریب جهانی قرار می‌گیرد.

Output Aspect (outputaspect) ⊞

تنظیم نسبت تصویر خروجی برای نمایش تکسچرها در هر اندازه‌ای. هنگام ترکیب TOPهایی با نسبت تصویر متفاوت، مراقب نتایج غیرمنتظره باشید.
(می‌توان تصاویر با پیکسل‌های غیرمربعی تعریف کرد با استفاده از xres، yres، aspectx و aspecty در حالتی که xres/yres ≠ aspectx/aspecty باشد.)

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

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

  • Custom Aspect (custom) – تعریف دستی نسبت تصویر

Aspect (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 (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 (nearest) – نمایش دقیق پیکسل‌ها (دندانه‌دار در زوم‌های غیر Native)

  • Interpolate Pixels (linear) – فیلتر خطی برای نمایش نرم‌تر

  • Mipmap Pixels (mipmap) – کاهش آرتیفکت و لرزش در اسکیل

Passes (npasses)

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

Channel Mask (chanmask)

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

Pixel Format (format) ⊞

فرمت ذخیره‌سازی داده برای هر کانال تصویر (R، G، B، A). برای اطلاعات بیشتر به بخش Pixel Formats مراجعه کنید.

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

  • Input 0: —

کانال‌های Info CHOP (Info CHOP Channels)

اطلاعات تکمیلی مربوط به MPCDI TOP از طریق یک Info CHOP قابل دسترسی است.

کانال‌های اطلاعات عمومی TOP

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

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

  • aspectx – نسبت افقی تصویر

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

  • depth – عمق آرایه‌ی 2D یا 3D در صورت استفاده

  • gpu_memory_used – میزان حافظه‌ی گرافیکی مصرف‌شده توسط این TOP

کانال‌های اطلاعات عمومی اپراتور

  • total_cooks – تعداد دفعاتی که اپراتور از شروع پروژه Cook شده است

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

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

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

  • cook_start_time – زمان شروع Cook (میلی‌ثانیه)

  • cook_end_time – زمان پایان Cook (میلی‌ثانیه)

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

  • warnings – تعداد هشدارهای اپراتور (در صورت وجود)

  • errors – تعداد خطاهای اپراتور (در صورت وجود)