game_gui.cpp

Go to the documentation of this file.

/*
 * This file is part of OpenTTD.
 * 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.
 * 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.
 * 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/>.
 */
 
#include "../stdafx.h"
#include "../error.h"
#include "../settings_gui.h"
#include "../querystring_gui.h"
#include "../window_func.h"
#include "../network/network.h"
#include "../network/network_content.h"
#include "../dropdown_type.h"
#include "../dropdown_func.h"
#include "../timer/timer.h"
#include "../timer/timer_window.h"
#include "../core/string_consumer.hpp"
 
#include "game.hpp"
#include "game_gui.hpp"
#include "game_config.hpp"
#include "game_info.hpp"
#include "../script/script_gui.h"
#include "../script_config.hpp"
 
#include "table/strings.h"
 
#include "../safeguards.h"
 
 
static constexpr NWidgetPart _nested_gs_config_widgets[] = {
  NWidget(NWID_HORIZONTAL),
    NWidget(WWT_CLOSEBOX, COLOUR_MAUVE),
    NWidget(WWT_CAPTION, COLOUR_MAUVE), SetStringTip(STR_AI_CONFIG_CAPTION_GAMESCRIPT, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
    NWidget(WWT_DEFSIZEBOX, COLOUR_MAUVE),
  EndContainer(),
  NWidget(WWT_PANEL, COLOUR_MAUVE, WID_GSC_BACKGROUND),
    NWidget(NWID_VERTICAL), SetPIP(0, WidgetDimensions::unscaled.vsep_wide, 0), SetPadding(WidgetDimensions::unscaled.sparse_resize),
      NWidget(WWT_FRAME, COLOUR_MAUVE), SetStringTip(STR_AI_CONFIG_GAMESCRIPT), SetFill(1, 0), SetResize(1, 0),
        NWidget(WWT_MATRIX, COLOUR_MAUVE, WID_GSC_GSLIST), SetMinimalSize(288, 14), SetFill(1, 1), SetResize(1, 0), SetMatrixDataTip(1, 1, STR_AI_CONFIG_GAMELIST_TOOLTIP),
      EndContainer(),
      NWidget(WWT_FRAME, COLOUR_MAUVE), SetStringTip(STR_AI_CONFIG_GAMESCRIPT_PARAM), SetFill(1, 1), SetResize(1, 0), SetPIP(0, WidgetDimensions::unscaled.vsep_sparse, 0),
        NWidget(NWID_HORIZONTAL),
          NWidget(WWT_MATRIX, COLOUR_MAUVE, WID_GSC_SETTINGS), SetFill(1, 0), SetResize(1, 1), SetMinimalSize(188, 182), SetMatrixDataTip(1, 0), SetScrollbar(WID_GSC_SCROLLBAR),
          NWidget(NWID_VSCROLLBAR, COLOUR_MAUVE, WID_GSC_SCROLLBAR),
        EndContainer(),
        NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_GSC_RESET), SetFill(1, 0), SetResize(1, 0), SetStringTip(STR_AI_SETTINGS_RESET),
      EndContainer(),
      NWidget(NWID_HORIZONTAL), SetPIP(0, WidgetDimensions::unscaled.hsep_wide, 0),
        NWidget(NWID_VERTICAL, NWidContainerFlag::EqualSize),
          NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_GSC_CHANGE), SetFill(1, 1), SetResize(1, 0), SetStringTip(STR_AI_CONFIG_CHANGE_GAMESCRIPT, STR_AI_CONFIG_CHANGE_TOOLTIP),
          NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_GSC_CONTENT_DOWNLOAD), SetFill(1, 1), SetResize(1, 0), SetStringTip(STR_INTRO_ONLINE_CONTENT, STR_INTRO_TOOLTIP_ONLINE_CONTENT),
        EndContainer(),
        NWidget(NWID_VERTICAL, NWidContainerFlag::EqualSize),
          NWidget(NWID_HORIZONTAL, NWidContainerFlag::EqualSize),
            NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_GSC_OPEN_URL), SetResize(1, 0), SetFill(1, 0), SetStringTip(STR_CONTENT_OPEN_URL, STR_CONTENT_OPEN_URL_TOOLTIP),
            NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_GSC_TEXTFILE + TFT_README), SetFill(1, 1), SetResize(1, 0), SetMinimalSize(93, 0), SetStringTip(STR_TEXTFILE_VIEW_README, STR_TEXTFILE_VIEW_README_TOOLTIP),
          EndContainer(),
          NWidget(NWID_HORIZONTAL, NWidContainerFlag::EqualSize),
            NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_GSC_TEXTFILE + TFT_CHANGELOG), SetFill(1, 1), SetResize(1, 0), SetStringTip(STR_TEXTFILE_VIEW_CHANGELOG, STR_TEXTFILE_VIEW_CHANGELOG_TOOLTIP),
            NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_GSC_TEXTFILE + TFT_LICENSE), SetFill(1, 1), SetResize(1, 0), SetStringTip(STR_TEXTFILE_VIEW_LICENCE, STR_TEXTFILE_VIEW_LICENCE_TOOLTIP),
          EndContainer(),
        EndContainer(),
      EndContainer(),
    EndContainer(),
    NWidget(NWID_HORIZONTAL),
      NWidget(NWID_SPACER), SetFill(1, 0), SetResize(1, 0),
      NWidget(WWT_RESIZEBOX, COLOUR_MAUVE), SetResizeWidgetTypeTip(RWV_HIDE_BEVEL, STR_TOOLTIP_RESIZE),
    EndContainer(),
  EndContainer(),
};
static constexpr NWidgetPart _nested_gs_config_widgets[] = {…};
 
