Video Device In TOP

پرش به ناوبری | پرش به جستجو

خلاصه (Summary)

Video Device In TOP برای دریافت ویدئو از دوربین خارجی، کارت کپچر، دانگل کپچر، دوربین IP یا ویدئو دیکودر متصل به سیستم استفاده می‌شود. با استفاده از چندین Device In TOP می‌توان چندین دستگاه را به صورت همزمان به TouchDesigner متصل و ویدئو استریم کرد. ویدئو HD-SDI می‌تواند از طریق کارت‌های کپچر مانند کارت‌های Blackmagic Design، AJA و Deltacast به TouchDesigner منتقل شود.

نکته: اگر دستگاه ویدئویی نشان نمی‌دهد ولی در منوی پارامتر Cameras ظاهر می‌شود، مطمئن شوید که برنامه دیگری در حال استفاده از دستگاه نیست.

TIP: یک Info DAT ایجاد کنید و آن را به Video Device In TOP متصل کنید تا ببینید کدام دستگاه‌ها متصل هستند. Info CHOP داده‌هایی برای بررسی عملکرد Video Device In و Out فراهم می‌کند. همچنین می‌تواند برای دریافت تایم‌کدهای جاسازی‌شده در سیگنال منبع برخی دستگاه‌ها استفاده شود.

سازندگان اصلی کارت‌های کپچر پشتیبانی‌شده:

  • Blackmagic Design – پشتیبانی از Timecode، ویندوز و macOS

  • AJA – پشتیبانی از Timecode، فقط ویندوز و macOS

  • Deltacast – پشتیبانی از Timecode، فقط ویندوز

  • Bluefish444 – فقط ویندوز

همچنین برخی مدل‌های Datapath SDI، Allied Vision، Imaging Development Systems (IDS)، FLIR/Point Grey و Ximea با درایورهای بومی پشتیبانی می‌شوند.

دستگاه‌های AJA و Blackmagic Design از ورودی و خروجی ۱۲ بیتی پشتیبانی می‌کنند، شامل توانایی AJA برای ضبط با ۱۲-bit RGB 4:4:4 کامل.

برای کپچر HDMI به USB3 با Magewell (توصیه‌شده، بدون نیاز به درایور، plug-and-play) به Magewell مراجعه کنید.

دوربین‌های IP و USB3 شامل مدل‌های زیر هستند:

  • Allied Vision – فقط مدل‌های PvAPI SDK، سری Prosilica و دوربین‌های Manta. ویندوز فقط.

  • Point Grey FLIR – Flycapture2 و Spinnaker، ویندوز فقط.

  • IDS – TouchDesigner از uEye IDS Software Suite و Peak SDK پشتیبانی می‌کند. دوربین‌های GigE Vision فعلاً پشتیبانی نمی‌شوند.

  • Ximea – ویندوز فقط.

تنها یک زیرمجموعه کوچک از دوربین‌ها تست شده‌اند، اما انتظار می‌رود هر دوربین مدرن از سازندگان پشتیبانی‌شده کار کند. در صورت بروز مشکل با support@derivative.ca تماس بگیرید.

به Video Device Out TOP نیز مراجعه کنید.

PythonIcon.png
videodeviceinTOP_Class

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

  1. Summary

  2. Parameters – Video In Page

  3. Parameters – Options Page

  4. Parameters – Common Page

  5. Info CHOP Channels
      5.1 Specific Video Device In TOP Info Channels
      5.2 Common TOP Info Channels
      5.3 Common Operator Info Channels

پارامترها – صفحه Video In

Active (active)
وقتی فعال شود، TOP جریان تصویر از دوربین یا دیکودر را دریافت می‌کند.

Driver (driver) – ⊞
کتابخانه‌ای که برای ارتباط با دوربین‌ها استفاده می‌شود را انتخاب کنید.

Device (device) – ⊞
دوربین یا دیکودری که می‌خواهید استفاده کنید انتخاب کنید.

Specify IP (specifyip)
در صورت استفاده از کتابخانه Allied Vision، آدرس IP دوربین را مشخص می‌کند.

IP (ip)
آدرس IP مورد استفاده وقتی Specify IP فعال باشد.

Options (options)
پنل گزینه‌ها یا کنترل دوربین را باز می‌کند. توجه: فقط برای دوربین‌های DirectShow (WDM) کاربرد دارد.

Deinterlace (deinterlace) – ⊞
تعیین فیلدهایی که نمایش داده می‌شوند.

Field Precedence (precedence) – ⊞
در روش Bob (Split) deinterlacing، مشخص می‌کند کدام فیلد ابتدا نمایش داده شود.

TV Channel (channel)
کانال تلویزیونی در صورت استفاده از TV tuner به عنوان ورودی ویدئو.

Signal Format (signalformat)
فرمت سیگنال ورودی شامل رزولوشن، نرخ فریم و نوع progressive یا interlaced. توجه: در حالت interlaced نرخ مربوط به فیلد در ثانیه است.

Quad Link (quadlink)
برای کارت‌های پشتیبانی‌کننده از Quad-link. این روش ۴ ورودی را ترکیب می‌کند تا یک ورودی بزرگ‌تر ایجاد شود (مثلاً ۴ ورودی 1080p به یک ورودی 4K).

Input Pixel Format (inputpixelformat) – ⊞
برخی دستگاه‌ها فرمت پیکسل‌های غیر از ۸ بیت را پشتیبانی می‌کنند (مثلاً Blackmagic Design).

Input Color Space (inputcolorspace) – ⊞
کنترل فضای رنگ ورودی، که هنگام ارسال به GPU به Working Color Space تبدیل می‌شود.

