SDL_keyboard_c.h File Reference

#include "../SDL_internal.h"
#include "SDL_keycode.h"
#include "SDL_events.h"

Include dependency graph for SDL_keyboard_c.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
int	SDL_KeyboardInit (void)
void	SDL_ResetKeyboard (void)
void	SDL_GetDefaultKeymap (SDL_Keycode *keymap)
void	SDL_SetKeymap (int start, SDL_Keycode *keys, int length)
void	SDL_SetScancodeName (SDL_Scancode scancode, const char *name)
void	SDL_SetKeyboardFocus (SDL_Window *window)
int	SDL_SendKeyboardKey (Uint8 state, SDL_Scancode scancode)
int	SDL_SendKeyboardKeyAutoRelease (SDL_Scancode scancode)
void	SDL_ReleaseAutoReleaseKeys (void)
SDL_bool	SDL_HardwareKeyboardKeyPressed (void)
int	SDL_SendKeyboardText (const char *text)
int	SDL_SendEditingText (const char *text, int start, int end)
void	SDL_KeyboardQuit (void)
char *	SDL_UCS4ToUTF8 (Uint32 ch, char *dst)
void	SDL_ToggleModState (const SDL_Keymod modstate, const SDL_bool toggle)

Function Documentation

SDL_GetDefaultKeymap()

void SDL_GetDefaultKeymap

(

SDL_Keycode *

keymap

)

Definition at line 592 of file SDL_keyboard.c.

{
    SDL_memcpy(keymap, SDL_default_keymap, sizeof(SDL_default_keymap));
}

References SDL_default_keymap, and SDL_memcpy.

SDL_HardwareKeyboardKeyPressed()

SDL_bool SDL_HardwareKeyboardKeyPressed

(

void

)

Definition at line 834 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
    SDL_Scancode scancode;
 
    for (scancode = SDL_SCANCODE_UNKNOWN; scancode < SDL_NUM_SCANCODES; ++scancode) {
        if ((keyboard->keysource[scancode] & KEYBOARD_HARDWARE) != 0) {
            return SDL_TRUE;
        }
    }
    return SDL_FALSE;
}

References KEYBOARD_HARDWARE, SDL_Keyboard::keysource, SDL_FALSE, SDL_keyboard, SDL_NUM_SCANCODES, SDL_SCANCODE_UNKNOWN, and SDL_TRUE.

SDL_KeyboardInit()

int SDL_KeyboardInit

(

void

)

Definition at line 566 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
 
    /* Set the default keymap */
    SDL_memcpy(keyboard->keymap, SDL_default_keymap, sizeof(SDL_default_keymap));
    return (0);
}

References SDL_Keyboard::keymap, SDL_default_keymap, SDL_keyboard, and SDL_memcpy.

Referenced by SDL_VideoInit().

SDL_KeyboardQuit()

void SDL_KeyboardQuit

(

void

)

Definition at line 891 of file SDL_keyboard.c.

{
}

Referenced by SDL_VideoQuit().

SDL_ReleaseAutoReleaseKeys()

void SDL_ReleaseAutoReleaseKeys

(

void

)

Definition at line 818 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
    SDL_Scancode scancode;
 
    if (keyboard->autorelease_pending) {
        for (scancode = SDL_SCANCODE_UNKNOWN; scancode < SDL_NUM_SCANCODES; ++scancode) {
            if (keyboard->keysource[scancode] == KEYBOARD_AUTORELEASE) {
                SDL_SendKeyboardKeyInternal(KEYBOARD_AUTORELEASE, SDL_RELEASED, scancode);
            }
        }
        keyboard->autorelease_pending = SDL_FALSE;
    }
}

References SDL_Keyboard::autorelease_pending, KEYBOARD_AUTORELEASE, SDL_Keyboard::keysource, SDL_FALSE, SDL_keyboard, SDL_NUM_SCANCODES, SDL_RELEASED, SDL_SCANCODE_UNKNOWN, and SDL_SendKeyboardKeyInternal().

Referenced by SDL_PumpEvents().

SDL_ResetKeyboard()

void SDL_ResetKeyboard

(

void

)

Definition at line 576 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
    SDL_Scancode scancode;
 
#ifdef DEBUG_KEYBOARD
    printf("Resetting keyboard\n");
#endif
    for (scancode = (SDL_Scancode) 0; scancode < SDL_NUM_SCANCODES; ++scancode) {
        if (keyboard->keystate[scancode] == SDL_PRESSED) {
            SDL_SendKeyboardKey(SDL_RELEASED, scancode);
        }
    }
}

References SDL_Keyboard::keystate, SDL_keyboard, SDL_NUM_SCANCODES, SDL_PRESSED, SDL_RELEASED, and SDL_SendKeyboardKey().

Referenced by SDL_SetKeyboardFocus(), and SDL_ShowMessageBox().

SDL_SendEditingText()

int SDL_SendEditingText	(	const char *	text,
		int	start,
		int	end
	)

