test/testautomation_audio.c
author Andreas Schiffler <aschiffler@ferzkopp.net>
Mon, 21 Jan 2013 09:16:27 -0800
changeset 6819 afef68703f54
parent 6772 5229a117ef97
child 6821 f36771112651
permissions -rw-r--r--
Add additional input validation to SDL_BuildAudioCVT; add additional tests to automation (audio, rwops)
aschiffler@6772
     1
/**
aschiffler@6772
     2
 * Original code: automated SDL audio test written by Edgar Simo "bobbens"
aschiffler@6772
     3
 * New/updated tests: aschiffler at ferzkopp dot net
aschiffler@6772
     4
 */
aschiffler@6772
     5
aschiffler@6772
     6
#include <stdio.h>
aschiffler@6819
     7
#include <string.h>
aschiffler@6772
     8
aschiffler@6772
     9
#include "SDL.h"
aschiffler@6772
    10
#include "SDL_test.h"
aschiffler@6772
    11
aschiffler@6772
    12
/* ================= Test Case Implementation ================== */
aschiffler@6772
    13
aschiffler@6772
    14
/* Fixture */
aschiffler@6772
    15
aschiffler@6772
    16
void
aschiffler@6772
    17
_audioSetUp(void *arg)
aschiffler@6772
    18
{
aschiffler@6772
    19
	/* Start SDL audio subsystem */
aschiffler@6772
    20
	int ret = SDL_InitSubSystem( SDL_INIT_AUDIO );
aschiffler@6772
    21
        SDLTest_AssertPass("Call to SDL_InitSubSystem(SDL_INIT_AUDIO)");
aschiffler@6772
    22
	SDLTest_AssertCheck(ret==0, "Check result from SDL_InitSubSystem(SDL_INIT_AUDIO)");
aschiffler@6772
    23
	if (ret != 0) {
aschiffler@6772
    24
           SDLTest_LogError("%s", SDL_GetError());
aschiffler@6772
    25
        }
aschiffler@6772
    26
}
aschiffler@6772
    27
aschiffler@6772
    28
aschiffler@6772
    29
/* Test case functions */
aschiffler@6772
    30
aschiffler@6772
    31
/**
aschiffler@6772
    32
 * \brief Enumerate and name available audio devices (output and capture).
aschiffler@6772
    33
 * 
aschiffler@6772
    34
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetNumAudioDevices
aschiffler@6772
    35
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetAudioDeviceName
aschiffler@6772
    36
 */
aschiffler@6772
    37
int audio_enumerateAndNameAudioDevices()
aschiffler@6772
    38
{
aschiffler@6772
    39
   int t, tt;
aschiffler@6772
    40
   int i, n, nn;
aschiffler@6772
    41
   const char *name, *nameAgain;
aschiffler@6772
    42
aschiffler@6772
    43
   /* Iterate over types: t=0 output device, t=1 input/capture device */
aschiffler@6772
    44
   for (t=0; t<2; t++) {
aschiffler@6772
    45
   
aschiffler@6772
    46
      /* Get number of devices. */
aschiffler@6772
    47
      n = SDL_GetNumAudioDevices(t);
aschiffler@6772
    48
      SDLTest_AssertPass("Call to SDL_GetNumAudioDevices(%i)", t);
aschiffler@6772
    49
      SDLTest_Log("Number of %s devices < 0, reported as %i", (t) ? "output" : "capture", n);
aschiffler@6772
    50
      SDLTest_AssertCheck(n >= 0, "Validate result is >= 0, got: %i", n);
aschiffler@6772
    51
aschiffler@6772
    52
      /* Variation of non-zero type */
aschiffler@6772
    53
      if (t==1) {
aschiffler@6772
    54
         tt = t + SDLTest_RandomIntegerInRange(1,10);
aschiffler@6772
    55
         nn = SDL_GetNumAudioDevices(tt);
aschiffler@6772
    56
         SDLTest_AssertCheck(n==nn, "Verify result from SDL_GetNumAudioDevices(%i), expected same number of audio devices %i, got %i", tt, n, nn);
aschiffler@6772
    57
         nn = SDL_GetNumAudioDevices(-tt);
aschiffler@6772
    58
         SDLTest_AssertCheck(n==nn, "Verify result from SDL_GetNumAudioDevices(%i), expected same number of audio devices %i, got %i", -tt, n, nn);
aschiffler@6772
    59
      } 
aschiffler@6772
    60
   
aschiffler@6772
    61
      /* List devices. */
aschiffler@6772
    62
      if (n>0) {
aschiffler@6772
    63
         for (i=0; i<n; i++) {
aschiffler@6772
    64
            name = SDL_GetAudioDeviceName(i, t);
aschiffler@6772
    65
            SDLTest_AssertPass("Call to SDL_GetAudioDeviceName(%i, %i)", i, t);
aschiffler@6772
    66
            SDLTest_AssertCheck(name != NULL, "Verify result from SDL_GetAudioDeviceName(%i, %i) is not NULL", i, t);
aschiffler@6772
    67
            if (name != NULL) {
aschiffler@6772
    68
              SDLTest_AssertCheck(SDL_strlen(name)>0, "verify result from SDL_GetAudioDeviceName(%i, %i) is not empty, got: '%s'", i, t, name);
aschiffler@6772
    69
              if (t==1) {
aschiffler@6772
    70
                  /* Also try non-zero type */
aschiffler@6772
    71
                  tt = t + SDLTest_RandomIntegerInRange(1,10);
aschiffler@6772
    72
                  nameAgain = SDL_GetAudioDeviceName(i, tt);
aschiffler@6772
    73
                  SDLTest_AssertCheck(nameAgain != NULL, "Verify result from SDL_GetAudioDeviceName(%i, %i) is not NULL", i, tt);
aschiffler@6772
    74
                  if (nameAgain != NULL) {
aschiffler@6772
    75
                    SDLTest_AssertCheck(SDL_strlen(nameAgain)>0, "Verify result from SDL_GetAudioDeviceName(%i, %i) is not empty, got: '%s'", i, tt, nameAgain);
aschiffler@6772
    76
                    SDLTest_AssertCheck(SDL_strcmp(name, nameAgain)==0, 
aschiffler@6772
    77
                      "Verify SDL_GetAudioDeviceName(%i, %i) and SDL_GetAudioDeviceName(%i %i) return the same string", 
aschiffler@6772
    78
                      i, t, i, tt);
aschiffler@6772
    79
                  }
aschiffler@6772
    80
               }
aschiffler@6772
    81
            }
aschiffler@6772
    82
         }
aschiffler@6772
    83
      }
aschiffler@6772
    84
   }
aschiffler@6772
    85
   
aschiffler@6772
    86
   return TEST_COMPLETED;
aschiffler@6772
    87
}
aschiffler@6772
    88
