ra8_keyboard.h

Go to the documentation of this file.

 
#pragma once
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include <stdint.h>
 
#include "ra8_err.h"
#include "ra8_ui.h"

typedef enum : uint8_t {
  k_ra8_kbd_rows     = 4U,   
  k_ra8_kbd_max_keys = 40U,  
  k_ra8_kbd_text_max = 64U,  
  k_ra8_kbd_no_hit   = 255U, 
} ra8_kbd_limits_t;

typedef enum : uint8_t {
  k_ra8_kbd_layer_letters = 0U, 
  k_ra8_kbd_layer_numbers = 1U, 
  k_ra8_kbd_layer_symbols = 2U, 
} ra8_kbd_layer_t;

typedef enum : uint8_t {
  k_ra8_kbd_key_char      = 0U, 
  k_ra8_kbd_key_space     = 1U, 
  k_ra8_kbd_key_backspace = 2U, 
  k_ra8_kbd_key_enter     = 3U, 
  k_ra8_kbd_key_shift     = 4U, 
  k_ra8_kbd_key_layer     = 5U, 
} ra8_kbd_key_kind_t;

typedef struct {
  ra8_ui_rect_t      rect;     
  char               ch_lower; 
  char               ch_upper; 
  ra8_kbd_key_kind_t kind;     
  uint8_t            aux;      
} ra8_kbd_key_t;

typedef struct {
  ra8_kbd_key_t keys[k_ra8_kbd_max_keys]; 
  uint8_t       count;                    
  bool          shift;                    
  uint8_t       layer;                    
  ra8_ui_rect_t frame;                    
} ra8_kbd_layout_t;

typedef struct {
  char    buf[k_ra8_kbd_text_max]; 
  uint8_t len;                     
  bool    committed;               
} ra8_kbd_text_t;

[[nodiscard]] ra8_err_t ra8_kbd_layout_init(ra8_kbd_layout_t* kb, const ra8_ui_rect_t* frame);

[[nodiscard]] uint8_t ra8_kbd_hit(const ra8_kbd_layout_t* kb, int32_t px, int32_t py);

[[nodiscard]] char ra8_kbd_key_glyph(const ra8_kbd_layout_t* kb, uint8_t key_idx);

[[nodiscard]] ra8_err_t ra8_kbd_text_init(ra8_kbd_text_t* t);

[[nodiscard]] ra8_err_t ra8_kbd_apply(ra8_kbd_text_t* t, ra8_kbd_layout_t* kb, uint8_t key_idx);
 
#ifdef __cplusplus
}
#endif