SDL 3.0
SDL_test_common.h
Go to the documentation of this file.
1/*
2 Simple DirectMedia Layer
3 Copyright (C) 1997-2024 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 * Common functions of SDL test framework.
26 *
27 * This code is a part of the SDL 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 <SDL3/SDL.h>
36
37#ifdef __PSP__
38#define DEFAULT_WINDOW_WIDTH 480
39#define DEFAULT_WINDOW_HEIGHT 272
40#elif defined(__VITA__)
41#define DEFAULT_WINDOW_WIDTH 960
42#define DEFAULT_WINDOW_HEIGHT 544
43#else
44#define DEFAULT_WINDOW_WIDTH 640
45#define DEFAULT_WINDOW_HEIGHT 480
46#endif
47
48#define VERBOSE_VIDEO 0x00000001
49#define VERBOSE_MODES 0x00000002
50#define VERBOSE_RENDER 0x00000004
51#define VERBOSE_EVENT 0x00000008
52#define VERBOSE_AUDIO 0x00000010
53#define VERBOSE_MOTION 0x00000020
54
55typedef struct
56{
57 /* SDL init flags */
58 char **argv;
61
62 /* Video info */
63 const char *videodriver;
66 const char *window_title;
67 const char *window_icon;
83 float scale;
84 int depth;
90
91 /* Renderer info */
92 const char *renderdriver;
97
98 /* Audio info */
99 const char *audiodriver;
104
105 /* GL settings */
127
128 /* Mouse info */
130
132
133#include <SDL3/SDL_begin_code.h>
134/* Set up for C function definitions, even when using C++ */
135#ifdef __cplusplus
136extern "C" {
137#endif
138
139/* Function prototypes */
140
141/**
142 * Parse command line parameters and create common state.
143 *
144 * \param argv Array of command line parameters
145 * \param flags Flags indicating which subsystem to initialize (i.e. SDL_INIT_VIDEO | SDL_INIT_AUDIO)
146 *
147 * \returns a newly allocated common state object.
148 */
150
151/**
152 * Free the common state object.
153 *
154 * \param state The common state object to destroy
155 */
157
158/**
159 * Process one common argument.
160 *
161 * \param state The common state describing the test window to create.
162 * \param index The index of the argument to process in argv[].
163 *
164 * \returns the number of arguments processed (i.e. 1 for --fullscreen, 2 for --video [videodriver], or -1 on error.
165 */
167
168
169/**
170 * Logs command line usage info.
171 *
172 * This logs the appropriate command line options for the subsystems in use
173 * plus other common options, and then any application-specific options.
174 * This uses the SDL_Log() function and splits up output to be friendly to
175 * 80-character-wide terminals.
176 *
177 * \param state The common state describing the test window for the app.
178 * \param argv0 argv[0], as passed to main/SDL_main.
179 * \param options an array of strings for application specific options. The last element of the array should be NULL.
180 */
181void SDLTest_CommonLogUsage(SDLTest_CommonState *state, const char *argv0, const char **options);
182
183/**
184 * Open test window.
185 *
186 * \param state The common state describing the test window to create.
187 *
188 * \returns SDL_TRUE if initialization succeeded, false otherwise
189 */
191
192/**
193 * Easy argument handling when test app doesn't need any custom args.
194 *
195 * \param state The common state describing the test window to create.
196 * \param argc argc, as supplied to SDL_main
197 * \param argv argv, as supplied to SDL_main
198 *
199 * \returns SDL_FALSE if app should quit, true otherwise.
200 */
201SDL_bool SDLTest_CommonDefaultArgs(SDLTest_CommonState *state, const int argc, char **argv);
202
203/**
204 * Common event handler for test windows if you use a standard SDL_main.
205 *
206 * This will free data from the event, like the string in a drop event!
207 *
208 * \param state The common state used to create test window.
209 * \param event The event to handle.
210 * \param done Flag indicating we are done.
211 */
212void SDLTest_CommonEvent(SDLTest_CommonState *state, SDL_Event *event, int *done);
213
214/**
215 * Common event handler for test windows if you use SDL_AppEvent.
216 *
217 * This does _not_ free anything in `event`.
218 *
219 * \param state The common state used to create test window.
220 * \param event The event to handle.
221 * \returns Value suitable for returning from SDL_AppEvent().
222 */
224
225/**
226 * Close test window.
227 *
228 * \param state The common state used to create test window.
229 *
230 */
232
233/**
234 * Draws various window information (position, size, etc.) to the renderer.
235 *
236 * \param renderer The renderer to draw to.
237 * \param window The window whose information should be displayed.
238 * \param usedHeight Returns the height used, so the caller can draw more below.
239 *
240 */
241void SDLTest_CommonDrawWindowInfo(SDL_Renderer *renderer, SDL_Window *window, float *usedHeight);
242
243/* Ends C function definitions when using C++ */
244#ifdef __cplusplus
245}
246#endif
247#include <SDL3/SDL_close_code.h>
248
249#endif /* SDL_test_common_h_ */
Uint16 SDL_AudioFormat
Definition SDL_audio.h:76
Uint32 SDL_AudioDeviceID
Definition SDL_audio.h:144
struct SDL_Texture SDL_Texture
Definition SDL_render.h:130
SDL_RendererLogicalPresentation
Definition SDL_render.h:112
struct SDL_Renderer SDL_Renderer
Definition SDL_render.h:124
int SDL_bool
Definition SDL_stdinc.h:137
uint32_t Uint32
Definition SDL_stdinc.h:174
SDL_ScaleMode
Definition SDL_surface.h:72
void SDLTest_CommonQuit(SDLTest_CommonState *state)
SDL_bool SDLTest_CommonDefaultArgs(SDLTest_CommonState *state, const int argc, char **argv)
SDLTest_CommonState * SDLTest_CommonCreateState(char **argv, Uint32 flags)
void SDLTest_CommonEvent(SDLTest_CommonState *state, SDL_Event *event, int *done)
int SDLTest_CommonArg(SDLTest_CommonState *state, int index)
void SDLTest_CommonDrawWindowInfo(SDL_Renderer *renderer, SDL_Window *window, float *usedHeight)
SDL_bool SDLTest_CommonInit(SDLTest_CommonState *state)
void SDLTest_CommonDestroyState(SDLTest_CommonState *state)
void SDLTest_CommonLogUsage(SDLTest_CommonState *state, const char *argv0, const char **options)
int SDLTest_CommonEventMainCallbacks(SDLTest_CommonState *state, const SDL_Event *event)
Uint32 SDL_DisplayID
Definition SDL_video.h:44
struct SDL_Window SDL_Window
Definition SDL_video.h:137
SDL_Window ** windows
SDL_Texture ** targets
SDL_ScaleMode logical_scale_mode
const char * window_title
SDL_DisplayID displayID
const char * videodriver
SDL_AudioDeviceID audio_id
const char * window_icon
SDL_AudioFormat audio_format
SDL_RendererLogicalPresentation logical_presentation
const char * renderdriver
const char * audiodriver
SDL_Renderer ** renderers
SDL_DisplayMode fullscreen_mode