Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 7 - Sound / Sound Reference

Protos / protoSoundChannel

SetInputGain

soundChannel:SetInputGain(gain)

Sets the amplification applied to the signal coming from the input device.

gain

An integer from 0 (no amplification) to 255 (maximum amplification) specifying the amplification to be applied to the input signal.

return value

Undefined; do not rely on it.

DISCUSSION

This method changes the input gain, in real time, of the current input channel (and because current hardware supports only one input source at a time, all other active input channels).

This method does not change the value of the inputGain slot in the sound channel frame.

*SetInputGain can be called only on open channels, otherwise an exception is thrown.

SEE ALSO

For more information on gain values, see "Setting the Input Gain".