Amplify
From Avisynth wiki
(Difference between revisions)
Raffriff42 (Talk | contribs) (clarify AmplifyDB w/ examples; clarify negative scale factor; delete obsolete "converted to 16 bits in the process") |
(add link to avs+ documentation) |
||
| (5 intermediate revisions by 2 users not shown) | |||
| Line 1: | Line 1: | ||
| − | + | <div style="max-width:62em" > | |
| + | <div {{BlueBox2|40|0|3px solid purple}} > | ||
| + | {{AvsPlusFullname}}<br> | ||
| + | Up-to-date documentation: [https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/amplify.html https://avisynthplus.readthedocs.io] | ||
| + | </div> | ||
| − | |||
| − | + | These filters amplify the audio of the clip by the prescribed amount. You can specify different {{FuncArg|amount}} arguments for each channel. If there are more arguments than there are channels, the extra ones are ignored. If there are fewer arguments than channels, the last one is applied to the rest of the channels. | |
| + | 8bit and 24bit audio is converted to [[Float|float]]; the other audio formats are kept as they are. See [[ConvertAudio]]. | ||
| − | |||
| − | + | {{FuncDefH4|Amplify}} | |
| − | + | {{FuncDef|Amplify(clip, float ''amount'' [, float ''amount'' ]...)}} | |
| + | :{{Par2|amount|float|1.0}} | ||
| + | ::Multiply (scale) the audio by {{FuncArg|amount}}; values are linear : | ||
| + | ::*{{FuncArg|amount}} > 1.0 increases volume | ||
| + | ::*{{FuncArg|amount}} < 1.0 decreases volume | ||
| + | ::*{{FuncArg|amount}} = 1.0 retains the same volume (default) | ||
| + | ::*Negative scale factors will shift the [http://www.soundonsound.com/sos/apr08/articles/phasedemystified.htm phase] by 180 degrees (i.e. invert the samples) | ||
| − | |||
| − | + | {{FuncDefH4|AmplifyDB}} | |
| + | {{FuncDef|AmplifyDB(clip, float ''amount'' [, float ''amount'' ]...)}} | ||
| + | :{{Par2|amount|float|0.0}} | ||
| + | ::Multiply (scale) the audio by {{FuncArg|amount}}; values are in dB ([[wikipedia:Decibel|decibels]]) : | ||
| + | ::*{{FuncArg|amount}} > 0.0 increases volume | ||
| + | ::*{{FuncArg|amount}} < 0.0 decreases volume | ||
| + | ::*{{FuncArg|amount}} = 0.0 retains the same volume (default) | ||
| + | |||
| + | |||
| + | The relation between ''linear'' and ''decibel'' gain control is: | ||
| + | ::'''lin''' = 10<sup> ('''dB'''/20)</sup> | ||
| + | ::'''dB''' = 20'''·'''log<sub>10</sub>('''lin''') | ||
| + | For example, | ||
| + | :*<tt>AmplifyDB( 0.0)</tt> ''is equivalent to'' <tt>Amplify(1.0) </tt> (no change) | ||
| + | :*<tt>AmplifyDB( 6.0)</tt> ''is equivalent to'' <tt>Amplify(2.0) </tt> (about twice as loud) | ||
| + | :*<tt>AmplifyDB( -6.0)</tt> ''is equivalent to'' <tt>Amplify(0.5) </tt> (about half as loud) | ||
| + | :*<tt>AmplifyDB( 20.0)</tt> ''is equivalent to'' <tt>Amplify(10) </tt> (much louder) | ||
| + | :*<tt>AmplifyDB(-20.0)</tt> ''is equivalent to'' <tt>Amplify(0.1) </tt> (much softer) | ||
| + | |||
| + | |||
| + | More examples: | ||
| + | :*<tt>AmplifyDB(+3, 0)</tt> increases the volume of the left channel by a small amount. | ||
| + | :*<tt>Amplify(-1, 1)</tt> inverts the phase of the left channel. See Wikipedia: [[Wikipedia:Out_Of_Phase_Stereo|Out Of Phase Stereo]]. | ||
| + | |||
| + | ==== See Also ==== | ||
| + | * [[Normalize]] - with ''show=true'', can show the maximum amplification possible without [[Wikipedia:Clipping_%28audio%29|clipping]]. | ||
| + | |||
| + | </div> | ||
[[Category:Internal filters]] | [[Category:Internal filters]] | ||
| + | [[Category:Audio_filters]] | ||
Latest revision as of 05:32, 18 September 2022
AviSynth+
Up-to-date documentation: https://avisynthplus.readthedocs.io
These filters amplify the audio of the clip by the prescribed amount. You can specify different amount arguments for each channel. If there are more arguments than there are channels, the extra ones are ignored. If there are fewer arguments than channels, the last one is applied to the rest of the channels.
8bit and 24bit audio is converted to float; the other audio formats are kept as they are. See ConvertAudio.
Amplify(clip, float amount [, float amount ]...)
- float amount = 1.0
- Multiply (scale) the audio by amount; values are linear :
- amount > 1.0 increases volume
- amount < 1.0 decreases volume
- amount = 1.0 retains the same volume (default)
- Negative scale factors will shift the phase by 180 degrees (i.e. invert the samples)
- Multiply (scale) the audio by amount; values are linear :
AmplifyDB(clip, float amount [, float amount ]...)
- float amount = 0.0
- Multiply (scale) the audio by amount; values are in dB (decibels) :
- amount > 0.0 increases volume
- amount < 0.0 decreases volume
- amount = 0.0 retains the same volume (default)
- Multiply (scale) the audio by amount; values are in dB (decibels) :
The relation between linear and decibel gain control is:
- lin = 10 (dB/20)
- dB = 20·log10(lin)
For example,
- AmplifyDB( 0.0) is equivalent to Amplify(1.0) (no change)
- AmplifyDB( 6.0) is equivalent to Amplify(2.0) (about twice as loud)
- AmplifyDB( -6.0) is equivalent to Amplify(0.5) (about half as loud)
- AmplifyDB( 20.0) is equivalent to Amplify(10) (much louder)
- AmplifyDB(-20.0) is equivalent to Amplify(0.1) (much softer)
More examples:
- AmplifyDB(+3, 0) increases the volume of the left channel by a small amount.
- Amplify(-1, 1) inverts the phase of the left channel. See Wikipedia: Out Of Phase Stereo.
