OpenTTD Source  13.0-beta1
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 <http://www.gnu.org/licenses/>.
6  */
7 
10 #include "stdafx.h"
11 #include "debug.h"
12 #include "landscape.h"
13 #include "error.h"
14 #include "gui.h"
15 #include "command_func.h"
16 #include "company_func.h"
17 #include "town.h"
18 #include "string_func.h"
19 #include "company_base.h"
20 #include "texteff.hpp"
21 #include "strings_func.h"
22 #include "window_func.h"
23 #include "querystring_gui.h"
24 #include "core/geometry_func.hpp"
25 #include "newgrf_debug.h"
26 #include "zoom_func.h"
27 #include "guitimer_func.h"
28 #include "viewport_func.h"
29 #include "landscape_cmd.h"
30 #include "rev.h"
31 
32 #include "widgets/misc_widget.h"
33 
34 #include "table/strings.h"
35 
36 #include <sstream>
37 #include <iomanip>
38 
39 #include "safeguards.h"
40 
47 };
48 
49 
50 static const NWidgetPart _nested_land_info_widgets[] = {
52  NWidget(WWT_CLOSEBOX, COLOUR_GREY),
53  NWidget(WWT_CAPTION, COLOUR_GREY), SetDataTip(STR_LAND_AREA_INFORMATION_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
54  NWidget(WWT_PUSHIMGBTN, COLOUR_GREY, WID_LI_LOCATION), SetMinimalSize(12, 14), SetDataTip(SPR_GOTO_LOCATION, STR_LAND_AREA_INFORMATION_LOCATION_TOOLTIP),
55  NWidget(WWT_DEBUGBOX, COLOUR_GREY),
56  EndContainer(),
58 };
59 
60 static WindowDesc _land_info_desc(
61  WDP_AUTO, "land_info", 0, 0,
63  0,
64  _nested_land_info_widgets, lengthof(_nested_land_info_widgets)
65 );
66 
67 class LandInfoWindow : public Window {
69  std::string cargo_acceptance;
70 
71 public:
72  TileIndex tile;
73 
74  void DrawWidget(const Rect &r, int widget) const override
75  {
76  if (widget != WID_LI_BACKGROUND) return;
77 
78  uint y = r.top + WD_TEXTPANEL_TOP;
79  for (size_t i = 0; i < this->landinfo_data.size(); i++) {
80  DrawString(r.left + WD_FRAMETEXT_LEFT, r.right - WD_FRAMETEXT_RIGHT, y, this->landinfo_data[i], i == 0 ? TC_LIGHT_BLUE : TC_FROMSTRING, SA_HOR_CENTER);
82  if (i == 0) y += 4;
83  }
84 
85  if (!this->cargo_acceptance.empty()) {
86  SetDParamStr(0, this->cargo_acceptance);
87  DrawStringMultiLine(r.left + WD_FRAMETEXT_LEFT, r.right - WD_FRAMETEXT_RIGHT, y, r.bottom - WD_TEXTPANEL_BOTTOM, STR_JUST_RAW_STRING, TC_FROMSTRING, SA_CENTER);
88  }
89  }
90 
91  void UpdateWidgetSize(int widget, Dimension *size, const Dimension &padding, Dimension *fill, Dimension *resize) override
92  {
93  if (widget != WID_LI_BACKGROUND) return;
94 
95  size->height = WD_TEXTPANEL_TOP + WD_TEXTPANEL_BOTTOM;
96  for (size_t i = 0; i < this->landinfo_data.size(); i++) {
97  uint width = GetStringBoundingBox(this->landinfo_data[i]).width + WD_FRAMETEXT_LEFT + WD_FRAMETEXT_RIGHT;
98  size->width = std::max(size->width, width);
99 
100  size->height += FONT_HEIGHT_NORMAL + WD_PAR_VSEP_NORMAL;
101  if (i == 0) size->height += 4;
102  }
103 
104  if (!this->cargo_acceptance.empty()) {
105  uint width = GetStringBoundingBox(this->cargo_acceptance).width + WD_FRAMETEXT_LEFT + WD_FRAMETEXT_RIGHT;
106  size->width = std::max(size->width, std::min(300u, width));
108  size->height += GetStringHeight(STR_JUST_RAW_STRING, size->width - WD_FRAMETEXT_LEFT - WD_FRAMETEXT_RIGHT);
109  }
110  }
111 
112  LandInfoWindow(TileIndex tile) : Window(&_land_info_desc), tile(tile)
113  {
114  this->InitNested();
115 
116 #if defined(_DEBUG)
117 # define LANDINFOD_LEVEL 0
118 #else
119 # define LANDINFOD_LEVEL 1
120 #endif
121  Debug(misc, LANDINFOD_LEVEL, "TILE: {:#x} ({},{})", tile, TileX(tile), TileY(tile));
122  Debug(misc, LANDINFOD_LEVEL, "type = {:#x}", _m[tile].type);
123  Debug(misc, LANDINFOD_LEVEL, "height = {:#x}", _m[tile].height);
124  Debug(misc, LANDINFOD_LEVEL, "m1 = {:#x}", _m[tile].m1);
125  Debug(misc, LANDINFOD_LEVEL, "m2 = {:#x}", _m[tile].m2);
126  Debug(misc, LANDINFOD_LEVEL, "m3 = {:#x}", _m[tile].m3);
127  Debug(misc, LANDINFOD_LEVEL, "m4 = {:#x}", _m[tile].m4);
128  Debug(misc, LANDINFOD_LEVEL, "m5 = {:#x}", _m[tile].m5);
129  Debug(misc, LANDINFOD_LEVEL, "m6 = {:#x}", _me[tile].m6);
130  Debug(misc, LANDINFOD_LEVEL, "m7 = {:#x}", _me[tile].m7);
131  Debug(misc, LANDINFOD_LEVEL, "m8 = {:#x}", _me[tile].m8);
132 #undef LANDINFOD_LEVEL
133  }
134 
135  void OnInit() override
136  {
138 
139  /* Because build_date is not set yet in every TileDesc, we make sure it is empty */
140  TileDesc td;
141 
143 
144  /* Most tiles have only one owner, but
145  * - drivethrough roadstops can be build on town owned roads (up to 2 owners) and
146  * - roads can have up to four owners (railroad, road, tram, 3rd-roadtype "highway").
147  */
148  td.owner_type[0] = STR_LAND_AREA_INFORMATION_OWNER; // At least one owner is displayed, though it might be "N/A".
149  td.owner_type[1] = STR_NULL; // STR_NULL results in skipping the owner
150  td.owner_type[2] = STR_NULL;
151  td.owner_type[3] = STR_NULL;
152  td.owner[0] = OWNER_NONE;
153  td.owner[1] = OWNER_NONE;
154  td.owner[2] = OWNER_NONE;
155  td.owner[3] = OWNER_NONE;
156 
157  td.station_class = STR_NULL;
158  td.station_name = STR_NULL;
159  td.airport_class = STR_NULL;
160  td.airport_name = STR_NULL;
161  td.airport_tile_name = STR_NULL;
162  td.railtype = STR_NULL;
163  td.rail_speed = 0;
164  td.roadtype = STR_NULL;
165  td.road_speed = 0;
166  td.tramtype = STR_NULL;
167  td.tram_speed = 0;
168 
169  td.grf = nullptr;
170 
171  CargoArray acceptance;
172  AddAcceptedCargo(tile, acceptance, nullptr);
173  GetTileDesc(tile, &td);
174 
175  this->landinfo_data.clear();
176 
177  /* Tiletype */
178  SetDParam(0, td.dparam[0]);
179  this->landinfo_data.push_back(GetString(td.str));
180 
181  /* Up to four owners */
182  for (uint i = 0; i < 4; i++) {
183  if (td.owner_type[i] == STR_NULL) continue;
184 
185  SetDParam(0, STR_LAND_AREA_INFORMATION_OWNER_N_A);
186  if (td.owner[i] != OWNER_NONE && td.owner[i] != OWNER_WATER) GetNameOfOwner(td.owner[i], tile);
187  this->landinfo_data.push_back(GetString(td.owner_type[i]));
188  }
189 
190  /* Cost to clear/revenue when cleared */
191  StringID str = STR_LAND_AREA_INFORMATION_COST_TO_CLEAR_N_A;
193  if (c != nullptr) {
194  assert(_current_company == _local_company);
196  if (costclear.Succeeded()) {
197  Money cost = costclear.GetCost();
198  if (cost < 0) {
199  cost = -cost; // Negate negative cost to a positive revenue
200  str = STR_LAND_AREA_INFORMATION_REVENUE_WHEN_CLEARED;
201  } else {
202  str = STR_LAND_AREA_INFORMATION_COST_TO_CLEAR;
203  }
204  SetDParam(0, cost);
205  }
206  }
207  this->landinfo_data.push_back(GetString(str));
208 
209  /* Location */
210  std::stringstream tile_ss;
211  tile_ss << "0x" << std::setfill('0') << std::setw(4) << std::hex << std::uppercase << tile; // 0x%.4X
212  std::string tile_str = tile_ss.str(); // Can't pass it directly to SetDParamStr as the string is only a temporary and would be destructed before the GetString call.
213 
214  SetDParam(0, TileX(tile));
215  SetDParam(1, TileY(tile));
216  SetDParam(2, GetTileZ(tile));
217  SetDParamStr(3, tile_str);
218  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LANDINFO_COORDS));
219 
220  /* Local authority */
221  SetDParam(0, STR_LAND_AREA_INFORMATION_LOCAL_AUTHORITY_NONE);
222  if (t != nullptr) {
223  SetDParam(0, STR_TOWN_NAME);
224  SetDParam(1, t->index);
225  }
226  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_LOCAL_AUTHORITY));
227 
228  /* Build date */
229  if (td.build_date != INVALID_DATE) {
230  SetDParam(0, td.build_date);
231  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_BUILD_DATE));
232  }
233 
234  /* Station class */
235  if (td.station_class != STR_NULL) {
236  SetDParam(0, td.station_class);
237  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_STATION_CLASS));
238  }
239 
240  /* Station type name */
241  if (td.station_name != STR_NULL) {
242  SetDParam(0, td.station_name);
243  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_STATION_TYPE));
244  }
245 
246  /* Airport class */
247  if (td.airport_class != STR_NULL) {
248  SetDParam(0, td.airport_class);
249  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORT_CLASS));
250  }
251 
252  /* Airport name */
253  if (td.airport_name != STR_NULL) {
254  SetDParam(0, td.airport_name);
255  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORT_NAME));
256  }
257 
258  /* Airport tile name */
259  if (td.airport_tile_name != STR_NULL) {
261  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_AIRPORTTILE_NAME));
262  }
263 
264  /* Rail type name */
265  if (td.railtype != STR_NULL) {
266  SetDParam(0, td.railtype);
267  this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_RAIL_TYPE));
268  }
269 
270  /* Rail speed limit */
271  if (td.rail_speed != 0) {
272  SetDParam(0, td.rail_speed);
273  this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_RAIL_SPEED_LIMIT));
274  }
275 
276  /* Road type name */
277  if (td.roadtype != STR_NULL) {
278  SetDParam(0, td.roadtype);
279  this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_ROAD_TYPE));
280  }
281 
282  /* Road speed limit */
283  if (td.road_speed != 0) {
284  SetDParam(0, td.road_speed);
285  this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_ROAD_SPEED_LIMIT));
286  }
287 
288  /* Tram type name */
289  if (td.tramtype != STR_NULL) {
290  SetDParam(0, td.tramtype);
291  this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_TRAM_TYPE));
292  }
293 
294  /* Tram speed limit */
295  if (td.tram_speed != 0) {
296  SetDParam(0, td.tram_speed);
297  this->landinfo_data.push_back(GetString(STR_LANG_AREA_INFORMATION_TRAM_SPEED_LIMIT));
298  }
299 
300  /* NewGRF name */
301  if (td.grf != nullptr) {
302  SetDParamStr(0, td.grf);
303  this->landinfo_data.push_back(GetString(STR_LAND_AREA_INFORMATION_NEWGRF_NAME));
304  }
305 
306  /* Cargo acceptance is displayed in a extra multiline */
307  std::stringstream line;
308  line << GetString(STR_LAND_AREA_INFORMATION_CARGO_ACCEPTED);
309 
310  bool found = false;
311  for (CargoID i = 0; i < NUM_CARGO; ++i) {
312  if (acceptance[i] > 0) {
313  /* Add a comma between each item. */
314  if (found) line << ", ";
315  found = true;
316 
317  /* If the accepted value is less than 8, show it in 1/8:ths */
318  if (acceptance[i] < 8) {
319  SetDParam(0, acceptance[i]);
320  SetDParam(1, CargoSpec::Get(i)->name);
321  line << GetString(STR_LAND_AREA_INFORMATION_CARGO_EIGHTS);
322  } else {
323  line << GetString(CargoSpec::Get(i)->name);
324  }
325  }
326  }
327  if (found) {
328  this->cargo_acceptance = line.str();
329  } else {
330  this->cargo_acceptance.clear();
331  }
332  }
333 
334  bool IsNewGRFInspectable() const override
335  {
336  return ::IsNewGRFInspectable(GetGrfSpecFeature(this->tile), this->tile);
337  }
338 
339  void ShowNewGRFInspectWindow() const override
340  {
341  ::ShowNewGRFInspectWindow(GetGrfSpecFeature(this->tile), this->tile);
342  }
343 
344  void OnClick(Point pt, int widget, int click_count) override
345  {
346  switch (widget) {
347  case WID_LI_LOCATION:
348  if (_ctrl_pressed) {
349  ShowExtraViewportWindow(this->tile);
350  } else {
351  ScrollMainWindowToTile(this->tile);
352  }
353  break;
354  }
355  }
356 
362  void OnInvalidateData(int data = 0, bool gui_scope = true) override
363  {
364  if (!gui_scope) return;
365  switch (data) {
366  case 1:
367  /* ReInit, "debug" sprite might have changed */
368  this->ReInit();
369  break;
370  }
371  }
372 };
373 
379 {
381  new LandInfoWindow(tile);
382 }
383 
384 static const NWidgetPart _nested_about_widgets[] = {
386  NWidget(WWT_CLOSEBOX, COLOUR_GREY),
387  NWidget(WWT_CAPTION, COLOUR_GREY), SetDataTip(STR_ABOUT_OPENTTD, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
388  EndContainer(),
389  NWidget(WWT_PANEL, COLOUR_GREY), SetPIP(4, 2, 4),
390  NWidget(WWT_LABEL, COLOUR_GREY), SetDataTip(STR_ABOUT_ORIGINAL_COPYRIGHT, STR_NULL),
391  NWidget(WWT_LABEL, COLOUR_GREY), SetDataTip(STR_ABOUT_VERSION, STR_NULL),
392  NWidget(WWT_FRAME, COLOUR_GREY), SetPadding(0, 5, 1, 5),
393  NWidget(WWT_EMPTY, INVALID_COLOUR, WID_A_SCROLLING_TEXT),
394  EndContainer(),
395  NWidget(WWT_LABEL, COLOUR_GREY, WID_A_WEBSITE), SetDataTip(STR_BLACK_RAW_STRING, STR_NULL),
396  NWidget(WWT_LABEL, COLOUR_GREY, WID_A_COPYRIGHT), SetDataTip(STR_ABOUT_COPYRIGHT_OPENTTD, STR_NULL),
397  EndContainer(),
398 };
399 
400 static WindowDesc _about_desc(
401  WDP_CENTER, nullptr, 0, 0,
403  0,
404  _nested_about_widgets, lengthof(_nested_about_widgets)
405 );
406 
407 static const char * const _credits[] = {
408  u8"Original design by Chris Sawyer",
409  u8"Original graphics by Simon Foster",
410  u8"",
411  u8"The OpenTTD team (in alphabetical order):",
412  u8" Matthijs Kooijman (blathijs) - Pathfinder-guru, Debian port (since 0.3)",
413  u8" Christoph Elsenhans (frosch) - General coding (since 0.6)",
414  u8" Lo\u00efc Guilloux (glx) - General / Windows Expert (since 0.4.5)",
415  u8" Charles Pigott (LordAro) - General / Correctness police (since 1.9)",
416  u8" Michael Lutz (michi_cc) - Path based signals (since 0.7)",
417  u8" Niels Martin Hansen (nielsm) - Music system, general coding (since 1.9)",
418  u8" Owen Rudge (orudge) - Forum host, OS/2 port (since 0.1)",
419  u8" Peter Nelson (peter1138) - Spiritual descendant from NewGRF gods (since 0.4.5)",
420  u8" Remko Bijker (Rubidium) - Coder and way more (since 0.4.5)",
421  u8" Patric Stout (TrueBrain) - NoProgrammer (since 0.3), sys op",
422  u8"",
423  u8"Inactive Developers:",
424  u8" Grzegorz Duczy\u0144ski (adf88) - General coding (1.7 - 1.8)",
425  u8" Albert Hofkamp (Alberth) - GUI expert (0.7 - 1.9)",
426  u8" Jean-Fran\u00e7ois Claeys (Belugas) - GUI, NewGRF and more (0.4.5 - 1.0)",
427  u8" Bjarni Corfitzen (Bjarni) - MacOSX port, coder and vehicles (0.3 - 0.7)",
428  u8" Victor Fischer (Celestar) - Programming everywhere you need him to (0.3 - 0.6)",
429  u8" Ulf Hermann (fonsinchen) - Cargo Distribution (1.3 - 1.6)",
430  u8" Jaroslav Mazanec (KUDr) - YAPG (Yet Another Pathfinder God) ;) (0.4.5 - 0.6)",
431  u8" Jonathan Coome (Maedhros) - High priest of the NewGRF Temple (0.5 - 0.6)",
432  u8" Attila B\u00e1n (MiHaMiX) - Developer WebTranslator 1 and 2 (0.3 - 0.5)",
433  u8" Ingo von Borstel (planetmaker) - General coding, Support (1.1 - 1.9)",
434  u8" Zden\u011bk Sojka (SmatZ) - Bug finder and fixer (0.6 - 1.3)",
435  u8" Jos\u00e9 Soler (Terkhen) - General coding (1.0 - 1.4)",
436  u8" Christoph Mallon (Tron) - Programmer, code correctness police (0.3 - 0.5)",
437  u8" Thijs Marinussen (Yexo) - AI Framework, General (0.6 - 1.3)",
438  u8" Leif Linse (Zuu) - AI/Game Script (1.2 - 1.6)",
439  u8"",
440  u8"Retired Developers:",
441  u8" Tam\u00e1s Farag\u00f3 (Darkvater) - Ex-Lead coder (0.3 - 0.5)",
442  u8" Dominik Scherer (dominik81) - Lead programmer, GUI expert (0.3 - 0.3)",
443  u8" Emil Djupfeld (egladil) - MacOSX (0.4.5 - 0.6)",
444  u8" Simon Sasburg (HackyKid) - Many bugfixes (0.4 - 0.4.5)",
445  u8" Ludvig Strigeus (ludde) - Original author of OpenTTD, main coder (0.1 - 0.3)",
446  u8" Cian Duffy (MYOB) - BeOS port / manual writing (0.1 - 0.3)",
447  u8" Petr Baudi\u0161 (pasky) - Many patches, NewGRF support (0.3 - 0.3)",
448  u8" Benedikt Br\u00fcggemeier (skidd13) - Bug fixer and code reworker (0.6 - 0.7)",
449  u8" Serge Paquet (vurlix) - 2nd contributor after ludde (0.1 - 0.3)",
450  u8"",
451  u8"Special thanks go out to:",
452  u8" Josef Drexler - For his great work on TTDPatch",
453  u8" Marcin Grzegorczyk - Track foundations and for describing TTD internals",
454  u8" Stefan Mei\u00dfner (sign_de) - For his work on the console",
455  u8" Mike Ragsdale - OpenTTD installer",
456  u8" Christian Rosentreter (tokai) - MorphOS / AmigaOS port",
457  u8" Richard Kempton (richK) - additional airports, initial TGP implementation",
458  u8" Alberto Demichelis - Squirrel scripting language \u00a9 2003-2008",
459  u8" L. Peter Deutsch - MD5 implementation \u00a9 1999, 2000, 2002",
460  u8" Michael Blunck - Pre-signals and semaphores \u00a9 2003",
461  u8" George - Canal/Lock graphics \u00a9 2003-2004",
462  u8" Andrew Parkhouse (andythenorth) - River graphics",
463  u8" David Dallaston (Pikka) - Tram tracks",
464  u8" All Translators - Who made OpenTTD a truly international game",
465  u8" Bug Reporters - Without whom OpenTTD would still be full of bugs!",
466  u8"",
467  u8"",
468  u8"And last but not least:",
469  u8" Chris Sawyer - For an amazing game!"
470 };
471 
472 struct AboutWindow : public Window {
475  static const int num_visible_lines = 19;
476 
477  static const uint TIMER_INTERVAL = 2100;
478  GUITimer timer;
479 
480  AboutWindow() : Window(&_about_desc)
481  {
483 
484  this->text_position = this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y + this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->current_y;
485  }
486 
487  void SetStringParameters(int widget) const override
488  {
489  if (widget == WID_A_WEBSITE) SetDParamStr(0, "Website: https://www.openttd.org");
490  if (widget == WID_A_COPYRIGHT) SetDParamStr(0, _openttd_revision_year);
491  }
492 
493  void UpdateWidgetSize(int widget, Dimension *size, const Dimension &padding, Dimension *fill, Dimension *resize) override
494  {
495  if (widget != WID_A_SCROLLING_TEXT) return;
496 
497  this->line_height = FONT_HEIGHT_NORMAL;
498 
499  Dimension d;
500  d.height = this->line_height * num_visible_lines;
501 
502  d.width = 0;
503  for (uint i = 0; i < lengthof(_credits); i++) {
504  d.width = std::max(d.width, GetStringBoundingBox(_credits[i]).width);
505  }
506  *size = maxdim(*size, d);
507 
508  /* Set scroll interval based on required speed. To keep scrolling smooth,
509  * the interval is adjusted rather than the distance moved. */
510  this->timer.SetInterval(TIMER_INTERVAL / FONT_HEIGHT_NORMAL);
511  }
512 
513  void DrawWidget(const Rect &r, int widget) const override
514  {
515  if (widget != WID_A_SCROLLING_TEXT) return;
516 
517  int y = this->text_position;
518 
519  /* Show all scrolling _credits */
520  for (uint i = 0; i < lengthof(_credits); i++) {
521  if (y >= r.top + 7 && y < r.bottom - this->line_height) {
522  DrawString(r.left, r.right, y, _credits[i], TC_BLACK, SA_LEFT | SA_FORCE);
523  }
524  y += this->line_height;
525  }
526  }
527 
528  void OnRealtimeTick(uint delta_ms) override
529  {
530  uint count = this->timer.CountElapsed(delta_ms);
531  if (count > 0) {
532  this->text_position -= count;
533  /* If the last text has scrolled start a new from the start */
534  if (this->text_position < (int)(this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y - lengthof(_credits) * this->line_height)) {
535  this->text_position = this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->pos_y + this->GetWidget<NWidgetBase>(WID_A_SCROLLING_TEXT)->current_y;
536  }
538  }
539  }
540 };
541 
542 void ShowAboutWindow()
543 {
545  new AboutWindow();
546 }
547 
554 void ShowEstimatedCostOrIncome(Money cost, int x, int y)
555 {
556  StringID msg = STR_MESSAGE_ESTIMATED_COST;
557 
558  if (cost < 0) {
559  cost = -cost;
560  msg = STR_MESSAGE_ESTIMATED_INCOME;
561  }
562  SetDParam(0, cost);
564 }
565 
573 void ShowCostOrIncomeAnimation(int x, int y, int z, Money cost)
574 {
575  if (cost == 0) {
576  return;
577  }
578  Point pt = RemapCoords(x, y, z);
579  StringID msg = STR_INCOME_FLOAT_COST;
580 
581  if (cost < 0) {
582  cost = -cost;
583  msg = STR_INCOME_FLOAT_INCOME;
584  }
585  SetDParam(0, cost);
586  AddTextEffect(msg, pt.x, pt.y, DAY_TICKS, TE_RISING);
587 }
588 
597 void ShowFeederIncomeAnimation(int x, int y, int z, Money transfer, Money income)
598 {
599  Point pt = RemapCoords(x, y, z);
600 
601  SetDParam(0, transfer);
602  if (income == 0) {
603  AddTextEffect(STR_FEEDER, pt.x, pt.y, DAY_TICKS, TE_RISING);
604  } else {
605  StringID msg = STR_FEEDER_COST;
606  if (income < 0) {
607  income = -income;
608  msg = STR_FEEDER_INCOME;
609  }
610  SetDParam(1, income);
611  AddTextEffect(msg, pt.x, pt.y, DAY_TICKS, TE_RISING);
612  }
613 }
614 
624 TextEffectID ShowFillingPercent(int x, int y, int z, uint8 percent, StringID string)
625 {
626  Point pt = RemapCoords(x, y, z);
627 
628  assert(string != STR_NULL);
629 
630  SetDParam(0, percent);
631  return AddTextEffect(string, pt.x, pt.y, 0, TE_STATIC);
632 }
633 
639 void UpdateFillingPercent(TextEffectID te_id, uint8 percent, StringID string)
640 {
641  assert(string != STR_NULL);
642 
643  SetDParam(0, percent);
644  UpdateTextEffect(te_id, string);
645 }
646 
651 void HideFillingPercent(TextEffectID *te_id)
652 {
653  if (*te_id == INVALID_TE_ID) return;
654 
655  RemoveTextEffect(*te_id);
656  *te_id = INVALID_TE_ID;
657 }
658 
659 static const NWidgetPart _nested_tooltips_widgets[] = {
660  NWidget(WWT_PANEL, COLOUR_GREY, WID_TT_BACKGROUND), SetMinimalSize(200, 32), EndContainer(),
661 };
662 
663 static WindowDesc _tool_tips_desc(
664  WDP_MANUAL, nullptr, 0, 0, // Coordinates and sizes are not used,
666  WDF_NO_FOCUS,
667  _nested_tooltips_widgets, lengthof(_nested_tooltips_widgets)
668 );
669 
671 struct TooltipsWindow : public Window
672 {
674  byte paramcount;
675  uint64 params[8];
676  TooltipCloseCondition close_cond;
677 
678  TooltipsWindow(Window *parent, StringID str, uint paramcount, const uint64 params[], TooltipCloseCondition close_tooltip) : Window(&_tool_tips_desc)
679  {
680  this->parent = parent;
681  this->string_id = str;
682  static_assert(sizeof(this->params[0]) == sizeof(params[0]));
683  assert(paramcount <= lengthof(this->params));
684  if (params == nullptr) {
685  _global_string_params.offset = 0;
686  params = _global_string_params.GetDataPointer();
687  }
688  if (paramcount > 0) memcpy(this->params, params, sizeof(this->params[0]) * paramcount);
689  this->paramcount = paramcount;
690  this->close_cond = close_tooltip;
691 
692  this->InitNested();
693 
694  CLRBITS(this->flags, WF_WHITE_BORDER);
695  }
696 
697  Point OnInitialPosition(int16 sm_width, int16 sm_height, int window_number) override
698  {
699  /* Find the free screen space between the main toolbar at the top, and the statusbar at the bottom.
700  * Add a fixed distance 2 so the tooltip floats free from both bars.
701  */
702  int scr_top = GetMainViewTop() + 2;
703  int scr_bot = GetMainViewBottom() - 2;
704 
705  Point pt;
706 
707  /* Correctly position the tooltip position, watch out for window and cursor size
708  * Clamp value to below main toolbar and above statusbar. If tooltip would
709  * go below window, flip it so it is shown above the cursor */
710  pt.y = Clamp(_cursor.pos.y + _cursor.total_size.y + _cursor.total_offs.y + 5, scr_top, scr_bot);
711  if (pt.y + sm_height > scr_bot) pt.y = std::min(_cursor.pos.y + _cursor.total_offs.y - 5, scr_bot) - sm_height;
712  pt.x = sm_width >= _screen.width ? 0 : Clamp(_cursor.pos.x - (sm_width >> 1), 0, _screen.width - sm_width);
713 
714  return pt;
715  }
716 
717  void UpdateWidgetSize(int widget, Dimension *size, const Dimension &padding, Dimension *fill, Dimension *resize) override
718  {
719  /* There is only one widget. */
720  for (uint i = 0; i != this->paramcount; i++) SetDParam(i, this->params[i]);
721 
722  size->width = std::min<uint>(GetStringBoundingBox(this->string_id).width, ScaleGUITrad(194));
723  size->height = GetStringHeight(this->string_id, size->width);
724 
725  /* Increase slightly to have some space around the box. */
726  size->width += 2 + WD_FRAMERECT_LEFT + WD_FRAMERECT_RIGHT;
727  size->height += 2 + WD_FRAMERECT_TOP + WD_FRAMERECT_BOTTOM;
728  }
729 
730  void DrawWidget(const Rect &r, int widget) const override
731  {
732  /* There is only one widget. */
733  GfxFillRect(r.left, r.top, r.right, r.bottom, PC_BLACK);
734  GfxFillRect(r.left + 1, r.top + 1, r.right - 1, r.bottom - 1, PC_LIGHT_YELLOW);
735 
736  for (uint arg = 0; arg < this->paramcount; arg++) {
737  SetDParam(arg, this->params[arg]);
738  }
739  DrawStringMultiLine(r.left + WD_FRAMERECT_LEFT, r.right - WD_FRAMERECT_RIGHT, r.top + WD_FRAMERECT_TOP, r.bottom - WD_FRAMERECT_BOTTOM, this->string_id, TC_FROMSTRING, SA_CENTER);
740  }
741 
742  void OnMouseLoop() override
743  {
744  /* Always close tooltips when the cursor is not in our window. */
745  if (!_cursor.in_window) {
746  this->Close();
747  return;
748  }
749 
750  /* We can show tooltips while dragging tools. These are shown as long as
751  * we are dragging the tool. Normal tooltips work with hover or rmb. */
752  switch (this->close_cond) {
753  case TCC_RIGHT_CLICK: if (!_right_button_down) this->Close(); break;
754  case TCC_HOVER: if (!_mouse_hovering) this->Close(); break;
755  case TCC_NONE: break;
756 
757  case TCC_EXIT_VIEWPORT: {
758  Window *w = FindWindowFromPt(_cursor.pos.x, _cursor.pos.y);
759  if (w == nullptr || IsPtInWindowViewport(w, _cursor.pos.x, _cursor.pos.y) == nullptr) this->Close();
760  break;
761  }
762  }
763  }
764 };
765 
774 void GuiShowTooltips(Window *parent, StringID str, uint paramcount, const uint64 params[], TooltipCloseCondition close_tooltip)
775 {
777 
778  if (str == STR_NULL || !_cursor.in_window) return;
779 
780  new TooltipsWindow(parent, str, paramcount, params, close_tooltip);
781 }
782 
783 void QueryString::HandleEditBox(Window *w, int wid)
784 {
785  if (w->IsWidgetGloballyFocused(wid) && this->text.HandleCaret()) {
786  w->SetWidgetDirty(wid);
787 
788  /* For the OSK also invalidate the parent window */
789  if (w->window_class == WC_OSK) w->InvalidateData();
790  }
791 }
792 
793 void QueryString::DrawEditBox(const Window *w, int wid) const
794 {
795  const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
796 
797  assert((wi->type & WWT_MASK) == WWT_EDITBOX);
798 
799  bool rtl = _current_text_dir == TD_RTL;
800  Dimension sprite_size = GetSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
801  int clearbtn_width = sprite_size.width + WD_IMGBTN_LEFT + WD_IMGBTN_RIGHT;
802 
803  int clearbtn_left = wi->pos_x + (rtl ? 0 : wi->current_x - clearbtn_width);
804  int clearbtn_right = wi->pos_x + (rtl ? clearbtn_width : wi->current_x) - 1;
805  int left = wi->pos_x + (rtl ? clearbtn_width : 0);
806  int right = wi->pos_x + (rtl ? wi->current_x : wi->current_x - clearbtn_width) - 1;
807 
808  int top = wi->pos_y;
809  int bottom = wi->pos_y + wi->current_y - 1;
810 
811  DrawFrameRect(clearbtn_left, top, clearbtn_right, bottom, wi->colour, wi->IsLowered() ? FR_LOWERED : FR_NONE);
812  DrawSprite(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT, PAL_NONE, clearbtn_left + WD_IMGBTN_LEFT + (wi->IsLowered() ? 1 : 0), (top + bottom - sprite_size.height) / 2 + (wi->IsLowered() ? 1 : 0));
813  if (this->text.bytes == 1) GfxFillRect(clearbtn_left + 1, top + 1, clearbtn_right - 1, bottom - 1, _colour_gradient[wi->colour & 0xF][2], FILLRECT_CHECKER);
814 
815  DrawFrameRect(left, top, right, bottom, wi->colour, FR_LOWERED | FR_DARKENED);
816  GfxFillRect(left + 1, top + 1, right - 1, bottom - 1, PC_BLACK);
817 
818  /* Limit the drawing of the string inside the widget boundaries */
819  DrawPixelInfo dpi;
820  if (!FillDrawPixelInfo(&dpi, left + WD_FRAMERECT_LEFT, top + WD_FRAMERECT_TOP, right - left - WD_FRAMERECT_RIGHT, bottom - top - WD_FRAMERECT_BOTTOM)) return;
821 
822  DrawPixelInfo *old_dpi = _cur_dpi;
823  _cur_dpi = &dpi;
824 
825  /* We will take the current widget length as maximum width, with a small
826  * space reserved at the end for the caret to show */
827  const Textbuf *tb = &this->text;
828  int delta = std::min(0, (right - left) - tb->pixels - 10);
829 
830  if (tb->caretxoffs + delta < 0) delta = -tb->caretxoffs;
831 
832  /* If we have a marked area, draw a background highlight. */
833  if (tb->marklength != 0) GfxFillRect(delta + tb->markxoffs, 0, delta + tb->markxoffs + tb->marklength - 1, bottom - top, PC_GREY);
834 
835  DrawString(delta, tb->pixels, 0, tb->buf, TC_YELLOW);
836  bool focussed = w->IsWidgetGloballyFocused(wid) || IsOSKOpenedFor(w, wid);
837  if (focussed && tb->caret) {
838  int caret_width = GetStringBoundingBox("_").width;
839  DrawString(tb->caretxoffs + delta, tb->caretxoffs + delta + caret_width, 0, "_", TC_WHITE);
840  }
841 
842  _cur_dpi = old_dpi;
843 }
844 
852 {
853  const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
854 
855  assert((wi->type & WWT_MASK) == WWT_EDITBOX);
856 
857  bool rtl = _current_text_dir == TD_RTL;
858  Dimension sprite_size = GetSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
859  int clearbtn_width = sprite_size.width + WD_IMGBTN_LEFT + WD_IMGBTN_RIGHT;
860 
861  int left = wi->pos_x + (rtl ? clearbtn_width : 0);
862  int right = wi->pos_x + (rtl ? wi->current_x : wi->current_x - clearbtn_width) - 1;
863 
864  /* Clamp caret position to be inside out current width. */
865  const Textbuf *tb = &this->text;
866  int delta = std::min(0, (right - left) - tb->pixels - 10);
867  if (tb->caretxoffs + delta < 0) delta = -tb->caretxoffs;
868 
869  Point pt = {left + WD_FRAMERECT_LEFT + tb->caretxoffs + delta, (int)wi->pos_y + WD_FRAMERECT_TOP};
870  return pt;
871 }
872 
881 Rect QueryString::GetBoundingRect(const Window *w, int wid, const char *from, const char *to) const
882 {
883  const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
884 
885  assert((wi->type & WWT_MASK) == WWT_EDITBOX);
886 
887  bool rtl = _current_text_dir == TD_RTL;
888  Dimension sprite_size = GetSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
889  int clearbtn_width = sprite_size.width + WD_IMGBTN_LEFT + WD_IMGBTN_RIGHT;
890 
891  int left = wi->pos_x + (rtl ? clearbtn_width : 0);
892  int right = wi->pos_x + (rtl ? wi->current_x : wi->current_x - clearbtn_width) - 1;
893 
894  int top = wi->pos_y + WD_FRAMERECT_TOP;
895  int bottom = wi->pos_y + wi->current_y - 1 - WD_FRAMERECT_BOTTOM;
896 
897  /* Clamp caret position to be inside our current width. */
898  const Textbuf *tb = &this->text;
899  int delta = std::min(0, (right - left) - tb->pixels - 10);
900  if (tb->caretxoffs + delta < 0) delta = -tb->caretxoffs;
901 
902  /* Get location of first and last character. */
903  Point p1 = GetCharPosInString(tb->buf, from, FS_NORMAL);
904  Point p2 = from != to ? GetCharPosInString(tb->buf, to, FS_NORMAL) : p1;
905 
906  Rect r = { Clamp(left + p1.x + delta + WD_FRAMERECT_LEFT, left, right), top, Clamp(left + p2.x + delta + WD_FRAMERECT_LEFT, left, right - WD_FRAMERECT_RIGHT), bottom };
907 
908  return r;
909 }
910 
918 const char *QueryString::GetCharAtPosition(const Window *w, int wid, const Point &pt) const
919 {
920  const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
921 
922  assert((wi->type & WWT_MASK) == WWT_EDITBOX);
923 
924  bool rtl = _current_text_dir == TD_RTL;
925  Dimension sprite_size = GetSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT);
926  int clearbtn_width = sprite_size.width + WD_IMGBTN_LEFT + WD_IMGBTN_RIGHT;
927 
928  int left = wi->pos_x + (rtl ? clearbtn_width : 0);
929  int right = wi->pos_x + (rtl ? wi->current_x : wi->current_x - clearbtn_width) - 1;
930 
931  int top = wi->pos_y + WD_FRAMERECT_TOP;
932  int bottom = wi->pos_y + wi->current_y - 1 - WD_FRAMERECT_BOTTOM;
933 
934  if (!IsInsideMM(pt.y, top, bottom)) return nullptr;
935 
936  /* Clamp caret position to be inside our current width. */
937  const Textbuf *tb = &this->text;
938  int delta = std::min(0, (right - left) - tb->pixels - 10);
939  if (tb->caretxoffs + delta < 0) delta = -tb->caretxoffs;
940 
941  return ::GetCharAtPosition(tb->buf, pt.x - delta - left);
942 }
943 
944 void QueryString::ClickEditBox(Window *w, Point pt, int wid, int click_count, bool focus_changed)
945 {
946  const NWidgetLeaf *wi = w->GetWidget<NWidgetLeaf>(wid);
947 
948  assert((wi->type & WWT_MASK) == WWT_EDITBOX);
949 
950  bool rtl = _current_text_dir == TD_RTL;
951  int clearbtn_width = GetSpriteSize(rtl ? SPR_IMG_DELETE_RIGHT : SPR_IMG_DELETE_LEFT).width;
952 
953  int clearbtn_left = wi->pos_x + (rtl ? 0 : wi->current_x - clearbtn_width);
954 
955  if (IsInsideBS(pt.x, clearbtn_left, clearbtn_width)) {
956  if (this->text.bytes > 1) {
957  this->text.DeleteAll();
958  w->HandleButtonClick(wid);
959  w->OnEditboxChanged(wid);
960  }
961  return;
962  }
963 
965  (!focus_changed || _settings_client.gui.osk_activation == OSKA_IMMEDIATELY) &&
966  (click_count == 2 || _settings_client.gui.osk_activation != OSKA_DOUBLE_CLICK)) {
967  /* Open the OSK window */
968  ShowOnScreenKeyboard(w, wid);
969  }
970 }
971 
973 struct QueryStringWindow : public Window
974 {
978 
979  QueryStringWindow(StringID str, StringID caption, uint max_bytes, uint max_chars, WindowDesc *desc, Window *parent, CharSetFilter afilter, QueryStringFlags flags) :
980  Window(desc), editbox(max_bytes, max_chars)
981  {
982  char *last_of = &this->editbox.text.buf[this->editbox.text.max_bytes - 1];
983  GetString(this->editbox.text.buf, str, last_of);
984  StrMakeValidInPlace(this->editbox.text.buf, last_of, SVS_NONE);
985 
986  /* Make sure the name isn't too long for the text buffer in the number of
987  * characters (not bytes). max_chars also counts the '\0' characters. */
988  while (Utf8StringLength(this->editbox.text.buf) + 1 > this->editbox.text.max_chars) {
989  *Utf8PrevChar(this->editbox.text.buf + strlen(this->editbox.text.buf)) = '\0';
990  }
991 
992  this->editbox.text.UpdateSize();
993 
994  if ((flags & QSF_ACCEPT_UNCHANGED) == 0) this->editbox.orig = stredup(this->editbox.text.buf);
995 
996  this->querystrings[WID_QS_TEXT] = &this->editbox;
997  this->editbox.caption = caption;
998  this->editbox.cancel_button = WID_QS_CANCEL;
999  this->editbox.ok_button = WID_QS_OK;
1000  this->editbox.text.afilter = afilter;
1001  this->flags = flags;
1002 
1003  this->InitNested(WN_QUERY_STRING);
1004  this->UpdateWarningStringSize();
1005 
1006  this->parent = parent;
1007 
1009  }
1010 
1011  void UpdateWarningStringSize()
1012  {
1013  if (this->flags & QSF_PASSWORD) {
1014  assert(this->nested_root->smallest_x > 0);
1016  this->warning_size.height = GetStringHeight(STR_WARNING_PASSWORD_SECURITY, this->warning_size.width);
1017  this->warning_size.height += WD_FRAMETEXT_TOP + WD_FRAMETEXT_BOTTOM + WD_FRAMERECT_TOP + WD_FRAMERECT_BOTTOM;
1018  } else {
1019  this->warning_size = Dimension{ 0, 0 };
1020  }
1021 
1022  this->ReInit();
1023  }
1024 
1025  void UpdateWidgetSize(int widget, Dimension *size, const Dimension &padding, Dimension *fill, Dimension *resize) override
1026  {
1027  if (widget == WID_QS_DEFAULT && (this->flags & QSF_ENABLE_DEFAULT) == 0) {
1028  /* We don't want this widget to show! */
1029  fill->width = 0;
1030  resize->width = 0;
1031  size->width = 0;
1032  }
1033 
1034  if (widget == WID_QS_WARNING) {
1035  *size = this->warning_size;
1036  }
1037  }
1038 
1039  void DrawWidget(const Rect &r, int widget) const override
1040  {
1041  if (widget != WID_QS_WARNING) return;
1042 
1043  if (this->flags & QSF_PASSWORD) {
1046  STR_WARNING_PASSWORD_SECURITY, TC_FROMSTRING, SA_CENTER);
1047  }
1048  }
1049 
1050  void SetStringParameters(int widget) const override
1051  {
1052  if (widget == WID_QS_CAPTION) SetDParam(0, this->editbox.caption);
1053  }
1054 
1055  void OnOk()
1056  {
1057  if (this->editbox.orig == nullptr || strcmp(this->editbox.text.buf, this->editbox.orig) != 0) {
1058  assert(this->parent != nullptr);
1059 
1060  this->parent->OnQueryTextFinished(this->editbox.text.buf);
1061  this->editbox.handled = true;
1062  }
1063  }
1064 
1065  void OnClick(Point pt, int widget, int click_count) override
1066  {
1067  switch (widget) {
1068  case WID_QS_DEFAULT:
1069  this->editbox.text.DeleteAll();
1070  FALLTHROUGH;
1071 
1072  case WID_QS_OK:
1073  this->OnOk();
1074  FALLTHROUGH;
1075 
1076  case WID_QS_CANCEL:
1077  this->Close();
1078  break;
1079  }
1080  }
1081 
1082  void Close() override
1083  {
1084  if (!this->editbox.handled && this->parent != nullptr) {
1085  Window *parent = this->parent;
1086  this->parent = nullptr; // so parent doesn't try to close us again
1087  parent->OnQueryTextFinished(nullptr);
1088  }
1089  this->Window::Close();
1090  }
1091 };
1092 
1093 static const NWidgetPart _nested_query_string_widgets[] = {
1095  NWidget(WWT_CLOSEBOX, COLOUR_GREY),
1096  NWidget(WWT_CAPTION, COLOUR_GREY, WID_QS_CAPTION), SetDataTip(STR_WHITE_STRING, STR_NULL),
1097  EndContainer(),
1098  NWidget(WWT_PANEL, COLOUR_GREY),
1099  NWidget(WWT_EDITBOX, COLOUR_GREY, WID_QS_TEXT), SetMinimalSize(256, 12), SetFill(1, 1), SetPadding(2, 2, 2, 2),
1100  EndContainer(),
1101  NWidget(WWT_PANEL, COLOUR_GREY, WID_QS_WARNING), EndContainer(),
1103  NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_QS_DEFAULT), SetMinimalSize(87, 12), SetFill(1, 1), SetDataTip(STR_BUTTON_DEFAULT, STR_NULL),
1104  NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_QS_CANCEL), SetMinimalSize(86, 12), SetFill(1, 1), SetDataTip(STR_BUTTON_CANCEL, STR_NULL),
1105  NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_QS_OK), SetMinimalSize(87, 12), SetFill(1, 1), SetDataTip(STR_BUTTON_OK, STR_NULL),
1106  EndContainer(),
1107 };
1108 
1109 static WindowDesc _query_string_desc(
1110  WDP_CENTER, "query_string", 0, 0,
1112  0,
1113  _nested_query_string_widgets, lengthof(_nested_query_string_widgets)
1114 );
1115 
1125 void ShowQueryString(StringID str, StringID caption, uint maxsize, Window *parent, CharSetFilter afilter, QueryStringFlags flags)
1126 {
1127  assert(parent != nullptr);
1128 
1130  new QueryStringWindow(str, caption, ((flags & QSF_LEN_IN_CHARS) ? MAX_CHAR_LENGTH : 1) * maxsize, maxsize, &_query_string_desc, parent, afilter, flags);
1131 }
1132 
1136 struct QueryWindow : public Window {
1138  uint64 params[10];
1141 
1143  {
1144  /* Create a backup of the variadic arguments to strings because it will be
1145  * overridden pretty often. We will copy these back for drawing */
1146  CopyOutDParam(this->params, 0, lengthof(this->params));
1147  this->caption = caption;
1148  this->message = message;
1149  this->proc = callback;
1150  this->parent = parent;
1151 
1153  }
1154 
1155  void Close() override
1156  {
1157  if (this->proc != nullptr) this->proc(this->parent, false);
1158  this->Window::Close();
1159  }
1160 
1161  void FindWindowPlacementAndResize(int def_width, int def_height) override
1162  {
1163  /* Position query window over the calling window, ensuring it's within screen bounds. */
1164  this->left = Clamp(parent->left + (parent->width / 2) - (this->width / 2), 0, _screen.width - this->width);
1165  this->top = Clamp(parent->top + (parent->height / 2) - (this->height / 2), 0, _screen.height - this->height);
1166  this->SetDirty();
1167  }
1168 
1169  void SetStringParameters(int widget) const override
1170  {
1171  switch (widget) {
1172  case WID_Q_CAPTION:
1173  CopyInDParam(1, this->params, lengthof(this->params));
1174  SetDParam(0, this->caption);
1175  break;
1176 
1177  case WID_Q_TEXT:
1178  CopyInDParam(0, this->params, lengthof(this->params));
1179  break;
1180  }
1181  }
1182 
1183  void UpdateWidgetSize(int widget, Dimension *size, const Dimension &padding, Dimension *fill, Dimension *resize) override
1184  {
1185  if (widget != WID_Q_TEXT) return;
1186 
1187  Dimension d = GetStringMultiLineBoundingBox(this->message, *size);
1189  d.height += WD_FRAMERECT_TOP + WD_FRAMERECT_BOTTOM;
1190  *size = d;
1191  }
1192 
1193  void DrawWidget(const Rect &r, int widget) const override
1194  {
1195  if (widget != WID_Q_TEXT) return;
1196 
1198  this->message, TC_FROMSTRING, SA_CENTER);
1199  }
1200 
1201  void OnClick(Point pt, int widget, int click_count) override
1202  {
1203  switch (widget) {
1204  case WID_Q_YES: {
1205  /* in the Generate New World window, clicking 'Yes' causes
1206  * CloseNonVitalWindows() to be called - we shouldn't be in a window then */
1207  QueryCallbackProc *proc = this->proc;
1208  Window *parent = this->parent;
1209  /* Prevent the destructor calling the callback function */
1210  this->proc = nullptr;
1211  this->Close();
1212  if (proc != nullptr) {
1213  proc(parent, true);
1214  proc = nullptr;
1215  }
1216  break;
1217  }
1218  case WID_Q_NO:
1219  this->Close();
1220  break;
1221  }
1222  }
1223 
1224  EventState OnKeyPress(WChar key, uint16 keycode) override
1225  {
1226  /* ESC closes the window, Enter confirms the action */
1227  switch (keycode) {
1228  case WKC_RETURN:
1229  case WKC_NUM_ENTER:
1230  if (this->proc != nullptr) {
1231  this->proc(this->parent, true);
1232  this->proc = nullptr;
1233  }
1234  FALLTHROUGH;
1235 
1236  case WKC_ESC:
1237  this->Close();
1238  return ES_HANDLED;
1239  }
1240  return ES_NOT_HANDLED;
1241  }
1242 };
1243 
1244 static const NWidgetPart _nested_query_widgets[] = {
1246  NWidget(WWT_CLOSEBOX, COLOUR_RED),
1247  NWidget(WWT_CAPTION, COLOUR_RED, WID_Q_CAPTION), SetDataTip(STR_JUST_STRING, STR_NULL),
1248  EndContainer(),
1249  NWidget(WWT_PANEL, COLOUR_RED), SetPIP(8, 15, 8),
1250  NWidget(WWT_TEXT, COLOUR_RED, WID_Q_TEXT), SetMinimalSize(200, 12),
1251  NWidget(NWID_HORIZONTAL, NC_EQUALSIZE), SetPIP(20, 29, 20),
1252  NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_Q_NO), SetMinimalSize(71, 12), SetFill(1, 1), SetDataTip(STR_QUIT_NO, STR_NULL),
1253  NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_Q_YES), SetMinimalSize(71, 12), SetFill(1, 1), SetDataTip(STR_QUIT_YES, STR_NULL),
1254  EndContainer(),
1255  EndContainer(),
1256 };
1257 
1258 static WindowDesc _query_desc(
1259  WDP_CENTER, nullptr, 0, 0,
1261  WDF_MODAL,
1262  _nested_query_widgets, lengthof(_nested_query_widgets)
1263 );
1264 
1274 void ShowQuery(StringID caption, StringID message, Window *parent, QueryCallbackProc *callback)
1275 {
1276  if (parent == nullptr) parent = FindWindowById(WC_MAIN_WINDOW, 0);
1277 
1278  for (Window *w : Window::Iterate()) {
1279  if (w->window_class != WC_CONFIRM_POPUP_QUERY) continue;
1280 
1281  QueryWindow *qw = dynamic_cast<QueryWindow *>(w);
1282  if (qw->parent != parent || qw->proc != callback) continue;
1283 
1284  qw->Close();
1285  break;
1286  }
1287 
1288  new QueryWindow(&_query_desc, caption, message, parent, callback);
1289 }
ES_HANDLED
@ ES_HANDLED
The passed event is handled.
Definition: window_type.h:718
TileDesc::airport_class
StringID airport_class
Name of the airport class.
Definition: tile_cmd.h:58
AboutWindow::TIMER_INTERVAL
static const uint TIMER_INTERVAL
Scrolling interval, scaled by line text line height. This value chosen to maintain parity: 2100 / FON...
Definition: misc_gui.cpp:477
TileDesc::grf
const char * grf
newGRF used for the tile contents
Definition: tile_cmd.h:61
QueryWindow::FindWindowPlacementAndResize
void FindWindowPlacementAndResize(int def_width, int def_height) override
Resize window towards the default size.
Definition: misc_gui.cpp:1161
WD_FRAMERECT_TOP
@ WD_FRAMERECT_TOP
Offset at top to draw the frame rectangular area.
Definition: window_gui.h:64
IsInsideMM
static constexpr bool IsInsideMM(const T x, const size_t min, const size_t max) noexcept
Checks if a value is in an interval.
Definition: math_func.hpp:204
FindWindowFromPt
Window * FindWindowFromPt(int x, int y)
Do a search for a window at specific coordinates.
Definition: window.cpp:1811
QueryWindow::SetStringParameters
void SetStringParameters(int widget) const override
Initialize string parameters for a widget.
Definition: misc_gui.cpp:1169
ScrollMainWindowToTile
bool ScrollMainWindowToTile(TileIndex tile, bool instant)
Scrolls the viewport of the main window to a given location.
Definition: viewport.cpp:2446
QueryString::ok_button
int ok_button
Widget button of parent window to simulate when pressing OK in OSK.
Definition: querystring_gui.h:27
WChar
char32_t WChar
Type for wide characters, i.e.
Definition: string_type.h:35
querystring_gui.h
CopyOutDParam
void CopyOutDParam(uint64 *dst, int offs, int num)
Copy num string parameters from the global string parameter array to the dst array.
Definition: strings.cpp:139
Window::OnEditboxChanged
virtual void OnEditboxChanged(int widget)
The text in an editbox has been edited.
Definition: window_gui.h:726
ShowExtraViewportWindow
void ShowExtraViewportWindow(TileIndex tile=INVALID_TILE)
Show a new Extra Viewport window.
Definition: viewport_gui.cpp:168
Textbuf::max_bytes
uint16 max_bytes
the maximum size of the buffer in bytes (including terminating '\0')
Definition: textbuf_type.h:33
TooltipsWindow::paramcount
byte paramcount
Number of string parameters in string_id.
Definition: misc_gui.cpp:674
QSF_PASSWORD
@ QSF_PASSWORD
password entry box, show warning about password security
Definition: textbuf_gui.h:23
Dimension
Dimensions (a width and height) of a rectangle in 2D.
Definition: geometry_type.hpp:27
command_func.h
TE_RISING
@ TE_RISING
Make the text effect slowly go upwards.
Definition: texteff.hpp:21
Window::nested_root
NWidgetBase * nested_root
Root of the nested tree.
Definition: window_gui.h:324
SetPadding
static NWidgetPart SetPadding(uint8 top, uint8 right, uint8 bottom, uint8 left)
Widget part function for setting additional space around a widget.
Definition: widget_type.h:1141
Pool::PoolItem<&_company_pool >::GetIfValid
static Titem * GetIfValid(size_t index)
Returns Titem with given index.
Definition: pool_type.hpp:348
WID_Q_YES
@ WID_Q_YES
No button.
Definition: misc_widget.h:46
WC_LAND_INFO
@ WC_LAND_INFO
Land info window; Window numbers:
Definition: window_type.h:142
QSF_ACCEPT_UNCHANGED
@ QSF_ACCEPT_UNCHANGED
return success even when the text didn't change
Definition: textbuf_gui.h:20
ClosestTownFromTile
Town * ClosestTownFromTile(TileIndex tile, uint threshold)
Return the town closest (in distance or ownership) to a given tile, within a given threshold.
Definition: town_cmd.cpp:3598
guitimer_func.h
TileDesc::railtype
StringID railtype
Type of rail on the tile.
Definition: tile_cmd.h:63
Window::ReInit
void ReInit(int rx=0, int ry=0)
Re-initialize a window, and optionally change its size.
Definition: window.cpp:1004
company_base.h
TileDesc::owner
Owner owner[4]
Name of the owner(s)
Definition: tile_cmd.h:53
WWT_CAPTION
@ WWT_CAPTION
Window caption (window title between closebox and stickybox)
Definition: widget_type.h:59
WID_LI_BACKGROUND
@ WID_LI_BACKGROUND
Background of the window.
Definition: misc_widget.h:16
RemapCoords
static 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:82
TileDesc::station_class
StringID station_class
Class of station.
Definition: tile_cmd.h:56
WWT_LABEL
@ WWT_LABEL
Centered label.
Definition: widget_type.h:55
WID_A_COPYRIGHT
@ WID_A_COPYRIGHT
Copyright string.
Definition: misc_widget.h:28
Pool::PoolItem::index
Tindex index
Index of this pool item.
Definition: pool_type.hpp:235
LandInfoWindow::OnInvalidateData
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
Definition: misc_gui.cpp:362
CargoSpec::Get
static CargoSpec * Get(size_t index)
Retrieve cargo details for the given cargo ID.
Definition: cargotype.h:118
TE_STATIC
@ TE_STATIC
Keep the text effect static.
Definition: texteff.hpp:22
NWID_HORIZONTAL
@ NWID_HORIZONTAL
Horizontal container.
Definition: widget_type.h:73
WID_TT_BACKGROUND
@ WID_TT_BACKGROUND
Background of the window.
Definition: misc_widget.h:21
CargoArray
Class for storing amounts of cargo.
Definition: cargo_type.h:82
AboutWindow::OnRealtimeTick
void OnRealtimeTick(uint delta_ms) override
Called periodically.
Definition: misc_gui.cpp:528
OSKA_DISABLED
@ OSKA_DISABLED
The OSK shall not be activated at all.
Definition: misc_gui.cpp:43
AboutWindow::UpdateWidgetSize
void UpdateWidgetSize(int 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:493
maxdim
Dimension maxdim(const Dimension &d1, const Dimension &d2)
Compute bounding box of both dimensions.
Definition: geometry_func.cpp:22
FindWindowById
Window * FindWindowById(WindowClass cls, WindowNumber number)
Find a window by its class and window number.
Definition: window.cpp:1146
TileDesc::tram_speed
uint16 tram_speed
Speed limit of tram (bridges and track)
Definition: tile_cmd.h:68
GetTileZ
int GetTileZ(TileIndex tile)
Get bottom height of the tile.
Definition: tile_map.cpp:121
_me
TileExtended * _me
Extended Tiles of the map.
Definition: map.cpp:31
HideFillingPercent
void HideFillingPercent(TextEffectID *te_id)
Hide vehicle loading indicators.
Definition: misc_gui.cpp:651
TileIndex
The index/ID of a Tile.
Definition: tile_type.h:85
WDF_NO_FOCUS
@ WDF_NO_FOCUS
This window won't get focus/make any other window lose focus when click.
Definition: window_gui.h:212
TooltipsWindow::UpdateWidgetSize
void UpdateWidgetSize(int 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:717
_ctrl_pressed
bool _ctrl_pressed
Is Ctrl pressed?
Definition: gfx.cpp:38
FILLRECT_CHECKER
@ FILLRECT_CHECKER
Draw only every second pixel, used for greying-out.
Definition: gfx_type.h:288
Textbuf::caretxoffs
uint16 caretxoffs
the current position of the caret in pixels
Definition: textbuf_type.h:40
zoom_func.h
NWidgetLeaf
Leaf widget.
Definition: widget_type.h:817
WD_FRAMETEXT_TOP
@ WD_FRAMETEXT_TOP
Top offset of the text of the frame.
Definition: window_gui.h:74
UpdateFillingPercent
void UpdateFillingPercent(TextEffectID te_id, uint8 percent, StringID string)
Update vehicle loading indicators.
Definition: misc_gui.cpp:639
_settings_client
ClientSettings _settings_client
The current settings for this game.
Definition: settings.cpp:53
WC_OSK
@ WC_OSK
On Screen Keyboard; Window numbers:
Definition: window_type.h:154
DrawString
int DrawString(int left, int right, int top, const char *str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly truncated to make it fit in its allocated space.
Definition: gfx.cpp:645
WWT_EMPTY
@ WWT_EMPTY
Empty widget, place holder to reserve space in widget array.
Definition: widget_type.h:46
newgrf_debug.h
town.h
TileY
static uint TileY(TileIndex tile)
Get the Y component of a tile.
Definition: map_func.h:215
TileDesc::airport_tile_name
StringID airport_tile_name
Name of the airport tile.
Definition: tile_cmd.h:60
WID_QS_DEFAULT
@ WID_QS_DEFAULT
Default button.
Definition: misc_widget.h:36
IsOSKOpenedFor
bool IsOSKOpenedFor(const Window *w, int button)
Check whether the OSK is opened for a specific editbox.
Definition: osk_gui.cpp:440
FR_LOWERED
@ FR_LOWERED
If set the frame is lowered and the background colour brighter (ie. buttons when pressed)
Definition: window_gui.h:31
LandInfoWindow::OnClick
void OnClick(Point pt, int widget, int click_count) override
A click with the left mouse button has been made on the window.
Definition: misc_gui.cpp:344
WID_Q_NO
@ WID_Q_NO
Yes button.
Definition: misc_widget.h:45
QueryStringWindow::Close
void Close() override
Hide the window and all its child windows, and mark them for a later deletion.
Definition: misc_gui.cpp:1082
QueryString::GetCharAtPosition
const char * GetCharAtPosition(const Window *w, int wid, const Point &pt) const
Get the character that is rendered at a position.
Definition: misc_gui.cpp:918
Window::HandleButtonClick
void HandleButtonClick(byte widget)
Do all things to make a button look clicked and mark it to be unclicked in a few ticks.
Definition: window.cpp:646
WD_FRAMETEXT_LEFT
@ WD_FRAMETEXT_LEFT
Left offset of the text of the frame.
Definition: window_gui.h:72
_colour_gradient
byte _colour_gradient[COLOUR_END][8]
All 16 colour gradients 8 colours per gradient from darkest (0) to lightest (7)
Definition: gfx.cpp:55
TileDesc
Tile description for the 'land area information' tool.
Definition: tile_cmd.h:51
AboutWindow::text_position
int text_position
The top of the scrolling text.
Definition: misc_gui.cpp:473
SetDParam
static void SetDParam(uint n, uint64 v)
Set a string parameter v at index n in the global string parameter array.
Definition: strings_func.h:196
TileDesc::airport_name
StringID airport_name
Name of the airport.
Definition: tile_cmd.h:59
NWidgetPart
Partial widget specification to allow NWidgets to be written nested.
Definition: widget_type.h:973
TooltipsWindow::params
uint64 params[8]
The string parameters.
Definition: misc_gui.cpp:675
SetDataTip
static NWidgetPart SetDataTip(uint32 data, StringID tip)
Widget part function for setting the data and tooltip.
Definition: widget_type.h:1109
QueryString
Data stored about a string that can be modified in the GUI.
Definition: querystring_gui.h:20
QueryStringWindow::flags
QueryStringFlags flags
Flags controlling behaviour of the window.
Definition: misc_gui.cpp:976
Textbuf::pixels
uint16 pixels
the current size of the string in pixels
Definition: textbuf_type.h:37
CommandCost::Succeeded
bool Succeeded() const
Did this command succeed?
Definition: command_type.h:151
GetStringBoundingBox
Dimension GetStringBoundingBox(const char *str, FontSize start_fontsize)
Return the string dimension in pixels.
Definition: gfx.cpp:891
QueryStringWindow::DrawWidget
void DrawWidget(const Rect &r, int widget) const override
Draw the contents of a nested widget.
Definition: misc_gui.cpp:1039
QueryStringWindow::editbox
QueryString editbox
Editbox.
Definition: misc_gui.cpp:975
Textbuf::buf
char *const buf
buffer in which text is saved
Definition: textbuf_type.h:32
TileX
static uint TileX(TileIndex tile)
Get the X component of a tile.
Definition: map_func.h:205
Window::querystrings
SmallMap< int, QueryString * > querystrings
QueryString associated to WWT_EDITBOX widgets.
Definition: window_gui.h:323
ShowErrorMessage
void ShowErrorMessage(StringID summary_msg, StringID detailed_msg, WarningLevel wl, int x=0, int y=0, const GRFFile *textref_stack_grffile=nullptr, uint textref_stack_size=0, const uint32 *textref_stack=nullptr)
Display an error message in a window.
Definition: error_gui.cpp:383
DrawStringMultiLine
int DrawStringMultiLine(int left, int right, int top, int bottom, const char *str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly over multiple lines.
Definition: gfx.cpp:790
TooltipsWindow
Window for displaying a tooltip.
Definition: misc_gui.cpp:671
QSF_LEN_IN_CHARS
@ QSF_LEN_IN_CHARS
the length of the string is counted in characters
Definition: textbuf_gui.h:22
MAX_CHAR_LENGTH
static const int MAX_CHAR_LENGTH
Max. length of UTF-8 encoded unicode character.
Definition: strings_type.h:18
QueryWindow::Close
void Close() override
Hide the window and all its child windows, and mark them for a later deletion.
Definition: misc_gui.cpp:1155
QueryWindow::caption
StringID caption
title of window
Definition: misc_gui.cpp:1140
WindowDesc
High level window description.
Definition: window_gui.h:168
GetGrfSpecFeature
GrfSpecFeature GetGrfSpecFeature(TileIndex tile)
Get the GrfSpecFeature associated with the tile.
Definition: newgrf_debug_gui.cpp:768
TileDesc::build_date
Date build_date
Date of construction of tile contents.
Definition: tile_cmd.h:55
WID_QS_CAPTION
@ WID_QS_CAPTION
Caption of the window.
Definition: misc_widget.h:33
LandInfoWindow::DrawWidget
void DrawWidget(const Rect &r, int widget) const override
Draw the contents of a nested widget.
Definition: misc_gui.cpp:74
Utf8StringLength
size_t Utf8StringLength(const char *s)
Get the length of an UTF-8 encoded string in number of characters and thus not the number of bytes th...
Definition: string.cpp:435
NC_EQUALSIZE
@ NC_EQUALSIZE
Value of the NCB_EQUALSIZE flag.
Definition: widget_type.h:464
Window::GetWidget
const NWID * GetWidget(uint widnum) const
Get the nested widget with number widnum from the nested widget tree.
Definition: window_gui.h:908
WC_CONFIRM_POPUP_QUERY
@ WC_CONFIRM_POPUP_QUERY
Popup with confirm question; Window numbers:
Definition: window_type.h:122
ShowFillingPercent
TextEffectID ShowFillingPercent(int x, int y, int z, uint8 percent, StringID string)
Display vehicle loading indicators.
Definition: misc_gui.cpp:624
landscape_cmd.h
WC_QUERY_STRING
@ WC_QUERY_STRING
Query string window; Window numbers:
Definition: window_type.h:115
GUITimer
Definition: guitimer_func.h:13
WDP_AUTO
@ WDP_AUTO
Find a place automatically.
Definition: window_gui.h:156
Window::resize
ResizeInfo resize
Resize information.
Definition: window_gui.h:317
CommandCost
Common return value for all commands.
Definition: command_type.h:24
GuiShowTooltips
void GuiShowTooltips(Window *parent, StringID str, uint paramcount, const uint64 params[], TooltipCloseCondition close_tooltip)
Shows a tooltip.
Definition: misc_gui.cpp:774
WN_QUERY_STRING
@ WN_QUERY_STRING
Query string.
Definition: window_type.h:21
FS_NORMAL
@ FS_NORMAL
Index of the normal font in the font tables.
Definition: gfx_type.h:207
WID_Q_TEXT
@ WID_Q_TEXT
Text of the query.
Definition: misc_widget.h:44
Window::InitNested
void InitNested(WindowNumber number=0)
Perform complete initialization of the Window with nested widgets, to allow use.
Definition: window.cpp:1789
WWT_EDITBOX
@ WWT_EDITBOX
a textbox for typing
Definition: widget_type.h:69
NWidgetBase::type
WidgetType type
Type of the widget / nested widget.
Definition: widget_type.h:175
Window::height
int height
Height of the window (number of pixels down in y direction)
Definition: window_gui.h:315
LandInfoWindow
Definition: misc_gui.cpp:67
WF_WHITE_BORDER
@ WF_WHITE_BORDER
Window white border counter bit mask.
Definition: window_gui.h:242
QueryStringFlags
QueryStringFlags
Flags used in ShowQueryString() call.
Definition: textbuf_gui.h:18
Textbuf::marklength
uint16 marklength
the length of the marked area in pixels
Definition: textbuf_type.h:44
StrMakeValidInPlace
void StrMakeValidInPlace(char *str, const char *last, StringValidationSettings settings)
Scans the string for invalid characters and replaces then with a question mark '?' (if not ignored).
Definition: string.cpp:273
Window::SetDirty
void SetDirty() const
Mark entire window as dirty (in need of re-paint)
Definition: window.cpp:993
NWidgetBase::smallest_x
uint smallest_x
Smallest horizontal size of the widget in a filled window.
Definition: widget_type.h:183
WD_FRAMERECT_LEFT
@ WD_FRAMERECT_LEFT
Offset at left to draw the frame rectangular area.
Definition: window_gui.h:62
TileDesc::roadtype
StringID roadtype
Type of road on the tile.
Definition: tile_cmd.h:65
IsInsideBS
static bool IsInsideBS(const T x, const size_t base, const size_t size)
Checks if a value is between a window started at some base point.
Definition: math_func.hpp:188
QueryString::GetBoundingRect
Rect GetBoundingRect(const Window *w, int wid, const char *from, const char *to) const
Get the bounding rectangle for a range of the query string.
Definition: misc_gui.cpp:881
WN_CONFIRM_POPUP_QUERY
@ WN_CONFIRM_POPUP_QUERY
Query popup confirm.
Definition: window_type.h:24
WD_PAR_VSEP_NORMAL
@ WD_PAR_VSEP_NORMAL
Normal amount of vertical space between two paragraphs of text.
Definition: window_gui.h:139
WD_FRAMERECT_RIGHT
@ WD_FRAMERECT_RIGHT
Offset at right to draw the frame rectangular area.
Definition: window_gui.h:63
ES_NOT_HANDLED
@ ES_NOT_HANDLED
The passed event is not handled.
Definition: window_type.h:719
WD_FRAMERECT_BOTTOM
@ WD_FRAMERECT_BOTTOM
Offset at bottom to draw the frame rectangular area.
Definition: window_gui.h:65
WWT_PUSHTXTBTN
@ WWT_PUSHTXTBTN
Normal push-button (no toggle button) with text caption.
Definition: widget_type.h:104
QueryStringWindow::SetStringParameters
void SetStringParameters(int widget) const override
Initialize string parameters for a widget.
Definition: misc_gui.cpp:1050
QueryWindow::proc
QueryCallbackProc * proc
callback function executed on closing of popup. Window* points to parent, bool is true if 'yes' click...
Definition: misc_gui.cpp:1137
WD_FRAMETEXT_BOTTOM
@ WD_FRAMETEXT_BOTTOM
Bottom offset of the text of the frame.
Definition: window_gui.h:75
GetNameOfOwner
void GetNameOfOwner(Owner owner, TileIndex tile)
Set the right DParams to get the name of an owner.
Definition: company_cmd.cpp:284
TooltipsWindow::DrawWidget
void DrawWidget(const Rect &r, int widget) const override
Draw the contents of a nested widget.
Definition: misc_gui.cpp:730
StringParameters::offset
uint offset
Current offset in the data/type arrays.
Definition: strings_func.h:66
QueryStringWindow
Class for the string query window.
Definition: misc_gui.cpp:973
GetMainViewTop
int GetMainViewTop()
Return the top of the main view available for general use.
Definition: window.cpp:2105
_settings_game
GameSettings _settings_game
Game settings of a running game or the scenario editor.
Definition: settings.cpp:54
SA_FORCE
@ SA_FORCE
Force the alignment, i.e. don't swap for RTL languages.
Definition: gfx_type.h:340
CursorVars::total_size
Point total_size
union of sprite properties
Definition: gfx_type.h:131
GameSettings::economy
EconomySettings economy
settings to change the economy
Definition: settings_type.h:590
GetCharAtPosition
const char * GetCharAtPosition(const char *str, int x, FontSize start_fontsize)
Get the character from a string that is drawn at a specific position.
Definition: gfx.cpp:947
Window::parent
Window * parent
Parent window.
Definition: window_gui.h:332
WL_INFO
@ WL_INFO
Used for DoCommand-like (and some non-fatal AI GUI) errors/information.
Definition: error.h:22
_local_company
CompanyID _local_company
Company controlled by the human player at this client. Can also be COMPANY_SPECTATOR.
Definition: company_cmd.cpp:46
StringList
std::vector< std::string > StringList
Type for a list of strings.
Definition: string_type.h:58
Window::IsWidgetGloballyFocused
bool IsWidgetGloballyFocused(byte widget_index) const
Check if given widget has user input focus.
Definition: window_gui.h:437
safeguards.h
ShowQueryString
void ShowQueryString(StringID str, StringID caption, uint maxsize, Window *parent, CharSetFilter afilter, QueryStringFlags flags)
Show a query popup window with a textbox in it.
Definition: misc_gui.cpp:1125
Window::left
int left
x position of left edge of the window
Definition: window_gui.h:312
Window::flags
WindowFlags flags
Window flags.
Definition: window_gui.h:305
CommandCost::GetCost
Money GetCost() const
The costs as made up to this moment.
Definition: command_type.h:83
LandInfoWindow::OnInit
void OnInit() override
Notification that the nested widget tree gets initialized.
Definition: misc_gui.cpp:135
Textbuf::caret
bool caret
is the caret ("_") visible or not
Definition: textbuf_type.h:38
_mouse_hovering
bool _mouse_hovering
The mouse is hovering over the same point.
Definition: window.cpp:91
WID_A_WEBSITE
@ WID_A_WEBSITE
URL of OpenTTD website.
Definition: misc_widget.h:27
DrawSprite
void DrawSprite(SpriteID img, PaletteID pal, int x, int y, const SubSprite *sub, ZoomLevel zoom)
Draw a sprite, not in a viewport.
Definition: gfx.cpp:1044
WDF_MODAL
@ WDF_MODAL
The window is a modal child of some other window, meaning the parent is 'inactive'.
Definition: window_gui.h:211
GetStringMultiLineBoundingBox
Dimension GetStringMultiLineBoundingBox(StringID str, const Dimension &suggestion)
Calculate string bounding box for multi-line strings.
Definition: gfx.cpp:756
TooltipsWindow::OnMouseLoop
void OnMouseLoop() override
Called for every mouse loop run, which is at least once per (game) tick.
Definition: misc_gui.cpp:742
Point
Coordinates of a point in 2D.
Definition: geometry_type.hpp:21
Textbuf::afilter
CharSetFilter afilter
Allowed characters.
Definition: textbuf_type.h:31
TileDesc::station_name
StringID station_name
Type of station within the class.
Definition: tile_cmd.h:57
error.h
NWidgetCore::IsLowered
bool IsLowered() const
Return whether the widget is lowered.
Definition: widget_type.h:375
StringParameters::GetDataPointer
uint64 * GetDataPointer() const
Get a pointer to the current element in the data array.
Definition: strings_func.h:126
WWT_FRAME
@ WWT_FRAME
Frame.
Definition: widget_type.h:58
TileDesc::dparam
uint64 dparam[2]
Parameters of the str string.
Definition: tile_cmd.h:62
WD_FRAMETEXT_RIGHT
@ WD_FRAMETEXT_RIGHT
Right offset of the text of the frame.
Definition: window_gui.h:73
Window::SetFocusedWidget
bool SetFocusedWidget(int widget_index)
Set focus within this window to the given widget.
Definition: window.cpp:506
stdafx.h
ShowCostOrIncomeAnimation
void ShowCostOrIncomeAnimation(int x, int y, int z, Money cost)
Display animated income or costs on the map.
Definition: misc_gui.cpp:573
PC_BLACK
static const uint8 PC_BLACK
Black palette colour.
Definition: gfx_func.h:204
Window::window_number
WindowNumber window_number
Window number within the window class.
Definition: window_gui.h:307
GfxFillRect
void GfxFillRect(int left, int top, int right, int bottom, int colour, FillRectMode mode)
Applies a certain FillRectMode-operation to a rectangle [left, right] x [top, bottom] on the screen.
Definition: gfx.cpp:119
landscape.h
Window::InvalidateData
void InvalidateData(int data=0, bool gui_scope=true)
Mark this window's data as invalid (in need of re-computing)
Definition: window.cpp:3174
viewport_func.h
NWidgetBase::current_y
uint current_y
Current vertical size (after resizing).
Definition: widget_type.h:187
WC_NONE
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
Definition: window_type.h:37
SA_HOR_CENTER
@ SA_HOR_CENTER
Horizontally center the text.
Definition: gfx_type.h:329
Window::AllWindows
Iterable ensemble of all valid Windows.
Definition: window_gui.h:859
PC_GREY
static const uint8 PC_GREY
Grey palette colour.
Definition: gfx_func.h:206
LandInfoWindow::landinfo_data
StringList landinfo_data
Info lines to show.
Definition: misc_gui.cpp:68
QueryWindow::OnKeyPress
EventState OnKeyPress(WChar key, uint16 keycode) override
A key has been pressed.
Definition: misc_gui.cpp:1224
FillDrawPixelInfo
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:1772
GetStringHeight
int GetStringHeight(const char *str, int maxw, FontSize fontsize)
Calculates height of string (in pixels).
Definition: gfx.cpp:716
GetSpriteSize
Dimension GetSpriteSize(SpriteID sprid, Point *offset, ZoomLevel zoom)
Get the size of a sprite.
Definition: gfx.cpp:979
WWT_CLOSEBOX
@ WWT_CLOSEBOX
Close box (at top-left of a window)
Definition: widget_type.h:67
EconomySettings::dist_local_authority
byte dist_local_authority
distance for town local authority, default 20
Definition: settings_type.h:510
QueryWindow::params
uint64 params[10]
local copy of #_global_string_params
Definition: misc_gui.cpp:1138
texteff.hpp
string_func.h
OskActivation
OskActivation
Method to open the OSK.
Definition: misc_gui.cpp:42
StringID
uint32 StringID
Numeric value that represents a string, independent of the selected language.
Definition: strings_type.h:16
WWT_PUSHIMGBTN
@ WWT_PUSHIMGBTN
Normal push-button (no toggle button) with image caption.
Definition: widget_type.h:105
ShowQuery
void ShowQuery(StringID caption, StringID message, Window *parent, QueryCallbackProc *callback)
Show a modal confirmation window with standard 'yes' and 'no' buttons The window is aligned to the ce...
Definition: misc_gui.cpp:1274
Textbuf::bytes
uint16 bytes
the current size of the string in bytes (including terminating '\0')
Definition: textbuf_type.h:35
QueryString::cancel_button
int cancel_button
Widget button of parent window to simulate when pressing CANCEL in OSK.
Definition: querystring_gui.h:28
_current_company
CompanyID _current_company
Company currently doing an action.
Definition: company_cmd.cpp:47
rev.h
WC_GAME_OPTIONS
@ WC_GAME_OPTIONS
Game options window; Window numbers:
Definition: window_type.h:604
EndContainer
static NWidgetPart EndContainer()
Widget part function for denoting the end of a container (horizontal, vertical, WWT_FRAME,...
Definition: widget_type.h:1094
LandInfoWindow::IsNewGRFInspectable
bool IsNewGRFInspectable() const override
Is the data related to this window NewGRF inspectable?
Definition: misc_gui.cpp:334
ShowFeederIncomeAnimation
void ShowFeederIncomeAnimation(int x, int y, int z, Money transfer, Money income)
Display animated feeder income.
Definition: misc_gui.cpp:597
Clamp
static T Clamp(const T a, const T min, const T max)
Clamp a value between an interval.
Definition: math_func.hpp:77
strings_func.h
NWidgetBase::pos_x
int pos_x
Horizontal position of top-left corner of the widget in the window.
Definition: widget_type.h:189
QueryStringWindow::OnClick
void OnClick(Point pt, int widget, int click_count) override
A click with the left mouse button has been made on the window.
Definition: misc_gui.cpp:1065
INVALID_DATE
static const Date INVALID_DATE
Representation of an invalid date.
Definition: date_type.h:111
WWT_TEXT
@ WWT_TEXT
Pure simple text.
Definition: widget_type.h:56
PC_LIGHT_YELLOW
static const uint8 PC_LIGHT_YELLOW
Light yellow palette colour.
Definition: gfx_func.h:218
FONT_HEIGHT_NORMAL
#define FONT_HEIGHT_NORMAL
Height of characters in the normal (FS_NORMAL) font.
Definition: gfx_func.h:168
ScaleGUITrad
static int ScaleGUITrad(int value)
Scale traditional pixel dimensions to GUI zoom level.
Definition: zoom_func.h:107
NWidget
static NWidgetPart NWidget(WidgetType tp, Colours col, int16 idx=-1)
Widget part function for starting a new 'real' widget.
Definition: widget_type.h:1209
geometry_func.hpp
AboutWindow::SetStringParameters
void SetStringParameters(int widget) const override
Initialize string parameters for a widget.
Definition: misc_gui.cpp:487
WID_A_SCROLLING_TEXT
@ WID_A_SCROLLING_TEXT
The actually scrolling text.
Definition: misc_widget.h:26
CloseWindowByClass
void CloseWindowByClass(WindowClass cls)
Close all windows of a given class.
Definition: window.cpp:1188
SetMinimalSize
static NWidgetPart SetMinimalSize(int16 x, int16 y)
Widget part function for setting the minimal size.
Definition: widget_type.h:1012
WC_TOOLTIPS
@ WC_TOOLTIPS
Tooltip window; Window numbers:
Definition: window_type.h:108
Textbuf::UpdateSize
void UpdateSize()
Update Textbuf type with its actual physical character and screenlength Get the count of characters i...
Definition: textbuf.cpp:430
LandInfoWindow::ShowNewGRFInspectWindow
void ShowNewGRFInspectWindow() const override
Show the NewGRF inspection window.
Definition: misc_gui.cpp:339
WWT_PANEL
@ WWT_PANEL
Simple depressed panel.
Definition: widget_type.h:48
OWNER_NONE
@ OWNER_NONE
The tile has no ownership.
Definition: company_type.h:25
QueryWindow
Window used for asking the user a YES/NO question.
Definition: misc_gui.cpp:1136
QueryStringWindow::warning_size
Dimension warning_size
How much space to use for the warning text.
Definition: misc_gui.cpp:977
LandInfoWindow::UpdateWidgetSize
void UpdateWidgetSize(int 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:91
NUM_CARGO
@ NUM_CARGO
Maximal number of cargo types in a game.
Definition: cargo_type.h:65
AboutWindow::num_visible_lines
static const int num_visible_lines
The number of lines visible simultaneously.
Definition: misc_gui.cpp:475
OSKA_SINGLE_CLICK
@ OSKA_SINGLE_CLICK
Single click after focus click opens OSK.
Definition: misc_gui.cpp:45
EventState
EventState
State of handling an event.
Definition: window_type.h:717
ShowLandInfo
void ShowLandInfo(TileIndex tile)
Show land information window.
Definition: misc_gui.cpp:378
WID_QS_WARNING
@ WID_QS_WARNING
Warning label about password security.
Definition: misc_widget.h:35
QueryWindow::OnClick
void OnClick(Point pt, int widget, int click_count) override
A click with the left mouse button has been made on the window.
Definition: misc_gui.cpp:1201
GUISettings::osk_activation
uint8 osk_activation
Mouse gesture to trigger the OSK.
Definition: settings_type.h:170
GUITimer::CountElapsed
uint CountElapsed(uint delta)
Count how many times the interval has elapsed.
Definition: guitimer_func.h:40
Window::window_class
WindowClass window_class
Window class.
Definition: window_gui.h:306
NWidgetCore::colour
Colours colour
Colour of this widget.
Definition: widget_type.h:333
TileDesc::str
StringID str
Description of the tile.
Definition: tile_cmd.h:52
WC_MAIN_WINDOW
@ WC_MAIN_WINDOW
Main window; Window numbers:
Definition: window_type.h:43
OSKA_DOUBLE_CLICK
@ OSKA_DOUBLE_CLICK
Double click on the edit box opens OSK.
Definition: misc_gui.cpp:44
company_func.h
Window::top
int top
y position of top edge of the window
Definition: window_gui.h:313
SVS_NONE
@ SVS_NONE
Allow nothing and replace nothing.
Definition: string_type.h:49
stredup
char * stredup(const char *s, const char *last)
Create a duplicate of the given string.
Definition: string.cpp:138
IsPtInWindowViewport
Viewport * IsPtInWindowViewport(const Window *w, int x, int y)
Is a xy position inside the viewport of the window?
Definition: viewport.cpp:401
SA_LEFT
@ SA_LEFT
Left align the text.
Definition: gfx_type.h:328
DrawFrameRect
void DrawFrameRect(int left, int top, int right, int bottom, Colours colour, FrameFlags flags)
Draw frame rectangle.
Definition: widget.cpp:209
CommandHelper
Definition: command_func.h:94
window_func.h
SA_CENTER
@ SA_CENTER
Center both horizontally and vertically.
Definition: gfx_type.h:338
Debug
#define Debug(name, level, format_string,...)
Ouptut a line of debugging information.
Definition: debug.h:37
Town
Town data structure.
Definition: town.h:50
lengthof
#define lengthof(x)
Return the length of an fixed size array.
Definition: stdafx.h:386
Window::width
int width
width of the window (number of pixels to the right in x direction)
Definition: window_gui.h:314
TooltipsWindow::string_id
StringID string_id
String to display as tooltip.
Definition: misc_gui.cpp:673
TileDesc::rail_speed
uint16 rail_speed
Speed limit of rail (bridges and track)
Definition: tile_cmd.h:64
WID_Q_CAPTION
@ WID_Q_CAPTION
Caption of the window.
Definition: misc_widget.h:43
WID_QS_OK
@ WID_QS_OK
OK button.
Definition: misc_widget.h:38
WDP_MANUAL
@ WDP_MANUAL
Manually align the window (so no automatic location finding)
Definition: window_gui.h:155
SetPIP
static NWidgetPart SetPIP(uint8 pre, uint8 inter, uint8 post)
Widget part function for setting a pre/inter/post spaces.
Definition: widget_type.h:1171
OverflowSafeInt< int64 >
FR_DARKENED
@ FR_DARKENED
If set the background is darker, allows for lowered frames with normal background colour when used wi...
Definition: window_gui.h:32
CargoID
byte CargoID
Cargo slots to indicate a cargo type within a game.
Definition: cargo_type.h:20
CloseWindowById
void CloseWindowById(WindowClass cls, WindowNumber number, bool force)
Close a window by its class and window number (if it is open).
Definition: window.cpp:1176
NWidgetBase::pos_y
int pos_y
Vertical position of top-left corner of the widget in the window.
Definition: widget_type.h:190
WID_QS_CANCEL
@ WID_QS_CANCEL
Cancel button.
Definition: misc_widget.h:37
QueryWindow::DrawWidget
void DrawWidget(const Rect &r, int widget) const override
Draw the contents of a nested widget.
Definition: misc_gui.cpp:1193
QueryString::GetCaretPosition
Point GetCaretPosition(const Window *w, int wid) const
Get the current caret position.
Definition: misc_gui.cpp:851
IsNewGRFInspectable
bool IsNewGRFInspectable(GrfSpecFeature feature, uint index)
Can we inspect the data given a certain feature and index.
Definition: newgrf_debug_gui.cpp:756
SetFill
static NWidgetPart SetFill(uint fill_x, uint fill_y)
Widget part function for setting filling.
Definition: widget_type.h:1078
TileDesc::owner_type
StringID owner_type[4]
Type of each owner.
Definition: tile_cmd.h:54
ShowOnScreenKeyboard
void ShowOnScreenKeyboard(Window *parent, int button)
Show the on-screen keyboard (osk) associated with a given textbox.
Definition: osk_gui.cpp:408
gui.h
TooltipsWindow::close_cond
TooltipCloseCondition close_cond
Condition for closing the window.
Definition: misc_gui.cpp:676
Window
Data structure for an opened window.
Definition: window_gui.h:279
QueryCallbackProc
void QueryCallbackProc(Window *, bool)
Callback procedure for the ShowQuery method.
Definition: textbuf_gui.h:29
WID_QS_TEXT
@ WID_QS_TEXT
Text of the query.
Definition: misc_widget.h:34
TileDesc::tramtype
StringID tramtype
Type of tram on the tile.
Definition: tile_cmd.h:67
Window::OnQueryTextFinished
virtual void OnQueryTextFinished(char *str)
The query window opened from this window has closed.
Definition: window_gui.h:734
DC_QUERY_COST
@ DC_QUERY_COST
query cost only, don't build.
Definition: command_type.h:352
WD_IMGBTN_LEFT
@ WD_IMGBTN_LEFT
Left offset of the image in the button.
Definition: window_gui.h:40
Window::SetWidgetDirty
void SetWidgetDirty(byte widget_index) const
Invalidate a widget, i.e.
Definition: window.cpp:608
GetMainViewBottom
int GetMainViewBottom()
Return the bottom of the main view available for general use.
Definition: window.cpp:2116
WWT_DEBUGBOX
@ WWT_DEBUGBOX
NewGRF debug box (at top-right of a window, between WWT_CAPTION and WWT_SHADEBOX)
Definition: widget_type.h:61
Rect
Specification of a rectangle with absolute coordinates of all edges.
Definition: geometry_type.hpp:47
CursorVars::pos
Point pos
logical mouse position
Definition: gfx_type.h:117
Company
Definition: company_base.h:117
QueryWindow::UpdateWidgetSize
void UpdateWidgetSize(int 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:1183
QueryWindow::message
StringID message
message shown for query window
Definition: misc_gui.cpp:1139
AboutWindow::line_height
int line_height
The height of a single line.
Definition: misc_gui.cpp:474
OWNER_WATER
@ OWNER_WATER
The tile/execution is done by "water".
Definition: company_type.h:26
GetCharPosInString
Point GetCharPosInString(const char *str, const char *ch, FontSize start_fontsize)
Get the leading corner of a character in a single-line string relative to the start of the string.
Definition: gfx.cpp:934
QSF_ENABLE_DEFAULT
@ QSF_ENABLE_DEFAULT
enable the 'Default' button ("\0" is returned)
Definition: textbuf_gui.h:21
CursorVars::in_window
bool in_window
mouse inside this window, determines drawing logic
Definition: gfx_type.h:141
CLRBITS
#define CLRBITS(x, y)
Clears several bits in a variable.
Definition: bitmath_func.hpp:166
NWidgetBase::current_x
uint current_x
Current horizontal size (after resizing).
Definition: widget_type.h:186
AboutWindow::DrawWidget
void DrawWidget(const Rect &r, int widget) const override
Draw the contents of a nested widget.
Definition: misc_gui.cpp:513
WID_LI_LOCATION
@ WID_LI_LOCATION
Scroll to location.
Definition: misc_widget.h:15
WD_IMGBTN_RIGHT
@ WD_IMGBTN_RIGHT
Right offset of the image in the button.
Definition: window_gui.h:41
WDP_CENTER
@ WDP_CENTER
Center the window.
Definition: window_gui.h:157
OSKA_IMMEDIATELY
@ OSKA_IMMEDIATELY
Focusing click already opens OSK.
Definition: misc_gui.cpp:46
Textbuf::DeleteAll
void CDECL void DeleteAll()
Delete every character in the textbuffer.
Definition: textbuf.cpp:116
TD_RTL
@ TD_RTL
Text is written right-to-left by default.
Definition: strings_type.h:24
DAY_TICKS
static const int DAY_TICKS
1 day is 74 ticks; _date_fract used to be uint16 and incremented by 885.
Definition: date_type.h:28
_m
Tile * _m
Tiles of the map.
Definition: map.cpp:30
_current_text_dir
TextDirection _current_text_dir
Text direction of the currently selected language.
Definition: strings.cpp:48
CharSetFilter
CharSetFilter
Valid filter types for IsValidChar.
Definition: string_type.h:26
misc_widget.h
WD_TEXTPANEL_BOTTOM
@ WD_TEXTPANEL_BOTTOM
Offset at bottom to draw below the text.
Definition: window_gui.h:69
_right_button_down
bool _right_button_down
Is right mouse button pressed?
Definition: gfx.cpp:43
CopyInDParam
void CopyInDParam(int offs, const uint64 *src, int num)
Copy num string parameters from array src into the global string parameter array.
Definition: strings.cpp:128
WN_GAME_OPTIONS_ABOUT
@ WN_GAME_OPTIONS_ABOUT
About window.
Definition: window_type.h:16
SetDParamStr
void SetDParamStr(uint n, const char *str)
This function is used to "bind" a C string to a OpenTTD dparam slot.
Definition: strings.cpp:296
WWT_TEXTBTN
@ WWT_TEXTBTN
(Toggle) Button with text
Definition: widget_type.h:53
Utf8PrevChar
static char * Utf8PrevChar(char *s)
Retrieve the previous UNICODE character in an UTF-8 encoded string.
Definition: string_func.h:160
INVALID_STRING_ID
static const StringID INVALID_STRING_ID
Constant representing an invalid string (16bit in case it is used in savegames)
Definition: strings_type.h:17
LandInfoWindow::cargo_acceptance
std::string cargo_acceptance
Centered multi-line string for cargo acceptance.
Definition: misc_gui.cpp:69
ClientSettings::gui
GUISettings gui
settings related to the GUI
Definition: settings_type.h:598
debug.h
ShowEstimatedCostOrIncome
void ShowEstimatedCostOrIncome(Money cost, int x, int y)
Display estimated costs.
Definition: misc_gui.cpp:554
DrawPixelInfo
Data about how and where to blit pixels.
Definition: gfx_type.h:155
QueryStringWindow::UpdateWidgetSize
void UpdateWidgetSize(int 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:1025
WD_TEXTPANEL_TOP
@ WD_TEXTPANEL_TOP
Offset at top to draw above the text.
Definition: window_gui.h:68
AboutWindow
Definition: misc_gui.cpp:472
Textbuf
Helper/buffer for input fields.
Definition: textbuf_type.h:30
Window::Close
virtual void Close()
Hide the window and all its child windows, and mark them for a later deletion.
Definition: window.cpp:1092
TileDesc::road_speed
uint16 road_speed
Speed limit of road (bridges and track)
Definition: tile_cmd.h:66
TooltipsWindow::OnInitialPosition
Point OnInitialPosition(int16 sm_width, int16 sm_height, int window_number) override
Compute the initial position of the window.
Definition: misc_gui.cpp:697
Textbuf::markxoffs
uint16 markxoffs
the start position of the marked area in pixels
Definition: textbuf_type.h:43