2010-12-22 02:34:21 +01:00
|
|
|
/*
|
2013-02-24 18:40:43 +01:00
|
|
|
Minetest
|
2013-02-24 19:38:45 +01:00
|
|
|
Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
|
2010-12-22 02:34:21 +01:00
|
|
|
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
2012-06-05 16:56:56 +02:00
|
|
|
it under the terms of the GNU Lesser General Public License as published by
|
|
|
|
the Free Software Foundation; either version 2.1 of the License, or
|
2010-12-22 02:34:21 +01:00
|
|
|
(at your option) any later version.
|
|
|
|
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
2012-06-05 16:56:56 +02:00
|
|
|
GNU Lesser General Public License for more details.
|
2010-12-22 02:34:21 +01:00
|
|
|
|
2012-06-05 16:56:56 +02:00
|
|
|
You should have received a copy of the GNU Lesser General Public License along
|
2010-12-22 02:34:21 +01:00
|
|
|
with this program; if not, write to the Free Software Foundation, Inc.,
|
|
|
|
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
|
|
|
*/
|
|
|
|
|
2017-08-17 22:19:39 +02:00
|
|
|
#pragma once
|
2010-12-22 02:34:21 +01:00
|
|
|
|
2013-06-23 18:30:21 +02:00
|
|
|
#include <utility>
|
2016-07-07 22:10:15 +02:00
|
|
|
#include <stack>
|
2019-03-16 22:38:36 +01:00
|
|
|
#include <unordered_set>
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2012-06-17 03:00:31 +02:00
|
|
|
#include "irrlichttypes_extrabloated.h"
|
2012-01-12 06:10:39 +01:00
|
|
|
#include "inventorymanager.h"
|
2010-12-23 14:31:50 +01:00
|
|
|
#include "modalMenu.h"
|
2020-02-01 13:55:13 +01:00
|
|
|
#include "guiInventoryList.h"
|
2020-07-12 09:48:50 +02:00
|
|
|
#include "guiScrollBar.h"
|
2013-08-23 12:24:11 +02:00
|
|
|
#include "guiTable.h"
|
2015-01-12 17:01:41 +01:00
|
|
|
#include "network/networkprotocol.h"
|
2016-05-27 08:35:07 +02:00
|
|
|
#include "client/joystick_controller.h"
|
2016-04-04 18:31:00 +02:00
|
|
|
#include "util/string.h"
|
2016-05-31 17:30:11 +02:00
|
|
|
#include "util/enriched_string.h"
|
2019-03-15 20:03:12 +01:00
|
|
|
#include "StyleSpec.h"
|
2010-12-22 02:34:21 +01:00
|
|
|
|
2011-12-06 14:21:56 +01:00
|
|
|
class InventoryManager;
|
2013-08-20 22:38:14 +02:00
|
|
|
class ISimpleTextureSource;
|
2014-09-21 02:23:55 +02:00
|
|
|
class Client;
|
2020-04-13 10:50:07 +02:00
|
|
|
class GUIScrollContainer;
|
2020-09-16 17:10:17 +02:00
|
|
|
class ISoundManager;
|
2011-11-13 23:19:48 +01:00
|
|
|
|
2020-11-26 22:19:46 +01:00
|
|
|
enum FormspecFieldType {
|
2013-06-23 18:30:21 +02:00
|
|
|
f_Button,
|
2013-08-23 12:24:11 +02:00
|
|
|
f_Table,
|
2013-06-23 18:30:21 +02:00
|
|
|
f_TabHeader,
|
|
|
|
f_CheckBox,
|
|
|
|
f_DropDown,
|
2014-06-19 18:17:35 +02:00
|
|
|
f_ScrollBar,
|
2019-11-07 20:11:01 +01:00
|
|
|
f_Box,
|
|
|
|
f_ItemImage,
|
2020-02-11 19:53:09 +01:00
|
|
|
f_HyperText,
|
2020-03-16 22:56:48 +01:00
|
|
|
f_AnimatedImage,
|
2013-06-23 18:30:21 +02:00
|
|
|
f_Unknown
|
2020-11-26 22:19:46 +01:00
|
|
|
};
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2020-11-26 22:19:46 +01:00
|
|
|
enum FormspecQuitMode {
|
2014-03-04 19:57:39 +01:00
|
|
|
quit_mode_no,
|
|
|
|
quit_mode_accept,
|
|
|
|
quit_mode_cancel
|
2020-11-26 22:19:46 +01:00
|
|
|
};
|
2014-03-04 19:57:39 +01:00
|
|
|
|
2012-07-15 18:19:38 +02:00
|
|
|
struct TextDest
|
|
|
|
{
|
2017-08-20 19:37:29 +02:00
|
|
|
virtual ~TextDest() = default;
|
|
|
|
|
2012-07-15 18:19:38 +02:00
|
|
|
// This is deprecated I guess? -celeron55
|
2017-04-22 00:51:13 +02:00
|
|
|
virtual void gotText(const std::wstring &text) {}
|
2015-05-19 08:24:14 +02:00
|
|
|
virtual void gotText(const StringMap &fields) = 0;
|
2014-03-04 19:57:39 +01:00
|
|
|
|
|
|
|
std::string m_formname;
|
2012-07-15 18:19:38 +02:00
|
|
|
};
|
|
|
|
|
2012-06-03 17:30:34 +02:00
|
|
|
class IFormSource
|
|
|
|
{
|
|
|
|
public:
|
2017-08-20 19:37:29 +02:00
|
|
|
virtual ~IFormSource() = default;
|
2017-08-29 19:25:16 +02:00
|
|
|
virtual const std::string &getForm() const = 0;
|
2012-07-15 18:19:38 +02:00
|
|
|
// Fill in variables in field text
|
2017-04-25 10:17:53 +02:00
|
|
|
virtual std::string resolveText(const std::string &str) { return str; }
|
2012-06-03 17:30:34 +02:00
|
|
|
};
|
|
|
|
|
2012-07-15 18:19:38 +02:00
|
|
|
class GUIFormSpecMenu : public GUIModalMenu
|
2010-12-22 02:34:21 +01:00
|
|
|
{
|
2015-06-16 10:48:54 +02:00
|
|
|
struct ListRingSpec
|
|
|
|
{
|
2017-08-20 19:37:29 +02:00
|
|
|
ListRingSpec() = default;
|
|
|
|
|
2015-06-16 10:48:54 +02:00
|
|
|
ListRingSpec(const InventoryLocation &a_inventoryloc,
|
|
|
|
const std::string &a_listname):
|
|
|
|
inventoryloc(a_inventoryloc),
|
|
|
|
listname(a_listname)
|
|
|
|
{
|
|
|
|
}
|
|
|
|
|
|
|
|
InventoryLocation inventoryloc;
|
|
|
|
std::string listname;
|
|
|
|
};
|
|
|
|
|
2012-07-15 18:19:38 +02:00
|
|
|
struct FieldSpec
|
|
|
|
{
|
2017-08-20 19:37:29 +02:00
|
|
|
FieldSpec() = default;
|
|
|
|
|
2015-06-10 01:54:33 +02:00
|
|
|
FieldSpec(const std::string &name, const std::wstring &label,
|
2020-01-11 20:17:11 +01:00
|
|
|
const std::wstring &default_text, s32 id, int priority = 0,
|
|
|
|
gui::ECURSOR_ICON cursor_icon = ECI_NORMAL) :
|
2012-07-15 18:19:38 +02:00
|
|
|
fname(name),
|
2016-08-07 17:22:50 +02:00
|
|
|
flabel(label),
|
2017-01-31 18:05:03 +01:00
|
|
|
fdefault(unescape_enriched(translate_string(default_text))),
|
2016-08-07 17:22:50 +02:00
|
|
|
fid(id),
|
|
|
|
send(false),
|
|
|
|
ftype(f_Unknown),
|
2019-11-20 19:39:10 +01:00
|
|
|
is_exit(false),
|
2020-01-11 20:17:11 +01:00
|
|
|
priority(priority),
|
|
|
|
fcursor_icon(cursor_icon)
|
2017-04-21 23:40:48 +02:00
|
|
|
{
|
|
|
|
}
|
2017-04-21 10:06:08 +02:00
|
|
|
|
2015-06-10 01:54:33 +02:00
|
|
|
std::string fname;
|
2012-07-15 18:19:38 +02:00
|
|
|
std::wstring flabel;
|
|
|
|
std::wstring fdefault;
|
2019-11-20 19:39:10 +01:00
|
|
|
s32 fid;
|
2012-07-15 18:19:38 +02:00
|
|
|
bool send;
|
2013-06-23 18:30:21 +02:00
|
|
|
FormspecFieldType ftype;
|
2012-07-22 16:28:09 +02:00
|
|
|
bool is_exit;
|
2019-11-20 19:39:10 +01:00
|
|
|
// Draw priority for formspec version < 3
|
|
|
|
int priority;
|
2012-12-01 18:36:42 +01:00
|
|
|
core::rect<s32> rect;
|
2020-01-11 20:17:11 +01:00
|
|
|
gui::ECURSOR_ICON fcursor_icon;
|
2020-09-16 17:10:17 +02:00
|
|
|
std::string sound;
|
2012-07-15 18:19:38 +02:00
|
|
|
};
|
2012-06-03 16:18:08 +02:00
|
|
|
|
2017-04-21 23:40:48 +02:00
|
|
|
struct TooltipSpec
|
|
|
|
{
|
2017-08-20 19:37:29 +02:00
|
|
|
TooltipSpec() = default;
|
2017-01-31 18:05:03 +01:00
|
|
|
TooltipSpec(const std::wstring &a_tooltip, irr::video::SColor a_bgcolor,
|
2014-06-24 12:28:24 +02:00
|
|
|
irr::video::SColor a_color):
|
2017-01-31 18:05:03 +01:00
|
|
|
tooltip(translate_string(a_tooltip)),
|
2014-06-24 12:28:24 +02:00
|
|
|
bgcolor(a_bgcolor),
|
|
|
|
color(a_color)
|
2017-04-21 23:40:48 +02:00
|
|
|
{
|
|
|
|
}
|
2017-04-21 10:06:08 +02:00
|
|
|
|
2016-04-04 18:31:00 +02:00
|
|
|
std::wstring tooltip;
|
2014-06-24 12:28:24 +02:00
|
|
|
irr::video::SColor bgcolor;
|
|
|
|
irr::video::SColor color;
|
|
|
|
};
|
|
|
|
|
2010-12-22 02:34:21 +01:00
|
|
|
public:
|
2017-06-26 20:11:17 +02:00
|
|
|
GUIFormSpecMenu(JoystickController *joystick,
|
2010-12-22 02:34:21 +01:00
|
|
|
gui::IGUIElement* parent, s32 id,
|
2011-04-04 14:13:19 +02:00
|
|
|
IMenuManager *menumgr,
|
2017-01-09 20:39:22 +01:00
|
|
|
Client *client,
|
2014-04-20 02:40:25 +02:00
|
|
|
ISimpleTextureSource *tsrc,
|
2020-09-16 17:10:17 +02:00
|
|
|
ISoundManager *sound_manager,
|
2014-04-20 02:40:25 +02:00
|
|
|
IFormSource* fs_src,
|
|
|
|
TextDest* txt_dst,
|
Optimize string (mis)handling (#8128)
* Optimize statbar drawing
The texture name of the statbar is a string passed by value.
That slows down the client and creates litter in the heap
as the content of the string is allocated there. Convert the
offending parameter to a const reference to avoid the
performance hit.
* Optimize texture cache
There is an unnecessary temporary created when the texture
path is being generated. This slows down the cache each time
a new texture is encountered and it needs to be loaded into
the cache. Additionally, the heap litter created by this
unnecessary temporary is particularly troublesome here as
the following code then piles another string (the resulting
full path of the texture) on top of it, followed by the
texture itself, which both are quite long term objects as
they are subsequently inserted into the cache where they can
remain for quite a while (especially if the texture turns
out to be a common one like dirt, grass or stone).
Use std::string.append to get rid of the temporary which
solves both issues (speed and heap fragmentation).
* Optimize animations in client
Each time an animated node is updated, an unnecessary copy of
the texture name is created, littering the heap with lots of
fragments. This can be specifically troublesome when looking
at oceans or large lava lakes as both of these nodes are
usually animated (the lava animation is pretty visible).
Convert the parameter of GenericCAO::updateTextures to a
const reference to get rid of the unnecessary copy.
There is a comment stating "std::string copy is mandatory as
mod can be a class member and there is a swap on those class
members ... do NOT pass by reference", reinforcing the
belief that the unnecessary copy is in fact necessary.
However one of the first things the code of the method does
is to assign the parameter to its class member, creating
another copy. By rearranging the code a little bit this
"another copy" can then be used by the subsequent code,
getting rid of the need to pass the parameter by value and
thus saving that copying effort.
* Optimize chat console history handling
The GUIChatConsole::replaceAndAddToHistory was getting the
line to work on by value which turns out to be unnecessary.
Get rid of that unnecessary copy by converting the parameter
to a const reference.
* Optimize gui texture setting
The code used to set the texture for GUI components was
getting the name of the texture by value, creating
unnecessary performance bottleneck for mods/games with
heavily textured GUIs. Get rid of the bottleneck by passing
the texture name as a const reference.
* Optimize sound playing code in GUIEngine
The GUIEngine's code receives the specification of the sound
to be played by value, which turns out to be most likely a
mistake as the underlying sound manager interface receives
the same thing by reference. Convert the offending parameter
to a const reference to get rid of the rather bulky copying
effort and the associated performance hit.
* Silence CLANG TIDY warnings for unit tests
Change "std::string" to "const std::string &" to avoid an
unnecessary local value copy, silencing the CLANG TIDY
process.
* Optimize formspec handling
The "formspec prepend" parameter was passed to the formspec
handling code by value, creating unnecessary copy of
std::string and slowing down the game if mods add things like
textured backgrounds for the player inventory and/or other
forms. Get rid of that performance bottleneck by converting
the parameter to a const reference.
* Optimize hotbar image handling
The code that sets the background images for the hotbar is
getting the name of the image by value, creating an
unnecessary std::string copying effort. Fix that by
converting the relevant parameters to const references.
* Optimize inventory deserialization
The inventory manager deserialization code gets the
serialized version of the inventory by value, slowing the
server and the client down when there are inventory updates.
This can get particularly troublesome with pipeworks which
adds nodes that can mess around with inventories
automatically or with mods that have mobs with inventories
that actively use them.
* Optimize texture scaling cache
There is an io::path parameter passed by value in the
procedure used to add images converted from textures,
leading to slowdown when the image is not yet created and
the conversion is thus needed. The performance hit is
quite significant as io::path is similar to std::string
so convert the parameter to a const reference to get rid of
it.
* Optimize translation file loader
Use "std::string::append" when calculating the final index
for the translation table to avoid unnecessary temporary
strings. This speeds the translation file loader up
significantly as std::string uses heap allocation which
tends to be rather slow. Additionally, the heap is no
longer being littered by these unnecessary string
temporaries, increasing performance of code that gets
executed after the translation file loader finishes.
* Optimize server map saving
When the directory structure for the world data is created
during server map saving, an unnecessary value passing of
the directory name slows things down. Remove that overhead
by converting the offending parameter to a const reference.
2019-05-18 17:19:13 +02:00
|
|
|
const std::string &formspecPrepend,
|
2015-03-14 10:55:35 +01:00
|
|
|
bool remap_dbl_click = true);
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2012-07-15 18:19:38 +02:00
|
|
|
~GUIFormSpecMenu();
|
2010-12-22 02:34:21 +01:00
|
|
|
|
2018-01-13 10:54:18 +01:00
|
|
|
static void create(GUIFormSpecMenu *&cur_formspec, Client *client,
|
2018-03-28 17:04:41 +02:00
|
|
|
JoystickController *joystick, IFormSource *fs_src, TextDest *txt_dest,
|
2020-09-16 17:10:17 +02:00
|
|
|
const std::string &formspecPrepend, ISoundManager *sound_manager);
|
2018-01-13 10:34:56 +01:00
|
|
|
|
2012-06-03 15:03:19 +02:00
|
|
|
void setFormSpec(const std::string &formspec_string,
|
2017-04-21 23:40:48 +02:00
|
|
|
const InventoryLocation ¤t_inventory_location)
|
2011-04-04 23:24:47 +02:00
|
|
|
{
|
2012-06-03 15:03:19 +02:00
|
|
|
m_formspec_string = formspec_string;
|
|
|
|
m_current_inventory_location = current_inventory_location;
|
2020-07-12 09:47:05 +02:00
|
|
|
m_is_form_regenerated = false;
|
2012-06-03 15:03:19 +02:00
|
|
|
regenerateGui(m_screensize_old);
|
2011-04-04 23:24:47 +02:00
|
|
|
}
|
2014-05-30 03:07:48 +02:00
|
|
|
|
2019-06-10 13:01:07 +02:00
|
|
|
const InventoryLocation &getFormspecLocation()
|
|
|
|
{
|
|
|
|
return m_current_inventory_location;
|
|
|
|
}
|
|
|
|
|
2018-03-28 17:04:41 +02:00
|
|
|
void setFormspecPrepend(const std::string &formspecPrepend)
|
|
|
|
{
|
|
|
|
m_formspec_prepend = formspecPrepend;
|
|
|
|
}
|
|
|
|
|
2012-07-15 18:19:38 +02:00
|
|
|
// form_src is deleted by this GUIFormSpecMenu
|
2012-06-03 17:30:34 +02:00
|
|
|
void setFormSource(IFormSource *form_src)
|
|
|
|
{
|
2017-06-05 01:52:55 +02:00
|
|
|
delete m_form_src;
|
2012-06-03 17:30:34 +02:00
|
|
|
m_form_src = form_src;
|
|
|
|
}
|
2011-04-04 23:24:47 +02:00
|
|
|
|
2012-07-15 18:19:38 +02:00
|
|
|
// text_dst is deleted by this GUIFormSpecMenu
|
|
|
|
void setTextDest(TextDest *text_dst)
|
|
|
|
{
|
2017-06-05 01:52:55 +02:00
|
|
|
delete m_text_dst;
|
2012-07-15 18:19:38 +02:00
|
|
|
m_text_dst = text_dst;
|
|
|
|
}
|
|
|
|
|
2013-06-23 18:30:21 +02:00
|
|
|
void allowClose(bool value)
|
|
|
|
{
|
|
|
|
m_allowclose = value;
|
|
|
|
}
|
|
|
|
|
2015-01-27 01:17:04 +01:00
|
|
|
void lockSize(bool lock,v2u32 basescreensize=v2u32(0,0))
|
|
|
|
{
|
2013-06-23 18:30:21 +02:00
|
|
|
m_lock = lock;
|
|
|
|
m_lockscreensize = basescreensize;
|
|
|
|
}
|
|
|
|
|
2010-12-25 15:04:51 +01:00
|
|
|
void removeChildren();
|
2013-08-19 11:26:51 +02:00
|
|
|
void setInitialFocus();
|
2015-01-27 01:17:04 +01:00
|
|
|
|
2017-03-19 13:18:52 +01:00
|
|
|
void setFocus(const std::string &elementname)
|
2015-01-27 01:17:04 +01:00
|
|
|
{
|
|
|
|
m_focused_element = elementname;
|
|
|
|
}
|
|
|
|
|
2020-02-01 13:55:13 +01:00
|
|
|
Client *getClient() const
|
|
|
|
{
|
|
|
|
return m_client;
|
|
|
|
}
|
|
|
|
|
|
|
|
const GUIInventoryList::ItemSpec *getSelectedItem() const
|
|
|
|
{
|
|
|
|
return m_selected_item;
|
|
|
|
}
|
|
|
|
|
|
|
|
const u16 getSelectedAmount() const
|
|
|
|
{
|
|
|
|
return m_selected_amount;
|
|
|
|
}
|
|
|
|
|
|
|
|
bool doTooltipAppendItemname() const
|
|
|
|
{
|
|
|
|
return m_tooltip_append_itemname;
|
|
|
|
}
|
|
|
|
|
|
|
|
void addHoveredItemTooltip(const std::string &name)
|
|
|
|
{
|
|
|
|
m_hovered_item_tooltips.emplace_back(name);
|
|
|
|
}
|
|
|
|
|
2010-12-22 02:34:21 +01:00
|
|
|
/*
|
|
|
|
Remove and re-add (or reposition) stuff
|
|
|
|
*/
|
2010-12-23 14:31:50 +01:00
|
|
|
void regenerateGui(v2u32 screensize);
|
2014-05-30 03:07:48 +02:00
|
|
|
|
2020-02-01 13:55:13 +01:00
|
|
|
GUIInventoryList::ItemSpec getItemAtPos(v2s32 p) const;
|
2012-01-21 21:21:41 +01:00
|
|
|
void drawSelectedItem();
|
2010-12-23 14:31:50 +01:00
|
|
|
void drawMenu();
|
2012-01-21 21:21:41 +01:00
|
|
|
void updateSelectedItem();
|
2013-06-18 01:32:11 +02:00
|
|
|
ItemStack verifySelectedItem();
|
2010-12-22 02:34:21 +01:00
|
|
|
|
2014-03-04 19:57:39 +01:00
|
|
|
void acceptInput(FormspecQuitMode quitmode);
|
2013-08-19 11:26:51 +02:00
|
|
|
bool preprocessEvent(const SEvent& event);
|
2010-12-22 02:34:21 +01:00
|
|
|
bool OnEvent(const SEvent& event);
|
2014-03-13 14:06:18 +01:00
|
|
|
bool doPause;
|
|
|
|
bool pausesGame() { return doPause; }
|
2013-08-15 21:46:55 +02:00
|
|
|
|
2015-06-10 01:54:33 +02:00
|
|
|
GUITable* getTable(const std::string &tablename);
|
2016-05-05 18:50:02 +02:00
|
|
|
std::vector<std::string>* getDropDownValues(const std::string &name);
|
2013-08-23 12:24:11 +02:00
|
|
|
|
2014-04-21 14:10:59 +02:00
|
|
|
#ifdef __ANDROID__
|
|
|
|
bool getAndroidUIInput();
|
|
|
|
#endif
|
|
|
|
|
2011-04-04 23:24:47 +02:00
|
|
|
protected:
|
2010-12-22 15:30:23 +01:00
|
|
|
v2s32 getBasePos() const
|
|
|
|
{
|
2013-06-23 18:30:21 +02:00
|
|
|
return padding + offset + AbsoluteRect.UpperLeftCorner;
|
2010-12-22 15:30:23 +01:00
|
|
|
}
|
2018-06-24 21:50:57 +02:00
|
|
|
std::wstring getLabelByID(s32 id);
|
|
|
|
std::string getNameByID(s32 id);
|
2019-11-20 19:39:10 +01:00
|
|
|
const FieldSpec *getSpecByID(s32 id);
|
2019-11-07 20:11:01 +01:00
|
|
|
v2s32 getElementBasePos(const std::vector<std::string> *v_pos);
|
|
|
|
v2s32 getRealCoordinateBasePos(const std::vector<std::string> &v_pos);
|
2019-06-27 14:40:49 +02:00
|
|
|
v2s32 getRealCoordinateGeometry(const std::vector<std::string> &v_geom);
|
2010-12-22 15:30:23 +01:00
|
|
|
|
2020-04-11 22:39:30 +02:00
|
|
|
std::unordered_map<std::string, std::vector<StyleSpec>> theme_by_type;
|
|
|
|
std::unordered_map<std::string, std::vector<StyleSpec>> theme_by_name;
|
2019-03-16 22:38:36 +01:00
|
|
|
std::unordered_set<std::string> property_warned;
|
2019-03-15 20:03:12 +01:00
|
|
|
|
2020-04-11 22:39:30 +02:00
|
|
|
StyleSpec getDefaultStyleForElement(const std::string &type,
|
|
|
|
const std::string &name="", const std::string &parent_type="");
|
|
|
|
std::array<StyleSpec, StyleSpec::NUM_STATES> getStyleForElement(const std::string &type,
|
2019-03-16 22:38:36 +01:00
|
|
|
const std::string &name="", const std::string &parent_type="");
|
2019-03-15 20:03:12 +01:00
|
|
|
|
2010-12-22 15:30:23 +01:00
|
|
|
v2s32 padding;
|
2018-08-04 18:55:54 +02:00
|
|
|
v2f32 spacing;
|
2010-12-22 15:30:23 +01:00
|
|
|
v2s32 imgsize;
|
2013-06-23 18:30:21 +02:00
|
|
|
v2s32 offset;
|
2018-08-04 18:55:54 +02:00
|
|
|
v2f32 pos_offset;
|
|
|
|
std::stack<v2f32> container_stack;
|
2014-05-30 03:07:48 +02:00
|
|
|
|
2011-04-04 14:13:19 +02:00
|
|
|
InventoryManager *m_invmgr;
|
2013-08-20 22:38:14 +02:00
|
|
|
ISimpleTextureSource *m_tsrc;
|
2020-09-16 17:10:17 +02:00
|
|
|
ISoundManager *m_sound_manager;
|
2014-09-21 02:23:55 +02:00
|
|
|
Client *m_client;
|
2010-12-22 15:30:23 +01:00
|
|
|
|
2012-06-03 15:03:19 +02:00
|
|
|
std::string m_formspec_string;
|
2018-03-28 17:04:41 +02:00
|
|
|
std::string m_formspec_prepend;
|
2012-06-03 15:03:19 +02:00
|
|
|
InventoryLocation m_current_inventory_location;
|
2012-06-03 16:18:08 +02:00
|
|
|
|
2020-07-12 09:47:05 +02:00
|
|
|
// Default true because we can't control regeneration on resizing, but
|
|
|
|
// we can control cases when the formspec is shown intentionally.
|
|
|
|
bool m_is_form_regenerated = true;
|
|
|
|
|
2020-02-01 13:55:13 +01:00
|
|
|
std::vector<GUIInventoryList *> m_inventorylists;
|
2015-06-16 10:48:54 +02:00
|
|
|
std::vector<ListRingSpec> m_inventory_rings;
|
2019-11-07 20:11:01 +01:00
|
|
|
std::vector<gui::IGUIElement *> m_backgrounds;
|
2017-06-04 21:00:04 +02:00
|
|
|
std::unordered_map<std::string, bool> field_close_on_enter;
|
2020-07-10 12:11:26 +02:00
|
|
|
std::unordered_map<std::string, bool> m_dropdown_index_event;
|
2012-12-20 18:19:49 +01:00
|
|
|
std::vector<FieldSpec> m_fields;
|
2019-11-07 20:11:01 +01:00
|
|
|
std::vector<std::pair<FieldSpec, GUITable *>> m_tables;
|
|
|
|
std::vector<std::pair<FieldSpec, gui::IGUICheckBox *>> m_checkboxes;
|
2015-06-10 01:54:33 +02:00
|
|
|
std::map<std::string, TooltipSpec> m_tooltips;
|
2019-11-07 20:11:01 +01:00
|
|
|
std::vector<std::pair<gui::IGUIElement *, TooltipSpec>> m_tooltip_rects;
|
|
|
|
std::vector<std::pair<FieldSpec, GUIScrollBar *>> m_scrollbars;
|
|
|
|
std::vector<std::pair<FieldSpec, std::vector<std::string>>> m_dropdowns;
|
2020-03-31 19:34:42 +02:00
|
|
|
std::vector<gui::IGUIElement *> m_clickthrough_elements;
|
2020-04-13 10:50:07 +02:00
|
|
|
std::vector<std::pair<std::string, GUIScrollContainer *>> m_scroll_containers;
|
2014-06-19 18:17:35 +02:00
|
|
|
|
2020-02-01 13:55:13 +01:00
|
|
|
GUIInventoryList::ItemSpec *m_selected_item = nullptr;
|
2018-04-03 11:15:58 +02:00
|
|
|
u16 m_selected_amount = 0;
|
2017-06-16 11:25:52 +02:00
|
|
|
bool m_selected_dragging = false;
|
2018-04-03 11:15:58 +02:00
|
|
|
ItemStack m_selected_swap;
|
2012-01-21 21:21:41 +01:00
|
|
|
|
2017-06-16 11:25:52 +02:00
|
|
|
gui::IGUIStaticText *m_tooltip_element = nullptr;
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2017-05-26 14:03:36 +02:00
|
|
|
u64 m_tooltip_show_delay;
|
2017-09-16 18:42:17 +02:00
|
|
|
bool m_tooltip_append_itemname;
|
2017-06-16 11:25:52 +02:00
|
|
|
u64 m_hovered_time = 0;
|
|
|
|
s32 m_old_tooltip_id = -1;
|
2014-06-24 12:28:24 +02:00
|
|
|
|
2017-10-17 21:50:58 +02:00
|
|
|
bool m_auto_place = false;
|
2014-10-09 09:53:20 +02:00
|
|
|
|
2017-06-16 11:25:52 +02:00
|
|
|
bool m_allowclose = true;
|
|
|
|
bool m_lock = false;
|
2013-06-23 18:30:21 +02:00
|
|
|
v2u32 m_lockscreensize;
|
2013-11-02 04:26:44 +01:00
|
|
|
|
2019-12-08 18:59:30 +01:00
|
|
|
bool m_bgnonfullscreen;
|
2013-11-02 04:26:44 +01:00
|
|
|
bool m_bgfullscreen;
|
|
|
|
video::SColor m_bgcolor;
|
2017-08-29 19:25:16 +02:00
|
|
|
video::SColor m_fullscreen_bgcolor;
|
2014-06-24 12:28:24 +02:00
|
|
|
video::SColor m_default_tooltip_bgcolor;
|
|
|
|
video::SColor m_default_tooltip_color;
|
|
|
|
|
2013-06-23 18:30:21 +02:00
|
|
|
private:
|
2016-05-27 08:35:07 +02:00
|
|
|
IFormSource *m_form_src;
|
|
|
|
TextDest *m_text_dst;
|
2020-07-12 09:47:05 +02:00
|
|
|
std::string m_last_formname;
|
2019-09-10 21:18:42 +02:00
|
|
|
u16 m_formspec_version = 1;
|
2017-06-16 11:25:52 +02:00
|
|
|
std::string m_focused_element = "";
|
2016-05-27 08:35:07 +02:00
|
|
|
JoystickController *m_joystick;
|
2020-04-12 12:02:32 +02:00
|
|
|
bool m_show_debug = false;
|
2014-04-20 02:40:25 +02:00
|
|
|
|
2020-11-26 22:19:46 +01:00
|
|
|
struct parserData {
|
Scale form elements consistently
The ratios between the sizes of form elements, including text, is now
fixed, aside from variations caused by rounding. This makes form layout
almost fully predictable, and particularly independent of player's
screen size. The proportions of non-text elements are the traditional
proportions.
For compatibility, the way in which element positions and sizes are
specified remains unchanged, in all its baroqueness, with one exception.
The exception is that the position of a label[] element is now defined
in terms of the vertically center of the first line of the label,
rather than the bottom of the first line of the label. This change
allows a label to be precisely aligned with button text or an edit box,
which are positioned in a centering manner. Label positioning remains
consistent with the previous system, just more precisely defined.
Make multi-line label[] elements work properly. Previously the code set
a bounding rectangle assuming that there would be only a single line,
and as a result a multi-line label would be cut somewhere in the middle
of the second line. Now multi-line labels not only work, but have
guaranteed line spacing relative to inventory slots, to aid alignment.
Incidentally fix tabheader[] elements which were being constrained to
the wrong width.
Given an unusually large form, in variable-size mode, the form rendering
system now chooses a scale that will fit the entire form on the screen,
if that doesn't make elements too small. Fixed-size forms, including the
main menu, are have their sizes fixed in inch terms. The fixed size for
fixed-size forms and the preferred and minimum sizes for variable-size
forms all scale according to the gui_scaling parameter.
2014-08-21 00:42:27 +02:00
|
|
|
bool explicit_size;
|
2019-06-27 14:40:49 +02:00
|
|
|
bool real_coordinates;
|
2019-11-07 20:11:01 +01:00
|
|
|
u8 simple_field_count;
|
Scale form elements consistently
The ratios between the sizes of form elements, including text, is now
fixed, aside from variations caused by rounding. This makes form layout
almost fully predictable, and particularly independent of player's
screen size. The proportions of non-text elements are the traditional
proportions.
For compatibility, the way in which element positions and sizes are
specified remains unchanged, in all its baroqueness, with one exception.
The exception is that the position of a label[] element is now defined
in terms of the vertically center of the first line of the label,
rather than the bottom of the first line of the label. This change
allows a label to be precisely aligned with button text or an edit box,
which are positioned in a centering manner. Label positioning remains
consistent with the previous system, just more precisely defined.
Make multi-line label[] elements work properly. Previously the code set
a bounding rectangle assuming that there would be only a single line,
and as a result a multi-line label would be cut somewhere in the middle
of the second line. Now multi-line labels not only work, but have
guaranteed line spacing relative to inventory slots, to aid alignment.
Incidentally fix tabheader[] elements which were being constrained to
the wrong width.
Given an unusually large form, in variable-size mode, the form rendering
system now chooses a scale that will fit the entire form on the screen,
if that doesn't make elements too small. Fixed-size forms, including the
main menu, are have their sizes fixed in inch terms. The fixed size for
fixed-size forms and the preferred and minimum sizes for variable-size
forms all scale according to the gui_scaling parameter.
2014-08-21 00:42:27 +02:00
|
|
|
v2f invsize;
|
2013-06-23 18:30:21 +02:00
|
|
|
v2s32 size;
|
2017-03-04 10:46:55 +01:00
|
|
|
v2f32 offset;
|
|
|
|
v2f32 anchor;
|
2013-06-23 18:30:21 +02:00
|
|
|
core::rect<s32> rect;
|
|
|
|
v2s32 basepos;
|
|
|
|
v2u32 screensize;
|
2013-08-23 12:24:11 +02:00
|
|
|
GUITable::TableOptions table_options;
|
|
|
|
GUITable::TableColumns table_columns;
|
2020-04-13 10:50:07 +02:00
|
|
|
gui::IGUIElement *current_parent = nullptr;
|
2019-12-06 21:51:10 +01:00
|
|
|
|
2020-02-01 13:55:13 +01:00
|
|
|
GUIInventoryList::Options inventorylist_options;
|
|
|
|
|
2019-12-06 21:51:10 +01:00
|
|
|
struct {
|
|
|
|
s32 max = 1000;
|
|
|
|
s32 min = 0;
|
|
|
|
s32 small_step = 10;
|
|
|
|
s32 large_step = 100;
|
|
|
|
s32 thumb_size = 1;
|
|
|
|
GUIScrollBar::ArrowVisibility arrow_visiblity = GUIScrollBar::DEFAULT;
|
|
|
|
} scrollbar_options;
|
|
|
|
|
2013-08-23 12:24:11 +02:00
|
|
|
// used to restore table selection/scroll/treeview state
|
2017-06-04 21:00:04 +02:00
|
|
|
std::unordered_map<std::string, GUITable::DynamicData> table_dyndata;
|
2020-11-26 22:19:46 +01:00
|
|
|
};
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2020-11-26 22:19:46 +01:00
|
|
|
struct fs_key_pending {
|
2013-07-07 21:53:40 +02:00
|
|
|
bool key_up;
|
|
|
|
bool key_down;
|
|
|
|
bool key_enter;
|
|
|
|
bool key_escape;
|
2020-11-26 22:19:46 +01:00
|
|
|
};
|
2013-07-07 21:53:40 +02:00
|
|
|
|
2020-11-26 22:19:46 +01:00
|
|
|
fs_key_pending current_keys_pending;
|
2017-06-16 11:25:52 +02:00
|
|
|
std::string current_field_enter_pending = "";
|
2020-02-01 13:55:13 +01:00
|
|
|
std::vector<std::string> m_hovered_item_tooltips;
|
2013-07-07 21:53:40 +02:00
|
|
|
|
2017-04-21 23:40:48 +02:00
|
|
|
void parseElement(parserData* data, const std::string &element);
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2017-04-20 00:12:52 +02:00
|
|
|
void parseSize(parserData* data, const std::string &element);
|
|
|
|
void parseContainer(parserData* data, const std::string &element);
|
2016-07-07 22:10:15 +02:00
|
|
|
void parseContainerEnd(parserData* data);
|
2020-04-13 10:50:07 +02:00
|
|
|
void parseScrollContainer(parserData *data, const std::string &element);
|
|
|
|
void parseScrollContainerEnd(parserData *data);
|
2017-04-20 00:12:52 +02:00
|
|
|
void parseList(parserData* data, const std::string &element);
|
|
|
|
void parseListRing(parserData* data, const std::string &element);
|
|
|
|
void parseCheckbox(parserData* data, const std::string &element);
|
|
|
|
void parseImage(parserData* data, const std::string &element);
|
2020-02-15 16:33:18 +01:00
|
|
|
void parseAnimatedImage(parserData *data, const std::string &element);
|
2017-04-20 00:12:52 +02:00
|
|
|
void parseItemImage(parserData* data, const std::string &element);
|
|
|
|
void parseButton(parserData* data, const std::string &element,
|
|
|
|
const std::string &typ);
|
|
|
|
void parseBackground(parserData* data, const std::string &element);
|
|
|
|
void parseTableOptions(parserData* data, const std::string &element);
|
|
|
|
void parseTableColumns(parserData* data, const std::string &element);
|
|
|
|
void parseTable(parserData* data, const std::string &element);
|
|
|
|
void parseTextList(parserData* data, const std::string &element);
|
|
|
|
void parseDropDown(parserData* data, const std::string &element);
|
2016-10-03 01:30:33 +02:00
|
|
|
void parseFieldCloseOnEnter(parserData *data, const std::string &element);
|
2017-04-20 00:12:52 +02:00
|
|
|
void parsePwdField(parserData* data, const std::string &element);
|
|
|
|
void parseField(parserData* data, const std::string &element, const std::string &type);
|
2018-03-10 00:24:57 +01:00
|
|
|
void createTextField(parserData *data, FieldSpec &spec,
|
|
|
|
core::rect<s32> &rect, bool is_multiline);
|
2013-06-23 18:30:21 +02:00
|
|
|
void parseSimpleField(parserData* data,std::vector<std::string> &parts);
|
2014-03-04 19:57:39 +01:00
|
|
|
void parseTextArea(parserData* data,std::vector<std::string>& parts,
|
2017-04-20 00:12:52 +02:00
|
|
|
const std::string &type);
|
2019-09-10 15:11:26 +02:00
|
|
|
void parseHyperText(parserData *data, const std::string &element);
|
2017-04-20 00:12:52 +02:00
|
|
|
void parseLabel(parserData* data, const std::string &element);
|
|
|
|
void parseVertLabel(parserData* data, const std::string &element);
|
|
|
|
void parseImageButton(parserData* data, const std::string &element,
|
|
|
|
const std::string &type);
|
|
|
|
void parseItemImageButton(parserData* data, const std::string &element);
|
|
|
|
void parseTabHeader(parserData* data, const std::string &element);
|
|
|
|
void parseBox(parserData* data, const std::string &element);
|
|
|
|
void parseBackgroundColor(parserData* data, const std::string &element);
|
|
|
|
void parseListColors(parserData* data, const std::string &element);
|
|
|
|
void parseTooltip(parserData* data, const std::string &element);
|
|
|
|
bool parseVersionDirect(const std::string &data);
|
|
|
|
bool parseSizeDirect(parserData* data, const std::string &element);
|
|
|
|
void parseScrollBar(parserData* data, const std::string &element);
|
2019-12-06 21:51:10 +01:00
|
|
|
void parseScrollBarOptions(parserData *data, const std::string &element);
|
2017-03-04 10:46:55 +01:00
|
|
|
bool parsePositionDirect(parserData *data, const std::string &element);
|
|
|
|
void parsePosition(parserData *data, const std::string &element);
|
|
|
|
bool parseAnchorDirect(parserData *data, const std::string &element);
|
|
|
|
void parseAnchor(parserData *data, const std::string &element);
|
2019-03-15 20:03:12 +01:00
|
|
|
bool parseStyle(parserData *data, const std::string &element, bool style_type);
|
2020-07-12 09:47:05 +02:00
|
|
|
void parseSetFocus(const std::string &element);
|
2020-11-04 21:46:18 +01:00
|
|
|
void parseModel(parserData *data, const std::string &element);
|
2014-05-30 03:07:48 +02:00
|
|
|
|
2016-05-27 08:35:07 +02:00
|
|
|
void tryClose();
|
|
|
|
|
2017-06-03 08:55:26 +02:00
|
|
|
void showTooltip(const std::wstring &text, const irr::video::SColor &color,
|
|
|
|
const irr::video::SColor &bgcolor);
|
|
|
|
|
2019-11-07 20:11:01 +01:00
|
|
|
/**
|
|
|
|
* In formspec version < 2 the elements were not ordered properly. Some element
|
|
|
|
* types were drawn before others.
|
|
|
|
* This function sorts the elements in the old order for backwards compatibility.
|
|
|
|
*/
|
|
|
|
void legacySortElements(core::list<IGUIElement *>::Iterator from);
|
|
|
|
|
2014-06-14 11:22:09 +02:00
|
|
|
int m_btn_height;
|
2017-06-16 11:25:52 +02:00
|
|
|
gui::IGUIFont *m_font = nullptr;
|
2013-06-23 18:30:21 +02:00
|
|
|
};
|
|
|
|
|
|
|
|
class FormspecFormSource: public IFormSource
|
|
|
|
{
|
|
|
|
public:
|
2017-04-21 10:06:08 +02:00
|
|
|
FormspecFormSource(const std::string &formspec):
|
|
|
|
m_formspec(formspec)
|
2017-04-21 23:40:48 +02:00
|
|
|
{
|
|
|
|
}
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2017-08-20 19:37:29 +02:00
|
|
|
~FormspecFormSource() = default;
|
2013-06-23 18:30:21 +02:00
|
|
|
|
2017-04-21 10:06:08 +02:00
|
|
|
void setForm(const std::string &formspec)
|
|
|
|
{
|
2019-09-10 21:18:42 +02:00
|
|
|
m_formspec = formspec;
|
2013-06-23 18:30:21 +02:00
|
|
|
}
|
|
|
|
|
2017-08-29 19:25:16 +02:00
|
|
|
const std::string &getForm() const
|
|
|
|
{
|
|
|
|
return m_formspec;
|
|
|
|
}
|
2013-06-23 18:30:21 +02:00
|
|
|
|
|
|
|
std::string m_formspec;
|
2010-12-22 02:34:21 +01:00
|
|
|
};
|