void AL_SoundInfo( void ) {
Com_Printf( "AL_VENDOR: %s\n", qalGetString( AL_VENDOR ) );
Com_Printf( "AL_RENDERER: %s\n", qalGetString( AL_RENDERER ) );
Com_Printf( "AL_VERSION: %s\n", qalGetString( AL_VERSION ) );
Com_Printf( "AL_EXTENSIONS: %s\n", qalGetString( AL_EXTENSIONS ) );
Com_Printf( "Number of sources: %d\n", s_numchannels );
}
/*
=================
S_AL_SoundInfo
=================
*/
static
void S_AL_SoundInfo( void )
{
Com_Printf( "OpenAL info:\n" );
Com_Printf( " Vendor: %s\n", qalGetString( AL_VENDOR ) );
Com_Printf( " Version: %s\n", qalGetString( AL_VERSION ) );
Com_Printf( " Renderer: %s\n", qalGetString( AL_RENDERER ) );
Com_Printf( " Extensions: %s\n", qalGetString( AL_EXTENSIONS ) );
if(qalcIsExtensionPresent(NULL, "ALC_ENUMERATION_EXT"))
{
Com_Printf(" Device: %s\n", qalcGetString(alDevice, ALC_DEVICE_SPECIFIER));
Com_Printf("Available Devices:\n%s", s_alAvailableDevices->string);
}
}
qboolean SndAl_Init( void )
{
const char *device = NULL;
// Original console variables
s_volume = si.Cvar_Get( "s_volume", "0.8", CVAR_ARCHIVE );
s_musicVolume = si.Cvar_Get( "s_musicvolume", "0.25", CVAR_ARCHIVE );
s_doppler = si.Cvar_Get( "s_doppler", "1", CVAR_ARCHIVE );
// New console variables
s_precache = si.Cvar_Get( "al_precache", "1", CVAR_ARCHIVE );
s_gain = si.Cvar_Get( "al_gain", "0.4", CVAR_ARCHIVE );
s_sources = si.Cvar_Get( "al_sources", "64", CVAR_ARCHIVE );
s_dopplerFactor = si.Cvar_Get( "al_dopplerfactor", "1.0", CVAR_ARCHIVE );
s_dopplerSpeed = si.Cvar_Get( "al_dopplerspeed", "2200", CVAR_ARCHIVE );
s_minDistance = si.Cvar_Get( "al_mindistance", "80", CVAR_ARCHIVE );
s_rolloff = si.Cvar_Get( "al_rolloff", "0.25", CVAR_ARCHIVE );
s_alDevice = si.Cvar_Get( "al_device", "", CVAR_ARCHIVE | CVAR_LATCH );
#ifdef USE_OPENAL_DLOPEN
s_alDriver = si.Cvar_Get( "al_driver", ALDRIVER_DEFAULT, CVAR_ARCHIVE );
#endif // USE_OPENAL_DLOPEN
#ifdef USE_OPENAL_DLOPEN
// Load QAL
if ( !QAL_Init( s_alDriver->string ) )
{
si.Printf( PRINT_ALL, "not initializing.\n" );
return qfalse;
}
#endif // USE_OPENAL_DLOPEN
// Open default device
device = s_alDevice->string;
if ( device && !*device )
{
device = NULL;
}
if ( qalcIsExtensionPresent( NULL, "ALC_ENUMERATION_EXT" ) )
{
char devicenames[ 1024 ] = "";
const char *devicelist;
#ifdef _WIN32
const char *defaultdevice;
#endif
int curlen;
// get all available devices + the default device name.
devicelist = qalcGetString( NULL, ALC_DEVICE_SPECIFIER );
#ifdef _WIN32
defaultdevice = qalcGetString( NULL, ALC_DEFAULT_DEVICE_SPECIFIER );
// check whether the default device is generic hardware. If it is, change to
// Generic Software as that one works more reliably with various sound systems.
// If it's not, use OpenAL's default selection as we don't want to ignore
// native hardware acceleration.
if ( !device && !strcmp( defaultdevice, "Generic Hardware" ) )
{
device = "Generic Software";
}
#endif
// dump a list of available devices to a cvar for the user to see.
#ifndef MACOS_X
while ( ( curlen = strlen( devicelist ) ) )
{
strcat( devicenames, devicelist );
strcat( devicenames, "\n" );
devicelist += curlen + 1;
}
#endif
s_alAvailableDevices = si.Cvar_Get( "al_AvailableDevices", devicenames, CVAR_ROM | CVAR_NORESTART );
}
alDevice = qalcOpenDevice( device );
if ( !alDevice && device )
{
si.Printf( PRINT_ALL, "Failed to open OpenAL device '%s', trying default.\n", device );
alDevice = qalcOpenDevice( NULL );
}
if ( !alDevice )
{
#ifdef USE_OPENAL_DLOPEN
QAL_Shutdown();
#endif
si.Printf( PRINT_ALL, "Failed to open OpenAL device.\n" );
return qfalse;
}
// Create OpenAL context
alContext = qalcCreateContext( alDevice, NULL );
if ( !alContext )
{
#ifdef USE_OPENAL_DLOPEN
QAL_Shutdown();
#endif
qalcCloseDevice( alDevice );
si.Printf( PRINT_ALL, "Failed to create context\n" );
return qfalse;
}
qalcMakeContextCurrent( alContext );
qalcProcessContext( alContext );
// Print OpenAL information
si.Printf( PRINT_ALL, "OpenAL initialised\n" );
si.Printf( PRINT_ALL, " Vendor: %s\n", qalGetString( AL_VENDOR ) );
si.Printf( PRINT_ALL, " Version: %s\n", qalGetString( AL_VERSION ) );
si.Printf( PRINT_ALL, " Renderer: %s\n", qalGetString( AL_RENDERER ) );
si.Printf( PRINT_ALL, " AL Extensions: %s\n", qalGetString( AL_EXTENSIONS ) );
si.Printf( PRINT_ALL, " ALC Extensions: %s\n", qalcGetString( alDevice, ALC_EXTENSIONS ) );
if ( qalcIsExtensionPresent( NULL, "ALC_ENUMERATION_EXT" ) )
{
si.Printf( PRINT_ALL, " Device: %s\n", qalcGetString( alDevice, ALC_DEVICE_SPECIFIER ) );
si.Printf( PRINT_ALL, "Available Devices:\n%s", s_alAvailableDevices->string );
}
// Check for Linux shutdown race condition
if ( !strcmp( qalGetString( AL_VENDOR ), "J. Valenzuela" ) )
{
snd_shutdown_bug = qtrue;
}
// Initialize sources, buffers, music
al_buf_init();
al_src_init();
// Set up OpenAL parameters (doppler, etc)
qalDistanceModel( AL_INVERSE_DISTANCE_CLAMPED );
qalDopplerFactor( s_dopplerFactor->value );
qalDopplerVelocity( s_dopplerSpeed->value );;
// Add commands
si.Cmd_AddCommand( "play", S_Play_f );
si.Cmd_AddCommand( "music", S_Music_f );
#ifdef USE_VOIP
SndAl_InitCapture( qtrue );
#endif
// Init successful
si.Printf( PRINT_ALL, "initialization successful\n" );
return qtrue;
}
/*
* S_Init
*/
static qboolean S_Init( void *hwnd, int maxEntities, qboolean verbose )
{
int numDevices;
int userDeviceNum = -1;
char *devices, *defaultDevice;
cvar_t *s_openAL_device;
alDevice = NULL;
alContext = NULL;
// get system default device identifier
defaultDevice = ( char * )qalcGetString( NULL, ALC_DEFAULT_DEVICE_SPECIFIER );
if( !defaultDevice )
{
Com_Printf( "Failed to get openAL default device\n" );
return qfalse;
}
s_openAL_device = trap_Cvar_Get( "s_openAL_device", ALDEVICE_DEFAULT ? ALDEVICE_DEFAULT : defaultDevice, CVAR_ARCHIVE|CVAR_LATCH_SOUND );
devices = ( char * )qalcGetString( NULL, ALC_DEVICE_SPECIFIER );
for( numDevices = 0; *devices; devices += strlen( devices ) + 1, numDevices++ )
{
if( !Q_stricmp( s_openAL_device->string, devices ) )
{
userDeviceNum = numDevices;
// force case sensitive
if( strcmp( s_openAL_device->string, devices ) )
trap_Cvar_ForceSet( "s_openAL_device", devices );
}
}
if( !numDevices )
{
Com_Printf( "Failed to get openAL devices\n" );
return qfalse;
}
// the device assigned by the user is not available
if( userDeviceNum == -1 )
{
Com_Printf( "'s_openAL_device': incorrect device name, reseting to default\n" );
trap_Cvar_ForceSet( "s_openAL_device", ALDEVICE_DEFAULT ? ALDEVICE_DEFAULT : defaultDevice );
devices = ( char * )qalcGetString( NULL, ALC_DEVICE_SPECIFIER );
for( numDevices = 0; *devices; devices += strlen( devices ) + 1, numDevices++ )
{
if( !Q_stricmp( s_openAL_device->string, devices ) )
userDeviceNum = numDevices;
}
if( userDeviceNum == -1 )
trap_Cvar_ForceSet( "s_openAL_device", defaultDevice );
}
alDevice = qalcOpenDevice( (const ALchar *)s_openAL_device->string );
if( !alDevice )
{
Com_Printf( "Failed to open device\n" );
return qfalse;
}
// Create context
alContext = qalcCreateContext( alDevice, NULL );
if( !alContext )
{
Com_Printf( "Failed to create context\n" );
return qfalse;
}
qalcMakeContextCurrent( alContext );
if( verbose )
{
Com_Printf( "OpenAL initialized\n" );
if( numDevices )
{
int i;
Com_Printf( " Devices: " );
devices = ( char * )qalcGetString( NULL, ALC_DEVICE_SPECIFIER );
for( i = 0; *devices; devices += strlen( devices ) + 1, i++ )
Com_Printf( "%s%s", devices, ( i < numDevices - 1 ) ? ", " : "" );
Com_Printf( "\n" );
if( defaultDevice && *defaultDevice )
Com_Printf( " Default system device: %s\n", defaultDevice );
Com_Printf( "\n" );
}
Com_Printf( " Device: %s\n", qalcGetString( alDevice, ALC_DEVICE_SPECIFIER ) );
Com_Printf( " Vendor: %s\n", qalGetString( AL_VENDOR ) );
Com_Printf( " Version: %s\n", qalGetString( AL_VERSION ) );
Com_Printf( " Renderer: %s\n", qalGetString( AL_RENDERER ) );
Com_Printf( " Extensions: %s\n", qalGetString( AL_EXTENSIONS ) );
}
// Check for Linux shutdown race condition
if( !Q_stricmp( qalGetString( AL_VENDOR ), "J. Valenzuela" ) )
snd_shutdown_bug = qtrue;
qalDopplerFactor( s_doppler->value );
qalDopplerVelocity( s_sound_velocity->value > 0.0f ? s_sound_velocity->value : 0.0f );
if( qalSpeedOfSound ) // opelAL 1.1 only. alDopplerVelocity being deprecated
qalSpeedOfSound( s_sound_velocity->value > 0.0f ? s_sound_velocity->value : 0.0f );
s_doppler->modified = qfalse;
S_SetAttenuationModel( S_DEFAULT_ATTENUATION_MODEL, S_DEFAULT_ATTENUATION_MAXDISTANCE, S_DEFAULT_ATTENUATION_REFDISTANCE );
S_LockBackgroundTrack( qfalse );
if( !S_InitDecoders( verbose ) )
{
Com_Printf( "Failed to init decoders\n" );
return qfalse;
}
if( !S_InitSources( maxEntities, verbose ) )
{
Com_Printf( "Failed to init sources\n" );
return qfalse;
}
return qtrue;
}
void QAL_Info(void)
{
Com_Printf("AL_VENDOR: %s\n", qalGetString(AL_VENDOR));
Com_Printf("AL_RENDERER: %s\n", qalGetString(AL_RENDERER));
Com_Printf("AL_VERSION: %s\n", qalGetString(AL_VERSION));
Com_DPrintf("AL_EXTENSIONS: %s\n", qalGetString(AL_EXTENSIONS));
// print out available devices
if (qalcIsExtensionPresent(NULL, "ALC_ENUMERATE_ALL_EXT"))
{
const char *devs = qalcGetString(NULL, ALC_ALL_DEVICES_SPECIFIER);
Com_Printf("\nAvailable OpenAL devices:\n");
if (devs == NULL)
{
// no devices, might be an old OpenAL 1.0 or prior system...
Com_Printf(S_COLOR_RED "- No devices found. Depending on your\n");
Com_Printf(S_COLOR_RED " platform this may be expected and\n");
Com_Printf(S_COLOR_RED " doesn't indicate a problem!\n");
}
else
{
while (devs && *devs)
{
Com_Printf("- %s\n", devs);
devs += strlen(devs) + 1;
}
}
}
// print out current device
if (qalcIsExtensionPresent(NULL, "ALC_ENUMERATE_ALL_EXT"))
{
const char *devs = qalcGetString(device, ALC_DEVICE_SPECIFIER);
Com_Printf("\nCurrent OpenAL device:\n");
if (devs == NULL)
Com_Printf("- No OpenAL device in use\n");
else
Com_Printf("- %s\n", devs);
}
// grab frequency for device
{
ALCint attr_size;
ALCint * attributes;
int i = 0;
qalcGetIntegerv(device, ALC_ATTRIBUTES_SIZE, sizeof(attr_size), &attr_size);
attributes = (ALCint *)Z_TagMalloc(attr_size * sizeof(ALCint), 0);
qalcGetIntegerv(device, ALC_ALL_ATTRIBUTES, attr_size, attributes);
for (i = 0; i < attr_size; i += 2)
{
if (attributes[i] == ALC_FREQUENCY)
Com_Printf("ALC_FREQUENCY: %i\n", attributes[i + 1]);
}
Z_Free(attributes);
}
// check for hrtf support
if (qalcIsExtensionPresent(device, "ALC_SOFT_HRTF"))
{
alcGetIntegerv(device, ALC_HRTF_SOFT, 1, &hrtf_state);
if (!hrtf_state)
{
Com_Printf(S_COLOR_RED "HRTF not enabled!\n");
}
else
{
const ALchar *name = alcGetString(device, ALC_HRTF_SPECIFIER_SOFT);
Com_Printf(S_COLOR_GREEN "HRTF enabled, using %s\n", name);
}
}
}
/*
* S_Init
*/
qboolean S_Init( void *hwnd, int maxEntities, qboolean verbose )
{
int numDevices;
int userDeviceNum = -1;
char *devices, *defaultDevice;
soundpool = S_MemAllocPool( "OpenAL sound module" );
alDevice = NULL;
alContext = NULL;
#ifdef OPENAL_RUNTIME
if( !QAL_Init( ALDRIVER, verbose ) )
{
#ifdef ALDRIVER_ALT
if( !QAL_Init( ALDRIVER_ALT, verbose ) )
#endif
{
Com_Printf( "Failed to load OpenAL library: %s\n", ALDRIVER );
goto fail_no_device;
}
}
#endif
// get system default device identifier
defaultDevice = ( char * )qalcGetString( NULL, ALC_DEFAULT_DEVICE_SPECIFIER );
if( !defaultDevice )
{
Com_Printf( "Failed to get openAL default device\n" );
goto fail_no_device;
}
s_openAL_device = trap_Cvar_Get( "s_openAL_device", ALDEVICE_DEFAULT ? ALDEVICE_DEFAULT : defaultDevice, CVAR_ARCHIVE|CVAR_LATCH_SOUND );
devices = ( char * )qalcGetString( NULL, ALC_DEVICE_SPECIFIER );
for( numDevices = 0; *devices; devices += strlen( devices ) + 1, numDevices++ )
{
if( !Q_stricmp( s_openAL_device->string, devices ) )
{
userDeviceNum = numDevices;
// force case sensitive
if( strcmp( s_openAL_device->string, devices ) )
trap_Cvar_ForceSet( "s_openAL_device", devices );
}
}
if( !numDevices )
{
Com_Printf( "Failed to get openAL devices\n" );
goto fail_no_device;
}
// the device assigned by the user is not available
if( userDeviceNum == -1 )
{
Com_Printf( "'s_openAL_device': incorrect device name, reseting to default\n" );
trap_Cvar_ForceSet( "s_openAL_device", ALDEVICE_DEFAULT ? ALDEVICE_DEFAULT : defaultDevice );
devices = ( char * )qalcGetString( NULL, ALC_DEVICE_SPECIFIER );
for( numDevices = 0; *devices; devices += strlen( devices ) + 1, numDevices++ )
{
if( !Q_stricmp( s_openAL_device->string, devices ) )
userDeviceNum = numDevices;
}
if( userDeviceNum == -1 )
trap_Cvar_ForceSet( "s_openAL_device", defaultDevice );
}
alDevice = qalcOpenDevice( (const ALchar *)s_openAL_device->string );
if( !alDevice )
{
Com_Printf( "Failed to open device\n" );
goto fail_no_device;
}
// Create context
alContext = qalcCreateContext( alDevice, NULL );
if( !alContext )
{
Com_Printf( "Failed to create context\n" );
goto fail;
}
qalcMakeContextCurrent( alContext );
if( verbose )
{
Com_Printf( "OpenAL initialized\n" );
if( numDevices )
{
int i;
Com_Printf( " Devices: " );
devices = ( char * )qalcGetString( NULL, ALC_DEVICE_SPECIFIER );
for( i = 0; *devices; devices += strlen( devices ) + 1, i++ )
Com_Printf( "%s%s", devices, ( i < numDevices - 1 ) ? ", " : "" );
Com_Printf( "\n" );
if( defaultDevice && *defaultDevice )
Com_Printf( " Default system device: %s\n", defaultDevice );
Com_Printf( "\n" );
}
Com_Printf( " Device: %s\n", qalcGetString( alDevice, ALC_DEVICE_SPECIFIER ) );
Com_Printf( " Vendor: %s\n", qalGetString( AL_VENDOR ) );
Com_Printf( " Version: %s\n", qalGetString( AL_VERSION ) );
Com_Printf( " Renderer: %s\n", qalGetString( AL_RENDERER ) );
Com_Printf( " Extensions: %s\n", qalGetString( AL_EXTENSIONS ) );
}
// Check for Linux shutdown race condition
if( !Q_stricmp( qalGetString( AL_VENDOR ), "J. Valenzuela" ) )
snd_shutdown_bug = qtrue;
s_volume = trap_Cvar_Get( "s_volume", "0.8", CVAR_ARCHIVE );
s_musicvolume = trap_Cvar_Get( "s_musicvolume", "0.5", CVAR_ARCHIVE );
s_doppler = trap_Cvar_Get( "s_doppler", "1.0", CVAR_ARCHIVE );
s_sound_velocity = trap_Cvar_Get( "s_sound_velocity", "10976", CVAR_DEVELOPER );
s_stereo2mono = trap_Cvar_Get ( "s_stereo2mono", "0", CVAR_ARCHIVE );
qalDopplerFactor( s_doppler->value );
qalDopplerVelocity( s_sound_velocity->value > 0.0f ? s_sound_velocity->value : 0.0f );
if( qalSpeedOfSound ) // opelAL 1.1 only. alDopplerVelocity being deprecated
qalSpeedOfSound( s_sound_velocity->value > 0.0f ? s_sound_velocity->value : 0.0f );
s_doppler->modified = qfalse;
S_SetAttenuationModel( S_DEFAULT_ATTENUATION_MODEL, S_DEFAULT_ATTENUATION_MAXDISTANCE, S_DEFAULT_ATTENUATION_REFDISTANCE );
S_LockBackgroundTrack( qfalse );
if( !S_InitDecoders( verbose ) )
{
Com_Printf( "Failed to init decoders\n" );
goto fail;
}
if( !S_InitBuffers() )
{
Com_Printf( "Failed to init buffers\n" );
goto fail;
}
if( !S_InitSources( maxEntities, verbose ) )
{
Com_Printf( "Failed to init sources\n" );
goto fail;
}
#ifdef ENABLE_PLAY
trap_Cmd_AddCommand( "play", S_Play );
#endif
trap_Cmd_AddCommand( "music", S_Music );
trap_Cmd_AddCommand( "stopmusic", S_StopMusic );
trap_Cmd_AddCommand( "prevmusic", S_PrevMusic );
trap_Cmd_AddCommand( "nextmusic", S_NextMusic );
trap_Cmd_AddCommand( "pausemusic", S_PauseMusic );
trap_Cmd_AddCommand( "soundlist", S_SoundList );
trap_Cmd_AddCommand( "s_devices", S_ListDevices );
return qtrue;
fail:
if( alContext )
{
if( !snd_shutdown_bug )
qalcMakeContextCurrent( NULL );
qalcDestroyContext( alContext );
alContext = NULL;
}
if( alDevice )
{
qalcCloseDevice( alDevice );
alDevice = NULL;
}
fail_no_device:
S_MemFreePool( &soundpool );
return qfalse;
}