|
Size: 1738
Comment: Added updated example from old wiki and removed old comment.
|
← Revision 14 as of 2013-12-07 14:28:51 ⇥
Size: 1608
Comment: Removed old comments (answer: formatting was changed).
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 33: | Line 33: |
| <<Color2(col=green,text="From [[SDL_GetKeyState]] in old wiki.")>><<BR>> | |
| Line 36: | Line 35: |
| Note: This function gives you the current state after all events have been processed, so if a key or button has been pressed and released before you process events, then the pressed state will never show up in the [[SDL_GetKeyboardState]]() <<Color2(col=green,text="formatting here ok?")>> calls. | Note: This function gives you the current state after all events have been processed, so if a key or button has been pressed and released before you process events, then the pressed state will never show up in the [[SDL_GetKeyboardState]]() calls. |
| Line 38: | Line 37: |
| Note: This function doesn't take into account whether shift has been pressed or not. <<BR>> | Note: This function doesn't take into account whether shift has been pressed or not. |
DRAFT |
SDL_GetKeyboardState
Use this function to get a snapshot of the current state of the keyboard.
Contents
Syntax
const Uint8* SDL_GetKeyboardState(int* numkeys)
Function Parameters
numkeys |
if non-NULL, receives the length of the returned array |
Return Value
Returns a pointer to an array of key states. A value of 1 means that the key is pressed and a value of 0 means that it is not. Indexes into this array are obtained by using SDL_Scancode values. The pointer returned is a pointer to an internal SDL array. It will be valid for the whole lifetime of the application and should not be freed by the caller.
Code Examples
const Uint8 *state = SDL_GetKeyboardState(NULL);
if (state[SDL_SCANCODE_RETURN]) {
printf("<RETURN> is pressed.\n");
}
if (state[SDL_SCANCODE_RIGHT] && state[SDL_SCANCODE_UP]) {
printf("Right and Up Keys Pressed.\n");
}
Remarks
Note: Use SDL_PumpEvents() to update the state array.
Note: This function gives you the current state after all events have been processed, so if a key or button has been pressed and released before you process events, then the pressed state will never show up in the SDL_GetKeyboardState() calls.
Note: This function doesn't take into account whether shift has been pressed or not.