aschiffler@6772
    89
/**
aschiffler@6772
    90
 * \brief Negative tests around enumeration and naming of audio devices.
aschiffler@6772
    91
 * 
aschiffler@6772
    92
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetNumAudioDevices
aschiffler@6772
    93
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetAudioDeviceName
aschiffler@6772
    94
 */
aschiffler@6772
    95
int audio_enumerateAndNameAudioDevicesNegativeTests()
aschiffler@6772
    96
{
aschiffler@6772
    97
   int t;
aschiffler@6772
    98
   int i, j, no, nc;
aschiffler@6772
    99
   const char *name;
aschiffler@6772
   100
      
aschiffler@6772
   101
   /* Get number of devices. */
aschiffler@6772
   102
   no = SDL_GetNumAudioDevices(0);
aschiffler@6772
   103
   SDLTest_AssertPass("Call to SDL_GetNumAudioDevices(0)");
aschiffler@6772
   104
   nc = SDL_GetNumAudioDevices(1);
aschiffler@6772
   105
   SDLTest_AssertPass("Call to SDL_GetNumAudioDevices(1)");
aschiffler@6772
   106
   
aschiffler@6772
   107
   /* Invalid device index when getting name */
aschiffler@6772
   108
   for (t=0; t<2; t++) {
aschiffler@6772
   109
      /* Negative device index */
aschiffler@6772
   110
      i = SDLTest_RandomIntegerInRange(-10,-1);
aschiffler@6772
   111
      name = SDL_GetAudioDeviceName(i, t);
aschiffler@6772
   112
      SDLTest_AssertPass("Call to SDL_GetAudioDeviceName(%i, %i)", i, t);
aschiffler@6772
   113
      SDLTest_AssertCheck(name == NULL, "Check SDL_GetAudioDeviceName(%i, %i) result NULL, expected NULL, got: %s", i, t, (name == NULL) ? "NULL" : name);
aschiffler@6772
   114
      
aschiffler@6772
   115
      /* Device index past range */
aschiffler@6772
   116
      for (j=0; j<3; j++) {
aschiffler@6772
   117
         i = (t) ? nc+j : no+j;
aschiffler@6772
   118
         name = SDL_GetAudioDeviceName(i, t);
aschiffler@6772
   119
         SDLTest_AssertPass("Call to SDL_GetAudioDeviceName(%i, %i)", i, t);
aschiffler@6772
   120
         SDLTest_AssertCheck(name == NULL, "Check SDL_GetAudioDeviceName(%i, %i) result, expected: NULL, got: %s", i, t, (name == NULL) ? "NULL" : name);
aschiffler@6772
   121
      }
aschiffler@6772
   122
      
aschiffler@6772
   123
      /* Capture index past capture range but within output range */
aschiffler@6772
   124
      if ((no>0) && (no>nc) && (t==1)) {
aschiffler@6772
   125
         i = no-1;
aschiffler@6772
   126
         name = SDL_GetAudioDeviceName(i, t);
aschiffler@6772
   127
         SDLTest_AssertPass("Call to SDL_GetAudioDeviceName(%i, %i)", i, t);
aschiffler@6772
   128
         SDLTest_AssertCheck(name == NULL, "Check SDL_GetAudioDeviceName(%i, %i) result, expected: NULL, got: %s", i, t, (name == NULL) ? "NULL" : name);
aschiffler@6772
   129
      }
aschiffler@6772
   130
   }
aschiffler@6772
   131
aschiffler@6772
   132
   return TEST_COMPLETED;
aschiffler@6772
   133
}
aschiffler@6772
   134
