engine_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 "window_gui.h"
#include "engine_base.h"
#include "command_func.h"
#include "strings_func.h"
#include "engine_gui.h"
#include "articulated_vehicles.h"
#include "vehicle_func.h"
#include "company_func.h"
#include "rail.h"
#include "road.h"
#include "settings_type.h"
#include "train.h"
#include "roadveh.h"
#include "ship.h"
#include "aircraft.h"
#include "engine_cmd.h"
#include "zoom_func.h"
 
#include "widgets/engine_widget.h"
 
#include "table/strings.h"
 
#include "safeguards.h"
 
StringID GetEngineCategoryName(EngineID engine)
{
  const Engine *e = Engine::Get(engine);
  switch (e->type) {
    default: NOT_REACHED();
    case VEH_ROAD:
      return GetRoadTypeInfo(e->u.road.roadtype)->strings.new_engine;
    case VEH_AIRCRAFT:          return STR_ENGINE_PREVIEW_AIRCRAFT;
    case VEH_SHIP:              return STR_ENGINE_PREVIEW_SHIP;
    case VEH_TRAIN:
      assert(e->u.rail.railtypes.Any());
      return GetRailTypeInfo(e->u.rail.railtypes.GetNthSetBit(0).value())->strings.new_loco;
  }
}
 