Input Reference White (inputreferencewhite) – ⊞
کنترل نحوه تبدیل رنگ ورودی نسبت به Reference White به Working Color Space. مثال: اگر SDR Reference White برابر ۱۲۰ nits و HDR Reference White برابر ۸۰ nits باشد، رنگ (1,1,1) به (1.5,1.5,1.5) در HDR تبدیل می‌شود.

Transfer Mode (transfermode) – ⊞
کنترل نحوه انتقال فریم‌ها از دستگاه به حافظه CPU و از CPU به GPU.

Memory Mode (memorymode) – ⊞
کنترل نوع حافظه برای انتقال داده بین کارت کپچر و GPU.

Sync Inputs (syncinputs)
فعال‌سازی همگام‌سازی چند Video Device In TOP. این ویژگی فقط با Blackmagic، DataPath، Deltacast و BlueFish پشتیبانی می‌شود.

Sync Group Index (syncgroupindex)
تعیین گروه همگام‌سازی که نود باید با آن هماهنگ شود.

Max Sync Offset (ms) (maxsyncoffset)
حداکثر اختلاف زمانی دو تصویر برای درنظر گرفتن همگام بودن، بر حسب میلی‌ثانیه.

Sync Timeout (ms) (synctimeout)
مدت زمان انتظار برای تمام فریم‌های گروه همگام قبل از انصراف، بر حسب میلی‌ثانیه.

Reset Stats (resetstats)
پالس برای ریست آمار Info CHOP متصل.

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

(این گزینه‌ها فعلاً فقط برای دوربین‌های Ximea کاربرد دارند)

  • Preset (preset) – ⊞

  • Auto Gain/Exposure (autoge)

  • Auto Gain/Exposure Bias (autogebias)

  • Auto Gain/Exposure Level (autogelevel)

  • Max Gain (maxgain)

  • Max Exposure (ms) (maxexposure)

  • Gain (gain)

  • Exposure (ms) (exposure)

  • Chromaticity Gamma (cgamma)

  • Luminosity Gamma (lgamma)

  • Limit FPS (limitfps)

  • FPS (limitedfps)

  • Capture (capture)

  • Capture Pulse (capturepulse)

  • Auto White-Balance (autowb)

  • White-Balance Coeffs (wbcoeffs) – ⊞

  • Custom Bandwidth (custombandwidth) – ⊞

  • Bandwidth Limit (Mb/s) (bandwidthlimit)

  • Camera Bit Depth (camerabitdepth) – ⊞

  • GPU Demosaic (gpudemosaic)

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

همانند پارامترهای Common در سایر TOPها:

  • Output Resolution (outputresolution) – ⊞

  • Resolution (resolution) – ⊞

  • Resolution Menu (resmenu)

  • Use Global Res Multiplier (resmult)

  • Output Aspect (outputaspect) – ⊞

  • Aspect (aspect) – ⊞

  • Aspect Menu (armenu)

  • Input Smoothness (inputfiltertype) – ⊞

  • Fill Viewer (fillmode) – ⊞

  • Viewer Smoothness (filtertype) – ⊞

  • Passes (npasses)

  • Channel Mask (chanmask)

  • Pixel Format (format) – ⊞

  • Parameter Color Space (parmcolorspace) – ⊞

  • Parameter Reference White (parmreferencewhite) – ⊞

کانال‌های Info CHOP

کانال‌های خاص Video Device In TOP

  • connected – 1 اگر اتصال موفق به دستگاه برقرار شده باشد، 0 در غیر اینصورت

  • sync_timeouts – تعداد دفعاتی که گروه همگام‌سازی نتوانسته فریم‌ها را با زمان‌بندی مشابه فراهم کند

  • last_sync_wait – مدت زمان انتظار نود برای دریافت فریم‌های معتبر

  • odd_field – 1 وقتی فیلد فرد نمایش داده می‌شود و 0 برای فیلد زوج

  • capture_fps – تعداد فریم در ثانیه واقعی که دستگاه ضبط کرده است

  • capture_total – تعداد کل فریم‌های ضبط‌شده از شروع کپچر

  • frames_repeated – تعداد دفعاتی که یک فریم تکرار شده

  • frames_dropped – تعداد فریم‌هایی که توسط کارت ضبط شدند ولی TouchDesigner نخوانده

  • frames_skipped – تعداد فریم‌هایی که TouchDesigner خوانده ولی نود مصرف نکرده

  • connection_changes – تعداد تغییرات اتصال، همه دستگاه‌ها پشتیبانی نمی‌کنند

  • temperature – دمای دستگاه در درجه سانتی‌گراد، اگر پشتیبانی نشود عدد بسیار منفی

  • signal_fps – نرخ فریم سیگنال ورودی، 0 اگر ناشناخته باشد

  • rgb_input – 1 اگر ورودی RGB باشد، 0 اگر YUV/YCbCr باشد، -1 اگر ناشناخته

  • frame_queue_length – تعداد فریم‌های دریافت‌شده در صف TouchDesigner

  • frame_hw_queue_length – تعداد فریم‌های هنوز خوانده‌نشده روی دستگاه

  • last_dma_copy_time – زمان کپی آخرین فریم از دستگاه به CPU، -1 اگر اندازه‌گیری نشده

  • frame_timestamp – زمان فریم آخر نمایش داده‌شده، -1 اگر ارائه نشده

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

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

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

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

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

  • depth – عمق آرایه 2D یا 3D

  • gpu_memory_used – حافظه GPU مصرفی

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

  • total_cooks – تعداد Cook انجام شده

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

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

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

  • cook_start_time – زمان شروع Cook در آن فریم

  • cook_end_time – زمان پایان Cook در آن فریم

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

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

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