F:/My Projects/LSEngine/Modules/LSSoundLib/Src/LSSSoundLib.h

#ifndef __LSS_SOUNDLIB_H__
#define __LSS_SOUNDLIB_H__

// Include the memory library.
#include "LSAMemLib.h"
using namespace ::lsa;

// Include the file library.
#include "LSFFileLib.h"
using namespace ::lsf;

// Include the thread library.
#include "LSHThreadLib.h"
using namespace ::lsh;

// Include the math library.
#include "LSMMathLib.h"
using namespace ::lsm;

// Include the standard library.
#include "LSSTDStandardLib.h"
using namespace ::lsstd;

// Include the LSTL.
#include "LSTLib.h"
using namespace ::lstl;


// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
// OPTIONS
// * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
// Do we use OpenAL for this sound implementation?
#define LSS_USEOPENAL

#ifdef LSS_USEOPENAL
#if defined( LSE_IPHONE ) || defined( LSE_MAC )
#include <OpenAL/al.h>
#include <OpenAL/alc.h>
#else
#include "al.h"
#include "alc.h"
#endif  // #ifdef LSE_IPHONE
#endif  // #ifdef LSS_USEOPENAL


namespace lss {

        // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
        // TYPES
        // * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
        // Define the precision used in our library.
#ifdef LSS_USEOPENAL
        typedef ALfloat                                                 LSSREAL;
#else   // #ifdef LSS_USEOPENAL
        typedef LSSFLOAT                                                LSSREAL;
#endif  // #ifdef LSS_USEOPENAL

        class CSoundLib {
        public :
                // == Enumerations.
                enum LSS_CHANNELS {
                        LSS_C_MONO8,
                        LSS_C_MONO16,
                        LSS_C_MONO_FLOAT32,
                        LSS_C_STEREO8,
                        LSS_C_STEREO16,
                        LSS_C_STEREO_FLOAT32,
                        LSS_C_MONO_IMA4,
                        LSS_C_STEREO_IMA4,
                        LSS_C_QUAD8_LOKI,
                        LSS_C_QUAD16_LOKI,
                        LSS_C_QUAD8,
                        LSS_C_QUAD16,
                        LSS_C_QUAD32,
                        LSS_C_51CHN8,
                        LSS_C_51CHN16,
                        LSS_C_51CHN32,
                        LSS_C_61CHN8,
                        LSS_C_61CHN16,
                        LSS_C_61CHN32,
                        LSS_C_71CHN8,
                        LSS_C_71CHN16,
                        LSS_C_71CHN32,
                        LSS_C_REAR8,
                        LSS_C_REAR16,
                        LSS_C_REAR32,
                        LSS_C_TOTAL
                };


                // == Functions.
                static LSVOID LSE_CALL                  InitSoundLibrary();

                static LSVOID LSE_CALL                  PostInitSoundLibrary();

                static LSVOID LSE_CALL                  ShutDownSoundLibrary();

                static LSUINT32 LSE_CALL                        GetTotalDevices();

                static LSUINT32 LSE_CALL                        GetLongestDeviceName();

                static LSBOOL LSE_CALL                  GetDeviceNameByIndex( LSUINT32 _ui32Index,
                        LSCHAR * _pcNameReturn, LSUINT32 _ui32MaxLen );

                static LSBOOL LSE_CALL                  ChannelArrangementSupported( LSS_CHANNELS _cArrangement );

                static LSUINT32 LSE_CALL                        GetOsChannelEnum( LSS_CHANNELS _cArrangement );

                static LSUINT32 LSE_CALL                        GetBitsPerChannel( LSS_CHANNELS _cArrangement );

                static LSUINT32 LSE_CALL                        GetChannels( LSS_CHANNELS _cArrangement );

        protected :
                // == Types.
#ifdef LSS_USEOPENAL

                typedef struct LSS_CHANNEL_ARRANGEMENT {
                        const LSCHAR *                                  pcEnumName;

                        LSUINT32                                                ui32EnumValue;

                        LSUINT32                                                ui32Bits;
                        
                        LSUINT32                                                ui32Channels;
                } * LPLSS_CHANNEL_ARRANGEMENT, * const LPCLSS_CHANNEL_ARRANGEMENT;
#endif  // #ifdef LSS_USEOPENAL

                // == Members.

#ifdef LSS_USEOPENAL
                // Do we have the ability to enumerate devices?
                static LSBOOL                                           m_bEnumDevices;

                // String of device names.  Each name is terminated with a NULL.  The end of the list is
                //      terminated with 2 NULL's.
                static const ALCchar *                          m_pcDevices;

                // Total number of devices.
                static LSUINT32                                 m_ui32Devices;

                // Longest device name (including its terminating NULL).
                static LSUINT32                                 m_ui32MaxDeviceNameLength;

                // Various enumerated values indicating the number and arrangement of channels.
                static LSS_CHANNEL_ARRANGEMENT          m_caChannels[LSS_C_TOTAL];

#endif  // #ifdef LSS_USEOPENAL

        };

}       // namespace lss

#endif  // __LSS_SOUNDLIB_H__