43#include "table/strings.h"
87Point _cursorpos_drag_start;
89int _scrollbar_start_pos;
91uint8_t _scroller_click_timeout = 0;
110 const std::span<const NWidgetPart> nwid_parts,
HotkeyList *hotkeys,
111 const std::source_location location) :
112 source_location(location),
113 default_pos(def_pos),
115 parent_cls(parent_class),
118 nwid_parts(nwid_parts),
120 default_width_trad(def_width_trad),
121 default_height_trad(def_height_trad)
127WindowDesc::~WindowDesc()
160 if (wd->ini_key.empty())
continue;
184 if (wd->ini_key.empty())
continue;
214 const NWidgetBase *wid = this->GetWidget<NWidgetBase>(widget);
215 if (line_height < 0) line_height = wid->
resize_y;
216 if (clickpos < wid->pos_y + padding)
return INT_MAX;
217 return (clickpos - wid->
pos_y - padding) / line_height;
227 if (nwid->IsHighlighted()) {
228 nwid->SetHighlighted(TC_INVALID);
243 NWidgetBase *nwid = this->GetWidget<NWidgetBase>(widget_index);
244 if (nwid ==
nullptr)
return;
246 nwid->SetHighlighted(highlighted_colour);
249 if (highlighted_colour != TC_INVALID) {
257 if (!nwid->IsHighlighted())
continue;
273 const NWidgetBase *nwid = this->GetWidget<NWidgetBase>(widget_index);
274 if (nwid ==
nullptr)
return false;
276 return nwid->IsHighlighted();
288 if (widget < 0)
return;
299 NWidgetCore *nwi2 = this->GetWidget<NWidgetCore>(widget);
315 return this->GetWidget<NWidgetScrollbar>(widnum);
325 return this->GetWidget<NWidgetScrollbar>(widnum);
336 return query != this->
querystrings.end() ? query->second :
nullptr;
347 return query != this->
querystrings.end() ? query->second :
nullptr;
399 Rect r = {0, 0, 0, 0};
423 if (_focused_window == w)
return;
429 if (_focused_window !=
nullptr) {
434 Window *old_focused = _focused_window;
438 if (old_focused !=
nullptr) old_focused->
OnFocusLost(
false);
439 if (_focused_window !=
nullptr) _focused_window->
OnFocus();
449 if (_focused_window ==
nullptr)
return false;
487 NWidgetCore *widget = this->GetWidget<NWidgetCore>(widget_index);
488 assert(widget !=
nullptr);
506 if (stringid == STR_NULL)
return {};
535 if (wid !=
nullptr && ((type & ~WWB_PUSHBUTTON) <
WWT_LAST || type == NWID_PUSHBUTTON_DROPDOWN) &&
545 if (wid !=
nullptr) {
562 it->second->SetDirty(
this);
574 NWidgetCore *nw = this->GetWidget<NWidgetCore>(hotkey);
621 bool focused_widget_changed =
false;
624 if (_focused_window != w) {
627 focused_widget_changed =
true;
636 if (nw ==
nullptr)
return;
641 WidgetID widget_index = nw->GetIndex();
666 switch (widget_type) {
674 if (query !=
nullptr) query->ClickEditBox(w, pt, widget_index, click_count, focused_widget_changed);
695 if (click_count > 1) {
741 if (widget_index < 0)
return;
749 w->
OnClick(pt, widget_index, click_count);
761 if (wid ==
nullptr)
return;
766 if (wid->GetIndex() >= 0) {
792 if (wid ==
nullptr)
return;
803 if (wid->GetIndex() < 0)
return;
805 w->
OnHover(pt, wid->GetIndex());
817 if (nwid ==
nullptr)
return;
884 for (; !it.IsEnd(); ++it) {
889 left < v->left + v->
width &&
890 top < v->top + v->
height) {
894 if (left < (x = v->
left)) {
906 if (top < (x = v->
top)) {
924 dp->width = right - left;
925 dp->height = bottom - top;
926 dp->left = left - w->
left;
927 dp->top = top - w->
top;
928 dp->pitch = _screen.pitch;
951 left < w->left + w->width &&
952 top < w->top + w->height) {
954 DrawOverlappedWindow(w, std::max(left, w->left), std::max(top, w->top), std::min(right, w->left + w->width), std::min(bottom, w->top + w->height));
994 window_width = std::max(window_width + rx, this->
width);
995 window_height = std::max(window_height + ry, this->
height);
1047 if ((wc ==
WC_INVALID || wc == v->window_class) && v->parent ==
this)
return v;
1062 if (wc == v->window_class && number == v->window_number && v->parent ==
this)
return v;
1075 while (child !=
nullptr) {
1090 while (child !=
nullptr) {
1102 if (*this->z_position ==
nullptr)
return;
1104 *this->z_position =
nullptr;
1121 if (_focused_window ==
this) {
1123 _focused_window =
nullptr;
1139 assert(*this->z_position ==
nullptr);
1151 if (w->window_class == cls && w->window_number == number)
return w;
1166 if (w->window_class == cls)
return w;
1180 assert(w !=
nullptr);
1206 if (w->window_class == cls) {
1222 if (w->owner ==
id) {
1241 if (w->owner != old_owner)
continue;
1243 switch (w->window_class) {
1258 w->owner = new_owner;
1288static inline bool IsVitalWindow(
const Window *w)
1314 uint z_priority = 0;
1397 WindowList::iterator dest =
_z_windows.begin();
1400 if (dest != w->z_position) {
1456 this->
width = sm_width;
1457 this->
height = sm_height;
1474 def_width = std::max(def_width, this->
width);
1475 def_height = std::max(def_height, this->
height);
1481 if (this->
width != def_width || this->
height != def_height) {
1483 int free_height = _screen.height;
1485 if (wt !=
nullptr) free_height -= wt->
height;
1487 if (wt !=
nullptr) free_height -= wt->
height;
1489 int enlarge_x = std::max(std::min(def_width - this->
width, _screen.width - this->width), 0);
1490 int enlarge_y = std::max(std::min(def_height - this->
height, free_height - this->
height), 0);
1506 int nx = this->
left;
1509 if (nx + this->
width > _screen.width) nx -= (nx + this->
width - _screen.width);
1512 ny = std::max(ny, (wt ==
nullptr ||
this == wt || this->
top == 0) ? 0 : wt->
height);
1513 nx = std::max(nx, 0);
1539 int right = width + left;
1540 int bottom = height + top;
1542 if (left < 0 || top < toolbar_y || right > _screen.width || bottom > _screen.height)
return false;
1548 if (right > w->
left &&
1581 if (left < -(width >> 1) || left > _screen.width - (width >> 2))
return false;
1583 if (left < -(width >> 2) || left > _screen.width - (width >> 1))
return false;
1587 if (top < toolbar_y || top > _screen.height - (height >> 2))
return false;
1593 if (left + width > w->
left &&
1595 top + height > w->
top &&
1620 const int toolbar_y = main_toolbar !=
nullptr ? main_toolbar->
height : 0;
1621 if (
IsGoodAutoPlace1(rtl ? _screen.width - width : 0, toolbar_y, width, height, toolbar_y, pt))
return pt;
1656 int left = rtl ? _screen.width - width : 0, top = toolbar_y;
1662 if (w->
left == left && w->
top == top) {
1683 assert(w !=
nullptr);
1716 pt.
x = w->
left + (rtl ? w->
width - default_width : 0);
1725 if (w->
top + 3 * indent_y < _screen.height) {
1726 pt.
y = w->
top + indent_y;
1730 pt.
x = std::max(w->
left + w->
width - default_width - indent_close, 0);
1731 if (pt.
x + default_width >= indent_close && pt.
x + indent_resize <= _screen.width)
return pt;
1733 pt.
x = std::min(w->
left + indent_close, _screen.width - default_width);
1734 if (pt.
x + default_width >= indent_resize && pt.
x + indent_close <= _screen.width)
return pt;
1748 pt.
x = (_screen.width - default_width) / 2;
1749 pt.
y = (_screen.height - default_height) / 2;
1839 _focused_window =
nullptr;
1847 NWidgetScrollbar::InvalidateDimensionCache();
1878static void DecreaseWindowCounters()
1880 if (_scroller_click_timeout != 0) _scroller_click_timeout--;
1883 if (_scroller_click_timeout == 0) {
1885 for (
auto &pair : w->widget_lookup) {
1889 if (sb->
disp_flags.
Any({NWidgetDisplayFlag::ScrollbarUp, NWidgetDisplayFlag::ScrollbarDown})) {
1899 for (
auto &pair : w->querystrings) {
1900 pair.second->HandleEditBox(w, pair.first);
1916static void HandlePlacePresize()
1921 if (w ==
nullptr)
return;
1923 Point pt = GetTileBelowCursor();
1967 Point pt = { -1, -1 };
1978 if (widget !=
nullptr) w->
OnMouseOver(pt, widget->GetIndex());
2000 if (v ==
nullptr)
return;
2002 const int min_visible = rect.
Height();
2006 int safe_y = (dir ==
PHD_UP) ? (v->
top - min_visible - rect.top) : (v_bottom + min_visible - rect.bottom);
2008 if (*ny + rect.top <= v->
top - min_visible)
return;
2009 if (*ny + rect.bottom >= v_bottom + min_visible)
return;
2012 if (*nx + rect.left + min_visible < v->left) {
2013 if (v->
left < min_visible) *ny = safe_y;
2016 if (*nx + rect.right - min_visible > v_right) {
2017 if (v_right > _screen.width - min_visible) *ny = safe_y;
2022 if (px + rect.left < v->
left && v->
left >= min_visible) {
2023 *nx = v->
left - min_visible - rect.left;
2024 }
else if (px + rect.right > v_right && v_right <= _screen.width - min_visible) {
2025 *nx = v_right + min_visible - rect.right;
2042 if (caption !=
nullptr) {
2043 const Rect caption_rect = caption->GetCurrentRect();
2045 const int min_visible = caption_rect.
Height();
2048 nx =
Clamp(nx, min_visible - caption_rect.right, _screen.width - min_visible - caption_rect.left);
2049 ny =
Clamp(ny, 0, _screen.height - min_visible);
2077 if (delta_x != 0 || delta_y != 0) {
2078 if (clamp_to_screen) {
2081 int new_right = w->
left + w->
width + delta_x;
2082 int new_bottom = w->
top + w->
height + delta_y;
2083 if (new_right >= (
int)_screen.width) delta_x -=
Ceil(new_right - _screen.width, std::max(1U, w->
nested_root->resize_x));
2084 if (new_bottom >= (
int)_screen.height) delta_y -=
Ceil(new_bottom - _screen.height, std::max(1U, w->
nested_root->resize_y));
2102 if (schedule_resize) {
2118 return (w ==
nullptr) ? 0 : w->
top + w->
height;
2129 return (w ==
nullptr) ? _screen.height : w->
top;
2168 if (v == w)
continue;
2170 if (y + w->
height > v->top && y < v->top + v->height) {
2172 delta =
abs(v->left + v->width - x);
2173 if (delta <= hsnap) {
2174 nx = v->left + v->width;
2179 delta =
abs(v->left - x - w->
width);
2180 if (delta <= hsnap) {
2181 nx = v->left - w->
width;
2186 if (w->
top + w->
height >= v->top && w->
top <= v->top + v->height) {
2188 delta =
abs(v->left - x);
2189 if (delta <= hsnap) {
2195 delta =
abs(v->left + v->width - x - w->
width);
2196 if (delta <= hsnap) {
2197 nx = v->left + v->width - w->
width;
2202 if (x + w->
width > v->left && x < v->left + v->width) {
2204 delta =
abs(v->top + v->height - y);
2205 if (delta <= vsnap) {
2206 ny = v->top + v->height;
2212 if (delta <= vsnap) {
2218 if (w->
left + w->
width >= v->left && w->
left <= v->left + v->width) {
2220 delta =
abs(v->top - y);
2221 if (delta <= vsnap) {
2227 delta =
abs(v->top + v->height - y - w->
height);
2228 if (delta <= vsnap) {
2229 ny = v->top + v->height - w->
height;
2264 if (w->
top + w->
height + y > _screen.height) {
2265 y = _screen.height - w->
height - w->
top;
2350 i = _cursor.
pos.
x - _cursorpos_drag_start.
x;
2353 i = _cursor.
pos.
y - _cursorpos_drag_start.
y;
2356 if (sb->
disp_flags.
Any({NWidgetDisplayFlag::ScrollbarUp, NWidgetDisplayFlag::ScrollbarDown})) {
2357 if (_scroller_click_timeout == 1) {
2358 _scroller_click_timeout = 3;
2369 if (range <= 0)
return;
2371 int pos =
RoundDivSU((i + _scrollbar_start_pos) * range, std::max(1, _scrollbar_size));
2372 if (rtl) pos = range - pos;
2442 if (scrollwheel_scrolling) {
2445 delta.
x =
static_cast<int>(_cursor.h_wheel);
2446 delta.
y =
static_cast<int>(_cursor.v_wheel);
2449 _cursor.v_wheel = std::modf(_cursor.v_wheel, &temp);
2450 _cursor.h_wheel = std::modf(_cursor.h_wheel, &temp);
2466 _cursor.wheel_moved =
false;
2482 bool bring_to_front =
false;
2492 int w_width = w->
width;
2493 int w_height = w->
height;
2501 for (; !it.IsEnd(); ++it) {
2518 if (w->
left + w_width <= u->left ||
2520 w->
top + w_height <= u->top ||
2525 bring_to_front =
true;
2547 switch (query->text.HandleKeyPress(key, keycode)) {
2591 if (query->text.
GetText().empty()) {
2642 if (key >= 0xE000 && key <= 0xF8FF) key = 0;
2647 if (key == 0 && keycode == 0)
return;
2679 HandleGlobalHotkeys(key, keycode);
2698 void Window::InsertTextString(
WidgetID wid, std::string_view str,
bool marked, std::optional<size_t> caret, std::optional<size_t> insert_location, std::optional<size_t> replacement_end)
2701 if (query ==
nullptr)
return;
2703 if (query->text.
InsertString(str, marked, caret, insert_location, replacement_end) || marked) {
2715void HandleTextInput(std::string_view str,
bool marked, std::optional<size_t> caret, std::optional<size_t> insert_location, std::optional<size_t> replacement_end)
2732 int x = _cursor.
pos.
x;
2733 int y = _cursor.
pos.
y;
2739 if (vp ==
nullptr)
return;
2746 static const int SCROLLSPEED = 3;
2750 }
else if (15 - (vp->
width - x) > 0) {
2757 }
else if (15 - (vp->
height - y) > 0) {
2763enum MouseClick : uint8_t {
2778static void ScrollMainViewport(
int x,
int y)
2780 if (_game_mode != GM_MENU && _game_mode != GM_BOOTSTRAP) {
2815static void HandleKeyScrolling()
2824 if (_game_mode != GM_MENU && _game_mode != GM_BOOTSTRAP) {
2827 main_window->
viewport->CancelFollow(*main_window);
2834static void MouseLoop(MouseClick click,
int mousewheel)
2840 HandlePlacePresize();
2852 if (click == MC_NONE && mousewheel == 0 && !scrollwheel_scrolling)
return;
2854 int x = _cursor.
pos.
x;
2855 int y = _cursor.
pos.
y;
2857 if (w ==
nullptr)
return;
2863 if (vp !=
nullptr && (_game_mode == GM_MENU ||
HasModalProgress()))
return;
2865 if (mousewheel != 0) {
2877 if (vp !=
nullptr) {
2885 case MC_DOUBLE_LEFT:
2887 if (HandleViewportClicked(*vp, x, y))
return;
2914 case MC_DOUBLE_LEFT:
2934 _cursor.h_wheel = 0.0f;
2935 _cursor.v_wheel = 0.0f;
2936 _cursor.wheel_moved =
false;
2948 static std::chrono::steady_clock::time_point double_click_time = {};
2949 static Point double_click_pos = {0, 0};
2952 MouseClick click = MC_NONE;
2958 click = MC_DOUBLE_LEFT;
2960 double_click_time = std::chrono::steady_clock::now();
2961 double_click_pos = _cursor.
pos;
2969 if (_cursor.
wheel) {
2970 mousewheel = _cursor.
wheel;
2974 static std::chrono::steady_clock::time_point hover_time = {};
2975 static Point hover_pos = {0, 0};
2981 hover_pos = _cursor.
pos;
2982 hover_time = std::chrono::steady_clock::now();
2988 hover_time = std::chrono::steady_clock::now();
3001 MouseLoop(click, mousewheel);
3018 uint deletable_count = 0;
3019 Window *last_deletable =
nullptr;
3030 assert(last_deletable !=
nullptr);
3031 last_deletable->
Close();
3053static std::chrono::time_point<std::chrono::steady_clock> _realtime_tick_start;
3055bool CanContinueRealtimeTick()
3057 auto now = std::chrono::steady_clock::now();
3058 return std::chrono::duration_cast<std::chrono::milliseconds>(now - _realtime_tick_start).count() < (
MILLISECONDS_PER_TICK * 3 / 4);
3066 _realtime_tick_start = std::chrono::steady_clock::now();
3074 extern int _caret_timer;
3078 HandleKeyScrolling();
3080 DecreaseWindowCounters();
3105 static auto last_time = std::chrono::steady_clock::now();
3106 auto now = std::chrono::steady_clock::now();
3107 auto delta_ms = std::chrono::duration_cast<std::chrono::milliseconds>(now - last_time);
3109 if (delta_ms.count() == 0)
return;
3243 if (pair.second->IsHighlighted()) pair.second->SetDirty(
this);
3378void ReInitWindow(
Window *w,
bool zoom_changed)
3380 if (w ==
nullptr)
return;
3393 NWidgetScrollbar::InvalidateDimensionCache();
3403 ReInitWindow(w, zoom_changed);
3426 if (w ==
nullptr)
return 0;
3428 int old_left = w->
left;
3430 case 1: w->
left = (_screen.width - w->
width) / 2;
break;
3431 case 2: w->
left = _screen.width - w->
width;
break;
3432 default: w->
left = 0;
break;
3446 Debug(misc, 5,
"Repositioning Main Toolbar...");
3457 Debug(misc, 5,
"Repositioning statusbar...");
3468 Debug(misc, 5,
"Repositioning news message...");
3479 Debug(misc, 5,
"Repositioning network chat window...");
3493 w->
viewport->follow_vehicle = to_index;
3517 ws->top = newh - ws->height;
3555 top = (newh - w->
height) >> 1;
3556 left = (neww - w->
width) >> 1;
3561 if (left + (w->
width >> 1) >= neww) left = neww - w->
width;
3562 if (left < 0) left = 0;
3565 if (top + (w->
height >> 1) >= newh) top = newh - w->
height;
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
constexpr Timpl & Reset()
Reset all bits.
constexpr Timpl & Flip(Tvalue_type value)
Flip the value-th bit.
constexpr Timpl & Set()
Set all bits.
constexpr bool Any(const Timpl &other) const
Test if any of the given values are set.
static Blitter * GetCurrentBlitter()
Get the current active blitter (always set by calling SelectBlitter).
How all blitters should look like.
virtual void * MoveTo(void *video, int x, int y)=0
Move the destination pointer the requested amount x and y, keeping in mind any pitch and bpp of the r...
static void NewEvent(class ScriptEvent *event)
Queue a new event for a Game Script.
An interval timer will fire every interval, and will continue to fire until it is deleted.
void Close(int data=0) override
Hide the window and all its child windows, and mark them for a later deletion.
static bool Elapsed(TElapsed value)
Called when time for this timer elapsed.
virtual void EditBoxLostFocus()
An edit box lost the input focus.
static VideoDriver * GetInstance()
Get the currently active instance of the video driver.
virtual void EditBoxGainedFocus()
An edit box gained the input focus.
Functions related to companies.
bool IsLocalCompany()
Is the current company the local company?
static constexpr Owner INVALID_OWNER
An invalid owner.
Console functions used outside of the console code.
void IConsoleClose()
Close the in-game console.
void IConsoleResize(Window *w)
Change the size of the in-game console window after the screen size changed, or the window state chan...
GUI related functions in the console.
#define Debug(category, level, format_string,...)
Output a line of debugging information.
Functions related to depots.
void InitDepotWindowBlockSizes()
Set the size of the blocks in the window so we can be sure that they are big enough for the vehicle s...
Functions related to errors.
void UnshowCriticalError()
Unshow the critical error.
void ShowFirstError()
Show the first error of the queue.
Factory to 'query' all available blitters.
@ NO_DIRECTORY
A path without any base directory.
int GetCharacterHeight(FontSize size)
Get height of a character for a given font size.
void ProcessPendingPerformanceMeasurements()
This drains the PFE_SOUND measurement data queue into _pf_data.
Types for recording game performance data.
@ PFE_DRAWING
Speed of drawing world and GUI.
@ PFE_DRAWWORLD
Time spent drawing world viewports in GUI.
Base functions for all Games.
bool _shift_pressed
Is Shift pressed?
bool _left_button_down
Is left mouse button pressed?
bool _ctrl_pressed
Is Ctrl pressed?
uint8_t _dirkeys
1 = left, 2 = up, 4 = right, 8 = down
bool _left_button_clicked
Is left mouse button clicked?
bool _right_button_clicked
Is right mouse button clicked?
bool _right_button_down
Is right mouse button pressed?
int _gui_scale
GUI scale, 100 is 100%.
Functions related to the gfx engine.
@ FS_NORMAL
Index of the normal font in the font tables.
TextColour
Colour of the strings, see _string_colourmap in table/string_colours.h or docs/ottd-colourtext-palett...
static const uint MILLISECONDS_PER_TICK
The number of milliseconds per game tick.
void SetDirty() const
Mark entire window as dirty (in need of re-paint)
void AddDirtyBlock(int left, int top, int right, int bottom)
Extend the internal _invalid_rect rectangle to contain the rectangle defined by the given parameters.
void DrawDirtyBlocks()
Repaints the rectangle blocks which are marked as 'dirty'.
void MarkWholeScreenDirty()
This function mark the whole screen as dirty.
Hotkey related functions.
Types related to reading/writing '*.ini' files.
static debug_inline TileIndex TileVirtXY(uint x, uint y)
Get a tile from the virtual XY-coordinate.
constexpr bool IsInsideBS(const T x, const size_t base, const size_t size)
Checks if a value is between a window started at some base point.
constexpr T abs(const T a)
Returns the absolute value of (scalar) variable.
constexpr int RoundDivSU(int a, uint b)
Computes round(a / b) for signed a and unsigned b.
constexpr uint Ceil(uint a, uint b)
Computes ceil(a / b) * b for non-negative a and b.
constexpr T Clamp(const T a, const T min, const T max)
Clamp a value between an interval.
void GuiShowTooltips(Window *parent, EncodedString &&text, TooltipCloseCondition close_tooltip)
Shows a tooltip.
bool _networking
are we in networking mode?
bool _network_dedicated
are we a dedicated server?
Basic functions/variables used all over the place.
void NetworkDrawChatMessage()
Draw the chat message-box.
void NetworkReInitChatBoxSize()
Initialize all font-dependent chat box sizes.
void NetworkUndrawChatMessage()
Hide the chatbox.
Network functions used by other parts of OpenTTD.
Functions/types related to NewGRF debugging.
NewGrfDebugSpritePicker _newgrf_debug_sprite_picker
The sprite picker.
Functions related to news.
void InitNewsItemStructs()
Initialize the news-items data structures.
Functions related to modal progress.
bool HasModalProgress()
Check if we are currently in a modal progress state.
Base for the GUIs that have an edit box in them.
A number of safeguards to prevent using unsafe methods.
void IniLoadWindowSettings(IniFile &ini, std::string_view grpname, WindowDesc *desc)
Load a WindowDesc from config.
void IniSaveWindowSettings(IniFile &ini, std::string_view grpname, WindowDesc *desc)
Save a WindowDesc to config.
ClientSettings _settings_client
The current settings for this game.
Functions related to setting/changing the settings.
Types related to global configuration settings.
@ VSM_VIEWPORT_RMB_FIXED
Viewport moves with mouse movement on holding right mouse button, cursor position is fixed.
@ VSM_MAP_RMB_FIXED
Map moves with mouse movement on holding right mouse button, cursor position is fixed.
@ VSM_MAP_LMB
Map moves with mouse movement on holding left mouse button, cursor moves.
@ SWS_SCROLL_MAP
Scroll wheel scrolls the map.
bool ScrollMainWindowTo(int x, int y, int z, bool instant)
Scrolls the main window to given coordinates.
void SndClickBeep()
Play a beep sound for a click event if enabled in settings.
Functions related to sound.
Functions, definitions and such used only by the GUI.
@ SBI_NEWS_DELETED
abort current news display (active news were deleted)
Definition of base types and functions in a cross-platform compatible way.
EncodedString GetEncodedString(StringID str)
Encode a string with no parameters into an encoded string.
std::string GetString(StringID string)
Resolve the given StringID into a std::string with formatting but no parameters.
TextDirection _current_text_dir
Text direction of the currently selected language.
Functions related to OTTD's strings.
uint32_t StringID
Numeric value that represents a string, independent of the selected language.
@ TD_RTL
Text is written right-to-left by default.
Class to backup a specific variable and restore it upon destruction of this object to prevent stack v...
GUISettings gui
settings related to the GUI
bool fix_at
mouse is moving, but cursor is not (used for scrolling)
Point pos
logical mouse position
bool in_window
mouse inside this window, determines drawing logic
int wheel
mouse wheel movement
Point delta
relative mouse movement in this tick
Data about how and where to blit pixels.
uint8_t window_snap_radius
windows snap at each other if closer than this
uint16_t hover_delay_ms
time required to activate a hover event, in milliseconds
uint8_t auto_scrolling
scroll when moving mouse to the edge (see ViewportAutoscrolling)
uint8_t scroll_mode
viewport scroll mode
RightClickClose right_click_wnd_close
close window with right click
uint8_t window_soft_limit
soft limit of maximum number of non-stickied non-vital windows (0 = no limit)
uint8_t toolbar_pos
position of toolbars, 0=left, 1=center, 2=right
uint8_t statusbar_pos
position of statusbar, 0=left, 1=center, 2=right
uint8_t scrollwheel_scrolling
scrolling using the scroll wheel?
List of hotkeys for a window.
int CheckMatch(uint16_t keycode, bool global_only=false) const
Check if a keycode is bound to something.
Ini file that supports both loading and saving.
bool SaveToDisk(const std::string &filename)
Save the Ini file's data to the disk.
void LoadFromDisk(std::string_view filename, Subdirectory subdir)
Load the Ini file's data from the disk.
NewGrfDebugSpritePickerMode mode
Current state.
void * clicked_pixel
Clicked pixel (pointer to blitter buffer)
FlatSet< SpriteID > sprites
Sprites found.
static Titem * Get(auto index)
Returns Titem with given index.
Data stored about a string that can be modified in the GUI.
int ok_button
Widget button of parent window to simulate when pressing OK in OSK.
static const int ACTION_DESELECT
Deselect editbox.
int cancel_button
Widget button of parent window to simulate when pressing CANCEL in OSK.
ptrdiff_t GetCharAtPosition(const Window *w, WidgetID wid, const Point &pt) const
Get the character that is rendered at a position.
static const int ACTION_NOTHING
Nothing.
static const int ACTION_CLEAR
Clear editbox.
Point GetCaretPosition(const Window *w, WidgetID wid) const
Get the current caret position.
Rect GetBoundingRect(const Window *w, WidgetID wid, size_t from, size_t to) const
Get the bounding rectangle for a range of the query string.
Specification of a rectangle with absolute coordinates of all edges.
int Height() const
Get height of Rect.
uint step_height
Step-size of height resize changes.
uint step_width
Step-size of width resize changes.
Helper/buffer for input fields.
void UpdateSize()
Update Textbuf type with its actual physical character and screenlength Get the count of characters i...
void DeleteAll()
Delete every character in the textbuffer.
std::string_view GetText() const
Get the current text.
bool InsertString(std::string_view str, bool marked, std::optional< size_t > caret=std::nullopt, std::optional< size_t > insert_location=std::nullopt, std::optional< size_t > replacement_end=std::nullopt)
Insert a string into the text buffer.
Window * GetCallbackWnd()
Get the window that started the current highlighting.
WindowClass window_class
The WindowClass of the window that is responsible for the selection mode.
void Reset()
Reset tile highlighting.
Point selend
The location where the drag currently ends.
WindowNumber window_number
The WindowNumber of the window that is responsible for the selection mode.
int32_t z_pos
z coordinate.
int32_t y_pos
y coordinate.
int32_t x_pos
x coordinate.
Data structure for viewport, display of a part of the world.
int top
Screen coordinate top edge of the viewport.
int width
Screen width of the viewport.
ZoomLevel zoom
The zoom level of the viewport.
int left
Screen coordinate left edge of the viewport.
int height
Screen height of the viewport.
High level window description.
int16_t GetDefaultWidth() const
Determine default width of window.
static void SaveToConfig()
Save all WindowDesc settings to _windows_file.
int16_t pref_width
User-preferred width of the window. Zero if unset.
const WindowPosition default_pos
Preferred position of the window.
bool pref_sticky
Preferred stickyness.
int16_t pref_height
User-preferred height of the window. Zero if unset.
int16_t GetDefaultHeight() const
Determine default height of window.
const int16_t default_height_trad
Preferred initial height of the window (pixels at 1x zoom).
const int16_t default_width_trad
Preferred initial width of the window (pixels at 1x zoom).
const WindowClass cls
Class of the window,.
const std::string_view ini_key
Key to store window defaults in openttd.cfg. An empty string if nothing shall be stored.
const WindowDefaultFlags flags
Flags.
static void LoadFromConfig()
Load all WindowDesc settings from _windows_file.
const WindowClass parent_cls
Class of the parent window.
const HotkeyList * hotkeys
Hotkeys for the window.
WindowDesc(WindowPosition default_pos, std::string_view ini_key, int16_t def_width_trad, int16_t def_height_trad, WindowClass window_class, WindowClass parent_class, WindowDefaultFlags flags, const std::span< const NWidgetPart > nwid_parts, HotkeyList *hotkeys=nullptr, const std::source_location location=std::source_location::current())
Window description constructor.
const std::span< const NWidgetPart > nwid_parts
Span of nested widget parts describing the window.
Number to differentiate different windows of the same class.
Iterator to iterate all valid Windows.
Data structure for an opened window.
virtual const struct Textbuf * GetFocusedTextbuf() const
Get the current input text buffer.
void SetWidgetHighlight(WidgetID widget_index, TextColour highlighted_colour)
Sets the highlighted status of a widget.
void ReInit(int rx=0, int ry=0, bool reposition=false)
Re-initialize a window, and optionally change its size.
virtual void Close(int data=0)
Hide the window and all its child windows, and mark them for a later deletion.
virtual void OnInvalidateData(int data=0, bool gui_scope=true)
Some data on this window has become invalid.
void FinishInitNested(WindowNumber window_number=0)
Perform the second part of the initialization of a nested widget tree.
std::map< WidgetID, QueryString * > querystrings
QueryString associated to WWT_EDITBOX widgets.
virtual void ApplyDefaults()
Read default values from WindowDesc configuration an apply them to the window.
uint8_t white_border_timer
Timer value of the WindowFlag::WhiteBorder for flags.
NWidgetStacked * shade_select
Selection widget (NWID_SELECTION) to use for shading the window. If nullptr, window cannot shade.
void InitializePositionSize(int x, int y, int min_width, int min_height)
Set the position and smallest size of the window.
Dimension unshaded_size
Last known unshaded size (only valid while shaded).
void InvalidateData(int data=0, bool gui_scope=true)
Mark this window's data as invalid (in need of re-computing)
virtual EventState OnKeyPress(char32_t key, uint16_t keycode)
A key has been pressed.
Window * parent
Parent window.
AllWindows< false > IterateFromBack
Iterate all windows in Z order from back to front.
virtual ~Window()
Remove window and all its child windows from the window stack.
void RaiseWidget(WidgetID widget_index)
Marks a widget as raised.
void SetWidgetDirty(WidgetID widget_index) const
Invalidate a widget, i.e.
uint8_t timeout_timer
Timer value of the WindowFlag::Timeout for flags.
std::unique_ptr< ViewportData > viewport
Pointer to viewport data, if present.
virtual std::string GetWidgetString(WidgetID widget, StringID stringid) const
Get the raw string for a widget.
WidgetID mouse_capture_widget
ID of current mouse capture widget (e.g. dragged scrollbar). -1 if no widget has mouse capture.
virtual void OnGameTick()
Called once per (game) tick.
virtual void ShowNewGRFInspectWindow() const
Show the NewGRF inspection window.
virtual bool OnRightClick(Point pt, WidgetID widget)
A click with the right mouse button has been made on the window.
virtual void OnScrollbarScroll(WidgetID widget)
Notify window that a scrollbar position has been updated.
virtual void OnDropdownSelect(WidgetID widget, int index, int click_result)
A dropdown option associated to this window has been selected.
void ProcessScheduledInvalidations()
Process all scheduled invalidations.
void CloseChildWindows(WindowClass wc=WC_INVALID) const
Close all children a window might have in a head-recursive manner.
ResizeInfo resize
Resize information.
void UnfocusFocusedWidget()
Makes no widget on this window have focus.
virtual void OnMouseLoop()
Called for every mouse loop run, which is at least once per (game) tick.
void SetShaded(bool make_shaded)
Set the shaded state of the window to make_shaded.
int scale
Scale of this window – used to determine how to resize.
void ScheduleResize()
Mark this window as resized and in need of OnResize() event.
virtual void OnPaint()
The window must be repainted.
virtual void OnDragDrop(Point pt, WidgetID widget)
A dragged 'object' has been released.
void CreateNestedTree()
Perform the first part of the initialization of a nested widget tree.
WindowDesc & window_desc
Window description.
WindowClass window_class
Window class.
virtual void OnRealtimeTick(uint delta_ms)
Called periodically.
virtual void OnMouseWheel(int wheel, WidgetID widget)
The mouse wheel has been turned.
AllWindows< true > IterateFromFront
Iterate all windows in Z order from front to back.
void CloseChildWindowById(WindowClass wc, WindowNumber number) const
Close all children a window might have in a head-recursive manner.
void SetWhiteBorder()
Set the timeout flag of the window and initiate the timer.
bool SetFocusedWidget(WidgetID widget_index)
Set focus within this window to the given widget.
virtual void OnFocusLost(bool closing)
The window has lost focus.
static std::vector< Window * > closed_windows
List of closed windows to delete.
void RaiseButtons(bool autoraise=false)
Raise the buttons of the window.
virtual Point OnInitialPosition(int16_t sm_width, int16_t sm_height, int window_number)
Compute the initial position of the window.
Owner owner
The owner of the content shown in this window. Company colour is acquired from this variable.
virtual Point GetCaretPosition() const
Get the current caret position if an edit box has the focus.
virtual void FindWindowPlacementAndResize(int def_width, int def_height, bool allow_resize)
Resize window towards the default size.
virtual void OnDropdownClose(Point pt, WidgetID widget, int index, int click_result, bool instant_close)
A dropdown window associated to this window has been closed.
virtual void InsertTextString(WidgetID wid, std::string_view str, bool marked, std::optional< size_t > caret, std::optional< size_t > insert_location, std::optional< size_t > replacement_end)
Insert a text string at the cursor position into the edit box widget.
int left
x position of left edge of the window
bool IsShaded() const
Is window shaded currently?
Window * FindChildWindow(WindowClass wc=WC_INVALID) const
Find the Window whose parent pointer points to this window.
void SetTimeout()
Set the timeout flag of the window and initiate the timer.
const NWidgetCore * nested_focus
Currently focused nested widget, or nullptr if no nested widget has focus.
virtual void OnEditboxChanged(WidgetID widget)
The text in an editbox has been edited.
void UpdateQueryStringSize()
Update size of all QueryStrings of this window.
virtual void OnScroll(Point delta)
Handle the request for (viewport) scrolling.
int top
y position of top edge of the window
virtual void OnClick(Point pt, WidgetID widget, int click_count)
A click with the left mouse button has been made on the window.
const QueryString * GetQueryString(WidgetID widnum) const
Return the querystring associated to a editbox.
WidgetLookup widget_lookup
Indexed access to the nested widget tree. Do not access directly, use Window::GetWidget() instead.
virtual ptrdiff_t GetTextCharacterAtPosition(const Point &pt) const
Get the character that is rendered at a position by the focused edit box.
std::vector< int > scheduled_invalidation_data
Data of scheduled OnInvalidateData() calls.
void InitializeData(WindowNumber window_number)
Initializes the data (except the position and initial size) of a new Window.
virtual void OnMouseOver(Point pt, WidgetID widget)
The mouse is currently moving over the window or has just moved outside of the window.
Window(WindowDesc &desc)
Empty constructor, initialization has been moved to InitNested() called from the constructor of the d...
int GetRowFromWidget(int clickpos, WidgetID widget, int padding, int line_height=-1) const
Compute the row of a widget that a user clicked in.
const NWID * GetWidget(WidgetID widnum) const
Get the nested widget with number widnum from the nested widget tree.
virtual bool OnTooltip(Point pt, WidgetID widget, TooltipCloseCondition close_cond)
Event to display a custom tooltip.
void LowerWidget(WidgetID widget_index)
Marks a widget as lowered.
virtual EventState OnCTRLStateChange()
The state of the control key has changed.
void ProcessScheduledResize()
Process scheduled OnResize() event.
EventState HandleEditBoxKey(WidgetID wid, char32_t key, uint16_t keycode)
Process keypress for editbox widget.
virtual void OnMouseDrag(Point pt, WidgetID widget)
An 'object' is being dragged at the provided position, highlight the target if possible.
void HandleButtonClick(WidgetID widget)
Do all things to make a button look clicked and mark it to be unclicked in a few ticks.
virtual void OnResize()
Called after the window got resized.
Window * FindChildWindowById(WindowClass wc, WindowNumber number) const
Find the Window whose parent pointer points to this window.
virtual void OnFocus()
The window has gained focus.
void InitNested(WindowNumber number=0)
Perform complete initialization of the Window with nested widgets, to allow use.
virtual void OnTimeout()
Called when this window's timeout has been reached.
WindowFlags flags
Window flags.
const Scrollbar * GetScrollbar(WidgetID widnum) const
Return the Scrollbar to a widget index.
void ProcessHighlightedInvalidations()
Process all invalidation of highlighted widgets.
virtual EventState OnHotkey(int hotkey)
A hotkey has been pressed.
static void DeleteClosedWindows()
Delete all closed windows.
std::unique_ptr< NWidgetBase > nested_root
Root of the nested tree.
bool scheduled_resize
Set if window has been resized.
virtual Rect GetTextBoundingRect(size_t from, size_t to) const
Get the bounding rectangle for a text range if an edit box has the focus.
bool IsWidgetHighlighted(WidgetID widget_index) const
Gets the highlighted status of a widget.
void DisableAllWidgetHighlight()
Disable the highlighted status of all widgets.
virtual void OnPlacePresize(Point pt, TileIndex tile)
The user moves over the map when a tile highlight mode has been set when the special mouse mode has b...
AllWindows< false > Iterate
Iterate all windows in whatever order is easiest.
int height
Height of the window (number of pixels down in y direction)
virtual void OnHover(Point pt, WidgetID widget)
The mouse is hovering over a widget in the window, perform an action for it.
int width
width of the window (number of pixels to the right in x direction)
virtual void OnInit()
Notification that the nested widget tree gets initialized.
WindowNumber window_number
Window number within the window class.
std::vector< WindowDesc * > * _window_descs
List of WindowDescs.
@ HKPR_NOT_HANDLED
Key does not affect editboxes.
@ HKPR_CANCEL
Escape key pressed.
@ HKPR_EDITING
Textbuf content changed.
@ HKPR_CONFIRM
Return or enter key pressed.
@ HKPR_CURSOR
Non-text change, e.g. cursor position.
Functions related to tile highlights.
void ResetObjectToPlace()
Reset the cursor and mouse mode handling back to default (normal cursor, only clicking in windows).
void UpdateTileSelection()
Updates tile highlighting for all cases.
Definition of Interval and OneShot timers.
Definition of the Window system.
static constexpr std::chrono::milliseconds TIMER_BLINK_INTERVAL
Interval used by blinking interface elements.
Base class for all vehicles.
Base of all video drivers.
Viewport * IsPtInWindowViewport(const Window *w, int x, int y)
Is a xy position inside the viewport of the window?
void UpdateViewportPosition(Window *w, uint32_t delta_ms)
Update the viewport position being displayed.
Functions related to (drawing on) viewports.
int PositionStatusbar(Window *w)
(Re)position statusbar window at the screen.
static void PreventHiding(int *nx, int *ny, const Rect &rect, const Window *v, int px, PreventHideDirection dir)
Do not allow hiding of the rectangle with base coordinates nx and ny behind window v.
static bool _dragging_window
A window is being dragged or resized.
static const IntervalTimer< TimerWindow > white_border_interval(std::chrono::milliseconds(30), [](auto) { if(_network_dedicated) return;for(Window *w :Window::Iterate()) { if(w->flags.Test(WindowFlag::WhiteBorder) &&--w->white_border_timer==0) { w->flags.Reset(WindowFlag::WhiteBorder);w->SetDirty();} } })
Blink all windows marked with a white border.
void CloseConstructionWindows()
Close all windows that are used for construction of vehicle etc.
void CloseWindowById(WindowClass cls, WindowNumber number, bool force, int data)
Close a window by its class and window number (if it is open).
static Point LocalGetWindowPlacement(const WindowDesc &desc, int16_t sm_width, int16_t sm_height, int window_number)
Compute the position of the top-left corner of a new window that is opened.
Window * GetMainWindow()
Get the main window, i.e.
static Point _drag_delta
delta between mouse cursor and upper left corner of dragged window
static bool MayBeShown(const Window *w)
Returns whether a window may be shown or not.
void CloseCompanyWindows(CompanyID id)
Close all windows of a company.
void HandleCtrlChanged()
State of CONTROL key has changed.
static void DrawOverlappedWindow(Window *w, int left, int top, int right, int bottom)
Generate repaint events for the visible part of window w within the rectangle.
bool _scrolling_viewport
A viewport is being scrolled with the mouse.
void InputLoop()
Regular call from the global game loop.
void UpdateWindows()
Update the continuously changing contents of the windows, such as the viewports.
int PositionMainToolbar(Window *w)
(Re)position main toolbar window at the screen.
void CloseNonVitalWindows()
Try to close a non-vital window.
void DrawOverlappedWindowForAll(int left, int top, int right, int bottom)
From a rectangle that needs redrawing, find the windows that intersect with the rectangle.
void ResizeWindow(Window *w, int delta_x, int delta_y, bool clamp_to_screen, bool schedule_resize)
Resize the window.
static bool IsGoodAutoPlace2(int left, int top, int width, int height, int toolbar_y, Point &pos)
Decide whether a given rectangle is a good place to open a mostly visible new window.
int PositionNetworkChatWindow(Window *w)
(Re)position network chat window at the screen.
static void StartWindowSizing(Window *w, bool to_left)
Start resizing a window.
static Point GetAutoPlacePosition(int width, int height)
Find a good place for opening a new window of a given width and height.
PreventHideDirection
Direction for moving the window.
@ PHD_DOWN
Below v is a safe position.
@ PHD_UP
Above v is a safe position.
static void HandleAutoscroll()
If needed and switched on, perform auto scrolling (automatically moving window contents when mouse is...
bool _window_highlight_colour
If false, highlight is white, otherwise the by the widget defined colour.
void HandleToolbarHotkey(int hotkey)
Handle Toolbar hotkey events - can come from a source like the MacBook Touch Bar.
static int PositionWindow(Window *w, WindowClass clss, int setting)
(Re)position a window at the screen.
void SetFocusedWindow(Window *w)
Set the window that has the focus.
static bool IsGoodAutoPlace1(int left, int top, int width, int height, int toolbar_y, Point &pos)
Decide whether a given rectangle is a good place to open a completely visible new window.
static constexpr int MAX_OFFSET_DOUBLE_CLICK
How much the mouse is allowed to move to call it a double click.
Window * FindWindowByClass(WindowClass cls)
Find any window by its class.
void ChangeVehicleViewports(VehicleID from_index, VehicleID to_index)
Switches viewports following vehicles, which get autoreplaced.
const std::chrono::milliseconds TIME_BETWEEN_DOUBLE_CLICK(500)
Time between 2 left clicks before it becoming a double click.
static EventState HandleViewportScroll()
Handle viewport scrolling with the mouse.
static void DispatchMouseWheelEvent(Window *w, NWidgetCore *nwid, int wheel)
Dispatch the mousewheel-action to the window.
static void DispatchLeftClickEvent(Window *w, int x, int y, int click_count)
Dispatch left mouse-button (possibly double) click in window.
Window * FindWindowFromPt(int x, int y)
Do a search for a window at specific coordinates.
void DeleteAllMessages()
Delete all messages and close their corresponding window (if any).
static Window * _last_scroll_window
Window of the last scroll event.
int GetMainViewTop()
Return the top of the main view available for general use.
static void BringWindowToFront(Window *w, bool dirty=true)
On clicking on a window, make it the frontmost window of all windows with an equal or lower z-priorit...
void ReInitAllWindows(bool zoom_changed)
Re-initialize all windows.
static void EnsureVisibleCaption(Window *w, int nx, int ny)
Make sure at least a part of the caption bar is still visible by moving the window if necessary.
void CloseWindowByClass(WindowClass cls, int data)
Close all windows of a given class.
void HandleMouseEvents()
Handle a mouse event from the video driver.
Point GetToolbarAlignedWindowPosition(int window_width)
Computer the position of the top-left corner of a window to be opened right under the toolbar.
static EventState HandleWindowDragging()
Handle dragging/resizing of a window.
int PositionNewsMessage(Window *w)
(Re)position news message window at the screen.
int GetMainViewBottom()
Return the bottom of the main view available for general use.
static void DispatchHoverEvent(Window *w, int x, int y)
Dispatch hover of the mouse over a window.
void ChangeWindowOwner(Owner old_owner, Owner new_owner)
Change the owner of all the windows one company can take over from another company in the case of a c...
void HandleKeypress(uint keycode, char32_t key)
Handle keyboard input.
void SetWindowClassesDirty(WindowClass cls)
Mark all windows of a particular class as dirty (in need of repainting)
EventState VpHandlePlaceSizingDrag()
Handle the mouse while dragging for placement/resizing.
static constexpr int MAX_OFFSET_HOVER
Maximum mouse movement before stopping a hover event.
bool FocusedWindowIsConsole()
Check if a console is focused.
void ResetWindowSystem()
Reset the windowing system, by means of shutting it down followed by re-initialization.
static uint GetWindowZPriority(WindowClass wc)
Get the z-priority for a given window.
bool EditBoxInGlobalFocus()
Check if an edit box is in global focus.
void InvalidateWindowData(WindowClass cls, WindowNumber number, int data, bool gui_scope)
Mark window data of the window of a given class and specific window number as invalid (in need of re-...
void HideVitalWindows()
Close all always on-top windows to get an empty screen.
static const IntervalTimer< TimerWindow > highlight_interval(TIMER_BLINK_INTERVAL, [](auto) { _window_highlight_colour=!_window_highlight_colour;})
Blink the window highlight colour constantly.
static bool DescSorter(WindowDesc *const &a, WindowDesc *const &b)
Sort WindowDesc by ini_key.
Window * BringWindowToFrontById(WindowClass cls, WindowNumber number)
Find a window and make it the relative top-window on the screen.
void RelocateAllWindows(int neww, int newh)
Relocate all windows to fit the new size of the game application screen.
std::string _windows_file
Config file to store WindowDesc.
static void HandleScrollbarScrolling(Window *w)
Handle scrollbar scrolling with the mouse.
bool _mouse_hovering
The mouse is hovering over the same point.
static void StartWindowDrag(Window *w)
Start window dragging.
void CallWindowGameTickEvent()
Dispatch OnGameTick event over all windows.
static EventState HandleActiveWidget()
Handle active widget (mouse dragging on widget) with the mouse.
std::vector< WindowDesc * > * _window_descs
List of all WindowDescs.
static void DispatchRightClickEvent(Window *w, int x, int y)
Dispatch right mouse-button click in window.
ViewportAutoscrolling
Values for _settings_client.gui.auto_scrolling.
@ VA_MAIN_VIEWPORT_FULLSCREEN
Scroll main viewport at edge when using fullscreen.
@ VA_MAIN_VIEWPORT
Scroll main viewport at edge.
@ VA_EVERY_VIEWPORT
Scroll all viewports at their edges.
@ VA_DISABLED
Do not autoscroll when mouse is at edge of viewport.
static const int8_t scrollamt[16][2]
Describes all the different arrow key combinations the game allows when it is in scrolling mode.
static bool MaybeBringWindowToFront(Window *w)
Check if a window can be made relative top-most window, and if so do it.
WindowList _z_windows
List of windows opened at the screen sorted from the front to back.
void CallWindowRealtimeTickEvent(uint delta_ms)
Dispatch OnRealtimeTick event over all windows.
SpecialMouseMode _special_mouse_mode
Mode of the mouse.
static EventState HandleMouseDragDrop()
Handle dragging and dropping in mouse dragging mode (WSM_DRAGDROP).
void CloseAllNonVitalWindows()
It is possible that a stickied window gets to a position where the 'close' button is outside the gami...
static void HandleMouseOver()
Report position of the mouse to the underlying window.
static const IntervalTimer< TimerWindow > window_interval(std::chrono::milliseconds(30), [](auto) { extern int _caret_timer;_caret_timer+=3;CursorTick();HandleKeyScrolling();HandleAutoscroll();DecreaseWindowCounters();})
Update various of window-related information on a regular interval.
static Window * _mouseover_last_w
Window of the last OnMouseOver event.
static void CheckSoftLimit()
Check the soft limit of deletable (non vital, non sticky) windows.
Window * FindWindowById(WindowClass cls, WindowNumber number)
Find a window by its class and window number.
void UnInitWindowSystem()
Close down the windowing system.
void InitWindowSystem()
(re)initialize the windowing system
void SetWindowWidgetDirty(WindowClass cls, WindowNumber number, WidgetID widget_index)
Mark a particular widget in a particular window as dirty (in need of repainting)
void HandleTextInput(std::string_view str, bool marked, std::optional< size_t > caret, std::optional< size_t > insert_location, std::optional< size_t > replacement_end)
Handle text input.
void SetWindowDirty(WindowClass cls, WindowNumber number)
Mark window as dirty (in need of repainting)
void InvalidateWindowClassesData(WindowClass cls, int data, bool gui_scope)
Mark window data of all windows of a given class as invalid (in need of re-computing) Note that by de...
Window functions not directly related to making/drawing windows.
@ Construction
This window is used for construction; close it whenever changing company.
@ NoClose
This window can't be interactively closed.
@ NoFocus
This window won't get focus/make any other window lose focus when click.
@ Modal
The window is a modal child of some other window, meaning the parent is 'inactive'.
void SetFocusedWindow(Window *w)
Set the window that has the focus.
@ SizingLeft
Window is being resized towards the left.
@ DisableVpScroll
Window does not do autoscroll,.
@ Highlighted
Window has a widget that has a highlight.
@ Centred
Window is centered and shall stay centered after ReInit.
@ Dragging
Window is being dragged.
@ SizingRight
Window is being resized towards the right.
@ WhiteBorder
Window white border counter bit mask.
@ Timeout
Window timeout counter.
@ Sticky
Window is made sticky by user.
WidgetID GetWidgetFromPos(const Window *w, int x, int y)
Returns the index for the widget located at the given position relative to the window.
SpecialMouseMode
Mouse modes.
@ WSM_DRAGDROP
Drag&drop an object.
@ WSM_PRESIZE
Presizing mode (docks, tunnels).
WindowPosition
How do we the window to be placed?
@ WDP_CENTER
Center the window.
@ WDP_AUTO
Find a place automatically.
@ WDP_ALIGN_TOOLBAR
Align toward the toolbar.
@ WDP_MANUAL
Manually align the window (so no automatic location finding)
WindowList _z_windows
List of windows opened at the screen sorted from the front to back.
EventState
State of handling an event.
@ ES_HANDLED
The passed event is handled.
@ ES_NOT_HANDLED
The passed event is not handled.
WindowClass
Window classes.
@ WC_INVALID
Invalid window.
@ WC_OSK
On Screen Keyboard; Window numbers:
@ WC_CONSOLE
Console; Window numbers:
@ WC_NEWS_WINDOW
News window; Window numbers:
@ WC_HIGHSCORE
Highscore; Window numbers:
@ WC_BUY_COMPANY
Buyout company (merger); Window numbers:
@ WC_SPRITE_ALIGNER
Sprite aligner (debug); Window numbers:
@ WC_COMPANY_INFRASTRUCTURE
Company infrastructure overview; Window numbers:
@ WC_ENDSCREEN
Endscreen; Window numbers:
@ WC_COMPANY_COLOUR
Company colour selection; Window numbers:
@ WC_STATION_LIST
Station list; Window numbers:
@ WC_ROADVEH_LIST
Road vehicle list; Window numbers:
@ WC_STATUS_BAR
Statusbar (at the bottom of your screen); Window numbers:
@ WC_VEHICLE_ORDERS
Vehicle orders; Window numbers:
@ WC_SEND_NETWORK_MSG
Chatbox; Window numbers:
@ WC_ERRMSG
Error message; Window numbers:
@ WC_BUILD_TOOLBAR
Build toolbar; Window numbers:
@ WC_NETWORK_ASK_RELAY
Network ask relay window; Window numbers:
@ WC_SCRIPT_SETTINGS
Script settings; Window numbers:
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
@ WC_SCEN_LAND_GEN
Landscape generation (in Scenario Editor); Window numbers:
@ WC_SCRIPT_LIST
Scripts list; Window numbers:
@ WC_SAVE_PRESET
Save preset; Window numbers:
@ WC_SHIPS_LIST
Ships list; Window numbers:
@ WC_MESSAGE_HISTORY
News history list; Window numbers:
@ WC_CONFIRM_POPUP_QUERY
Popup with confirm question; Window numbers:
@ WC_GENERATE_LANDSCAPE
Generate landscape (newgame); Window numbers:
@ WC_CUSTOM_CURRENCY
Custom currency; Window numbers:
@ WC_MAIN_WINDOW
Main window; Window numbers:
@ WC_TRAINS_LIST
Trains list; Window numbers:
@ WC_GAME_OPTIONS
Game options window; Window numbers:
@ WC_NETWORK_WINDOW
Network window; Window numbers:
@ WC_FINANCES
Finances of a company; Window numbers:
@ WC_TEXTFILE
textfile; Window numbers:
@ WC_DROPDOWN_MENU
Drop down menu; Window numbers:
@ WC_QUERY_STRING
Query string window; Window numbers:
@ WC_SMALLMAP
Small map; Window numbers:
@ WC_BOOTSTRAP
Bootstrap; Window numbers:
@ WC_SAVELOAD
Saveload window; Window numbers:
@ WC_GRF_PARAMETERS
NewGRF parameters; Window numbers:
@ WC_MODAL_PROGRESS
Progress report of landscape generation; Window numbers:
@ WC_MAIN_TOOLBAR
Main toolbar (the long bar at the top); Window numbers:
@ WC_TOOLTIPS
Tooltip window; Window numbers:
@ WC_COMPANY
Company view; Window numbers:
@ WC_NETWORK_STATUS_WINDOW
Network status window; Window numbers:
@ WC_AIRCRAFT_LIST
Aircraft list; Window numbers:
Functions related to zooming.
int ScaleByZoom(int value, ZoomLevel zoom)
Scale by zoom level, usually shift left (when zoom > ZoomLevel::Min) When shifting right,...