[FFmpeg-devel] [PATCHv2] doc/demuxers: document gif demuxer

[Timothy Gu]

On Aug 31, 2014 3:16 PM, "Lou Logan" <lou at lrcd.com> wrote:

> + at item ignore_loop

> +GIF files can be set to loop infinitely or up to a certain number of
> +times.

can contain information to loop...

"Can be set" sounds like settable from a ffmpeg command.

> +
> +If @option{ignore_loop} is set to 1, then the loop setting from the
> +input will be ignored and looping will not occur.
> +
> +If set to 0, then looping will occur and will cycle the number of times
> +the GIF dictates.

Merge the above 3 paragraphs if you think it is appropriate.

> +
> +This option prevents a GIF stream from looping forever.

Not necessary. Covered in the second paragraph above.

> +
> +Default value is 1.

5 paragraphs for this trivial option? Ouch.

> + at end table
> +
> +For example, with the overlay filter, place an infinitely looping GIF
> +over another video:
> + at example

> +ffmpeg -i input.mp4 -ignore_loop 0 -i input.gif
>  -filter_complex overlay=shortest=1 out.mkv

What if input.gif contains information saying that it should only be looped
once? Doesn't this command break then?

Rest LGTM.

Timothy