src/touchscreengui.h

   1 /*
   2 Copyright (C) 2014 sapier
   3
   4 This program is free software; you can redistribute it and/or modify
   5 it under the terms of the GNU Lesser General Public License as published by
   6 the Free Software Foundation; either version 2.1 of the License, or
   7 (at your option) any later version.
   8
   9 This program is distributed in the hope that it will be useful,
  10 but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 GNU Lesser General Public License for more details.
  13
  14 You should have received a copy of the GNU Lesser General Public License along
  15 with this program; if not, write to the Free Software Foundation, Inc.,
  16 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  17 */
  18
  19 #ifndef TOUCHSCREENGUI_HEADER
  20 #define TOUCHSCREENGUI_HEADER
  21
  22 #include <IGUIEnvironment.h>
  23 #include <IGUIButton.h>
  24 #include <IEventReceiver.h>
  25
  26 #include <vector>
  27 #include <map>
  28
  29 #include "game.h"
  30 #include "client/tile.h"
  31
  32 using namespace irr;
  33 using namespace irr::core;
  34 using namespace irr::gui;
  35
  36 typedef enum {
  37         forward_id = 0,
  38         backward_id,
  39         left_id,
  40         right_id,
  41         jump_id,
  42         crunch_id,
  43         after_last_element_id,
  44         settings_starter_id,
  45         rare_controls_starter_id,
  46         fly_id,
  47         noclip_id,
  48         fast_id,
  49         debug_id,
  50         camera_id,
  51         range_id,
  52         chat_id,
  53         inventory_id,
  54         drop_id
  55 } touch_gui_button_id;
  56
  57 typedef enum {
  58         AHBB_Dir_Top_Bottom,
  59         AHBB_Dir_Bottom_Top,
  60         AHBB_Dir_Left_Right,
  61         AHBB_Dir_Right_Left
  62 } autohide_button_bar_dir;
  63
  64 #define MIN_DIG_TIME_MS 500
  65 #define MAX_TOUCH_COUNT 64
  66 #define BUTTON_REPEAT_DELAY 0.2f
  67
  68 #define SETTINGS_BAR_Y_OFFSET 6.5
  69 #define RARE_CONTROLS_BAR_Y_OFFSET 4
  70
  71 extern const char** touchgui_button_imagenames;
  72
  73 struct button_info {
  74         float            repeatcounter;
  75         float            repeatdelay;
  76         irr::EKEY_CODE   keycode;
  77         std::vector<int> ids;
  78         IGUIButton*      guibutton;
  79         bool             immediate_release;
  80 };
  81
  82 class AutoHideButtonBar
  83 {
  84 public:
  85
  86         AutoHideButtonBar( IrrlichtDevice *device, IEventReceiver* receiver );
  87
  88         void init(ISimpleTextureSource* tsrc, const char* starter_img,
  89                         int button_id, v2s32 UpperLeft, v2s32 LowerRight,
  90                         autohide_button_bar_dir dir, float timeout);
  91
  92         ~AutoHideButtonBar();
  93
  94         /* add button to be shown */
  95         void addButton(touch_gui_button_id id, const wchar_t* caption,
  96                         const char* btn_image);
  97
  98         /* detect settings bar button events */
  99         bool isButton(const SEvent &event);
 100
 101         /* handle released hud buttons */
 102         bool isReleaseButton(int eventID);
 103
 104         /* step handler */
 105         void step(float dtime);
 106
 107         /* deactivate button bar */
 108         void deactivate();
 109
 110         /* hide the whole buttonbar */
 111         void hide();
 112
 113         /* unhide the buttonbar */
 114         void show();
 115
 116 private:
 117         ISimpleTextureSource*     m_texturesource;
 118         irr::video::IVideoDriver* m_driver;
 119         IGUIEnvironment*          m_guienv;
 120         IEventReceiver*           m_receiver;
 121         v2u32                     m_screensize;
 122         button_info               m_starter;
 123         std::vector<button_info*> m_buttons;
 124
 125         v2s32                     m_upper_left;
 126         v2s32                     m_lower_right;
 127
 128         /* show settings bar */
 129         bool                      m_active;
 130
 131         bool                      m_visible;
 132
 133         /* settings bar timeout */
 134         float                     m_timeout;
 135         float                     m_timeout_value;
 136         bool                      m_initialized;
 137         autohide_button_bar_dir   m_dir;
 138 };
 139
 140 class TouchScreenGUI
 141 {
 142 public:
 143         TouchScreenGUI(IrrlichtDevice *device, IEventReceiver* receiver);
 144         ~TouchScreenGUI();
 145
 146         void translateEvent(const SEvent &event);
 147
 148         void init(ISimpleTextureSource* tsrc);
 149
 150         double getYawChange() {
 151                 double res = m_camera_yaw_change;
 152                 m_camera_yaw_change = 0;
 153                 return res;
 154         }
 155
 156         double getPitch() { return m_camera_pitch; }
 157
 158         line3d<f32> getShootline() { return m_shootline; }
 159
 160         void step(float dtime);
 161         void resetHud();
 162         void registerHudItem(int index, const rect<s32> &rect);
 163         void Toggle(bool visible);
 164
 165         void hide();
 166         void show();
 167
 168 private:
 169         IrrlichtDevice*         m_device;
 170         IGUIEnvironment*        m_guienv;
 171         IEventReceiver*         m_receiver;
 172         ISimpleTextureSource*   m_texturesource;
 173         v2u32                   m_screensize;
 174         std::map<int,rect<s32> > m_hud_rects;
 175         std::map<int,irr::EKEY_CODE> m_hud_ids;
 176         bool                    m_visible; // is the gui visible
 177
 178         /* value in degree */
 179         double                  m_camera_yaw_change;
 180         double                  m_camera_pitch;
 181
 182         line3d<f32>             m_shootline;
 183
 184         rect<s32>               m_control_pad_rect;
 185
 186         int                     m_move_id;
 187         bool                    m_move_has_really_moved;
 188         s32                     m_move_downtime;
 189         bool                    m_move_sent_as_mouse_event;
 190         v2s32                   m_move_downlocation;
 191
 192         button_info m_buttons[after_last_element_id];
 193
 194         /* gui button detection */
 195         touch_gui_button_id getButtonID(s32 x, s32 y);
 196
 197         /* gui button by eventID */
 198         touch_gui_button_id getButtonID(int eventID);
 199
 200         /* check if a button has changed */
 201         void handleChangedButton(const SEvent &event);
 202
 203         /* initialize a button */
 204         void initButton(touch_gui_button_id id, rect<s32> button_rect,
 205                         std::wstring caption, bool immediate_release,
 206                         float repeat_delay = BUTTON_REPEAT_DELAY);
 207
 208         /* load texture */
 209         void loadButtonTexture(button_info* btn, const char* path, rect<s32> button_rect);
 210
 211         struct id_status{
 212                 int id;
 213                 int X;
 214                 int Y;
 215         };
 216
 217         /* vector to store known ids and their initial touch positions*/
 218         std::vector<id_status> m_known_ids;
 219
 220         /* handle a button event */
 221         void handleButtonEvent(touch_gui_button_id bID, int eventID, bool action);
 222
 223         /* handle pressed hud buttons */
 224         bool isHUDButton(const SEvent &event);
 225
 226         /* handle released hud buttons */
 227         bool isReleaseHUDButton(int eventID);
 228
 229         /* handle double taps */
 230         bool doubleTapDetection();
 231
 232         /* handle release event */
 233         void handleReleaseEvent(int evt_id);
 234
 235         /* get size of regular gui control button */
 236         int getGuiButtonSize();
 237
 238         /* doubleclick detection variables */
 239         struct key_event {
 240                 unsigned int down_time;
 241                 s32 x;
 242                 s32 y;
 243         };
 244
 245         /* array for saving last known position of a pointer */
 246         v2s32 m_pointerpos[MAX_TOUCH_COUNT];
 247
 248         /* array for doubletap detection */
 249         key_event m_key_events[2];
 250
 251         /* settings bar */
 252         AutoHideButtonBar m_settingsbar;
 253
 254         /* rare controls bar */
 255         AutoHideButtonBar m_rarecontrolsbar;
 256 };
 257 extern TouchScreenGUI *g_touchscreengui;
 258 #endif