[FFmpeg-devel] [PATCH] doc/filters: itemize crop examples

[Stefano Sabatini]

On date Saturday 2012-12-15 19:55:58 +0100, Clément Bœsch encoded:
> On Sat, Dec 15, 2012 at 05:03:45PM +0100, Stefano Sabatini wrote:
> > ---
> >  doc/filters.texi |   72 ++++++++++++++++++++++++++++++++++++++----------------
> >  1 file changed, 51 insertions(+), 21 deletions(-)
> > 
> > diff --git a/doc/filters.texi b/doc/filters.texi
> > index a8b6221..3f926c2 100644
> > --- a/doc/filters.texi
> > +++ b/doc/filters.texi
> > @@ -1610,41 +1610,71 @@ is approximated to the nearest valid value.
> >  The expression for @var{x} may depend on @var{y}, and the expression
> >  for @var{y} may depend on @var{x}.
> >  
> > -Follow some examples:
> > + at subsection Examples
> > + at itemize
> > + at item
> > +Crop the central input area with size 100x100:
> >  @example
> > -# crop the central input area with size 100x100
> >  crop=100:100
> > + at end example
> >  
> > -# crop the central input area with size 2/3 of the input video
> > -"crop=2/3*in_w:2/3*in_h"
> > + at item
> > +Crop the central input area with size 2/3 of the input video:
> > + at example
> > +crop=2/3*in_w:2/3*in_h
> > + at end example
> >  
> > -# crop the input video central square
> > + at item
> > +Crop the input video central square:
> > + at example
> >  crop=in_h
> > + at end example
> >  
> > -# delimit the rectangle with the top-left corner placed at position
> > -# 100:100 and the right-bottom corner corresponding to the right-bottom
> > -# corner of the input image.
> > + at item
> > +Delimit the rectangle with the top-left corner placed at position
> > +100:100 and the right-bottom corner corresponding to the right-bottom
> > +corner of the input image:
> > + at example
> >  crop=in_w-100:in_h-100:100:100
> > + at end example
> >  
> > -# crop 10 pixels from the left and right borders, and 20 pixels from
> > -# the top and bottom borders
> > -"crop=in_w-2*10:in_h-2*20"
> > + at item
> > +Crop 10 pixels from the left and right borders, and 20 pixels from
> > +the top and bottom borders
> > + at example
> > +crop=in_w-2*10:in_h-2*20
> > + at end example
> >  
> > -# keep only the bottom right quarter of the input image
> > -"crop=in_w/2:in_h/2:in_w/2:in_h/2"
> > + at item
> > +Keep only the bottom right quarter of the input image:
> > + at example
> > +crop=in_w/2:in_h/2:in_w/2:in_h/2
> > + at end example
> >  
> > -# crop height for getting Greek harmony
> > -"crop=in_w:1/PHI*in_w"
> > + at item
> > +Crop height for getting Greek harmony:
> > + at example
> > +crop=in_w:1/PHI*in_w
> > + at end example
> >  
> > -# trembling effect
> > -"crop=in_w/2:in_h/2:(in_w-out_w)/2+((in_w-out_w)/2)*sin(n/10):(in_h-out_h)/2 +((in_h-out_h)/2)*sin(n/7)"
> > + at item
> > +Appply trembling effect:
> > + at example
> > +crop=in_w/2:in_h/2:(in_w-out_w)/2+((in_w-out_w)/2)*sin(n/10):(in_h-out_h)/2 +((in_h-out_h)/2)*sin(n/7)
> > + at end example
> >  
> > -# erratic camera effect depending on timestamp
> > -"crop=in_w/2:in_h/2:(in_w-out_w)/2+((in_w-out_w)/2)*sin(t*10):(in_h-out_h)/2 +((in_h-out_h)/2)*sin(t*13)"
> > + at item
> > +Apply erratic camera effect depending on timestamp:
> > + at example
> > +crop=in_w/2:in_h/2:(in_w-out_w)/2+((in_w-out_w)/2)*sin(t*10):(in_h-out_h)/2 +((in_h-out_h)/2)*sin(t*13)"
> > + at end example
> >  
> > -# set x depending on the value of y
> > -"crop=in_w/2:in_h/2:y:10+10*sin(n/10)"
> > + at item
> > +Set x depending on the value of y:
> > + at example
> > +crop=in_w/2:in_h/2:y:10+10*sin(n/10)
> >  @end example
> > + at end itemize
> >  
> >  @section cropdetect
> >  
> 
> Looks OK. I guess you could commit such formatting improvement directly.

Will push it soon, thanks.
-- 
FFmpeg = Foolish & Fantastic Mind-dumbing Peaceful Extended Guru