Definition at line 871 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
    int posted;
 
    /* Post the event, if desired */
    posted = 0;
    if (SDL_GetEventState(SDL_TEXTEDITING) == SDL_ENABLE) {
        SDL_Event event;
        event.edit.type = SDL_TEXTEDITING;
        event.edit.windowID = keyboard->focus ? keyboard->focus->id : 0;
        event.edit.start = start;
        event.edit.length = length;
        SDL_utf8strlcpy(event.edit.text, text, SDL_arraysize(event.edit.text));
        posted = (SDL_PushEvent(&event) > 0);
    }
    return (posted);
}

References SDL_Keyboard::focus, SDL_Window::id, SDL_arraysize, SDL_ENABLE, SDL_GetEventState, SDL_keyboard, SDL_PushEvent, SDL_TEXTEDITING, SDL_utf8strlcpy, and text.

Referenced by DBus_MessageFilter().

SDL_SendKeyboardKey()

int SDL_SendKeyboardKey	(	Uint8	state,
		SDL_Scancode	scancode
	)

Definition at line 806 of file SDL_keyboard.c.

{
    return SDL_SendKeyboardKeyInternal(KEYBOARD_HARDWARE, state, scancode);
}

References KEYBOARD_HARDWARE, SDL_SendKeyboardKeyInternal(), and state.

Referenced by SDL_BApp::_HandleKey(), handleKeyboardEvent(), SDL_ResetKeyboard(), and WINRT_OnBackButtonPressed().

SDL_SendKeyboardKeyAutoRelease()

int SDL_SendKeyboardKeyAutoRelease

(

SDL_Scancode

scancode

)

Definition at line 812 of file SDL_keyboard.c.

{
    return SDL_SendKeyboardKeyInternal(KEYBOARD_AUTORELEASE, SDL_PRESSED, scancode);
}

References KEYBOARD_AUTORELEASE, SDL_PRESSED, and SDL_SendKeyboardKeyInternal().

SDL_SendKeyboardText()

int SDL_SendKeyboardText

(

const char *

text

)

Definition at line 848 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
    int posted;
 
    /* Don't post text events for unprintable characters */
    if ((unsigned char)*text < ' ' || *text == 127) {
        return 0;
    }
 
    /* Post the event, if desired */
    posted = 0;
    if (SDL_GetEventState(SDL_TEXTINPUT) == SDL_ENABLE) {
        SDL_Event event;
        event.text.type = SDL_TEXTINPUT;
        event.text.windowID = keyboard->focus ? keyboard->focus->id : 0;
        SDL_utf8strlcpy(event.text.text, text, SDL_arraysize(event.text.text));
        posted = (SDL_PushEvent(&event) > 0);
    }
    return (posted);
}

References SDL_Keyboard::focus, SDL_Window::id, SDL_arraysize, SDL_ENABLE, SDL_GetEventState, SDL_keyboard, SDL_PushEvent, SDL_TEXTINPUT, SDL_utf8strlcpy, and text.

Referenced by SDL_BApp::_HandleKey(), and DBus_MessageFilter().

SDL_SetKeyboardFocus()

void SDL_SetKeyboardFocus

(

SDL_Window *

window

)

Definition at line 634 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
 
    if (keyboard->focus && !window) {
        /* We won't get anymore keyboard messages, so reset keyboard state */
        SDL_ResetKeyboard();
    }
 
    /* See if the current window has lost focus */
    if (keyboard->focus && keyboard->focus != window) {
 
        /* new window shouldn't think it has mouse captured. */
        SDL_assert(!window || !(window->flags & SDL_WINDOW_MOUSE_CAPTURE));
 
        /* old window must lose an existing mouse capture. */
        if (keyboard->focus->flags & SDL_WINDOW_MOUSE_CAPTURE) {
            SDL_CaptureMouse(SDL_FALSE);  /* drop the capture. */
            SDL_assert(!(keyboard->focus->flags & SDL_WINDOW_MOUSE_CAPTURE));
        }
 
        SDL_SendWindowEvent(keyboard->focus, SDL_WINDOWEVENT_FOCUS_LOST,
                            0, 0);
 
        /* Ensures IME compositions are committed */
        if (SDL_EventState(SDL_TEXTINPUT, SDL_QUERY)) {
            SDL_VideoDevice *video = SDL_GetVideoDevice();
            if (video && video->StopTextInput) {
                video->StopTextInput(video);
            }
        }
    }
 
    keyboard->focus = window;
 
    if (keyboard->focus) {
        SDL_SendWindowEvent(keyboard->focus, SDL_WINDOWEVENT_FOCUS_GAINED,
                            0, 0);
 
        if (SDL_EventState(SDL_TEXTINPUT, SDL_QUERY)) {
            SDL_VideoDevice *video = SDL_GetVideoDevice();
            if (video && video->StartTextInput) {
                video->StartTextInput(video);
            }
        }
    }
}

