Return the current general status of PlayIt.

=> | R0 = | volume

<= | R0 = | old volume setting

Sets the overall playback volume to the given value. The volume is scaled from 1 (slient) through 127 (normal = 100%) to 255 (amplify). 0 has no effect and can be used to read the volume without changing it.

The scaling is such that an increase (decrease) of 16 results in a doubling (halving) of the linear amplitude. ie 16 units corresponds to 3dB. The upper limit on linear ampfication is 16x (+12dB) so values above 192 are currently equivalent to 16. This logarithmic scale give a more natural sounding volume progression than a linear control would give due to the logarithm response of the human ear.

Note that the volume may also be scaled by the system volume if configured (see SWI PlayIt_Config 0). Amplification may be useful (volumes > 127) for playing low amplitude (ie quiet) samples or playing louder than the system volume currently allows. Distortion (due to clipping) will most likely occur if the amplification is too high.

By default, PlayIt's volume is independent of the system volume - see SWI PlayIt_Config 0.

Some useful reference volumes are:

R0 | linear | dB

0 | ÷256 | -24
31 | ÷64 | -18
63 | ÷16 | -12
95 | ÷4 | -6
127 | x1 | +0
159 | x4 | +6
191 | x16 | +12

[ Parent ] [ Manual root ]