OpenTTD Source 20260512-master-g20b387b91f
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
61 {},
62 _nested_land_info_widgets
63);
64
65class LandInfoWindow : public Window {
67 std::string cargo_acceptance{};
68
69public:
71
72 void DrawWidget(const Rect &r, WidgetID widget) const override
73 {
74 if (widget != WID_LI_BACKGROUND) return;
75
76 Rect ir = r.Shrink(WidgetDimensions::scaled.frametext);
77 for (size_t i = 0; i < this->landinfo_data.size(); i++) {
78 DrawString(ir, this->landinfo_data[i], i == 0 ? TC_LIGHT_BLUE : TC_FROMSTRING, SA_HOR_CENTER);
79 ir.top += GetCharacterHeight(FontSize::Normal) + (i == 0 ? WidgetDimensions::scaled.vsep_wide : WidgetDimensions::scaled.vsep_normal);
80 }
81
82 if (!this->cargo_acceptance.empty()) {
83 DrawStringMultiLine(ir, GetString(STR_JUST_RAW_STRING, this->cargo_acceptance), TC_FROMSTRING, SA_CENTER);
84 }
85 }
86
87 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
88 {
89 if (widget != WID_LI_BACKGROUND) return;
90
91 size.height = WidgetDimensions::scaled.frametext.Vertical();
92 for (size_t i = 0; i < this->landinfo_data.size(); i++) {
93 uint width = GetStringBoundingBox(this->landinfo_data[i]).width + WidgetDimensions::scaled.frametext.Horizontal();
94 size.width = std::max(size.width, width);
95
96 size.height += GetCharacterHeight(FontSize::Normal) + (i == 0 ? WidgetDimensions::scaled.vsep_wide : WidgetDimensions::scaled.vsep_normal);
97 }
98
99 if (!this->cargo_acceptance.empty()) {
100 uint width = GetStringBoundingBox(this->cargo_acceptance).width + WidgetDimensions::scaled.frametext.Horizontal();
101 size.width = std::max(size.width, std::min(static_cast<uint>(ScaleGUITrad(300)), width));
102 size.height += GetStringHeight(GetString(STR_JUST_RAW_STRING, this->cargo_acceptance), size.width - WidgetDimensions::scaled.frametext.Horizontal());
103 }
104 }
105
106 LandInfoWindow(Tile tile) : Window(_land_info_desc), tile(tile)
107 {
108 this->InitNested();
109
110#if defined(_DEBUG)
111# define LANDINFOD_LEVEL 0
112#else
113# define LANDINFOD_LEVEL 1
114#endif
115 Debug(misc, LANDINFOD_LEVEL, "TILE: {0} (0x{0:x}) ({1},{2})", (TileIndex)tile, TileX(tile), TileY(tile));
116 Debug(misc, LANDINFOD_LEVEL, "type = 0x{:x}", tile.type());
117 Debug(misc, LANDINFOD_LEVEL, "height = 0x{:x}", tile.height());
118 Debug(misc, LANDINFOD_LEVEL, "m1 = 0x{:x}", tile.m1());
119 Debug(misc, LANDINFOD_LEVEL, "m2 = 0x{:x}", tile.m2());
120 Debug(misc, LANDINFOD_LEVEL, "m3 = 0x{:x}", tile.m3());
121 Debug(misc, LANDINFOD_LEVEL, "m4 = 0x{:x}", tile.m4());
122 Debug(misc, LANDINFOD_LEVEL, "m5 = 0x{:x}", tile.m5());
123 Debug(misc, LANDINFOD_LEVEL, "m6 = 0x{:x}", tile.m6());
124 Debug(misc, LANDINFOD_LEVEL, "m7 = 0x{:x}", tile.m7());
125 Debug(misc, LANDINFOD_LEVEL, "m8 = 0x{:x}", tile.m8());
126
127 PrintWaterRegionDebugInfo(tile);
128#undef LANDINFOD_LEVEL
129 }
130
131 void OnInit() override
132 {
133 Town *t = ClosestTownFromTile(this->tile, _settings_game.economy.dist_local_authority);
134
135 TileDesc td{};
136 td.owner_type[0] = STR_LAND_AREA_INFORMATION_OWNER; // At least one owner is displayed, though it might be "N/A".
137
138 CargoArray acceptance{};
139 CargoTypes always_accepted{};
140 AddAcceptedCargo(this->tile, acceptance, always_accepted);
141 GetTileDesc(this->tile, td);
142
143 this->landinfo_data.clear();
144
145 /* Tiletype */
146 this->landinfo_data.push_back(GetString(td.str, td.dparam));
147
148 /* Up to four owners */
149 for (uint i = 0; i < 4; i++) {
150 if (td.owner_type[i] == STR_NULL) continue;
151
152 if (td.owner[i] == OWNER_NONE || td.owner[i] == OWNER_WATER) {
153 this->landinfo_data.push_back(GetString(td.owner_type[i], STR_LAND_AREA_INFORMATION_OWNER_N_A, std::monostate{}));
154 } else {
155 auto params = GetParamsForOwnedBy(td.owner[i], this->tile);
156 this->landinfo_data.push_back(GetStringWithArgs(td.owner_type[i], params));
157 }
158 }
159
160 /* Cost to clear/revenue when cleared */
162 if (c != nullptr) {
164 CommandCost costclear = Command<Commands::LandscapeClear>::Do(DoCommandFlag::QueryCost, this->tile);
165 if (costclear.Succeeded()) {
166 Money cost = costclear.GetCost();
167 StringID str;
168 if (cost < 0) {
169 cost = -cost; // Negate negative cost to a positive revenue
170 str = STR_LAND_AREA_INFORMATION_REVENUE_WHEN_CLEARED;
171 } else {
172 str = STR_LAND_AREA_INFORMATION_COST_TO_CLEAR;
173 }
174 this->landinfo_data.push_back(GetString(str, cost));
175 } else {
176 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_COST_TO_CLEAR_N_A));
177 }
178 } else {
179 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_COST_TO_CLEAR_N_A));
180 }
181
182 /* Location */
183 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LANDINFO_COORDS, TileX(this->tile), TileY(this->tile), GetTileZ(this->tile)));
184
185 /* Tile index */
186 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LANDINFO_INDEX, this->tile, this->tile));
187
188 /* Local authority */
189 if (t == nullptr) {
190 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LOCAL_AUTHORITY, STR_LAND_AREA_INFORMATION_LOCAL_AUTHORITY_NONE, std::monostate{}));
191 } else {
192 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LOCAL_AUTHORITY, STR_TOWN_NAME, t->index));
193 }
194
195 /* Build date */
197 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_BUILD_DATE, td.build_date));
198 }
199
200 /* Station class */
201 if (td.station_class != STR_NULL) {
202 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_STATION_CLASS, td.station_class));
203 }
204
205 /* Station type name */
206 if (td.station_name != STR_NULL) {
207 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_STATION_TYPE, td.station_name));
208 }
209
210 /* Airport class */
211 if (td.airport_class != STR_NULL) {
212 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORT_CLASS, td.airport_class));
213 }
214
215 /* Airport name */
216 if (td.airport_name != STR_NULL) {
217 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORT_NAME, td.airport_name));
218 }
219
220 /* Airport tile name */
221 if (td.airport_tile_name != STR_NULL) {
222 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORTTILE_NAME, td.airport_tile_name));
223 }
224
225 /* Rail type name */
226 if (td.railtype != STR_NULL) {
227 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_RAIL_TYPE, td.railtype));
228 }
229
230 /* Rail speed limit */
231 if (td.rail_speed != 0) {
232 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_RAIL_SPEED_LIMIT, PackVelocity(td.rail_speed, VehicleType::Train)));
233 }
234
235 /* Road type name */
236 if (td.roadtype != STR_NULL) {
237 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_ROAD_TYPE, td.roadtype));
238 }
239
240 /* Road speed limit */
241 if (td.road_speed != 0) {
242 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_ROAD_SPEED_LIMIT, PackVelocity(td.road_speed, VehicleType::Road)));
243 }
244
245 /* Tram type name */
246 if (td.tramtype != STR_NULL) {
247 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_TRAM_TYPE, td.tramtype));
248 }
249
250 /* Tram speed limit */
251 if (td.tram_speed != 0) {
252 this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_TRAM_SPEED_LIMIT, PackVelocity(td.tram_speed, VehicleType::Road)));
253 }
254
255 /* Tile protection status */
256 if (td.town_can_upgrade.has_value()) {
257 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));
258 }
259
260 /* NewGRF name */
261 if (td.grf.has_value()) {
262 this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_NEWGRF_NAME, std::move(*td.grf)));
263 }
264
265 /* Cargo acceptance is displayed in a extra multiline */
266 auto line = BuildCargoAcceptanceString(acceptance, STR_LAND_AREA_INFORMATION_CARGO_ACCEPTED);
267 if (line.has_value()) {
268 this->cargo_acceptance = std::move(*line);
269 } else {
270 this->cargo_acceptance.clear();
271 }
272 }
273
274 bool IsNewGRFInspectable() const override
275 {
276 return ::IsNewGRFInspectable(GetGrfSpecFeature(this->tile), this->tile.base());
277 }
278
279 void ShowNewGRFInspectWindow() const override
280 {
281 ::ShowNewGRFInspectWindow(GetGrfSpecFeature(this->tile), this->tile.base());
282 }
283
284 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
285 {
286 switch (widget) {
287 case WID_LI_LOCATION:
288 if (_ctrl_pressed) {
289 ShowExtraViewportWindow(this->tile);
290 } else {
291 ScrollMainWindowToTile(this->tile);
292 }
293 break;
294 }
295 }
296
302 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
303 {
304 if (!gui_scope) return;
305
306 /* ReInit, "debug" sprite might have changed */
307 if (data == 1) this->ReInit();
308 }
309};
310
316{
318 new LandInfoWindow(tile);
319}
320
321static constexpr std::initializer_list<NWidgetPart> _nested_about_widgets = {
324 NWidget(WWT_CAPTION, Colours::Grey), SetStringTip(STR_ABOUT_OPENTTD, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
325 EndContainer(),
327 NWidget(WWT_LABEL, Colours::Invalid), SetStringTip(STR_ABOUT_ORIGINAL_COPYRIGHT),
328 NWidget(WWT_LABEL, Colours::Invalid), SetStringTip(STR_ABOUT_VERSION),
331 EndContainer(),
334 EndContainer(),
335};
336
339 WindowPosition::Center, {}, 0, 0,
341 {},
342 _nested_about_widgets
343);
344
345static const std::initializer_list<const std::string_view> _credits = {
346 "Original design by Chris Sawyer",
347 "Original graphics by Simon Foster",
348 "",
349 "The OpenTTD team (in alphabetical order):",
350 " Matthijs Kooijman (blathijs) - Pathfinder-guru, Debian port (since 0.3)",
351 " Christoph Elsenhans (frosch) - General coding (since 0.6)",
352 " Lo\u00efc Guilloux (glx) - General / Windows Expert (since 0.4.5)",
353 " Koen Bussemaker (Kuhnovic) - General / Ship pathfinder (since 14)",
354 " Charles Pigott (LordAro) - General / Correctness police (since 1.9)",
355 " Michael Lutz (michi_cc) - Path based signals (since 0.7)",
356 " Niels Martin Hansen (nielsm) - Music system, general coding (since 1.9)",
357 " Owen Rudge (orudge) - Forum host, OS/2 port (since 0.1)",
358 " Peter Nelson (peter1138) - Spiritual descendant from NewGRF gods (since 0.4.5)",
359 " Remko Bijker (Rubidium) - Coder and way more (since 0.4.5)",
360 " Patric Stout (TrueBrain) - NoProgrammer (since 0.3), sys op",
361 " Tyler Trahan (2TallTyler) - General / Time Lord (since 13)",
362 " Richard Wheeler (zephyris) - Precision pixel production (since 15)",
363 "",
364 "Inactive Developers:",
365 " Grzegorz Duczy\u0144ski (adf88) - General coding (1.7 - 1.8)",
366 " Albert Hofkamp (Alberth) - GUI expert (0.7 - 1.9)",
367 " Jean-Fran\u00e7ois Claeys (Belugas) - GUI, NewGRF and more (0.4.5 - 1.0)",
368 " Bjarni Corfitzen (Bjarni) - MacOSX port, coder and vehicles (0.3 - 0.7)",
369 " Victor Fischer (Celestar) - Programming everywhere you need him to (0.3 - 0.6)",
370 " Ulf Hermann (fonsinchen) - Cargo Distribution (1.3 - 1.6)",
371 " Jaroslav Mazanec (KUDr) - YAPG (Yet Another Pathfinder God) ;) (0.4.5 - 0.6)",
372 " Jonathan Coome (Maedhros) - High priest of the NewGRF Temple (0.5 - 0.6)",
373 " Attila B\u00e1n (MiHaMiX) - Developer WebTranslator 1 and 2 (0.3 - 0.5)",
374 " Ingo von Borstel (planetmaker) - General coding, Support (1.1 - 1.9)",
375 " Zden\u011bk Sojka (SmatZ) - Bug finder and fixer (0.6 - 1.3)",
376 " Jos\u00e9 Soler (Terkhen) - General coding (1.0 - 1.4)",
377 " Christoph Mallon (Tron) - Programmer, code correctness police (0.3 - 0.5)",
378 " Thijs Marinussen (Yexo) - AI Framework, General (0.6 - 1.3)",
379 " Leif Linse (Zuu) - AI/Game Script (1.2 - 1.6)",
380 "",
381 "Retired Developers:",
382 " Tam\u00e1s Farag\u00f3 (Darkvater) - Ex-Lead coder (0.3 - 0.5)",
383 " Dominik Scherer (dominik81) - Lead programmer, GUI expert (0.3 - 0.3)",
384 " Emil Djupfeld (egladil) - MacOSX (0.4.5 - 0.6)",
385 " Simon Sasburg (HackyKid) - Many bugfixes (0.4 - 0.4.5)",
386 " Ludvig Strigeus (ludde) - Original author of OpenTTD, main coder (0.1 - 0.3)",
387 " Cian Duffy (MYOB) - BeOS port / manual writing (0.1 - 0.3)",
388 " Petr Baudi\u0161 (pasky) - Many patches, NewGRF support (0.3 - 0.3)",
389 " Benedikt Br\u00fcggemeier (skidd13) - Bug fixer and code reworker (0.6 - 0.7)",
390 " Serge Paquet (vurlix) - 2nd contributor after ludde (0.1 - 0.3)",
391 "",
392 "Special thanks go out to:",
393 " Josef Drexler - For his great work on TTDPatch",
394 " Marcin Grzegorczyk - Track foundations and for describing TTD internals",
395 " Stefan Mei\u00dfner (sign_de) - For his work on the console",
396 " Mike Ragsdale - OpenTTD installer",
397 " Christian Rosentreter (tokai) - MorphOS / AmigaOS port",
398 " Richard Kempton (richK) - additional airports, initial TGP implementation",
399 " Alberto Demichelis - Squirrel scripting language \u00a9 2003-2008",
400 " L. Peter Deutsch - MD5 implementation \u00a9 1999, 2000, 2002",
401 " Michael Blunck - Pre-signals and semaphores \u00a9 2003",
402 " George - Canal/Lock graphics \u00a9 2003-2004",
403 " Andrew Parkhouse (andythenorth) - River graphics",
404 " David Dallaston (Pikka) - Tram tracks",
405 " All Translators - Who made OpenTTD a truly international game",
406 " Bug Reporters - Without whom OpenTTD would still be full of bugs!",
407 "",
408 "",
409 "And last but not least:",
410 " Chris Sawyer - For an amazing game!"
411};
412
413struct AboutWindow : public Window {
415 int line_height = 0;
416 static const int num_visible_lines = 19;
417
418 AboutWindow() : Window(_about_desc)
419 {
421
422 this->text_position = this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y + this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->current_y;
423 }
424
425 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
426 {
427 if (widget == WID_A_WEBSITE) return "Website: https://www.openttd.org";
428 if (widget == WID_A_COPYRIGHT) return GetString(STR_ABOUT_COPYRIGHT_OPENTTD, _openttd_revision_year);
429 return this->Window::GetWidgetString(widget, stringid);
430 }
431
432 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
433 {
434 if (widget != WID_A_SCROLLING_TEXT) return;
435
436 this->line_height = GetCharacterHeight(FontSize::Normal);
437
438 Dimension d;
439 d.height = this->line_height * num_visible_lines;
440
441 d.width = 0;
442 for (const auto &str : _credits) {
443 d.width = std::max(d.width, GetStringBoundingBox(str).width);
444 }
445 size = maxdim(size, d);
446 }
447
448 void DrawWidget(const Rect &r, WidgetID widget) const override
449 {
450 if (widget != WID_A_SCROLLING_TEXT) return;
451
452 int y = this->text_position;
453
454 /* Show all scrolling _credits */
455 for (const auto &str : _credits) {
456 if (y >= r.top + 7 && y < r.bottom - this->line_height) {
457 DrawString(r.left, r.right, y, str, TC_BLACK, SA_LEFT | SA_FORCE);
458 }
459 y += this->line_height;
460 }
461 }
462
468 const IntervalTimer<TimerWindow> scroll_interval = {std::chrono::milliseconds(2100) / GetCharacterHeight(FontSize::Normal), [this](uint count) {
469 this->text_position -= count;
470 /* If the last text has scrolled start a new from the start */
471 if (this->text_position < (int)(this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y - std::size(_credits) * this->line_height)) {
472 this->text_position = this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y + this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->current_y;
473 }
475 }};
476};
477
478void ShowAboutWindow()
479{
481 new AboutWindow();
482}
483
490void ShowEstimatedCostOrIncome(Money cost, int x, int y)
491{
492 StringID msg = STR_MESSAGE_ESTIMATED_COST;
493
494 if (cost < 0) {
495 cost = -cost;
496 msg = STR_MESSAGE_ESTIMATED_INCOME;
497 }
498 ShowErrorMessage(GetEncodedString(msg, cost), {}, WL_INFO, x, y);
499}
500
508void ShowCostOrIncomeAnimation(int x, int y, int z, Money cost)
509{
510 if (cost == 0) {
511 return;
512 }
513 Point pt = RemapCoords(x, y, z);
514 StringID msg = STR_INCOME_FLOAT_COST;
515
516 if (cost < 0) {
517 cost = -cost;
518 msg = STR_INCOME_FLOAT_INCOME;
519 }
520 AddTextEffect(GetEncodedString(msg, cost), pt.x, pt.y, Ticks::DAY_TICKS, TE_RISING);
521}
522
531void ShowFeederIncomeAnimation(int x, int y, int z, Money transfer, Money income)
532{
533 Point pt = RemapCoords(x, y, z);
534
535 if (income == 0) {
536 AddTextEffect(GetEncodedString(STR_FEEDER, transfer), pt.x, pt.y, Ticks::DAY_TICKS, TE_RISING);
537 } else {
538 StringID msg = STR_FEEDER_COST;
539 if (income < 0) {
540 income = -income;
541 msg = STR_FEEDER_INCOME;
542 }
543 AddTextEffect(GetEncodedString(msg, transfer, income), pt.x, pt.y, Ticks::DAY_TICKS, TE_RISING);
544 }
545}
546
556TextEffectID ShowFillingPercent(int x, int y, int z, uint8_t percent, StringID string)
557{
558 Point pt = RemapCoords(x, y, z);
559
560 assert(string != STR_NULL);
561
562 return AddTextEffect(GetEncodedString(string, percent), pt.x, pt.y, 0, TE_STATIC);
563}
564
571void UpdateFillingPercent(TextEffectID te_id, uint8_t percent, StringID string)
572{
573 assert(string != STR_NULL);
574
575 UpdateTextEffect(te_id, GetEncodedString(string, percent));
576}
577
582void HideFillingPercent(TextEffectID *te_id)
583{
584 if (*te_id == INVALID_TE_ID) return;
585
586 RemoveTextEffect(*te_id);
587 *te_id = INVALID_TE_ID;
588}
589
590static constexpr std::initializer_list<NWidgetPart> _nested_tooltips_widgets = {
592};
593
596 WindowPosition::Manual, {}, 0, 0, // Coordinates and sizes are not used,
599 _nested_tooltips_widgets
600);
601
603struct TooltipsWindow : public Window
604{
606 TooltipCloseCondition close_cond{};
607
608 TooltipsWindow(Window *parent, EncodedString &&text, TooltipCloseCondition close_tooltip) : Window(_tool_tips_desc), text(std::move(text))
609 {
610 this->parent = parent;
611 this->close_cond = close_tooltip;
612
613 this->InitNested();
614
616 }
617
618 Point OnInitialPosition([[maybe_unused]] int16_t sm_width, [[maybe_unused]] int16_t sm_height, [[maybe_unused]] int window_number) override
619 {
620 /* Find the free screen space between the main toolbar at the top, and the statusbar at the bottom.
621 * Add a fixed distance 2 so the tooltip floats free from both bars.
622 */
623 int scr_top = GetMainViewTop() + 2;
624 int scr_bot = GetMainViewBottom() - 2;
625
626 Point pt;
627
628 /* Correctly position the tooltip position, watch out for window and cursor size
629 * Clamp value to below main toolbar and above statusbar. If tooltip would
630 * go below window, flip it so it is shown above the cursor */
631 pt.y = SoftClamp(_cursor.pos.y + _cursor.total_size.y + _cursor.total_offs.y + 5, scr_top, scr_bot);
632 if (pt.y + sm_height > scr_bot) pt.y = std::min(_cursor.pos.y + _cursor.total_offs.y - 5, scr_bot) - sm_height;
633 pt.x = sm_width >= _screen.width ? 0 : SoftClamp(_cursor.pos.x - (sm_width >> 1), 0, _screen.width - sm_width);
634
635 return pt;
636 }
637
638 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
639 {
640 if (widget != WID_TT_BACKGROUND) return;
641
642 auto str = this->text.GetDecodedString();
643 size.width = std::min<uint>(GetStringBoundingBox(str).width, ScaleGUITrad(194));
644 size.height = GetStringHeight(str, size.width);
645
646 /* Increase slightly to have some space around the box. */
647 size.width += WidgetDimensions::scaled.framerect.Horizontal() + WidgetDimensions::scaled.fullbevel.Horizontal();
648 size.height += WidgetDimensions::scaled.framerect.Vertical() + WidgetDimensions::scaled.fullbevel.Vertical();
649 }
650
651 void DrawWidget(const Rect &r, WidgetID widget) const override
652 {
653 if (widget != WID_TT_BACKGROUND) return;
656
657 DrawStringMultiLine(r.Shrink(WidgetDimensions::scaled.framerect).Shrink(WidgetDimensions::scaled.fullbevel), this->text.GetDecodedString(), TC_BLACK, SA_CENTER);
658 }
659
660 void OnMouseLoop() override
661 {
662 /* Always close tooltips when the cursor is not in our window. */
663 if (!_cursor.in_window) {
664 this->Close();
665 return;
666 }
667
668 /* We can show tooltips while dragging tools. These are shown as long as
669 * we are dragging the tool. Normal tooltips work with hover or rmb. */
670 switch (this->close_cond) {
671 case TCC_RIGHT_CLICK: if (!_right_button_down) this->Close(); break;
672 case TCC_HOVER: if (!_mouse_hovering) this->Close(); break;
673 case TCC_NONE: break;
674
675 case TCC_EXIT_VIEWPORT: {
676 Window *w = FindWindowFromPt(_cursor.pos.x, _cursor.pos.y);
677 if (w == nullptr || IsPtInWindowViewport(w, _cursor.pos.x, _cursor.pos.y) == nullptr) this->Close();
678 break;
679 }
680 }
681 }
682};
683
690void GuiShowTooltips(Window *parent, EncodedString &&text, TooltipCloseCondition close_tooltip)
691{
693
694 if (text.empty() || !_cursor.in_window) return;
695
696 new TooltipsWindow(parent, std::move(text), close_tooltip);
697}
698
699void QueryString::HandleEditBox(Window *w, WidgetID wid)
700{
701 if (w->IsWidgetGloballyFocused(wid) && this->text.HandleCaret()) {
702 w->SetWidgetDirty(wid);
703
704 /* For the OSK also invalidate the parent window */
705 if (w->window_class == WC_OSK) w->InvalidateData();
706 }
707}
708
709static int GetCaretWidth()
710{
712}
713
721{
722 const int linewidth = tb.pixels + GetCaretWidth();
723 const int boxwidth = r.Width();
724 if (linewidth <= boxwidth) return r;
725
726 /* Extend to cover whole string. This is left-aligned, adjusted by caret position. */
727 r = r.WithWidth(linewidth, false);
728
729 /* Slide so that the caret is at the centre unless limited by bounds of the line, i.e. near either end. */
730 return r.Translate(-std::clamp(tb.caretxoffs - (boxwidth / 2), 0, linewidth - boxwidth), 0);
731}
732
733void QueryString::DrawEditBox(const Window *w, WidgetID wid) const
734{
735 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
736
737 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
738
739 bool rtl = _current_text_dir == TD_RTL;
740 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
741 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
742
743 Rect r = wi->GetCurrentRect();
744 Rect cr = r.WithWidth(clearbtn_width, !rtl);
745 Rect fr = r.Indent(clearbtn_width, !rtl);
746
747 DrawFrameRect(cr, wi->colour, wi->IsLowered() ? FrameFlag::Lowered : FrameFlags{});
748 DrawSpriteIgnorePadding(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT, PAL_NONE, cr, SA_CENTER);
750
751 DrawFrameRect(fr, wi->colour, {FrameFlag::Lowered, FrameFlag::Darkened});
753
754 fr = fr.Shrink(WidgetDimensions::scaled.framerect);
755 /* Limit the drawing of the string inside the widget boundaries */
756 DrawPixelInfo dpi;
757 if (!FillDrawPixelInfo(&dpi, fr)) return;
758 /* Keep coordinates relative to the window. */
759 dpi.left += fr.left;
760 dpi.top += fr.top;
761
762 AutoRestoreBackup dpi_backup(_cur_dpi, &dpi);
763
764 /* We will take the current widget length as maximum width, with a small
765 * space reserved at the end for the caret to show */
766 const Textbuf *tb = &this->text;
767 fr = ScrollEditBoxTextRect(fr, *tb);
768
769 /* If we have a marked area, draw a background highlight. */
770 if (tb->marklength != 0) GfxFillRect(fr.left + tb->markxoffs, fr.top, fr.left + tb->markxoffs + tb->marklength - 1, fr.bottom, PC_GREY);
771
772 DrawString(fr.left, fr.right, CentreBounds(fr.top, fr.bottom, GetCharacterHeight(FontSize::Normal)), tb->GetText(), TC_YELLOW);
773 bool focussed = w->IsWidgetGloballyFocused(wid) || IsOSKOpenedFor(w, wid);
774 if (focussed && tb->caret) {
775 int caret_width = GetCaretWidth();
776 if (rtl) {
777 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);
778 } else {
779 DrawString(fr.left + tb->caretxoffs, fr.left + tb->caretxoffs + caret_width, CentreBounds(fr.top, fr.bottom, GetCharacterHeight(FontSize::Normal)), "_", TC_WHITE);
780 }
781 }
782}
783
791{
792 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
793
794 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
795
796 bool rtl = _current_text_dir == TD_RTL;
797 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
798 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
799
800 Rect r = wi->GetCurrentRect().Indent(clearbtn_width, !rtl).Shrink(WidgetDimensions::scaled.framerect);
801
802 /* Clamp caret position to be inside out current width. */
803 const Textbuf *tb = &this->text;
804 r = ScrollEditBoxTextRect(r, *tb);
805
806 Point pt = {r.left + tb->caretxoffs, r.top};
807 return pt;
808}
809
818Rect QueryString::GetBoundingRect(const Window *w, WidgetID wid, size_t from, size_t to) const
819{
820 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
821
822 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
823
824 bool rtl = _current_text_dir == TD_RTL;
825 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
826 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
827
828 Rect r = wi->GetCurrentRect().Indent(clearbtn_width, !rtl).Shrink(WidgetDimensions::scaled.framerect);
829
830 /* Clamp caret position to be inside our current width. */
831 const Textbuf *tb = &this->text;
832 r = ScrollEditBoxTextRect(r, *tb);
833
834 /* Get location of first and last character. */
835 const auto p1 = GetCharPosInString(tb->GetText(), from, FontSize::Normal);
836 const auto p2 = from != to ? GetCharPosInString(tb->GetText(), to, FontSize::Normal) : p1;
837
838 return r.WithX(Clamp(r.left + p1.left, r.left, r.right), Clamp(r.left + p2.right, r.left, r.right));
839}
840
848ptrdiff_t QueryString::GetCharAtPosition(const Window *w, WidgetID wid, const Point &pt) const
849{
850 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
851
852 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
853
854 bool rtl = _current_text_dir == TD_RTL;
855 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
856 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
857
858 Rect r = wi->GetCurrentRect().Indent(clearbtn_width, !rtl).Shrink(WidgetDimensions::scaled.framerect);
859
860 if (!IsInsideMM(pt.y, r.top, r.bottom)) return -1;
861
862 /* Clamp caret position to be inside our current width. */
863 const Textbuf *tb = &this->text;
864 r = ScrollEditBoxTextRect(r, *tb);
865
866 return ::GetCharAtPosition(tb->GetText(), pt.x - r.left);
867}
868
869void QueryString::ClickEditBox(Window *w, Point pt, WidgetID wid, int click_count, bool focus_changed)
870{
871 const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
872
873 assert((wi->type & WWT_MASK) == WWT_EDITBOX);
874
875 bool rtl = _current_text_dir == TD_RTL;
876 Dimension sprite_size = GetScaledSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
877 int clearbtn_width = sprite_size.width + WidgetDimensions::scaled.imgbtn.Horizontal();
878
879 Rect cr = wi->GetCurrentRect().WithWidth(clearbtn_width, !rtl);
880
881 if (IsInsideMM(pt.x, cr.left, cr.right)) {
882 if (!this->text.GetText().empty()) {
883 this->text.DeleteAll();
884 w->HandleButtonClick(wid);
885 w->OnEditboxChanged(wid);
886 }
887 return;
888 }
889
893 /* Open the OSK window */
894 ShowOnScreenKeyboard(w, wid);
895 }
896}
897
899struct QueryStringWindow : public Window
900{
902 QueryStringFlags flags{};
903
905
906 QueryStringWindow(std::string_view str, StringID caption, uint max_bytes, uint max_chars, WindowDesc &desc, Window *parent, CharSetFilter afilter, QueryStringFlags flags) :
907 Window(desc), editbox(max_bytes, max_chars)
908 {
909 this->editbox.text.Assign(str);
910
911 if (!flags.Test(QueryStringFlag::AcceptUnchanged)) this->editbox.orig = this->editbox.text.GetText();
912
913 this->querystrings[WID_QS_TEXT] = &this->editbox;
914 this->editbox.caption = caption;
915 this->editbox.cancel_button = WID_QS_CANCEL;
916 this->editbox.ok_button = WID_QS_OK;
917 this->editbox.text.afilter = afilter;
918 this->flags = flags;
919
920 this->CreateNestedTree();
922 this->GetWidget<NWidgetStacked>(WID_QS_MOVE_SEL)->SetDisplayedPlane((this->flags.Test(QueryStringFlag::EnableMove)) ? 0 : SZSP_NONE);
923 this->FinishInitNested(WN_QUERY_STRING);
924
925 this->parent = parent;
926
927 this->SetFocusedWidget(WID_QS_TEXT);
928 }
929
930 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
931 {
932 if (widget == WID_QS_CAPTION) return GetString(this->editbox.caption);
933
934 return this->Window::GetWidgetString(widget, stringid);
935 }
936
937 void OnOk()
938 {
939 if (!this->editbox.orig.has_value() || this->editbox.text.GetText() != this->editbox.orig) {
940 assert(this->parent != nullptr);
941
942 this->parent->OnQueryTextFinished(std::string{this->editbox.text.GetText()});
943 this->editbox.handled = true;
944 }
945 }
946
947 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
948 {
949 switch (widget) {
950 case WID_QS_DEFAULT:
951 this->editbox.text.DeleteAll();
952 [[fallthrough]];
953
954 case WID_QS_OK:
955 this->OnOk();
956 [[fallthrough]];
957
958 case WID_QS_CANCEL:
959 this->Close();
960 break;
961
962 case WID_QS_MOVE:
963 this->last_user_action = widget;
964
965 if (Station::IsExpected(Station::Get(this->parent->window_number))) {
966 /* this is a station */
967 SetViewportStationRect(Station::Get(this->parent->window_number), !this->IsWidgetLowered(WID_QS_MOVE));
968 } else {
969 /* this is a waypoint */
970 SetViewportWaypointRect(Waypoint::Get(this->parent->window_number), !this->IsWidgetLowered(WID_QS_MOVE));
971 }
972
973 HandlePlacePushButton(this, WID_QS_MOVE, SPR_CURSOR_SIGN, HT_RECT);
974 break;
975 }
976 }
977
978 void OnPlaceObject([[maybe_unused]] Point pt, TileIndex tile) override
979 {
980 switch (this->last_user_action) {
981 case WID_QS_MOVE: // Move name button
982 if (Station::IsExpected(Station::Get(this->parent->window_number))) {
983 /* this is a station */
984 Command<Commands::MoveStationName>::Post(STR_ERROR_CAN_T_MOVE_STATION_NAME, CcMoveStationName, this->parent->window_number, tile);
985 } else {
986 /* this is a waypoint */
987 Command<Commands::MoveWaypointNAme>::Post(STR_ERROR_CAN_T_MOVE_WAYPOINT_NAME, CcMoveWaypointName, this->parent->window_number, tile);
988 }
989 break;
990
991 default: NOT_REACHED();
992 }
993 }
994
995private:
998 {
999 if (this->parent->window_class == WC_STATION_VIEW) SetViewportStationRect(Station::Get(this->parent->window_number), false);
1000 if (this->parent->window_class == WC_WAYPOINT_VIEW) SetViewportWaypointRect(Waypoint::Get(this->parent->window_number), false);
1001 }
1002
1003public:
1004 void OnPlaceObjectAbort() override
1005 {
1006 if (this->parent != nullptr) {
1007 this->ClearViewportRect();
1008 }
1009
1010 this->RaiseButtons();
1011 }
1012
1013 void Close([[maybe_unused]] int data = 0) override
1014 {
1015 if (this->parent != nullptr) {
1016 this->ClearViewportRect();
1017
1018 if (!this->editbox.handled) {
1019 Window *parent = this->parent;
1020 this->parent = nullptr; // so parent doesn't try to close us again
1021 parent->OnQueryTextFinished(std::nullopt);
1022 }
1023 }
1024
1025 this->Window::Close();
1026 }
1027};
1028
1029static constexpr std::initializer_list<NWidgetPart> _nested_query_string_widgets = {
1033 EndContainer(),
1036 EndContainer(),
1039 NWidget(WWT_TEXTBTN, Colours::Grey, WID_QS_DEFAULT), SetMinimalSize(65, 12), SetFill(1, 1), SetStringTip(STR_BUTTON_DEFAULT),
1040 EndContainer(),
1041 NWidget(WWT_TEXTBTN, Colours::Grey, WID_QS_CANCEL), SetMinimalSize(65, 12), SetFill(1, 1), SetStringTip(STR_BUTTON_CANCEL),
1044 NWidget(WWT_TEXTBTN, Colours::Grey, WID_QS_MOVE), SetMinimalSize(65, 12), SetFill(1, 1), SetStringTip(STR_BUTTON_MOVE),
1045 EndContainer(),
1046 EndContainer(),
1047};
1048
1051 WindowPosition::Center, {}, 0, 0,
1053 {},
1054 _nested_query_string_widgets
1055);
1056
1066void ShowQueryString(std::string_view str, StringID caption, uint maxsize, Window *parent, CharSetFilter afilter, QueryStringFlags flags)
1067{
1068 assert(parent != nullptr);
1069
1071 new QueryStringWindow(str, caption, (flags.Test(QueryStringFlag::LengthIsInChars) ? MAX_CHAR_LENGTH : 1) * maxsize, maxsize, _query_string_desc, parent, afilter, flags);
1072}
1073
1078void UpdateQueryStringDefault(std::string_view str)
1079{
1081 if (w != nullptr) w->editbox.orig = str;
1082}
1083
1087struct QueryWindow : public Window {
1091
1093 : Window(desc), proc(callback), caption(std::move(caption)), message(std::move(message))
1094 {
1095 this->parent = parent;
1096
1097 this->CreateNestedTree();
1099 }
1100
1101 void Close([[maybe_unused]] int data = 0) override
1102 {
1103 if (this->proc != nullptr) this->proc(this->parent, false);
1104 this->Window::Close();
1105 }
1106
1107 void FindWindowPlacementAndResize(int, int, bool) override
1108 {
1109 /* Position query window over the calling window, ensuring it's within screen bounds. */
1110 this->left = SoftClamp(parent->left + (parent->width / 2) - (this->width / 2), 0, _screen.width - this->width);
1111 this->top = SoftClamp(parent->top + (parent->height / 2) - (this->height / 2), 0, _screen.height - this->height);
1112 this->SetDirty();
1113 }
1114
1115 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
1116 {
1117 switch (widget) {
1118 case WID_Q_CAPTION:
1119 return this->caption.GetDecodedString();
1120
1121 default:
1122 return this->Window::GetWidgetString(widget, stringid);
1123 }
1124 }
1125
1126 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
1127 {
1128 if (widget != WID_Q_TEXT) return;
1129
1130 size = GetStringMultiLineBoundingBox(this->message.GetDecodedString(), size);
1131 }
1132
1133 void DrawWidget(const Rect &r, WidgetID widget) const override
1134 {
1135 if (widget != WID_Q_TEXT) return;
1136
1137 DrawStringMultiLine(r, this->message.GetDecodedString(), TC_FROMSTRING, SA_CENTER);
1138 }
1139
1140 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
1141 {
1142 switch (widget) {
1143 case WID_Q_YES: {
1144 /* in the Generate New World window, clicking 'Yes' causes
1145 * CloseNonVitalWindows() to be called - we shouldn't be in a window then */
1146 QueryCallbackProc *proc = this->proc;
1147 Window *parent = this->parent;
1148 /* Prevent the destructor calling the callback function */
1149 this->proc = nullptr;
1150 this->Close();
1151 if (proc != nullptr) {
1152 proc(parent, true);
1153 proc = nullptr;
1154 }
1155 break;
1156 }
1157 case WID_Q_NO:
1158 this->Close();
1159 break;
1160 }
1161 }
1162
1163 EventState OnKeyPress([[maybe_unused]] char32_t key, uint16_t keycode) override
1164 {
1165 /* ESC closes the window, Enter confirms the action */
1166 switch (keycode) {
1167 case WKC_RETURN:
1168 case WKC_NUM_ENTER:
1169 if (this->proc != nullptr) {
1170 this->proc(this->parent, true);
1171 this->proc = nullptr;
1172 }
1173 [[fallthrough]];
1174
1175 case WKC_ESC:
1176 this->Close();
1177 return ES_HANDLED;
1178 }
1179 return ES_NOT_HANDLED;
1180 }
1181};
1182
1183static constexpr std::initializer_list<NWidgetPart> _nested_query_widgets = {
1187 EndContainer(),
1194 EndContainer(),
1195 EndContainer(),
1196 EndContainer(),
1197};
1198
1201 WindowPosition::Center, {}, 0, 0,
1204 _nested_query_widgets
1205);
1206
1217void ShowQuery(EncodedString &&caption, EncodedString &&message, Window *parent, QueryCallbackProc *callback, bool focus)
1218{
1219 if (parent == nullptr) parent = GetMainWindow();
1220
1221 for (Window *w : Window::Iterate()) {
1222 if (w->window_class != WC_CONFIRM_POPUP_QUERY) continue;
1223
1224 QueryWindow *qw = dynamic_cast<QueryWindow *>(w);
1225 assert(qw != nullptr);
1226 if (qw->parent != parent || qw->proc != callback) continue;
1227
1228 qw->Close();
1229 break;
1230 }
1231
1232 QueryWindow *q = new QueryWindow(_query_desc, std::move(caption), std::move(message), parent, callback);
1233 if (focus) SetFocusedWindow(q);
1234}
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:72
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
Definition misc_gui.cpp:302
StringList landinfo_data
Info lines to show.
Definition misc_gui.cpp:66
std::string cargo_acceptance
Centered multi-line string for cargo acceptance.
Definition misc_gui.cpp:67
bool IsNewGRFInspectable() const override
Is the data related to this window NewGRF inspectable?
Definition misc_gui.cpp:274
void OnInit() override
Notification that the nested widget tree gets initialized.
Definition misc_gui.cpp:131
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:284
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:87
void ShowNewGRFInspectWindow() const override
Show the NewGRF inspection window.
Definition misc_gui.cpp:279
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
@ 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
static WindowDesc _query_desc(WindowPosition::Center, {}, 0, 0, WC_CONFIRM_POPUP_QUERY, WC_NONE, WindowDefaultFlag::Modal, _nested_query_widgets)
Window definition for the query window.
void GuiShowTooltips(Window *parent, EncodedString &&text, TooltipCloseCondition close_tooltip)
Shows a tooltip.
Definition misc_gui.cpp:690
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...
static WindowDesc _land_info_desc(WindowPosition::Automatic, {}, 0, 0, WC_LAND_INFO, WC_NONE, {}, _nested_land_info_widgets)
Window definition for the land information window.
void HideFillingPercent(TextEffectID *te_id)
Hide vehicle loading indicators.
Definition misc_gui.cpp:582
void ShowCostOrIncomeAnimation(int x, int y, int z, Money cost)
Display animated income or costs on the map.
Definition misc_gui.cpp:508
void ShowEstimatedCostOrIncome(Money cost, int x, int y)
Display estimated costs.
Definition misc_gui.cpp:490
static WindowDesc _about_desc(WindowPosition::Center, {}, 0, 0, WC_GAME_OPTIONS, WC_NONE, {}, _nested_about_widgets)
Window definition for the about window.
void ShowLandInfo(TileIndex tile)
Show land information window.
Definition misc_gui.cpp:315
static WindowDesc _tool_tips_desc(WindowPosition::Manual, {}, 0, 0, WC_TOOLTIPS, WC_NONE, {WindowDefaultFlag::NoFocus, WindowDefaultFlag::NoClose}, _nested_tooltips_widgets)
Window definition for the tool tip window.
void ShowFeederIncomeAnimation(int x, int y, int z, Money transfer, Money income)
Display animated feeder income.
Definition misc_gui.cpp:531
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.
static WindowDesc _query_string_desc(WindowPosition::Center, {}, 0, 0, WC_QUERY_STRING, WC_NONE, {}, _nested_query_string_widgets)
Window definition for the string query window.
void UpdateFillingPercent(TextEffectID te_id, uint8_t percent, StringID string)
Update vehicle loading indicators.
Definition misc_gui.cpp:571
TextEffectID ShowFillingPercent(int x, int y, int z, uint8_t percent, StringID string)
Display vehicle loading indicators.
Definition misc_gui.cpp:556
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:720
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:1905
Functions/types related to NewGRF debugging.
PixelColour GetColourGradient(Colours colour, Shade shade)
Get colour gradient palette index.
Definition palette.cpp:393
@ Darker
Darker colour shade.
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:392
bool IsOSKOpenedFor(const Window *w, WidgetID button)
Check whether the OSK is opened for a specific editbox.
Definition osk_gui.cpp:423
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:448
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:432
const IntervalTimer< TimerWindow > scroll_interval
Scroll the text in the about window slow.
Definition misc_gui.cpp:468
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
Definition misc_gui.cpp:425
int text_position
The top of the scrolling text.
Definition misc_gui.cpp:414
static const int num_visible_lines
The number of lines visible simultaneously.
Definition misc_gui.cpp:416
int line_height
The height of a single line.
Definition misc_gui.cpp:415
Class for storing amounts of cargo.
Definition cargo_type.h:117
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:900
void OnPlaceObjectAbort() override
The user cancelled a tile highlight mode that has been set.
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:947
void ClearViewportRect()
Clear parent window station/waypoint viewport rect.
Definition misc_gui.cpp:997
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:978
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:901
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
Definition misc_gui.cpp:930
QueryStringFlags flags
Flags controlling behaviour of the window.
Definition misc_gui.cpp:902
WidgetID last_user_action
Last started user action.
Definition misc_gui.cpp:904
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:848
Point GetCaretPosition(const Window *w, WidgetID wid) const
Get the current caret position.
Definition misc_gui.cpp:790
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:818
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 coordinates.
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:604
TooltipCloseCondition close_cond
Condition for closing the window.
Definition misc_gui.cpp:606
EncodedString text
String to display as tooltip.
Definition misc_gui.cpp:605
void OnMouseLoop() override
Called for every mouse loop run, which is at least once per (game) tick.
Definition misc_gui.cpp:660
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:618
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:638
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
Definition misc_gui.cpp:651
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.
@ Road
Road vehicle type.
@ 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
@ Automatic
Find a place automatically.
Definition window_gui.h:144
@ Center
Center the window.
Definition window_gui.h:145
@ 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.