KallistiOS git master
Independent SDK for the Sega Dreamcast
Loading...
Searching...
No Matches

Frame-based polling for keyboard input More...

Functions

kbd_state_tkbd_get_state (maple_device_t *device)
 Retrieves the keyboard state from a maple device.
 

Detailed Description

Frame-based polling for keyboard input

One method of checking for key input is to simply poll kbd_state_t::key_states for the desired key states each frame.

First, lets grab a pointer to the kbd_state_t:

kbd_state_t *kbd = kbd_get_state(device);
kbd_state_t * kbd_get_state(maple_device_t *device)
Retrieves the keyboard state from a maple device.
Keyboard status structure.
Definition keyboard.h:450

Then let's "move" every frame an arrow key is held down:

if(kbd->key_states[KBD_KEY_LEFT].is_down)
    printf("Moving left!\n");
if(kbd->key_states[KBD_KEY_RIGHT].is_down)
    printf("Moving right!\n");
if(kbd->key_states[KBD_KEY_UP].is_down)
    printf("Moving up!\n");
if(kbd->key_states[KBD_KEY_DOWN].is_down)
    printf("Moving down!\n");

Finally, let's "attack" for only a single frame each time the button is pressed, requiring it to be released and pressed again to start the next attack:

if(kbd->key_states[KBD_KEY_SPACE].value == KEY_STATE_CHANGED_DOWN)
    printf("Attacking!\n");

Function Documentation

◆ kbd_get_state()

kbd_state_t * kbd_get_state ( maple_device_t * device)

Retrieves the keyboard state from a maple device.

Accessor method for safely retrieving a kbd_state_t from a maple_device_t of a MAPLE_FUNC_KEYBOARD type. This function also checks for whether the given device is actually a keyboard and for whether it is currently valid.

Parameters
deviceHandle corresponding to a MAPLE_FUNC_KEYBOARD device.
Return values
kbd_state_t*A pointer to the internal keyboard state on success.
NULLOn failure.