mirror of https://git.videolan.org/git/ffmpeg.git
doc/filters.texi: merge setdar and setsar documentation
Most of the documentation is common to both filters, and I'm going to add more shared docs. Factorize.
This commit is contained in:
parent
70ffda3217
commit
3fa9ace3d8
|
@ -2335,26 +2335,38 @@ select='gte(t\,10)*lte(t\,20)*eq(pict_type\,I)'
|
||||||
select='isnan(prev_selected_t)+gte(t-prev_selected_t\,10)'
|
select='isnan(prev_selected_t)+gte(t-prev_selected_t\,10)'
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@anchor{setdar}
|
@section setdar, setsar
|
||||||
@section setdar
|
|
||||||
|
|
||||||
Set the Display Aspect Ratio for the filter output video.
|
The @code{setdar} filter sets the Display Aspect Ratio for the filter
|
||||||
|
output video.
|
||||||
|
|
||||||
This is done by changing the specified Sample (aka Pixel) Aspect
|
This is done by changing the specified Sample (aka Pixel) Aspect
|
||||||
Ratio, according to the following equation:
|
Ratio, according to the following equation:
|
||||||
@math{DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR}
|
@math{DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR}
|
||||||
|
|
||||||
Keep in mind that this filter does not modify the pixel dimensions of
|
Keep in mind that the @code{setdar} filter does not modify the pixel
|
||||||
the video frame. Also the display aspect ratio set by this filter may
|
dimensions of the video frame. Also the display aspect ratio set by
|
||||||
be changed by later filters in the filterchain, e.g. in case of
|
this filter may be changed by later filters in the filterchain,
|
||||||
scaling or if another "setdar" or a "setsar" filter is applied.
|
e.g. in case of scaling or if another "setdar" or a "setsar" filter is
|
||||||
|
applied.
|
||||||
|
|
||||||
The filter accepts a parameter string which represents the wanted
|
The @code{setsar} filter sets the Sample (aka Pixel) Aspect Ratio for
|
||||||
display aspect ratio.
|
the filter output video.
|
||||||
The parameter can be a floating point number string, or an expression
|
|
||||||
of the form @var{num}:@var{den}, where @var{num} and @var{den} are the
|
Note that as a consequence of the application of this filter, the
|
||||||
numerator and denominator of the aspect ratio.
|
output display aspect ratio will change according to the equation
|
||||||
If the parameter is not specified, it is assumed the value "0:1".
|
above.
|
||||||
|
|
||||||
|
Keep in mind that the sample aspect ratio set by the @code{setsar}
|
||||||
|
filter may be changed by later filters in the filterchain, e.g. if
|
||||||
|
another "setsar" or a "setdar" filter is applied.
|
||||||
|
|
||||||
|
The @code{setdar} and @code{setsar} filters accept a parameter string
|
||||||
|
which represents the wanted aspect ratio. The parameter can
|
||||||
|
be a floating point number string, an expression, or a string of the form
|
||||||
|
@var{num}:@var{den}, where @var{num} and @var{den} are the numerator
|
||||||
|
and denominator of the aspect ratio. If the parameter is not
|
||||||
|
specified, it is assumed the value "0:1".
|
||||||
|
|
||||||
For example to change the display aspect ratio to 16:9, specify:
|
For example to change the display aspect ratio to 16:9, specify:
|
||||||
@example
|
@example
|
||||||
|
@ -2363,7 +2375,10 @@ setdar=16:9
|
||||||
setdar=1.77777
|
setdar=1.77777
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
See also the @ref{setsar} filter documentation.
|
To change the sample aspect ratio to 10:11, specify:
|
||||||
|
@example
|
||||||
|
setsar=10:11
|
||||||
|
@end example
|
||||||
|
|
||||||
@section setpts
|
@section setpts
|
||||||
|
|
||||||
|
@ -2416,32 +2431,6 @@ setpts=N/(25*TB)
|
||||||
setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))'
|
setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))'
|
||||||
@end example
|
@end example
|
||||||
|
|
||||||
@anchor{setsar}
|
|
||||||
@section setsar
|
|
||||||
|
|
||||||
Set the Sample (aka Pixel) Aspect Ratio for the filter output video.
|
|
||||||
|
|
||||||
Note that as a consequence of the application of this filter, the
|
|
||||||
output display aspect ratio will change according to the following
|
|
||||||
equation:
|
|
||||||
@math{DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR}
|
|
||||||
|
|
||||||
Keep in mind that the sample aspect ratio set by this filter may be
|
|
||||||
changed by later filters in the filterchain, e.g. if another "setsar"
|
|
||||||
or a "setdar" filter is applied.
|
|
||||||
|
|
||||||
The filter accepts a parameter string which represents the wanted
|
|
||||||
sample aspect ratio.
|
|
||||||
The parameter can be a floating point number string, or an expression
|
|
||||||
of the form @var{num}:@var{den}, where @var{num} and @var{den} are the
|
|
||||||
numerator and denominator of the aspect ratio.
|
|
||||||
If the parameter is not specified, it is assumed the value "0:1".
|
|
||||||
|
|
||||||
For example to change the sample aspect ratio to 10:11, specify:
|
|
||||||
@example
|
|
||||||
setsar=10:11
|
|
||||||
@end example
|
|
||||||
|
|
||||||
@section settb
|
@section settb
|
||||||
|
|
||||||
Set the timebase to use for the output frames timestamps.
|
Set the timebase to use for the output frames timestamps.
|
||||||
|
|
Loading…
Reference in New Issue