Tone detector control functions.

---

Detailed Description

The tone detector monitors its inputs for the presence of any of a number of tones.

Currently 25Hz and 35Hz tones can be detected independently on left and right channels. Tones that exceed the threshold set by HPI_ToneDetector_SetThreshold() are detected. The result of the detection is reflected in the controls state, and optionally by sending an async event with the new state. Tones must have a minimum duration of 200ms before they are detected.

Functions
ASX32_API ASX_ERROR	ASX_ToneDetector_SetEnable (ASX_HANDLE hToneDetector, const unsigned int nEnable)
	Turns the entire tone detector on and off.
ASX32_API ASX_ERROR	ASX_ToneDetector_GetEnable (ASX_HANDLE hToneDetector, unsigned int *nEnable)
	Returns whether the entire tone detector is on or off.
ASX32_API ASX_ERROR	ASX_ToneDetector_SetEventEnable (ASX_HANDLE hToneDetector, const unsigned int nEnable)
	Turns the event reporting function of the tone detector on and off.
ASX32_API ASX_ERROR	ASX_ToneDetector_GetEventEnable (ASX_HANDLE hToneDetector, unsigned int *nEnable)
	Returns whether the event reporting function of the tone detector is on or off.
ASX32_API ASX_ERROR	ASX_ToneDetector_SetThreshold (ASX_HANDLE hToneDetector, const float fThreshold)
	Sets the tone detector threshold (units of dB).
ASX32_API ASX_ERROR	ASX_ToneDetector_GetThreshold (ASX_HANDLE hToneDetector, float *fThreshold)
	Gets the tone detector threshold (units of dB) with respect to full scale eg.
ASX32_API ASX_ERROR	ASX_ToneDetector_GetState (ASX_HANDLE hToneDetector, unsigned int *nState)
	Gets the tone detector state.
ASX32_API ASX_ERROR	ASX_ToneDetector_GetFrequency (ASX_HANDLE hToneDetector, unsigned int nIndex, unsigned int *nState)
	Gets the centre frequency of each tone detector by index.

---

Function Documentation

ASX32_API ASX_ERROR ASX_ToneDetector_GetEnable (  ASX_HANDLE  hToneDetector, unsigned int *  nEnable )

Returns whether the entire tone detector is on or off. Parameters: hToneDetector  A handle to an ASX tone detector control. nEnable  A return value of 1 implies on, while 0 implies off. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned.

ASX32_API ASX_ERROR ASX_ToneDetector_GetEventEnable (  ASX_HANDLE  hToneDetector, unsigned int *  nEnable )

Returns whether the event reporting function of the tone detector is on or off. Parameters: hToneDetector  A handle to an ASX tone detector control. nEnable  A return value of 1 implies on, while 0 implies off. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned.

ASX32_API ASX_ERROR ASX_ToneDetector_GetFrequency (  ASX_HANDLE  hToneDetector, unsigned int  nIndex, unsigned int *  nState )

Gets the centre frequency of each tone detector by index. This can be used to determine the meanings of the state bits. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned.

ASX32_API ASX_ERROR ASX_ToneDetector_GetState (  ASX_HANDLE  hToneDetector, unsigned int *  nState )

Gets the tone detector state. The state is a bitfield. Pairs of bits represent left and right channels of detectors. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned.

ASX32_API ASX_ERROR ASX_ToneDetector_GetThreshold (  ASX_HANDLE  hToneDetector, float *  fThreshold )

Gets the tone detector threshold (units of dB) with respect to full scale eg. -20dBFS. Tones with level above -20dBFs threshold are detected Tones must have a minimum duration of 200ms before they are detected. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned.

ASX32_API ASX_ERROR ASX_ToneDetector_SetEnable (  ASX_HANDLE  hToneDetector, const unsigned int  nEnable )

Turns the entire tone detector on and off. Parameters: hToneDetector  A handle to an ASX tone detector control. nEnable  A value of 1 enables the tone detector and a value of 0 disables it. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned.

ASX32_API ASX_ERROR ASX_ToneDetector_SetEventEnable (  ASX_HANDLE  hToneDetector, const unsigned int  nEnable )

Turns the event reporting function of the tone detector on and off. Parameters: hToneDetector  A handle to an ASX tone detector control. nEnable  A value of 1 enables the tone detector event reporting and a value of 0 disables it. Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned.

ASX32_API ASX_ERROR ASX_ToneDetector_SetThreshold (  ASX_HANDLE  hToneDetector, const float  fThreshold )

Sets the tone detector threshold (units of dB). Returns: Returns 0 if there is no error, otherwise one of asxERROR is returned.

---