[FFmpeg-devel] [PATCH] doc/filters: itemize scale examples, and create a dedicated subsection for them

[Clément Bœsch]

On Sat, Oct 06, 2012 at 12:39:47PM +0200, Stefano Sabatini wrote:
> ---
>  doc/filters.texi |   60 +++++++++++++++++++++++++++++++++++++++++++----------
>  1 files changed, 48 insertions(+), 12 deletions(-)
> 
> diff --git a/doc/filters.texi b/doc/filters.texi
> index d56a51a..a13d5ed 100644
> --- a/doc/filters.texi
> +++ b/doc/filters.texi
> @@ -3088,41 +3088,77 @@ If the value for @var{width} or @var{height} is -1, the scale filter will
>  use, for the respective output size, a value that maintains the aspect
>  ratio of the input image.
>  
> -Some examples follow:
> + at subsection Examples
> +
> + at itemize
> + at item
> +Scale the input video to a size of 200x100:
>  @example
> -# scale the input video to a size of 200x100.
>  scale=200:100
> + at end example
>  
> -# the above example is the same as:
> + at item
> +The above example is the same as:
> + at example
>  scale=w=200:h=100
> + at end example
>  
> -# scale the input to 2x
> + at item
> +Scale the input to 2x:
> + at example
>  scale=2*iw:2*ih
> -# the above is the same as
> + at end example
> +
> + at item
> +The above is the same as:
> + at example
>  scale=2*in_w:2*in_h
> + at end example
>  
> -# scale the input to 2x with forced interlaced scaling
> + at item
> +Scale the input to 2x with forced interlaced scaling:
> + at example
>  scale=2*iw:2*ih:interl=1
> + at end example
>  
> -# scale the input to half size
> + at item
> +Scale the input to half size:
> + at example
>  scale=iw/2:ih/2
> + at end example
>  
> -# increase the width, and set the height to the same size
> + at item
> +Increase the width, and set the height to the same size:
> + at example
>  scale=3/2*iw:ow
> + at end example
>  
> -# seek for Greek harmony
> + at item
> +Seek for Greek harmony:
> + at example
>  scale=iw:1/PHI*iw
>  scale=ih*PHI:ih
> + at end example
>  
> -# increase the height, and set the width to 3/2 of the height
> + at item
> +Increase the height, and set the width to 3/2 of the height:
> + at example
>  scale=3/2*oh:3/5*ih
> + at end example
>  
> -# increase the size, but make the size a multiple of the chroma
> + at item
> +Increase the size, but make the size a multiple of the chroma:
> + at example
>  scale="trunc(3/2*iw/hsub)*hsub:trunc(3/2*ih/vsub)*vsub"
> + at end example
>  
> -# increase the width to a maximum of 500 pixels, keep the same input aspect ratio
> + at item
> +Increase the width to a maximum of 500 pixels, keep the same input
> +aspect ratio:
> + at example
>  scale='min(500\, iw*3/2):-1'
>  @end example
> + at end itemize
>  
>  @section select
>  Select frames to pass in output.

LGTM

-- 
Clément B.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 490 bytes
Desc: not available
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20121006/6d308697/attachment.asc>