[Function]

(amplitude amp [softest] [loudest] [power])

Converts a logical amplitude amp to an amplitude value according to its optional arguments. A logical amplitude is a value from 0.0 to 1.0 inclusive, or one of the following symbols:

niente pppp ppp pp p mp mf f ff fff ffff

amplitude supports the following optional arguments:

softest

The value to return when amp is 0 or niente. The default value is *softest*.

loudest

The value to return when amp is 1 or ffff. The default value is *loudest*.

power

If power is 1 then the amplitude returned is calculated linearly, otherwise the value lies on an exponential curve amp^power. The default value is *power*.

Examples:

(amplitude 'mp)
⇒ .5
(amplitude 'mp 0 127)
⇒ 63.5
(amplitude .5 0 1 4)
⇒ 0.0625

See also:

• *loudest* [Variable]
• *power* [Variable]
• *softest* [Variable]