static WindowDesc _gs_config_desc(
  WDP_CENTER, "settings_gs_config", 500, 350,
  WC_GAME_OPTIONS, WC_NONE,
  {},
  _nested_gs_config_widgets
);
 
struct GSConfigWindow : public Window {
  ScriptConfig *gs_config = nullptr; 
  int line_height = 0; 
  int clicked_button = -1; 
  bool clicked_increase = false; 
  bool clicked_dropdown = false; 
  bool closing_dropdown = false; 
  int clicked_row = 0; 
  Scrollbar *vscroll = nullptr; 
  typedef std::vector<const ScriptConfigItem *> VisibleSettingsList; 
  VisibleSettingsList visible_settings{}; 
 
  GSConfigWindow() : Window(_gs_config_desc)
  {
    this->gs_config = GameConfig::GetConfig();
 
    this->CreateNestedTree(); // Initializes 'this->line_height' as a side effect.
    this->vscroll = this->GetScrollbar(WID_GSC_SCROLLBAR);
    this->FinishInitNested(WN_GAME_OPTIONS_GS);
    this->OnInvalidateData(0);
 
    this->RebuildVisibleSettings();
  }
 
  void Close([[maybe_unused]] int data = 0) override
  {
    CloseWindowByClass(WC_SCRIPT_LIST);
    this->Window::Close();
  }
  void Close([[maybe_unused]] int data = 0) override {…}
 
  void RebuildVisibleSettings()
  {
    this->visible_settings.clear();
 
    for (const auto &item : *this->gs_config->GetConfigList()) {
      bool no_hide = !item.flags.Test(ScriptConfigFlag::Developer);
      if (no_hide || _settings_client.gui.ai_developer_tools) {
        this->visible_settings.push_back(&item);
      }
    }
 
    this->vscroll->SetCount(this->visible_settings.size());
  }
  void RebuildVisibleSettings() {…}
 
  void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
  {
    switch (widget) {
      case WID_GSC_SETTINGS:
        this->line_height = std::max(SETTING_BUTTON_HEIGHT, GetCharacterHeight(FS_NORMAL)) + padding.height;
        resize.width = 1;
        resize.height = this->line_height;
        size.height = 5 * this->line_height;
        break;
 
      case WID_GSC_GSLIST:
        this->line_height = GetCharacterHeight(FS_NORMAL) + padding.height;
        size.height = 1 * this->line_height;
        break;
    }
  }
  void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override {…}
 
