sdl_getkeystate(3) [opensolaris man page]

SDL_GetKeyState(3)						 SDL API Reference						SDL_GetKeyState(3)

NAME

       SDL_GetKeyState - Get a snapshot of the current keyboard state

SYNOPSIS

       #include "SDL.h"

       Uint8 *SDL_GetKeyState(int *numkeys);

DESCRIPTION

       Gets  a	snapshot  of the current keyboard state. The current state is return as a pointer to an array, the size of this array is stored in
       numkeys. The array is indexed by the SDLK_* symbols. A value of 1 means the key is pressed and a value of 0  means  its	not.  The  pointer
       returned is a pointer to an internal SDL array and should not be freed by the caller.

	      Note:

	      Use SDL_PumpEvents to update the state array.

EXAMPLE

       Uint8 *keystate = SDL_GetKeyState(NULL);
       if ( keystate[SDLK_RETURN] ) printf("Return Key Pressed.
       ");

SEE ALSO

       SDL Key Symbols, SDL_PumpEvents

SDL
							      Tue 11 Sep 2001, 22:59						SDL_GetKeyState(3)

SDL_keysym(3)							 SDL API Reference						     SDL_keysym(3)

NAME

       SDL_keysym- Keysym structure

STRUCTURE DEFINITION

       typedef struct{
	 Uint8 scancode;
	 SDLKey sym;
	 SDLMod mod;
	 Uint16 unicode;
       } SDL_keysym;

STRUCTURE DATA

       scancode 	   Hardware specific scancode

       sym		   SDL virtual keysym

       mod		   Current key modifiers

       unicode		   Translated character

DESCRIPTION

       The SDL_keysym structure is used by reporting key presses and releases since it is a part of the SDL_KeyboardEvent.

       The  scancode  field  should  generally	be  left  alone,  it is the hardware dependent scancode returned by the keyboard. The sym field is
       extremely useful. It is the SDL-defined value of the key (see SDL Key Syms. This field is very useful when you are checking for certain key
       presses, like so:

       .
       .
       while(SDL_PollEvent(&event)){
	 switch(event.type){
	   case SDL_KEYDOWN:
	     if(event.key.keysym.sym==SDLK_LEFT)
	       move_left();
	     break;
	   .
	   .
	   .
	 }
       }
       .
       .

	mod  stores the current state of the keyboard modifiers as explained in SDL_GetModState. The unicode is only used when UNICODE translation
       is enabled with SDL_EnableUNICODE. If unicode is non-zero then this a the UNICODE character corresponding to the keypress. If  the  high  9
       bits of the character are 0, then this maps to the equivalent ASCII character:

       char ch;
       if ( (keysym.unicode & 0xFF80) == 0 ) {
	 ch = keysym.unicode & 0x7F;
       }
       else {
	 printf("An International Character.
       ");
       }

	UNICODE translation does have a slight overhead so don't enable it unless its needed.

SEE ALSO

       SDLKey

SDL
							      Tue 11 Sep 2001, 23:00						     SDL_keysym(3)