خلاصه (Summary)

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

اپراتور Ncam TOP می‌تواند داده‌های تصویری را از یک سیستم رهگیری خارجی Ncam Reality دریافت کند تا در تولید مجازی (Virtual Production) استفاده شود.
برای دریافت داده، این TOP باید به یک Ncam CHOP ارجاع داده شود که به سرور Ncam متصل است. نوع تصویری که در TOP نمایش داده می‌شود از طریق پارامتر Output انتخاب می‌گردد. بسته به تنظیمات سرور، ممکن است چندین جریان تصویری (Image Stream) در دسترس باشد و می‌توان با استفاده از چند Ncam TOP به بیش از یک جریان به‌صورت هم‌زمان دسترسی داشت.

جریان‌های تصویری ممکن شامل تصویر اصلی فیلم‌برداری‌شده توسط دوربین فیزیکی، نقشه‌ی اعوجاج لنز (Lens Distortion Map) و تصویر عمق (Depth Image) هستند.
نقشه‌ی اعوجاج لنز یک تصویر ۳۲ بیتی ممیز شناور (32-bit Float) است که در آن کانال‌های R و G شامل مختصات مکانی هستند که داده‌ی رنگ هر پیکسل باید از آن نمونه‌برداری شود. این نقشه برای وارپ (Warp) کردن تصویر رندرشده استفاده می‌شود تا با ویژگی‌های اپتیکی تصویری که توسط یک لنز فیزیکی ثبت شده مطابقت پیدا کند.

نقشه‌ی اعوجاج لنز را می‌توان با اتصال یک TOP شامل محتوای رندرشده به ورودی Ncam TOP و تنظیم پارامتر Output روی حالت Distort Input به تصویر اعمال کرد.
همچنین می‌توان محتوای رندرشده را اعوجاج داد و با استفاده از گزینه Composite روی تصویر فیلم ترکیب (کامپوزیت) کرد.

PythonIcon.png
ncamTOP_Class

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

  1. خلاصه

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

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

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

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

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

Active (active)

با خاموش کردن این پارامتر، دریافت داده‌ی تصویری از سرور Ncam متوقف می‌شود.
سرور Ncam فقط جریان‌های تصویری‌ای را ارسال می‌کند که توسط TOPهای فعال درخواست شده‌اند.
غیرفعال کردن TOP باعث غیرفعال شدن CHOP نمی‌شود.

Ncam CHOP (chop)

لینک به Ncam CHOP که به سرور Ncam متصل است.
وجود یک Ncam CHOP برای دریافت هرگونه داده توسط TOP الزامی است، اما چند TOP می‌توانند به یک CHOP مشترک متصل باشند.

Output (output) ⊞

مشخص می‌کند این TOP چه نوع خروجی‌ای تولید کند.
برخی حالت‌ها مانند Composite و Distort Input به یک تصویر ورودی از TOP دیگر نیاز دارند.
همه‌ی جریان‌های تصویری ممکن است از طرف سرور Ncam در دسترس نباشند؛ اگر جریانی موجود نباشد، TOP خطا تولید می‌کند.

  • Composite (composite)
    نقشه‌ی اعوجاج لنز را روی تصویر ورودی اعمال می‌کند و سپس آن را با استفاده از آلفای تصویر ورودی به‌عنوان ماسک، روی تصویر فیلم (Film Stream) ترکیب می‌کند.

  • Distort Input (distort)
    اعوجاج لنز را فقط روی تصویر ورودی اعمال می‌کند.

  • Distort Passthrough (distort_passthrough)
    نقشه‌ی اعوجاج خام را خروجی می‌دهد. این نقشه می‌تواند به‌صورت جداگانه با استفاده از Lookup TOP یا GLSL TOP برای اعوجاج تصویر استفاده شود.

  • Film Passthrough (film_passthrough)
    تصویر خام فیلم ضبط‌شده توسط دوربین فیزیکی را خروجی می‌دهد.

  • Depth Passthrough (depth_passthrough)
    تصویر عمق خام محاسبه‌شده توسط سیستم Ncam Reality را خروجی می‌دهد.

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

Output Resolution (outputresolution) ⊞

تغییر سریع رزولوشن خروجی TOP:

  • Use Input – استفاده از رزولوشن ورودی

  • Eighth / Quarter / Half / 2X / 4X / 8X – ضرب رزولوشن ورودی در مقدار انتخاب‌شده

  • Fit Resolution – افزایش یا کاهش رزولوشن ورودی با حفظ نسبت تصویر

  • Limit Resolution – محدود کردن رزولوشن ورودی بدون تغییر نسبت تصویر

  • Custom Resolution – کنترل مستقیم عرض و ارتفاع

Resolution (resolution) ⊞

فقط در حالت Custom فعال است:

  • W (resolutionw) – عرض

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

Resolution Menu (resmenu)

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

Use Global Res Multiplier (resmult)

استفاده از ضریب رزولوشن سراسری موجود در
Edit > Preferences > TOPs
برای تطبیق پروژه با سخت‌افزارهای ضعیف‌تر.

Output Aspect (outputaspect) ⊞

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

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

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

  • Custom Aspect – تعریف نسبت تصویر دلخواه

Aspect (aspect) ⊞

در حالت Custom Aspect استفاده می‌شود:

  • Aspect1 (aspect1)

  • Aspect2 (aspect2)

Aspect Menu (armenu)

نسبت‌های تصویر رایج.

Input Smoothness (inputfiltertype) ⊞

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

  • Nearest Pixel – نزدیک‌ترین پیکسل (لبه‌دار در زوم‌های غیر Native)

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

  • Mipmap Pixels – کاهش نویز و لرزش در تصاویر پرجزئیات متحرک

Fill Viewer (fillmode) ⊞

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

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

  • Use Input – استفاده از تنظیمات Viewer ورودی

  • Fill – کشیدن تصویر برای پر کردن کامل Viewer

  • Fit Horizontal – تطبیق افقی

  • Fit Vertical – تطبیق عمودی

  • Fit Best – بدون برش تصویر

  • Fit Outside – پر کردن Viewer با احتمال برش

  • Native Resolution – نمایش رزولوشن واقعی تصویر

Viewer Smoothness (filtertype) ⊞

کنترل فیلتر پیکسلی Viewer.
نکته: اگر ورودی 32-bit float باشد، فقط حالت Nearest استفاده می‌شود، فارغ از انتخاب کاربر.

Passes (npasses)

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

Channel Mask (chanmask)

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

Pixel Format (format) ⊞

فرمت ذخیره‌سازی داده‌ی هر کانال تصویر.
(شامل RGBA، RGB، Mono، RG، Alpha و ترکیبات آن‌ها در حالت‌های 8، 16 و 32 بیت Fixed یا Float)

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

  • Input 0: —

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

اطلاعات تکمیلی Ncam TOP از طریق Info CHOP در دسترس است.

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

  • resx – رزولوشن افقی

  • resy – رزولوشن عمودی

  • aspectx – نسبت افقی

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

  • depth – عمق آرایه‌ی تکسچرهای 2D یا 3D

  • gpu_memory_used – میزان حافظه‌ی گرافیکی مصرف‌شده

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

  • total_cooks – تعداد دفعات Cook

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

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

  • cook_abs_frame – شماره فریم مطلق

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

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

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

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

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