[FFmpeg-devel] [PATCH 3/3] doc/indevs: Rework and update documentation of AVFoundation device.

[Thilo Borgmann]

-------------- next part --------------
>From ee349f8572fb9fdf808a6d32efe75c8ab17a7f1e Mon Sep 17 00:00:00 2001
From: Thilo Borgmann <thilo.borgmann at mail.de>
Date: Thu, 13 Nov 2014 17:25:02 +0100
Subject: [PATCH 3/3] doc/indevs: Rework and update documentation of
 AVFoundation device.

---
 doc/indevs.texi | 86 +++++++++++++++++++++++++++++++++++++++++++++++----------
 1 file changed, 72 insertions(+), 14 deletions(-)

diff --git a/doc/indevs.texi b/doc/indevs.texi
index 18fc5a2..5d2a308 100644
--- a/doc/indevs.texi
+++ b/doc/indevs.texi
@@ -58,36 +58,94 @@ AVFoundation input device.
 AVFoundation is the currently recommended framework by Apple for streamgrabbing on OSX >= 10.7 as well as on iOS.
 The older QTKit framework has been marked deprecated since OSX version 10.7.
 
-The filename passed as input is parsed to contain two input streams seperated by ":".
-The first entry selects the video input while the latter selects the audio input @option{"<video>:<audio>"}.
-Each stream can either be specified by the device name or the index.
-The device index can also be given by using @option{-video_device_index <index>} and/or @option{-audio_device_index <index>}, respectively.
-A given device index will override any given device name.
-If the desired device consists of numbers only, use the device index option to identify it.
-The default device will be chosen if an empty string  or the device name @code{default} is given.
-The available devices can be enumerated by using @option{-list_devices true}.
-The pixel format can be set using @option{-pixel_format <format>}.
-Available formats:
+The input filename has to be given in the following syntax:
+ at example
+-i "[[VIDEO]:[AUDIO]]"
+ at end example
+The first entry selects the video input while the latter selects the audio input.
+The stream has to be specified by the device name or the device index as shown by the device list.
+Alternatively, the video and/or audio input device can be chosen by index using the
+ at option{
+    -video_device_index <INDEX>
+}
+and/or
+ at option{
+    -audio_device_index <INDEX>
+}
+, overriding any
+device name or index given in the input filename.
+
+All available devices can be enumerated by using @option{-list_devices true}, listing
+all device names and corresponding indices.
+
+There are two device name aliases:
+ at table @code
+
+ at item default
+Select the AVFoundation default device of the corresponding type.
+
+ at item none
+Do not record the corresponding media type.
+This is equivalent to specifiying an empty device name or index.
+
+ at end table
+
+ at subsection Options
+
+AVFoundation supports the following options:
+
+ at table @option
+
+ at item -list_devices <TRUE|FALSE>
+If set to true, a list of all available input devices is given showing all
+device names and indices.
+
+ at item -video_device_index <INDEX>
+Specify the video device by its index. Overrides anything given in the input filename.
+
+ at item -audio_device_index <INDEX>
+Specify the audio device by its index. Overrides anything given in the input filename.
+
+ at item -pixel_format <FORMAT>
+Request the video device to use a specific pixel format.
+If the specified format is not supported, a list of available formats is given
+und the first one in this list is used instead. Available pixel formats are:
 @code{monob, rgb555be, rgb555le, rgb565be, rgb565le, rgb24, bgr24, 0rgb, bgr0, 0bgr, rgb0,
  bgr48be, uyvy422, yuva444p, yuva444p16le, yuv444p, yuv422p16, yuv422p10, yuv444p10,
  yuv420p, nv12, yuyv422, gray}
 
+ at end table
+
+ at subsection Examples
+
+ at itemize
+
+ at item
+Print the list of AVFoundation supported devices and exit:
 @example
-ffmpeg -f avfoundation -i "0:0" out.mpg
+$ ffmpeg -f avfoundation -list_devices true -i ""
 @end example
 
+ at item
+Record video from video device 0 and audio from audio device 0 into out.avi:
 @example
-ffmpeg -f avfoundation -video_device_index 0 -i ":0" out.mpg
+$ ffmpeg -f avfoundation -i "0:0" out.avi
 @end example
 
+ at item
+Record video from video device 2 and audio from audio device 1 into out.avi:
 @example
-ffmpeg -f avfoundation -pixel_format bgr0 -i "default:default" out.mpg
+$ ffmpeg -f avfoundation -video_device_index 2 -i ":1" out.avi
 @end example
 
+ at item
+Record video from the system default video device using the pixel format bgr0 and do not record any audio into out.avi:
 @example
-ffmpeg -f avfoundation -list_devices true -i ""
+$ ffmpeg -f avfoundation -pixel_format bgr0 -i "default:none" out.avi
 @end example
 
+ at end itemize
+
 @section bktr
 
 BSD video input device.
-- 
1.9.3 (Apple Git-50)