[FFmpeg-devel] [PATCH 4/5] doc/indevs: Add examples for libdc1394

[Gyan]

This patch (and others in this set) appear to have been sent multiple 
times. This is the latest received one, so reviewing this one.

On 20-10-2019 03:25 PM, Forest Crossman wrote:
> Signed-off-by: Forest Crossman <cyrozap at gmail.com>
> ---
>   doc/indevs.texi | 51 +++++++++++++++++++++++++++++++++++++++++++++++++
>   1 file changed, 51 insertions(+)
>
> diff --git a/doc/indevs.texi b/doc/indevs.texi
> index 757fac91de..078f45497a 100644
> --- a/doc/indevs.texi
> +++ b/doc/indevs.texi
> @@ -1086,6 +1086,57 @@ Set the video size given as a string such as @code{640x480} or @code{hd720}.
>   Default is @code{qvga}.
>   @end table
>   
> + at subsection Examples
> +
> + at itemize
> +
> + at item
> +List all the connected IIDC cameras.
> + at example
> +ffmpeg -sources libdc1394
> + at end example
> +
> + at item
> +Grab and record the input of an Apple iSight.
> + at example
> +ffmpeg -f libdc1394 -pixel_format uyvy422 -video_size 320x240 -framerate 30 -i auto out.mkv
> + at end example
> +
> + at item
> +Grab and record the input of an Apple iSight, using the shorter options.
> + at example
> +ffmpeg -f libdc1394 -pix_fmt uyvy422 -s 320x240 -r 30 -i auto out.mkv
> + at end example

The shorter options are deprecated and aren't strictly speaking, private 
options of this device, so remove this example.

> + at item
> +Grab and record the input of an Apple iSight, specifying the framerate
> +as a ratio.
> + at example
> +ffmpeg -f libdc1394 -pix_fmt uyvy422 -s 320x240 -r 30000:1000 -i auto out.mkv
> + at end example

Not really necessary, but if kept, replace with device options.

> + at item
> +Grab and record the input of an Apple iSight at a greater resolution but
> +a lower framerate.
> + at example
> +ffmpeg -f libdc1394 -pix_fmt uyvy422 -s 640x480 -r 15 -i auto out.mkv
> + at end example

Unless there are restrictions on combinations of option values, seems 
unnecessary.

> + at item
> +Grab and record the input of a specific Apple iSight.
> + at example
> +ffmpeg -f libdc1394 -pix_fmt uyvy422 -s 640x480 -r 15 -i 0x000a270004106ea3 out.mkv
> + at end example

Replace with device options.

> + at item
> +Grab and record the second stream from a specific camera that has
> +multiple units.
> + at example
> +ffmpeg -f libdc1394 -pix_fmt uyvy422 -s 640x480 -r 15 -i 0xfacade02bc394f15:1 out.mkv
> + at end example

Same.


Regards,
Gyan