sdl

FORK: Simple Directmedia Layer
git clone https://git.neptards.moe/neptards/sdl.git
Log | Files | Refs

SDL_visualtest_variators.h (1861B)

      1 /* See COPYING.txt for the full license governing this code. */
      2 /**
      3  * \file SDL_visualtest_variators.h
      4  *
      5  * Header for all the variators that vary input parameters to a SUT application.
      6  */
      7 
      8 #include "SDL_visualtest_exhaustive_variator.h"
      9 #include "SDL_visualtest_random_variator.h"
     10 
     11 #ifndef SDL_visualtest_variators_h_
     12 #define SDL_visualtest_variators_h_
     13 
     14 /* Set up for C function definitions, even when using C++ */
     15 #ifdef __cplusplus
     16 extern "C" {
     17 #endif
     18 
     19 /**
     20  * Struct that acts like a wrapper around the different types of variators
     21  * available.
     22  */
     23 typedef struct SDLVisualTest_Variator
     24 {
     25     /*! Type of the variator */
     26     SDLVisualTest_VariatorType type;
     27     /*! union object that stores the variator */
     28     union
     29     {
     30         SDLVisualTest_ExhaustiveVariator exhaustive;
     31         SDLVisualTest_RandomVariator random;
     32     } data;
     33 } SDLVisualTest_Variator;
     34 
     35 /**
     36  * Initializes the variator object pointed to by \c variator of type \c type
     37  * with information from the config object pointed to by \c config.
     38  *
     39  * \return 1 on success, 0 on failure
     40  */
     41 int SDLVisualTest_InitVariator(SDLVisualTest_Variator* variator,
     42                                SDLVisualTest_SUTConfig* config,
     43                                SDLVisualTest_VariatorType type,
     44                                Uint64 seed);
     45 
     46 /**
     47  * Gets the next variation using the variator.
     48  *
     49  * \return The arguments string representing the variation on success, and
     50  *         NULL on failure. The pointer returned should not be freed.
     51  */
     52 char* SDLVisualTest_GetNextVariation(SDLVisualTest_Variator* variator);
     53 
     54 /**
     55  * Frees any resources associated with the variator.
     56  */
     57 void SDLVisualTest_FreeVariator(SDLVisualTest_Variator* variator);
     58 
     59 /* Ends C function definitions when using C++ */
     60 #ifdef __cplusplus
     61 }
     62 #endif
     63 
     64 #endif /* SDL_visualtest_variators_h_ */
     65 
     66 /* vi: set ts=4 sw=4 expandtab: */