|
Size: 1138
Comment: create page, add content (Wed Mar 10 ver; changeset 4428)
|
Size: 1018
Comment: minor change
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 3: | Line 3: |
| ||<tablewidth="100%" style="color: #FF0000;" :> DRAFT|| | |
| Line 6: | Line 5: |
| Use this function to return ^a^ mask of the specified subsystems which have ^previously^ been initialized. | Use this function to return a mask of the specified subsystems which have previously been initialized. |
| Line 19: | Line 18: |
| If flags is 0, it returns a mask of all initialized subsystems. <<Color2(green,Otherwise it returns the initialization status of the specified subsystems. ?????)>> | If flags is 0 it returns a mask of all initialized subsystems, otherwise it returns the initialization status of the specified subsystems. |
| Line 28: | Line 27: |
| <<Include(SDL_Init, , , from="OR'd together.", to="== Return Value ==")>> ''You can add useful comments here'' |
<<Include(SDL_Init, , , from="multiple subsystems.", to="This function loads")>> |
SDL_WasInit
Use this function to return a mask of the specified subsystems which have previously been initialized.
Contents
Syntax
Uint32 SDL_WasInit(Uint32 flags)
Function Parameters
Return Value
If flags is 0 it returns a mask of all initialized subsystems, otherwise it returns the initialization status of the specified subsystems.
Code Examples
You can add your code example here
Remarks
These are the flags which may be passed to SDL_WasInit() and may be OR'd together to query multiple, specific subsystems simultaneously.
Include: Nothing found for "multiple subsystems."!
Include: Nothing found for "This function loads"!
SDL_Init
Use this function to initialize the SDL library. This must be called before using most other SDL functions.
Syntax
int SDL_Init(Uint32 flags)
Function Parameters
flags |
subsystem initialization flags; see Remarks for details |
Return Value
Returns 0 on success or a negative error code on failure; call SDL_GetError() for more information.
Code Examples
#include "SDL.h"
int main(int argc, char* argv[])
{
if (SDL_Init(SDL_INIT_VIDEO|SDL_INIT_AUDIO) != 0) {
SDL_Log("Unable to initialize SDL: %s", SDL_GetError());
return 1;
}
/* ... */
SDL_Quit();
return 0;
}
Remarks
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 and threading subsystems are initialized by default. You must specifically initialize other subsystems if you use them in your application.
Logging works without initialization, too.
flags may be any of the following OR'd together:
SDL_INIT_TIMER |
timer subsystem |
SDL_INIT_AUDIO |
audio subsystem |
SDL_INIT_VIDEO |
video subsystem; automatically initializes the events subsystem |
SDL_INIT_JOYSTICK |
joystick subsystem; automatically initializes the events subsystem |
SDL_INIT_HAPTIC |
haptic (force feedback) subsystem |
SDL_INIT_GAMECONTROLLER |
controller subsystem; automatically initializes the joystick subsystem |
SDL_INIT_EVENTS |
events subsystem |
SDL_INIT_EVERYTHING |
all of the above subsystems |
SDL_INIT_NOPARACHUTE |
compatibility; this flag is ignored |
If you want to initialize subsystems separately you would call SDL_Init(0) followed by SDL_InitSubSystem() with the desired subsystem flag.
Related Functions
