Previous Topic Index Next Topic
[API function]

FSOUND_SetSpeakerMode

Sets the mode for the users speaker setup.

void F_API FSOUND_SetSpeakerMode(
unsigned int speakermode
);

Parameters

speakermode This is an enum describing the users speaker setup.

Return Value

void

Remarks

Note - Only reliably works with FSOUND_OUTPUT_DSOUND or FSOUND_OUTPUT_XBOX output modes. Other output modes will only
interpret FSOUND_SPEAKERMODE_MONO and set everything else to be stereo.
----------------------------------
To get true 5.1 dolby digital or DTS output you will need a soundcard that can encode it, and a receiver that can decode it.
If not the results can be unpredictable.
----------------------------------
Calling this will reset the pan separation setting. It sets it to 0 if FSOUND_SPEAKERMODE_MONO is chosen, and 1 otherwise.
You will need to reset the pan separation if required afterwards.
Note that some soundcard drivers may ignore this call.
----------------------------------
XBOX only - This function MUST be called before FSOUND_Init to change the default speaker mode. To change on the fly, you must close down FMOD with FSOUND_Close then re-initialize it with FSOUND_Init.
If it is called after FSOUND_Init, only headphone speakermode is interpreted to switch headphone mode on and off.
___________________
Supported on the following platforms : Win32, WinCE, Linux, Macintosh, XBox, PlayStation 2

See Also

FSOUND_Close , FSOUND_Init , FSOUND_SetPanSeperation , FSOUND_SPEAKERMODES

This document copyright ©Firelight Technologies, Pty, Ltd, 1999-2002. All rights reserved.
Generated Fri Dec 20 16:31:09 2002 by SourceDoc v0.10, the automated source code documenter.