|
1.0: Final Release | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
ObstructionControl
provides a mechanism to control the overall level of an audio
signal flowing directly from a sound source to the Spectator
.
Additionally, it provides the capability of filtering
(attenuating) the high frequency components of the signal to a specified degree.
The default values for the properties of all obstruction controls (whether the application has obtained them or not) are:
level = 0 mB
HFLevel = 0 mB
The following values, for example, could be used to simulate an object made of the listed material obstructing (only) the direct path between the SoundSource3D and the Spectator:
level (mB) | HFLevel (mB) | |
single window | -1988 | -812 |
double window | -2000 | -3000 |
thin door | -1188 | -612 |
thick door | -2816 | -1584 |
wood wall | -2000 | -2000 |
brick wall | -3000 | -2000 |
stone wall | -4080 | -1920 |
curtain | -180 | -1020 |
Method Summary | |
int |
getHFLevel()
Returns the level at which high frequency components are being transmitted directly from the source. |
int |
getLevel()
Returns the overall level being transmitted directly from the source. |
void |
setHFLevel(int HFLevel)
Sets the level at which high frequency components will be transmitted directly from the source. |
void |
setLevel(int level)
Sets the overall level that will be transmitted directly from the source. |
Method Detail |
public void setLevel(int level)
level
- the new output level in millibels (mB, 1 mB = 1/100 dB) at which the sound directly
from a source will be heard compared to a non-obstructed source; must be a non-positive value.
Setting the level to 0 makes the source non-obstructed.
java.lang.IllegalArgumentException
- if the given level is positivepublic int getLevel()
public void setHFLevel(int HFLevel)
HFLevel
- the new output level at 5000 Hz in millibels (mB, 1 mB = 1/100 dB)
at which the sound directly
from a source will be heard compared to the overall level of the source;
must be a non-positive value.
Setting the level to 0 makes the source's frequency response flat.
java.lang.IllegalArgumentException
- if the given level is positivepublic int getHFLevel()
|
1.0: Final Release | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |