N64® Functions Menu

al - Audio Library Functions
gDP - DP GBI Macros
gdSP - General GBI Macros
gSP - SP GBI Macros
gt - Turbo Microcode RDP
gu - Graphics Utilities
Math - Math Functions
nuSys - NuSystem
os - N64 Operating System
sp - Sprite Library Functions
uh - Host to Target IO
64DD - N64 Disk Drive

Nintendo® Confidential

## osVoiceControlGain

Syntax

    #include <ultra64.h>

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

Explanation
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 osVoiceMaskDictionary() 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 (default)
1 | -3 dB

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

analog | Transmission system digital gain
0 | 0 dB (default)
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.

CONT_ERR_INVALID
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. Write your program so that this error does not occur when development is completed.

See Also
osContInit
osVoiceCheckWord
osVoiceClearDictionary
osVoiceCountSyllables
osVoiceGetReadData
osVoiceInit
osVoiceMaskDictionary
osVoiceSetWord
osVoiceStartReadData
osVoiceStopReadData

Nintendo® Confidential Warning: all information in this document is confidential and covered by a non-disclosure agreement. You are responsible for keeping this information confidential and protected. Nintendo will vigorously enforce this responsibility.
Copyright © 1998
Nintendo of America Inc. All rights reserved
Nintendo and N64 are registered trademarks of Nintendo
Last updated March 1998