X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=doc%2Findevs.texi;h=1d5ed657735a59040e89a196837c4c08fbd91314;hb=c2771bbf815bd7d0ff273ba590b7db02a303399f;hp=5d4c02c597460d77ef670c629500294755dc49af;hpb=26148e923613e718787c6fc4bf3f64e8909f597c;p=ffmpeg diff --git a/doc/indevs.texi b/doc/indevs.texi index 5d4c02c5974..1d5ed657735 100644 --- a/doc/indevs.texi +++ b/doc/indevs.texi @@ -267,7 +267,8 @@ audio track. @item list_devices If set to @option{true}, print a list of devices and exit. -Defaults to @option{false}. +Defaults to @option{false}. Alternatively you can use the @code{-sources} +option of ffmpeg to list the available input devices. @item list_formats If set to @option{true}, print a list of supported formats and exit. @@ -370,6 +371,20 @@ If set to @option{true}, timestamps are forwarded as they are without removing the initial offset. Defaults to @option{false}. +@item timestamp_align +Capture start time alignment in seconds. If set to nonzero, input frames are +dropped till the system timestamp aligns with configured value. +Alignment difference of up to one frame duration is tolerated. +This is useful for maintaining input synchronization across N different +hardware devices deployed for 'N-way' redundancy. The system time of different +hardware devices should be synchronized with protocols such as NTP or PTP, +before using this option. +Note that this method is not foolproof. In some border cases input +synchronization may not happen due to thread scheduling jitters in the OS. +Either sync could go wrong by 1 frame or in a rarer case +@option{timestamp_align} seconds. +Defaults to @samp{0}. + @end table @subsection Examples @@ -772,7 +787,7 @@ ffplay -f iec61883 -i auto Grab and record the input of a FireWire DV/HDV device, using a packet buffer of 100000 packets if the source is HDV. @example -ffmpeg -f iec61883 -i auto -hdvbuffer 100000 out.mpg +ffmpeg -f iec61883 -i auto -dvbuffer 100000 out.mpg @end example @end itemize @@ -1035,54 +1050,21 @@ IIDC1394 input device, based on libdc1394 and libraw1394. Requires the configure option @code{--enable-libdc1394}. -@section libndi_newtek - -The libndi_newtek input device provides capture capabilities for using NDI (Network -Device Interface, standard created by NewTek). - -Input filename is a NDI source name that could be found by sending -find_sources 1 -to command line - it has no specific syntax but human-readable formatted. - -To enable this input device, you need the NDI SDK and you -need to configure with the appropriate @code{--extra-cflags} -and @code{--extra-ldflags}. - @subsection Options - @table @option -@item find_sources -If set to @option{true}, print a list of found/available NDI sources and exit. -Defaults to @option{false}. - -@item wait_sources -Override time to wait until the number of online sources have changed. -Defaults to @option{0.5}. +@item framerate +Set the frame rate. Default is @code{ntsc}, corresponding to a frame +rate of @code{30000/1001}. -@item allow_video_fields -When this flag is @option{false}, all video that you receive will be progressive. -Defaults to @option{true}. +@item pixel_format +Select the pixel format. Default is @code{uyvy422}. +@item video_size +Set the video size given as a string such as @code{640x480} or @code{hd720}. +Default is @code{qvga}. @end table -@subsection Examples - -@itemize - -@item -List input devices: -@example -ffmpeg -f libndi_newtek -find_sources 1 -i dummy -@end example - -@item -Restream to NDI: -@example -ffmpeg -f libndi_newtek -i "DEV-5.INTERNAL.M1STEREO.TV (NDI_SOURCE_NAME_1)" -f libndi_newtek -y NDI_SOURCE_NAME_2 -@end example - -@end itemize - @section openal The OpenAL input device provides audio capture on all systems with a