static constexpr NWidgetPart _nested_engine_preview_widgets[] = {
  NWidget(NWID_HORIZONTAL),
    NWidget(WWT_CLOSEBOX, COLOUR_LIGHT_BLUE),
    NWidget(WWT_CAPTION, COLOUR_LIGHT_BLUE), SetStringTip(STR_ENGINE_PREVIEW_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
  EndContainer(),
  NWidget(WWT_PANEL, COLOUR_LIGHT_BLUE),
    NWidget(NWID_VERTICAL), SetPIP(0, WidgetDimensions::unscaled.vsep_wide, 0), SetPadding(WidgetDimensions::unscaled.modalpopup),
      NWidget(WWT_EMPTY, INVALID_COLOUR, WID_EP_QUESTION), SetMinimalSize(300, 0), SetFill(1, 0),
      NWidget(NWID_HORIZONTAL, NWidContainerFlag::EqualSize), SetPIP(85, WidgetDimensions::unscaled.hsep_wide, 85),
        NWidget(WWT_PUSHTXTBTN, COLOUR_LIGHT_BLUE, WID_EP_NO), SetStringTip(STR_QUIT_NO), SetFill(1, 0),
        NWidget(WWT_PUSHTXTBTN, COLOUR_LIGHT_BLUE, WID_EP_YES), SetStringTip(STR_QUIT_YES), SetFill(1, 0),
      EndContainer(),
    EndContainer(),
  EndContainer(),
};
 
struct EnginePreviewWindow : Window {
  int vehicle_space = 0; // The space to show the vehicle image
 
  EnginePreviewWindow(WindowDesc &desc, WindowNumber window_number) : Window(desc)
  {
    this->InitNested(window_number);
 
    /* There is no way to recover the window; so disallow closure via DEL; unless SHIFT+DEL */
    this->flags.Set(WindowFlag::Sticky);
  }
 
  void UpdateWidgetSize(WidgetID widget, Dimension &size, [[maybe_unused]] const Dimension &padding, [[maybe_unused]] Dimension &fill, [[maybe_unused]] Dimension &resize) override
  {
    if (widget != WID_EP_QUESTION) return;
 
    /* Get size of engine sprite, on loan from depot_gui.cpp */
    EngineID engine = static_cast<EngineID>(this->window_number);
    EngineImageType image_type = EIT_PREVIEW;
    uint x, y;
    int x_offs, y_offs;
 
    const Engine *e = Engine::Get(engine);
    switch (e->type) {
      default: NOT_REACHED();
      case VEH_TRAIN:    GetTrainSpriteSize(   engine, x, y, x_offs, y_offs, image_type); break;
      case VEH_ROAD:     GetRoadVehSpriteSize( engine, x, y, x_offs, y_offs, image_type); break;
      case VEH_SHIP:     GetShipSpriteSize(    engine, x, y, x_offs, y_offs, image_type); break;
      case VEH_AIRCRAFT: GetAircraftSpriteSize(engine, x, y, x_offs, y_offs, image_type); break;
    }
    this->vehicle_space = std::max<int>(ScaleSpriteTrad(40), y - y_offs);
 
    size.width = std::max(size.width, x + std::abs(x_offs));
    size.height = GetStringHeight(GetString(STR_ENGINE_PREVIEW_MESSAGE, GetEngineCategoryName(engine)), size.width) + WidgetDimensions::scaled.vsep_wide + GetCharacterHeight(FS_NORMAL) + this->vehicle_space;
    size.height += GetStringHeight(GetEngineInfoString(engine), size.width);
  }
 
  void DrawWidget(const Rect &r, WidgetID widget) const override
  {
    if (widget != WID_EP_QUESTION) return;
 
    EngineID engine = static_cast<EngineID>(this->window_number);
    int y = DrawStringMultiLine(r, GetString(STR_ENGINE_PREVIEW_MESSAGE, GetEngineCategoryName(engine)), TC_FROMSTRING, SA_HOR_CENTER | SA_TOP) + WidgetDimensions::scaled.vsep_wide;
 
    DrawString(r.left, r.right, y, GetString(STR_ENGINE_NAME, PackEngineNameDParam(engine, EngineNameContext::PreviewNews)), TC_BLACK, SA_HOR_CENTER);
    y += GetCharacterHeight(FS_NORMAL);
 
    DrawVehicleEngine(r.left, r.right, this->width >> 1, y + this->vehicle_space / 2, engine, GetEnginePalette(engine, _local_company), EIT_PREVIEW);
 
    y += this->vehicle_space;
    DrawStringMultiLine(r.left, r.right, y, r.bottom, GetEngineInfoString(engine), TC_BLACK, SA_CENTER);
  }
 
  void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
  {
    switch (widget) {
      case WID_EP_YES:
        Command<CMD_WANT_ENGINE_PREVIEW>::Post(static_cast<EngineID>(this->window_number));
        [[fallthrough]];
      case WID_EP_NO:
        if (!_shift_pressed) this->Close();
        break;
    }
  }
 
  void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
  {
    if (!gui_scope) return;
 
    EngineID engine = static_cast<EngineID>(this->window_number);
    if (Engine::Get(engine)->preview_company != _local_company) this->Close();
  }
};
 
static WindowDesc _engine_preview_desc(
  WDP_CENTER, {}, 0, 0,
  WC_ENGINE_PREVIEW, WC_NONE,
  WindowDefaultFlag::Construction,
  _nested_engine_preview_widgets
);
 
 
void ShowEnginePreviewWindow(EngineID engine)
{
  AllocateWindowDescFront<EnginePreviewWindow>(_engine_preview_desc, engine);
}
 
uint GetTotalCapacityOfArticulatedParts(EngineID engine)
{
  CargoArray cap = GetCapacityOfArticulatedParts(engine);
  return cap.GetSum<uint>();
}
 
static std::string GetPreviewRunningCostString(const Engine &e)
{
  return GetString(TimerGameEconomy::UsingWallclockUnits() ? STR_ENGINE_PREVIEW_RUNCOST_PERIOD : STR_ENGINE_PREVIEW_RUNCOST_YEAR, e.GetRunningCost());
}
 
static std::string GetTrainEngineInfoString(const Engine &e)
{
  std::stringstream res;
 
  res << GetString(STR_ENGINE_PREVIEW_COST_WEIGHT, e.GetCost(), e.GetDisplayWeight());
  res << '\n';
 
  if (e.u.rail.railtypes.Count() > 1) {
    std::string railtypes{};
    std::string_view list_separator = GetListSeparator();
 
    for (const auto &rt : _sorted_railtypes) {
      if (!e.u.rail.railtypes.Test(rt)) continue;
 
      if (!railtypes.empty()) railtypes += list_separator;
      AppendStringInPlace(railtypes, GetRailTypeInfo(rt)->strings.name);
    }
    res << GetString(STR_ENGINE_PREVIEW_RAILTYPES, railtypes);
    res << '\n';
  }
 
  bool is_maglev = true;
  for (RailType rt : e.u.rail.railtypes) {
    is_maglev &= GetRailTypeInfo(rt)->acceleration_type == VehicleAccelerationModel::Maglev;
  }
 
  if (_settings_game.vehicle.train_acceleration_model != AM_ORIGINAL && !is_maglev) {
    res << GetString(STR_ENGINE_PREVIEW_SPEED_POWER_MAX_TE, PackVelocity(e.GetDisplayMaxSpeed(), e.type), e.GetPower(), e.GetDisplayMaxTractiveEffort());
    res << '\n';
  } else {
    res << GetString(STR_ENGINE_PREVIEW_SPEED_POWER, PackVelocity(e.GetDisplayMaxSpeed(), e.type), e.GetPower());
    res << '\n';
  }
 
  res << GetPreviewRunningCostString(e);
  res << '\n';
 
  uint capacity = GetTotalCapacityOfArticulatedParts(e.index);
  res << GetString(STR_ENGINE_PREVIEW_CAPACITY, capacity == 0 ? INVALID_CARGO : e.GetDefaultCargoType(), capacity);
 
  return res.str();
}
 
static std::string GetAircraftEngineInfoString(const Engine &e)
{
  std::stringstream res;
 
  res << GetString(STR_ENGINE_PREVIEW_COST_MAX_SPEED, e.GetCost(), PackVelocity(e.GetDisplayMaxSpeed(), e.type));
  res << '\n';
 
  if (uint16_t range = e.GetRange(); range > 0) {
    res << GetString(STR_ENGINE_PREVIEW_TYPE_RANGE, e.GetAircraftTypeText(), range);
    res << '\n';
  } else {
    res << GetString(STR_ENGINE_PREVIEW_TYPE, e.GetAircraftTypeText());
    res << '\n';
  }
 
  res << GetPreviewRunningCostString(e);
  res << '\n';
 
  CargoType cargo = e.GetDefaultCargoType();
  uint16_t mail_capacity;
  uint capacity = e.GetDisplayDefaultCapacity(&mail_capacity);
  if (mail_capacity > 0) {
    res << GetString(STR_ENGINE_PREVIEW_CAPACITY_2, cargo, capacity, GetCargoTypeByLabel(CT_MAIL), mail_capacity);
  } else {
    res << GetString(STR_ENGINE_PREVIEW_CAPACITY, cargo, capacity);
  }
 
  return res.str();
}
 
static std::string GetRoadVehEngineInfoString(const Engine &e)
{
  std::stringstream res;
 
  if (_settings_game.vehicle.roadveh_acceleration_model == AM_ORIGINAL) {
    res << GetString(STR_ENGINE_PREVIEW_COST_MAX_SPEED, e.GetCost(), PackVelocity(e.GetDisplayMaxSpeed(), e.type));
    res << '\n';
  } else {
    res << GetString(STR_ENGINE_PREVIEW_COST_WEIGHT, e.GetCost(), e.GetDisplayWeight());
    res << '\n';
    res << GetString(STR_ENGINE_PREVIEW_SPEED_POWER_MAX_TE, PackVelocity(e.GetDisplayMaxSpeed(), e.type), e.GetPower(), e.GetDisplayMaxTractiveEffort());
    res << '\n';
  }
 
  res << GetPreviewRunningCostString(e);
  res << '\n';
 
  uint capacity = GetTotalCapacityOfArticulatedParts(e.index);
  res << GetString(STR_ENGINE_PREVIEW_CAPACITY, capacity == 0 ? INVALID_CARGO : e.GetDefaultCargoType(), capacity);
 
  return res.str();
}
 
static std::string GetShipEngineInfoString(const Engine &e)
{
  std::stringstream res;
 
  res << GetString(STR_ENGINE_PREVIEW_COST_MAX_SPEED, e.GetCost(), PackVelocity(e.GetDisplayMaxSpeed(), e.type));
  res << '\n';
 
  res << GetPreviewRunningCostString(e);
  res << '\n';
 
  res << GetString(STR_ENGINE_PREVIEW_CAPACITY, e.GetDefaultCargoType(), e.GetDisplayDefaultCapacity());
 
  return res.str();
}
 
 
std::string GetEngineInfoString(EngineID engine)
{
  const Engine &e = *Engine::Get(engine);
 
  switch (e.type) {
    case VEH_TRAIN:
      return GetTrainEngineInfoString(e);
 
    case VEH_ROAD:
      return GetRoadVehEngineInfoString(e);
 
    case VEH_SHIP:
      return GetShipEngineInfoString(e);
 
    case VEH_AIRCRAFT:
      return GetAircraftEngineInfoString(e);
 
    default: NOT_REACHED();
  }
}
 
void DrawVehicleEngine(int left, int right, int preferred_x, int y, EngineID engine, PaletteID pal, EngineImageType image_type)
{
  const Engine *e = Engine::Get(engine);
 
  switch (e->type) {
    case VEH_TRAIN:
      DrawTrainEngine(left, right, preferred_x, y, engine, pal, image_type);
      break;
 
    case VEH_ROAD:
      DrawRoadVehEngine(left, right, preferred_x, y, engine, pal, image_type);
      break;
 
    case VEH_SHIP:
      DrawShipEngine(left, right, preferred_x, y, engine, pal, image_type);
      break;
 
    case VEH_AIRCRAFT:
      DrawAircraftEngine(left, right, preferred_x, y, engine, pal, image_type);
      break;
 
    default: NOT_REACHED();
  }
}
 
void EngList_Sort(GUIEngineList &el, EngList_SortTypeFunction compare)
{
  if (el.size() < 2) return;
  std::sort(el.begin(), el.end(), compare);
}
 
void EngList_SortPartial(GUIEngineList &el, EngList_SortTypeFunction compare, size_t begin, size_t num_items)
{
  if (num_items < 2) return;
  assert(begin < el.size());
  assert(begin + num_items <= el.size());
  std::sort(el.begin() + begin, el.begin() + begin + num_items, compare);
}