aschiffler@6772
   135
aschiffler@6772
   136
/**
aschiffler@6819
   137
 * \brief Checks available audio driver names.
aschiffler@6819
   138
 *
aschiffler@6819
   139
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetNumAudioDrivers
aschiffler@6819
   140
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetAudioDriver
aschiffler@6772
   141
 */
aschiffler@6772
   142
int audio_printAudioDrivers()
aschiffler@6772
   143
{
aschiffler@6772
   144
   int i, n;
aschiffler@6772
   145
   const char *name;
aschiffler@6772
   146
aschiffler@6772
   147
   /* Get number of drivers */
aschiffler@6772
   148
   n = SDL_GetNumAudioDrivers();
aschiffler@6772
   149
   SDLTest_AssertPass("Call to SDL_GetNumAudioDrivers()");
aschiffler@6772
   150
   SDLTest_AssertCheck(n>=0, "Verify number of audio drivers >= 0, got: %i", n);
aschiffler@6772
   151
   
aschiffler@6772
   152
   /* List drivers. */
aschiffler@6772
   153
   if (n>0)
aschiffler@6772
   154
   {
aschiffler@6772
   155
      for (i=0; i<n; i++) {
aschiffler@6772
   156
         name = SDL_GetAudioDriver(i);
aschiffler@6772
   157
         SDLTest_AssertPass("Call to SDL_GetAudioDriver(%i)", i);
aschiffler@6772
   158
         SDLTest_AssertCheck(name != NULL, "Verify returned name is not NULL");
aschiffler@6772
   159
         if (name != NULL) {
aschiffler@6772
   160
            SDLTest_AssertCheck(SDL_strlen(name)>0, "Verify returned name is not empty, got: '%s'", name);
aschiffler@6772
   161
         }
aschiffler@6772
   162
      }
aschiffler@6772
   163
   }
aschiffler@6772
   164
aschiffler@6772
   165
   return TEST_COMPLETED;
aschiffler@6772
   166
}
aschiffler@6772
   167
aschiffler@6772
   168
aschiffler@6772
   169
/**
aschiffler@6819
   170
 * \brief Checks current audio driver name with initialized audio.
aschiffler@6819
   171
 *
aschiffler@6819
   172
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetCurrentAudioDriver
aschiffler@6772
   173
 */
aschiffler@6772
   174
int audio_printCurrentAudioDriver()
aschiffler@6772
   175
{
aschiffler@6772
   176
   const char *name;
aschiffler@6772
   177
aschiffler@6772
   178
   /* Check current audio driver */
aschiffler@6772
   179
   name = SDL_GetCurrentAudioDriver();
aschiffler@6772
   180
   SDLTest_AssertPass("Call to SDL_GetCurrentAudioDriver()");
aschiffler@6772
   181
   SDLTest_AssertCheck(name != NULL, "Verify returned name is not NULL");
aschiffler@6772
   182
   if (name != NULL) {
aschiffler@6772
   183
      SDLTest_AssertCheck(SDL_strlen(name)>0, "Verify returned name is not empty, got: '%s'", name);
aschiffler@6772
   184
   }
aschiffler@6772
   185
aschiffler@6772
   186
   return TEST_COMPLETED;
aschiffler@6772
   187
}
aschiffler@6772
   188
aschiffler@6819
   189
aschiffler@6819
   190
/**
aschiffler@6819
   191
 * \brief Builds various audio conversion structures
aschiffler@6819
   192
 *
aschiffler@6819
   193
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_BuildAudioCVT
aschiffler@6819
   194
 */
aschiffler@6819
   195
