Video Stream In TOP

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

خلاصه (Summary)

Video Stream In TOP یک کلاینت ایجاد می‌کند تا ویدئو و صدا را از طریق شبکه از منابع با پروتکل‌های RTSP، HLS، یا SRT دریافت کند؛ یا از یک همتای WebRTC از طریق WebRTC DAT.

آدرس URL برای اتصال به سرور RTSP به شکل زیر است:

مثال:

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

دسترسی به جریان‌های HLS/DASH از طریق URLهایی که به فایل‌های m3u8 اشاره دارند.

دسترسی به جریان‌ها با پروتکل SRT (Secure Reliable Transport) با URLهایی به شکل srt:// امکان‌پذیر است. برای اطلاعات بیشتر در مورد URLهای SRT به Video Stream Out TOP مراجعه کنید.

SRT ارسال شده در Video Stream In TOP می‌تواند شامل متادیتای هر فریم باشد که امکان ارسال و دریافت داده‌های CHOP/DAT همزمان با ویدئو را آسان می‌کند. می‌توان یک Info DAT به این TOP متصل کرد.

کدک‌های ویدئویی قابل پخش از طریق SRT عبارتند از: H.264 و H.265.

برای پروتکل‌های دیگر روی IP، به NDI (Network Data Interface) و Touch Out TOP / Touch In TOP مراجعه کنید.

نکته برای ویندوز: اگر با مشکل اتصال مواجه شدید، مطمئن شوید که فایروال ویندوز غیرفعال است.

PythonIcon.png
videostreaminTOP_Class

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

Summary
Parameters – Play Page
Parameters – Image Page
Parameters – Tune Page
Parameters – WebRTC Page
Parameters – Common Page
Info CHOP Channels
  7.1 Specific Video Stream In TOP Info Channels
  7.2 Common TOP Info Channels
  7.3 Common Operator Info Channels

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

Active (active)
زمانی که روی 1 قرار گیرد، TOP جریان تصویر را از URL مشخص‌شده دریافت می‌کند.

Mode (mode) – ⊞
انتخاب حالت: Server (برای URLهای RTSP، HLS یا SRT) یا WebRTC.

Server (server)
استفاده از منبع سرور RTSP، HLS یا SRT.

WebRTC (webrtc)
استفاده از همتای WebRTC به عنوان منبع.

Server URL (url)
آدرس جریان، جزئیات را در خلاصه ببینید.

Reload (reload)
بازخوانی جریان با تلاش برای اتصال مجدد.

Reload Pulse (reloadpulse)
فعال‌سازی بازخوانی بلافاصله بعد از آزاد شدن دکمه (button-up). در پایتون از متد pulse() قابل دسترسی است.

Play (play)
وقتی Play = On، جریان پخش می‌شود و وقتی Off است، متوقف می‌شود.

Force Re-buffer (forcerebuffer)
اجبار جریان برای بافر مجدد در صورت امکان.

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

Deinterlace (deinterlace) – ⊞
برای فیلم‌هایی که به صورت فیلد ذخیره شده‌اند، هر تصویر از دو تصویر در هم تنیده تشکیل شده است. یک فیلم 30 فریم بر ثانیه شامل 60 فیلد بر ثانیه است.

راه‌های Video Stream In TOP برای مدیریت این:

Off – خروجی بدون تغییر
Even – استفاده از خطوط اسکن زوج و ایجاد خطوط فرد با میان‌یابی
Odd – استفاده از خطوط اسکن فرد و ایجاد خطوط زوج با میان‌یابی
Bob (Split) – تولید 60 تصویر در ثانیه برای فیلم 30 فریم بر ثانیه. ابتدا تصویر زوج، سپس تصویر فرد. بهترین نرم‌نمایی زمانی را دارد.

Field Precedence (precedence) – ⊞
تعیین ترتیب استخراج فیلدها: زوج اول یا فرد اول.

