examples/openal-info.c

   1 /*
   2  * openal-info: Display information about ALC and AL.
   3  *
   4  * Idea based on glxinfo for OpenGL.
   5  * Initial OpenAL version by Erik Hofman <erik@ehofman.com>.
   6  * Further hacked by Sven Panne <sven.panne@aedion.de>.
   7  *
   8  */
   9
  10 #if HAVE_CONFIG_H
  11 #include "config.h"
  12 #endif
  13
  14 #include <stdio.h>
  15 #include <stdlib.h>
  16
  17 #include "AL/alc.h"
  18 #include "AL/al.h"
  19 #include "AL/alext.h"
  20
  21
  22 static const int indentation = 4;
  23 static const int maxmimumWidth = 79;
  24
  25 static void printChar(int c, int *width)
  26 {
  27     putchar(c);
  28     *width = ((c == '\n') ? 0 : ((*width) + 1));
  29 }
  30
  31 static void indent(int *width)
  32 {
  33     int i;
  34     for(i = 0; i < indentation; i++)
  35         printChar(' ', width);
  36 }
  37
  38 static void printExtensions(const char *header, char separator, const char *extensions)
  39 {
  40     int width = 0, start = 0, end = 0;
  41
  42     printf("%s:\n", header);
  43     if(extensions == NULL || extensions[0] == '\0')
  44         return;
  45
  46     indent(&width);
  47     while (1)
  48     {
  49         if(extensions[end] == separator || extensions[end] == '\0')
  50         {
  51             if(width + end - start + 2 > maxmimumWidth)
  52             {
  53                 printChar('\n', &width);
  54                 indent(&width);
  55             }
  56             while(start < end)
  57             {
  58                 printChar(extensions[start], &width);
  59                 start++;
  60             }
  61             if(extensions[end] == '\0')
  62                 break;
  63             start++;
  64             end++;
  65             if(extensions[end] == '\0')
  66                 break;
  67             printChar(',', &width);
  68             printChar(' ', &width);
  69         }
  70         end++;
  71     }
  72     printChar('\n', &width);
  73 }
  74
  75 static void die(const char *kind, const char *description)
  76 {
  77     fprintf(stderr, "%s error %s occured\n", kind, description);
  78     exit(EXIT_FAILURE);
  79 }
  80
  81 static void checkForErrors(void)
  82 {
  83     {
  84         ALCdevice *device = alcGetContextsDevice(alcGetCurrentContext());
  85         ALCenum error = alcGetError(device);
  86         if(error != ALC_NO_ERROR)
  87             die("ALC", (const char*)alcGetString(device, error));
  88     }
  89     {
  90         ALenum error = alGetError();
  91         if(error != AL_NO_ERROR)
  92             die("AL", (const char*)alGetString(error));
  93     }
  94 }
  95
  96 static void printDevices(ALCenum which, const char *kind)
  97 {
  98     const char *s = alcGetString(NULL, which);
  99     checkForErrors();
 100
 101     printf("Available %sdevices:\n", kind);
 102     while(*s != '\0')
 103     {
 104         printf("    %s\n", s);
 105         while(*s++ != '\0')
 106             ;
 107     }
 108 }
 109
 110 static void printALCInfo (void)
 111 {
 112     ALCint major, minor;
 113     ALCdevice *device;
 114
 115     if(alcIsExtensionPresent(NULL, (const ALCchar*)"ALC_ENUMERATION_EXT") == AL_TRUE)
 116     {
 117         if(alcIsExtensionPresent(NULL, (const ALCchar*)"ALC_ENUMERATE_ALL_EXT") == AL_TRUE)
 118             printDevices(ALC_ALL_DEVICES_SPECIFIER, "playback ");
 119         else
 120             printDevices(ALC_DEVICE_SPECIFIER, "playback ");
 121         printDevices(ALC_CAPTURE_DEVICE_SPECIFIER, "capture ");
 122     }
 123     else
 124         printf("No device enumeration available\n");
 125
 126     device = alcGetContextsDevice(alcGetCurrentContext());
 127     checkForErrors();
 128
 129     printf("Default device: %s\n",
 130            alcGetString(device, ALC_DEFAULT_DEVICE_SPECIFIER));
 131
 132     printf("Default capture device: %s\n",
 133            alcGetString(device, ALC_CAPTURE_DEFAULT_DEVICE_SPECIFIER));
 134
 135     alcGetIntegerv(device, ALC_MAJOR_VERSION, 1, &major);
 136     alcGetIntegerv(device, ALC_MAJOR_VERSION, 1, &minor);
 137     checkForErrors();
 138     printf("ALC version: %d.%d\n", (int)major, (int)minor);
 139
 140     printExtensions("ALC extensions", ' ',
 141                     alcGetString(device, ALC_EXTENSIONS));
 142     checkForErrors();
 143 }
 144
 145 static void printALInfo(void)
 146 {
 147     printf("OpenAL vendor string: %s\n", alGetString(AL_VENDOR));
 148     printf("OpenAL renderer string: %s\n", alGetString(AL_RENDERER));
 149     printf("OpenAL version string: %s\n", alGetString(AL_VERSION));
 150     printExtensions("OpenAL extensions", ' ', alGetString(AL_EXTENSIONS));
 151     checkForErrors();
 152 }
 153
 154 int main()
 155 {
 156     ALCdevice *device = alcOpenDevice(NULL);
 157     ALCcontext *context = alcCreateContext(device, NULL);
 158     alcMakeContextCurrent(context);
 159     checkForErrors();
 160
 161     printALCInfo();
 162     printALInfo();
 163     checkForErrors();
 164
 165     alcMakeContextCurrent(NULL);
 166     alcDestroyContext(context);
 167     alcCloseDevice(device);
 168
 169     return EXIT_SUCCESS;
 170 }