ui_ncurses_input.c

Go to the documentation of this file.

#include "ui_ncurses_internal.h"
#include <string.h>
/** @file
   @brief Input handling for ncurses-based UI.
   @ingroup ui_ncurses
 
   This file implements the input handling for the ncurses-based UI. It translates
   ncurses key codes into the UI's internal key representation and handles mouse events.
 */
 
/**
   @brief Translates a ncurses key code into the UI's internal key
   representation.
 
   @param ch The ncurses key code to translate.
   @return The corresponding UiKey value.
 */
static UiKey translate_key(int ch) {
    switch (ch) {
    case ERR:
        return UI_KEY_NONE;
    case '\n':
    case '\r':
        return UI_KEY_ENTER;
    case 27:
        return UI_KEY_ESCAPE;
    case '\t':
        return UI_KEY_TAB;
#ifdef KEY_BTAB
    case KEY_BTAB:
        return UI_KEY_BTAB;
#endif
    case KEY_UP:
        return UI_KEY_UP;
    case KEY_DOWN:
        return UI_KEY_DOWN;
    case KEY_LEFT:
        return UI_KEY_LEFT;
    case KEY_RIGHT:
        return UI_KEY_RIGHT;
    case KEY_HOME:
        return UI_KEY_HOME;
    case KEY_END:
        return UI_KEY_END;
    case KEY_PPAGE:
        return UI_KEY_PGUP;
    case KEY_NPAGE:
        return UI_KEY_PGDN;
    case KEY_IC:
        return UI_KEY_INSERT;
    case KEY_DC:
        return UI_KEY_DELETE;
    case KEY_BACKSPACE:
        return UI_KEY_BACKSPACE;
#ifdef KEY_RESIZE
    case KEY_RESIZE:
        return UI_KEY_RESIZE;
#endif
    case KEY_MOUSE:
        return UI_KEY_MOUSE;
    case KEY_F(1):
        return UI_KEY_F1;
    case KEY_F(2):
        return UI_KEY_F2;
    case KEY_F(3):
        return UI_KEY_F3;
    case KEY_F(4):
        return UI_KEY_F4;
    case KEY_F(5):
        return UI_KEY_F5;
    case KEY_F(6):
        return UI_KEY_F6;
    case KEY_F(7):
        return UI_KEY_F7;
    case KEY_F(8):
        return UI_KEY_F8;
    case KEY_F(9):
        return UI_KEY_F9;
    case KEY_F(10):
        return UI_KEY_F10;
    case KEY_F(11):
        return UI_KEY_F11;
    case KEY_F(12):
        return UI_KEY_F12;
 
    default:
        if (ch >= 32 && ch <= 126)
            return UI_KEY_CHAR;
        return UI_KEY_NONE;
    }
}
 
/**
   @brief Retrieves an input event from the specified UI surface.
   @ingroup ui_ncurses
 
   This function waits for an input event on the given UI surface (or the standard
   screen if no surface is specified) and fills the provided UiEvent structure
   with the details of the event. It handles both keyboard and mouse events.
 
   @param ui The UI runtime context (unused in this implementation).
   @param target The UI surface to monitor for events, or NULL to use stdscr.
   @param ev A pointer to a UiEvent structure to be filled with event details.
   @param timeout_ms The maximum time to wait for an event in milliseconds,
   or -1 to wait indefinitely.
   @return 0 on success, or -1 on error (e.g., if ev is NULL).
 */
int ui_get_event(UiRuntime *ui, UiSurface *target, UiEvent *ev, int timeout_ms) {
    int ch;
    WINDOW *win;
 
    (void)ui;
    if (!ev)
        return -1;
    memset(ev, 0, sizeof(*ev));
 
    win = target ? target->win : stdscr;
 
    if (timeout_ms < 0) {
        wtimeout(win, -1);
    } else {
        wtimeout(win, timeout_ms);
    }
 
    ch = wgetch(win);
    ev->key = translate_key(ch);
 
    if (ev->key == UI_KEY_CHAR) {
        ev->ch = (uint32_t)ch;
    } else if (ev->key == UI_KEY_MOUSE) {
        MEVENT me;
        if (getmouse(&me) == OK) {
            ev->y = me.y;
            ev->x = me.x;
#ifdef BUTTON4_PRESSED
            if (me.bstate & BUTTON4_PRESSED) {
                ev->mouse_action = UI_MOUSE_SCROLL_UP;
#endif
#ifdef BUTTON5_PRESSED
            } else if (me.bstate & BUTTON5_PRESSED) {
                ev->mouse_action = UI_MOUSE_SCROLL_DOWN;
#endif
            } else if (me.bstate & BUTTON1_PRESSED) {
                ev->mouse_action = UI_MOUSE_PRESS;
            } else if (me.bstate & BUTTON1_RELEASED) {
                ev->mouse_action = UI_MOUSE_RELEASE;
            }
        }
    }
 
    return 0;
}