References SDL_Window::flags, SDL_Keyboard::focus, SDL_assert, SDL_CaptureMouse, SDL_EventState, SDL_FALSE, SDL_GetVideoDevice(), SDL_keyboard, SDL_QUERY, SDL_ResetKeyboard(), SDL_SendWindowEvent(), SDL_TEXTINPUT, SDL_WINDOW_MOUSE_CAPTURE, SDL_WINDOWEVENT_FOCUS_GAINED, SDL_WINDOWEVENT_FOCUS_LOST, SDL_VideoDevice::StartTextInput, and SDL_VideoDevice::StopTextInput.

Referenced by SDL_BApp::_HandleKeyboardFocus(), and SDL_DestroyWindow().

SDL_SetKeymap()

void SDL_SetKeymap	(	int	start,
		SDL_Keycode *	keys,
		int	length
	)

Definition at line 598 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
    SDL_Scancode scancode;
 
    if (start < 0 || start + length > SDL_NUM_SCANCODES) {
        return;
    }
 
    SDL_memcpy(&keyboard->keymap[start], keys, sizeof(*keys) * length);
 
    /* The number key scancodes always map to the number key keycodes.
     * On AZERTY layouts these technically are symbols, but users (and games)
     * always think of them and view them in UI as number keys.
     */
    keyboard->keymap[SDL_SCANCODE_0] = SDLK_0;
    for (scancode = SDL_SCANCODE_1; scancode <= SDL_SCANCODE_9; ++scancode) {
        keyboard->keymap[scancode] = SDLK_1 + (scancode - SDL_SCANCODE_1);
    }
}

References SDL_Keyboard::keymap, SDL_keyboard, SDL_memcpy, SDL_NUM_SCANCODES, SDL_SCANCODE_0, SDL_SCANCODE_1, SDL_SCANCODE_9, SDLK_0, and SDLK_1.

SDL_SetScancodeName()

void SDL_SetScancodeName	(	SDL_Scancode	scancode,
		const char *	name
	)

Definition at line 620 of file SDL_keyboard.c.

{
    SDL_scancode_names[scancode] = name;
}

References SDL_scancode_names.

SDL_ToggleModState()

void SDL_ToggleModState	(	const SDL_Keymod	modstate,
		const SDL_bool	toggle
	)

Definition at line 924 of file SDL_keyboard.c.

{
    SDL_Keyboard *keyboard = &SDL_keyboard;
    if (toggle) {
        keyboard->modstate |= modstate;
    } else {
        keyboard->modstate &= ~modstate;
    }
}

References SDL_Keyboard::modstate, and SDL_keyboard.

SDL_UCS4ToUTF8()

char* SDL_UCS4ToUTF8	(	Uint32	ch,
		char *	dst
	)

Definition at line 524 of file SDL_keyboard.c.

{
    Uint8 *p = (Uint8 *) dst;
    if (ch <= 0x7F) {
        *p = (Uint8) ch;
        ++dst;
    } else if (ch <= 0x7FF) {
        p[0] = 0xC0 | (Uint8) ((ch >> 6) & 0x1F);
        p[1] = 0x80 | (Uint8) (ch & 0x3F);
        dst += 2;
    } else if (ch <= 0xFFFF) {
        p[0] = 0xE0 | (Uint8) ((ch >> 12) & 0x0F);
        p[1] = 0x80 | (Uint8) ((ch >> 6) & 0x3F);
        p[2] = 0x80 | (Uint8) (ch & 0x3F);
        dst += 3;
    } else if (ch <= 0x1FFFFF) {
        p[0] = 0xF0 | (Uint8) ((ch >> 18) & 0x07);
        p[1] = 0x80 | (Uint8) ((ch >> 12) & 0x3F);
        p[2] = 0x80 | (Uint8) ((ch >> 6) & 0x3F);
        p[3] = 0x80 | (Uint8) (ch & 0x3F);
        dst += 4;
    } else if (ch <= 0x3FFFFFF) {
        p[0] = 0xF8 | (Uint8) ((ch >> 24) & 0x03);
        p[1] = 0x80 | (Uint8) ((ch >> 18) & 0x3F);
        p[2] = 0x80 | (Uint8) ((ch >> 12) & 0x3F);
        p[3] = 0x80 | (Uint8) ((ch >> 6) & 0x3F);
        p[4] = 0x80 | (Uint8) (ch & 0x3F);
        dst += 5;
    } else {
        p[0] = 0xFC | (Uint8) ((ch >> 30) & 0x01);
        p[1] = 0x80 | (Uint8) ((ch >> 24) & 0x3F);
        p[2] = 0x80 | (Uint8) ((ch >> 18) & 0x3F);
        p[3] = 0x80 | (Uint8) ((ch >> 12) & 0x3F);
        p[4] = 0x80 | (Uint8) ((ch >> 6) & 0x3F);
        p[5] = 0x80 | (Uint8) (ch & 0x3F);
        dst += 6;
    }
    return dst;
}

Referenced by SDL_GetKeyName().