Merge branch 'drawbox_exprs' of https://github.com/mjmvisser/FFmpeg
authorMichael Niedermayer <michaelni@gmx.at>
Tue, 25 Jun 2013 22:33:24 +0000 (00:33 +0200)
committerMichael Niedermayer <michaelni@gmx.at>
Tue, 25 Jun 2013 22:33:41 +0000 (00:33 +0200)
* 'drawbox_exprs' of https://github.com/mjmvisser/FFmpeg:
  enabled expressions on x, y, w, h and t parameters for drawgrid and drawbox, added examples

Reviewed-by: Andrey Utkin
Merged-by: Michael Niedermayer <michaelni@gmx.at>
1  2 
doc/filters.texi

@@@ -2900,7 -2900,44 +2900,44 @@@ value @code{invert} is used, the box ed
  video with inverted luma.
  
  @item thickness, t
- Set the thickness of the box edge. Default value is @code{3}.
+ The expression which sets the thickness of the box edge. Default value is @code{3}.
+ See below for the list of accepted constants.
+ @end table
+ The parameters for @var{x}, @var{y}, @var{w} and @var{h} and @var{t} are expressions containing the
+ following constants:
+ @table @option
+ @item dar
+ The input display aspect ratio, it is the same as (@var{w} / @var{h}) * @var{sar}.
+ @item hsub
+ @item vsub
+ horizontal and vertical chroma subsample values. For example for the
+ pixel format "yuv422p" @var{hsub} is 2 and @var{vsub} is 1.
+ @item in_h, ih
+ @item in_w, iw
+ The input width and height.
+ @item sar
+ The input sample aspect ratio.
+ @item x
+ @item y
+ The x and y offset coordinates where the box is drawn.
+ @item w
+ @item h
+ The width and height of the drawn box.
+ @item t
+ The thickness of the drawn box.
 -These constants allow the @var{x}, @var{y}, @var{w}, @var{h} and @var{t} expressions to refer to 
++These constants allow the @var{x}, @var{y}, @var{w}, @var{h} and @var{t} expressions to refer to
+ each other, so you may for example specify @code(y=x/dar} or @code(h=w/dar).
  @end table
  
  @subsection Examples
@@@ -2956,7 -2999,44 +2999,44 @@@ Note that you can append opacity value 
  to color name after @@ sign.
  
  @item thickness, t
- Set the thickness of the grid line. Default value is @code{1}.
+ The expression which sets the thickness of the grid line. Default value is @code{1}.
+ See below for the list of accepted constants.
+ @end table
+ The parameters for @var{x}, @var{y}, @var{w} and @var{h} and @var{t} are expressions containing the
+ following constants:
+ @table @option
+ @item dar
+ The input display aspect ratio, it is the same as (@var{w} / @var{h}) * @var{sar}.
+ @item hsub
+ @item vsub
+ horizontal and vertical chroma subsample values. For example for the
+ pixel format "yuv422p" @var{hsub} is 2 and @var{vsub} is 1.
+ @item in_h, ih
+ @item in_w, iw
+ The input grid cell width and height.
+ @item sar
+ The input sample aspect ratio.
+ @item x
+ @item y
+ The x and y coordinates of some point of grid intersection (meant to configure offset).
+ @item w
+ @item h
+ The width and height of the drawn cell.
+ @item t
+ The thickness of the drawn cell.
 -These constants allow the @var{x}, @var{y}, @var{w}, @var{h} and @var{t} expressions to refer to 
++These constants allow the @var{x}, @var{y}, @var{w}, @var{h} and @var{t} expressions to refer to
+ each other, so you may for example specify @code(y=x/dar} or @code(h=w/dar).
  @end table
  
  @subsection Examples