test/testautomation_audio.c
author Andreas Schiffler <aschiffler@ferzkopp.net>
Mon, 24 Dec 2012 14:43:57 -0800
changeset 6772 5229a117ef97
child 6819 afef68703f54
permissions -rw-r--r--
Added audio test suite; minor code cleanups in test lib
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@6772
     7
aschiffler@6772
     8
#include "SDL.h"
aschiffler@6772
     9
#include "SDL_test.h"
aschiffler@6772
    10
aschiffler@6772
    11
/* ================= Test Case Implementation ================== */
aschiffler@6772
    12
aschiffler@6772
    13
/* Fixture */
aschiffler@6772
    14
aschiffler@6772
    15
void
aschiffler@6772
    16
_audioSetUp(void *arg)
aschiffler@6772
    17
{
aschiffler@6772
    18
	/* Start SDL audio subsystem */
aschiffler@6772
    19
	int ret = SDL_InitSubSystem( SDL_INIT_AUDIO );
aschiffler@6772
    20
        SDLTest_AssertPass("Call to SDL_InitSubSystem(SDL_INIT_AUDIO)");
aschiffler@6772
    21
	SDLTest_AssertCheck(ret==0, "Check result from SDL_InitSubSystem(SDL_INIT_AUDIO)");
aschiffler@6772
    22
	if (ret != 0) {
aschiffler@6772
    23
           SDLTest_LogError("%s", SDL_GetError());
aschiffler@6772
    24
        }
aschiffler@6772
    25
}
aschiffler@6772
    26
aschiffler@6772
    27
aschiffler@6772
    28
/* Test case functions */
aschiffler@6772
    29
aschiffler@6772
    30
/**
aschiffler@6772
    31
 * \brief Enumerate and name available audio devices (output and capture).
aschiffler@6772
    32
 * 
aschiffler@6772
    33
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetNumAudioDevices
aschiffler@6772
    34
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetAudioDeviceName
aschiffler@6772
    35
 */
aschiffler@6772
    36
int audio_enumerateAndNameAudioDevices()
aschiffler@6772
    37
{
aschiffler@6772
    38
   int t, tt;
aschiffler@6772
    39
   int i, n, nn;
aschiffler@6772
    40
   const char *name, *nameAgain;
aschiffler@6772
    41
aschiffler@6772
    42
   /* Iterate over types: t=0 output device, t=1 input/capture device */
aschiffler@6772
    43
   for (t=0; t<2; t++) {
aschiffler@6772
    44
   
aschiffler@6772
    45
      /* Get number of devices. */
aschiffler@6772
    46
      n = SDL_GetNumAudioDevices(t);
aschiffler@6772
    47
      SDLTest_AssertPass("Call to SDL_GetNumAudioDevices(%i)", t);
aschiffler@6772
    48
      SDLTest_Log("Number of %s devices < 0, reported as %i", (t) ? "output" : "capture", n);
aschiffler@6772
    49
      SDLTest_AssertCheck(n >= 0, "Validate result is >= 0, got: %i", n);
aschiffler@6772
    50
aschiffler@6772
    51
      /* Variation of non-zero type */
aschiffler@6772
    52
      if (t==1) {
aschiffler@6772
    53
         tt = t + SDLTest_RandomIntegerInRange(1,10);
aschiffler@6772
    54
         nn = SDL_GetNumAudioDevices(tt);
aschiffler@6772
    55
         SDLTest_AssertCheck(n==nn, "Verify result from SDL_GetNumAudioDevices(%i), expected same number of audio devices %i, got %i", tt, n, nn);
aschiffler@6772
    56
         nn = SDL_GetNumAudioDevices(-tt);
aschiffler@6772
    57
         SDLTest_AssertCheck(n==nn, "Verify result from SDL_GetNumAudioDevices(%i), expected same number of audio devices %i, got %i", -tt, n, nn);
aschiffler@6772
    58
      } 
aschiffler@6772
    59
   
aschiffler@6772
    60
      /* List devices. */
aschiffler@6772
    61
      if (n>0) {
aschiffler@6772
    62
         for (i=0; i<n; i++) {
aschiffler@6772
    63
            name = SDL_GetAudioDeviceName(i, t);
aschiffler@6772
    64
            SDLTest_AssertPass("Call to SDL_GetAudioDeviceName(%i, %i)", i, t);
aschiffler@6772
    65
            SDLTest_AssertCheck(name != NULL, "Verify result from SDL_GetAudioDeviceName(%i, %i) is not NULL", i, t);
aschiffler@6772
    66
            if (name != NULL) {
aschiffler@6772
    67
              SDLTest_AssertCheck(SDL_strlen(name)>0, "verify result from SDL_GetAudioDeviceName(%i, %i) is not empty, got: '%s'", i, t, name);
aschiffler@6772
    68
              if (t==1) {
aschiffler@6772
    69
                  /* Also try non-zero type */
aschiffler@6772
    70
                  tt = t + SDLTest_RandomIntegerInRange(1,10);
aschiffler@6772
    71
                  nameAgain = SDL_GetAudioDeviceName(i, tt);
aschiffler@6772
    72
                  SDLTest_AssertCheck(nameAgain != NULL, "Verify result from SDL_GetAudioDeviceName(%i, %i) is not NULL", i, tt);
aschiffler@6772
    73
                  if (nameAgain != NULL) {
aschiffler@6772
    74
                    SDLTest_AssertCheck(SDL_strlen(nameAgain)>0, "Verify result from SDL_GetAudioDeviceName(%i, %i) is not empty, got: '%s'", i, tt, nameAgain);
aschiffler@6772
    75
                    SDLTest_AssertCheck(SDL_strcmp(name, nameAgain)==0, 
aschiffler@6772
    76
                      "Verify SDL_GetAudioDeviceName(%i, %i) and SDL_GetAudioDeviceName(%i %i) return the same string", 
aschiffler@6772
    77
                      i, t, i, tt);
aschiffler@6772
    78
                  }
aschiffler@6772
    79
               }
aschiffler@6772
    80
            }
aschiffler@6772
    81
         }
aschiffler@6772
    82
      }
aschiffler@6772
    83
   }
aschiffler@6772
    84
   
aschiffler@6772
    85
   return TEST_COMPLETED;
aschiffler@6772
    86
}
aschiffler@6772
    87
