Merge commit 'cecf45b2bfbb85e9e59f355428fbd4d8cbc652a8'
authorMichael Niedermayer <michaelni@gmx.at>
Sat, 7 Mar 2015 00:16:17 +0000 (01:16 +0100)
committerMichael Niedermayer <michaelni@gmx.at>
Sat, 7 Mar 2015 00:16:17 +0000 (01:16 +0100)
* commit 'cecf45b2bfbb85e9e59f355428fbd4d8cbc652a8':
  doc: Add -list_formats all example for video4linux2

Conflicts:
doc/indevs.texi

Merged-by: Michael Niedermayer <michaelni@gmx.at>
1  2 
doc/indevs.texi

diff --cc doc/indevs.texi
@@@ -889,106 -265,22 +889,112 @@@ kind @file{/dev/video@var{N}}, where @v
  the device.
  
  Video4Linux2 devices usually support a limited set of
 -@var{width}x@var{height} sizes and framerates. You can check which are
 +@var{width}x@var{height} sizes and frame rates. You can check which are
  supported using @command{-list_formats all} for Video4Linux2 devices.
 -Some usage examples of the video4linux2 devices with avconv and avplay:
 +Some devices, like TV cards, support one or more standards. It is possible
 +to list all the supported standards using @command{-list_standards all}.
 +
 +The time base for the timestamps is 1 microsecond. Depending on the kernel
 +version and configuration, the timestamps may be derived from the real time
 +clock (origin at the Unix Epoch) or the monotonic clock (origin usually at
 +boot time, unaffected by NTP or manual changes to the clock). The
 +@option{-timestamps abs} or @option{-ts abs} option can be used to force
 +conversion into the real time clock.
 +
 +Some usage examples of the video4linux2 device with @command{ffmpeg}
 +and @command{ffplay}:
 +@itemize
 +@item
++List supported formats for a video4linux2 device:
++@example
++ffplay -f video4linux2 -list_formats all /dev/video0
++@end example
++@item
 +Grab and show the input of a video4linux2 device:
 +@example
 +ffplay -f video4linux2 -framerate 30 -video_size hd720 /dev/video0
 +@end example
  
 +@item
 +Grab and record the input of a video4linux2 device, leave the
 +frame rate and size as previously set:
  @example
 -# List supported formats for a video4linux2 device.
 -avplay -f video4linux2 -list_formats all /dev/video0
 +ffmpeg -f video4linux2 -input_format mjpeg -i /dev/video0 out.mpeg
 +@end example
 +@end itemize
  
 -# Grab and show the input of a video4linux2 device.
 -avplay -f video4linux2 -framerate 30 -video_size hd720 /dev/video0
 +For more information about Video4Linux, check @url{http://linuxtv.org/}.
  
 -# 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
 +@subsection Options
 +
 +@table @option
 +@item standard
 +Set the standard. Must be the name of a supported standard. To get a
 +list of the supported standards, use the @option{list_standards}
 +option.
 +
 +@item channel
 +Set the input channel number. Default to -1, which means using the
 +previously selected channel.
 +
 +@item video_size
 +Set the video frame size. The argument must be a string in the form
 +@var{WIDTH}x@var{HEIGHT} or a valid size abbreviation.
 +
 +@item pixel_format
 +Select the pixel format (only valid for raw video input).
 +
 +@item input_format
 +Set the preferred pixel format (for raw video) or a codec name.
 +This option allows one to select the input format, when several are
 +available.
 +
 +@item framerate
 +Set the preferred video frame rate.
 +
 +@item list_formats
 +List available formats (supported pixel formats, codecs, and frame
 +sizes) and exit.
 +
 +Available values are:
 +@table @samp
 +@item all
 +Show all available (compressed and non-compressed) formats.
 +
 +@item raw
 +Show only raw video (non-compressed) formats.
 +
 +@item compressed
 +Show only compressed formats.
 +@end table
 +
 +@item list_standards
 +List supported standards and exit.
 +
 +Available values are:
 +@table @samp
 +@item all
 +Show all supported standards.
 +@end table
 +
 +@item timestamps, ts
 +Set type of timestamps for grabbed frames.
 +
 +Available values are:
 +@table @samp
 +@item default
 +Use timestamps from the kernel.
 +
 +@item abs
 +Use absolute timestamps (wall clock).
 +
 +@item mono2abs
 +Force conversion from monotonic to absolute timestamps.
 +@end table
 +
 +Default value is @code{default}.
 +@end table
  
  @section vfwcap