include/SDL_test_common.h
author Sam Lantinga <slouken@libsdl.org>
Wed, 29 May 2013 03:22:19 -0700
changeset 7240 39eb4958950a
parent 7194 987fb567bba9
child 7796 75c80f36038e
permissions -rw-r--r--
When the window is resized, the viewport is automatically reset.
This resolves lots of confusion around resizable windows. Most people don't expect a viewport to be implicitly set when the renderer is created and then not to be reset to the window size if the window is resized.

Added common test command line parameters --logical WxH and --scale N to test the render logical size and scaling APIs.
     1 /*
     2   Simple DirectMedia Layer
     3   Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
     4 
     5   This software is provided 'as-is', without any express or implied
     6   warranty.  In no event will the authors be held liable for any damages
     7   arising from the use of this software.
     8 
     9   Permission is granted to anyone to use this software for any purpose,
    10   including commercial applications, and to alter it and redistribute it
    11   freely, subject to the following restrictions:
    12 
    13   1. The origin of this software must not be misrepresented; you must not
    14      claim that you wrote the original software. If you use this software
    15      in a product, an acknowledgment in the product documentation would be
    16      appreciated but is not required.
    17   2. Altered source versions must be plainly marked as such, and must not be
    18      misrepresented as being the original software.
    19   3. This notice may not be removed or altered from any source distribution.
    20 */
    21 
    22 /**
    23  *  \file SDL_test_common.h
    24  *
    25  *  Include file for SDL test framework.
    26  *
    27  *  This code is a part of the SDL2_test library, not the main SDL library.
    28  */
    29 
    30 /* Ported from original test\common.h file. */
    31 
    32 #ifndef _SDL_test_common_h
    33 #define _SDL_test_common_h
    34 
    35 #include "SDL.h"
    36 
    37 #if defined(__PSP__)
    38 #define DEFAULT_WINDOW_WIDTH  480
    39 #define DEFAULT_WINDOW_HEIGHT 272
    40 #else
    41 #define DEFAULT_WINDOW_WIDTH  640
    42 #define DEFAULT_WINDOW_HEIGHT 480
    43 #endif
    44 
    45 #define VERBOSE_VIDEO   0x00000001
    46 #define VERBOSE_MODES   0x00000002
    47 #define VERBOSE_RENDER  0x00000004
    48 #define VERBOSE_EVENT   0x00000008
    49 #define VERBOSE_AUDIO   0x00000010
    50 
    51 typedef struct
    52 {
    53     /* SDL init flags */
    54     char **argv;
    55     Uint32 flags;
    56     Uint32 verbose;
    57 
    58     /* Video info */
    59     const char *videodriver;
    60     int display;
    61     const char *window_title;
    62     const char *window_icon;
    63     Uint32 window_flags;
    64     int window_x;
    65     int window_y;
    66     int window_w;
    67     int window_h;
    68     int window_minW;
    69     int window_minH;
    70     int window_maxW;
    71     int window_maxH;
    72     int logical_w;
    73     int logical_h;
    74     float scale;
    75     int depth;
    76     int refresh_rate;
    77     int num_windows;
    78     SDL_Window **windows;
    79 
    80     /* Renderer info */
    81     const char *renderdriver;
    82     Uint32 render_flags;
    83     SDL_bool skip_renderer;
    84     SDL_Renderer **renderers;
    85 
    86     /* Audio info */
    87     const char *audiodriver;
    88     SDL_AudioSpec audiospec;
    89 
    90     /* GL settings */
    91     int gl_red_size;
    92     int gl_green_size;
    93     int gl_blue_size;
    94     int gl_alpha_size;
    95     int gl_buffer_size;
    96     int gl_depth_size;
    97     int gl_stencil_size;
    98     int gl_double_buffer;
    99     int gl_accum_red_size;
   100     int gl_accum_green_size;
   101     int gl_accum_blue_size;
   102     int gl_accum_alpha_size;
   103     int gl_stereo;
   104     int gl_multisamplebuffers;
   105     int gl_multisamplesamples;
   106     int gl_retained_backing;
   107     int gl_accelerated;
   108     int gl_major_version;
   109     int gl_minor_version;
   110     int gl_debug;
   111 } SDLTest_CommonState;
   112 
   113 #include "begin_code.h"
   114 /* Set up for C function definitions, even when using C++ */
   115 #ifdef __cplusplus
   116 extern "C" {
   117 #endif
   118 
   119 /* Function prototypes */
   120 
   121 /**
   122  * \brief Parse command line parameters and create common state.
   123  *
   124  * \param argv Array of command line parameters
   125  * \param flags Flags indicating which subsystem to initialize (i.e. SDL_INIT_VIDEO | SDL_INIT_AUDIO)
   126  *
   127  * \returns Returns a newly allocated common state object.
   128  */
   129 SDLTest_CommonState *SDLTest_CommonCreateState(char **argv, Uint32 flags);
   130 
   131 /**
   132  * \brief Process one common argument.
   133  *
   134  * \param state The common state describing the test window to create.
   135  * \param index The index of the argument to process in argv[].
   136  *
   137  * \returns The number of arguments processed (i.e. 1 for --fullscreen, 2 for --video [videodriver], or -1 on error.
   138  */
   139 int SDLTest_CommonArg(SDLTest_CommonState * state, int index);
   140 
   141 /**
   142  * \brief Returns common usage information
   143  *
   144  * \param state The common state describing the test window to create.
   145  *
   146  * \returns String with usage information
   147  */
   148 const char *SDLTest_CommonUsage(SDLTest_CommonState * state);
   149 
   150 /**
   151  * \brief Open test window.
   152  *
   153  * \param state The common state describing the test window to create.
   154  *
   155  * \returns True if initialization succeeded, false otherwise
   156  */
   157 SDL_bool SDLTest_CommonInit(SDLTest_CommonState * state);
   158 
   159 /**
   160  * \brief Common event handler for test windows.
   161  *
   162  * \param state The common state used to create test window.
   163  * \param event The event to handle.
   164  * \param done Flag indicating we are done.
   165  *
   166  */
   167 void SDLTest_CommonEvent(SDLTest_CommonState * state, SDL_Event * event, int *done);
   168 
   169 /**
   170  * \brief Close test window.
   171  *
   172  * \param state The common state used to create test window.
   173  *
   174  */
   175 void SDLTest_CommonQuit(SDLTest_CommonState * state);
   176 
   177 
   178 /* Ends C function definitions when using C++ */
   179 #ifdef __cplusplus
   180 }
   181 #endif
   182 #include "close_code.h"
   183 
   184 #endif /* _SDL_test_common_h */
   185 
   186 /* vi: set ts=4 sw=4 expandtab: */