OpenTTD Source 20260206-master-g4d4e37dbf1
script_gui.cpp
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <https://www.gnu.org/licenses/old-licenses/gpl-2.0>.
6 */
7
9
10#include "../stdafx.h"
11#include "../table/sprites.h"
12#include "../error.h"
13#include "../settings_gui.h"
14#include "../querystring_gui.h"
16#include "../company_base.h"
17#include "../company_gui.h"
18#include "../dropdown_type.h"
19#include "../dropdown_func.h"
20#include "../window_func.h"
21#include "../network/network.h"
22#include "../hotkeys.h"
23#include "../company_cmd.h"
24#include "../misc_cmd.h"
25#include "../strings_func.h"
26#include "../timer/timer.h"
29
30#include "script_gui.h"
31#include "script_log.hpp"
32#include "script_scanner.hpp"
33#include "script_config.hpp"
34#include "../ai/ai.hpp"
35#include "../ai/ai_config.hpp"
36#include "../ai/ai_info.hpp"
37#include "../ai/ai_instance.hpp"
38#include "../game/game.hpp"
40#include "../game/game_info.hpp"
42
43#include "table/strings.h"
44
45#include "../safeguards.h"
46
47
48static ScriptConfig *GetConfig(CompanyID slot)
49{
50 if (slot == OWNER_DEITY) return GameConfig::GetConfig();
51 return AIConfig::GetConfig(slot);
52}
53
57struct ScriptListWindow : public Window {
58 const ScriptInfoList *info_list = nullptr;
59 int selected = -1;
60 CompanyID slot{};
61 int line_height = 0;
62 Scrollbar *vscroll = nullptr;
63 bool show_all = false;
64
71 ScriptListWindow(WindowDesc &desc, CompanyID slot, bool show_all) : Window(desc),
73 {
74 if (this->slot == OWNER_DEITY) {
75 this->info_list = this->show_all ? Game::GetInfoList() : Game::GetUniqueInfoList();
76 } else {
77 this->info_list = this->show_all ? AI::GetInfoList() : AI::GetUniqueInfoList();
78 }
79
80 this->CreateNestedTree();
81 this->vscroll = this->GetScrollbar(WID_SCRL_SCROLLBAR);
82 this->FinishInitNested(); // Initializes 'this->line_height' as side effect.
83
84 this->vscroll->SetCount(this->info_list->size() + 1);
85
86 /* Try if we can find the currently selected AI */
87 if (GetConfig(this->slot)->HasScript()) {
88 ScriptInfo *info = GetConfig(this->slot)->GetInfo();
89 int i = 0;
90 for (const auto &item : *this->info_list) {
91 if (item.second == info) {
92 this->selected = i;
93 break;
94 }
95
96 i++;
97 }
98 }
99 }
100
101 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
102 {
103 if (widget != WID_SCRL_CAPTION) return this->Window::GetWidgetString(widget, stringid);
104
105 return GetString(STR_AI_LIST_CAPTION, (this->slot == OWNER_DEITY) ? STR_AI_LIST_CAPTION_GAMESCRIPT : STR_AI_LIST_CAPTION_AI);
106 }
107
108 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
109 {
110 if (widget != WID_SCRL_LIST) return;
111
112 this->line_height = GetCharacterHeight(FS_NORMAL) + padding.height;
113
114 resize.width = 1;
115 fill.height = resize.height = this->line_height;
116 size.height = 5 * this->line_height;
117 }
118
119 void DrawWidget(const Rect &r, WidgetID widget) const override
120 {
121 switch (widget) {
122 case WID_SCRL_LIST: {
123 /* Draw a list of all available Scripts. */
124 Rect tr = r.Shrink(WidgetDimensions::scaled.matrix);
125 /* First AI in the list is hardcoded to random */
126 if (this->vscroll->IsVisible(0)) {
127 DrawString(tr, this->slot == OWNER_DEITY ? STR_AI_CONFIG_NONE : STR_AI_CONFIG_RANDOM_AI, this->selected == -1 ? TC_WHITE : TC_ORANGE);
128 tr.top += this->line_height;
129 }
130 int i = 0;
131 for (const auto &item : *this->info_list) {
132 i++;
133 if (this->vscroll->IsVisible(i)) {
134 DrawString(tr, this->show_all ? GetString(STR_AI_CONFIG_NAME_VERSION, item.second->GetName(), item.second->GetVersion()) : item.second->GetName(), (this->selected == i - 1) ? TC_WHITE : TC_ORANGE);
135 tr.top += this->line_height;
136 }
137 }
138 break;
139 }
140 case WID_SCRL_INFO_BG: {
141 ScriptInfo *selected_info = nullptr;
142 int i = 0;
143 for (const auto &item : *this->info_list) {
144 i++;
145 if (this->selected == i - 1) selected_info = static_cast<ScriptInfo *>(item.second);
146 }
147 /* Some info about the currently selected Script. */
148 if (selected_info != nullptr) {
150 DrawString(tr, GetString(STR_AI_LIST_AUTHOR, selected_info->GetAuthor()));
152 DrawString(tr, GetString(STR_AI_LIST_VERSION, selected_info->GetVersion()));
154 if (!selected_info->GetURL().empty()) {
155 DrawString(tr, GetString(STR_AI_LIST_URL, selected_info->GetURL()));
157 }
158 DrawStringMultiLine(tr, selected_info->GetDescription(), TC_WHITE);
159 }
160 break;
161 }
162 }
163 }
164
169 {
170 if (this->selected == -1) {
171 GetConfig(this->slot)->Change(std::nullopt);
172 } else {
173 ScriptInfoList::const_iterator it = this->info_list->cbegin();
174 std::advance(it, this->selected);
175 GetConfig(this->slot)->Change(it->second->GetName(), it->second->GetVersion());
176 }
177 if (_game_mode == GM_EDITOR) {
178 if (this->slot == OWNER_DEITY) {
179 if (Game::GetInstance() != nullptr) Game::ResetInstance();
181 } else {
182 Company *c = Company::GetIfValid(this->slot);
183 if (c != nullptr && c->ai_instance != nullptr) {
184 c->ai_instance.reset();
185 AI::StartNew(this->slot);
186 }
187 }
188 }
194 }
195
196 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
197 {
198 switch (widget) {
199 case WID_SCRL_LIST: { // Select one of the Scripts
200 int sel = this->vscroll->GetScrolledRowFromWidget(pt.y, this, WID_SCRL_LIST) - 1;
201 if (sel < static_cast<int>(this->info_list->size())) {
202 this->selected = sel;
203 this->SetDirty();
204 if (click_count > 1) {
205 this->ChangeScript();
206 this->Close();
207 }
208 }
209 break;
210 }
211
212 case WID_SCRL_ACCEPT: {
213 this->ChangeScript();
214 this->Close();
215 break;
216 }
217 }
218 }
219
220 void OnResize() override
221 {
222 this->vscroll->SetCapacityFromWidget(this, WID_SCRL_LIST);
223 }
224
230 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
231 {
232 if (_game_mode == GM_NORMAL && Company::IsValidID(this->slot)) {
233 this->Close();
234 return;
235 }
236
237 if (!gui_scope) return;
238
239 this->vscroll->SetCount(this->info_list->size() + 1);
240
241 /* selected goes from -1 .. length of ai list - 1. */
242 this->selected = std::min(this->selected, this->vscroll->GetCount() - 2);
243 }
244};
245
247static constexpr std::initializer_list<NWidgetPart> _nested_script_list_widgets = {
249 NWidget(WWT_CLOSEBOX, COLOUR_MAUVE),
250 NWidget(WWT_CAPTION, COLOUR_MAUVE, WID_SCRL_CAPTION),
251 NWidget(WWT_DEFSIZEBOX, COLOUR_MAUVE),
252 EndContainer(),
254 NWidget(WWT_MATRIX, COLOUR_MAUVE, WID_SCRL_LIST), SetMinimalSize(188, 112), SetFill(1, 1), SetResize(1, 1), SetMatrixDataTip(1, 0, STR_AI_LIST_TOOLTIP), SetScrollbar(WID_SCRL_SCROLLBAR),
256 EndContainer(),
257 NWidget(WWT_PANEL, COLOUR_MAUVE, WID_SCRL_INFO_BG), SetMinimalTextLines(8, WidgetDimensions::unscaled.framerect.Vertical() + WidgetDimensions::unscaled.vsep_normal * 3), SetResize(1, 0),
258 EndContainer(),
260 NWidget(WWT_PUSHTXTBTN, COLOUR_MAUVE, WID_SCRL_ACCEPT), SetResize(1, 0), SetFill(1, 0), SetStringTip(STR_AI_LIST_ACCEPT, STR_AI_LIST_ACCEPT_TOOLTIP),
261 NWidget(WWT_RESIZEBOX, COLOUR_MAUVE),
262 EndContainer(),
263};
264
267 WDP_CENTER, "settings_script_list", 200, 234,
269 {},
271);
272
278void ShowScriptListWindow(CompanyID slot, bool show_all)
279{
281 new ScriptListWindow(_script_list_desc, slot, show_all);
282}
283
284
289 CompanyID slot{};
291 int clicked_button = -1;
292 bool clicked_increase = false;
293 bool clicked_dropdown = false;
294 bool closing_dropdown = false;
295 int clicked_row = 0;
296 int line_height = 0;
297 Scrollbar *vscroll = nullptr;
298 typedef std::vector<const ScriptConfigItem *> VisibleSettingsList;
300
307 {
308 this->CreateNestedTree();
309 this->vscroll = this->GetScrollbar(WID_SCRS_SCROLLBAR);
310 this->FinishInitNested(this->slot); // Initializes 'this->line_height' as side effect.
311
312 this->OnInvalidateData();
313 }
314
321 {
322 this->visible_settings.clear();
323
324 for (const auto &item : *this->script_config->GetConfigList()) {
325 bool no_hide = !item.flags.Test(ScriptConfigFlag::Developer);
326 if (no_hide || _settings_client.gui.ai_developer_tools) {
327 this->visible_settings.push_back(&item);
328 }
329 }
330
331 this->vscroll->SetCount(this->visible_settings.size());
332 }
333
334 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
335 {
336 if (widget != WID_SCRS_CAPTION) return this->Window::GetWidgetString(widget, stringid);
337
338 return GetString((this->slot == OWNER_DEITY) ? STR_AI_SETTINGS_CAPTION_GAMESCRIPT : STR_AI_SETTINGS_CAPTION_AI);
339 }
340
341 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
342 {
343 if (widget != WID_SCRS_BACKGROUND) return;
344
345 this->line_height = std::max(SETTING_BUTTON_HEIGHT, GetCharacterHeight(FS_NORMAL)) + padding.height;
346
347 resize.width = 1;
348 fill.height = resize.height = this->line_height;
349 size.height = 5 * this->line_height;
350 }
351
352 void DrawWidget(const Rect &r, WidgetID widget) const override
353 {
354 if (widget != WID_SCRS_BACKGROUND) return;
355
356 Rect ir = r.Shrink(WidgetDimensions::scaled.frametext, RectPadding::zero);
357 bool rtl = _current_text_dir == TD_RTL;
358 Rect br = ir.WithWidth(SETTING_BUTTON_WIDTH, rtl);
360
361 int y = r.top;
362 int button_y_offset = (this->line_height - SETTING_BUTTON_HEIGHT) / 2;
363 int text_y_offset = (this->line_height - GetCharacterHeight(FS_NORMAL)) / 2;
364
365 const auto [first, last] = this->vscroll->GetVisibleRangeIterators(this->visible_settings);
366 for (auto it = first; it != last; ++it) {
367 const ScriptConfigItem &config_item = **it;
368 int current_value = this->script_config->GetSetting(config_item.name);
369 bool editable = this->IsEditableItem(config_item);
370
371 if (config_item.flags.Test(ScriptConfigFlag::Boolean)) {
372 DrawBoolButton(br.left, y + button_y_offset, COLOUR_YELLOW, COLOUR_MAUVE, current_value != 0, editable);
373 } else {
374 int i = static_cast<int>(std::distance(std::begin(this->visible_settings), it));
375 if (config_item.complete_labels) {
376 DrawDropDownButton(br.left, y + button_y_offset, COLOUR_YELLOW, this->clicked_row == i && this->clicked_dropdown, editable);
377 } else {
378 DrawArrowButtons(br.left, y + button_y_offset, COLOUR_YELLOW, (this->clicked_button == i) ? 1 + (this->clicked_increase != rtl) : 0, editable && current_value > config_item.min_value, editable && current_value < config_item.max_value);
379 }
380 }
381
382 DrawString(tr.left, tr.right, y + text_y_offset, config_item.GetString(current_value), config_item.GetColour());
383 y += this->line_height;
384 }
385 }
386
387 void OnPaint() override
388 {
389 if (this->closing_dropdown) {
390 this->closing_dropdown = false;
391 this->clicked_dropdown = false;
392 }
393 this->DrawWidgets();
394 }
395
396 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
397 {
398 switch (widget) {
399 case WID_SCRS_BACKGROUND: {
400 auto it = this->vscroll->GetScrolledItemFromWidget(this->visible_settings, pt.y, this, widget);
401 if (it == this->visible_settings.end()) break;
402
403 const ScriptConfigItem &config_item = **it;
404 if (!this->IsEditableItem(config_item)) return;
405
406 int num = it - this->visible_settings.begin();
407 if (this->clicked_row != num) {
410 this->clicked_row = num;
411 this->clicked_dropdown = false;
412 }
413
414 bool bool_item = config_item.flags.Test(ScriptConfigFlag::Boolean);
415
416 Rect r = this->GetWidget<NWidgetBase>(widget)->GetCurrentRect().Shrink(WidgetDimensions::scaled.frametext, RectPadding::zero);
417 int x = pt.x - r.left;
418 if (_current_text_dir == TD_RTL) x = r.Width() - 1 - x;
419
420 /* One of the arrows is clicked (or green/red rect in case of bool value) */
421 int old_val = this->script_config->GetSetting(config_item.name);
422 if (!bool_item && IsInsideMM(x, 0, SETTING_BUTTON_WIDTH) && config_item.complete_labels) {
423 if (this->clicked_dropdown) {
424 /* unclick the dropdown */
426 this->clicked_dropdown = false;
427 this->closing_dropdown = false;
428 } else {
429 int rel_y = (pt.y - r.top) % this->line_height;
430
431 Rect wi_rect;
432 wi_rect.left = pt.x - (_current_text_dir == TD_RTL ? SETTING_BUTTON_WIDTH - 1 - x : x);
433 wi_rect.right = wi_rect.left + SETTING_BUTTON_WIDTH - 1;
434 wi_rect.top = pt.y - rel_y + (this->line_height - SETTING_BUTTON_HEIGHT) / 2;
435 wi_rect.bottom = wi_rect.top + SETTING_BUTTON_HEIGHT - 1;
436
437 /* If the mouse is still held but dragged outside of the dropdown list, keep the dropdown open */
438 if (pt.y >= wi_rect.top && pt.y <= wi_rect.bottom) {
439 this->clicked_dropdown = true;
440 this->closing_dropdown = false;
441
442 DropDownList list;
443 for (int i = config_item.min_value; i <= config_item.max_value; i++) {
444 list.push_back(MakeDropDownListStringItem(GetString(STR_JUST_RAW_STRING, config_item.labels.find(i)->second), i));
445 }
446
447 ShowDropDownListAt(this, std::move(list), old_val, WID_SCRS_SETTING_DROPDOWN, wi_rect, COLOUR_ORANGE);
448 }
449 }
450 } else if (IsInsideMM(x, 0, SETTING_BUTTON_WIDTH)) {
451 int new_val = old_val;
452 if (bool_item) {
453 new_val = !new_val;
454 } else if (x >= SETTING_BUTTON_WIDTH / 2) {
455 /* Increase button clicked */
456 new_val += config_item.step_size;
457 if (new_val > config_item.max_value) new_val = config_item.max_value;
458 this->clicked_increase = true;
459 } else {
460 /* Decrease button clicked */
461 new_val -= config_item.step_size;
462 if (new_val < config_item.min_value) new_val = config_item.min_value;
463 this->clicked_increase = false;
464 }
465
466 if (new_val != old_val) {
467 this->script_config->SetSetting(config_item.name, new_val);
468 this->clicked_button = num;
469 this->unclick_timeout.Reset();
470 }
471 } else if (!bool_item && !config_item.complete_labels) {
472 /* Display a query box so users can enter a custom value. */
473 ShowQueryString(GetString(STR_JUST_INT, old_val), STR_CONFIG_SETTING_QUERY_CAPTION, INT32_DIGITS_WITH_SIGN_AND_TERMINATION, this, CS_NUMERAL_SIGNED, {});
474 }
475 this->SetDirty();
476 break;
477 }
478
479 case WID_SCRS_RESET:
480 this->script_config->ResetEditableSettings(_game_mode == GM_MENU || ((this->slot != OWNER_DEITY) && !Company::IsValidID(this->slot)));
481 this->SetDirty();
482 break;
483 }
484 }
485
486 void OnQueryTextFinished(std::optional<std::string> str) override
487 {
488 if (!str.has_value()) return;
489 auto value = ParseInteger<int32_t>(*str, 10, true);
490 if (!value.has_value()) return;
491 this->SetValue(*value);
492 }
493
494 void OnDropdownSelect(WidgetID widget, int index, int) override
495 {
496 if (widget != WID_SCRS_SETTING_DROPDOWN) return;
497 assert(this->clicked_dropdown);
498 this->SetValue(index);
499 }
500
501 void OnDropdownClose(Point, WidgetID widget, int, int, bool) override
502 {
503 if (widget != WID_SCRS_SETTING_DROPDOWN) return;
504 /* We cannot raise the dropdown button just yet. OnClick needs some hint, whether
505 * the same dropdown button was clicked again, and then not open the dropdown again.
506 * So, we only remember that it was closed, and process it on the next OnPaint, which is
507 * after OnClick. */
508 assert(this->clicked_dropdown);
509 this->closing_dropdown = true;
510 this->SetDirty();
511 }
512
513 void OnResize() override
514 {
515 this->vscroll->SetCapacityFromWidget(this, WID_SCRS_BACKGROUND);
516 }
517
519 TimeoutTimer<TimerWindow> unclick_timeout = {std::chrono::milliseconds(150), [this]() {
520 this->clicked_button = -1;
521 this->SetDirty();
522 }};
523
529 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
530 {
531 this->script_config = GetConfig(this->slot);
532 if (this->script_config->GetConfigList()->empty()) this->Close();
536 }
537
538private:
539 bool IsEditableItem(const ScriptConfigItem &config_item) const
540 {
541 return _game_mode == GM_MENU
542 || _game_mode == GM_EDITOR
543 || ((this->slot != OWNER_DEITY) && !Company::IsValidID(this->slot))
544 || config_item.flags.Test(ScriptConfigFlag::InGame)
545 || _settings_client.gui.ai_developer_tools;
546 }
547
548 void SetValue(int value)
549 {
550 const ScriptConfigItem &config_item = *this->visible_settings[this->clicked_row];
551 if (_game_mode == GM_NORMAL && ((this->slot == OWNER_DEITY) || Company::IsValidID(this->slot)) && !config_item.flags.Test(ScriptConfigFlag::InGame)) return;
552 this->script_config->SetSetting(config_item.name, value);
553 this->SetDirty();
554 }
555};
556
558static constexpr std::initializer_list<NWidgetPart> _nested_script_settings_widgets = {
560 NWidget(WWT_CLOSEBOX, COLOUR_MAUVE),
561 NWidget(WWT_CAPTION, COLOUR_MAUVE, WID_SCRS_CAPTION),
562 NWidget(WWT_DEFSIZEBOX, COLOUR_MAUVE),
563 EndContainer(),
567 EndContainer(),
569 NWidget(WWT_PUSHTXTBTN, COLOUR_MAUVE, WID_SCRS_RESET), SetStringTip(STR_AI_SETTINGS_RESET),
570 NWidget(WWT_PANEL, COLOUR_MAUVE), SetResize(1, 0), SetFill(1, 0),
571 EndContainer(),
572 NWidget(WWT_RESIZEBOX, COLOUR_MAUVE),
573 EndContainer(),
574};
575
578 WDP_CENTER, "settings_script", 500, 208,
580 {},
582);
583
594
595
597struct ScriptTextfileWindow : public TextfileWindow {
598 CompanyID slot{};
599
601 {
602 this->ConstructWindow();
603 this->OnInvalidateData();
604 }
605
606 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
607 {
608 if (widget == WID_TF_CAPTION) {
609 return GetString(stringid, (this->slot == OWNER_DEITY) ? STR_CONTENT_TYPE_GAME_SCRIPT : STR_CONTENT_TYPE_AI, GetConfig(this->slot)->GetInfo()->GetName());
610 }
611
612 return this->Window::GetWidgetString(widget, stringid);
613 }
614
615 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
616 {
617 auto textfile = GetConfig(this->slot)->GetTextfile(file_type, this->slot);
618 if (!textfile.has_value()) {
619 this->Close();
620 } else {
621 this->LoadTextfile(textfile.value(), (this->slot == OWNER_DEITY) ? GAME_DIR : AI_DIR);
622 }
623 }
624};
625
632void ShowScriptTextfileWindow(Window *parent, TextfileType file_type, CompanyID slot)
633{
634 parent->CloseChildWindowById(WC_TEXTFILE, file_type);
635 new ScriptTextfileWindow(parent, file_type, slot);
636}
637
638
647static bool SetScriptButtonColour(NWidgetCore &button, bool dead, bool paused)
648{
649 /* Dead scripts are indicated with red background and
650 * paused scripts are indicated with yellow background. */
651 Colours colour = dead ? COLOUR_RED :
652 (paused ? COLOUR_YELLOW : COLOUR_GREY);
653 if (button.colour != colour) {
654 button.colour = colour;
655 return true;
656 }
657 return false;
658}
659
663struct ScriptDebugWindow : public Window {
664 static const uint MAX_BREAK_STR_STRING_LENGTH = 256;
665
672
673 static inline FilterState initial_state = {
674 "",
675 CompanyID::Invalid(),
676 true,
677 false,
678 };
679
681 bool autoscroll = true;
682 bool show_break_box = false;
685 int highlight_row = -1;
686 Scrollbar *vscroll = nullptr;
687 Scrollbar *hscroll = nullptr;
688 FilterState filter{};
689
690 ScriptLogTypes::LogData &GetLogData() const
691 {
692 if (this->filter.script_debug_company == OWNER_DEITY) return Game::GetInstance()->GetLogData();
693 return Company::Get(this->filter.script_debug_company)->ai_instance->GetLogData();
694 }
695
700 bool IsDead() const
701 {
702 if (this->filter.script_debug_company == OWNER_DEITY) {
704 return game == nullptr || game->IsDead();
705 }
706 return !Company::IsValidAiID(this->filter.script_debug_company) || Company::Get(this->filter.script_debug_company)->ai_instance->IsDead();
707 }
708
714 bool IsValidDebugCompany(CompanyID company) const
715 {
716 switch (company.base()) {
717 case CompanyID::Invalid().base(): return false;
718 case OWNER_DEITY.base(): return Game::GetInstance() != nullptr;
719 default: return Company::IsValidAiID(company);
720 }
721 }
722
728 {
729 /* Check if the currently selected company is still active. */
730 if (this->IsValidDebugCompany(this->filter.script_debug_company)) return;
731
732 this->filter.script_debug_company = CompanyID::Invalid();
733
734 for (const Company *c : Company::Iterate()) {
735 if (c->is_ai) {
736 this->ChangeToScript(c->index);
737 return;
738 }
739 }
740
741 /* If no AI is available, see if there is a game script. */
742 if (Game::GetInstance() != nullptr) this->ChangeToScript(OWNER_DEITY);
743 }
744
752 {
753 this->filter = ScriptDebugWindow::initial_state;
754 this->break_string_filter = {&this->filter.case_sensitive_break_check, false};
755
756 this->CreateNestedTree();
757 this->vscroll = this->GetScrollbar(WID_SCRD_VSCROLLBAR);
758 this->hscroll = this->GetScrollbar(WID_SCRD_HSCROLLBAR);
759 this->FinishInitNested(number);
760
761 this->querystrings[WID_SCRD_BREAK_STR_EDIT_BOX] = &this->break_editbox;
762
763 this->hscroll->SetStepSize(10); // Speed up horizontal scrollbar
764
765 /* Restore the break string value from static variable, and enable the filter. */
766 this->break_editbox.text.Assign(this->filter.break_string);
767 this->break_string_filter.SetFilterTerm(this->filter.break_string);
768
769 if (show_company == CompanyID::Invalid()) {
771 } else {
772 this->ChangeToScript(show_company);
773 }
774 }
775
776 void OnInit() override
777 {
778 this->show_break_box = _settings_client.gui.ai_developer_tools;
779 this->GetWidget<NWidgetStacked>(WID_SCRD_BREAK_STRING_WIDGETS)->SetDisplayedPlane(this->show_break_box ? 0 : SZSP_HORIZONTAL);
780 if (!this->show_break_box) this->filter.break_check_enabled = false;
782
783 this->InvalidateData(-1);
784 }
785
786 ~ScriptDebugWindow() override
787 {
788 ScriptDebugWindow::initial_state = this->filter;
789 }
790
791 void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
792 {
793 if (widget == WID_SCRD_LOG_PANEL) {
794 fill.height = resize.height = GetCharacterHeight(FS_NORMAL) + WidgetDimensions::scaled.vsep_normal;
795 size.height = 14 * resize.height + WidgetDimensions::scaled.framerect.Vertical();
796 }
797 }
798
799 void OnPaint() override
800 {
802 this->UpdateLogScroll();
803
804 /* Draw standard stuff */
805 this->DrawWidgets();
806 }
807
808 std::string GetWidgetString(WidgetID widget, StringID stringid) const override
809 {
810 if (widget != WID_SCRD_NAME_TEXT) return this->Window::GetWidgetString(widget, stringid);
811
812 if (this->filter.script_debug_company == OWNER_DEITY) {
813 const GameInfo *info = Game::GetInfo();
814 assert(info != nullptr);
815 return GetString(STR_AI_DEBUG_NAME_AND_VERSION, info->GetName(), info->GetVersion());
816 }
817 if (this->filter.script_debug_company == CompanyID::Invalid() || !Company::IsValidAiID(this->filter.script_debug_company)) {
818 return {};
819 }
820
821 const AIInfo *info = Company::Get(this->filter.script_debug_company)->ai_info;
822 return GetString(STR_AI_DEBUG_NAME_AND_VERSION, info->GetName(), info->GetVersion());
823 }
824
825 void DrawWidget(const Rect &r, WidgetID widget) const override
826 {
827 switch (widget) {
829 this->DrawWidgetLog(r);
830 break;
831
832 default:
833 if (IsInsideBS(widget, WID_SCRD_COMPANY_BUTTON_START, MAX_COMPANIES)) {
835 }
836 break;
837 }
838 }
839
846 void DrawWidgetCompanyButton(const Rect &r, WidgetID widget, int start) const
847 {
848 if (this->IsWidgetDisabled(widget)) return;
849 CompanyID cid = static_cast<CompanyID>(widget - start);
850 Dimension sprite_size = GetSpriteSize(SPR_COMPANY_ICON);
851 DrawCompanyIcon(cid, CentreBounds(r.left, r.right, sprite_size.width), CentreBounds(r.top, r.bottom, sprite_size.height));
852 }
853
858 void DrawWidgetLog(const Rect &r) const
859 {
860 if (this->filter.script_debug_company == CompanyID::Invalid()) return;
861
862 const ScriptLogTypes::LogData &log = this->GetLogData();
863 if (log.empty()) return;
864
865 Rect fr = r.Shrink(WidgetDimensions::scaled.framerect);
866
867 /* Setup a clipping rectangle... */
868 DrawPixelInfo tmp_dpi;
869 if (!FillDrawPixelInfo(&tmp_dpi, fr)) return;
870 /* ...but keep coordinates relative to the window. */
871 tmp_dpi.left += fr.left;
872 tmp_dpi.top += fr.top;
873
874 AutoRestoreBackup dpi_backup(_cur_dpi, &tmp_dpi);
875
876 fr = ScrollRect(fr, *this->hscroll, 1);
877
878 auto [first, last] = this->vscroll->GetVisibleRangeIterators(log);
879 for (auto it = first; it != last; ++it) {
880 const ScriptLogTypes::LogLine &line = *it;
881
882 TextColour colour;
883 switch (line.type) {
884 case ScriptLogTypes::LOG_SQ_INFO: colour = TC_BLACK; break;
885 case ScriptLogTypes::LOG_SQ_ERROR: colour = TC_WHITE; break;
886 case ScriptLogTypes::LOG_INFO: colour = TC_BLACK; break;
887 case ScriptLogTypes::LOG_WARNING: colour = TC_YELLOW; break;
888 case ScriptLogTypes::LOG_ERROR: colour = TC_RED; break;
889 default: colour = TC_BLACK; break;
890 }
891
892 /* Check if the current line should be highlighted */
893 if (std::distance(std::begin(log), it) == this->highlight_row) {
894 fr.bottom = fr.top + this->resize.step_height - 1;
896 if (colour == TC_BLACK) colour = TC_WHITE; // Make black text readable by inverting it to white.
897 }
898
899 DrawString(fr, line.text, colour, SA_LEFT | SA_FORCE);
900 fr.top += this->resize.step_height;
901 }
902 }
903
908 {
909 this->SetWidgetsDisabledState(this->filter.script_debug_company == CompanyID::Invalid(), WID_SCRD_VSCROLLBAR, WID_SCRD_HSCROLLBAR);
910 if (this->filter.script_debug_company == CompanyID::Invalid()) return;
911
912 ScriptLogTypes::LogData &log = this->GetLogData();
913
914 int scroll_count = static_cast<int>(log.size());
915 if (this->vscroll->GetCount() != scroll_count) {
916 this->vscroll->SetCount(scroll_count);
917
918 /* We need a repaint */
920 }
921
922 if (log.empty()) return;
923
924 /* Detect when the user scrolls the window. Enable autoscroll when the bottom-most line becomes visible. */
925 if (this->last_vscroll_pos != this->vscroll->GetPosition()) {
926 this->autoscroll = this->vscroll->GetPosition() + this->vscroll->GetCapacity() >= static_cast<int>(log.size());
927 }
928
929 if (this->autoscroll && this->vscroll->SetPosition(static_cast<int>(log.size()))) {
930 /* We need a repaint */
933 }
934
935 this->last_vscroll_pos = this->vscroll->GetPosition();
936 }
937
942 {
943 /* Update company buttons */
944 for (CompanyID i = CompanyID::Begin(); i < MAX_COMPANIES; ++i) {
945 /* Mark dead/paused AIs by setting the background colour. */
946 bool valid = Company::IsValidAiID(i);
947 bool dead = valid && Company::Get(i)->ai_instance->IsDead();
948 bool paused = valid && Company::Get(i)->ai_instance->IsPaused();
949
951 button->SetDisabled(!valid);
952 button->SetLowered(this->filter.script_debug_company == i);
953 SetScriptButtonColour(*button, dead, paused);
954 }
955 }
956
961 {
963 bool valid = game != nullptr;
964 bool dead = valid && game->IsDead();
965 bool paused = valid && game->IsPaused();
966
968 button->SetDisabled(!valid);
969 button->SetLowered(this->filter.script_debug_company == OWNER_DEITY);
970 SetScriptButtonColour(*button, dead, paused);
971 }
972
978 void ChangeToScript(CompanyID show_script, bool new_window = false)
979 {
980 if (!this->IsValidDebugCompany(show_script)) return;
981
982 if (new_window) {
983 ScriptDebugWindow::initial_state = this->filter;
984 ShowScriptDebugWindow(show_script, true);
985 return;
986 }
987
988 this->filter.script_debug_company = show_script;
989
990 this->highlight_row = -1; // The highlight of one Script make little sense for another Script.
991
992 /* Close AI settings window to prevent confusion */
994
995 this->InvalidateData(-1);
996
997 this->autoscroll = true;
998 this->last_vscroll_pos = this->vscroll->GetPosition();
999 }
1000
1001 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
1002 {
1003 /* Also called for hotkeys, so check for disabledness */
1004 if (this->IsWidgetDisabled(widget)) return;
1005
1006 /* Check which button is clicked */
1008 this->ChangeToScript(static_cast<CompanyID>(widget - WID_SCRD_COMPANY_BUTTON_START), _ctrl_pressed);
1009 }
1010
1011 switch (widget) {
1014 break;
1015
1017 if (this->filter.script_debug_company == OWNER_DEITY) break;
1018 /* First kill the company of the AI, then start a new one. This should start the current AI again */
1019 Command<Commands::CompanyControl>::Post(CCA_DELETE, this->filter.script_debug_company, CRR_MANUAL, INVALID_CLIENT_ID);
1020 Command<Commands::CompanyControl>::Post(CCA_NEW_AI, this->filter.script_debug_company, CRR_NONE, INVALID_CLIENT_ID);
1021 break;
1022
1023 case WID_SCRD_SETTINGS:
1025 break;
1026
1028 this->filter.break_check_enabled = !this->filter.break_check_enabled;
1029 this->InvalidateData(-1);
1030 break;
1031
1033 this->filter.case_sensitive_break_check = !this->filter.case_sensitive_break_check;
1034 this->InvalidateData(-1);
1035 break;
1036
1038 /* Unpause current AI / game script and mark the corresponding script button dirty. */
1039 if (!this->IsDead()) {
1040 if (this->filter.script_debug_company == OWNER_DEITY) {
1041 Game::Unpause();
1042 } else {
1043 AI::Unpause(this->filter.script_debug_company);
1044 }
1045 }
1046
1047 /* If the last AI/Game Script is unpaused, unpause the game too. */
1048 if (_pause_mode.Test(PauseMode::Normal)) {
1049 bool all_unpaused = !Game::IsPaused();
1050 if (all_unpaused) {
1051 for (const Company *c : Company::Iterate()) {
1052 if (c->is_ai && AI::IsPaused(c->index)) {
1053 all_unpaused = false;
1054 break;
1055 }
1056 }
1057 if (all_unpaused) {
1058 /* All scripts have been unpaused => unpause the game. */
1059 Command<Commands::Pause>::Post(PauseMode::Normal, false);
1060 }
1061 }
1062 }
1063
1064 this->highlight_row = -1;
1065 this->InvalidateData(-1);
1066 break;
1067 }
1068 }
1069
1070 void OnEditboxChanged(WidgetID wid) override
1071 {
1072 if (wid != WID_SCRD_BREAK_STR_EDIT_BOX) return;
1073
1074 /* Save the current string to static member so it can be restored next time the window is opened. */
1075 this->filter.break_string = this->break_editbox.text.GetText();
1076 this->break_string_filter.SetFilterTerm(this->filter.break_string);
1077 }
1078
1085 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
1086 {
1087 if (this->show_break_box != _settings_client.gui.ai_developer_tools) this->ReInit();
1088
1089 /* If the log message is related to the active company tab, check the break string.
1090 * This needs to be done in gameloop-scope, so the AI is suspended immediately. */
1091 if (!gui_scope && data == this->filter.script_debug_company &&
1092 this->IsValidDebugCompany(this->filter.script_debug_company) &&
1093 this->filter.break_check_enabled && !this->break_string_filter.IsEmpty()) {
1094 /* Get the log instance of the active company */
1095 ScriptLogTypes::LogData &log = this->GetLogData();
1096
1097 if (!log.empty()) {
1098 this->break_string_filter.ResetState();
1099 this->break_string_filter.AddLine(log.back().text);
1100 if (this->break_string_filter.GetState()) {
1101 /* Pause execution of script. */
1102 if (!this->IsDead()) {
1103 if (this->filter.script_debug_company == OWNER_DEITY) {
1104 Game::Pause();
1105 } else {
1106 AI::Pause(this->filter.script_debug_company);
1107 }
1108 }
1109
1110 /* Pause the game. */
1111 if (!_pause_mode.Test(PauseMode::Normal)) {
1112 Command<Commands::Pause>::Post(PauseMode::Normal, true);
1113 }
1114
1115 /* Highlight row that matched */
1116 this->highlight_row = static_cast<int>(log.size() - 1);
1117 }
1118 }
1119 }
1120
1121 if (!gui_scope) return;
1122
1124
1125 uint max_width = 0;
1126 if (this->filter.script_debug_company != CompanyID::Invalid()) {
1127 for (auto &line : this->GetLogData()) {
1128 if (line.width == 0 || data == -1) line.width = GetStringBoundingBox(line.text).width;
1129 max_width = std::max(max_width, line.width);
1130 }
1131 }
1132
1133 this->vscroll->SetCount(this->filter.script_debug_company != CompanyID::Invalid() ? this->GetLogData().size() : 0);
1134 this->hscroll->SetCount(max_width + WidgetDimensions::scaled.frametext.Horizontal());
1135
1136 this->UpdateAIButtonsState();
1137 this->UpdateGSButtonState();
1138
1141
1142 this->SetWidgetDisabledState(WID_SCRD_SETTINGS, this->filter.script_debug_company == CompanyID::Invalid() ||
1143 GetConfig(this->filter.script_debug_company)->GetConfigList()->empty());
1144 extern CompanyID _local_company;
1146 this->filter.script_debug_company == CompanyID::Invalid() ||
1147 this->filter.script_debug_company == OWNER_DEITY ||
1148 this->filter.script_debug_company == _local_company);
1149 this->SetWidgetDisabledState(WID_SCRD_CONTINUE_BTN, this->filter.script_debug_company == CompanyID::Invalid() ||
1150 (this->filter.script_debug_company == OWNER_DEITY ? !Game::IsPaused() : !AI::IsPaused(this->filter.script_debug_company)));
1151 }
1152
1153 void OnResize() override
1154 {
1155 this->vscroll->SetCapacityFromWidget(this, WID_SCRD_LOG_PANEL, WidgetDimensions::scaled.framerect.Vertical());
1156 this->hscroll->SetCapacityFromWidget(this, WID_SCRD_LOG_PANEL, WidgetDimensions::scaled.framerect.Horizontal());
1157 }
1158
1165 {
1166 if (_game_mode != GM_NORMAL) return ES_NOT_HANDLED;
1167 Window *w = ShowScriptDebugWindow(CompanyID::Invalid());
1168 if (w == nullptr) return ES_NOT_HANDLED;
1169 return w->OnHotkey(hotkey);
1170 }
1171
1172 static inline HotkeyList hotkeys{"aidebug", {
1173 Hotkey('1', "company_1", WID_SCRD_COMPANY_BUTTON_START),
1174 Hotkey('2', "company_2", WID_SCRD_COMPANY_BUTTON_START + 1),
1175 Hotkey('3', "company_3", WID_SCRD_COMPANY_BUTTON_START + 2),
1176 Hotkey('4', "company_4", WID_SCRD_COMPANY_BUTTON_START + 3),
1177 Hotkey('5', "company_5", WID_SCRD_COMPANY_BUTTON_START + 4),
1178 Hotkey('6', "company_6", WID_SCRD_COMPANY_BUTTON_START + 5),
1179 Hotkey('7', "company_7", WID_SCRD_COMPANY_BUTTON_START + 6),
1180 Hotkey('8', "company_8", WID_SCRD_COMPANY_BUTTON_START + 7),
1181 Hotkey('9', "company_9", WID_SCRD_COMPANY_BUTTON_START + 8),
1182 Hotkey(0, "company_10", WID_SCRD_COMPANY_BUTTON_START + 9),
1183 Hotkey(0, "company_11", WID_SCRD_COMPANY_BUTTON_START + 10),
1184 Hotkey(0, "company_12", WID_SCRD_COMPANY_BUTTON_START + 11),
1185 Hotkey(0, "company_13", WID_SCRD_COMPANY_BUTTON_START + 12),
1186 Hotkey(0, "company_14", WID_SCRD_COMPANY_BUTTON_START + 13),
1187 Hotkey(0, "company_15", WID_SCRD_COMPANY_BUTTON_START + 14),
1188 Hotkey('S', "settings", WID_SCRD_SETTINGS),
1189 Hotkey('0', "game_script", WID_SCRD_SCRIPT_GAME),
1190 Hotkey(0, "reload", WID_SCRD_RELOAD_TOGGLE),
1191 Hotkey('B', "break_toggle", WID_SCRD_BREAK_STR_ON_OFF_BTN),
1192 Hotkey('F', "break_string", WID_SCRD_BREAK_STR_EDIT_BOX),
1193 Hotkey('C', "match_case", WID_SCRD_MATCH_CASE_BTN),
1194 Hotkey(WKC_RETURN, "continue", WID_SCRD_CONTINUE_BTN),
1196};
1197
1199std::unique_ptr<NWidgetBase> MakeCompanyButtonRowsScriptDebug()
1200{
1201 return MakeCompanyButtonRows(WID_SCRD_COMPANY_BUTTON_START, WID_SCRD_COMPANY_BUTTON_END, COLOUR_GREY, 5, STR_AI_DEBUG_SELECT_AI_TOOLTIP, false);
1202}
1203
1205static constexpr std::initializer_list<NWidgetPart> _nested_script_debug_widgets = {
1207 NWidget(WWT_CLOSEBOX, COLOUR_GREY),
1208 NWidget(WWT_CAPTION, COLOUR_GREY), SetStringTip(STR_AI_DEBUG, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
1209 NWidget(WWT_SHADEBOX, COLOUR_GREY),
1210 NWidget(WWT_DEFSIZEBOX, COLOUR_GREY),
1211 NWidget(WWT_STICKYBOX, COLOUR_GREY),
1212 EndContainer(),
1214 NWidget(WWT_PANEL, COLOUR_GREY, WID_SCRD_VIEW),
1216 EndContainer(),
1217 NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_SCRD_SCRIPT_GAME), SetMinimalSize(100, 20), SetStringTip(STR_AI_GAME_SCRIPT, STR_AI_GAME_SCRIPT_TOOLTIP),
1218 NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_SCRD_NAME_TEXT), SetResize(1, 0), SetToolTip(STR_AI_DEBUG_NAME_TOOLTIP),
1220 NWidget(WWT_PUSHTXTBTN, COLOUR_GREY, WID_SCRD_SETTINGS), SetMinimalSize(100, 20), SetFill(0, 1), SetStringTip(STR_AI_DEBUG_SETTINGS, STR_AI_DEBUG_SETTINGS_TOOLTIP),
1221 NWidget(WWT_PUSHTXTBTN, COLOUR_GREY, WID_SCRD_RELOAD_TOGGLE), SetMinimalSize(100, 20), SetFill(0, 1), SetStringTip(STR_AI_DEBUG_RELOAD, STR_AI_DEBUG_RELOAD_TOOLTIP),
1222 EndContainer(),
1223 EndContainer(),
1226 /* Log panel */
1228 EndContainer(),
1229 /* Break string widgets */
1232 NWidget(WWT_IMGBTN_2, COLOUR_GREY, WID_SCRD_BREAK_STR_ON_OFF_BTN), SetAspect(WidgetDimensions::ASPECT_VEHICLE_FLAG), SetFill(0, 1), SetSpriteTip(SPR_FLAG_VEH_STOPPED, STR_AI_DEBUG_BREAK_STR_ON_OFF_TOOLTIP),
1233 NWidget(WWT_PANEL, COLOUR_GREY),
1235 NWidget(WWT_LABEL, INVALID_COLOUR), SetPadding(2, 2, 2, 4), SetStringTip(STR_AI_DEBUG_BREAK_ON_LABEL),
1236 NWidget(WWT_EDITBOX, COLOUR_GREY, WID_SCRD_BREAK_STR_EDIT_BOX), SetFill(1, 1), SetResize(1, 0), SetPadding(2, 2, 2, 2), SetStringTip(STR_AI_DEBUG_BREAK_STR_OSKTITLE, STR_AI_DEBUG_BREAK_STR_TOOLTIP),
1237 EndContainer(),
1238 EndContainer(),
1239 NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_SCRD_MATCH_CASE_BTN), SetMinimalSize(100, 0), SetFill(0, 1), SetStringTip(STR_AI_DEBUG_MATCH_CASE, STR_AI_DEBUG_MATCH_CASE_TOOLTIP),
1240 NWidget(WWT_PUSHTXTBTN, COLOUR_GREY, WID_SCRD_CONTINUE_BTN), SetMinimalSize(100, 0), SetFill(0, 1), SetStringTip(STR_AI_DEBUG_CONTINUE, STR_AI_DEBUG_CONTINUE_TOOLTIP),
1241 EndContainer(),
1242 EndContainer(),
1244 EndContainer(),
1247 NWidget(WWT_RESIZEBOX, COLOUR_GREY),
1248 EndContainer(),
1249EndContainer(),
1250};
1251
1254 WDP_AUTO, "script_debug", 600, 450,
1256 {},
1258 &ScriptDebugWindow::hotkeys
1259);
1260
1266Window *ShowScriptDebugWindow(CompanyID show_company, bool new_window)
1267{
1268 if (!_networking || _network_server) {
1269 int i = 0;
1270 if (new_window) {
1271 /* find next free window number for script debug */
1272 while (FindWindowById(WC_SCRIPT_DEBUG, i) != nullptr) i++;
1273 } else {
1274 /* Find existing window showing show_company. */
1275 for (Window *w : Window::Iterate()) {
1276 if (w->window_class == WC_SCRIPT_DEBUG && static_cast<ScriptDebugWindow *>(w)->filter.script_debug_company == show_company) {
1277 return BringWindowToFrontById(w->window_class, w->window_number);
1278 }
1279 }
1280
1281 /* Maybe there's a window showing a different company which can be switched. */
1283 if (w != nullptr) {
1285 w->ChangeToScript(show_company);
1286 return w;
1287 }
1288 }
1289 return new ScriptDebugWindow(_script_debug_desc, i, show_company);
1290 } else {
1291 ShowErrorMessage(GetEncodedString(STR_ERROR_AI_DEBUG_SERVER_ONLY), {}, WL_INFO);
1292 }
1293
1294 return nullptr;
1295}
1296
1301{
1302 ScriptDebugWindow::initial_state.script_debug_company = CompanyID::Invalid();
1303}
1304
1307{
1308 /* Network clients can't debug AIs. */
1309 if (_networking && !_network_server) return;
1310
1311 for (const Company *c : Company::Iterate()) {
1312 if (c->is_ai && c->ai_instance->IsDead()) {
1313 ShowScriptDebugWindow(c->index);
1314 break;
1315 }
1316 }
1317
1319 if (g != nullptr && g->IsDead()) {
1321 }
1322}
Base functions for all AIs.
AIConfig stores the configuration settings of every AI.
AIInfo keeps track of all information of an AI, like Author, Description, ...
The AIInstance tracks an AI.
static AIConfig * GetConfig(CompanyID company, ScriptSettingSource source=SSS_DEFAULT)
Get the config of a company.
Definition ai_config.cpp:20
All static information from an AI like name, version, etc.
Definition ai_info.hpp:16
static void Pause(CompanyID company)
Suspend the AI and then pause execution of the script.
Definition ai_core.cpp:124
static void StartNew(CompanyID company)
Start a new AI company.
Definition ai_core.cpp:36
static const ScriptInfoList * GetUniqueInfoList()
Wrapper function for AIScanner::GetUniqueAIInfoList.
Definition ai_core.cpp:303
static bool IsPaused(CompanyID company)
Checks if the AI is paused.
Definition ai_core.cpp:145
static void Unpause(CompanyID company)
Resume execution of the AI.
Definition ai_core.cpp:137
static const ScriptInfoList * GetInfoList()
Wrapper function for AIScanner::GetAIInfoList.
Definition ai_core.cpp:298
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
static GameConfig * GetConfig(ScriptSettingSource source=SSS_DEFAULT)
Get the config of a company.
All static information from an Game like name, version, etc.
Definition game_info.hpp:16
Runtime information about a game script like a pointer to the squirrel vm and the current state.
static void StartNew()
Start up a new GameScript.
Definition game_core.cpp:72
static class GameInfo * GetInfo()
Get the current GameInfo.
Definition game.hpp:70
static void Unpause()
Resume execution of the Game Script.
static bool IsPaused()
Checks if the Game Script is paused.
static void ResetInstance()
Reset the current active instance.
static const ScriptInfoList * GetUniqueInfoList()
Wrapper function for GameScanner::GetUniqueInfoList.
static void Pause()
Suspends the Game Script and then pause the execution of the script.
static class GameInstance * GetInstance()
Get the current active instance.
Definition game.hpp:96
static const ScriptInfoList * GetInfoList()
Wrapper function for GameScanner::GetInfoList.
Base class for a 'real' widget.
Colours colour
Colour of this widget.
void SetLowered(bool lowered)
Lower or raise the widget.
void SetDisabled(bool disabled)
Disable (grey-out) or enable the widget.
Script settings.
void SetSetting(std::string_view name, int value)
Set the value of a setting for this config.
const ScriptConfigItemList * GetConfigList()
Get the config list for this ScriptConfig.
int GetSetting(const std::string &name) const
Get the value of a setting for this config.
void ResetEditableSettings(bool yet_to_start)
Reset only editable and visible settings to their default value.
All static information from an Script like name, version, etc.
const std::string & GetName() const
Get the Name of the script.
const std::string & GetAuthor() const
Get the Author of the script.
const std::string & GetURL() const
Get the website for this script.
int GetVersion() const
Get the version of the script.
const std::string & GetDescription() const
Get the description of the script.
bool IsPaused()
Checks if the script is paused.
ScriptLogTypes::LogData & GetLogData()
Get the log pointer of this script.
bool IsDead() const
Return the "this script died" value.
Scrollbar data structure.
bool IsVisible(size_type item) const
Checks whether given current item is visible in the list.
size_type GetCapacity() const
Gets the number of visible elements of the scrollbar.
void SetCount(size_t num)
Sets the number of elements in the list.
auto GetScrolledItemFromWidget(Tcontainer &container, int clickpos, const Window *const w, WidgetID widget, int padding=0, int line_height=-1) const
Return an iterator pointing to the element of a scrolled widget that a user clicked in.
size_type GetScrolledRowFromWidget(int clickpos, const Window *const w, WidgetID widget, int padding=0, int line_height=-1) const
Compute the row of a scrolled widget that a user clicked in.
Definition widget.cpp:2426
bool SetPosition(size_type position)
Sets the position of the first visible element.
void SetCapacityFromWidget(Window *w, WidgetID widget, int padding=0)
Set capacity of visible elements from the size and resize properties of a widget.
Definition widget.cpp:2500
size_type GetCount() const
Gets the number of elements in the list.
auto GetVisibleRangeIterators(Tcontainer &container) const
Get a pair of iterators for the range of visible elements in a container.
void SetStepSize(size_t stepsize)
Set the distance to scroll when using the buttons or the wheel.
size_type GetPosition() const
Gets the position of the first visible element in the list.
A timeout timer will fire once after the interval.
Definition timer.h:116
static WidgetDimensions scaled
Widget dimensions scaled for current zoom level.
Definition window_gui.h:30
static const WidgetDimensions unscaled
Unscaled widget dimensions.
Definition window_gui.h:93
Definition of stuff that is very close to a company, like the company struct itself.
void DrawCompanyIcon(CompanyID c, int x, int y)
Draw the icon of a company.
CompanyID _local_company
Company controlled by the human player at this client. Can also be COMPANY_SPECTATOR.
Command definitions related to companies.
GUI Functions related to companies.
static constexpr Owner OWNER_DEITY
The object is owned by a superuser / goal script.
@ CCA_NEW_AI
Create a new AI company.
@ CCA_DELETE
Delete a company.
@ CRR_NONE
Dummy reason for actions that don't need one.
@ CRR_MANUAL
The company is manually removed.
void ShowDropDownListAt(Window *w, DropDownList &&list, int selected, WidgetID button, Rect wi_rect, Colours wi_colour, DropDownOptions options)
Show a drop down list.
Definition dropdown.cpp:403
Functions related to the drop down widget.
Types related to the drop down widget.
std::vector< std::unique_ptr< const DropDownListItem > > DropDownList
A drop down list is a collection of drop down list items.
Functions related to errors.
@ WL_INFO
Used for DoCommand-like (and some non-fatal AI GUI) errors/information.
Definition error.h:24
void ShowErrorMessage(EncodedString &&summary_msg, int x, int y, CommandCost &cc)
Display an error message in a window.
@ AI_DIR
Subdirectory for all AI files.
Definition fileio_type.h:99
@ GAME_DIR
Subdirectory for all game scripts.
int GetCharacterHeight(FontSize size)
Get height of a character for a given font size.
Definition fontcache.cpp:87
Base functions for all Games.
GameConfig stores the configuration settings of every Game.
GameInfo keeps track of all information of an Game, like Author, Description, ...
The GameInstance tracks games.
int CentreBounds(int min, int max, int size)
Determine where to position a centred object.
Dimension GetSpriteSize(SpriteID sprid, Point *offset, ZoomLevel zoom)
Get the size of a sprite.
Definition gfx.cpp:972
Dimension GetStringBoundingBox(std::string_view str, FontSize start_fontsize)
Return the string dimension in pixels.
Definition gfx.cpp:900
int DrawString(int left, int right, int top, std::string_view str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly truncated to make it fit in its allocated space.
Definition gfx.cpp:669
bool _ctrl_pressed
Is Ctrl pressed?
Definition gfx.cpp:39
PauseModes _pause_mode
The current pause mode.
Definition gfx.cpp:51
int DrawStringMultiLine(int left, int right, int top, int bottom, std::string_view str, TextColour colour, StringAlignment align, bool underline, FontSize fontsize)
Draw string, possibly over multiple lines.
Definition gfx.cpp:788
void GfxFillRect(int left, int top, int right, int bottom, const std::variant< PixelColour, PaletteID > &colour, FillRectMode mode)
Applies a certain FillRectMode-operation to a rectangle [left, right] x [top, bottom] on the screen.
Definition gfx.cpp:116
bool FillDrawPixelInfo(DrawPixelInfo *n, int left, int top, int width, int height)
Set up a clipping area for only drawing into a certain area.
Definition gfx.cpp:1573
@ FS_NORMAL
Index of the normal font in the font tables.
Definition gfx_type.h:249
@ SA_LEFT
Left align the text.
Definition gfx_type.h:388
@ SA_FORCE
Force the alignment, i.e. don't swap for RTL languages.
Definition gfx_type.h:400
TextColour
Colour of the strings, see _string_colourmap in table/string_colours.h or docs/ottd-colourtext-palett...
Definition gfx_type.h:307
constexpr NWidgetPart SetMatrixDataTip(uint32_t cols, uint32_t rows, StringID tip={})
Widget part function for setting the data and tooltip of WWT_MATRIX widgets.
constexpr NWidgetPart NWidgetFunction(NWidgetFunctionType *func_ptr)
Obtain a nested widget (sub)tree from an external source.
constexpr NWidgetPart SetFill(uint16_t fill_x, uint16_t fill_y)
Widget part function for setting filling.
constexpr NWidgetPart SetSpriteTip(SpriteID sprite, StringID tip={})
Widget part function for setting the sprite and tooltip.
constexpr NWidgetPart SetScrollbar(WidgetID index)
Attach a scrollbar to a widget.
constexpr NWidgetPart SetPadding(uint8_t top, uint8_t right, uint8_t bottom, uint8_t left)
Widget part function for setting additional space around a widget.
constexpr NWidgetPart SetStringTip(StringID string, StringID tip={})
Widget part function for setting the string and tooltip.
constexpr NWidgetPart SetAspect(float ratio, AspectFlags flags=AspectFlag::ResizeX)
Widget part function for setting the aspect ratio.
constexpr NWidgetPart SetMinimalSize(int16_t x, int16_t y)
Widget part function for setting the minimal size.
constexpr NWidgetPart SetToolTip(StringID tip)
Widget part function for setting tooltip and clearing the widget data.
constexpr NWidgetPart EndContainer()
Widget part function for denoting the end of a container (horizontal, vertical, WWT_FRAME,...
constexpr NWidgetPart NWidget(WidgetType tp, Colours col, WidgetID idx=INVALID_WIDGET)
Widget part function for starting a new 'real' widget.
constexpr NWidgetPart SetMinimalTextLines(uint8_t lines, uint8_t spacing, FontSize size=FS_NORMAL)
Widget part function for setting the minimal text lines.
constexpr NWidgetPart SetResize(int16_t dx, int16_t dy)
Widget part function for setting the resize step.
void SetDirty() const
Mark entire window as dirty (in need of re-paint).
Definition window.cpp:969
Hotkey related functions.
#define Point
Macro that prevents name conflicts between included headers.
constexpr bool IsInsideBS(const T x, const size_t base, const size_t size)
Checks if a value is between a window started at some base point.
constexpr bool IsInsideMM(const size_t x, const size_t min, const size_t max) noexcept
Checks if a value is in an interval.
Miscellaneous command definitions.
void ShowQueryString(std::string_view str, StringID caption, uint maxsize, Window *parent, CharSetFilter afilter, QueryStringFlags flags)
Show a query popup window with a textbox in it.
@ WID_TF_CAPTION
The caption of the window.
Definition misc_widget.h:53
bool _networking
are we in networking mode?
Definition network.cpp:66
bool _network_server
network-server is active
Definition network.cpp:67
Basic functions/variables used all over the place.
@ INVALID_CLIENT_ID
Client is not part of anything.
@ Normal
A game normally paused.
Definition openttd.h:69
static constexpr PixelColour PC_BLACK
Black palette colour.
Base for the GUIs that have an edit box in them.
A number of safeguards to prevent using unsafe methods.
ScriptConfig stores the configuration settings of every Script.
static const int INT32_DIGITS_WITH_SIGN_AND_TERMINATION
Maximum of 10 digits for MIN / MAX_INT32, 1 for the sign and 1 for '\0'.
@ Boolean
This value is a boolean (either 0 (false) or 1 (true) ).
@ Developer
This setting will only be visible when the Script development tools are active.
@ InGame
This setting can be changed while the Script is running.
static constexpr std::initializer_list< NWidgetPart > _nested_script_list_widgets
Widgets for the AI list window.
void ShowScriptDebugWindowIfScriptError()
Open the AI debug window if one of the AI scripts has crashed.
Window * ShowScriptDebugWindow(CompanyID show_company, bool new_window)
Open the Script debug window and select the given company.
static WindowDesc _script_debug_desc(WDP_AUTO, "script_debug", 600, 450, WC_SCRIPT_DEBUG, WC_NONE, {}, _nested_script_debug_widgets, &ScriptDebugWindow::hotkeys)
Window definition for the Script debug window.
std::unique_ptr< NWidgetBase > MakeCompanyButtonRowsScriptDebug()
Make a number of rows with buttons for each company for the Script debug window.
static bool SetScriptButtonColour(NWidgetCore &button, bool dead, bool paused)
Set the widget colour of a button based on the state of the script.
static constexpr std::initializer_list< NWidgetPart > _nested_script_debug_widgets
Widgets for the Script debug window.
static WindowDesc _script_list_desc(WDP_CENTER, "settings_script_list", 200, 234, WC_SCRIPT_LIST, WC_NONE, {}, _nested_script_list_widgets)
Window definition for the ai list window.
void ShowScriptSettingsWindow(CompanyID slot)
Open the Script settings window to change the Script settings for a Script.
static WindowDesc _script_settings_desc(WDP_CENTER, "settings_script", 500, 208, WC_SCRIPT_SETTINGS, WC_NONE, {}, _nested_script_settings_widgets)
Window definition for the Script settings window.
void ShowScriptTextfileWindow(Window *parent, TextfileType file_type, CompanyID slot)
Open the Script version of the textfile window.
static constexpr std::initializer_list< NWidgetPart > _nested_script_settings_widgets
Widgets for the Script settings window.
void ShowScriptListWindow(CompanyID slot, bool show_all)
Open the Script list window to chose a script for the given company slot.
void InitializeScriptGui()
Reset the Script windows to their initial state.
Window for configuring the scripts.
Declarations of the class for the script scanner.
std::map< std::string, class ScriptInfo *, CaseInsensitiveComparator > ScriptInfoList
Type for the list of scripts.
@ WID_SCRD_NAME_TEXT
Name of the current selected.
@ WID_SCRD_BREAK_STRING_WIDGETS
The panel to handle the breaking on string.
@ WID_SCRD_SCRIPT_GAME
Game Script button.
@ WID_SCRD_RELOAD_TOGGLE
Reload button.
@ WID_SCRD_HSCROLLBAR
Horizontal scrollbar of the log panel.
@ WID_SCRD_SETTINGS
Settings button.
@ WID_SCRD_BREAK_STR_EDIT_BOX
Edit box for the string to break on.
@ WID_SCRD_COMPANY_BUTTON_START
Buttons in the VIEW.
@ WID_SCRD_VIEW
The row of company buttons.
@ WID_SCRD_MATCH_CASE_BTN
Checkbox to use match caching or not.
@ WID_SCRD_BREAK_STR_ON_OFF_BTN
Enable breaking on string.
@ WID_SCRD_VSCROLLBAR
Vertical scrollbar of the log panel.
@ WID_SCRD_LOG_PANEL
Panel where the log is in.
@ WID_SCRD_CONTINUE_BTN
Continue button.
@ WID_SCRD_COMPANY_BUTTON_END
Last possible button in the VIEW.
@ WID_SCRL_ACCEPT
Accept button.
@ WID_SCRL_INFO_BG
Panel to draw some Script information on.
@ WID_SCRL_CAPTION
Caption of the window.
@ WID_SCRL_LIST
The matrix with all available Scripts.
@ WID_SCRL_SCROLLBAR
Scrollbar next to the Script list.
@ WID_SCRS_SETTING_DROPDOWN
Dynamically created dropdown for changing setting value.
@ WID_SCRS_BACKGROUND
Panel to draw the settings on.
@ WID_SCRS_SCROLLBAR
Scrollbar to scroll through all settings.
@ WID_SCRS_RESET
Reset button.
@ WID_SCRS_CAPTION
Caption of the window.
ClientSettings _settings_client
The current settings for this game.
Definition settings.cpp:60
void DrawArrowButtons(int x, int y, Colours button_colour, uint8_t state, bool clickable_left, bool clickable_right)
Draw [<][>] boxes.
void DrawBoolButton(int x, int y, Colours button_colour, Colours background, bool state, bool clickable)
Draw a toggle button.
void DrawDropDownButton(int x, int y, Colours button_colour, bool state, bool clickable)
Draw a dropdown button.
Functions for setting GUIs.
#define SETTING_BUTTON_WIDTH
Width of setting buttons.
#define SETTING_BUTTON_HEIGHT
Height of setting buttons.
This file contains all sprite-related enums and defines.
Definition of base types and functions in a cross-platform compatible way.
Parse strings.
static std::optional< T > ParseInteger(std::string_view arg, int base=10, bool clamp=false)
Change a string into its number representation.
@ CS_NUMERAL_SIGNED
Only numbers and '-' for negative values.
Definition string_type.h:28
Searching and filtering using a stringterm.
EncodedString GetEncodedString(StringID str)
Encode a string with no parameters into an encoded string.
Definition strings.cpp:90
std::string GetString(StringID string)
Resolve the given StringID into a std::string with formatting but no parameters.
Definition strings.cpp:424
TextDirection _current_text_dir
Text direction of the currently selected language.
Definition strings.cpp:56
Functions related to OTTD's strings.
uint32_t StringID
Numeric value that represents a string, independent of the selected language.
@ TD_RTL
Text is written right-to-left by default.
Class to backup a specific variable and restore it upon destruction of this object to prevent stack v...
static bool IsValidAiID(auto index)
Is this company a valid company, controlled by the computer (a NoAI program)?
Dimensions (a width and height) of a rectangle in 2D.
Data about how and where to blit pixels.
Definition gfx_type.h:157
List of hotkeys for a window.
Definition hotkeys.h:37
All data for a single hotkey.
Definition hotkeys.h:21
static Pool::IterateWrapper< Company > Iterate(size_t from=0)
static Company * Get(auto index)
static Company * GetIfValid(auto index)
Data stored about a string that can be modified in the GUI.
Specification of a rectangle with absolute coordinates of all edges.
Rect WithWidth(int width, bool end) const
Copy Rect and set its width.
int Width() const
Get width of Rect.
Rect Shrink(int s) const
Copy and shrink Rect by s pixels.
Rect Indent(int indent, bool end) const
Copy Rect and indent it from its position.
Info about a single Script setting.
ScriptConfigFlags flags
Flags for the configuration setting.
std::string GetString(int value) const
Get string to display this setting in the configuration interface.
LabelMapping labels
Text labels for the integer values.
std::string name
The name of the configuration setting.
int min_value
The minimal value this configuration setting can have.
int max_value
The maximal value this configuration setting can have.
int step_size
The step size in the gui.
bool complete_labels
True if all values have a label.
TextColour GetColour() const
Get text colour to display this setting in the configuration interface.
bool break_check_enabled
Stop an AI when it prints a matching string.
bool case_sensitive_break_check
Is the matching done case-sensitive.
std::string break_string
The string to match to the AI output.
CompanyID script_debug_company
The AI that is (was last) being debugged.
Window with everything an AI prints via ScriptLog.
void UpdateAIButtonsState()
Update state of all Company (AI) buttons.
void DrawWidgetLog(const Rect &r) const
Draw the AI/GS log.
void UpdateGSButtonState()
Update state of game script button.
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
void OnInit() override
Notification that the nested widget tree gets initialized.
static EventState ScriptDebugGlobalHotkeys(int hotkey)
Handler for global hotkeys of the ScriptDebugWindow.
void SelectValidDebugCompany()
Ensure that script_debug_company refers to a valid AI company or GS, or is set to CompanyID::Invalid(...
void OnEditboxChanged(WidgetID wid) override
The text in an editbox has been edited.
int last_vscroll_pos
Last position of the scrolling.
void DrawWidgetCompanyButton(const Rect &r, WidgetID widget, int start) const
Draw a company button icon.
static const uint MAX_BREAK_STR_STRING_LENGTH
Maximum length of the break string.
QueryString break_editbox
Break editbox.
void OnPaint() override
The window must be repainted.
Scrollbar * hscroll
Cache of the horizontal scrollbar.
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
void OnResize() override
Called after the window got resized.
int highlight_row
The output row that matches the given string, or -1.
ScriptDebugWindow(WindowDesc &desc, WindowNumber number, Owner show_company)
Constructor for the window.
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
void UpdateLogScroll()
Update the scrollbar and scroll position of the log panel.
StringFilter break_string_filter
Log filter for break.
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
bool autoscroll
Whether automatically scrolling should be enabled or not.
bool IsDead() const
Check whether the currently selected AI/GS is dead.
bool IsValidDebugCompany(CompanyID company) const
Check whether a company is a valid AI company or GS.
void ChangeToScript(CompanyID show_script, bool new_window=false)
Change all settings to select another Script.
Scrollbar * vscroll
Cache of the vertical scrollbar.
bool show_break_box
Whether the break/debug box is visible.
Window that let you choose an available Script.
int line_height
Height of a row in the matrix widget.
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
bool show_all
Whether to show all available versions.
void OnResize() override
Called after the window got resized.
CompanyID slot
The company we're selecting a new Script for.
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
int selected
The currently selected Script.
Scrollbar * vscroll
Cache of the vertical scrollbar.
ScriptListWindow(WindowDesc &desc, CompanyID slot, bool show_all)
Constructor for the window.
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
void ChangeScript()
Changes the Script of the current slot.
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
const ScriptInfoList * info_list
The list of Scripts.
Window for settings the parameters of an AI.
int clicked_row
The clicked row of settings.
void OnPaint() override
The window must be repainted.
std::vector< const ScriptConfigItem * > VisibleSettingsList
typdef for a vector of script settings
int clicked_button
The button we clicked.
void OnResize() override
Called after the window got resized.
void OnDropdownSelect(WidgetID widget, int index, int) override
A dropdown option associated to this window has been selected.
void DrawWidget(const Rect &r, WidgetID widget) const override
Draw the contents of a nested widget.
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
void RebuildVisibleSettings()
Rebuilds the list of visible settings.
CompanyID slot
The currently show company's setting.
int line_height
Height of a row in the matrix widget.
ScriptSettingsWindow(WindowDesc &desc, CompanyID slot)
Constructor for the window.
bool clicked_dropdown
Whether the dropdown is open.
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
TimeoutTimer< TimerWindow > unclick_timeout
When reset, unclick the button after a small timeout.
bool clicked_increase
Whether we clicked the increase or decrease button.
void UpdateWidgetSize(WidgetID widget, Dimension &size, const Dimension &padding, Dimension &fill, Dimension &resize) override
Update size and resize step of a widget in the window.
ScriptConfig * script_config
The configuration we're modifying.
VisibleSettingsList visible_settings
List of visible AI settings.
void OnDropdownClose(Point, WidgetID widget, int, int, bool) override
A dropdown window associated to this window has been closed.
bool closing_dropdown
True, if the dropdown list is currently closing.
Scrollbar * vscroll
Cache of the vertical scrollbar.
void OnQueryTextFinished(std::optional< std::string > str) override
The query window opened from this window has closed.
Window for displaying the textfile of a AI.
CompanyID slot
View the textfile of this CompanyID slot.
void OnInvalidateData(int data=0, bool gui_scope=true) override
Some data on this window has become invalid.
std::string GetWidgetString(WidgetID widget, StringID stringid) const override
Get the raw string for a widget.
String filter and state.
void SetFilterTerm(std::string_view str)
Set the term to filter on.
void ResetState()
Reset the matching state to process a new item.
bool GetState() const
Get the matching state of the current item.
std::string_view GetText() const
Get the current text.
Definition textbuf.cpp:284
void Assign(std::string_view text)
Copy a string into the textbuffer.
Definition textbuf.cpp:420
Window for displaying a textfile.
TextfileType file_type
Type of textfile to view.
virtual void LoadTextfile(const std::string &textfile, Subdirectory dir)
Loads the textfile text from file and setup lines.
High level window description.
Definition window_gui.h:168
Number to differentiate different windows of the same class.
Data structure for an opened window.
Definition window_gui.h:274
void ReInit(int rx=0, int ry=0, bool reposition=false)
Re-initialize a window, and optionally change its size.
Definition window.cpp:981
virtual void Close(int data=0)
Hide the window and all its child windows, and mark them for a later deletion.
Definition window.cpp:1106
void FinishInitNested(WindowNumber window_number=0)
Perform the second part of the initialization of a nested widget tree.
Definition window.cpp:1812
std::map< WidgetID, QueryString * > querystrings
QueryString associated to WWT_EDITBOX widgets.
Definition window_gui.h:321
void DrawWidgets() const
Paint all widgets of a window.
Definition widget.cpp:766
void InvalidateData(int data=0, bool gui_scope=true)
Mark this window's data as invalid (in need of re-computing).
Definition window.cpp:3250
Window * parent
Parent window.
Definition window_gui.h:329
void SetWidgetDirty(WidgetID widget_index) const
Invalidate a widget, i.e.
Definition window.cpp:559
virtual std::string GetWidgetString(WidgetID widget, StringID stringid) const
Get the raw string for a widget.
Definition window.cpp:507
void CloseChildWindows(WindowClass wc=WC_INVALID) const
Close all children a window might have in a head-recursive manner.
Definition window.cpp:1078
ResizeInfo resize
Resize information.
Definition window_gui.h:315
void SetWidgetsDisabledState(bool disab_stat, Args... widgets)
Sets the enabled/disabled status of a list of widgets.
Definition window_gui.h:516
void CreateNestedTree()
Perform the first part of the initialization of a nested widget tree.
Definition window.cpp:1802
WindowClass window_class
Window class.
Definition window_gui.h:302
void CloseChildWindowById(WindowClass wc, WindowNumber number) const
Close all children a window might have in a head-recursive manner.
Definition window.cpp:1093
bool IsWidgetDisabled(WidgetID widget_index) const
Gets the enabled/disabled status of a widget.
Definition window_gui.h:411
void SetWidgetLoweredState(WidgetID widget_index, bool lowered_stat)
Sets the lowered/raised status of a widget.
Definition window_gui.h:442
Window(WindowDesc &desc)
Empty constructor, initialization has been moved to InitNested() called from the constructor of the d...
Definition window.cpp:1835
const NWID * GetWidget(WidgetID widnum) const
Get the nested widget with number widnum from the nested widget tree.
Definition window_gui.h:986
const Scrollbar * GetScrollbar(WidgetID widnum) const
Return the Scrollbar to a widget index.
Definition window.cpp:316
virtual EventState OnHotkey(int hotkey)
A hotkey has been pressed.
Definition window.cpp:573
void SetWidgetDisabledState(WidgetID widget_index, bool disab_stat)
Sets the enabled/disabled status of a widget.
Definition window_gui.h:382
AllWindows< false > Iterate
Iterate all windows in whatever order is easiest.
Definition window_gui.h:936
WindowNumber window_number
Window number within the window class.
Definition window_gui.h:303
TextfileType
Additional text files accompanying Tar archives.
Definition of Interval and OneShot timers.
Definition of the Window system.
Rect ScrollRect(Rect r, const Scrollbar &sb, int resize_step)
Apply 'scroll' to a rect to be drawn in.
Definition widget.cpp:2517
std::unique_ptr< NWidgetBase > MakeCompanyButtonRows(WidgetID widget_first, WidgetID widget_last, Colours button_colour, int max_length, StringID button_tooltip, bool resizable)
Make a number of rows with button-like graphics, for enabling/disabling each company.
Definition widget.cpp:3436
@ WWT_PUSHTXTBTN
Normal push-button (no toggle button) with text caption.
@ WWT_IMGBTN_2
(Toggle) Button with diff image when clicked
Definition widget_type.h:42
@ WWT_LABEL
Centered label.
Definition widget_type.h:48
@ WWT_EDITBOX
a textbox for typing
Definition widget_type.h:62
@ NWID_HORIZONTAL
Horizontal container.
Definition widget_type.h:66
@ WWT_TEXTBTN
(Toggle) Button with text
Definition widget_type.h:44
@ WWT_PANEL
Simple depressed panel.
Definition widget_type.h:39
@ WWT_STICKYBOX
Sticky box (at top-right of a window, after WWT_DEFSIZEBOX).
Definition widget_type.h:57
@ WWT_MATRIX
Grid of rows and columns.
Definition widget_type.h:50
@ WWT_SHADEBOX
Shade box (at top-right of a window, between WWT_DEBUGBOX and WWT_DEFSIZEBOX).
Definition widget_type.h:55
@ WWT_CAPTION
Window caption (window title between closebox and stickybox).
Definition widget_type.h:52
@ NWID_VSCROLLBAR
Vertical scrollbar.
Definition widget_type.h:76
@ NWID_VERTICAL
Vertical container.
Definition widget_type.h:68
@ WWT_CLOSEBOX
Close box (at top-left of a window).
Definition widget_type.h:60
@ NWID_HSCROLLBAR
Horizontal scrollbar.
Definition widget_type.h:75
@ WWT_RESIZEBOX
Resize box (normally at bottom-right of a window).
Definition widget_type.h:59
@ WWT_DEFSIZEBOX
Default window size box (at top-right of a window, between WWT_SHADEBOX and WWT_STICKYBOX).
Definition widget_type.h:56
@ NWID_SELECTION
Stacked widgets, only one visible at a time (eg in a panel with tabs).
Definition widget_type.h:71
@ SZSP_HORIZONTAL
Display plane with zero size vertically, and filling and resizing horizontally.
Window * FindWindowByClass(WindowClass cls)
Find any window by its class.
Definition window.cpp:1170
void CloseWindowByClass(WindowClass cls, int data)
Close all windows of a given class.
Definition window.cpp:1211
void InvalidateWindowData(WindowClass cls, WindowNumber number, int data, bool gui_scope)
Mark window data of the window of a given class and specific window number as invalid (in need of re-...
Definition window.cpp:3310
Window * BringWindowToFrontById(WindowClass cls, WindowNumber number)
Find a window and make it the relative top-window on the screen.
Definition window.cpp:1282
Window * FindWindowById(WindowClass cls, WindowNumber number)
Find a window by its class and window number.
Definition window.cpp:1155
void InvalidateWindowClassesData(WindowClass cls, int data, bool gui_scope)
Mark window data of all windows of a given class as invalid (in need of re-computing) Note that by de...
Definition window.cpp:3328
Window functions not directly related to making/drawing windows.
@ WDP_CENTER
Center the window.
Definition window_gui.h:145
@ WDP_AUTO
Find a place automatically.
Definition window_gui.h:144
int WidgetID
Widget ID.
Definition window_type.h:20
@ WN_GAME_OPTIONS_GS
GS settings.
Definition window_type.h:28
@ WN_GAME_OPTIONS_AI
AI settings.
Definition window_type.h:27
EventState
State of handling an event.
@ ES_NOT_HANDLED
The passed event is not handled.
@ WC_SCRIPT_SETTINGS
Script settings; Window numbers:
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
Definition window_type.h:50
@ WC_SCRIPT_LIST
Scripts list; Window numbers:
@ WC_GAME_OPTIONS
Game options window; Window numbers:
@ WC_SCRIPT_DEBUG
Script debug window; Window numbers:
@ WC_TEXTFILE
textfile; Window numbers:
@ WC_DROPDOWN_MENU
Drop down menu; Window numbers:
@ WC_QUERY_STRING
Query string window; Window numbers: