BASS_CONFIG_3DALGORITHM config option


The 3D algorithm for software mixed 3D channels.

BASS_SetConfig(
    BASS_CONFIG_3DALGORITHM,
    DWORD algo
);

Parameters

algoOne of these algorithms.
BASS_3DALG_DEFAULTThe default algorithm. If the user has selected a surround sound speaker configuration (eg. 4 or 5.1) in the control panel, the sound is panned among the available directional speakers. Otherwise it equates to BASS_3DALG_OFF.
BASS_3DALG_OFFUses normal left and right panning. The vertical axis is ignored except for scaling of volume due to distance. Doppler shift and volume scaling are still applied, but the 3D filtering is not performed. This is the most CPU efficient algorithm, but provides no virtual 3D audio effect. Head Related Transfer Function processing will not be done. Since only normal stereo panning is used, a channel using this algorithm may be accelerated by a 2D hardware voice if no free 3D hardware voices are available.
BASS_3DALG_FULLThis algorithm gives the highest quality 3D audio effect, but uses more CPU. This algorithm requires WDM drivers, if it's not available then BASS_3DALG_OFF will automatically be used instead.
BASS_3DALG_LIGHTThis algorithm gives a good 3D audio effect, and uses less CPU than the FULL algorithm. This algorithm also requires WDM drivers, if it's not available then BASS_3DALG_OFF will automatically be used instead.

Remarks

These algorithms only affect 3D channels that are being mixed in software. BASS_ChannelGetInfo can be used to check whether a channel is being software mixed.

Changing the algorithm only affects subsequently created or loaded samples, musics, or streams; it does not affect any that already exist.

Platform-specific

On Windows, DirectX 7 or above is required for this option to have effect. On other platforms, only the BASS_3DALG_DEFAULT and BASS_3DALG_OFF options are available.

See also

BASS_GetConfig, BASS_SampleCreate, BASS_SampleLoad, BASS_SetConfig