lg_ui.h

/*
 *      LibGame - Copyright (C) Emmanuel Thomas-Maurin 2011-2026
 *      All rights reserved
 */
 
#ifndef LG_UI_H
#define LG_UI_H
 
#ifndef ANDROID_V
#  define FLUSH_KEYB_OR_TOUCHSCREEN_BUF         {lg_flush_keyb_events();}       /* Don't call lg_flush_mouse_events() */
#else
#  define FLUSH_KEYB_OR_TOUCHSCREEN_BUF         {lg_flush_touch_events();}
#endif
 
#ifndef ANDROID_V
#  define WAIT_FOR_PRESS_OR_TOUCH               {lg_wait_for_any_key_pressed();}
#  define WAIT_FOR_PRESS_OR_CLICK_OR_TOUCH      {lg_wait_for_any_key_pressed_or_left_click();}
#else
#  define WAIT_FOR_PRESS_OR_TOUCH               {lg_wait_for_finger_down(NULL, NULL);}
#  define WAIT_FOR_PRESS_OR_CLICK_OR_TOUCH      {lg_wait_for_finger_down(NULL, NULL);}          /* ???? - whatever */
#endif
 
#define SPECIAL_KEYS_REPEAT_DELAY               200     /* In ms */
 
/* LPK = Last Pressed_Key */
#define LPK_MOUSE_CLICK_ACTIVITY                50000   /* Returned (+ in->tzw_i) by lg_get_user_input() as last pressed key in case of mouse activity */
 
#define LPK_TOUCH_ACTIVITY                      100000  /* Returned (+ in->tzw_i) by lg_get_user_input() as last pressed key in case of touch activity */
 
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 (touchscreen) */
        lg_finger_down_loc      finger_down_loc;        /* Logical OR of values */
        float                   x;
        float                   y;
        /* Mouse or touchscreen */
        uint32_t                tzw_i;                  /* Index + 1 of clicked/tapped TZW area in array */
        /* Cam/object motions and rotations = -1, 0, 1 */
        int                     move_forward;           /* Z transl */
        int                     move_up;                /* Y transl - not an aircraft motion */
        int                     cam_truck;              /* X transl - not an aircraft motion */
        /* Yaw/Pitch/Roll = -1, 0, 1 */                 /* Aircraft/flight simulator standard order */
        int                     yaw;
        int                     pitch;
        int                     roll;
        /* Orbit cam */
        int                     h_orbit;
        int                     v_orbit;
        /* Mouse inputs */
        zboolean                left_click;
        zboolean                right_click;
        int                     mouse_x;
        int                     mouse_y;
        int                     dx;
        int                     dy;
        int                     dz_wheel;               /* Mouse wheel also set move_forward */
        float                   thrust;
        /* Appply for keyboard and mouse */
        zboolean                slow_motion;
} 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,
        TZW_TRIANGLE_LEFT,
        TZW_TRIANGLE_RIGHT,
        TZW_TRIANGLE_UP,
        TZW_TRIANGLE_DOWN
} lg_tzw_type;
 
#define N_TZW_MAX       256
 
/* Array of all TZ wins for one frame */
typedef struct {
        LG_TouchZoneWindow      *tzw[N_TZW_MAX];
} LG_TZW_Array;
 
/* Helper struct to deal with TZ win area rects */
typedef struct {
        Rec2Di          *r[N_TZW_MAX];
        Rec2Di          r0[N_TZW_MAX];
} LG_TZRec_Array;
 
const char              **lg_camcontrols_keys_str();
 
uint32_t                lg_get_user_input(LG_InputState *, LG_TZW_Array *);
 
void                    lg_zero_input_state(LG_InputState *);
 
LG_TouchZoneWindow      *lg_tzwin_new(const char *, zboolean, 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_area(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_draw_triangle(Rec2Di, LG_Color_u, lg_tzw_type);
 
void                    lg_set_special_keys_repeat_delay(uint32_t);
 
LG_TZW_Array            *lg_tzw_array_new();
 
zboolean                lg_tzwin_add_to_array(LG_TZW_Array *, LG_TouchZoneWindow *);
 
LG_TZRec_Array          lg_rec2di_array_from_tzw_array(LG_TZW_Array *);
 
void                    lg_tzw_array_free_all_tzwin(LG_TZW_Array *);
 
void                    lg_tzw_array_free_all_tzwin_after(LG_TZW_Array *, uint32_t);
 
void                    lg_tzw_array_free(LG_TZW_Array *);
 
void                    lg_flush_in_clicks(LG_InputState *);
 
void                    lg_input_state_info(LG_InputState *);
 
#endif /* LG_UI_H */