int audio_buildAudioCVT()
aschiffler@6819
   196
{
aschiffler@6819
   197
  int result;
aschiffler@6819
   198
  SDL_AudioCVT  cvt;
aschiffler@6819
   199
  SDL_AudioSpec spec1;
aschiffler@6819
   200
  SDL_AudioSpec spec2;
aschiffler@6819
   201
  int i, j, k;
aschiffler@6819
   202
  const int numFormats = 18;
aschiffler@6819
   203
  SDL_AudioFormat formats[] = { AUDIO_S8, AUDIO_U8, AUDIO_S16LSB, AUDIO_S16MSB, AUDIO_S16SYS, AUDIO_S16, AUDIO_U16LSB, 
aschiffler@6819
   204
                                AUDIO_U16MSB, AUDIO_U16SYS, AUDIO_U16, AUDIO_S32LSB, AUDIO_S32MSB, AUDIO_S32SYS, AUDIO_S32, 
aschiffler@6819
   205
                                AUDIO_F32LSB, AUDIO_F32MSB, AUDIO_F32SYS, AUDIO_F32 };
aschiffler@6819
   206
  const int numChannels = 4;
aschiffler@6819
   207
  Uint8 channels[] = { 1, 2, 4, 6 };
aschiffler@6819
   208
  const int numFrequencies = 4;
aschiffler@6819
   209
  int frequencies[] = { 11025, 22050, 44100, 48000 };
aschiffler@6819
   210
  
aschiffler@6819
   211
  /* No conversion needed */
aschiffler@6819
   212
  spec1.format = AUDIO_S16LSB;
aschiffler@6819
   213
  spec1.channels = 2;
aschiffler@6819
   214
  spec1.freq = 22050;
aschiffler@6819
   215
  result = SDL_BuildAudioCVT(&cvt, spec1.format, spec1.channels, spec1.freq,
aschiffler@6819
   216
                                   spec1.format, spec1.channels, spec1.freq);
aschiffler@6819
   217
  SDLTest_AssertPass("Call to SDL_BuildAudioCVT(spec1 ==> spec1)");
aschiffler@6819
   218
  SDLTest_AssertCheck(result == 0, "Verify result value; expected: 0, got: %i", result);
aschiffler@6819
   219
aschiffler@6819
   220
  /* Typical conversion */
aschiffler@6819
   221
  spec1.format = AUDIO_S8;
aschiffler@6819
   222
  spec1.channels = 1;
aschiffler@6819
   223
  spec1.freq = 22050;
aschiffler@6819
   224
  spec2.format = AUDIO_S16LSB;
aschiffler@6819
   225
  spec2.channels = 2;
aschiffler@6819
   226
  spec2.freq = 44100;  
aschiffler@6819
   227
  result = SDL_BuildAudioCVT(&cvt, spec1.format, spec1.channels, spec1.freq,
aschiffler@6819
   228
                                   spec2.format, spec2.channels, spec2.freq);
aschiffler@6819
   229
  SDLTest_AssertPass("Call to SDL_BuildAudioCVT(spec1 ==> spec2)");
aschiffler@6819
   230
  SDLTest_AssertCheck(result == 1, "Verify result value; expected: 1, got: %i", result);
aschiffler@6819
   231
aschiffler@6819
   232
  /* All source conversions with random conversion targets */
aschiffler@6819
   233
  for (i=0; i<numFormats; i++) {
aschiffler@6819
   234
    for (j=0; j<numChannels; j++) {
aschiffler@6819
   235
      for (k=0; k<numFrequencies; k++) {
aschiffler@6819
   236
        spec1.format = formats[i];
aschiffler@6819
   237
        spec1.channels = channels[j];
aschiffler@6819
   238
        spec1.freq = frequencies[k];
aschiffler@6819
   239
        spec2.format = formats[SDLTest_RandomIntegerInRange(0, numFormats - 1)];
aschiffler@6819
   240
        spec2.channels = channels[SDLTest_RandomIntegerInRange(0, numChannels - 1)];
aschiffler@6819
   241
        spec2.freq = frequencies[SDLTest_RandomIntegerInRange(0, numFrequencies - 1)];
aschiffler@6819
   242
        result = SDL_BuildAudioCVT(&cvt, spec1.format, spec1.channels, spec1.freq,
aschiffler@6819
   243
                                        spec2.format, spec2.channels, spec2.freq);
aschiffler@6819
   244
        SDLTest_AssertPass("Call to SDL_BuildAudioCVT(format=%i,channels=%i,freq=%i ==> format=%i,channels=%i,freq=%i)", 
aschiffler@6819
   245
            spec1.format, spec1.channels, spec1.freq, spec2.format, spec2.channels, spec2.freq);
aschiffler@6819
   246
        SDLTest_AssertCheck(result == 0 || result == 1, "Verify result value; expected: 0 or 1, got: %i", result);
aschiffler@6819
   247
        if (result<0) {
aschiffler@6819
   248
          SDLTest_LogError(SDL_GetError());
aschiffler@6819
   249
        }
aschiffler@6819
   250
      }
aschiffler@6819
   251
    }
aschiffler@6819
   252
  }
aschiffler@6819
   253
aschiffler@6819
   254
   return TEST_COMPLETED;
aschiffler@6819
   255
}
aschiffler@6819
   256
aschiffler@6819
   257
/**
aschiffler@6819
   258
 * \brief Checkes calls with invalid input to SDL_BuildAudioCVT
aschiffler@6819
   259
 *
aschiffler@6819
   260
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_BuildAudioCVT
aschiffler@6819
   261
 */
aschiffler@6819
   262
