Unified · Split
| @@ -3135,7 +3135,7 @@ this goal *without* applying "dynamic range compressing". It will retain 100% · 3134 unmodified lines | ||
| 3135 | 3135 | of the dynamic range *within* each section of the audio file. |
| 3136 | 3136 | |
| 3137 | 3137 | @table @option |
| 3138 | −@item f | |
| 3138 | +@item framelen, f | |
| 3139 | 3139 | Set the frame length in milliseconds. In range from 10 to 8000 milliseconds. |
| 3140 | 3140 | Default is 500 milliseconds. |
| 3141 | 3141 | The Dynamic Audio Normalizer processes the input audio in small chunks, |
| @@ -3150,7 +3150,7 @@ been found to give good results with most files. · 8 unmodified lines | ||
| 3150 | 3150 | Note that the exact frame length, in number of samples, will be determined |
| 3151 | 3151 | automatically, based on the sampling rate of the individual input audio file. |
| 3152 | 3152 | |
| 3153 | −@item g | |
| 3153 | +@item gausssize, g | |
| 3154 | 3154 | Set the Gaussian filter window size. In range from 3 to 301, must be odd |
| 3155 | 3155 | number. Default is 31. |
| 3156 | 3156 | Probably the most important parameter of the Dynamic Audio Normalizer is the |
| @@ -3167,7 +3167,7 @@ Normalizer will behave like a "traditional" normalization filter. On the · 10 unmodified lines | ||
| 3167 | 3167 | contrary, the more you decrease this value, the more the Dynamic Audio |
| 3168 | 3168 | Normalizer will behave like a dynamic range compressor. |
| 3169 | 3169 | |
| 3170 | −@item p | |
| 3170 | +@item peak, p | |
| 3171 | 3171 | Set the target peak value. This specifies the highest permissible magnitude |
| 3172 | 3172 | level for the normalized audio input. This filter will try to approach the |
| 3173 | 3173 | target peak magnitude as closely as possible, but at the same time it also |
| @@ -3176,7 +3176,7 @@ A frame's maximum local gain factor is imposed directly by the target peak · 2 unmodified lines | ||
| 3176 | 3176 | magnitude. The default value is 0.95 and thus leaves a headroom of 5%*. |
| 3177 | 3177 | It is not recommended to go above this value. |
| 3178 | 3178 | |
| 3179 | −@item m | |
| 3179 | +@item maxgain, m | |
| 3180 | 3180 | Set the maximum gain factor. In range from 1.0 to 100.0. Default is 10.0. |
| 3181 | 3181 | The Dynamic Audio Normalizer determines the maximum possible (local) gain |
| 3182 | 3182 | factor for each input frame, i.e. the maximum gain factor that does not |
| @@ -3194,7 +3194,7 @@ Instead, a "sigmoid" threshold function will be applied. This way, the · 11 unmodified lines | ||
| 3194 | 3194 | gain factors will smoothly approach the threshold value, but never exceed that |
| 3195 | 3195 | value. |
| 3196 | 3196 | |
| 3197 | −@item r | |
| 3197 | +@item targetrms, r | |
| 3198 | 3198 | Set the target RMS. In range from 0.0 to 1.0. Default is 0.0 - disabled. |
| 3199 | 3199 | By default, the Dynamic Audio Normalizer performs "peak" normalization. |
| 3200 | 3200 | This means that the maximum local gain factor for each frame is defined |
| @@ -3212,7 +3212,7 @@ factor is defined as the factor that would result in exactly that RMS value. · 11 unmodified lines | ||
| 3212 | 3212 | Note, however, that the maximum local gain factor is still restricted by the |
| 3213 | 3213 | frame's highest magnitude sample, in order to prevent clipping. |
| 3214 | 3214 | |
| 3215 | −@item n | |
| 3215 | +@item coupling, n | |
| 3216 | 3216 | Enable channels coupling. By default is enabled. |
| 3217 | 3217 | By default, the Dynamic Audio Normalizer will amplify all channels by the same |
| 3218 | 3218 | amount. This means the same gain factor will be applied to all channels, i.e. |
| @@ -3224,7 +3224,7 @@ the gain factor will be determined independently for each channel, depending · 5 unmodified lines | ||
| 3224 | 3224 | only on the individual channel's highest magnitude sample. This allows for |
| 3225 | 3225 | harmonizing the volume of the different channels. |
| 3226 | 3226 | |
| 3227 | −@item c | |
| 3227 | +@item correctdc, c | |
| 3228 | 3228 | Enable DC bias correction. By default is disabled. |
| 3229 | 3229 | An audio signal (in the time domain) is a sequence of sample values. |
| 3230 | 3230 | In the Dynamic Audio Normalizer these sample values are represented in the |
| @@ -3243,7 +3243,7 @@ are centered around 0.0 again. Also, in order to avoid "gaps" at the frame · 12 unmodified lines | ||
| 3243 | 3243 | boundaries, the DC correction offset values will be interpolated smoothly |
| 3244 | 3244 | between neighbouring frames. |
| 3245 | 3245 | |
| 3246 | −@item b | |
| 3246 | +@item altboundary, b | |
| 3247 | 3247 | Enable alternative boundary mode. By default is disabled. |
| 3248 | 3248 | The Dynamic Audio Normalizer takes into account a certain neighbourhood |
| 3249 | 3249 | around each frame. This includes the preceding frames as well as the |
| @@ -3258,7 +3258,7 @@ to deal with this situation. The default boundary mode assumes a gain factor · 8 unmodified lines | ||
| 3258 | 3258 | of exactly 1.0 for the missing frames, resulting in a smooth "fade in" and |
| 3259 | 3259 | "fade out" at the beginning and at the end of the input, respectively. |
| 3260 | 3260 | |
| 3261 | −@item s | |
| 3261 | +@item compress, s | |
| 3262 | 3262 | Set the compress factor. In range from 0.0 to 30.0. Default is 0.0. |
| 3263 | 3263 | By default, the Dynamic Audio Normalizer does not apply "traditional" |
| 3264 | 3264 | compression. This means that signal peaks will not be pruned and thus the |
| @@ -82,15 +82,24 @@ typedef struct DynamicAudioNormalizerContext { · 81 unmodified lines | ||
| 82 | 82 | #define FLAGS AV_OPT_FLAG_AUDIO_PARAM|AV_OPT_FLAG_FILTERING_PARAM |
| 83 | 83 | |
| 84 | 84 | static const AVOption dynaudnorm_options[] = { |
| 85 | − { "f", "set the frame length in msec", OFFSET(frame_len_msec), AV_OPT_TYPE_INT, {.i64 = 500}, 10, 8000, FLAGS }, | |
| 86 | − { "g", "set the filter size", OFFSET(filter_size), AV_OPT_TYPE_INT, {.i64 = 31}, 3, 301, FLAGS }, | |
| 87 | − { "p", "set the peak value", OFFSET(peak_value), AV_OPT_TYPE_DOUBLE, {.dbl = 0.95}, 0.0, 1.0, FLAGS }, | |
| 88 | − { "m", "set the max amplification", OFFSET(max_amplification), AV_OPT_TYPE_DOUBLE, {.dbl = 10.0}, 1.0, 100.0, FLAGS }, | |
| 89 | − { "r", "set the target RMS", OFFSET(target_rms), AV_OPT_TYPE_DOUBLE, {.dbl = 0.0}, 0.0, 1.0, FLAGS }, | |
| 90 | − { "n", "set channel coupling", OFFSET(channels_coupled), AV_OPT_TYPE_BOOL, {.i64 = 1}, 0, 1, FLAGS }, | |
| 91 | − { "c", "set DC correction", OFFSET(dc_correction), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, FLAGS }, | |
| 92 | − { "b", "set alternative boundary mode", OFFSET(alt_boundary_mode), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, FLAGS }, | |
| 93 | − { "s", "set the compress factor", OFFSET(compress_factor), AV_OPT_TYPE_DOUBLE, {.dbl = 0.0}, 0.0, 30.0, FLAGS }, | |
| 85 | + { "framelen", "set the frame length in msec", OFFSET(frame_len_msec), AV_OPT_TYPE_INT, {.i64 = 500}, 10, 8000, FLAGS }, | |
| 86 | + { "f", "set the frame length in msec", OFFSET(frame_len_msec), AV_OPT_TYPE_INT, {.i64 = 500}, 10, 8000, FLAGS }, | |
| 87 | + { "gausssize", "set the filter size", OFFSET(filter_size), AV_OPT_TYPE_INT, {.i64 = 31}, 3, 301, FLAGS }, | |
| 88 | + { "g", "set the filter size", OFFSET(filter_size), AV_OPT_TYPE_INT, {.i64 = 31}, 3, 301, FLAGS }, | |
| 89 | + { "peak", "set the peak value", OFFSET(peak_value), AV_OPT_TYPE_DOUBLE, {.dbl = 0.95}, 0.0, 1.0, FLAGS }, | |
| 90 | + { "p", "set the peak value", OFFSET(peak_value), AV_OPT_TYPE_DOUBLE, {.dbl = 0.95}, 0.0, 1.0, FLAGS }, | |
| 91 | + { "maxgain", "set the max amplification", OFFSET(max_amplification), AV_OPT_TYPE_DOUBLE, {.dbl = 10.0}, 1.0, 100.0, FLAGS }, | |
| 92 | + { "m", "set the max amplification", OFFSET(max_amplification), AV_OPT_TYPE_DOUBLE, {.dbl = 10.0}, 1.0, 100.0, FLAGS }, | |
| 93 | + { "targetrms", "set the target RMS", OFFSET(target_rms), AV_OPT_TYPE_DOUBLE, {.dbl = 0.0}, 0.0, 1.0, FLAGS }, | |
| 94 | + { "r", "set the target RMS", OFFSET(target_rms), AV_OPT_TYPE_DOUBLE, {.dbl = 0.0}, 0.0, 1.0, FLAGS }, | |
| 95 | + { "coupling", "set channel coupling", OFFSET(channels_coupled), AV_OPT_TYPE_BOOL, {.i64 = 1}, 0, 1, FLAGS }, | |
| 96 | + { "n", "set channel coupling", OFFSET(channels_coupled), AV_OPT_TYPE_BOOL, {.i64 = 1}, 0, 1, FLAGS }, | |
| 97 | + { "correctdc", "set DC correction", OFFSET(dc_correction), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, FLAGS }, | |
| 98 | + { "c", "set DC correction", OFFSET(dc_correction), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, FLAGS }, | |
| 99 | + { "altboundary", "set alternative boundary mode", OFFSET(alt_boundary_mode), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, FLAGS }, | |
| 100 | + { "b", "set alternative boundary mode", OFFSET(alt_boundary_mode), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, FLAGS }, | |
| 101 | + { "compress", "set the compress factor", OFFSET(compress_factor), AV_OPT_TYPE_DOUBLE, {.dbl = 0.0}, 0.0, 30.0, FLAGS }, | |
| 102 | + { "s", "set the compress factor", OFFSET(compress_factor), AV_OPT_TYPE_DOUBLE, {.dbl = 0.0}, 0.0, 30.0, FLAGS }, | |
| 94 | 103 | { NULL } |
| 95 | 104 | }; |
| 96 | 105 | |