  static bool IsEditable()
  {
    return _game_mode != GM_NORMAL || Game::GetInstance() != nullptr;
  }
  static bool IsEditable() {…}
 
  std::string GetText() const
  {
    if (const GameInfo *info = GameConfig::GetConfig()->GetInfo(); info != nullptr) return info->GetName();
    return GetString(STR_AI_CONFIG_NONE);
  }
  std::string GetText() const {…}
 
  void DrawWidget(const Rect &r, WidgetID widget) const override
  {
    switch (widget) {
      case WID_GSC_GSLIST: {
        /* There is only one slot, unlike with the GS GUI, so it should never be white */
        DrawString(r.Shrink(WidgetDimensions::scaled.matrix), this->GetText(), (IsEditable() ? TC_ORANGE : TC_SILVER));
        break;
      }
      case WID_GSC_SETTINGS: {
        Rect ir = r.Shrink(WidgetDimensions::scaled.frametext, RectPadding::zero);
        bool rtl = _current_text_dir == TD_RTL;
        Rect br = ir.WithWidth(SETTING_BUTTON_WIDTH, rtl);
        Rect tr = ir.Indent(SETTING_BUTTON_WIDTH + WidgetDimensions::scaled.hsep_wide, rtl);
 
        int y = r.top;
        int button_y_offset = (this->line_height - SETTING_BUTTON_HEIGHT) / 2;
        int text_y_offset = (this->line_height - GetCharacterHeight(FS_NORMAL)) / 2;
 
        const auto [first, last] = this->vscroll->GetVisibleRangeIterators(this->visible_settings);
        for (auto it = first; it != last; ++it) {
          const ScriptConfigItem &config_item = **it;
          int current_value = this->gs_config->GetSetting(config_item.name);
          bool editable = this->IsEditableItem(config_item);
 
          if (config_item.flags.Test(ScriptConfigFlag::Boolean)) {
            DrawBoolButton(br.left, y + button_y_offset, COLOUR_YELLOW, COLOUR_MAUVE, current_value != 0, editable);
          } else {
            int i = static_cast<int>(std::distance(std::begin(this->visible_settings), it));
            if (config_item.complete_labels) {
              DrawDropDownButton(br.left, y + button_y_offset, COLOUR_YELLOW, this->clicked_row == i && this->clicked_dropdown, editable);
            } else {
              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);
            }
          }
 
          DrawString(tr.left, tr.right, y + text_y_offset, config_item.GetString(current_value), config_item.GetColour());
          y += this->line_height;
        }
        break;
      }
    }
  }
  void DrawWidget(const Rect &r, WidgetID widget) const override {…}
 
  void OnPaint() override
  {
    if (this->closing_dropdown) {
      this->closing_dropdown = false;
      this->clicked_dropdown = false;
    }
    this->DrawWidgets();
  }
  void OnPaint() override {…}
 
  void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
  {
    if (widget >= WID_GSC_TEXTFILE && widget < WID_GSC_TEXTFILE + TFT_CONTENT_END) {
      if (GameConfig::GetConfig() == nullptr) return;
 
      ShowScriptTextfileWindow(this, static_cast<TextfileType>(widget - WID_GSC_TEXTFILE), OWNER_DEITY);
      return;
    }
 
    switch (widget) {
      case WID_GSC_GSLIST: {
        this->InvalidateData();
        if (click_count > 1 && _game_mode != GM_NORMAL) ShowScriptListWindow(OWNER_DEITY, _ctrl_pressed);
        break;
      }
 
      case WID_GSC_CHANGE:  // choose other Game Script
        ShowScriptListWindow(OWNER_DEITY, _ctrl_pressed);
        break;
 
      case WID_GSC_CONTENT_DOWNLOAD:
        if (!_network_available) {
          ShowErrorMessage(GetEncodedString(STR_NETWORK_ERROR_NOTAVAILABLE), {}, WL_ERROR);
        } else {
          ShowNetworkContentListWindow(nullptr, CONTENT_TYPE_GAME);
        }
        break;
 
      case WID_GSC_SETTINGS: {
        auto it = this->vscroll->GetScrolledItemFromWidget(this->visible_settings, pt.y, this, widget);
        if (it == this->visible_settings.end()) break;
 
        const ScriptConfigItem &config_item = **it;
        if (!this->IsEditableItem(config_item)) return;
 
        int num = it - this->visible_settings.begin();
        if (this->clicked_row != num) {
          this->CloseChildWindows(WC_QUERY_STRING);
          this->CloseChildWindows(WC_DROPDOWN_MENU);
          this->clicked_row = num;
          this->clicked_dropdown = false;
        }
 
        bool bool_item = config_item.flags.Test(ScriptConfigFlag::Boolean);
 
        Rect r = this->GetWidget<NWidgetBase>(widget)->GetCurrentRect().Shrink(WidgetDimensions::scaled.frametext, RectPadding::zero);
        int x = pt.x - r.left;
        if (_current_text_dir == TD_RTL) x = r.Width() - 1 - x;
 
        /* One of the arrows is clicked (or green/red rect in case of bool value) */
        int old_val = this->gs_config->GetSetting(config_item.name);
        if (!bool_item && IsInsideMM(x, 0, SETTING_BUTTON_WIDTH) && config_item.complete_labels) {
          if (this->clicked_dropdown) {
            /* unclick the dropdown */
            this->CloseChildWindows(WC_DROPDOWN_MENU);
            this->clicked_dropdown = false;
            this->closing_dropdown = false;
          } else {
            int rel_y = (pt.y - r.top) % this->line_height;
 
            Rect wi_rect;
            wi_rect.left = pt.x - (_current_text_dir == TD_RTL ? SETTING_BUTTON_WIDTH - 1 - x : x);
            wi_rect.right = wi_rect.left + SETTING_BUTTON_WIDTH - 1;
            wi_rect.top = pt.y - rel_y + (this->line_height - SETTING_BUTTON_HEIGHT) / 2;
            wi_rect.bottom = wi_rect.top + SETTING_BUTTON_HEIGHT - 1;
 
            /* If the mouse is still held but dragged outside of the dropdown list, keep the dropdown open */
            if (pt.y >= wi_rect.top && pt.y <= wi_rect.bottom) {
              this->clicked_dropdown = true;
              this->closing_dropdown = false;
 
              DropDownList list;
              for (int i = config_item.min_value; i <= config_item.max_value; i++) {
                list.push_back(MakeDropDownListStringItem(GetString(STR_JUST_RAW_STRING, config_item.labels.find(i)->second), i));
              }
 
              ShowDropDownListAt(this, std::move(list), old_val, WID_GSC_SETTING_DROPDOWN, wi_rect, COLOUR_ORANGE);
            }
          }
        } else if (IsInsideMM(x, 0, SETTING_BUTTON_WIDTH)) {
          int new_val = old_val;
          if (bool_item) {
            new_val = !new_val;
          } else if (x >= SETTING_BUTTON_WIDTH / 2) {
            /* Increase button clicked */
            new_val += config_item.step_size;
            if (new_val > config_item.max_value) new_val = config_item.max_value;
            this->clicked_increase = true;
          } else {
            /* Decrease button clicked */
            new_val -= config_item.step_size;
            if (new_val < config_item.min_value) new_val = config_item.min_value;
            this->clicked_increase = false;
          }
 
          if (new_val != old_val) {
            this->gs_config->SetSetting(config_item.name, new_val);
            this->clicked_button = num;
            this->unclick_timeout.Reset();
          }
        } else if (!bool_item && !config_item.complete_labels) {
          /* Display a query box so users can enter a custom value. */
          ShowQueryString(GetString(STR_JUST_INT, old_val), STR_CONFIG_SETTING_QUERY_CAPTION, INT32_DIGITS_WITH_SIGN_AND_TERMINATION, this, CS_NUMERAL_SIGNED, {});
        }
        this->SetDirty();
        break;
      }
 
      case WID_GSC_OPEN_URL: {
        const GameConfig *config = GameConfig::GetConfig();
        if (config == nullptr || config->GetInfo() == nullptr) return;
        OpenBrowser(config->GetInfo()->GetURL());
        break;
      }
 
      case WID_GSC_RESET:
        this->gs_config->ResetEditableSettings(_game_mode == GM_MENU);
        this->SetDirty();
        break;
    }
  }
  void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override {…}
 
  void OnQueryTextFinished(std::optional<std::string> str) override
  {
    if (!str.has_value()) return;
    auto value = ParseInteger<int32_t>(*str, 10, true);
    if (!value.has_value()) return;
    this->SetValue(*value);
  }
  void OnQueryTextFinished(std::optional<std::string> str) override {…}
 
  void OnDropdownSelect(WidgetID widget, int index, int) override
  {
    if (widget != WID_GSC_SETTING_DROPDOWN) return;
    assert(this->clicked_dropdown);
    this->SetValue(index);
  }
  void OnDropdownSelect(WidgetID widget, int index, int) override {…}
 
  void OnDropdownClose(Point, WidgetID widget, int, int, bool) override
  {
    if (widget != WID_GSC_SETTING_DROPDOWN) return;
    /* We cannot raise the dropdown button just yet. OnClick needs some hint, whether
     * the same dropdown button was clicked again, and then not open the dropdown again.
     * So, we only remember that it was closed, and process it on the next OnPaint, which is
     * after OnClick. */
    assert(this->clicked_dropdown);
    this->closing_dropdown = true;
    this->SetDirty();
  }
  void OnDropdownClose(Point, WidgetID widget, int, int, bool) override {…}
 
  void OnResize() override
  {
    this->vscroll->SetCapacityFromWidget(this, WID_GSC_SETTINGS);
  }
  void OnResize() override {…}
 
  TimeoutTimer<TimerWindow> unclick_timeout = {std::chrono::milliseconds(150), [this]() {
    this->clicked_button = -1;
    this->SetDirty();
  }};
  TimeoutTimer<TimerWindow> unclick_timeout = {std::chrono::milliseconds(150), [this]() {…};
 
  void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
  {
    if (!gui_scope) return;
 
    this->SetWidgetDisabledState(WID_GSC_CHANGE, (_game_mode == GM_NORMAL) || !IsEditable());
 
    const GameConfig *config = GameConfig::GetConfig();
    this->SetWidgetDisabledState(WID_GSC_OPEN_URL, config->GetInfo() == nullptr || config->GetInfo()->GetURL().empty());
    for (TextfileType tft = TFT_CONTENT_BEGIN; tft < TFT_CONTENT_END; tft++) {
      this->SetWidgetDisabledState(WID_GSC_TEXTFILE + tft, !config->GetTextfile(tft, OWNER_DEITY).has_value());
    }
    this->RebuildVisibleSettings();
    this->CloseChildWindows(WC_DROPDOWN_MENU);
    this->CloseChildWindows(WC_QUERY_STRING);
  }
  void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override {…}
private:
  bool IsEditableItem(const ScriptConfigItem &config_item) const
  {
    return _game_mode == GM_MENU
      || _game_mode == GM_EDITOR
      || config_item.flags.Test(ScriptConfigFlag::InGame)
      || _settings_client.gui.ai_developer_tools;
  }
 
  void SetValue(int value)
  {
    const ScriptConfigItem &config_item = *this->visible_settings[this->clicked_row];
    if (_game_mode == GM_NORMAL && !config_item.flags.Test(ScriptConfigFlag::InGame)) return;
    this->gs_config->SetSetting(config_item.name, value);
    this->SetDirty();
  }
};
struct GSConfigWindow : public Window {…};
 
void ShowGSConfigWindow()
{
  CloseWindowByClass(WC_GAME_OPTIONS);
  new GSConfigWindow();
}
void ShowGSConfigWindow() {…}