int audio_buildAudioCVTNegative()
aschiffler@6819
   263
{
aschiffler@6819
   264
  const char *expectedError = "Parameter 'cvt' is invalid";
aschiffler@6819
   265
  const char *error;   
aschiffler@6819
   266
  int result;
aschiffler@6819
   267
  SDL_AudioCVT  cvt;
aschiffler@6819
   268
  SDL_AudioSpec spec1;
aschiffler@6819
   269
  SDL_AudioSpec spec2;
aschiffler@6819
   270
  int i;
aschiffler@6819
   271
  char message[256];
aschiffler@6819
   272
aschiffler@6819
   273
  /* Valid format */  
aschiffler@6819
   274
  spec1.format = AUDIO_S8;
aschiffler@6819
   275
  spec1.channels = 1;
aschiffler@6819
   276
  spec1.freq = 22050;
aschiffler@6819
   277
  spec2.format = AUDIO_S16LSB;
aschiffler@6819
   278
  spec2.channels = 2;
aschiffler@6819
   279
  spec2.freq = 44100;  
aschiffler@6819
   280
aschiffler@6819
   281
  SDL_ClearError();
aschiffler@6819
   282
  SDLTest_AssertPass("Call to SDL_ClearError()");
aschiffler@6819
   283
aschiffler@6819
   284
  /* NULL input for CVT buffer */
aschiffler@6819
   285
  result = SDL_BuildAudioCVT((SDL_AudioCVT *)NULL, spec1.format, spec1.channels, spec1.freq,
aschiffler@6819
   286
                                                   spec2.format, spec2.channels, spec2.freq);
aschiffler@6819
   287
  SDLTest_AssertPass("Call to SDL_BuildAudioCVT(NULL,...)");
aschiffler@6819
   288
  SDLTest_AssertCheck(result == -1, "Verify result value; expected: -1, got: %i", result); 
aschiffler@6819
   289
  error = SDL_GetError();
aschiffler@6819
   290
  SDLTest_AssertPass("Call to SDL_GetError()");
aschiffler@6819
   291
  SDLTest_AssertCheck(error != NULL, "Validate that error message was not NULL");
aschiffler@6819
   292
  if (error != NULL) {
aschiffler@6819
   293
      SDLTest_AssertCheck(SDL_strcmp(error, expectedError) == 0, 
aschiffler@6819
   294
          "Validate error message, expected: '%s', got: '%s'", expectedError, error);
aschiffler@6819
   295
  }
aschiffler@6819
   296
aschiffler@6819
   297
  /* Invalid conversions */
aschiffler@6819
   298
  for (i = 1; i < 64; i++) {
aschiffler@6819
   299
    /* Valid format to start with */  
aschiffler@6819
   300
    spec1.format = AUDIO_S8;
aschiffler@6819
   301
    spec1.channels = 1;
aschiffler@6819
   302
    spec1.freq = 22050;
aschiffler@6819
   303
    spec2.format = AUDIO_S16LSB;
aschiffler@6819
   304
    spec2.channels = 2;
aschiffler@6819
   305
    spec2.freq = 44100;  
aschiffler@6819
   306
aschiffler@6819
   307
    SDL_ClearError();
aschiffler@6819
   308
    SDLTest_AssertPass("Call to SDL_ClearError()");
aschiffler@6819
   309
   
aschiffler@6819
   310
    /* Set various invalid format inputs */
aschiffler@6819
   311
    strcpy(message, "Invalid: ");
aschiffler@6819
   312
    if (i & 1) {
aschiffler@6819
   313
        strcat(message, " spec1.format");
aschiffler@6819
   314
        spec1.format = 0;
aschiffler@6819
   315
    }
aschiffler@6819
   316
    if (i & 2) { 
aschiffler@6819
   317
        strcat(message, " spec1.channels");
aschiffler@6819
   318
        spec1.channels = 0;
aschiffler@6819
   319
    }
aschiffler@6819
   320
    if (i & 4) { 
aschiffler@6819
   321
        strcat(message, " spec1.freq");
aschiffler@6819
   322
        spec1.freq = 0;
aschiffler@6819
   323
    }
aschiffler@6819
   324
    if (i & 8) { 
aschiffler@6819
   325
        strcat(message, " spec2.format");
aschiffler@6819
   326
        spec2.format = 0;
aschiffler@6819
   327
    }
aschiffler@6819
   328
    if (i & 16) { 
aschiffler@6819
   329
        strcat(message, " spec2.channels");
aschiffler@6819
   330
        spec2.channels = 0;
aschiffler@6819
   331
    }
aschiffler@6819
   332
    if (i & 32) { 
aschiffler@6819
   333
        strcat(message, " spec2.freq");
aschiffler@6819
   334
        spec2.freq = 0;
aschiffler@6819
   335
    }
aschiffler@6819
   336
    SDLTest_Log(message);
aschiffler@6819
   337
    result = SDL_BuildAudioCVT(&cvt, spec1.format, spec1.channels, spec1.freq,
aschiffler@6819
   338
                                   spec2.format, spec2.channels, spec2.freq);
aschiffler@6819
   339
    SDLTest_AssertPass("Call to SDL_BuildAudioCVT(spec1 ==> spec2)");
aschiffler@6819
   340
    SDLTest_AssertCheck(result == -1, "Verify result value; expected: -1, got: %i", result);
aschiffler@6819
   341
    error = SDL_GetError();
aschiffler@6819
   342
    SDLTest_AssertPass("Call to SDL_GetError()");
aschiffler@6819
   343
    SDLTest_AssertCheck(error != NULL && SDL_strlen(error)>0, "Validate that error message was not NULL or empty");
aschiffler@6819
   344
  }
aschiffler@6819
   345
aschiffler@6819
   346
  SDL_ClearError();
aschiffler@6819
   347
  SDLTest_AssertPass("Call to SDL_ClearError()");
aschiffler@6819
   348
                                                
aschiffler@6819
   349
  return TEST_COMPLETED;
aschiffler@6819
   350
}
aschiffler@6819
   351
