OpenTTD Source 20260421-master-gc2fbc6fdeb
misc_gui.cpp
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4 * OpenTTD 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.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <https://www.gnu.org/licenses/old-licenses/gpl-2.0>.
6 */
7
9
10#include "stdafx.h"
11#include "debug.h"
12#include "landscape.h"
13#include "error.h"
14#include "gui.h"
15#include "gfx_layout.h"
16#include "tilehighlight_func.h"
17#include "command_func.h"
18#include "company_func.h"
19#include "town.h"
20#include "string_func.h"
21#include "company_base.h"
22#include "station_base.h"
23#include "waypoint_base.h"
24#include "texteff.hpp"
25#include "strings_func.h"
26#include "window_func.h"
27#include "querystring_gui.h"
29#include "newgrf_debug.h"
30#include "zoom_func.h"
31#include "viewport_func.h"
32#include "landscape_cmd.h"
33#include "station_cmd.h"
34#include "waypoint_cmd.h"
35#include "rev.h"
36#include "timer/timer.h"
37#include "timer/timer_window.h"
39
40#include "widgets/misc_widget.h"
41
42#include "table/strings.h"
43
44#include "safeguards.h"
45
46
47static constexpr std::initializer_list<NWidgetPart> _nested_land_info_widgets = {
50 NWidget(WWT_CAPTION, Colours::Grey), SetStringTip(STR_LAND_AREA_INFORMATION_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
51 NWidget(WWT_PUSHIMGBTN, Colours::Grey, WID_LI_LOCATION), SetAspect(WidgetDimensions::ASPECT_LOCATION), SetSpriteTip(SPR_GOTO_LOCATION, STR_LAND_AREA_INFORMATION_LOCATION_TOOLTIP),
55};
56
57static WindowDesc _land_info_desc(
58 WDP_AUTO, {}, 0, 0,
60 {},
61 _nested_land_info_widgets
62);
63
64class LandInfoWindow : public Window {
66 std::string cargo_acceptance{};
67
68public:
70
71 void DrawWidget(const Rect &r, WidgetID widget) const override
72 {
73 if (widget != WID_LI_BACKGROUND) return;
74
75 Rect ir = r.Shrink(WidgetDimensions::scaled.frametext);
76 for (size_t i = 0; i < this->landinfo_data.size(); i++) {
77 DrawString(ir, this->landinfo_data[i], i == 0 ? TC_LIGHT_BLUE : TC_FROMSTRING, SA_HOR_CENTER);
78 ir.top += GetCharacterHeight(FontSize::Normal) + (i == 0 ? WidgetDimensions::scaled.vsep_wide : WidgetDimensions::scaled.vsep_normal);
79 }
80
81 if (!this->cargo_acceptance.empty()) {
82 DrawStringMultiLine(ir, GetString(STR_JUST_RAW_STRING, this->cargo_acceptance), TC_FROMSTRING, SA_CENTER);
83 }
84 }
85
86 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
87 {
88 if (widget != WID_LI_BACKGROUND) return;
89
90 size.height = WidgetDimensions::scaled.frametext.Vertical();
91 for (size_t i = 0; i < this->landinfo_data.size(); i++) {
92 uint width = GetStringBoundingBox(this->landinfo_data[i]).width + WidgetDimensions::scaled.frametext.Horizontal();
93 size.width = std::max(size.width, width);
94
95 size.height += GetCharacterHeight(FontSize::Normal) + (i == 0 ? WidgetDimensions::scaled.vsep_wide : WidgetDimensions::scaled.vsep_normal);
96 }
97
98 if (!this->cargo_acceptance.empty()) {
99 uint width = GetStringBoundingBox(this->cargo_acceptance).width + WidgetDimensions::scaled.frametext.Horizontal();
100 size.width = std::max(size.width, std::min(static_cast<uint>(ScaleGUITrad(300)), width));
101 size.height += GetStringHeight(GetString(STR_JUST_RAW_STRING, this->cargo_acceptance), size.width - WidgetDimensions::scaled.frametext.Horizontal());
102 }
103 }
104
105 LandInfoWindow(Tile tile) : Window(_land_info_desc), tile(tile)
106 {
107 this->InitNested();
108
109#if defined(_DEBUG)
110# define LANDINFOD_LEVEL 0
111#else
112# define LANDINFOD_LEVEL 1
113#endif
114 Debug(misc, LANDINFOD_LEVEL, "TILE: {0} (0x{0:x}) ({1},{2})", (TileIndex)tile, TileX(tile), TileY(tile));
115 Debug(misc, LANDINFOD_LEVEL, "type = 0x{:x}", tile.type());
116 Debug(misc, LANDINFOD_LEVEL, "height = 0x{:x}", tile.height());
117 Debug(misc, LANDINFOD_LEVEL, "m1 = 0x{:x}", tile.m1());
118 Debug(misc, LANDINFOD_LEVEL, "m2 = 0x{:x}", tile.m2());
119 Debug(misc, LANDINFOD_LEVEL, "m3 = 0x{:x}", tile.m3());
120 Debug(misc, LANDINFOD_LEVEL, "m4 = 0x{:x}", tile.m4());
121 Debug(misc, LANDINFOD_LEVEL, "m5 = 0x{:x}", tile.m5());
122 Debug(misc, LANDINFOD_LEVEL, "m6 = 0x{:x}", tile.m6());
123 Debug(misc, LANDINFOD_LEVEL, "m7 = 0x{:x}", tile.m7());
124 Debug(misc, LANDINFOD_LEVEL, "m8 = 0x{:x}", tile.m8());
125
126 PrintWaterRegionDebugInfo(tile);
127#undef LANDINFOD_LEVEL
128 }
129
130 void OnInit() override
131 {
132 Town *t = ClosestTownFromTile(this->tile, _settings_game.economy.dist_local_authority);
133
134 TileDesc td{};
135 td.owner_type[0] = STR_LAND_AREA_INFORMATION_OWNER; // At least one owner is displayed, though it might be "N/A".
136
137 CargoArray acceptance{};
138 CargoTypes always_accepted{};
139 AddAcceptedCargo(this->tile, acceptance, always_accepted);
140 GetTileDesc(this->tile, td);
141
142 this->landinfo_data.clear();
143
144 /* Tiletype */
145 this->landinfo_data.push_back(GetString(td.str, td.dparam));
146
147 /* Up to four owners */
148 for (uint i = 0; i < 4; i++) {
149 if (td.owner_type[i] == STR_NULL) continue;
150
151 if (td.owner[i] == OWNER_NONE || td.owner[i] == OWNER_WATER) {
152 this->landinfo_data.push_back(GetString(td.owner_type[i], STR_LAND_AREA_INFORMATION_OWNER_N_A, std::monostate{}));
153 } else {
154 auto params = GetParamsForOwnedBy(td.owner[i], this->tile);
155 this->landinfo_data.push_back(GetStringWithArgs(td.owner_type[i], params));
156 }
157 }
158
159 /* Cost to clear/revenue when cleared */
161 if (c != nullptr) {
163 CommandCost costclear = Command<Commands::LandscapeClear>::Do(DoCommandFlag::QueryCost, this->tile);
164 if (costclear.Succeeded()) {
165 Money cost = costclear.GetCost();
166 StringID str;
167 if (cost < 0) {
168 cost = -cost; // Negate negative cost to a positive revenue
169 str = STR_LAND_AREA_INFORMATION_REVENUE_WHEN_CLEARED;
170 } else {
171 str = STR_LAND_AREA_INFORMATION_COST_TO_CLEAR;
172 }
173 this->landinfo_data.push_back(GetString(str, cost));
174 } else {
175 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_COST_TO_CLEAR_N_A));
176 }
177 } else {
178 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_COST_TO_CLEAR_N_A));
179 }
180
181 /* Location */
182 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LANDINFO_COORDS, TileX(this->tile), TileY(this->tile), GetTileZ(this->tile)));
183
184 /* Tile index */
185 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LANDINFO_INDEX, this->tile, this->tile));
186
187 /* Local authority */
188 if (t == nullptr) {
189 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LOCAL_AUTHORITY, STR_LAND_AREA_INFORMATION_LOCAL_AUTHORITY_NONE, std::monostate{}));
190 } else {
191 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LOCAL_AUTHORITY, STR_TOWN_NAME, t->index));
192 }
193
194 /* Build date */
196 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_BUILD_DATE, td.build_date));
197 }
198
199 /* Station class */
200 if (td.station_class != STR_NULL) {
201 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_STATION_CLASS, td.station_class));
202 }
203
204 /* Station type name */
205 if (td.station_name != STR_NULL) {
206 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_STATION_TYPE, td.station_name));
207 }
208
209 /* Airport class */
210 if (td.airport_class != STR_NULL) {
211 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORT_CLASS, td.airport_class));
212 }
213
214 /* Airport name */
215 if (td.airport_name != STR_NULL) {
216 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORT_NAME, td.airport_name));
217 }
218
219 /* Airport tile name */
220 if (td.airport_tile_name != STR_NULL) {
221 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORTTILE_NAME, td.airport_tile_name));
222 }
223
224 /* Rail type name */
225 if (td.railtype != STR_NULL) {
226 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_RAIL_TYPE, td.railtype));
227 }
228
229 /* Rail speed limit */
230 if (td.rail_speed != 0) {
231 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_RAIL_SPEED_LIMIT, PackVelocity(td.rail_speed, VEH_TRAIN)));
232 }
233
234 /* Road type name */
235 if (td.roadtype != STR_NULL) {
236 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_ROAD_TYPE, td.roadtype));
237 }
238
239 /* Road speed limit */
240 if (td.road_speed != 0) {
241 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_ROAD_SPEED_LIMIT, PackVelocity(td.road_speed, VEH_ROAD)));
242 }
243
244 /* Tram type name */
245 if (td.tramtype != STR_NULL) {
246 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_TRAM_TYPE, td.tramtype));
247 }
248
249 /* Tram speed limit */
250 if (td.tram_speed != 0) {
251 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_TRAM_SPEED_LIMIT, PackVelocity(td.tram_speed, VEH_ROAD)));
252 }
253
254 /* Tile protection status */
255 if (td.town_can_upgrade.has_value()) {
256 this->landinfo_data.push_back(GetString(td.town_can_upgrade.value() ? STR_LAND_AREA_INFORMATION_TOWN_CAN_UPGRADE : STR_LAND_AREA_INFORMATION_TOWN_CANNOT_UPGRADE));
257 }
258
259 /* NewGRF name */
260 if (td.grf.has_value()) {
261 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_NEWGRF_NAME, std::move(*td.grf)));
262 }
263
264 /* Cargo acceptance is displayed in a extra multiline */
265 auto line = BuildCargoAcceptanceString(acceptance, STR_LAND_AREA_INFORMATION_CARGO_ACCEPTED);
266 if (line.has_value()) {
267 this->cargo_acceptance = std::move(*line);
268 } else {
269 this->cargo_acceptance.clear();
270 }
271 }
272
273 bool IsNewGRFInspectable() const override
274 {
275 return ::IsNewGRFInspectable(GetGrfSpecFeature(this->tile), this->tile.base());
276 }
277
278 void ShowNewGRFInspectWindow() const override
279 {
280 ::ShowNewGRFInspectWindow(GetGrfSpecFeature(this->tile), this->tile.base());
281 }
282
283 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
284 {
285 switch (widget) {
286 case WID_LI_LOCATION:
287 if (_ctrl_pressed) {
288 ShowExtraViewportWindow(this->tile);
289 } else {
290 ScrollMainWindowToTile(this->tile);
291 }
292 break;
293 }
294 }
295
301 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
302 {
303 if (!gui_scope) return;
304
305 /* ReInit, "debug" sprite might have changed */
306 if (data == 1) this->ReInit();
307 }
308};
309
315{
317 new LandInfoWindow(tile);
318}
319
320static constexpr std::initializer_list<NWidgetPart> _nested_about_widgets = {
323 NWidget(WWT_CAPTION, Colours::Grey), SetStringTip(STR_ABOUT_OPENTTD, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
324 EndContainer(),
326 NWidget(WWT_LABEL, Colours::Invalid), SetStringTip(STR_ABOUT_ORIGINAL_COPYRIGHT),
327 NWidget(WWT_LABEL, Colours::Invalid), SetStringTip(STR_ABOUT_VERSION),
330 EndContainer(),
333 EndContainer(),
334};
335
336static WindowDesc _about_desc(
337 WDP_CENTER, {}, 0, 0,
339 {},
340 _nested_about_widgets
341);
342
343static const std::initializer_list<const std::string_view> _credits = {
344 "Original design by Chris Sawyer",
345 "Original graphics by Simon Foster",
346 "",
347 "The OpenTTD team (in alphabetical order):",
348 " Matthijs Kooijman (blathijs) - Pathfinder-guru, Debian port (since 0.3)",
349 " Christoph Elsenhans (frosch) - General coding (since 0.6)",
350 " Lo\u00efc Guilloux (glx) - General / Windows Expert (since 0.4.5)",
351 " Koen Bussemaker (Kuhnovic) - General / Ship pathfinder (since 14)",
352 " Charles Pigott (LordAro) - General / Correctness police (since 1.9)",
353 " Michael Lutz (michi_cc) - Path based signals (since 0.7)",
354 " Niels Martin Hansen (nielsm) - Music system, general coding (since 1.9)",
355 " Owen Rudge (orudge) - Forum host, OS/2 port (since 0.1)",
356 " Peter Nelson (peter1138) - Spiritual descendant from NewGRF gods (since 0.4.5)",
357 " Remko Bijker (Rubidium) - Coder and way more (since 0.4.5)",
358 " Patric Stout (TrueBrain) - NoProgrammer (since 0.3), sys op",
359 " Tyler Trahan (2TallTyler) - General / Time Lord (since 13)",
360 " Richard Wheeler (zephyris) - Precision pixel production (since 15)",
361 "",
362 "Inactive Developers:",
363 " Grzegorz Duczy\u0144ski (adf88) - General coding (1.7 - 1.8)",
364 " Albert Hofkamp (Alberth) - GUI expert (0.7 - 1.9)",
365 " Jean-Fran\u00e7ois Claeys (Belugas) - GUI, NewGRF and more (0.4.5 - 1.0)",
366 " Bjarni Corfitzen (Bjarni) - MacOSX port, coder and vehicles (0.3 - 0.7)",
367 " Victor Fischer (Celestar) - Programming everywhere you need him to (0.3 - 0.6)",
368 " Ulf Hermann (fonsinchen) - Cargo Distribution (1.3 - 1.6)",
369 " Jaroslav Mazanec (KUDr) - YAPG (Yet Another Pathfinder God) ;) (0.4.5 - 0.6)",
370 " Jonathan Coome (Maedhros) - High priest of the NewGRF Temple (0.5 - 0.6)",
371 " Attila B\u00e1n (MiHaMiX) - Developer WebTranslator 1 and 2 (0.3 - 0.5)",
372 " Ingo von Borstel (planetmaker) - General coding, Support (1.1 - 1.9)",
373 " Zden\u011bk Sojka (SmatZ) - Bug finder and fixer (0.6 - 1.3)",
374 " Jos\u00e9 Soler (Terkhen) - General coding (1.0 - 1.4)",
375 " Christoph Mallon (Tron) - Programmer, code correctness police (0.3 - 0.5)",
376 " Thijs Marinussen (Yexo) - AI Framework, General (0.6 - 1.3)",
377 " Leif Linse (Zuu) - AI/Game Script (1.2 - 1.6)",
378 "",
379 "Retired Developers:",
380 " Tam\u00e1s Farag\u00f3 (Darkvater) - Ex-Lead coder (0.3 - 0.5)",
381 " Dominik Scherer (dominik81) - Lead programmer, GUI expert (0.3 - 0.3)",
382 " Emil Djupfeld (egladil) - MacOSX (0.4.5 - 0.6)",
383 " Simon Sasburg (HackyKid) - Many bugfixes (0.4 - 0.4.5)",
384 " Ludvig Strigeus (ludde) - Original author of OpenTTD, main coder (0.1 - 0.3)",
385 " Cian Duffy (MYOB) - BeOS port / manual writing (0.1 - 0.3)",
386 " Petr Baudi\u0161 (pasky) - Many patches, NewGRF support (0.3 - 0.3)",
387 " Benedikt Br\u00fcggemeier (skidd13) - Bug fixer and code reworker (0.6 - 0.7)",
388 " Serge Paquet (vurlix) - 2nd contributor after ludde (0.1 - 0.3)",
389 "",
390 "Special thanks go out to:",
391 " Josef Drexler - For his great work on TTDPatch",
392 " Marcin Grzegorczyk - Track foundations and for describing TTD internals",
393 " Stefan Mei\u00dfner (sign_de) - For his work on the console",
394 " Mike Ragsdale - OpenTTD installer",
395 " Christian Rosentreter (tokai) - MorphOS / AmigaOS port",
396 " Richard Kempton (richK) - additional airports, initial TGP implementation",
397 " Alberto Demichelis - Squirrel scripting language \u00a9 2003-2008",
398 " L. Peter Deutsch - MD5 implementation \u00a9 1999, 2000, 2002",
399 " Michael Blunck - Pre-signals and semaphores \u00a9 2003",
400 " George - Canal/Lock graphics \u00a9 2003-2004",
401 " Andrew Parkhouse (andythenorth) - River graphics",
402 " David Dallaston (Pikka) - Tram tracks",
403 " All Translators - Who made OpenTTD a truly international game",
404 " Bug Reporters - Without whom OpenTTD would still be full of bugs!",
405 "",
406 "",
407 "And last but not least:",
408 " Chris Sawyer - For an amazing game!"
409};
410
411struct AboutWindow : public Window {
413 int line_height = 0;
414 static const int num_visible_lines = 19;
415
416 AboutWindow() : Window(_about_desc)
417 {
419
420 this->text_position = this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y + this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->current_y;
421 }
422
423 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
424 {
425 if (widget == WID_A_WEBSITE) return "Website: https://www.openttd.org";
426 if (widget == WID_A_COPYRIGHT) return GetString(STR_ABOUT_COPYRIGHT_OPENTTD, _openttd_revision_year);
427 return this->Window::GetWidgetString(widget, stringid);
428 }
429
430 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
431 {
432 if (widget != WID_A_SCROLLING_TEXT) return;
433
434 this->line_height = GetCharacterHeight(FontSize::Normal);
435
436 Dimension d;
437 d.height = this->line_height * num_visible_lines;
438
439 d.width = 0;
440 for (const auto &str : _credits) {
441 d.width = std::max(d.width, GetStringBoundingBox(str).width);
442 }
443 size = maxdim(size, d);
444 }
445
446 void DrawWidget(const Rect &r, WidgetID widget) const override
447 {
448 if (widget != WID_A_SCROLLING_TEXT) return;
449
450 int y = this->text_position;
451
452 /* Show all scrolling _credits */
453 for (const auto &str : _credits) {
454 if (y >= r.top + 7 && y < r.bottom - this->line_height) {
455 DrawString(r.left, r.right, y, str, TC_BLACK, SA_LEFT | SA_FORCE);
456 }
457 y += this->line_height;
458 }
459 }
460
466 const IntervalTimer<TimerWindow> scroll_interval = {std::chrono::milliseconds(2100) / GetCharacterHeight(FontSize::Normal), [this](uint count) {
467 this->text_position -= count;
468 /* If the last text has scrolled start a new from the start */
469 if (this->text_position < (int)(this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y - std::size(_credits) * this->line_height)) {
470 this->text_position = this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y + this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->current_y;
471 }
473 }};
474};
475
476void ShowAboutWindow()
477{
479 new AboutWindow();
480}
481
488void ShowEstimatedCostOrIncome(Money cost, int x, int y)
489{
490 StringID msg = STR_MESSAGE_ESTIMATED_COST;
491
492 if (cost < 0) {
493 cost = -cost;
494 msg = STR_MESSAGE_ESTIMATED_INCOME;
495 }
496 ShowErrorMessage(GetEncodedString(msg, cost), {}, WL_INFO, x, y);
497}
498
506void ShowCostOrIncomeAnimation(int x, int y, int z, Money cost)
507{
508 if (cost == 0) {
509 return;
510 }
511 Point pt = RemapCoords(x, y, z);
512 StringID msg = STR_INCOME_FLOAT_COST;
513
514 if (cost < 0) {
515 cost = -cost;
516 msg = STR_INCOME_FLOAT_INCOME;
517 }
518 AddTextEffect(GetEncodedString(msg, cost), pt.x, pt.y, Ticks::DAY_TICKS, TE_RISING);
519}
520
529void ShowFeederIncomeAnimation(int x, int y, int z, Money transfer, Money income)
530{
531 Point pt = RemapCoords(x, y, z);
532
533 if (income == 0) {
534 AddTextEffect(GetEncodedString(STR_FEEDER, transfer), pt.x, pt.y, Ticks::DAY_TICKS, TE_RISING);
535 } else {
536 StringID msg = STR_FEEDER_COST;
537 if (income < 0) {
538 income = -income;
539 msg = STR_FEEDER_INCOME;
540 }
541 AddTextEffect(GetEncodedString(msg, transfer, income), pt.x, pt.y, Ticks::DAY_TICKS, TE_RISING);
542 }
543}
544
554TextEffectID ShowFillingPercent(int x, int y, int z, uint8_t percent, StringID string)
555{
556 Point pt = RemapCoords(x, y, z);
557
558 assert(string != STR_NULL);
559
560 return AddTextEffect(GetEncodedString(string, percent), pt.x, pt.y, 0, TE_STATIC);
561}
562
569void UpdateFillingPercent(TextEffectID te_id, uint8_t percent, StringID string)
570{
571 assert(string != STR_NULL);
572
573 UpdateTextEffect(te_id, GetEncodedString(string, percent));
574}
575
580void HideFillingPercent(TextEffectID *te_id)
581{
582 if (*te_id == INVALID_TE_ID) return;
583
584 RemoveTextEffect(*te_id);
585 *te_id = INVALID_TE_ID;
586}
587
588static constexpr std::initializer_list<NWidgetPart> _nested_tooltips_widgets = {
590};
591
592static WindowDesc _tool_tips_desc(
593 WDP_MANUAL, {}, 0, 0, // Coordinates and sizes are not used,
596 _nested_tooltips_widgets
597);
598
600struct TooltipsWindow : public Window
601{
603 TooltipCloseCondition close_cond{};
604
605 TooltipsWindow(Window *parent, EncodedString &&text, TooltipCloseCondition close_tooltip) : Window(_tool_tips_desc), text(std::move(text))
606 {
607 this->parent = parent;
608 this->close_cond = close_tooltip;
609
610 this->InitNested();
611
613 }
614
615 Point OnInitialPosition([[maybe_unused]] int16_t sm_width, [[maybe_unused]] int16_t sm_height, [[maybe_unused]] int window_number) override
616 {
617 /* Find the free screen space between the main toolbar at the top, and the statusbar at the bottom.
618 * Add a fixed distance 2 so the tooltip floats free from both bars.
619 */
620 int scr_top = GetMainViewTop() + 2;
621 int scr_bot = GetMainViewBottom() - 2;
622
623 Point pt;
624
625 /* Correctly position the tooltip position, watch out for window and cursor size
626 * Clamp value to below main toolbar and above statusbar. If tooltip would
627 * go below window, flip it so it is shown above the cursor */
628 pt.y = SoftClamp(_cursor.pos.y + _cursor.total_size.y + _cursor.total_offs.y + 5, scr_top, scr_bot);
629 if (pt.y + sm_height > scr_bot) pt.y = std::min(_cursor.pos.y + _cursor.total_offs.y - 5, scr_bot) - sm_height;
630 pt.x = sm_width >= _screen.width ? 0 : SoftClamp(_cursor.pos.x - (sm_width >> 1), 0, _screen.width - sm_width);
631
632 return pt;
633 }
634
635 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
636 {
637 if (widget != WID_TT_BACKGROUND) return;
638
639 auto str = this->text.GetDecodedString();
640 size.width = std::min<uint>(GetStringBoundingBox(str).width, ScaleGUITrad(194));
641 size.height = GetStringHeight(str, size.width);
642
643 /* Increase slightly to have some space around the box. */
644 size.width += WidgetDimensions::scaled.framerect.Horizontal() + WidgetDimensions::scaled.fullbevel.Horizontal();
645 size.height += WidgetDimensions::scaled.framerect.Vertical() + WidgetDimensions::scaled.fullbevel.Vertical();
646 }
647
648 void DrawWidget(const Rect &r, WidgetID widget) const override
649 {
650 if (widget != WID_TT_BACKGROUND) return;
653
654 DrawStringMultiLine(r.Shrink(WidgetDimensions::scaled.framerect).Shrink(WidgetDimensions::scaled.fullbevel), this->text.GetDecodedString(), TC_BLACK, SA_CENTER);
655 }
656
657 void OnMouseLoop() override
658 {
659 /* Always close tooltips when the cursor is not in our window. */
660 if (!_cursor.in_window) {
661 this->Close();
662 return;
663 }
664
665 /* We can show tooltips while dragging tools. These are shown as long as
666 * we are dragging the tool. Normal tooltips work with hover or rmb. */
667 switch (this->close_cond) {
668 case TCC_RIGHT_CLICK: if (!_right_button_down) this->Close(); break;
669 case TCC_HOVER: if (!_mouse_hovering) this->Close(); break;
670 case TCC_NONE: break;
671
672 case TCC_EXIT_VIEWPORT: {
673 Window *w = FindWindowFromPt(_cursor.pos.x, _cursor.pos.y);
674 if (w == nullptr || IsPtInWindowViewport(w, _cursor.pos.x, _cursor.pos.y) == nullptr) this->Close();
675 break;
676 }
677 }
678 }
679};
680
687void GuiShowTooltips(Window *parent, EncodedString &&text, TooltipCloseCondition close_tooltip)
688{
690
691 if (text.empty() || !_cursor.in_window) return;
692
693 new TooltipsWindow(parent, std::move(text), close_tooltip);
694}
695
696void QueryString::HandleEditBox(Window *w, WidgetID wid)
697{
698 if (w->IsWidgetGloballyFocused(wid) && this->text.HandleCaret()) {
699 w->SetWidgetDirty(wid);
700
701 /* For the OSK also invalidate the parent window */
702 if (w->window_class == WC_OSK) w->InvalidateData();
703 }
704}
705
706static int GetCaretWidth()
707{
709}
710
718{
719 const int linewidth = tb.pixels + GetCaretWidth();
720 const int boxwidth = r.Width();
721 if (linewidth <= boxwidth) return r;
722
723 /* Extend to cover whole string. This is left-aligned, adjusted by caret position. */
724 r = r.WithWidth(linewidth, false);
725
726 /* Slide so that the caret is at the centre unless limited by bounds of the line, i.e. near either end. */
727 return r.Translate(-std::clamp(tb.caretxoffs - (boxwidth / 2), 0, linewidth - boxwidth), 0);
728}
729
730void QueryString::DrawEditBox(const Window *w, WidgetID wid) const
731{
732 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
733
734 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
735
736 bool rtl = _current_text_dir == TD_RTL;
737 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
738 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
739
740 Rect r = wi->GetCurrentRect();
741 Rect cr = r.WithWidth(clearbtn_width, !rtl);
742 Rect fr = r.Indent(clearbtn_width, !rtl);
743
744 DrawFrameRect(cr, wi->colour, wi->IsLowered() ? FrameFlag::Lowered : FrameFlags{});
745 DrawSpriteIgnorePadding(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT, PAL_NONE, cr, SA_CENTER);
746 if (this->text.GetText().empty()) GfxFillRect(cr.Shrink(WidgetDimensions::scaled.bevel), GetColourGradient(wi->colour, SHADE_DARKER), FILLRECT_CHECKER);
747
748 DrawFrameRect(fr, wi->colour, {FrameFlag::Lowered, FrameFlag::Darkened});
750
751 fr = fr.Shrink(WidgetDimensions::scaled.framerect);
752 /* Limit the drawing of the string inside the widget boundaries */
753 DrawPixelInfo dpi;
754 if (!FillDrawPixelInfo(&dpi, fr)) return;
755 /* Keep coordinates relative to the window. */
756 dpi.left += fr.left;
757 dpi.top += fr.top;
758
759 AutoRestoreBackup dpi_backup(_cur_dpi, &dpi);
760
761 /* We will take the current widget length as maximum width, with a small
762 * space reserved at the end for the caret to show */
763 const Textbuf *tb = &this->text;
764 fr = ScrollEditBoxTextRect(fr, *tb);
765
766 /* If we have a marked area, draw a background highlight. */
767 if (tb->marklength != 0) GfxFillRect(fr.left + tb->markxoffs, fr.top, fr.left + tb->markxoffs + tb->marklength - 1, fr.bottom, PC_GREY);
768
769 DrawString(fr.left, fr.right, CentreBounds(fr.top, fr.bottom, GetCharacterHeight(FontSize::Normal)), tb->GetText(), TC_YELLOW);
770 bool focussed = w->IsWidgetGloballyFocused(wid) || IsOSKOpenedFor(w, wid);
771 if (focussed && tb->caret) {
772 int caret_width = GetCaretWidth();
773 if (rtl) {
774 DrawString(fr.right - tb->pixels + tb->caretxoffs - caret_width, fr.right - tb->pixels + tb->caretxoffs, CentreBounds(fr.top, fr.bottom, GetCharacterHeight(FontSize::Normal)), "_", TC_WHITE);
775 } else {
776 DrawString(fr.left + tb->caretxoffs, fr.left + tb->caretxoffs + caret_width, CentreBounds(fr.top, fr.bottom, GetCharacterHeight(FontSize::Normal)), "_", TC_WHITE);
777 }
778 }
779}
780
788{
789 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
790
791 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
792
793 bool rtl = _current_text_dir == TD_RTL;
794 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
795 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
796
797 Rect r = wi->GetCurrentRect().Indent(clearbtn_width, !rtl).Shrink(WidgetDimensions::scaled.framerect);
798
799 /* Clamp caret position to be inside out current width. */
800 const Textbuf *tb = &this->text;
801 r = ScrollEditBoxTextRect(r, *tb);
802
803 Point pt = {r.left + tb->caretxoffs, r.top};
804 return pt;
805}
806
815Rect QueryString::GetBoundingRect(const Window *w, WidgetID wid, size_t from, size_t to) const
816{
817 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
818
819 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
820
821 bool rtl = _current_text_dir == TD_RTL;
822 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
823 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
824
825 Rect r = wi->GetCurrentRect().Indent(clearbtn_width, !rtl).Shrink(WidgetDimensions::scaled.framerect);
826
827 /* Clamp caret position to be inside our current width. */
828 const Textbuf *tb = &this->text;
829 r = ScrollEditBoxTextRect(r, *tb);
830
831 /* Get location of first and last character. */
832 const auto p1 = GetCharPosInString(tb->GetText(), from, FontSize::Normal);
833 const auto p2 = from != to ? GetCharPosInString(tb->GetText(), to, FontSize::Normal) : p1;
834
835 return r.WithX(Clamp(r.left + p1.left, r.left, r.right), Clamp(r.left + p2.right, r.left, r.right));
836}
837
845ptrdiff_t QueryString::GetCharAtPosition(const Window *w, WidgetID wid, const Point &pt) const
846{
847 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
848
849 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
850
851 bool rtl = _current_text_dir == TD_RTL;
852 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
853 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
854
855 Rect r = wi->GetCurrentRect().Indent(clearbtn_width, !rtl).Shrink(WidgetDimensions::scaled.framerect);
856
857 if (!IsInsideMM(pt.y, r.top, r.bottom)) return -1;
858
859 /* Clamp caret position to be inside our current width. */
860 const Textbuf *tb = &this->text;
861 r = ScrollEditBoxTextRect(r, *tb);
862
863 return ::GetCharAtPosition(tb->GetText(), pt.x - r.left);
864}
865
866void QueryString::ClickEditBox(Window *w, Point pt, WidgetID wid, int click_count, bool focus_changed)
867{
868 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
869
870 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
871
872 bool rtl = _current_text_dir == TD_RTL;
873 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
874 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
875
876 Rect cr = wi->GetCurrentRect().WithWidth(clearbtn_width, !rtl);
877
878 if (IsInsideMM(pt.x, cr.left, cr.right)) {
879 if (!this->text.GetText().empty()) {
880 this->text.DeleteAll();
881 w->HandleButtonClick(wid);
882 w->OnEditboxChanged(wid);
883 }
884 return;
885 }
886
890 /* Open the OSK window */
891 ShowOnScreenKeyboard(w, wid);
892 }
893}
894
896struct QueryStringWindow : public Window
897{
899 QueryStringFlags flags{};
900
902
903 QueryStringWindow(std::string_view str, StringID caption, uint max_bytes, uint max_chars, WindowDesc &desc, Window *parent, CharSetFilter afilter, QueryStringFlags flags) :
904 Window(desc), editbox(max_bytes, max_chars)
905 {
906 this->editbox.text.Assign(str);
907
908 if (!flags.Test(QueryStringFlag::AcceptUnchanged)) this->editbox.orig = this->editbox.text.GetText();
909
910 this->querystrings[WID_QS_TEXT] = &this->editbox;
911 this->editbox.caption = caption;
912 this->editbox.cancel_button = WID_QS_CANCEL;
913 this->editbox.ok_button = WID_QS_OK;
914 this->editbox.text.afilter = afilter;
915 this->flags = flags;
916
917 this->CreateNestedTree();
919 this->GetWidget<NWidgetStacked>(WID_QS_MOVE_SEL)->SetDisplayedPlane((this->flags.Test(QueryStringFlag::EnableMove)) ? 0 : SZSP_NONE);
920 this->FinishInitNested(WN_QUERY_STRING);
921
922 this->parent = parent;
923
924 this->SetFocusedWidget(WID_QS_TEXT);
925 }
926
927 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
928 {
929 if (widget == WID_QS_CAPTION) return GetString(this->editbox.caption);
930
931 return this->Window::GetWidgetString(widget, stringid);
932 }
933
934 void OnOk()
935 {
936 if (!this->editbox.orig.has_value() || this->editbox.text.GetText() != this->editbox.orig) {
937 assert(this->parent != nullptr);
938
939 this->parent->OnQueryTextFinished(std::string{this->editbox.text.GetText()});
940 this->editbox.handled = true;
941 }
942 }
943
944 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
945 {
946 switch (widget) {
947 case WID_QS_DEFAULT:
948 this->editbox.text.DeleteAll();
949 [[fallthrough]];
950
951 case WID_QS_OK:
952 this->OnOk();
953 [[fallthrough]];
954
955 case WID_QS_CANCEL:
956 this->Close();
957 break;
958
959 case WID_QS_MOVE:
960 this->last_user_action = widget;
961
962 if (Station::IsExpected(Station::Get(this->parent->window_number))) {
963 /* this is a station */
964 SetViewportStationRect(Station::Get(this->parent->window_number), !this->IsWidgetLowered(WID_QS_MOVE));
965 } else {
966 /* this is a waypoint */
967 SetViewportWaypointRect(Waypoint::Get(this->parent->window_number), !this->IsWidgetLowered(WID_QS_MOVE));
968 }
969
970 HandlePlacePushButton(this, WID_QS_MOVE, SPR_CURSOR_SIGN, HT_RECT);
971 break;
972 }
973 }
974
975 void OnPlaceObject([[maybe_unused]] Point pt, TileIndex tile) override
976 {
977 switch (this->last_user_action) {
978 case WID_QS_MOVE: // Move name button
979 if (Station::IsExpected(Station::Get(this->parent->window_number))) {
980 /* this is a station */
981 Command<Commands::MoveStationName>::Post(STR_ERROR_CAN_T_MOVE_STATION_NAME, CcMoveStationName, this->parent->window_number, tile);
982 } else {
983 /* this is a waypoint */
984 Command<Commands::MoveWaypointNAme>::Post(STR_ERROR_CAN_T_MOVE_WAYPOINT_NAME, CcMoveWaypointName, this->parent->window_number, tile);
985 }
986 break;
987
988 default: NOT_REACHED();
989 }
990 }
991
992 void OnPlaceObjectAbort() override
993 {
994 if (Station::IsExpected(Station::Get(this->parent->window_number))) {
995 /* this is a station */
996 SetViewportStationRect(Station::Get(this->parent->window_number), false);
997 } else {
998 /* this is a waypoint */
999 SetViewportWaypointRect(Waypoint::Get(this->parent->window_number), false);
1000 }
1001
1002 this->RaiseButtons();
1003 }
1004
1005 void Close([[maybe_unused]] int data = 0) override
1006 {
1007 if (this->parent != nullptr) {
1008 if (this->parent->window_class == WC_STATION_VIEW) SetViewportStationRect(Station::Get(this->parent->window_number), false);
1009 if (this->parent->window_class == WC_WAYPOINT_VIEW) SetViewportWaypointRect(Waypoint::Get(this->parent->window_number), false);
1010
1011 if (!this->editbox.handled) {
1012 Window *parent = this->parent;
1013 this->parent = nullptr; // so parent doesn't try to close us again
1014 parent->OnQueryTextFinished(std::nullopt);
1015 }
1016 }
1017
1018 this->Window::Close();
1019 }
1020};
1021
1022static constexpr std::initializer_list<NWidgetPart> _nested_query_string_widgets = {
1026 EndContainer(),
1029 EndContainer(),
1032 NWidget(WWT_TEXTBTN, Colours::Grey, WID_QS_DEFAULT), SetMinimalSize(65, 12), SetFill(1, 1), SetStringTip(STR_BUTTON_DEFAULT),
1033 EndContainer(),
1034 NWidget(WWT_TEXTBTN, Colours::Grey, WID_QS_CANCEL), SetMinimalSize(65, 12), SetFill(1, 1), SetStringTip(STR_BUTTON_CANCEL),
1037 NWidget(WWT_TEXTBTN, Colours::Grey, WID_QS_MOVE), SetMinimalSize(65, 12), SetFill(1, 1), SetStringTip(STR_BUTTON_MOVE),
1038 EndContainer(),
1039 EndContainer(),
1040};
1041
1042static WindowDesc _query_string_desc(
1043 WDP_CENTER, {}, 0, 0,
1045 {},
1046 _nested_query_string_widgets
1047);
1048
1058void ShowQueryString(std::string_view str, StringID caption, uint maxsize, Window *parent, CharSetFilter afilter, QueryStringFlags flags)
1059{
1060 assert(parent != nullptr);
1061
1063 new QueryStringWindow(str, caption, (flags.Test(QueryStringFlag::LengthIsInChars) ? MAX_CHAR_LENGTH : 1) * maxsize, maxsize, _query_string_desc, parent, afilter, flags);
1064}
1065
1070void UpdateQueryStringDefault(std::string_view str)
1071{
1073 if (w != nullptr) w->editbox.orig = str;
1074}
1075
1079struct QueryWindow : public Window {
1083
1085 : Window(desc), proc(callback), caption(std::move(caption)), message(std::move(message))
1086 {
1087 this->parent = parent;
1088
1089 this->CreateNestedTree();
1091 }
1092
1093 void Close([[maybe_unused]] int data = 0) override
1094 {
1095 if (this->proc != nullptr) this->proc(this->parent, false);
1096 this->Window::Close();
1097 }
1098
1099 void FindWindowPlacementAndResize(int, int, bool) override
1100 {
1101 /* Position query window over the calling window, ensuring it's within screen bounds. */
1102 this->left = SoftClamp(parent->left + (parent->width / 2) - (this->width / 2), 0, _screen.width - this->width);
1103 this->top = SoftClamp(parent->top + (parent->height / 2) - (this->height / 2), 0, _screen.height - this->height);
1104 this->SetDirty();
1105 }
1106
1107 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
1108 {
1109 switch (widget) {
1110 case WID_Q_CAPTION:
1111 return this->caption.GetDecodedString();
1112
1113 default:
1114 return this->Window::GetWidgetString(widget, stringid);
1115 }
1116 }
1117
1118 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
1119 {
1120 if (widget != WID_Q_TEXT) return;
1121
1122 size = GetStringMultiLineBoundingBox(this->message.GetDecodedString(), size);
1123 }
1124
1125 void DrawWidget(const Rect &r, WidgetID widget) const override
1126 {
1127 if (widget != WID_Q_TEXT) return;
1128
1129 DrawStringMultiLine(r, this->message.GetDecodedString(), TC_FROMSTRING, SA_CENTER);
1130 }
1131
1132 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
1133 {
1134 switch (widget) {
1135 case WID_Q_YES: {
1136 /* in the Generate New World window, clicking 'Yes' causes
1137 * CloseNonVitalWindows() to be called - we shouldn't be in a window then */
1138 QueryCallbackProc *proc = this->proc;
1139 Window *parent = this->parent;
1140 /* Prevent the destructor calling the callback function */
1141 this->proc = nullptr;
1142 this->Close();
1143 if (proc != nullptr) {
1144 proc(parent, true);
1145 proc = nullptr;
1146 }
1147 break;
1148 }
1149 case WID_Q_NO:
1150 this->Close();
1151 break;
1152 }
1153 }
1154
1155 EventState OnKeyPress([[maybe_unused]] char32_t key, uint16_t keycode) override
1156 {
1157 /* ESC closes the window, Enter confirms the action */
1158 switch (keycode) {
1159 case WKC_RETURN:
1160 case WKC_NUM_ENTER:
1161 if (this->proc != nullptr) {
1162 this->proc(this->parent, true);
1163 this->proc = nullptr;
1164 }
1165 [[fallthrough]];
1166
1167 case WKC_ESC:
1168 this->Close();
1169 return ES_HANDLED;
1170 }
1171 return ES_NOT_HANDLED;
1172 }
1173};
1174
1175static constexpr std::initializer_list<NWidgetPart> _nested_query_widgets = {
1179 EndContainer(),
1186 EndContainer(),
1187 EndContainer(),
1188 EndContainer(),
1189};
1190
1191static WindowDesc _query_desc(
1192 WDP_CENTER, {}, 0, 0,
1195 _nested_query_widgets
1196);
1197
1208void ShowQuery(EncodedString &&caption, EncodedString &&message, Window *parent, QueryCallbackProc *callback, bool focus)
1209{
1210 if (parent == nullptr) parent = GetMainWindow();
1211
1212 for (Window *w : Window::Iterate()) {
1213 if (w->window_class != WC_CONFIRM_POPUP_QUERY) continue;
1214
1215 QueryWindow *qw = dynamic_cast<QueryWindow *>(w);
1216 assert(qw != nullptr);
1217 if (qw->parent != parent || qw->proc != callback) continue;
1218
1219 qw->Close();
1220 break;
1221 }
1222
1223 QueryWindow *q = new QueryWindow(_query_desc, std::move(caption), std::move(message), parent, callback);
1224 if (focus) SetFocusedWindow(q);
1225}
std::optional< std::string > BuildCargoAcceptanceString(const CargoArray &acceptance, StringID label)
Build comma-separated cargo acceptance string.
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
constexpr Timpl & Reset()
Reset all bits.
Common return value for all commands.
bool Succeeded() const
Did this command succeed?
Money GetCost() const
The costs as made up to this moment.
Container for an encoded string, created by GetEncodedString.
std::string GetDecodedString() const
Decode the encoded string.
Definition strings.cpp:207
An interval timer will fire every interval, and will continue to fire until it is deleted.
Definition timer.h:76
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
Definition misc_gui.cpp:71
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
Definition misc_gui.cpp:301
StringList landinfo_data
Info lines to show.
Definition misc_gui.cpp:65
std::string cargo_acceptance
Centered multi-line string for cargo acceptance.
Definition misc_gui.cpp:66
bool IsNewGRFInspectable() const override
Is the data related to this window NewGRF inspectable?
Definition misc_gui.cpp:273
void OnInit() override
Notification that the nested widget tree gets initialized.
Definition misc_gui.cpp:130
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
Definition misc_gui.cpp:283
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
Definition misc_gui.cpp:86
void ShowNewGRFInspectWindow() const override
Show the NewGRF inspection window.
Definition misc_gui.cpp:278
WidgetType type
Type of the widget / nested widget.
Colours colour
Colour of this widget.
bool IsLowered() const
Return whether the widget is lowered.
Leaf widget.
Stacked widgets, widgets all occupying the same space in the window.
bool SetDisplayedPlane(int plane)
Select which plane to show (for NWID_SELECTION only).
Definition widget.cpp:1453
static constexpr TimerGameTick::Ticks DAY_TICKS
1 day is 74 ticks; TimerGameCalendar::date_fract used to be uint16_t and incremented by 885.
Wrapper class to abstract away the way the tiles are stored.
Definition map_func.h:25
static constexpr TimerGame< struct Calendar >::Date INVALID_DATE
static WidgetDimensions scaled
Widget dimensions scaled for current zoom level.
Definition window_gui.h:30
RectPadding imgbtn
Padding around image button image.
Definition window_gui.h:34
static const WidgetDimensions unscaled
Unscaled widget dimensions.
Definition window_gui.h:93
RectPadding bevel
Bevel thickness, affected by "scaled bevels" game option.
Definition window_gui.h:38
Functions related to commands.
@ QueryCost
query cost only, don't build.
Definition of stuff that is very close to a company, like the company struct itself.
std::array< StringParameter, 2 > GetParamsForOwnedBy(Owner owner, TileIndex tile)
Get the right StringParameters for STR_ERROR_OWNED_BY.
CompanyID _local_company
Company controlled by the human player at this client. Can also be COMPANY_SPECTATOR.
CompanyID _current_company
Company currently doing an action.
Functions related to companies.
static constexpr Owner OWNER_NONE
The tile has no ownership.
static constexpr Owner OWNER_WATER
The tile/execution is done by "water".
Functions related to debugging.
#define Debug(category, level, format_string,...)
Output a line of debugging information.
Definition debug.h:37
Functions related to errors.
@ WL_INFO
Used for DoCommand-like (and some non-fatal AI GUI) errors/information.
Definition error.h:24
void ShowErrorMessage(EncodedString &&summary_msg, int x, int y, CommandCost &cc)
Display an error message in a window.
int GetCharacterHeight(FontSize size)
Get height of a character for a given font size.
Definition fontcache.cpp:88
Dimension maxdim(const Dimension &d1, const Dimension &d2)
Compute bounding box of both dimensions.
Geometry functions.
int CentreBounds(int min, int max, int size)
Determine where to position a centred object.
int GetStringHeight(std::string_view str, int maxw, FontSize fontsize)
Calculates height of string (in pixels).
Definition gfx.cpp:717
Dimension GetStringBoundingBox(std::string_view str, FontSize start_fontsize)
Return the string dimension in pixels.
Definition gfx.cpp:900
int DrawString(int left, int right, int top, std::string_view str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly truncated to make it fit in its allocated space.
Definition gfx.cpp:669
bool _ctrl_pressed
Is Ctrl pressed?
Definition gfx.cpp:39
uint8_t GetCharacterWidth(FontSize size, char32_t key)
Return width of character glyph.
Definition gfx.cpp:1278
Dimension GetStringMultiLineBoundingBox(StringID str, const Dimension &suggestion)
Calculate string bounding box for multi-line strings.
Definition gfx.cpp:753
int DrawStringMultiLine(int left, int right, int top, int bottom, std::string_view str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly over multiple lines.
Definition gfx.cpp:788
void GfxFillRect(int left, int top, int right, int bottom, const std::variant< PixelColour, PaletteID > &colour, FillRectMode mode)
Applies a certain FillRectMode-operation to a rectangle [left, right] x [top, bottom] on the screen.
Definition gfx.cpp:116
bool FillDrawPixelInfo(DrawPixelInfo *n, int left, int top, int width, int height)
Set up a clipping area for only drawing into a certain area.
Definition gfx.cpp:1573
bool _right_button_down
Is right mouse button pressed?
Definition gfx.cpp:44
Dimension GetScaledSpriteSize(SpriteID sprid)
Scale sprite size for GUI.
Definition widget.cpp:70
ParagraphLayouter::Position GetCharPosInString(std::string_view str, size_t pos, FontSize start_fontsize)
Get the leading corner of a character in a single-line string relative to the start of the string.
Functions related to laying out the texts.
@ Normal
Index of the normal font in the font tables.
Definition gfx_type.h:249
@ SA_LEFT
Left align the text.
Definition gfx_type.h:388
@ SA_HOR_CENTER
Horizontally center the text.
Definition gfx_type.h:389
@ SA_FORCE
Force the alignment, i.e. don't swap for RTL languages.
Definition gfx_type.h:400
@ SA_CENTER
Center both horizontally and vertically.
Definition gfx_type.h:398
@ Invalid
Invalid marker.
Definition gfx_type.h:302
@ Yellow
Yellow.
Definition gfx_type.h:288
@ Grey
Grey.
Definition gfx_type.h:299
@ Red
Red.
Definition gfx_type.h:289
@ FILLRECT_CHECKER
Draw only every second pixel, used for greying-out.
Definition gfx_type.h:346
constexpr NWidgetPart SetFill(uint16_t fill_x, uint16_t fill_y)
Widget part function for setting filling.
constexpr NWidgetPart SetSpriteTip(SpriteID sprite, StringID tip={})
Widget part function for setting the sprite and tooltip.
constexpr NWidgetPart SetPIP(uint8_t pre, uint8_t inter, uint8_t post)
Widget part function for setting a pre/inter/post spaces.
constexpr NWidgetPart SetPadding(uint8_t top, uint8_t right, uint8_t bottom, uint8_t left)
Widget part function for setting additional space around a widget.
constexpr NWidgetPart SetStringTip(StringID string, StringID tip={})
Widget part function for setting the string and tooltip.
constexpr NWidgetPart SetAspect(float ratio, AspectFlags flags=AspectFlag::ResizeX)
Widget part function for setting the aspect ratio.
constexpr NWidgetPart SetMinimalSize(int16_t x, int16_t y)
Widget part function for setting the minimal size.
constexpr NWidgetPart EndContainer()
Widget part function for denoting the end of a container (horizontal, vertical, WWT_FRAME,...
constexpr NWidgetPart SetTextStyle(TextColour colour, FontSize size=FontSize::Normal)
Widget part function for setting the text style.
constexpr NWidgetPart NWidget(WidgetType tp, Colours col, WidgetID idx=INVALID_WIDGET)
Widget part function for starting a new 'real' widget.
void SetDirty() const
Mark entire window as dirty (in need of re-paint).
Definition window.cpp:980
GUI functions that shouldn't be here.
void ShowExtraViewportWindow(TileIndex tile=INVALID_TILE)
Show a new Extra Viewport window.
Functions related to OTTD's landscape.
Point RemapCoords(int x, int y, int z)
Map 3D world or tile coordinate to equivalent 2D coordinate as used in the viewports and smallmap.
Definition landscape.h:81
Command definitions related to landscape (slopes etc.).
#define Rect
Macro that prevents name conflicts between included headers.
#define Point
Macro that prevents name conflicts between included headers.
bool HandlePlacePushButton(Window *w, WidgetID widget, CursorID cursor, HighLightStyle mode)
This code is shared for the majority of the pushbuttons.
Definition main_gui.cpp:63
static uint TileY(TileIndex tile)
Get the Y component of a tile.
Definition map_func.h:429
static uint TileX(TileIndex tile)
Get the X component of a tile.
Definition map_func.h:419
constexpr bool IsInsideMM(const size_t x, const size_t min, const size_t max) noexcept
Checks if a value is in an interval.
constexpr T SoftClamp(const T a, const T min, const T max)
Clamp a value between an interval.
constexpr T Clamp(const T a, const T min, const T max)
Clamp a value between an interval.
Definition math_func.hpp:79
void GuiShowTooltips(Window *parent, EncodedString &&text, TooltipCloseCondition close_tooltip)
Shows a tooltip.
Definition misc_gui.cpp:687
void ShowQuery(EncodedString &&caption, EncodedString &&message, Window *parent, QueryCallbackProc *callback, bool focus)
Show a confirmation window with standard 'yes' and 'no' buttons The window is aligned to the centre o...
void HideFillingPercent(TextEffectID *te_id)
Hide vehicle loading indicators.
Definition misc_gui.cpp:580
void ShowCostOrIncomeAnimation(int x, int y, int z, Money cost)
Display animated income or costs on the map.
Definition misc_gui.cpp:506
void ShowEstimatedCostOrIncome(Money cost, int x, int y)
Display estimated costs.
Definition misc_gui.cpp:488
void ShowLandInfo(TileIndex tile)
Show land information window.
Definition misc_gui.cpp:314
void ShowFeederIncomeAnimation(int x, int y, int z, Money transfer, Money income)
Display animated feeder income.
Definition misc_gui.cpp:529
void ShowQueryString(std::string_view str, StringID caption, uint maxsize, Window *parent, CharSetFilter afilter, QueryStringFlags flags)
Show a query popup window with a textbox in it.
void UpdateFillingPercent(TextEffectID te_id, uint8_t percent, StringID string)
Update vehicle loading indicators.
Definition misc_gui.cpp:569
TextEffectID ShowFillingPercent(int x, int y, int z, uint8_t percent, StringID string)
Display vehicle loading indicators.
Definition misc_gui.cpp:554
void UpdateQueryStringDefault(std::string_view str)
Updates default text value of query strign window.
static Rect ScrollEditBoxTextRect(Rect r, const Textbuf &tb)
Reposition edit text box rect based on textbuf length can caret position.
Definition misc_gui.cpp:717
Types related to the misc widgets.
@ WID_TT_BACKGROUND
Background of the window.
Definition misc_widget.h:21
@ WID_QS_MOVE_SEL
Container for move button, which can be hidden.
Definition misc_widget.h:40
@ WID_QS_DEFAULT
Default button.
Definition misc_widget.h:35
@ WID_QS_CAPTION
Caption of the window.
Definition misc_widget.h:33
@ WID_QS_TEXT
Text of the query.
Definition misc_widget.h:34
@ WID_QS_MOVE
Move button.
Definition misc_widget.h:39
@ WID_QS_CANCEL
Cancel button.
Definition misc_widget.h:37
@ WID_QS_DEFAULT_SEL
Container for default button, which can be hidden.
Definition misc_widget.h:36
@ WID_QS_OK
OK button.
Definition misc_widget.h:38
@ WID_A_WEBSITE
URL of OpenTTD website.
Definition misc_widget.h:27
@ WID_A_COPYRIGHT
Copyright string.
Definition misc_widget.h:28
@ WID_A_SCROLLING_TEXT
The actually scrolling text.
Definition misc_widget.h:26
@ WID_Q_NO
Yes button.
Definition misc_widget.h:47
@ WID_Q_YES
No button.
Definition misc_widget.h:48
@ WID_Q_CAPTION
Caption of the window.
Definition misc_widget.h:45
@ WID_Q_TEXT
Text of the query.
Definition misc_widget.h:46
@ WID_LI_BACKGROUND
Background of the window.
Definition misc_widget.h:16
@ WID_LI_LOCATION
Scroll to location.
Definition misc_widget.h:15
GrfSpecFeature GetGrfSpecFeature(VehicleType type)
Get the GrfSpecFeature associated with a VehicleType.
Definition newgrf.cpp:1904
Functions/types related to NewGRF debugging.
PixelColour GetColourGradient(Colours colour, ColourShade shade)
Get colour gradient palette index.
Definition palette.cpp:393
static constexpr PixelColour PC_GREY
Grey palette colour.
static constexpr PixelColour PC_BLACK
Black palette colour.
static constexpr PixelColour PC_LIGHT_YELLOW
Light yellow palette colour.
Base for the GUIs that have an edit box in them.
void ShowOnScreenKeyboard(Window *parent, WidgetID button)
Show the on-screen keyboard (osk) associated with a given textbox.
Definition osk_gui.cpp:391
bool IsOSKOpenedFor(const Window *w, WidgetID button)
Check whether the OSK is opened for a specific editbox.
Definition osk_gui.cpp:422
Declaration of OTTD revision dependent variables.
A number of safeguards to prevent using unsafe methods.
GameSettings _settings_game
Game settings of a running game or the scenario editor.
Definition settings.cpp:61
ClientSettings _settings_client
The current settings for this game.
Definition settings.cpp:60
@ DoubleClick
Double click on the edit box opens OSK.
@ Disabled
The OSK shall not be activated at all.
@ Immediately
Focusing click already opens OSK.
Base classes/functions for stations.
void CcMoveStationName(Commands, const CommandCost &result, StationID station_id)
Callback function that is called after a name is moved.
Command definitions related to stations.
Definition of base types and functions in a cross-platform compatible way.
Functions related to low-level strings.
CharSetFilter
Valid filter types for IsValidChar.
Definition string_type.h:24
std::vector< std::string > StringList
Type for a list of strings.
Definition string_type.h:60
void GetStringWithArgs(StringBuilder &builder, StringID string, StringParameters &args, uint case_index, bool game_script)
Get a parsed string with most special stringcodes replaced by the string parameters.
Definition strings.cpp:336
EncodedString GetEncodedString(StringID str)
Encode a string with no parameters into an encoded string.
Definition strings.cpp:90
std::string GetString(StringID string)
Resolve the given StringID into a std::string with formatting but no parameters.
Definition strings.cpp:424
TextDirection _current_text_dir
Text direction of the currently selected language.
Definition strings.cpp:56
Functions related to OTTD's strings.
int64_t PackVelocity(uint speed, VehicleType type)
Pack velocity and vehicle type for use with SCC_VELOCITY string parameter.
uint32_t StringID
Numeric value that represents a string, independent of the selected language.
@ TD_RTL
Text is written right-to-left by default.
static const int MAX_CHAR_LENGTH
Max. length of UTF-8 encoded unicode character.
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
Definition misc_gui.cpp:446
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
Definition misc_gui.cpp:430
const IntervalTimer< TimerWindow > scroll_interval
Scroll the text in the about window slow.
Definition misc_gui.cpp:466
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
Definition misc_gui.cpp:423
int text_position
The top of the scrolling text.
Definition misc_gui.cpp:412
static const int num_visible_lines
The number of lines visible simultaneously.
Definition misc_gui.cpp:414
int line_height
The height of a single line.
Definition misc_gui.cpp:413
Class for storing amounts of cargo.
Definition cargo_type.h:115
GUISettings gui
settings related to the GUI
T y
Y coordinate.
T x
X coordinate.
Dimensions (a width and height) of a rectangle in 2D.
OskActivation osk_activation
Mouse gesture to trigger the OSK.
static Company * GetIfValid(auto index)
Class for the string query window.
Definition misc_gui.cpp:897
void OnPlaceObjectAbort() override
The user cancelled a tile highlight mode that has been set.
Definition misc_gui.cpp:992
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
Definition misc_gui.cpp:944
void OnPlaceObject(Point pt, TileIndex tile) override
The user clicked some place on the map when a tile highlight mode has been set.
Definition misc_gui.cpp:975
void Close(int data=0) override
Hide the window and all its child windows, and mark them for a later deletion.
QueryString editbox
Editbox.
Definition misc_gui.cpp:898
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
Definition misc_gui.cpp:927
QueryStringFlags flags
Flags controlling behaviour of the window.
Definition misc_gui.cpp:899
WidgetID last_user_action
Last started user action.
Definition misc_gui.cpp:901
Data stored about a string that can be modified in the GUI.
ptrdiff_t GetCharAtPosition(const Window *w, WidgetID wid, const Point &pt) const
Get the character that is rendered at a position.
Definition misc_gui.cpp:845
Point GetCaretPosition(const Window *w, WidgetID wid) const
Get the current caret position.
Definition misc_gui.cpp:787
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.
Definition misc_gui.cpp:815
Window used for asking the user a YES/NO question.
void Close(int data=0) override
Hide the window and all its child windows, and mark them for a later deletion.
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
QueryCallbackProc * proc
callback function executed on closing of popup. Window* points to parent, bool is true if 'yes' click...
EventState OnKeyPress(char32_t key, uint16_t keycode) override
A key has been pressed.
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
EncodedString caption
caption for query window.
EncodedString message
message for query window.
void FindWindowPlacementAndResize(int, int, bool) override
Resize window towards the default size.
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
constexpr uint Horizontal() const
Get total horizontal padding of RectPadding.
Specification of a rectangle with absolute coordinates of all edges.
Rect WithWidth(int width, bool end) const
Copy Rect and set its width.
int Width() const
Get width of Rect.
Rect Shrink(int s) const
Copy and shrink Rect by s pixels.
Rect Indent(int indent, bool end) const
Copy Rect and indent it from its position.
Rect WithX(int new_left, int new_right) const
Create a new Rect, replacing the left and right coordiates.
Rect Translate(int x, int y) const
Copy and translate Rect by x,y pixels.
static bool IsExpected(const BaseStation *st)
static Station * Get(auto index)
Helper/buffer for input fields.
uint16_t pixels
the current size of the string in pixels
uint16_t markxoffs
the start position of the marked area in pixels
void DeleteAll()
Delete every character in the textbuffer.
Definition textbuf.cpp:112
std::string_view GetText() const
Get the current text.
Definition textbuf.cpp:284
uint16_t caretxoffs
the current position of the caret in pixels
uint16_t marklength
the length of the marked area in pixels
void Assign(std::string_view text)
Copy a string into the textbuffer.
Definition textbuf.cpp:420
bool caret
is the caret ("_") visible or not
Tile description for the 'land area information' tool.
Definition tile_cmd.h:39
uint16_t rail_speed
Speed limit of rail (bridges and track).
Definition tile_cmd.h:52
std::optional< std::string > grf
newGRF used for the tile contents
Definition tile_cmd.h:50
StringID station_name
Type of station within the class.
Definition tile_cmd.h:46
StringID str
Description of the tile.
Definition tile_cmd.h:40
TimerGameCalendar::Date build_date
Date of construction of tile contents.
Definition tile_cmd.h:44
std::array< Owner, 4 > owner
Name of the owner(s).
Definition tile_cmd.h:42
uint64_t dparam
Parameter of the str string.
Definition tile_cmd.h:41
StringID airport_class
Name of the airport class.
Definition tile_cmd.h:47
StringID airport_name
Name of the airport.
Definition tile_cmd.h:48
uint16_t tram_speed
Speed limit of tram (bridges and track).
Definition tile_cmd.h:56
StringID roadtype
Type of road on the tile.
Definition tile_cmd.h:53
StringID tramtype
Type of tram on the tile.
Definition tile_cmd.h:55
StringID railtype
Type of rail on the tile.
Definition tile_cmd.h:51
uint16_t road_speed
Speed limit of road (bridges and track).
Definition tile_cmd.h:54
std::array< StringID, 4 > owner_type
Type of each owner.
Definition tile_cmd.h:43
std::optional< bool > town_can_upgrade
Whether the town can upgrade this house during town growth.
Definition tile_cmd.h:57
StringID airport_tile_name
Name of the airport tile.
Definition tile_cmd.h:49
StringID station_class
Class of station.
Definition tile_cmd.h:45
Window for displaying a tooltip.
Definition misc_gui.cpp:601
TooltipCloseCondition close_cond
Condition for closing the window.
Definition misc_gui.cpp:603
EncodedString text
String to display as tooltip.
Definition misc_gui.cpp:602
void OnMouseLoop() override
Called for every mouse loop run, which is at least once per (game) tick.
Definition misc_gui.cpp:657
Point OnInitialPosition(int16_t sm_width, int16_t sm_height, int window_number) override
Compute the initial position of the window.
Definition misc_gui.cpp:615
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
Definition misc_gui.cpp:635
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
Definition misc_gui.cpp:648
Town data structure.
Definition town.h:63
High level window description.
Definition window_gui.h:168
Data structure for an opened window.
Definition window_gui.h:274
void ReInit(int rx=0, int ry=0, bool reposition=false)
Re-initialize a window, and optionally change its size.
Definition window.cpp:992
virtual void Close(int data=0)
Hide the window and all its child windows, and mark them for a later deletion.
Definition window.cpp:1117
bool IsWidgetGloballyFocused(WidgetID widget_index) const
Check if given widget has user input focus.
Definition window_gui.h:432
void FinishInitNested(WindowNumber window_number=0)
Perform the second part of the initialization of a nested widget tree.
Definition window.cpp:1822
void InvalidateData(int data=0, bool gui_scope=true)
Mark this window's data as invalid (in need of re-computing).
Definition window.cpp:3262
Window * parent
Parent window.
Definition window_gui.h:329
void SetWidgetDirty(WidgetID widget_index) const
Invalidate a widget, i.e.
Definition window.cpp:570
virtual std::string GetWidgetString(WidgetID widget, StringID stringid) const
Get the raw string for a widget.
Definition window.cpp:518
ResizeInfo resize
Resize information.
Definition window_gui.h:315
void CreateNestedTree()
Perform the first part of the initialization of a nested widget tree.
Definition window.cpp:1812
WindowClass window_class
Window class.
Definition window_gui.h:302
virtual void OnQueryTextFinished(std::optional< std::string > str)
The query window opened from this window has closed.
Definition window_gui.h:792
void RaiseButtons(bool autoraise=false)
Raise the buttons of the window.
Definition window.cpp:544
int left
x position of left edge of the window
Definition window_gui.h:310
virtual void OnEditboxChanged(WidgetID widget)
The text in an editbox has been edited.
Definition window_gui.h:784
int top
y position of top edge of the window
Definition window_gui.h:311
Window(WindowDesc &desc)
Empty constructor, initialization has been moved to InitNested() called from the constructor of the d...
Definition window.cpp:1846
const NWID * GetWidget(WidgetID widnum) const
Get the nested widget with number widnum from the nested widget tree.
Definition window_gui.h:990
void HandleButtonClick(WidgetID widget)
Do all things to make a button look clicked and mark it to be unclicked in a few ticks.
Definition window.cpp:609
void InitNested(WindowNumber number=0)
Perform complete initialization of the Window with nested widgets, to allow use.
Definition window.cpp:1836
WindowFlags flags
Window flags.
Definition window_gui.h:301
AllWindows< false > Iterate
Iterate all windows in whatever order is easiest.
Definition window_gui.h:940
int width
width of the window (number of pixels to the right in x direction)
Definition window_gui.h:312
WindowNumber window_number
Window number within the window class.
Definition window_gui.h:303
@ EnableMove
enable the 'Move' button
Definition textbuf_gui.h:22
@ AcceptUnchanged
return success even when the text didn't change
Definition textbuf_gui.h:19
@ EnableDefault
enable the 'Default' button ("\0" is returned)
Definition textbuf_gui.h:20
@ LengthIsInChars
the length of the string is counted in characters
Definition textbuf_gui.h:21
void QueryCallbackProc(Window *, bool)
Callback procedure for the ShowQuery method.
Definition textbuf_gui.h:28
Functions related to text effects.
@ TE_STATIC
Keep the text effect static.
Definition texteff.hpp:23
@ TE_RISING
Make the text effect slowly go upwards.
Definition texteff.hpp:22
void AddAcceptedCargo(TileIndex tile, CargoArray &acceptance, CargoTypes &always_accepted)
Obtain cargo acceptance of a tile.
Definition tile_cmd.h:244
int GetTileZ(TileIndex tile)
Get bottom height of the tile.
Definition tile_map.cpp:115
StrongType::Typedef< uint32_t, struct TileIndexTag, StrongType::Compare, StrongType::Integer, StrongType::Compatible< int32_t >, StrongType::Compatible< int64_t > > TileIndex
The index/ID of a Tile.
Definition tile_type.h:92
constexpr TileIndex INVALID_TILE
The very nice invalid tile marker.
Definition tile_type.h:100
Functions related to tile highlights.
@ HT_RECT
rectangle (stations, depots, ...)
Definition of Interval and OneShot timers.
Definition of the Window system.
Base of the town class.
Town * ClosestTownFromTile(TileIndex tile, uint threshold)
Return the town closest (in distance or ownership) to a given tile, within a given threshold.
@ VEH_ROAD
Road vehicle type.
@ VEH_TRAIN
Train vehicle type.
bool ScrollMainWindowToTile(TileIndex tile, bool instant)
Scrolls the viewport of the main window to a given location.
void SetViewportStationRect(const Station *st, bool sel)
Select or deselect station for rectangle area highlight.
Viewport * IsPtInWindowViewport(const Window *w, int x, int y)
Is a xy position inside the viewport of the window?
Definition viewport.cpp:408
void SetViewportWaypointRect(const Waypoint *wp, bool sel)
Select or deselect waypoint for rectangle area highlight.
Functions related to (drawing on) viewports.
Handles dividing the water in the map into regions to assist pathfinding.
Base of waypoints.
void CcMoveWaypointName(Commands, const CommandCost &result, StationID waypoint_id)
Callback function that is called after a name is moved.
Command definitions related to waypoints.
void DrawFrameRect(int left, int top, int right, int bottom, Colours colour, FrameFlags flags)
Draw frame rectangle.
Definition widget.cpp:309
static RectPadding ScaleGUITrad(const RectPadding &r)
Scale a RectPadding to GUI zoom level.
Definition widget.cpp:49
@ WWT_PUSHTXTBTN
Normal push-button (no toggle button) with text caption.
@ WWT_PUSHIMGBTN
Normal push-button (no toggle button) with image caption.
@ WWT_LABEL
Centered label.
Definition widget_type.h:48
@ WWT_EDITBOX
a textbox for typing
Definition widget_type.h:62
@ NWID_HORIZONTAL
Horizontal container.
Definition widget_type.h:66
@ WWT_TEXTBTN
(Toggle) Button with text
Definition widget_type.h:44
@ WWT_PANEL
Simple depressed panel.
Definition widget_type.h:39
@ WWT_CAPTION
Window caption (window title between closebox and stickybox).
Definition widget_type.h:52
@ NWID_VERTICAL
Vertical container.
Definition widget_type.h:68
@ WWT_CLOSEBOX
Close box (at top-left of a window).
Definition widget_type.h:60
@ WWT_FRAME
Frame.
Definition widget_type.h:51
@ WWT_EMPTY
Empty widget, place holder to reserve space in widget tree.
Definition widget_type.h:37
@ WWT_TEXT
Pure simple text.
Definition widget_type.h:49
@ WWT_DEBUGBOX
NewGRF debug box (at top-right of a window, between WWT_CAPTION and WWT_SHADEBOX).
Definition widget_type.h:54
@ NWID_SELECTION
Stacked widgets, only one visible at a time (eg in a panel with tabs).
Definition widget_type.h:71
@ SZSP_NONE
Display plane with zero size in both directions (none filling and resizing).
@ EqualSize
Containers should keep all their (resizing) children equally large.
void CloseWindowById(WindowClass cls, WindowNumber number, bool force, int data)
Close a window by its class and window number (if it is open).
Definition window.cpp:1209
Window * GetMainWindow()
Get the main window, i.e.
Definition window.cpp:1195
void SetFocusedWindow(Window *w)
Set the window that has the focus.
Definition window.cpp:435
Window * FindWindowByClass(WindowClass cls)
Find any window by its class.
Definition window.cpp:1181
Window * FindWindowFromPt(int x, int y)
Do a search for a window at specific coordinates.
Definition window.cpp:1858
int GetMainViewTop()
Return the top of the main view available for general use.
Definition window.cpp:2153
void CloseWindowByClass(WindowClass cls, int data)
Close all windows of a given class.
Definition window.cpp:1222
int GetMainViewBottom()
Return the bottom of the main view available for general use.
Definition window.cpp:2164
bool _mouse_hovering
The mouse is hovering over the same point.
Definition window.cpp:94
Window functions not directly related to making/drawing windows.
@ NoClose
This window can't be interactively closed.
Definition window_gui.h:156
@ NoFocus
This window won't get focus/make any other window lose focus when click.
Definition window_gui.h:155
@ Modal
The window is a modal child of some other window, meaning the parent is 'inactive'.
Definition window_gui.h:154
@ Lowered
If set the frame is lowered and the background colour brighter (ie. buttons when pressed).
Definition window_gui.h:27
@ WhiteBorder
Window white border counter bit mask.
Definition window_gui.h:235
@ WDP_CENTER
Center the window.
Definition window_gui.h:145
@ WDP_AUTO
Find a place automatically.
Definition window_gui.h:144
@ WDP_MANUAL
Manually align the window (so no automatic location finding).
Definition window_gui.h:143
int WidgetID
Widget ID.
Definition window_type.h:21
@ WN_QUERY_STRING
Query string.
Definition window_type.h:35
@ WN_GAME_OPTIONS_ABOUT
About window.
Definition window_type.h:30
@ WN_CONFIRM_POPUP_QUERY
Query popup confirm.
Definition window_type.h:38
EventState
State of handling an event.
@ ES_HANDLED
The passed event is handled.
@ ES_NOT_HANDLED
The passed event is not handled.
static constexpr WidgetID INVALID_WIDGET
An invalid widget index.
Definition window_type.h:24
@ WC_LAND_INFO
Land info window; Window numbers:
@ WC_OSK
On Screen Keyboard; Window numbers:
@ WC_WAYPOINT_VIEW
Waypoint view; Window numbers:
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
Definition window_type.h:51
@ WC_STATION_VIEW
Station view; Window numbers:
@ WC_CONFIRM_POPUP_QUERY
Popup with confirm question; Window numbers:
@ WC_GAME_OPTIONS
Game options window; Window numbers:
@ WC_QUERY_STRING
Query string window; Window numbers:
@ WC_TOOLTIPS
Tooltip window; Window numbers:
Functions related to zooming.