Wiki Page Content

Differences between revisions 5 and 7 (spanning 2 versions)
Revision 5 as of 2010-08-03 20:48:57
Size: 1018
Editor: SheenaSmith
Comment: minor change
Revision 7 as of 2010-08-27 05:55:45
Size: 1854
Editor: SheenaSmith
Comment: update content (old wiki); repaired include from SDL_Init
Deletions are marked like this. Additions are marked like this.
Line 18: Line 18:
If flags is 0 it returns a mask of all initialized subsystems, 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.

*<<BR>>If '''flags''' is 0 or SDL_INIT_EVERYTHING, it returns a mask of all initialized subsystems (this does not include SDL_INIT_EVENTTHREAD or SDL_INIT_NOPARACHUTE).<<BR>>*
Line 22: Line 24:
You can add your code example here /* Get init data on all the subsystems */
Uint32 subsystem_init;

subsystem_init=SDL_WasInit(SDL_INIT_EVERYTHING);

if(subsystem_init&SDL_INIT_VIDEO)
  printf("Video is initialized.\n");
else
  printf("Video is not initialized.\n");
}}}
{{{#!highlight cpp
/* Just check for one specific subsystem */

if(SDL_WasInit(SDL_INIT_VIDEO)!=0)
  printf("Video is initialized.\n");
else
  printf("Video is not initialized.\n");
}}}
{{{#!highlight cpp
/* Check for two subsystems */

Uint32 subsystem_mask=SDL_INIT_VIDEO|SDL_INIT_AUDIO;

if(SDL_WasInit(subsystem_mask)==subsystem_mask)
  printf("Video and Audio initialized.\n");
else
  printf("Video and Audio not initialized.\n");
Line 27: Line 55:
<<Include(SDL_Init, , , from="multiple subsystems.", to="This function loads")>>
<<Include(SDL_Init, , , from="OR'd together:", to="Unless the")>>

SDL_WasInit

Use this function to return a mask of the specified subsystems which have previously been initialized.

Syntax

Uint32 SDL_WasInit(Uint32 flags)

Function Parameters

flags

any of the flags used by SDL_Init(); see Remarks for details

Return Value

If flags is 0 it returns a mask of all initialized subsystems, otherwise it returns the initialization status of the specified subsystems.

*
If flags is 0 or SDL_INIT_EVERYTHING, it returns a mask of all initialized subsystems (this does not include SDL_INIT_EVENTTHREAD or SDL_INIT_NOPARACHUTE).
*

Code Examples

/* Get init data on all the subsystems */
Uint32 subsystem_init;

subsystem_init=SDL_WasInit(SDL_INIT_EVERYTHING);

if(subsystem_init&SDL_INIT_VIDEO)
  printf("Video is initialized.\n");
else
  printf("Video is not initialized.\n");

/* Just check for one specific subsystem */

if(SDL_WasInit(SDL_INIT_VIDEO)!=0)
  printf("Video is initialized.\n");
else
  printf("Video is not initialized.\n");

/* Check for two subsystems */

Uint32 subsystem_mask=SDL_INIT_VIDEO|SDL_INIT_AUDIO;

if(SDL_WasInit(subsystem_mask)==subsystem_mask)
  printf("Video and Audio initialized.\n");
else
  printf("Video and Audio not initialized.\n");

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 "Unless the"!

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


CategoryAPI, CategoryInit


CategoryAPI, CategoryInit

None: SDL_WasInit (last edited 2016-05-14 22:29:46 by PhilippWiesemann)

(Page Info.)
Feedback
Please include your contact information if you'd like to receive a reply.
Submit