Convert from linear amplitude to decibels (dB).
decibels = dbamp(ampval)
dbamp returns a corresponding decibel value for a linear amplitude value. The 16-bit (0-32767) linear amplitude range is approximately matched by a 1-90 decibel range (0 dB returns “-inf”).
NOTE: With the exception of boost, The RTcmix conversion functions follow a pattern. The command is divided into two halves, the one closest to the argument represent the format of the argument, and the one closest to the assignment represents the format to be returned. For example, “cpspch” is divided into “cps” and “pch”. The argument is in oct.pc form (“pch”) and the return value will be in cps (“cps”).
The various format specifiers are:
amp = linear amplitude (16-bit, 0-32767)
cps = cycles per second (Hz)
db = decibels
midi = MIDI note number (60 is middle C)
oct = linear octaves (8.5 is halfway between octave 8.00 [middle C] and 9.00)
pch = octave.pitch-class (oct.pc; 8.00 is middle C, 8.02 is D, 8.12 = 9.00 = C above middle C)
let = note-letter specification ("C4" is middle C, "C#4" is C-sharp above middle C,
"Gb5" is G-flat the octave above middle C octave. [see pitch-reps for more info])
dbval = dbamp(20000)
dbamp, boost, cpsmidi, cpslet, cpsoct, cpspch, midipch, octcps, octlet, octmidi, octpch, pchcps, pchlet, pchmidi, pchoct