aschiffler@6819
   352
/**
aschiffler@6819
   353
 * \brief Checks current audio status.
aschiffler@6819
   354
 *
aschiffler@6819
   355
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetAudioStatus
aschiffler@6819
   356
 */
aschiffler@6819
   357
int audio_getAudioStatus()
aschiffler@6819
   358
{
aschiffler@6819
   359
   SDL_AudioStatus result;
aschiffler@6819
   360
aschiffler@6819
   361
   /* Check current audio status */
aschiffler@6819
   362
   result = SDL_GetAudioStatus();
aschiffler@6819
   363
   SDLTest_AssertPass("Call to SDL_GetAudioStatus()");
aschiffler@6819
   364
   SDLTest_AssertCheck(result == SDL_AUDIO_STOPPED || result == SDL_AUDIO_PLAYING || result == SDL_AUDIO_PAUSED,
aschiffler@6819
   365
        "Verify returned value; expected: STOPPED (%i) | PLAYING (%i) | PAUSED (%i), got: %i", 
aschiffler@6819
   366
        SDL_AUDIO_STOPPED, SDL_AUDIO_PLAYING, SDL_AUDIO_PAUSED, result);
aschiffler@6819
   367
aschiffler@6819
   368
   return TEST_COMPLETED;
aschiffler@6819
   369
}
aschiffler@6819
   370
aschiffler@6819
   371
aschiffler@6819
   372
/* Test callback function */
aschiffler@6819
   373
void _audio_testCallback(void *userdata, Uint8 *stream, int len)
aschiffler@6819
   374
{
aschiffler@6819
   375
}
aschiffler@6819
   376
aschiffler@6819
   377
/**
aschiffler@6819
   378
 * \brief Opens, checks current audio status, and closes a device.
aschiffler@6819
   379
 *
aschiffler@6819
   380
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetAudioStatus
aschiffler@6819
   381
 */
aschiffler@6819
   382
int audio_openCloseAndGetAudioStatus()
aschiffler@6819
   383
{
aschiffler@6819
   384
   SDL_AudioStatus result;
aschiffler@6819
   385
   int i;
aschiffler@6819
   386
   int count;
aschiffler@6819
   387
   char *device;   
aschiffler@6819
   388
   SDL_AudioDeviceID id;
aschiffler@6819
   389
   SDL_AudioSpec desired, obtained;
aschiffler@6819
   390
   
aschiffler@6819
   391
   /* Get number of devices. */
aschiffler@6819
   392
   count = SDL_GetNumAudioDevices(0);
aschiffler@6819
   393
   SDLTest_AssertPass("Call to SDL_GetNumAudioDevices(0)");
aschiffler@6819
   394
   if (count>0) {
aschiffler@6819
   395
     for (i=0; i< count; i++) {
aschiffler@6819
   396
       /* Get device name */
aschiffler@6819
   397
       device = (char *)SDL_GetAudioDeviceName(i, 0);
aschiffler@6819
   398
       SDLTest_AssertPass("SDL_GetAudioDeviceName(%i,0)", i);
aschiffler@6819
   399
       SDLTest_AssertCheck(device != NULL, "Validate device name is not NULL; got: %s", (device != NULL) ? device : "NULL");
aschiffler@6819
   400
       if (device == NULL) return TEST_ABORTED;
aschiffler@6819
   401
aschiffler@6819
   402
       /* Set standard desired spec */
aschiffler@6819
   403
       desired.freq=22050;
aschiffler@6819
   404
       desired.format=AUDIO_S16SYS;
aschiffler@6819
   405
       desired.channels=2;
aschiffler@6819
   406
       desired.samples=4096;
aschiffler@6819
   407
       desired.callback=_audio_testCallback;
aschiffler@6819
   408
       desired.userdata=NULL;
aschiffler@6819
   409
       
aschiffler@6819
   410
       /* Open device */
aschiffler@6819
   411
       id = SDL_OpenAudioDevice((const char *)device, 0, &desired, &obtained, SDL_AUDIO_ALLOW_ANY_CHANGE);
aschiffler@6819
   412
       SDLTest_AssertPass("SDL_OpenAudioDevice('%s',...)", device);
aschiffler@6819
   413
       SDLTest_AssertCheck(id > 1, "Validate device ID; expected: >=2, got: %i", id);
aschiffler@6819
   414
       if (id > 1) {
aschiffler@6819
   415
     
aschiffler@6819
   416
         /* Check device audio status */
aschiffler@6819
   417
         result = SDL_GetAudioDeviceStatus(id);
aschiffler@6819
   418
         SDLTest_AssertPass("Call to SDL_GetAudioDeviceStatus()");
aschiffler@6819
   419
         SDLTest_AssertCheck(result == SDL_AUDIO_STOPPED || result == SDL_AUDIO_PLAYING || result == SDL_AUDIO_PAUSED,
aschiffler@6819
   420
            "Verify returned value; expected: STOPPED (%i) | PLAYING (%i) | PAUSED (%i), got: %i", 
aschiffler@6819
   421
            SDL_AUDIO_STOPPED, SDL_AUDIO_PLAYING, SDL_AUDIO_PAUSED, result);         
aschiffler@6819
   422
         
aschiffler@6819
   423
         /* Close device again */
aschiffler@6819
   424
         SDL_CloseAudioDevice(id);
aschiffler@6819
   425
         SDLTest_AssertPass("Call to SDL_CloseAudioDevice()");
aschiffler@6819
   426
       }
aschiffler@6819
   427
     }
aschiffler@6819
   428
   } else {
aschiffler@6819
   429
     SDLTest_Log("No devices to test with");
aschiffler@6819
   430
   }
aschiffler@6819
   431
   
aschiffler@6819
   432
   return TEST_COMPLETED;
aschiffler@6819
   433
}
aschiffler@6819
   434
