DemoGL::Reference::Structures::SSoundElement3DAttributes

SSoundElement3DAttributes

SSoundElement3DAttributes specifies the 3D specific properties of the behaviour of the sound played by a sound channel.

typedef struct
{
	DWORD	m_dw3DMode;
	float	m_fMinimalDistance;
	float	m_fMaximalDistance;
	int	m_iInsideProjectionConeAngle;
	int	m_iOutsideProjectionConeAngle;
	int	m_iDeltaVolumeOutsideOuterProjectionCone;
} SSoundElement3DAttributes;
Members.
m_dw3DMode
Specifies the 3D mode used. Can be one of the following values:

3D Mode Description
BASS_3DMODE_NORMAL Normal 3D mode.
BASS_3DMODE_RELATIVE The 3D position is relative to the listener. If the listener position is changed, the sound position isn't changed
BASS_3DMODE_OFF Will turn off 3D processing. Play will continue in the center.

These values are defined in the include file DemoGL_Bass.h.

m_fMinimalDistance
Specifies the minimal distance between the global listener and the sound channel. The channel's volume stops increasing when the global listener is within m_fMinimalDistance units from the sound channel.
m_fMaximalDistance
Specifies the maximum distance between the global listener and the sound channel. The channel's volume stops decreasing when the global listener is within m_fMaximumDistance units from the sound channel.
m_iInsideProjectionConeAngle
Specifies the angle of the inside projection cone in degrees. Legal values have to fall in the range [0,360], with 0 is no cone and 360 is a sphere.
m_iOutsideProjectionConeAngle
Specifies the angle of the outside projection cone in degrees. Legal values have to fall in the range [0,360], with 0 is no cone and 360 is a sphere.
m_iDeltaVolumeOutsideOuterProjectionCone
Specifies the delta-volume outside the outer projection cone. Legal values have to fall in the range [0,100], with 0 is silent and 100 is the same as inside the cone.

Remarks.
Used with DEMOGL_SoundSystemSetChannel3DPosition and DEMOGL_SoundSystemSetElement3DAttributes. m_iInsideProjectionConeAngle and m_iOutsideProjectionConeAngle angles decide how wide the sound is projected around the orientation angle of the channel. Within m_iInsideProjectionConeAngle the volume level is the channel volume, as set with DEMOGL_SoundSystemSetChannelAttributes for example. Outside m_iOutsideProjectionConeAngle, the volume changes according to the m_iDeltaVolumeOutsideOuterProjectionCone value. Between the m_iInsideProjectionConeAngle and m_iOutsideProjectionConeAngle angles, the volume gradually changes between the inner and outer volume levels. If the m_iInsideProjectionConeAngle and m_iOutsideProjectionConeAngle angles are 360 degrees, then the sound is transmitted equally in all directions.

Requirements.
DemoGL v1.3 (build 0112 or higher)

See also.
DEMOGL_SoundSystemSetChannelAttributes, DEMOGL_SoundSystemSetChannel3DAttributes, DEMOGL_SoundSystemSetElement3DAttributes

Last changed on 20-jan-2001

©1999-2001 Solutions Design