SDL 3.0
|
Go to the source code of this file.
Enumerations | |
enum | SDL_InitFlags { SDL_INIT_TIMER = 0x00000001 , SDL_INIT_AUDIO = 0x00000010 , SDL_INIT_VIDEO = 0x00000020 , SDL_INIT_JOYSTICK = 0x00000200 , SDL_INIT_HAPTIC = 0x00001000 , SDL_INIT_GAMEPAD = 0x00002000 , SDL_INIT_EVENTS = 0x00004000 , SDL_INIT_SENSOR = 0x00008000 , SDL_INIT_CAMERA = 0x00010000 } |
Functions | |
int | SDL_Init (Uint32 flags) |
int | SDL_InitSubSystem (Uint32 flags) |
void | SDL_QuitSubSystem (Uint32 flags) |
Uint32 | SDL_WasInit (Uint32 flags) |
void | SDL_Quit (void) |
Init and quit header for the SDL library
Definition in file SDL_init.h.
enum SDL_InitFlags |
Initialization flags for SDL_Init and/or SDL_InitSubSystem
These are the flags which may be passed to SDL_Init(). You should specify the subsystems which you will be using in your application.
Definition at line 53 of file SDL_init.h.
|
extern |
Initialize the SDL library.
SDL_Init() simply forwards to calling SDL_InitSubSystem(). Therefore, the two may be used interchangeably. Though for readability of your code SDL_InitSubSystem() might be preferred.
The file I/O (for example: SDL_IOFromFile) and threading (SDL_CreateThread) subsystems are initialized by default. Message boxes (SDL_ShowSimpleMessageBox) also attempt to work without initializing the video subsystem, in hopes of being useful in showing an error dialog when SDL_Init fails. You must specifically initialize other subsystems if you use them in your application.
Logging (such as SDL_Log) works without initialization, too.
flags
may be any of the following OR'd together:
SDL_INIT_TIMER
: timer subsystemSDL_INIT_AUDIO
: audio subsystemSDL_INIT_VIDEO
: video subsystem; automatically initializes the events subsystemSDL_INIT_JOYSTICK
: joystick subsystem; automatically initializes the events subsystemSDL_INIT_HAPTIC
: haptic (force feedback) subsystemSDL_INIT_GAMEPAD
: gamepad subsystem; automatically initializes the joystick subsystemSDL_INIT_EVENTS
: events subsystemSDL_INIT_SENSOR
: sensor subsystemSubsystem initialization is ref-counted, you must call SDL_QuitSubSystem() for each SDL_InitSubSystem() to correctly shutdown a subsystem manually (or call SDL_Quit() to force shutdown). If a subsystem is already loaded then this call will increase the ref-count and return.
flags | subsystem initialization flags |
|
extern |
Compatibility function to initialize the SDL library.
This function and SDL_Init() are interchangeable.
flags | any of the flags used by SDL_Init(); see SDL_Init for details. |
|
extern |
Clean up all initialized subsystems.
You should call this function even if you have already shutdown each initialized subsystem with SDL_QuitSubSystem(). It is safe to call this function even in the case of errors in initialization.
You can use this function with atexit() to ensure that it is run when your application is shutdown, but it is not wise to do this from a library or other dynamically loaded code.
|
extern |
Shut down specific SDL subsystems.
You still need to call SDL_Quit() even if you close all open subsystems with SDL_QuitSubSystem().
flags | any of the flags used by SDL_Init(); see SDL_Init for details. |
Get a mask of the specified subsystems which are currently initialized.
flags | any of the flags used by SDL_Init(); see SDL_Init for details. |
flags
is 0, otherwise it returns the initialization status of the specified subsystems.