generic-library/ffmpeg
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

doc/filters: itemize examples for pad filter, and fix a few typos

Browse Source
This commit is contained in:
Stefano Sabatini 2012-08-21 12:34:10 +02:00
parent bc151aee60
commit 4a32b30e0c
1 changed files with 39 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

55
doc/filters.texi
View File

@ -2795,36 +2795,59 @@ The default value of @var{color} is "black".
@end table @end table
Some examples follow: @section Examples
@itemize
@item
Add paddings with color "violet" to the input video. Output video
size is 640x480, the top-left corner of the input video is placed at
column 0, row 40:
@example @example
# Add paddings with color "violet" to the input video. Output video
# size is 640x480, the top-left corner of the input video is placed at
# column 0, row 40.
pad=640:480:0:40:violet pad=640:480:0:40:violet
@end example
# pad the input to get an output with dimensions increased bt 3/2, @item
# and put the input video at the center of the padded area Pad the input to get an output with dimensions increased by 3/2,
and put the input video at the center of the padded area:
@example
pad="3/2*iw:3/2*ih:(ow-iw)/2:(oh-ih)/2" pad="3/2*iw:3/2*ih:(ow-iw)/2:(oh-ih)/2"
@end example
# pad the input to get a squared output with size equal to the maximum @item
# value between the input width and height, and put the input video at Pad the input to get a squared output with size equal to the maximum
# the center of the padded area value between the input width and height, and put the input video at
the center of the padded area:
@example
pad="max(iw\,ih):ow:(ow-iw)/2:(oh-ih)/2" pad="max(iw\,ih):ow:(ow-iw)/2:(oh-ih)/2"
@end example
# pad the input to get a final w/h ratio of 16:9 @item
Pad the input to get a final w/h ratio of 16:9:
@example
pad="ih*16/9:ih:(ow-iw)/2:(oh-ih)/2" pad="ih*16/9:ih:(ow-iw)/2:(oh-ih)/2"
@end example
# for anamorphic video, in order to set the output display aspect ratio, @item
# it is necessary to use sar in the expression, according to the relation: In case of anamorphic video, in order to set the output display aspect
# (ih * X / ih) * sar = output_dar correctly, it is necessary to use @var{sar} in the expression,
# X = output_dar / sar according to the relation:
@example
(ih * X / ih) * sar = output_dar
X = output_dar / sar
@end example
Thus the previous example needs to be modified to:
@example
pad="ih*16/9/sar:ih:(ow-iw)/2:(oh-ih)/2" pad="ih*16/9/sar:ih:(ow-iw)/2:(oh-ih)/2"
@end example
# double output size and put the input video in the bottom-right @item
# corner of the output padded area Double output size and put the input video in the bottom-right
corner of the output padded area:
@example
pad="2*iw:2*ih:ow-iw:oh-ih" pad="2*iw:2*ih:ow-iw:oh-ih"
@end example @end example
@end itemize
@section pixdesctest @section pixdesctest