History

lavd: implement NewTek NDI input/output device support

Maksym Veremeyenko committed 9 years ago

Commit 26349271 parent 84ee65110 files · +779 −2Browse files

Showing the changes to doc (2 of 10 files). Show all

Unified · Split

2 files
  1. doc/indevs.texi +48 −0
  2. doc/outdevs.texi +45 −0
doc/indevs.texi+48−0
@@ -332,6 +332,54 @@ ffmpeg -channels 16 -format_code Hi50 -f decklink -i 'UltraStudio Mini Recorder' · 331 unmodified lines
332332
333333 @end itemize
334334
335+@section libndi_newtek
336+
337+The libndi_newtek input device provides capture capabilities for using NDI (Network
338+Device Interface, standard created by NewTek).
339+
340+Input filename is a NDI source name that could be found by sending -find_sources 1
341+to command line - it has no specific syntax but human-readable formatted.
342+
343+To enable this input device, you need the NDI SDK and you
344+need to configure with the appropriate @code{--extra-cflags}
345+and @code{--extra-ldflags}.
346+
347+@subsection Options
348+
349+@table @option
350+
351+@item find_sources
352+If set to @option{true}, print a list of found/available NDI sources and exit.
353+Defaults to @option{false}.
354+
355+@item wait_sources
356+Override time to wait until the number of online sources have changed.
357+Defaults to @option{0.5}.
358+
359+@item allow_video_fields
360+When this flag is @option{false}, all video that you receive will be progressive.
361+Defaults to @option{true}.
362+
363+@end table
364+
365+@subsection Examples
366+
367+@itemize
368+
369+@item
370+List input devices:
371+@example
372+ffmpeg -f libndi_newtek -find_sources 1 -i dummy
373+@end example
374+
375+@item
376+Restream to NDI:
377+@example
378+ffmpeg -f libndi_newtek -i "DEV-5.INTERNAL.M1STEREO.TV (NDI_SOURCE_NAME_1)" -f libndi_newtek -y NDI_SOURCE_NAME_2
379+@end example
380+
381+@end itemize
382+
335383 @section dshow
336384
337385 Windows DirectShow input device.
doc/outdevs.texi+45−0
@@ -182,6 +182,51 @@ ffmpeg -i test.avi -f decklink -pix_fmt uyvy422 -s 720x486 -r 24000/1001 'DeckLi · 181 unmodified lines
182182
183183 @end itemize
184184
185+@section libndi_newtek
186+
187+The libndi_newtek output device provides playback capabilities for using NDI (Network
188+Device Interface, standard created by NewTek).
189+
190+Output filename is a NDI name.
191+
192+To enable this output device, you need the NDI SDK and you
193+need to configure with the appropriate @code{--extra-cflags}
194+and @code{--extra-ldflags}.
195+
196+NDI uses uyvy422 pixel format natively, but also supports bgra, bgr0, rgba and
197+rgb0.
198+
199+@subsection Options
200+
201+@table @option
202+
203+@item reference_level
204+The audio reference level in dB. This specifies how many dB above the
205+reference level (+4dBU) is the full range of 16 bit audio.
206+Defaults to @option{0}.
207+
208+@item clock_video
209+These specify whether video "clock" themselves.
210+Defaults to @option{false}.
211+
212+@item clock_audio
213+These specify whether audio "clock" themselves.
214+Defaults to @option{false}.
215+
216+@end table
217+
218+@subsection Examples
219+
220+@itemize
221+
222+@item
223+Play video clip:
224+@example
225+ffmpeg -i "udp://@@239.1.1.1:10480?fifo_size=1000000&overrun_nonfatal=1" -vf "scale=720:576,fps=fps=25,setdar=dar=16/9,format=pix_fmts=uyvy422" -f libndi_newtek NEW_NDI1
226+@end example
227+
228+@end itemize
229+
185230 @section fbdev
186231
187232 Linux framebuffer output device.

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t