X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=doc%2Findevs.texi;h=f4a5779fccf12a1a2cdec7b0a901dc9488c593e2;hb=2fd9ce92af43e6dcbc8ed7c26c00b052de48ccad;hp=ae61331a6f580b9438bd208892e4a6e5d5ca74a7;hpb=be023405a7cdbdd6b5d163de8beb1968ee4ef52e;p=ffmpeg diff --git a/doc/indevs.texi b/doc/indevs.texi index ae61331a6f5..f4a5779fccf 100644 --- a/doc/indevs.texi +++ b/doc/indevs.texi @@ -627,20 +627,47 @@ ffmpeg -f lavfi -i "movie=test.ts[out0+subcc]" -map v frame%08d.png -map s -c co @section libcdio -Audio-CD input device based on cdio. +Audio-CD input device based on libcdio. To enable this input device during configuration you need libcdio -installed on your system. Requires the configure option +installed on your system. It requires the configure option @code{--enable-libcdio}. This device allows playing and grabbing from an Audio-CD. -For example to copy with @command{ffmpeg} the entire Audio-CD in /dev/sr0, +For example to copy with @command{ffmpeg} the entire Audio-CD in @file{/dev/sr0}, you may run the command: @example ffmpeg -f libcdio -i /dev/sr0 cd.wav @end example +@subsection Options +@table @option +@item speed +Set drive reading speed. Default value is 0. + +The speed is specified CD-ROM speed units. The speed is set through +the libcdio @code{cdio_cddap_speed_set} function. On many CD-ROM +drives, specifying a value too large will result in using the fastest +speed. + +@item paranoia_mode +Set paranoia recovery mode flags. It accepts one of the following values: + +@table @samp +@item disable +@item verify +@item overlap +@item neverskip +@item full +@end table + +Default value is @samp{disable}. + +For more information about the available recovery modes, consult the +paranoia project documentation. +@end table + @section libdc1394 IIDC1394 input device, based on libdc1394 and libraw1394. @@ -975,8 +1002,12 @@ other filename will be interpreted as device number 0. X11 video input device. -Depends on X11, Xext, and Xfixes. Requires the configure option -@code{--enable-x11grab}. +To enable this input device during configuration you need libxcb +installed on your system. It will be automatically detected during +configuration. + +Alternatively, the configure option @option{--enable-x11grab} exists +for legacy Xlib users. This device allows one to capture a region of an X11 display. @@ -994,10 +1025,12 @@ omitted, and defaults to "localhost". The environment variable area with respect to the top-left border of the X11 screen. They default to 0. -Check the X11 documentation (e.g. man X) for more detailed information. +Check the X11 documentation (e.g. @command{man X}) for more detailed +information. -Use the @command{dpyinfo} program for getting basic information about the -properties of your X11 display (e.g. grep for "name" or "dimensions"). +Use the @command{xdpyinfo} program for getting basic information about +the properties of your X11 display (e.g. grep for "name" or +"dimensions"). For example to grab from @file{:0.0} using @command{ffmpeg}: @example @@ -1046,6 +1079,10 @@ If @var{show_region} is specified with @code{1}, then the grabbing region will be indicated on screen. With this option, it is easy to know what is being grabbed if only a portion of the screen is grabbed. +@item region_border +Set the region border thickness if @option{-show_region 1} is used. +Range is 1 to 128 and default is 3 (XCB-based x11grab only). + For example: @example ffmpeg -f x11grab -show_region 1 -framerate 25 -video_size cif -i :0.0+10,20 out.mpg @@ -1061,7 +1098,8 @@ Set the video frame size. Default value is @code{vga}. @item use_shm Use the MIT-SHM extension for shared memory. Default value is @code{1}. -It may be necessary to disable it for remote displays. +It may be necessary to disable it for remote displays (legacy x11grab +only). @end table @section decklink