Unified · Split
| @@ -1001,6 +1001,36 @@ ratio of the input image. · 1000 unmodified lines | |||
| 1001 | 1001 | ||
| 1002 | The default value of @var{width} and @var{height} is 0. | 1002 | The default value of @var{width} and @var{height} is 0. |
| 1003 | 1003 | ||
| 1004 | @anchor{setdar} | ||
| 1005 | @section setdar | ||
| 1006 | |||
| 1007 | Set the Display Aspect Ratio for the filter output video. | ||
| 1008 | |||
| 1009 | This is done by changing the specified Sample (aka Pixel) Aspect | ||
| 1010 | Ratio, according to the following equation: | ||
| 1011 | @math{DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR} | ||
| 1012 | |||
| 1013 | Keep in mind that this filter does not modify the pixel dimensions of | ||
| 1014 | the video frame. Also the display aspect ratio set by this filter may | ||
| 1015 | be changed by later filters in the filterchain, e.g. in case of | ||
| 1016 | scaling or if another "setdar" or a "setsar" filter is applied. | ||
| 1017 | |||
| 1018 | The filter accepts a parameter string which represents the wanted | ||
| 1019 | display aspect ratio. | ||
| 1020 | The parameter can be a floating point number string, or an expression | ||
| 1021 | of the form @var{num}:@var{den}, where @var{num} and @var{den} are the | ||
| 1022 | numerator and denominator of the aspect ratio. | ||
| 1023 | If the parameter is not specified, it is assumed the value "0:1". | ||
| 1024 | |||
| 1025 | For example to change the display aspect ratio to 16:9, specify: | ||
| 1026 | @example | ||
| 1027 | setdar=16:9 | ||
| 1028 | # the above is equivalent to | ||
| 1029 | setdar=1.77777 | ||
| 1030 | @end example | ||
| 1031 | |||
| 1032 | See also the "setsar" filter documentation (@pxref{setsar}). | ||
| 1033 | |||
| 1004 | @section setpts | 1034 | @section setpts |
| 1005 | 1035 | ||
| 1006 | Change the PTS (presentation timestamp) of the input video frames. | 1036 | Change the PTS (presentation timestamp) of the input video frames. |
| @@ -1061,6 +1091,32 @@ setpts=N/(25*TB) · 54 unmodified lines | |||
| 1061 | setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))' | 1091 | setpts='1/(25*TB) * (N + 0.05 * sin(N*2*PI/25))' |
| 1062 | @end example | 1092 | @end example |
| 1063 | 1093 | ||
| 1094 | @anchor{setsar} | ||
| 1095 | @section setsar | ||
| 1096 | |||
| 1097 | Set the Sample (aka Pixel) Aspect Ratio for the filter output video. | ||
| 1098 | |||
| 1099 | Note that as a consequence of the application of this filter, the | ||
| 1100 | output display aspect ratio will change according to the following | ||
| 1101 | equation: | ||
| 1102 | @math{DAR = HORIZONTAL_RESOLUTION / VERTICAL_RESOLUTION * SAR} | ||
| 1103 | |||
| 1104 | Keep in mind that the sample aspect ratio set by this filter may be | ||
| 1105 | changed by later filters in the filterchain, e.g. if another "setsar" | ||
| 1106 | or a "setdar" filter is applied. | ||
| 1107 | |||
| 1108 | The filter accepts a parameter string which represents the wanted | ||
| 1109 | sample aspect ratio. | ||
| 1110 | The parameter can be a floating point number string, or an expression | ||
| 1111 | of the form @var{num}:@var{den}, where @var{num} and @var{den} are the | ||
| 1112 | numerator and denominator of the aspect ratio. | ||
| 1113 | If the parameter is not specified, it is assumed the value "0:1". | ||
| 1114 | |||
| 1115 | For example to change the sample aspect ratio to 10:11, specify: | ||
| 1116 | @example | ||
| 1117 | setsar=10:11 | ||
| 1118 | @end example | ||
| 1119 | |||
| 1064 | @section settb | 1120 | @section settb |
| 1065 | 1121 | ||
| 1066 | Set the timebase to use for the output frames timestamps. | 1122 | Set the timebase to use for the output frames timestamps. |