Bottom Half is Alpha (AAA) (bottomhalfalpha)
روش رمزگذاری آلفا در فرمت‌های RGB-only مانند H.264. نیمه پایین تصویر به کانال آلفا منتقل می‌شود و ارتفاع تصویر نصف می‌شود.

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

Pre-Read Frames (prereadframes)
تعیین تعداد فریم‌هایی که TouchDesigner پیشاپیش می‌خواند و در حافظه نگه می‌دارد.

Video Buffer Frames (videobufferframes)
تعداد فریم‌های بافر ویدئو برای خواندن روان جریان.

Max Decode CPUs (maxdecodecpus)
حداکثر تعداد CPU برای دیکد کردن کدک‌های چند-CPU مانند H.264.

Network Buffer Size (KB) (networkbuffersize)
اندازه بافر ورودی شبکه بر حسب کیلوبایت.

Network Queue Size (4KB Each) (networkqueuesize)
تعداد بخش‌های 4KB اختصاص داده شده به صف شبکه.

Disable Buffering (disablebuffering)
غیرفعال کردن بافرینگ شبکه.

Hardware Decode (hwdecode)
فعال‌سازی دیکدینگ سخت‌افزاری روی GPUهای Nvidia.

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

WebRTC DAT (webrtc)
تنظیم WebRTC DAT برای دریافت جریان ویدئو. با این کار منوی WebRTC Connection خودکار پر می‌شود.

WebRTC Connection (webrtcconnection)
انتخاب اتصال همتا به همتا WebRTC. انتخاب این مورد منوی WebRTC Track را پر می‌کند.

WebRTC Track (webrtctrack)
انتخاب مسیر ویدئو در اتصال همتا به همتا WebRTC.

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

Output Resolution (outputresolution) – ⊞
تغییر سریع رزولوشن داده‌های TOP.

گزینه‌ها:

Use Input – استفاده از رزولوشن ورودی
Eighth, Quarter, Half, 2X, 4X, 8X – ضرب رزولوشن ورودی در این مقدار
Fit Resolution – تغییر رزولوشن ورودی برای تطبیق با این رزولوشن با حفظ نسبت ابعاد
Limit Resolution – محدود کردن رزولوشن ورودی تا این حد
Custom Resolution – کنترل مستقیم عرض و ارتفاع

Resolution (resolution) – ⊞
فعال فقط زمانی که Resolution روی Custom قرار دارد.

Resolution Menu (resmenu)
منوی کشویی با رزولوشن‌های متداول.

Use Global Res Multiplier (resmult)
استفاده از ضریب جهانی رزولوشن برای تمام TOPها.

Output Aspect (outputaspect) – ⊞
تنظیم نسبت تصویر برای نمایش با هر اندازه.

Aspect (aspect) – ⊞
استفاده زمانی که Output Aspect روی Custom است.

Aspect Menu (armenu)
منوی کشویی با نسبت‌های متداول.

Input Smoothness (inputfiltertype) – ⊞
کنترل فیلتر پیکسل روی تصویر ورودی.

Fill Viewer (fillmode) – ⊞
نحوه نمایش تصویر در Viewer.

Viewer Smoothness (filtertype) – ⊞
کنترل فیلتر پیکسل در Viewer.

Passes (npasses)
تکرار عملیات TOP به تعداد مشخص.

Channel Mask (chanmask)
انتخاب کانال‌های فعال (R, G, B, A).

Pixel Format (format) – ⊞
فرمت ذخیره داده هر کانال. شامل گزینه‌های متنوع:

8/16/32-bit RGBA, RGB, Mono, RG, Alpha, Mono+Alpha، با فرمت ثابت یا float

کانال‌های Info CHOP

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

frame_time
file_resx
file_resy
odd_field
connections_lost
connections_failed
num_pre_read_frames
last_frame_network_read_time
last_frame_decode_time
last_gpu_upload_time
connected
connecting
connection_failed
hardware_yuv_to_rgb
network_mbit_rate

کانال‌های عمومی 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 – تعداد خطاها