aschiffler@6819
   435
/**
aschiffler@6819
   436
 * \brief Locks and unlocks open audio device.
aschiffler@6819
   437
 *
aschiffler@6819
   438
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_LockAudioDevice
aschiffler@6819
   439
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_UnlockAudioDevice
aschiffler@6819
   440
 */
aschiffler@6819
   441
int audio_lockUnlockOpenAudioDevice()
aschiffler@6819
   442
{
aschiffler@6819
   443
   int i;
aschiffler@6819
   444
   int count;
aschiffler@6819
   445
   char *device;   
aschiffler@6819
   446
   SDL_AudioDeviceID id;
aschiffler@6819
   447
   SDL_AudioSpec desired, obtained;
aschiffler@6819
   448
   
aschiffler@6819
   449
   /* Get number of devices. */
aschiffler@6819
   450
   count = SDL_GetNumAudioDevices(0);
aschiffler@6819
   451
   SDLTest_AssertPass("Call to SDL_GetNumAudioDevices(0)");
aschiffler@6819
   452
   if (count>0) {
aschiffler@6819
   453
     for (i=0; i< count; i++) {
aschiffler@6819
   454
       /* Get device name */
aschiffler@6819
   455
       device = (char *)SDL_GetAudioDeviceName(i, 0);
aschiffler@6819
   456
       SDLTest_AssertPass("SDL_GetAudioDeviceName(%i,0)", i);
aschiffler@6819
   457
       SDLTest_AssertCheck(device != NULL, "Validate device name is not NULL; got: %s", (device != NULL) ? device : "NULL");
aschiffler@6819
   458
       if (device == NULL) return TEST_ABORTED;
aschiffler@6819
   459
aschiffler@6819
   460
       /* Set standard desired spec */
aschiffler@6819
   461
       desired.freq=22050;
aschiffler@6819
   462
       desired.format=AUDIO_S16SYS;
aschiffler@6819
   463
       desired.channels=2;
aschiffler@6819
   464
       desired.samples=4096;
aschiffler@6819
   465
       desired.callback=_audio_testCallback;
aschiffler@6819
   466
       desired.userdata=NULL;
aschiffler@6819
   467
       
aschiffler@6819
   468
       /* Open device */
aschiffler@6819
   469
       id = SDL_OpenAudioDevice((const char *)device, 0, &desired, &obtained, SDL_AUDIO_ALLOW_ANY_CHANGE);
aschiffler@6819
   470
       SDLTest_AssertPass("SDL_OpenAudioDevice('%s',...)", device);
aschiffler@6819
   471
       SDLTest_AssertCheck(id > 1, "Validate device ID; expected: >=2, got: %i", id);
aschiffler@6819
   472
       if (id > 1) {     
aschiffler@6819
   473
         /* Lock to protect callback */
aschiffler@6819
   474
         SDL_LockAudioDevice(id);
aschiffler@6819
   475
         SDLTest_AssertPass("SDL_LockAudioDevice(%i)", id);
aschiffler@6819
   476
         
aschiffler@6819
   477
         /* Simulate callback processing */
aschiffler@6819
   478
         SDL_Delay(10);
aschiffler@6819
   479
         SDLTest_Log("Simulate callback processing - delay");
aschiffler@6819
   480
         
aschiffler@6819
   481
         /* Unlock again*/         
aschiffler@6819
   482
         SDL_UnlockAudioDevice(id);
aschiffler@6819
   483
         SDLTest_AssertPass("SDL_UnlockAudioDevice(%i)", id);         
aschiffler@6819
   484
         
aschiffler@6819
   485
         /* Close device again */
aschiffler@6819
   486
         SDL_CloseAudioDevice(id);
aschiffler@6819
   487
         SDLTest_AssertPass("Call to SDL_CloseAudioDevice()");
aschiffler@6819
   488
       }
aschiffler@6819
   489
     }
aschiffler@6819
   490
   } else {
aschiffler@6819
   491
     SDLTest_Log("No devices to test with");
aschiffler@6819
   492
   }
aschiffler@6819
   493
   
aschiffler@6819
   494
   return TEST_COMPLETED;
aschiffler@6819
   495
}
aschiffler@6819
   496
