X-Git-Url: https://git.sesse.net/?a=blobdiff_plain;f=doc%2Findevs.texi;h=b0ba6ac9f36a1c36a189ef442ec30e2ace757c51;hb=6aedabc9b68cab7b65833415953e958ac2c77f80;hp=87dee70d30942d96adea5b864cc1e771c28cbdf8;hpb=c4b97fbdfabb9d252a13c9c1f7bc8e1c2e9e43c5;p=ffmpeg diff --git a/doc/indevs.texi b/doc/indevs.texi index 87dee70d309..b0ba6ac9f36 100644 --- a/doc/indevs.texi +++ b/doc/indevs.texi @@ -42,10 +42,10 @@ specify card number or identifier, device number and subdevice number To see the list of cards currently recognized by your system check the files @file{/proc/asound/cards} and @file{/proc/asound/devices}. -For example to capture with @file{ffmpeg} from an ALSA device with +For example to capture with @command{avconv} from an ALSA device with card id 0, you may run the command: @example -ffmpeg -f alsa -i hw:0 alsaout.wav +avconv -f alsa -i hw:0 alsaout.wav @end example For more information see: @@ -72,14 +72,14 @@ For more detailed information read the file Documentation/fb/framebuffer.txt included in the Linux source tree. To record from the framebuffer device @file{/dev/fb0} with -@file{ffmpeg}: +@command{avconv}: @example -ffmpeg -f fbdev -r 10 -i /dev/fb0 out.avi +avconv -f fbdev -r 10 -i /dev/fb0 out.avi @end example You can take a single screenshot image with the command: @example -ffmpeg -f fbdev -vframes 1 -r 1 -i /dev/fb0 screenshot.jpeg +avconv -f fbdev -frames:v 1 -r 1 -i /dev/fb0 screenshot.jpeg @end example See also @url{http://linux-fbdev.sourceforge.net/}, and fbset(1). @@ -109,10 +109,10 @@ To list the JACK clients and their properties you can invoke the command @file{jack_lsp}. Follows an example which shows how to capture a JACK readable client -with @file{ffmpeg}. +with @command{avconv}. @example -# Create a JACK writable client with name "ffmpeg". -$ ffmpeg -f jack -i ffmpeg -y out.wav +# Create a JACK writable client with name "libav". +$ avconv -f jack -i libav -y out.wav # Start the sample jack_metro readable client. $ jack_metro -b 120 -d 0.2 -f 4000 @@ -123,11 +123,11 @@ system:capture_1 system:capture_2 system:playback_1 system:playback_2 -ffmpeg:input_1 +libav:input_1 metro:120_bpm -# Connect metro to the ffmpeg writable client. -$ jack_connect metro:120_bpm ffmpeg:input_1 +# Connect metro to the avconv writable client. +$ jack_connect metro:120_bpm libav:input_1 @end example For more information read: @@ -145,10 +145,10 @@ The filename to provide to the input device is the device node representing the OSS input device, and is usually set to @file{/dev/dsp}. -For example to grab from @file{/dev/dsp} using @file{ffmpeg} use the +For example to grab from @file{/dev/dsp} using @command{avconv} use the command: @example -ffmpeg -f oss -i /dev/dsp /tmp/oss.wav +avconv -f oss -i /dev/dsp /tmp/oss.wav @end example For more information about OSS see: @@ -248,15 +248,15 @@ The filename to provide to the input device is the device node representing the sndio input device, and is usually set to @file{/dev/audio0}. -For example to grab from @file{/dev/audio0} using @file{ffmpeg} use the +For example to grab from @file{/dev/audio0} using @command{avconv} use the command: @example -ffmpeg -f sndio -i /dev/audio0 /tmp/oss.wav +avconv -f sndio -i /dev/audio0 /tmp/oss.wav @end example -@section video4linux and video4linux2 +@section video4linux2 -Video4Linux and Video4Linux2 input video devices. +Video4Linux2 input video device. The name of the device to grab is a file device node, usually Linux systems tend to automatically create such nodes when the device @@ -264,33 +264,19 @@ systems tend to automatically create such nodes when the device kind @file{/dev/video@var{N}}, where @var{N} is a number associated to the device. -Video4Linux and Video4Linux2 devices only support a limited set of +Video4Linux2 devices usually support a limited set of @var{width}x@var{height} sizes and framerates. You can check which are -supported for example with the command @file{dov4l} for Video4Linux -devices and the command @file{v4l-info} for Video4Linux2 devices. +supported using @command{-list_formats all} for Video4Linux2 devices. -If the size for the device is set to 0x0, the input device will -try to autodetect the size to use. -Only for the video4linux2 device, if the frame rate is set to 0/0 the -input device will use the frame rate value already set in the driver. +Some usage examples of the video4linux2 devices with avconv and avplay: -Video4Linux support is deprecated since Linux 2.6.30, and will be -dropped in later versions. - -Follow some usage examples of the video4linux devices with the ff* -tools. @example -# Grab and show the input of a video4linux device, frame rate is set -# to the default of 25/1. -avplay -s 320x240 -f video4linux /dev/video0 - -# Grab and show the input of a video4linux2 device, autoadjust size. -avplay -f video4linux2 /dev/video0 +# Grab and show the input of a video4linux2 device. +avplay -f video4linux2 -framerate 30 -video_size hd720 /dev/video0 -# Grab and record the input of a video4linux2 device, autoadjust size, -# frame rate value defaults to 0/0 so it is read from the video4linux2 -# driver. -ffmpeg -f video4linux2 -i /dev/video0 out.mpeg +# Grab and record the input of a video4linux2 device, leave the +framerate and size as previously set. +avconv -f video4linux2 -input_format mjpeg -i /dev/video0 out.mpeg @end example @section vfwcap @@ -326,12 +312,12 @@ Check the X11 documentation (e.g. man X) for more detailed information. Use the @file{dpyinfo} 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 @file{ffmpeg}: +For example to grab from @file{:0.0} using @command{avconv}: @example -ffmpeg -f x11grab -r 25 -s cif -i :0.0 out.mpg +avconv -f x11grab -r 25 -s cif -i :0.0 out.mpg # Grab at position 10,20. -ffmpeg -f x11grab -r 25 -s cif -i :0.0+10,20 out.mpg +avconv -f x11grab -r 25 -s cif -i :0.0+10,20 out.mpg @end example @subsection @var{follow_mouse} AVOption @@ -348,10 +334,10 @@ zero) to the edge of region. For example: @example -ffmpeg -f x11grab -follow_mouse centered -r 25 -s cif -i :0.0 out.mpg +avconv -f x11grab -follow_mouse centered -r 25 -s cif -i :0.0 out.mpg # Follows only when the mouse pointer reaches within 100 pixels to edge -ffmpeg -f x11grab -follow_mouse 100 -r 25 -s cif -i :0.0 out.mpg +avconv -f x11grab -follow_mouse 100 -r 25 -s cif -i :0.0 out.mpg @end example @subsection @var{show_region} AVOption @@ -367,10 +353,10 @@ being grabbed if only a portion of the screen is grabbed. For example: @example -ffmpeg -f x11grab -show_region 1 -r 25 -s cif -i :0.0+10,20 out.mpg +avconv -f x11grab -show_region 1 -r 25 -s cif -i :0.0+10,20 out.mpg # With follow_mouse -ffmpeg -f x11grab -follow_mouse centered -show_region 1 -r 25 -s cif -i :0.0 out.mpg +avconv -f x11grab -follow_mouse centered -show_region 1 -r 25 -s cif -i :0.0 out.mpg @end example @c man end INPUT DEVICES