osVoiceControlGain osVoiceControlGain (function)

Adjusts the input gain of the Voice Recognition System


#include <ultra64.h> /* ultra64.h */

s32 osVoiceControlGain(OSVoiceHandle *hd, s32 analog, s32 digital);


The osVoiceControlGain function is for adjusting the gain of the input voice in the Voice Recognition System. The strength of the input voice signal can be changed by adjusting the gain. If the input voice is too strong, try decreasing the gain to decrease the voice level (normally, there is no particular need to change the gain).

hd is the Voice Recognition System control structure. The Voice Recognition System must be initialized with the osVoiceInit function before the osVoiceControlGain() function is called.

analog is the analog gain of the transmission system. The analog gain is for adjusting the strength of the voice signal which is input from the microphone. The following values are available.

analog Transmission system analog gain
0 0 dB
1 -3 dB

digital is the digital gain of the transmission system. The digital gain is for adjusting the strength of the digital signal converted from the analog voice signal. The following values are available.

digital Transmission system digital gain
0 0 dB
1 -0.4 dB
2 -0.8 dB
3 -1.2 dB
4 -1.6 dB
5 -2.0 dB
6 -2.4 dB
7 -2.8 dB

The returned value is an error code. A 0 (zero) is returned when processing ends normally. If an error occurs, this function has the following error codes.


There is an error in the function call method or in the argument. This error will not occur if the function is being used correctly.

See also

osVoiceCheckWord, osVoiceClearDictionary, osVoiceCountSyllables, osVoiceGetReadData, osVoiceInit, osContInit, osVoiceSetWord, osVoiceStartReadData, and osVoiceStopReadData

Revision History

1999/04/30 Changed Format