Sound::GetSoundProperty

Defined in: C4Sound.h

Returns a sound property.

Prototype

float GetSoundProperty(int32 property) const;

Parameters

property The identifier of the property to return.

Description

The GetSoundProperty function returns one of the sound properties listed below.

`kSoundVolume`	The master volume for the sound. All other volumes are relative to this volume. The default value is 1.0.
`kSoundDirectVolume`	The volume applied to the sound's direct path. The default value is 1.0, representing no obstruction.
`kSoundDirectHFVolume`	High-frequency volume applied to the sound's direct path. A value of 1.0 means no high-frequency damping, and 0.0 means maximum damping. The default value is 1.0, representing no obstruction.
`kSoundReflectionVolume`	The volume of reflections (and subsequent reverberation) generated by the sound. The default value is 1.0.
`kSoundReflectionHFVolume`	High-frequency volume applied to reflections generated by the sound. A value of 1.0 means no high-frequency damping, and 0.0 means maximum damping. The default value is 1.0.
`kSoundOuterConeVolume`	The volume of a directional sound outside the outer cone. The default value is 0.0.
`kSoundOuterConeHFVolume`	High-frequency volume applied outside the outer cone. A value of 1.0 means no high-frequency damping, and 0.0 means maximum damping. The default value is 1.0.
`kSoundMinAttenDistance`	The distance below which the sound is unattenuated and plays at full volume. This must be greater than or equal to 0.0. The default value is 0.0.
`kSoundMaxAttenDistance`	The distance above which the sound is completely silent due to attenuation. This must be greater than the value of `kSoundMinAttenDistance`. The default value is 16.0.
`kSoundInnerConeCosine`	The cosine of the inner sound cone's apex angle. This must be in the range [−1.0, 1.0]. The default value is 1.0.
`kSoundOuterConeCosine`	The cosine of the outer sound cone's apex angle. This must be in the range [−1.0, 1.0]. The default value is 0.0.
`kSoundFrequency`	The relative frequency at which the sound is played. This must be a positive number. A value of 1.0 (the default) means play at the frequency of the source data, a value of 0.5 means play at half the frequency, and so on. Values greater than 1.0 are allowed, but sound quality may be diminished.