src/guiFormSpecMenu.h

   1 /*
   2 Minetest
   3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   5 This program is free software; you can redistribute it and/or modify
   6 it under the terms of the GNU Lesser General Public License as published by
   7 the Free Software Foundation; either version 2.1 of the License, or
   8 (at your option) any later version.
   9
  10 This program is distributed in the hope that it will be useful,
  11 but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 GNU Lesser General Public License for more details.
  14
  15 You should have received a copy of the GNU Lesser General Public License along
  16 with this program; if not, write to the Free Software Foundation, Inc.,
  17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  18 */
  19
  20
  21 #ifndef GUIINVENTORYMENU_HEADER
  22 #define GUIINVENTORYMENU_HEADER
  23
  24 #include <utility>
  25 #include <stack>
  26
  27 #include "irrlichttypes_extrabloated.h"
  28 #include "inventorymanager.h"
  29 #include "modalMenu.h"
  30 #include "guiTable.h"
  31 #include "network/networkprotocol.h"
  32 #include "client/joystick_controller.h"
  33 #include "util/string.h"
  34 #include "util/enriched_string.h"
  35
  36 class InventoryManager;
  37 class ISimpleTextureSource;
  38 class Client;
  39
  40 typedef enum {
  41         f_Button,
  42         f_Table,
  43         f_TabHeader,
  44         f_CheckBox,
  45         f_DropDown,
  46         f_ScrollBar,
  47         f_Unknown
  48 } FormspecFieldType;
  49
  50 typedef enum {
  51         quit_mode_no,
  52         quit_mode_accept,
  53         quit_mode_cancel
  54 } FormspecQuitMode;
  55
  56 struct TextDest
  57 {
  58         virtual ~TextDest() {}
  59         // This is deprecated I guess? -celeron55
  60         virtual void gotText(const std::wstring &text) {}
  61         virtual void gotText(const StringMap &fields) = 0;
  62
  63         std::string m_formname;
  64 };
  65
  66 class IFormSource
  67 {
  68 public:
  69         virtual ~IFormSource(){}
  70         virtual std::string getForm() = 0;
  71         // Fill in variables in field text
  72         virtual std::string resolveText(const std::string &str) { return str; }
  73 };
  74
  75 class GUIFormSpecMenu : public GUIModalMenu
  76 {
  77         struct ItemSpec
  78         {
  79                 ItemSpec() :
  80                         i(-1)
  81                 {
  82                 }
  83
  84                 ItemSpec(const InventoryLocation &a_inventoryloc,
  85                                 const std::string &a_listname,
  86                                 s32 a_i) :
  87                         inventoryloc(a_inventoryloc),
  88                         listname(a_listname),
  89                         i(a_i)
  90                 {
  91                 }
  92
  93                 bool isValid() const { return i != -1; }
  94
  95                 InventoryLocation inventoryloc;
  96                 std::string listname;
  97                 s32 i;
  98         };
  99
 100         struct ListDrawSpec
 101         {
 102                 ListDrawSpec()
 103                 {
 104                 }
 105                 ListDrawSpec(const InventoryLocation &a_inventoryloc,
 106                                 const std::string &a_listname,
 107                                 v2s32 a_pos, v2s32 a_geom, s32 a_start_item_i):
 108                         inventoryloc(a_inventoryloc),
 109                         listname(a_listname),
 110                         pos(a_pos),
 111                         geom(a_geom),
 112                         start_item_i(a_start_item_i)
 113                 {
 114                 }
 115
 116                 InventoryLocation inventoryloc;
 117                 std::string listname;
 118                 v2s32 pos;
 119                 v2s32 geom;
 120                 s32 start_item_i;
 121         };
 122
 123         struct ListRingSpec
 124         {
 125                 ListRingSpec()
 126                 {
 127                 }
 128                 ListRingSpec(const InventoryLocation &a_inventoryloc,
 129                                 const std::string &a_listname):
 130                         inventoryloc(a_inventoryloc),
 131                         listname(a_listname)
 132                 {
 133                 }
 134
 135                 InventoryLocation inventoryloc;
 136                 std::string listname;
 137         };
 138
 139         struct ImageDrawSpec
 140         {
 141                 ImageDrawSpec():
 142                         parent_button(NULL),
 143                         clip(false)
 144                 {
 145                 }
 146
 147                 ImageDrawSpec(const std::string &a_name,
 148                                 const std::string &a_item_name,
 149                                 gui::IGUIButton *a_parent_button,
 150                                 const v2s32 &a_pos, const v2s32 &a_geom):
 151                         name(a_name),
 152                         item_name(a_item_name),
 153                         parent_button(a_parent_button),
 154                         pos(a_pos),
 155                         geom(a_geom),
 156                         scale(true),
 157                         clip(false)
 158                 {
 159                 }
 160
 161                 ImageDrawSpec(const std::string &a_name,
 162                                 const std::string &a_item_name,
 163                                 const v2s32 &a_pos, const v2s32 &a_geom):
 164                         name(a_name),
 165                         item_name(a_item_name),
 166                         parent_button(NULL),
 167                         pos(a_pos),
 168                         geom(a_geom),
 169                         scale(true),
 170                         clip(false)
 171                 {
 172                 }
 173
 174                 ImageDrawSpec(const std::string &a_name,
 175                                 const v2s32 &a_pos, const v2s32 &a_geom, bool clip=false):
 176                         name(a_name),
 177                         parent_button(NULL),
 178                         pos(a_pos),
 179                         geom(a_geom),
 180                         scale(true),
 181                         clip(clip)
 182                 {
 183                 }
 184
 185                 ImageDrawSpec(const std::string &a_name,
 186                                 const v2s32 &a_pos):
 187                         name(a_name),
 188                         parent_button(NULL),
 189                         pos(a_pos),
 190                         scale(false),
 191                         clip(false)
 192                 {
 193                 }
 194
 195                 std::string name;
 196                 std::string item_name;
 197                 gui::IGUIButton *parent_button;
 198                 v2s32 pos;
 199                 v2s32 geom;
 200                 bool scale;
 201                 bool clip;
 202         };
 203
 204         struct FieldSpec
 205         {
 206                 FieldSpec()
 207                 {
 208                 }
 209                 FieldSpec(const std::string &name, const std::wstring &label,
 210                                 const std::wstring &default_text, int id) :
 211                         fname(name),
 212                         flabel(label),
 213                         fdefault(unescape_enriched(default_text)),
 214                         fid(id),
 215                         send(false),
 216                         ftype(f_Unknown),
 217                         is_exit(false)
 218                 {
 219                 }
 220
 221                 std::string fname;
 222                 std::wstring flabel;
 223                 std::wstring fdefault;
 224                 int fid;
 225                 bool send;
 226                 FormspecFieldType ftype;
 227                 bool is_exit;
 228                 core::rect<s32> rect;
 229         };
 230
 231         struct BoxDrawSpec
 232         {
 233                 BoxDrawSpec(v2s32 a_pos, v2s32 a_geom,irr::video::SColor a_color):
 234                         pos(a_pos),
 235                         geom(a_geom),
 236                         color(a_color)
 237                 {
 238                 }
 239                 v2s32 pos;
 240                 v2s32 geom;
 241                 irr::video::SColor color;
 242         };
 243
 244         struct TooltipSpec
 245         {
 246                 TooltipSpec() {}
 247                 TooltipSpec(const std::string &a_tooltip, irr::video::SColor a_bgcolor,
 248                                 irr::video::SColor a_color):
 249                         tooltip(utf8_to_wide(a_tooltip)),
 250                         bgcolor(a_bgcolor),
 251                         color(a_color)
 252                 {
 253                 }
 254
 255                 std::wstring tooltip;
 256                 irr::video::SColor bgcolor;
 257                 irr::video::SColor color;
 258         };
 259
 260         struct StaticTextSpec
 261         {
 262                 StaticTextSpec():
 263                         parent_button(NULL)
 264                 {
 265                 }
 266
 267                 StaticTextSpec(const std::wstring &a_text,
 268                                 const core::rect<s32> &a_rect):
 269                         text(a_text),
 270                         rect(a_rect),
 271                         parent_button(NULL)
 272                 {
 273                 }
 274
 275                 StaticTextSpec(const std::wstring &a_text,
 276                                 const core::rect<s32> &a_rect,
 277                                 gui::IGUIButton *a_parent_button):
 278                         text(a_text),
 279                         rect(a_rect),
 280                         parent_button(a_parent_button)
 281                 {
 282                 }
 283
 284                 std::wstring text;
 285                 core::rect<s32> rect;
 286                 gui::IGUIButton *parent_button;
 287         };
 288
 289 public:
 290         GUIFormSpecMenu(JoystickController *joystick,
 291                         gui::IGUIElement* parent, s32 id,
 292                         IMenuManager *menumgr,
 293                         Client *client,
 294                         ISimpleTextureSource *tsrc,
 295                         IFormSource* fs_src,
 296                         TextDest* txt_dst,
 297                         bool remap_dbl_click = true);
 298
 299         ~GUIFormSpecMenu();
 300
 301         void setFormSpec(const std::string &formspec_string,
 302                         const InventoryLocation &current_inventory_location)
 303         {
 304                 m_formspec_string = formspec_string;
 305                 m_current_inventory_location = current_inventory_location;
 306                 regenerateGui(m_screensize_old);
 307         }
 308
 309         // form_src is deleted by this GUIFormSpecMenu
 310         void setFormSource(IFormSource *form_src)
 311         {
 312                 delete m_form_src;
 313                 m_form_src = form_src;
 314         }
 315
 316         // text_dst is deleted by this GUIFormSpecMenu
 317         void setTextDest(TextDest *text_dst)
 318         {
 319                 delete m_text_dst;
 320                 m_text_dst = text_dst;
 321         }
 322
 323         void allowClose(bool value)
 324         {
 325                 m_allowclose = value;
 326         }
 327
 328         void lockSize(bool lock,v2u32 basescreensize=v2u32(0,0))
 329         {
 330                 m_lock = lock;
 331                 m_lockscreensize = basescreensize;
 332         }
 333
 334         void removeChildren();
 335         void setInitialFocus();
 336
 337         void setFocus(const std::string &elementname)
 338         {
 339                 m_focused_element = elementname;
 340         }
 341
 342         /*
 343                 Remove and re-add (or reposition) stuff
 344         */
 345         void regenerateGui(v2u32 screensize);
 346
 347         ItemSpec getItemAtPos(v2s32 p) const;
 348         void drawList(const ListDrawSpec &s, int phase, bool &item_hovered);
 349         void drawSelectedItem();
 350         void drawMenu();
 351         void updateSelectedItem();
 352         ItemStack verifySelectedItem();
 353
 354         void acceptInput(FormspecQuitMode quitmode);
 355         bool preprocessEvent(const SEvent& event);
 356         bool OnEvent(const SEvent& event);
 357         bool doPause;
 358         bool pausesGame() { return doPause; }
 359
 360         GUITable* getTable(const std::string &tablename);
 361         std::vector<std::string>* getDropDownValues(const std::string &name);
 362
 363 #ifdef __ANDROID__
 364         bool getAndroidUIInput();
 365 #endif
 366
 367 protected:
 368         v2s32 getBasePos() const
 369         {
 370                         return padding + offset + AbsoluteRect.UpperLeftCorner;
 371         }
 372
 373         v2s32 padding;
 374         v2s32 spacing;
 375         v2s32 imgsize;
 376         v2s32 offset;
 377         v2s32 pos_offset;
 378         std::stack<v2s32> container_stack;
 379
 380         InventoryManager *m_invmgr;
 381         ISimpleTextureSource *m_tsrc;
 382         Client *m_client;
 383
 384         std::string m_formspec_string;
 385         InventoryLocation m_current_inventory_location;
 386
 387         std::vector<ListDrawSpec> m_inventorylists;
 388         std::vector<ListRingSpec> m_inventory_rings;
 389         std::vector<ImageDrawSpec> m_backgrounds;
 390         std::vector<ImageDrawSpec> m_images;
 391         std::vector<ImageDrawSpec> m_itemimages;
 392         std::vector<BoxDrawSpec> m_boxes;
 393         std::unordered_map<std::string, bool> field_close_on_enter;
 394         std::vector<FieldSpec> m_fields;
 395         std::vector<StaticTextSpec> m_static_texts;
 396         std::vector<std::pair<FieldSpec,GUITable*> > m_tables;
 397         std::vector<std::pair<FieldSpec,gui::IGUICheckBox*> > m_checkboxes;
 398         std::map<std::string, TooltipSpec> m_tooltips;
 399         std::vector<std::pair<FieldSpec,gui::IGUIScrollBar*> > m_scrollbars;
 400         std::vector<std::pair<FieldSpec, std::vector<std::string> > > m_dropdowns;
 401
 402         ItemSpec *m_selected_item = nullptr;
 403         u32 m_selected_amount = 0;
 404         bool m_selected_dragging = false;
 405
 406         // WARNING: BLACK MAGIC
 407         // Used to guess and keep up with some special things the server can do.
 408         // If name is "", no guess exists.
 409         ItemStack m_selected_content_guess;
 410         InventoryLocation m_selected_content_guess_inventory;
 411
 412         v2s32 m_pointer;
 413         v2s32 m_old_pointer;  // Mouse position after previous mouse event
 414         gui::IGUIStaticText *m_tooltip_element = nullptr;
 415
 416         u64 m_tooltip_show_delay;
 417         u64 m_hovered_time = 0;
 418         s32 m_old_tooltip_id = -1;
 419
 420         bool m_rmouse_auto_place = false;
 421
 422         bool m_allowclose = true;
 423         bool m_lock = false;
 424         v2u32 m_lockscreensize;
 425
 426         bool m_bgfullscreen;
 427         bool m_slotborder;
 428         video::SColor m_bgcolor;
 429         video::SColor m_slotbg_n;
 430         video::SColor m_slotbg_h;
 431         video::SColor m_slotbordercolor;
 432         video::SColor m_default_tooltip_bgcolor;
 433         video::SColor m_default_tooltip_color;
 434
 435 private:
 436         IFormSource        *m_form_src;
 437         TextDest           *m_text_dst;
 438         u32                 m_formspec_version = 0;
 439         std::string         m_focused_element = "";
 440         JoystickController *m_joystick;
 441
 442         typedef struct {
 443                 bool explicit_size;
 444                 v2f invsize;
 445                 v2s32 size;
 446                 v2f32 offset;
 447                 v2f32 anchor;
 448                 core::rect<s32> rect;
 449                 v2s32 basepos;
 450                 v2u32 screensize;
 451                 std::string focused_fieldname;
 452                 GUITable::TableOptions table_options;
 453                 GUITable::TableColumns table_columns;
 454                 // used to restore table selection/scroll/treeview state
 455                 std::unordered_map<std::string, GUITable::DynamicData> table_dyndata;
 456         } parserData;
 457
 458         typedef struct {
 459                 bool key_up;
 460                 bool key_down;
 461                 bool key_enter;
 462                 bool key_escape;
 463         } fs_key_pendig;
 464
 465         fs_key_pendig current_keys_pending;
 466         std::string current_field_enter_pending = "";
 467
 468         void parseElement(parserData* data, const std::string &element);
 469
 470         void parseSize(parserData* data, const std::string &element);
 471         void parseContainer(parserData* data, const std::string &element);
 472         void parseContainerEnd(parserData* data);
 473         void parseList(parserData* data, const std::string &element);
 474         void parseListRing(parserData* data, const std::string &element);
 475         void parseCheckbox(parserData* data, const std::string &element);
 476         void parseImage(parserData* data, const std::string &element);
 477         void parseItemImage(parserData* data, const std::string &element);
 478         void parseButton(parserData* data, const std::string &element,
 479                         const std::string &typ);
 480         void parseBackground(parserData* data, const std::string &element);
 481         void parseTableOptions(parserData* data, const std::string &element);
 482         void parseTableColumns(parserData* data, const std::string &element);
 483         void parseTable(parserData* data, const std::string &element);
 484         void parseTextList(parserData* data, const std::string &element);
 485         void parseDropDown(parserData* data, const std::string &element);
 486         void parseFieldCloseOnEnter(parserData *data, const std::string &element);
 487         void parsePwdField(parserData* data, const std::string &element);
 488         void parseField(parserData* data, const std::string &element, const std::string &type);
 489         void parseSimpleField(parserData* data,std::vector<std::string> &parts);
 490         void parseTextArea(parserData* data,std::vector<std::string>& parts,
 491                         const std::string &type);
 492         void parseLabel(parserData* data, const std::string &element);
 493         void parseVertLabel(parserData* data, const std::string &element);
 494         void parseImageButton(parserData* data, const std::string &element,
 495                         const std::string &type);
 496         void parseItemImageButton(parserData* data, const std::string &element);
 497         void parseTabHeader(parserData* data, const std::string &element);
 498         void parseBox(parserData* data, const std::string &element);
 499         void parseBackgroundColor(parserData* data, const std::string &element);
 500         void parseListColors(parserData* data, const std::string &element);
 501         void parseTooltip(parserData* data, const std::string &element);
 502         bool parseVersionDirect(const std::string &data);
 503         bool parseSizeDirect(parserData* data, const std::string &element);
 504         void parseScrollBar(parserData* data, const std::string &element);
 505         bool parsePositionDirect(parserData *data, const std::string &element);
 506         void parsePosition(parserData *data, const std::string &element);
 507         bool parseAnchorDirect(parserData *data, const std::string &element);
 508         void parseAnchor(parserData *data, const std::string &element);
 509
 510         void tryClose();
 511
 512         void showTooltip(const std::wstring &text, const irr::video::SColor &color,
 513                 const irr::video::SColor &bgcolor);
 514
 515         /**
 516          * check if event is part of a double click
 517          * @param event event to evaluate
 518          * @return true/false if a doubleclick was detected
 519          */
 520         bool DoubleClickDetection(const SEvent event);
 521
 522         struct clickpos
 523         {
 524                 v2s32 pos;
 525                 s64 time;
 526         };
 527         clickpos m_doubleclickdetect[2];
 528
 529         int m_btn_height;
 530         gui::IGUIFont *m_font = nullptr;
 531
 532         std::wstring getLabelByID(s32 id);
 533         std::string getNameByID(s32 id);
 534 #ifdef __ANDROID__
 535         v2s32 m_down_pos;
 536         std::string m_JavaDialogFieldName;
 537 #endif
 538
 539         /* If true, remap a double-click (or double-tap) action to ESC. This is so
 540          * that, for example, Android users can double-tap to close a formspec.
 541         *
 542          * This value can (currently) only be set by the class constructor
 543          * and the default value for the setting is true.
 544          */
 545         bool m_remap_dbl_click;
 546
 547 };
 548
 549 class FormspecFormSource: public IFormSource
 550 {
 551 public:
 552         FormspecFormSource(const std::string &formspec):
 553                 m_formspec(formspec)
 554         {
 555         }
 556
 557         ~FormspecFormSource()
 558         {
 559         }
 560
 561         void setForm(const std::string &formspec)
 562         {
 563                 m_formspec = FORMSPEC_VERSION_STRING + formspec;
 564         }
 565
 566         std::string getForm() { return m_formspec; }
 567
 568         std::string m_formspec;
 569 };
 570
 571 #endif