Revision 2fd8756b

View differences:

doc/filters.texi
789 789

  
790 790
The default value of @var{width} and @var{height} is 0.
791 791

  
792
@anchor{setdar}
793
@section setdar
794

  
795
Set the Display Aspect Ratio for the filter output video.
796

  
797
This is done by changing the specified Sample (aka Pixel) Aspect
798
Ratio, according to the following equation:
799
@math{DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR}
800

  
801
Keep in mind that this filter does not modify the pixel dimensions of
802
the video frame. Also the display aspect ratio set by this filter may
803
be changed by later filters in the filterchain, e.g. in case of
804
scaling or if another "setdar" or a "setsar" filter is applied.
805

  
806
The filter accepts a parameter string which represents the wanted
807
display aspect ratio.
808
The parameter can be a floating point number string, or an expression
809
of the form @var{num}:@var{den}, where @var{num} and @var{den} are the
810
numerator and denominator of the aspect ratio.
811
If the parameter is not specified, it is assumed the value "0:1".
812

  
813
For example to change the display aspect ratio to 16:9, specify:
814
@example
815
setdar=16:9
816
# the above is equivalent to
817
setdar=1.77777
818
@end example
819

  
820
See also the "setsar" filter documentation (@pxref{setsar}).
821

  
792 822
@section setpts
793 823

  
794 824
Change the PTS (presentation timestamp) of the input video frames.
......
849 879
setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))'
850 880
@end example
851 881

  
882
@anchor{setsar}
883
@section setsar
884

  
885
Set the Sample (aka Pixel) Aspect Ratio for the filter output video.
886

  
887
Note that as a consequence of the application of this filter, the
888
output display aspect ratio will change according to the following
889
equation:
890
@math{DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR}
891

  
892
Keep in mind that the sample aspect ratio set by this filter may be
893
changed by later filters in the filterchain, e.g. if another "setsar"
894
or a "setdar" filter is applied.
895

  
896
The filter accepts a parameter string which represents the wanted
897
sample aspect ratio.
898
The parameter can be a floating point number string, or an expression
899
of the form @var{num}:@var{den}, where @var{num} and @var{den} are the
900
numerator and denominator of the aspect ratio.
901
If the parameter is not specified, it is assumed the value "0:1".
902

  
903
For example to change the sample aspect ratio to 10:11, specify:
904
@example
905
setsar=10:11
906
@end example
907

  
852 908
@section settb
853 909

  
854 910
Set the timebase to use for the output frames timestamps.

Also available in: Unified diff