aschiffler@6819
   497
aschiffler@6819
   498
aschiffler@6772
   499
/* ================= Test Case References ================== */
aschiffler@6772
   500
aschiffler@6772
   501
/* Audio test cases */
aschiffler@6772
   502
static const SDLTest_TestCaseReference audioTest1 =
aschiffler@6772
   503
		{ (SDLTest_TestCaseFp)audio_enumerateAndNameAudioDevices, "audio_enumerateAndNameAudioDevices", "Enumerate and name available audio devices (output and capture)", TEST_ENABLED };
aschiffler@6772
   504
aschiffler@6772
   505
static const SDLTest_TestCaseReference audioTest2 =
aschiffler@6772
   506
		{ (SDLTest_TestCaseFp)audio_enumerateAndNameAudioDevicesNegativeTests, "audio_enumerateAndNameAudioDevicesNegativeTests", "Negative tests around enumeration and naming of audio devices.", TEST_ENABLED };
aschiffler@6772
   507
aschiffler@6772
   508
static const SDLTest_TestCaseReference audioTest3 =
aschiffler@6772
   509
		{ (SDLTest_TestCaseFp)audio_printAudioDrivers, "audio_printAudioDrivers", "Checks available audio driver names.", TEST_ENABLED };
aschiffler@6772
   510
aschiffler@6772
   511
static const SDLTest_TestCaseReference audioTest4 =
aschiffler@6772
   512
		{ (SDLTest_TestCaseFp)audio_printCurrentAudioDriver, "audio_printCurrentAudioDriver", "Checks current audio driver name with initialized audio.", TEST_ENABLED };
aschiffler@6772
   513
aschiffler@6819
   514
static const SDLTest_TestCaseReference audioTest5 =
aschiffler@6819
   515
		{ (SDLTest_TestCaseFp)audio_buildAudioCVT, "audio_buildAudioCVT", "Builds various audio conversion structures.", TEST_ENABLED };
aschiffler@6819
   516
aschiffler@6819
   517
static const SDLTest_TestCaseReference audioTest6 =
aschiffler@6819
   518
		{ (SDLTest_TestCaseFp)audio_buildAudioCVTNegative, "audio_buildAudioCVTNegative", "Checks calls with invalid input to SDL_BuildAudioCVT", TEST_ENABLED };
aschiffler@6819
   519
aschiffler@6819
   520
static const SDLTest_TestCaseReference audioTest7 =
aschiffler@6819
   521
		{ (SDLTest_TestCaseFp)audio_getAudioStatus, "audio_getAudioStatus", "Checks current audio status.", TEST_ENABLED };
aschiffler@6819
   522
aschiffler@6819
   523
static const SDLTest_TestCaseReference audioTest8 =
aschiffler@6819
   524
		{ (SDLTest_TestCaseFp)audio_openCloseAndGetAudioStatus, "audio_openCloseAndGetAudioStatus", "Opens and closes audio device and get audio status.", TEST_ENABLED };
aschiffler@6819
   525
aschiffler@6819
   526
static const SDLTest_TestCaseReference audioTest9 =
aschiffler@6819
   527
		{ (SDLTest_TestCaseFp)audio_lockUnlockOpenAudioDevice, "audio_lockUnlockOpenAudioDevice", "Locks and unlocks an open audio device.", TEST_ENABLED };
aschiffler@6819
   528
aschiffler@6772
   529
/* Sequence of Audio test cases */
aschiffler@6772
   530
static const SDLTest_TestCaseReference *audioTests[] =  {
aschiffler@6819
   531
	&audioTest1, &audioTest2, &audioTest3, &audioTest4, &audioTest5, &audioTest6, &audioTest7, &audioTest8, &audioTest9, NULL
aschiffler@6772
   532
};
aschiffler@6772
   533
aschiffler@6772
   534
/* Audio test suite (global) */
aschiffler@6772
   535
SDLTest_TestSuiteReference audioTestSuite = {
aschiffler@6772
   536
	"Audio",
aschiffler@6772
   537
	_audioSetUp,
aschiffler@6772
   538
	audioTests,
aschiffler@6772
   539
	NULL
aschiffler@6772
   540
};