aschiffler@6772
    88
/**
aschiffler@6772
    89
 * \brief Negative tests around enumeration and naming of audio devices.
aschiffler@6772
    90
 * 
aschiffler@6772
    91
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetNumAudioDevices
aschiffler@6772
    92
 * \sa http://wiki.libsdl.org/moin.cgi/SDL_GetAudioDeviceName
aschiffler@6772
    93
 */
aschiffler@6772
    94
int audio_enumerateAndNameAudioDevicesNegativeTests()
aschiffler@6772
    95
{
aschiffler@6772
    96
   int t;
aschiffler@6772
    97
   int i, j, no, nc;
aschiffler@6772
    98
   const char *name;
aschiffler@6772
    99
      
aschiffler@6772
   100
   /* Get number of devices. */
aschiffler@6772
   101
   no = SDL_GetNumAudioDevices(0);
aschiffler@6772
   102
   SDLTest_AssertPass("Call to SDL_GetNumAudioDevices(0)");
aschiffler@6772
   103
   nc = SDL_GetNumAudioDevices(1);
aschiffler@6772
   104
   SDLTest_AssertPass("Call to SDL_GetNumAudioDevices(1)");
aschiffler@6772
   105
   
aschiffler@6772
   106
   /* Invalid device index when getting name */
aschiffler@6772
   107
   for (t=0; t<2; t++) {
aschiffler@6772
   108
      /* Negative device index */
aschiffler@6772
   109
      i = SDLTest_RandomIntegerInRange(-10,-1);
aschiffler@6772
   110
      name = SDL_GetAudioDeviceName(i, t);
aschiffler@6772
   111
      SDLTest_AssertPass("Call to SDL_GetAudioDeviceName(%i, %i)", i, t);
aschiffler@6772
   112
      SDLTest_AssertCheck(name == NULL, "Check SDL_GetAudioDeviceName(%i, %i) result NULL, expected NULL, got: %s", i, t, (name == NULL) ? "NULL" : name);
aschiffler@6772
   113
      
aschiffler@6772
   114
      /* Device index past range */
aschiffler@6772
   115
      for (j=0; j<3; j++) {
aschiffler@6772
   116
         i = (t) ? nc+j : no+j;
aschiffler@6772
   117
         name = SDL_GetAudioDeviceName(i, t);
aschiffler@6772
   118
         SDLTest_AssertPass("Call to SDL_GetAudioDeviceName(%i, %i)", i, t);
aschiffler@6772
   119
         SDLTest_AssertCheck(name == NULL, "Check SDL_GetAudioDeviceName(%i, %i) result, expected: NULL, got: %s", i, t, (name == NULL) ? "NULL" : name);
aschiffler@6772
   120
      }
aschiffler@6772
   121
      
aschiffler@6772
   122
      /* Capture index past capture range but within output range */
aschiffler@6772
   123
      if ((no>0) && (no>nc) && (t==1)) {
aschiffler@6772
   124
         i = no-1;
aschiffler@6772
   125
         name = SDL_GetAudioDeviceName(i, t);
aschiffler@6772
   126
         SDLTest_AssertPass("Call to SDL_GetAudioDeviceName(%i, %i)", i, t);
aschiffler@6772
   127
         SDLTest_AssertCheck(name == NULL, "Check SDL_GetAudioDeviceName(%i, %i) result, expected: NULL, got: %s", i, t, (name == NULL) ? "NULL" : name);
aschiffler@6772
   128
      }
aschiffler@6772
   129
   }
aschiffler@6772
   130
aschiffler@6772
   131
   return TEST_COMPLETED;
aschiffler@6772
   132
}
aschiffler@6772
   133
aschiffler@6772
   134
aschiffler@6772
   135
/**
aschiffler@6772
   136
 * @brief Checks available audio driver names.
aschiffler@6772
   137
 */
aschiffler@6772
   138
