OpenTTD Source 20250218-master-g53dd1258a7
engine_gui.cpp
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
4 * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
5 * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
6 */
7
10#include "stdafx.h"
11#include "window_gui.h"
12#include "engine_base.h"
13#include "command_func.h"
14#include "strings_func.h"
15#include "engine_gui.h"
17#include "vehicle_func.h"
18#include "company_func.h"
19#include "rail.h"
20#include "road.h"
21#include "settings_type.h"
22#include "train.h"
23#include "roadveh.h"
24#include "ship.h"
25#include "aircraft.h"
26#include "engine_cmd.h"
27#include "zoom_func.h"
28
30
31#include "table/strings.h"
32
33#include "safeguards.h"
34
41{
42 const Engine *e = Engine::Get(engine);
43 switch (e->type) {
44 default: NOT_REACHED();
45 case VEH_ROAD:
46 return GetRoadTypeInfo(e->u.road.roadtype)->strings.new_engine;
47 case VEH_AIRCRAFT: return STR_ENGINE_PREVIEW_AIRCRAFT;
48 case VEH_SHIP: return STR_ENGINE_PREVIEW_SHIP;
49 case VEH_TRAIN:
50 return GetRailTypeInfo(e->u.rail.railtype)->strings.new_loco;
51 }
52}
53
54static constexpr NWidgetPart _nested_engine_preview_widgets[] = {
56 NWidget(WWT_CLOSEBOX, COLOUR_LIGHT_BLUE),
57 NWidget(WWT_CAPTION, COLOUR_LIGHT_BLUE), SetStringTip(STR_ENGINE_PREVIEW_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
59 NWidget(WWT_PANEL, COLOUR_LIGHT_BLUE),
61 NWidget(WWT_EMPTY, INVALID_COLOUR, WID_EP_QUESTION), SetMinimalSize(300, 0), SetFill(1, 0),
63 NWidget(WWT_PUSHTXTBTN, COLOUR_LIGHT_BLUE, WID_EP_NO), SetStringTip(STR_QUIT_NO), SetFill(1, 0),
64 NWidget(WWT_PUSHTXTBTN, COLOUR_LIGHT_BLUE, WID_EP_YES), SetStringTip(STR_QUIT_YES), SetFill(1, 0),
68};
69
71 int vehicle_space; // The space to show the vehicle image
72
74 {
75 this->InitNested(window_number);
76
77 /* There is no way to recover the window; so disallow closure via DEL; unless SHIFT+DEL */
79 }
80
82 {
83 if (widget != WID_EP_QUESTION) return;
84
85 /* Get size of engine sprite, on loan from depot_gui.cpp */
86 EngineID engine = static_cast<EngineID>(this->window_number);
88 uint x, y;
89 int x_offs, y_offs;
90
91 const Engine *e = Engine::Get(engine);
92 switch (e->type) {
93 default: NOT_REACHED();
94 case VEH_TRAIN: GetTrainSpriteSize( engine, x, y, x_offs, y_offs, image_type); break;
95 case VEH_ROAD: GetRoadVehSpriteSize( engine, x, y, x_offs, y_offs, image_type); break;
96 case VEH_SHIP: GetShipSpriteSize( engine, x, y, x_offs, y_offs, image_type); break;
97 case VEH_AIRCRAFT: GetAircraftSpriteSize(engine, x, y, x_offs, y_offs, image_type); break;
98 }
99 this->vehicle_space = std::max<int>(ScaleSpriteTrad(40), y - y_offs);
100
101 size.width = std::max(size.width, x + std::abs(x_offs));
104 SetDParam(0, engine);
105 size.height += GetStringHeight(GetEngineInfoString(engine), size.width);
106 }
107
108 void DrawWidget(const Rect &r, WidgetID widget) const override
109 {
110 if (widget != WID_EP_QUESTION) return;
111
112 EngineID engine = static_cast<EngineID>(this->window_number);
115
117 DrawString(r.left, r.right, y, STR_ENGINE_NAME, TC_BLACK, SA_HOR_CENTER);
119
120 DrawVehicleEngine(r.left, r.right, this->width >> 1, y + this->vehicle_space / 2, engine, GetEnginePalette(engine, _local_company), EIT_PREVIEW);
121
122 y += this->vehicle_space;
123 DrawStringMultiLine(r.left, r.right, y, r.bottom, GetEngineInfoString(engine), TC_BLACK, SA_CENTER);
124 }
125
126 void OnClick([[maybe_unused]] Point pt, WidgetID widget, [[maybe_unused]] int click_count) override
127 {
128 switch (widget) {
129 case WID_EP_YES:
130 Command<CMD_WANT_ENGINE_PREVIEW>::Post(static_cast<EngineID>(this->window_number));
131 [[fallthrough]];
132 case WID_EP_NO:
133 if (!_shift_pressed) this->Close();
134 break;
135 }
136 }
137
138 void OnInvalidateData([[maybe_unused]] int data = 0, [[maybe_unused]] bool gui_scope = true) override
139 {
140 if (!gui_scope) return;
141
142 EngineID engine = static_cast<EngineID>(this->window_number);
143 if (Engine::Get(engine)->preview_company != _local_company) this->Close();
144 }
145};
146
147static WindowDesc _engine_preview_desc(
148 WDP_CENTER, nullptr, 0, 0,
151 _nested_engine_preview_widgets
152);
153
154
155void ShowEnginePreviewWindow(EngineID engine)
156{
157 AllocateWindowDescFront<EnginePreviewWindow>(_engine_preview_desc, engine);
158}
159
166{
168 return cap.GetSum<uint>();
169}
170
176static std::string GetPreviewRunningCostString(const Engine &e)
177{
178 return GetString(TimerGameEconomy::UsingWallclockUnits() ? STR_ENGINE_PREVIEW_RUNCOST_PERIOD : STR_ENGINE_PREVIEW_RUNCOST_YEAR, e.GetRunningCost());
179}
180
181static std::string GetTrainEngineInfoString(const Engine &e)
182{
183 std::stringstream res;
184
185 res << GetString(STR_ENGINE_PREVIEW_COST_WEIGHT, e.GetCost(), e.GetDisplayWeight());
186 res << '\n';
187
189 res << GetString(STR_ENGINE_PREVIEW_SPEED_POWER_MAX_TE, PackVelocity(e.GetDisplayMaxSpeed(), e.type), e.GetPower(), e.GetDisplayMaxTractiveEffort());
190 res << '\n';
191 } else {
192 res << GetString(STR_ENGINE_PREVIEW_SPEED_POWER, PackVelocity(e.GetDisplayMaxSpeed(), e.type), e.GetPower());
193 res << '\n';
194 }
195
197 res << '\n';
198
199 uint capacity = GetTotalCapacityOfArticulatedParts(e.index);
200 res << GetString(STR_ENGINE_PREVIEW_CAPACITY, capacity == 0 ? INVALID_CARGO : e.GetDefaultCargoType(), capacity);
201
202 return res.str();
203}
204
205static std::string GetAircraftEngineInfoString(const Engine &e)
206{
207 std::stringstream res;
208
209 res << GetString(STR_ENGINE_PREVIEW_COST_MAX_SPEED, e.GetCost(), PackVelocity(e.GetDisplayMaxSpeed(), e.type));
210 res << '\n';
211
212 if (uint16_t range = e.GetRange(); range > 0) {
213 res << GetString(STR_ENGINE_PREVIEW_TYPE_RANGE, e.GetAircraftTypeText(), range);
214 res << '\n';
215 } else {
216 res << GetString(STR_ENGINE_PREVIEW_TYPE, e.GetAircraftTypeText());
217 res << '\n';
218 }
219
221 res << '\n';
222
223 CargoType cargo = e.GetDefaultCargoType();
224 uint16_t mail_capacity;
225 uint capacity = e.GetDisplayDefaultCapacity(&mail_capacity);
226 if (mail_capacity > 0) {
227 res << GetString(STR_ENGINE_PREVIEW_CAPACITY_2, cargo, capacity, GetCargoTypeByLabel(CT_MAIL), mail_capacity);
228 } else {
229 res << GetString(STR_ENGINE_PREVIEW_CAPACITY, cargo, capacity);
230 }
231
232 return res.str();
233}
234
235static std::string GetRoadVehEngineInfoString(const Engine &e)
236{
237 std::stringstream res;
238
240 res << GetString(STR_ENGINE_PREVIEW_COST_MAX_SPEED, e.GetCost(), PackVelocity(e.GetDisplayMaxSpeed(), e.type));
241 res << '\n';
242 } else {
243 res << GetString(STR_ENGINE_PREVIEW_COST_WEIGHT, e.GetCost(), e.GetDisplayWeight());
244 res << '\n';
245 res << GetString(STR_ENGINE_PREVIEW_SPEED_POWER_MAX_TE, PackVelocity(e.GetDisplayMaxSpeed(), e.type), e.GetPower(), e.GetDisplayMaxTractiveEffort());
246 res << '\n';
247 }
248
250 res << '\n';
251
252 uint capacity = GetTotalCapacityOfArticulatedParts(e.index);
253 res << GetString(STR_ENGINE_PREVIEW_CAPACITY, capacity == 0 ? INVALID_CARGO : e.GetDefaultCargoType(), capacity);
254
255 return res.str();
256}
257
258static std::string GetShipEngineInfoString(const Engine &e)
259{
260 std::stringstream res;
261
262 res << GetString(STR_ENGINE_PREVIEW_COST_MAX_SPEED, e.GetCost(), PackVelocity(e.GetDisplayMaxSpeed(), e.type));
263 res << '\n';
264
266 res << '\n';
267
268 res << GetString(STR_ENGINE_PREVIEW_CAPACITY, e.GetDefaultCargoType(), e.GetDisplayDefaultCapacity());
269
270 return res.str();
271}
272
273
280std::string GetEngineInfoString(EngineID engine)
281{
282 const Engine &e = *Engine::Get(engine);
283
284 switch (e.type) {
285 case VEH_TRAIN:
286 return GetTrainEngineInfoString(e);
287
288 case VEH_ROAD:
289 return GetRoadVehEngineInfoString(e);
290
291 case VEH_SHIP:
292 return GetShipEngineInfoString(e);
293
294 case VEH_AIRCRAFT:
295 return GetAircraftEngineInfoString(e);
296
297 default: NOT_REACHED();
298 }
299}
300
310void DrawVehicleEngine(int left, int right, int preferred_x, int y, EngineID engine, PaletteID pal, EngineImageType image_type)
311{
312 const Engine *e = Engine::Get(engine);
313
314 switch (e->type) {
315 case VEH_TRAIN:
316 DrawTrainEngine(left, right, preferred_x, y, engine, pal, image_type);
317 break;
318
319 case VEH_ROAD:
320 DrawRoadVehEngine(left, right, preferred_x, y, engine, pal, image_type);
321 break;
322
323 case VEH_SHIP:
324 DrawShipEngine(left, right, preferred_x, y, engine, pal, image_type);
325 break;
326
327 case VEH_AIRCRAFT:
328 DrawAircraftEngine(left, right, preferred_x, y, engine, pal, image_type);
329 break;
330
331 default: NOT_REACHED();
332 }
333}
334
341{
342 if (el.size() < 2) return;
343 std::sort(el.begin(), el.end(), compare);
344}
345
353void EngList_SortPartial(GUIEngineList &el, EngList_SortTypeFunction compare, size_t begin, size_t num_items)
354{
355 if (num_items < 2) return;
356 assert(begin < el.size());
357 assert(begin + num_items <= el.size());
358 std::sort(el.begin() + begin, el.begin() + begin + num_items, compare);
359}
360
Base for aircraft.
void GetAircraftSpriteSize(EngineID engine, uint &width, uint &height, int &xoffs, int &yoffs, EngineImageType image_type)
Get the size of the sprite of an aircraft sprite heading west (used for lists).
CargoArray GetCapacityOfArticulatedParts(EngineID engine)
Get the capacity of the parts of a given engine.
Functions related to articulated vehicles.
uint8_t CargoType
Cargo slots to indicate a cargo type within a game.
Definition cargo_type.h:23
constexpr Timpl & Set()
Set all bits.
struct RailTypeInfo::@24 strings
Strings associated with the rail type.
StringID new_loco
Name of an engine for this type of rail in the engine preview GUI.
Definition rail.h:172
uint8_t acceleration_type
Acceleration type of this rail type.
Definition rail.h:217
struct RoadTypeInfo::@27 strings
Strings associated with the rail type.
StringID new_engine
Name of an engine for this type of road in the engine preview GUI.
Definition road.h:99
static bool UsingWallclockUnits(bool newgame=false)
Check if we are using wallclock units.
static WidgetDimensions scaled
Widget dimensions scaled for current zoom level.
Definition window_gui.h:28
int vsep_wide
Wide vertical spacing.
Definition window_gui.h:60
static const WidgetDimensions unscaled
Unscaled widget dimensions.
Definition window_gui.h:94
Functions related to commands.
CompanyID _local_company
Company controlled by the human player at this client. Can also be COMPANY_SPECTATOR.
Functions related to companies.
Base class for engines.
Command definitions related to engines.
std::string GetEngineInfoString(EngineID engine)
Get a multi-line string with some technical data, describing the engine.
void EngList_Sort(GUIEngineList &el, EngList_SortTypeFunction compare)
Sort all items using quick sort and given 'CompareItems' function.
static std::string GetPreviewRunningCostString(const Engine &e)
Get preview running cost string for an engine.
uint GetTotalCapacityOfArticulatedParts(EngineID engine)
Get the capacity of an engine with articulated parts.
StringID GetEngineCategoryName(EngineID engine)
Return the category of an engine.
void EngList_SortPartial(GUIEngineList &el, EngList_SortTypeFunction compare, size_t begin, size_t num_items)
Sort selected range of items (on indices @ <begin, begin+num_items-1>)
void DrawVehicleEngine(int left, int right, int preferred_x, int y, EngineID engine, PaletteID pal, EngineImageType image_type)
Draw an engine.
Engine GUI functions, used by build_vehicle_gui and autoreplace_gui
bool EngList_SortTypeFunction(const GUIEngineListItem &, const GUIEngineListItem &)
argument type for EngList_Sort.
Definition engine_gui.h:33
void DrawRoadVehEngine(int left, int right, int preferred_x, int y, EngineID engine, PaletteID pal, EngineImageType image_type)
Draw a road vehicle engine.
uint64_t PackEngineNameDParam(EngineID engine_id, EngineNameContext context, uint32_t extra_data=0)
Combine an engine ID and a name context to an engine name dparam.
@ PreviewNews
Name is shown in exclusive preview or newspaper.
Types related to the engine widgets.
@ WID_EP_QUESTION
The container for the question.
@ WID_EP_NO
No button.
@ WID_EP_YES
Yes button.
int GetCharacterHeight(FontSize size)
Get height of a character for a given font size.
Definition fontcache.cpp:77
int GetStringHeight(std::string_view str, int maxw, FontSize fontsize)
Calculates height of string (in pixels).
Definition gfx.cpp:704
bool _shift_pressed
Is Shift pressed?
Definition gfx.cpp:39
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:657
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:774
@ FS_NORMAL
Index of the normal font in the font tables.
Definition gfx_type.h:243
@ SA_TOP
Top align the text.
Definition gfx_type.h:380
@ SA_HOR_CENTER
Horizontally center the text.
Definition gfx_type.h:376
@ SA_CENTER
Center both horizontally and vertically.
Definition gfx_type.h:385
uint32_t PaletteID
The number of the palette.
Definition gfx_type.h:18
constexpr NWidgetPart SetFill(uint16_t fill_x, uint16_t fill_y)
Widget part function for setting filling.
constexpr NWidgetPart SetPIP(uint8_t pre, uint8_t inter, uint8_t post)
Widget part function for setting a pre/inter/post spaces.
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 SetMinimalSize(int16_t x, int16_t y)
Widget part function for setting the minimal size.
constexpr NWidgetPart NWidget(WidgetType tp, Colours col, WidgetID idx=-1)
Widget part function for starting a new 'real' widget.
constexpr NWidgetPart EndContainer()
Widget part function for denoting the end of a container (horizontal, vertical, WWT_FRAME,...
Rail specific functions.
const RailTypeInfo * GetRailTypeInfo(RailType railtype)
Returns a pointer to the Railtype information for a given railtype.
Definition rail.h:300
Road specific functions.
const RoadTypeInfo * GetRoadTypeInfo(RoadType roadtype)
Returns a pointer to the Roadtype information for a given roadtype.
Definition road.h:220
Road vehicle states.
void GetRoadVehSpriteSize(EngineID engine, uint &width, uint &height, int &xoffs, int &yoffs, EngineImageType image_type)
Get the size of the sprite of a road vehicle sprite heading west (used for lists).
A number of safeguards to prevent using unsafe methods.
GameSettings _settings_game
Game settings of a running game or the scenario editor.
Definition settings.cpp:58
Types related to global configuration settings.
Base for ships.
void GetShipSpriteSize(EngineID engine, uint &width, uint &height, int &xoffs, int &yoffs, EngineImageType image_type)
Get the size of the sprite of a ship sprite heading west (used for lists).
Definition ship_cmd.cpp:120
Definition of base types and functions in a cross-platform compatible way.
void SetDParam(size_t n, uint64_t v)
Set a string parameter v at index n in the global string parameter array.
Definition strings.cpp:163
std::string GetString(StringID string)
Resolve the given StringID into a std::string with all the associated DParam lookups and formatting.
Definition strings.cpp:420
Functions related to OTTD's strings.
int64_t PackVelocity(uint speed, VehicleType type)
Pack velocity and vehicle type for use with SCC_VELOCITY string parameter.
uint32_t StringID
Numeric value that represents a string, independent of the selected language.
Class for storing amounts of cargo.
Definition cargo_type.h:113
const T GetSum() const
Get the sum of all cargo amounts.
Definition cargo_type.h:119
Dimensions (a width and height) of a rectangle in 2D.
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.
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 OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
StringID GetAircraftTypeText() const
Get the name of the aircraft type for display purposes.
Definition engine.cpp:467
uint GetPower() const
Returns the power of the engine for display and sorting purposes.
Definition engine.cpp:390
uint16_t GetRange() const
Get the range of an aircraft type.
Definition engine.cpp:453
Money GetCost() const
Return how much a new engine costs.
Definition engine.cpp:318
uint GetDisplayMaxSpeed() const
Returns max speed of the engine for display purposes.
Definition engine.cpp:358
uint GetDisplayWeight() const
Returns the weight of the engine for display purposes.
Definition engine.cpp:408
VehicleType type
Vehicle type, ie VEH_ROAD, VEH_TRAIN, etc.
Definition engine_base.h:61
uint GetDisplayDefaultCapacity(uint16_t *mail_capacity=nullptr) const
Determines the default cargo capacity of an engine for display purposes.
CargoType GetDefaultCargoType() const
Determines the default cargo type of an engine.
Money GetRunningCost() const
Return how much the running costs of this engine are.
Definition engine.cpp:281
uint GetDisplayMaxTractiveEffort() const
Returns the tractive effort of the engine for display purposes.
Definition engine.cpp:426
VehicleSettings vehicle
options for vehicles
Partial widget specification to allow NWidgets to be written nested.
Coordinates of a point in 2D.
Tindex index
Index of this pool item.
static Titem * Get(auto index)
Returns Titem with given index.
RailType railtype
Railtype, mangled if elrail is disabled.
Definition engine_type.h:50
Specification of a rectangle with absolute coordinates of all edges.
RoadType roadtype
Road type.
uint8_t roadveh_acceleration_model
realistic acceleration for road vehicles
uint8_t train_acceleration_model
realistic acceleration for trains
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:272
virtual void Close(int data=0)
Hide the window and all its child windows, and mark them for a later deletion.
Definition window.cpp:1044
ResizeInfo resize
Resize information.
Definition window_gui.h:313
const NWID * GetWidget(WidgetID widnum) const
Get the nested widget with number widnum from the nested widget tree.
Definition window_gui.h:969
void InitNested(WindowNumber number=0)
Perform complete initialization of the Window with nested widgets, to allow use.
Definition window.cpp:1743
WindowFlags flags
Window flags.
Definition window_gui.h:299
WindowNumber window_number
Window number within the window class.
Definition window_gui.h:301
Base for the train class.
void GetTrainSpriteSize(EngineID engine, uint &width, uint &height, int &xoffs, int &yoffs, EngineImageType image_type)
Get the size of the sprite of a train sprite heading west, or both heads (used for lists).
PaletteID GetEnginePalette(EngineID engine_type, CompanyID company)
Get the colour map for an engine.
Definition vehicle.cpp:2139
Functions related to vehicles.
EngineImageType
Visualisation contexts of vehicles and engines.
@ EIT_PURCHASE
Vehicle drawn in purchase list, autoreplace gui, ...
@ EIT_PREVIEW
Vehicle drawn in preview window, news, ...
@ VEH_ROAD
Road vehicle type.
@ VEH_AIRCRAFT
Aircraft vehicle type.
@ VEH_SHIP
Ship vehicle type.
@ VEH_TRAIN
Train vehicle type.
@ WWT_PUSHTXTBTN
Normal push-button (no toggle button) with text caption.
@ NWID_HORIZONTAL
Horizontal container.
Definition widget_type.h:66
@ WWT_PANEL
Simple depressed panel.
Definition widget_type.h:41
@ WWT_CAPTION
Window caption (window title between closebox and stickybox)
Definition widget_type.h:52
@ NWID_VERTICAL
Vertical container.
Definition widget_type.h:68
@ WWT_CLOSEBOX
Close box (at top-left of a window)
Definition widget_type.h:60
@ WWT_EMPTY
Empty widget, place holder to reserve space in widget tree.
Definition widget_type.h:39
@ EqualSize
Containers should keep all their (resizing) children equally large.
Functions, definitions and such used only by the GUI.
@ Construction
This window is used for construction; close it whenever changing company.
@ Sticky
Window is made sticky by user.
@ WDP_CENTER
Center the window.
Definition window_gui.h:146
int WidgetID
Widget ID.
Definition window_type.h:20
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
Definition window_type.h:47
@ WC_ENGINE_PREVIEW
Engine preview window; Window numbers:
Functions related to zooming.
int ScaleSpriteTrad(int value)
Scale traditional pixel dimensions to GUI zoom level, for drawing sprites.
Definition zoom_func.h:107