OpenTTD
signs_gui.cpp
Go to the documentation of this file.
1 /* $Id: signs_gui.cpp 27381 2015-08-10 20:24:13Z michi_cc $ */
2 
3 /*
4  * This file is part of OpenTTD.
5  * 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.
6  * 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.
7  * 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/>.
8  */
9 
12 #include "stdafx.h"
13 #include "company_gui.h"
14 #include "company_func.h"
15 #include "signs_base.h"
16 #include "signs_func.h"
17 #include "debug.h"
18 #include "command_func.h"
19 #include "strings_func.h"
20 #include "window_func.h"
21 #include "map_func.h"
22 #include "viewport_func.h"
23 #include "querystring_gui.h"
24 #include "sortlist_type.h"
25 #include "stringfilter_type.h"
26 #include "string_func.h"
27 #include "core/geometry_func.hpp"
28 #include "hotkeys.h"
29 #include "transparency.h"
30 
31 #include "widgets/sign_widget.h"
32 
33 #include "table/strings.h"
34 #include "table/sprites.h"
35 
36 #include "safeguards.h"
37 
38 struct SignList {
43 
44  static const Sign *last_sign;
45  GUISignList signs;
46 
48  static bool match_case;
49 
54  {
55  }
56 
57  void BuildSignsList()
58  {
59  if (!this->signs.NeedRebuild()) return;
60 
61  DEBUG(misc, 3, "Building sign list");
62 
63  this->signs.Clear();
64 
65  const Sign *si;
66  FOR_ALL_SIGNS(si) *this->signs.Append() = si;
67 
68  this->signs.SetFilterState(true);
69  this->FilterSignList();
70  this->signs.Compact();
71  this->signs.RebuildDone();
72  }
73 
75  static int CDECL SignNameSorter(const Sign * const *a, const Sign * const *b)
76  {
77  static char buf_cache[64];
78  char buf[64];
79 
80  SetDParam(0, (*a)->index);
81  GetString(buf, STR_SIGN_NAME, lastof(buf));
82 
83  if (*b != last_sign) {
84  last_sign = *b;
85  SetDParam(0, (*b)->index);
86  GetString(buf_cache, STR_SIGN_NAME, lastof(buf_cache));
87  }
88 
89  int r = strnatcmp(buf, buf_cache); // Sort by name (natural sorting).
90 
91  return r != 0 ? r : ((*a)->index - (*b)->index);
92  }
93 
94  void SortSignsList()
95  {
96  if (!this->signs.Sort(&SignNameSorter)) return;
97 
98  /* Reset the name sorter sort cache */
99  this->last_sign = NULL;
100  }
101 
103  static bool CDECL SignNameFilter(const Sign * const *a, StringFilter &filter)
104  {
105  /* Get sign string */
107  SetDParam(0, (*a)->index);
108  GetString(buf1, STR_SIGN_NAME, lastof(buf1));
109 
110  filter.ResetState();
111  filter.AddLine(buf1);
112  return filter.GetState();
113  }
114 
116  static bool CDECL OwnerDeityFilter(const Sign * const *a, StringFilter &filter)
117  {
118  /* You should never be able to edit signs of owner DEITY */
119  return (*a)->owner != OWNER_DEITY;
120  }
121 
123  static bool CDECL OwnerVisibilityFilter(const Sign * const *a, StringFilter &filter)
124  {
126  /* Hide sign if non-own signs are hidden in the viewport */
127  return (*a)->owner == _local_company || (*a)->owner == OWNER_DEITY;
128  }
129 
132  {
133  this->signs.Filter(&SignNameFilter, this->string_filter);
134  if (_game_mode != GM_EDITOR) this->signs.Filter(&OwnerDeityFilter, this->string_filter);
136  this->signs.Filter(&OwnerVisibilityFilter, this->string_filter);
137  }
138  }
139 };
140 
141 const Sign *SignList::last_sign = NULL;
142 bool SignList::match_case = false;
143 
147 };
148 
152  Scrollbar *vscroll;
153 
155  {
156  this->CreateNestedTree();
157  this->vscroll = this->GetScrollbar(WID_SIL_SCROLLBAR);
158  this->FinishInitNested(window_number);
159  this->SetWidgetLoweredState(WID_SIL_FILTER_MATCH_CASE_BTN, SignList::match_case);
160 
161  /* Initialize the text edit widget */
164 
165  /* Initialize the filtering variables */
166  this->SetFilterString("");
167 
168  /* Create initial list. */
169  this->signs.ForceRebuild();
170  this->signs.ForceResort();
171  this->BuildSortSignList();
172  }
173 
180  void SetFilterString(const char *new_filter_string)
181  {
182  /* check if there is a new filter string */
183  this->string_filter.SetFilterTerm(new_filter_string);
184 
185  /* Rebuild the list of signs */
186  this->InvalidateData();
187  }
188 
189  virtual void OnPaint()
190  {
191  if (this->signs.NeedRebuild()) this->BuildSortSignList();
192  this->DrawWidgets();
193  }
194 
195  virtual void DrawWidget(const Rect &r, int widget) const
196  {
197  switch (widget) {
198  case WID_SIL_LIST: {
199  uint y = r.top + WD_FRAMERECT_TOP; // Offset from top of widget.
200  /* No signs? */
201  if (this->vscroll->GetCount() == 0) {
202  DrawString(r.left + WD_FRAMETEXT_LEFT, r.right - WD_FRAMETEXT_RIGHT, y, STR_STATION_LIST_NONE);
203  return;
204  }
205 
206  bool rtl = _current_text_dir == TD_RTL;
207  int sprite_offset_y = (FONT_HEIGHT_NORMAL - 10) / 2 + 1;
208  uint icon_left = 4 + (rtl ? r.right - this->text_offset : r.left);
209  uint text_left = r.left + (rtl ? WD_FRAMERECT_LEFT : this->text_offset);
210  uint text_right = r.right - (rtl ? this->text_offset : WD_FRAMERECT_RIGHT);
211 
212  /* At least one sign available. */
213  for (uint16 i = this->vscroll->GetPosition(); this->vscroll->IsVisible(i) && i < this->vscroll->GetCount(); i++) {
214  const Sign *si = this->signs[i];
215 
216  if (si->owner != OWNER_NONE) DrawCompanyIcon(si->owner, icon_left, y + sprite_offset_y);
217 
218  SetDParam(0, si->index);
219  DrawString(text_left, text_right, y, STR_SIGN_NAME, TC_YELLOW);
220  y += this->resize.step_height;
221  }
222  break;
223  }
224  }
225  }
226 
227  virtual void SetStringParameters(int widget) const
228  {
229  if (widget == WID_SIL_CAPTION) SetDParam(0, this->vscroll->GetCount());
230  }
231 
232  virtual void OnClick(Point pt, int widget, int click_count)
233  {
234  switch (widget) {
235  case WID_SIL_LIST: {
236  uint id_v = this->vscroll->GetScrolledRowFromWidget(pt.y, this, WID_SIL_LIST, WD_FRAMERECT_TOP);
237  if (id_v == INT_MAX) return;
238 
239  const Sign *si = this->signs[id_v];
240  ScrollMainWindowToTile(TileVirtXY(si->x, si->y));
241  break;
242  }
243 
245  if (this->signs.Length() >= 1) {
246  const Sign *si = this->signs[0];
247  ScrollMainWindowToTile(TileVirtXY(si->x, si->y));
248  }
249  break;
250 
252  SignList::match_case = !SignList::match_case; // Toggle match case
253  this->SetWidgetLoweredState(WID_SIL_FILTER_MATCH_CASE_BTN, SignList::match_case); // Toggle button pushed state
254  this->InvalidateData(); // Rebuild the list of signs
255  break;
256  }
257  }
258 
259  virtual void OnResize()
260  {
262  }
263 
264  virtual void UpdateWidgetSize(int widget, Dimension *size, const Dimension &padding, Dimension *fill, Dimension *resize)
265  {
266  switch (widget) {
267  case WID_SIL_LIST: {
268  Dimension spr_dim = GetSpriteSize(SPR_COMPANY_ICON);
269  this->text_offset = WD_FRAMETEXT_LEFT + spr_dim.width + 2; // 2 pixels space between icon and the sign text.
270  resize->height = max<uint>(FONT_HEIGHT_NORMAL, spr_dim.height);
271  Dimension d = {(uint)(this->text_offset + WD_FRAMETEXT_RIGHT), WD_FRAMERECT_TOP + 5 * resize->height + WD_FRAMERECT_BOTTOM};
272  *size = maxdim(*size, d);
273  break;
274  }
275 
276  case WID_SIL_CAPTION:
278  *size = GetStringBoundingBox(STR_SIGN_LIST_CAPTION);
279  size->height += padding.height;
280  size->width += padding.width;
281  break;
282  }
283  }
284 
285  virtual EventState OnHotkey(int hotkey)
286  {
287  switch (hotkey) {
290  SetFocusedWindow(this); // The user has asked to give focus to the text box, so make sure this window is focused.
291  break;
292 
293  default:
294  return ES_NOT_HANDLED;
295  }
296 
297  return ES_HANDLED;
298  }
299 
300  virtual void OnEditboxChanged(int widget)
301  {
302  if (widget == WID_SIL_FILTER_TEXT) this->SetFilterString(this->filter_editbox.text.buf);
303  }
304 
305  void BuildSortSignList()
306  {
307  if (this->signs.NeedRebuild()) {
308  this->BuildSignsList();
309  this->vscroll->SetCount(this->signs.Length());
311  }
312  this->SortSignsList();
313  }
314 
315  virtual void OnHundredthTick()
316  {
317  this->BuildSortSignList();
318  this->SetDirty();
319  }
320 
326  virtual void OnInvalidateData(int data = 0, bool gui_scope = true)
327  {
328  /* When there is a filter string, we always need to rebuild the list even if
329  * the amount of signs in total is unchanged, as the subset of signs that is
330  * accepted by the filter might has changed. */
331  if (data == 0 || data == -1 || !this->string_filter.IsEmpty()) { // New or deleted sign, changed visibility setting or there is a filter string
332  /* This needs to be done in command-scope to enforce rebuilding before resorting invalid data */
333  this->signs.ForceRebuild();
334  } else { // Change of sign contents while there is no filter string
335  this->signs.ForceResort();
336  }
337  }
338 
339  static HotkeyList hotkeys;
340 };
341 
348 {
349  if (_game_mode == GM_MENU) return ES_NOT_HANDLED;
350  Window *w = ShowSignList();
351  if (w == NULL) return ES_NOT_HANDLED;
352  return w->OnHotkey(hotkey);
353 }
354 
355 static Hotkey signlist_hotkeys[] = {
356  Hotkey('F', "focus_filter_box", SLHK_FOCUS_FILTER_BOX),
357  HOTKEY_LIST_END
358 };
359 HotkeyList SignListWindow::hotkeys("signlist", signlist_hotkeys, SignListGlobalHotkeys);
360 
361 static const NWidgetPart _nested_sign_list_widgets[] = {
363  NWidget(WWT_CLOSEBOX, COLOUR_GREY),
364  NWidget(WWT_CAPTION, COLOUR_GREY, WID_SIL_CAPTION), SetDataTip(STR_SIGN_LIST_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
365  NWidget(WWT_SHADEBOX, COLOUR_GREY),
366  NWidget(WWT_DEFSIZEBOX, COLOUR_GREY),
367  NWidget(WWT_STICKYBOX, COLOUR_GREY),
368  EndContainer(),
374  NWidget(WWT_PANEL, COLOUR_GREY), SetFill(1, 1),
375  NWidget(WWT_EDITBOX, COLOUR_GREY, WID_SIL_FILTER_TEXT), SetMinimalSize(80, 12), SetResize(1, 0), SetFill(1, 0), SetPadding(2, 2, 2, 2),
376  SetDataTip(STR_LIST_FILTER_OSKTITLE, STR_LIST_FILTER_TOOLTIP),
377  EndContainer(),
378  NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_SIL_FILTER_MATCH_CASE_BTN), SetDataTip(STR_SIGN_LIST_MATCH_CASE, STR_SIGN_LIST_MATCH_CASE_TOOLTIP),
379  EndContainer(),
380  EndContainer(),
382  NWidget(NWID_VERTICAL), SetFill(0, 1),
384  EndContainer(),
385  NWidget(WWT_RESIZEBOX, COLOUR_GREY),
386  EndContainer(),
387  EndContainer(),
388 };
389 
390 static WindowDesc _sign_list_desc(
391  WDP_AUTO, "list_signs", 358, 138,
393  0,
394  _nested_sign_list_widgets, lengthof(_nested_sign_list_widgets),
395  &SignListWindow::hotkeys
396 );
397 
404 {
405  return AllocateWindowDescFront<SignListWindow>(&_sign_list_desc, 0);
406 }
407 
414 static bool RenameSign(SignID index, const char *text)
415 {
416  bool remove = StrEmpty(text);
417  DoCommandP(0, index, 0, CMD_RENAME_SIGN | (StrEmpty(text) ? CMD_MSG(STR_ERROR_CAN_T_DELETE_SIGN) : CMD_MSG(STR_ERROR_CAN_T_CHANGE_SIGN_NAME)), NULL, text);
418  return remove;
419 }
420 
422  QueryString name_editbox;
423  SignID cur_sign;
424 
426  {
427  this->querystrings[WID_QES_TEXT] = &this->name_editbox;
428  this->name_editbox.caption = STR_EDIT_SIGN_CAPTION;
429  this->name_editbox.cancel_button = WID_QES_CANCEL;
430  this->name_editbox.ok_button = WID_QES_OK;
431 
433 
434  UpdateSignEditWindow(si);
436  }
437 
438  void UpdateSignEditWindow(const Sign *si)
439  {
440  /* Display an empty string when the sign hasn't been edited yet */
441  if (si->name != NULL) {
442  SetDParam(0, si->index);
443  this->name_editbox.text.Assign(STR_SIGN_NAME);
444  } else {
445  this->name_editbox.text.DeleteAll();
446  }
447 
448  this->cur_sign = si->index;
449 
452  }
453 
459  const Sign *PrevNextSign(bool next)
460  {
461  /* Rebuild the sign list */
462  this->signs.ForceRebuild();
463  this->signs.NeedResort();
464  this->BuildSignsList();
465  this->SortSignsList();
466 
467  /* Search through the list for the current sign, excluding
468  * - the first sign if we want the previous sign or
469  * - the last sign if we want the next sign */
470  uint end = this->signs.Length() - (next ? 1 : 0);
471  for (uint i = next ? 0 : 1; i < end; i++) {
472  if (this->cur_sign == this->signs[i]->index) {
473  /* We've found the current sign, so return the sign before/after it */
474  return this->signs[i + (next ? 1 : -1)];
475  }
476  }
477  /* If we haven't found the current sign by now, return the last/first sign */
478  return this->signs[next ? 0 : this->signs.Length() - 1];
479  }
480 
481  virtual void SetStringParameters(int widget) const
482  {
483  switch (widget) {
484  case WID_QES_CAPTION:
485  SetDParam(0, this->name_editbox.caption);
486  break;
487  }
488  }
489 
490  virtual void OnClick(Point pt, int widget, int click_count)
491  {
492  switch (widget) {
493  case WID_QES_PREVIOUS:
494  case WID_QES_NEXT: {
495  const Sign *si = this->PrevNextSign(widget == WID_QES_NEXT);
496 
497  /* Rebuild the sign list */
498  this->signs.ForceRebuild();
499  this->signs.NeedResort();
500  this->BuildSignsList();
501  this->SortSignsList();
502 
503  /* Scroll to sign and reopen window */
504  ScrollMainWindowToTile(TileVirtXY(si->x, si->y));
505  UpdateSignEditWindow(si);
506  break;
507  }
508 
509  case WID_QES_DELETE:
510  /* Only need to set the buffer to null, the rest is handled as the OK button */
511  RenameSign(this->cur_sign, "");
512  /* don't delete this, we are deleted in Sign::~Sign() -> DeleteRenameSignWindow() */
513  break;
514 
515  case WID_QES_OK:
516  if (RenameSign(this->cur_sign, this->name_editbox.text.buf)) break;
517  /* FALL THROUGH */
518 
519  case WID_QES_CANCEL:
520  delete this;
521  break;
522  }
523  }
524 };
525 
526 static const NWidgetPart _nested_query_sign_edit_widgets[] = {
528  NWidget(WWT_CLOSEBOX, COLOUR_GREY),
529  NWidget(WWT_CAPTION, COLOUR_GREY, WID_QES_CAPTION), SetDataTip(STR_WHITE_STRING, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
530  EndContainer(),
531  NWidget(WWT_PANEL, COLOUR_GREY),
532  NWidget(WWT_EDITBOX, COLOUR_GREY, WID_QES_TEXT), SetMinimalSize(256, 12), SetDataTip(STR_EDIT_SIGN_SIGN_OSKTITLE, STR_NULL), SetPadding(2, 2, 2, 2),
533  EndContainer(),
535  NWidget(WWT_PUSHTXTBTN, COLOUR_GREY, WID_QES_OK), SetMinimalSize(61, 12), SetDataTip(STR_BUTTON_OK, STR_NULL),
536  NWidget(WWT_PUSHTXTBTN, COLOUR_GREY, WID_QES_CANCEL), SetMinimalSize(60, 12), SetDataTip(STR_BUTTON_CANCEL, STR_NULL),
537  NWidget(WWT_PUSHTXTBTN, COLOUR_GREY, WID_QES_DELETE), SetMinimalSize(60, 12), SetDataTip(STR_TOWN_VIEW_DELETE_BUTTON, STR_NULL),
538  NWidget(WWT_PANEL, COLOUR_GREY), SetFill(1, 1), EndContainer(),
539  NWidget(WWT_PUSHARROWBTN, COLOUR_GREY, WID_QES_PREVIOUS), SetMinimalSize(11, 12), SetDataTip(AWV_DECREASE, STR_EDIT_SIGN_PREVIOUS_SIGN_TOOLTIP),
540  NWidget(WWT_PUSHARROWBTN, COLOUR_GREY, WID_QES_NEXT), SetMinimalSize(11, 12), SetDataTip(AWV_INCREASE, STR_EDIT_SIGN_NEXT_SIGN_TOOLTIP),
541  EndContainer(),
542 };
543 
544 static WindowDesc _query_sign_edit_desc(
545  WDP_CENTER, "query_sign", 0, 0,
548  _nested_query_sign_edit_widgets, lengthof(_nested_query_sign_edit_widgets)
549 );
550 
555 void HandleClickOnSign(const Sign *si)
556 {
557  if (_ctrl_pressed && (si->owner == _local_company || (si->owner == OWNER_DEITY && _game_mode == GM_EDITOR))) {
558  RenameSign(si->index, NULL);
559  return;
560  }
562 }
563 
568 void ShowRenameSignWindow(const Sign *si)
569 {
570  /* Delete all other edit windows */
572 
573  new SignWindow(&_query_sign_edit_desc, si);
574 }
575 
581 {
583 
584  if (w != NULL && w->cur_sign == sign) delete w;
585 }