lg_ui.h

/*
 *      LibGame - Copyright (C) Emmanuel Thomas-Maurin 2011-2025
 *      All rights reserved
 */
 
#ifndef LG_UI_H
#define LG_UI_H
 
#ifndef ANDROID_V
#  define FLUSH_KEYB_OR_TOUCHSCREEN_BUF         {lg_flush_keyb_buf();}
#else
#  define FLUSH_KEYB_OR_TOUCHSCREEN_BUF         {lg_flush_touchscreen_buf();}
#endif
 
#ifndef ANDROID_V
#  define WAIT_FOR_PRESS_OR_TOUCH               {lg_wait_for_any_key_pressed();}
#else
#  define WAIT_FOR_PRESS_OR_TOUCH               {lg_wait_for_finger_down(NULL, NULL);}
#endif
 
#define FUNC_KEYS_REPEAT_DELAY                  200     /* In ms */
 
/*
 * Check this out:
 * Android touch screen
 *      typedef enum {
 *              LG_FINGER_DOWN_NO_LOC = 0,
 *              LG_FINGER_DOWN_LEFT = 1,
 *              LG_FINGER_DOWN_H_CENTER = 2,
 *              LG_FINGER_DOWN_RIGHT = 4,
 *              LG_FINGER_DOWN_BOTTOM = 8,
 *              LG_FINGER_DOWN_V_CENTER = 16,
 *              LG_FINGER_DOWN_TOP = 32
 *      } lg_finger_down_loc;
 *
 *\code
 *            L     C     R
 *         -------------------
 *      T  |     |     |     |
 *         -------------------
 *      C  |     |     |     |
 *         -------------------
 *      B  |     |     |     |
 *         -------------------
 *
 *      TZ_LEFT
 *      TZ_H_CENTER
 *      TZ_RIGHT
 *      TZ_BOTTOM
 *      TZ_V_CENTER
 *      TZ_TOP
 *\endcode
 */
 
typedef struct {
        /* Linux */
        uint8_t                 arrow_keys_state;       /* LEFT, RIGHT, UP, DOWN */
        zboolean                kmod_ctrl;
        zboolean                kmod_shift;
        zboolean                kmod_alt;
        uint32_t                last_pressed_key;
        /* Android */
        lg_finger_down_loc      finger_down_loc;        /* Logical OR of values */
        float                   x;
        float                   y;
        /* Cam/object motions = -1, 0, 1 (but slow_motion) */
        int                     move_forward;
        int                     move_up;                /* Y transl - not an aircraft motion */
        int                     cam_truck;              /* X transl - not an aircraft motion */
        int                     h_orbit;
        int                     v_orbit;
        int                     slow_motion;
        int                     fast_motion;            /* Unused so far */
        /* Yaw/Pitch/Roll = -1, 0, 1 */                 /* Aircraft/flight simulator standard order */
        int                     yaw;                    /* Or pan */
        int                     pitch;                  /* Or tilt */
        int                     roll;
        //
        // -> need yaw/pitch/roll quats ?
        //
        /* Mouse inputs */
        zboolean                left_click;
        zboolean                right_click;
        int                     dx;
        int                     dy;
        int                     dz_wheel;               /* Mouse wheel also set move_forward */
} LG_InputState;
 
/*
 * TZ/tz means Touch Zone (not Time Zone)
 */
typedef enum {
        TZ_LEFT,
        TZ_H_CENTER,
        TZ_RIGHT,
        TZ_BOTTOM,
        TZ_V_CENTER,
        TZ_TOP
} lg_touch_zone;
 
typedef struct {
        LG_Window       win;
        LG_Color_u      color;
        Rec2Di          area;
} LG_TouchZoneWindow;
 
#define TZW_ARROW_POINTS_NUM    7
 
typedef enum {
        TZW_RECTANGLE,
        TZW_RECT_CORNERS,
        TZW_ARROW_UP,
        TZW_ARROW_DOWN,
        TZW_ARROW_LEFT,
        TZW_ARROW_RIGHT,
        TZW_DOUBLE_ARROW_HORIZ,
        TZW_DOUBLE_ARROW_VERT,
} lg_tzw_type;
 
uint32_t                lg_get_user_input(LG_InputState *, Rec2Di *[]);
 
LG_TouchZoneWindow      *lg_tzwin_new(const char *, LG_Color_u, int, int, TTF_Font *);
 
void                    lg_tzwin_show(LG_TouchZoneWindow *, lg_tzw_type);
 
void                    lg_tzwin_free(LG_TouchZoneWindow *);
 
Rec2Di                  lg_tzwin_get_rect(LG_TouchZoneWindow *);
 
void                    lg_draw_rect_corners(Rec2Di, LG_Color_u, int);
 
void                    lg_draw_arrow(Rec2Di r, LG_Color_u c, lg_tzw_type);
 
void                    lg_rectangle_to_arrow(Rec2Di, lg_tzw_type, Point2Di *[]);
 
void                    lg_set_func_keys_repeat_delay(uint32_t);
 
#endif /* LG_UI_H */