int audio_printAudioDrivers()
aschiffler@6772
   139
{
aschiffler@6772
   140
   int i, n;
aschiffler@6772
   141
   const char *name;
aschiffler@6772
   142
aschiffler@6772
   143
   /* Get number of drivers */
aschiffler@6772
   144
   n = SDL_GetNumAudioDrivers();
aschiffler@6772
   145
   SDLTest_AssertPass("Call to SDL_GetNumAudioDrivers()");
aschiffler@6772
   146
   SDLTest_AssertCheck(n>=0, "Verify number of audio drivers >= 0, got: %i", n);
aschiffler@6772
   147
   
aschiffler@6772
   148
   /* List drivers. */
aschiffler@6772
   149
   if (n>0)
aschiffler@6772
   150
   {
aschiffler@6772
   151
      for (i=0; i<n; i++) {
aschiffler@6772
   152
         name = SDL_GetAudioDriver(i);
aschiffler@6772
   153
         SDLTest_AssertPass("Call to SDL_GetAudioDriver(%i)", i);
aschiffler@6772
   154
         SDLTest_AssertCheck(name != NULL, "Verify returned name is not NULL");
aschiffler@6772
   155
         if (name != NULL) {
aschiffler@6772
   156
            SDLTest_AssertCheck(SDL_strlen(name)>0, "Verify returned name is not empty, got: '%s'", name);
aschiffler@6772
   157
         }
aschiffler@6772
   158
      }
aschiffler@6772
   159
   }
aschiffler@6772
   160
aschiffler@6772
   161
   return TEST_COMPLETED;
aschiffler@6772
   162
}
aschiffler@6772
   163
aschiffler@6772
   164
aschiffler@6772
   165
/**
aschiffler@6772
   166
 * @brief Checks current audio driver name with initialized audio.
aschiffler@6772
   167
 */
aschiffler@6772
   168
int audio_printCurrentAudioDriver()
aschiffler@6772
   169
{
aschiffler@6772
   170
   const char *name;
aschiffler@6772
   171
aschiffler@6772
   172
   /* Check current audio driver */
aschiffler@6772
   173
   name = SDL_GetCurrentAudioDriver();
aschiffler@6772
   174
   SDLTest_AssertPass("Call to SDL_GetCurrentAudioDriver()");
aschiffler@6772
   175
   SDLTest_AssertCheck(name != NULL, "Verify returned name is not NULL");
aschiffler@6772
   176
   if (name != NULL) {
aschiffler@6772
   177
      SDLTest_AssertCheck(SDL_strlen(name)>0, "Verify returned name is not empty, got: '%s'", name);
aschiffler@6772
   178
   }
aschiffler@6772
   179
aschiffler@6772
   180
   return TEST_COMPLETED;
aschiffler@6772
   181
}
aschiffler@6772
   182
aschiffler@6772
   183
/* ================= Test Case References ================== */
aschiffler@6772
   184
aschiffler@6772
   185
/* Audio test cases */
aschiffler@6772
   186
static const SDLTest_TestCaseReference audioTest1 =
aschiffler@6772
   187
		{ (SDLTest_TestCaseFp)audio_enumerateAndNameAudioDevices, "audio_enumerateAndNameAudioDevices", "Enumerate and name available audio devices (output and capture)", TEST_ENABLED };
aschiffler@6772
   188
aschiffler@6772
   189
static const SDLTest_TestCaseReference audioTest2 =
aschiffler@6772
   190
		{ (SDLTest_TestCaseFp)audio_enumerateAndNameAudioDevicesNegativeTests, "audio_enumerateAndNameAudioDevicesNegativeTests", "Negative tests around enumeration and naming of audio devices.", TEST_ENABLED };
aschiffler@6772
   191
aschiffler@6772
   192
static const SDLTest_TestCaseReference audioTest3 =
aschiffler@6772
   193
		{ (SDLTest_TestCaseFp)audio_printAudioDrivers, "audio_printAudioDrivers", "Checks available audio driver names.", TEST_ENABLED };
aschiffler@6772
   194
aschiffler@6772
   195
static const SDLTest_TestCaseReference audioTest4 =
aschiffler@6772
   196
		{ (SDLTest_TestCaseFp)audio_printCurrentAudioDriver, "audio_printCurrentAudioDriver", "Checks current audio driver name with initialized audio.", TEST_ENABLED };
aschiffler@6772
   197
aschiffler@6772
   198
/* Sequence of Audio test cases */
aschiffler@6772
   199
static const SDLTest_TestCaseReference *audioTests[] =  {
aschiffler@6772
   200
	&audioTest1, &audioTest2, &audioTest3, &audioTest4, NULL
aschiffler@6772
   201
};
aschiffler@6772
   202
aschiffler@6772
   203
/* Audio test suite (global) */
aschiffler@6772
   204
SDLTest_TestSuiteReference audioTestSuite = {
aschiffler@6772
   205
	"Audio",
aschiffler@6772
   206
	_audioSetUp,
aschiffler@6772
   207
	audioTests,
aschiffler@6772
   208
	NULL
aschiffler@6772
   209
};