OpenTTD Source 20250524-master-gc366e6a48e
highscore_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 "highscore.h"
12#include "gfx_func.h"
13#include "table/sprites.h"
14#include "window_gui.h"
15#include "window_func.h"
16#include "network/network.h"
17#include "command_func.h"
18#include "company_func.h"
19#include "company_base.h"
20#include "strings_func.h"
21#include "hotkeys.h"
22#include "zoom_func.h"
23#include "misc_cmd.h"
24#include "timer/timer.h"
26
28
29#include "table/strings.h"
30
31#include "safeguards.h"
32
34 SpriteID background_img{};
35 int8_t rank = 0;
36
38 {
39 this->InitNested();
41 ResizeWindow(this, _screen.width - this->width, _screen.height - this->height);
42 }
43
44 /* Always draw a maximized window and within it the centered background */
45 void SetupHighScoreEndWindow()
46 {
47 /* Resize window to "full-screen". */
48 if (this->width != _screen.width || this->height != _screen.height) ResizeWindow(this, _screen.width - this->width, _screen.height - this->height);
49
50 this->DrawWidgets();
51
52 /* Standard background slices are 50 pixels high, but it's designed
53 * for 480 pixels total. 96% of 500 is 480. */
54 Dimension dim = GetSpriteSize(this->background_img);
55 Point pt = this->GetTopLeft(dim.width, dim.height * 96 / 10);
56 /* Center Highscore/Endscreen background */
57 for (uint i = 0; i < 10; i++) { // the image is split into 10 50px high parts
58 DrawSprite(this->background_img + i, PAL_NONE, pt.x, pt.y + (i * dim.height));
59 }
60 }
61
63 Point GetTopLeft(int x, int y)
64 {
65 Point pt = {std::max(0, (_screen.width / 2) - (x / 2)), std::max(0, (_screen.height / 2) - (y / 2))};
66 return pt;
67 }
68
69 void OnClick([[maybe_unused]] Point pt, [[maybe_unused]] WidgetID widget, [[maybe_unused]] int click_count) override
70 {
71 this->Close();
72 }
73
74 EventState OnKeyPress([[maybe_unused]] char32_t key, uint16_t keycode) override
75 {
76 /* All keys are 'handled' by this window but we want to make
77 * sure that 'quit' still works correctly. Not handling the
78 * quit key is enough so the main toolbar can handle it. */
79 if (IsQuitKey(keycode)) return ES_NOT_HANDLED;
80
81 switch (keycode) {
82 /* Keys for telling we want to go on */
83 case WKC_RETURN:
84 case WKC_ESC:
85 case WKC_SPACE:
86 this->Close();
87 return ES_HANDLED;
88
89 default:
90 /* We want to handle all keys; we don't want windows in
91 * the background to open. Especially the ones that do
92 * locate themselves based on the status-/toolbars. */
93 return ES_HANDLED;
94 }
95 }
96};
97
101 {
102 /* Pause in single-player to have a look at the highscore at your own leisure */
104
105 this->background_img = SPR_TYCOON_IMG1_BEGIN;
106
109 if (c->old_economy[0].performance_history == SCORE_MAX) {
110 this->background_img = SPR_TYCOON_IMG2_BEGIN;
111 }
112 }
113
114 /* In a network game show the endscores of the custom difficulty 'network' which is
115 * a TOP5 of that game, and not an all-time TOP5. */
116 if (_networking) {
118 this->rank = SaveHighScoreValueNetwork();
119 } else {
120 /* in singleplayer mode _local company is always valid */
122 this->window_number = SP_CUSTOM;
123 this->rank = SaveHighScoreValue(c);
124 }
125
127 }
128
129 void Close([[maybe_unused]] int data = 0) override
130 {
132 if (_game_mode != GM_MENU && !_exit_game) ShowHighscoreTable(this->window_number, this->rank);
134 }
135
136 void OnPaint() override
137 {
138 this->SetupHighScoreEndWindow();
139 Point pt = this->GetTopLeft(ScaleSpriteTrad(640), ScaleSpriteTrad(480));
140
142 if (c == nullptr) return;
143
144 /* We need to get performance from last year because the image is shown
145 * at the start of the new year when these things have already been copied */
146 if (this->background_img == SPR_TYCOON_IMG2_BEGIN) { // Tycoon of the century \o/
147 DrawStringMultiLine(pt.x + ScaleSpriteTrad(15), pt.x + ScaleSpriteTrad(640) - ScaleSpriteTrad(25), pt.y + ScaleSpriteTrad(90), pt.y + ScaleSpriteTrad(160),
148 GetString(STR_HIGHSCORE_PRESIDENT_OF_COMPANY_ACHIEVES_STATUS, c->index, c->index, EndGameGetPerformanceTitleFromValue(c->old_economy[0].performance_history)),
149 TC_FROMSTRING, SA_CENTER);
150 } else {
151 DrawStringMultiLine(pt.x + ScaleSpriteTrad(36), pt.x + ScaleSpriteTrad(640), pt.y + ScaleSpriteTrad(140), pt.y + ScaleSpriteTrad(206),
152 GetString(STR_HIGHSCORE_COMPANY_ACHIEVES_STATUS, c->index, EndGameGetPerformanceTitleFromValue(c->old_economy[0].performance_history)),
153 TC_FROMSTRING, SA_CENTER);
154 }
155 }
156};
157
160
161 HighScoreWindow(WindowDesc &desc, int difficulty, int8_t ranking) : EndGameHighScoreBaseWindow(desc)
162 {
163 /* pause game to show the chart */
164 this->game_paused_by_player = _pause_mode == PauseMode::Normal;
165 if (!_networking && !this->game_paused_by_player) Command<CMD_PAUSE>::Post(PauseMode::Normal, true);
166
167 /* Close all always on-top windows to get a clean screen */
168 if (_game_mode != GM_MENU) HideVitalWindows();
169
171 this->window_number = difficulty; // show highscore chart for difficulty...
172 this->background_img = SPR_HIGHSCORE_CHART_BEGIN; // which background to show
173 this->rank = ranking;
174 }
175
176 void Close([[maybe_unused]] int data = 0) override
177 {
178 if (_game_mode != GM_MENU && !_exit_game) ShowVitalWindows();
179
180 if (!_networking && !this->game_paused_by_player) Command<CMD_PAUSE>::Post(PauseMode::Normal, false); // unpause
181
183 }
184
185 void OnPaint() override
186 {
187 const auto &hs = _highscore_table[this->window_number];
188
189 this->SetupHighScoreEndWindow();
190 Point pt = this->GetTopLeft(ScaleSpriteTrad(640), ScaleSpriteTrad(480));
191
192 /* Draw the title. */
193 DrawStringMultiLine(pt.x + ScaleSpriteTrad(70), pt.x + ScaleSpriteTrad(570), pt.y, pt.y + ScaleSpriteTrad(140), STR_HIGHSCORE_TOP_COMPANIES, TC_FROMSTRING, SA_CENTER);
194
195 /* Draw Highscore peepz */
196 for (uint8_t i = 0; i < ClampTo<uint8_t>(hs.size()); i++) {
197 DrawString(pt.x + ScaleSpriteTrad(40), pt.x + ScaleSpriteTrad(600), pt.y + ScaleSpriteTrad(140 + i * 55),
198 GetString(STR_HIGHSCORE_POSITION, i + 1));
199
200 if (!hs[i].name.empty()) {
201 TextColour colour = (this->rank == i) ? TC_RED : TC_BLACK; // draw new highscore in red
202
203 DrawString(pt.x + ScaleSpriteTrad(71), pt.x + ScaleSpriteTrad(569), pt.y + ScaleSpriteTrad(140 + i * 55),
204 GetString(STR_JUST_BIG_RAW_STRING, hs[i].name), colour);
206 GetString(STR_HIGHSCORE_STATS, hs[i].title, hs[i].score), colour);
207 }
208 }
209 }
210};
211
212static constexpr NWidgetPart _nested_highscore_widgets[] = {
213 NWidget(WWT_PANEL, COLOUR_BROWN, WID_H_BACKGROUND), SetResize(1, 1), EndContainer(),
214};
215
216static WindowDesc _highscore_desc(
217 WDP_MANUAL, {}, 0, 0,
219 {},
220 _nested_highscore_widgets
221);
222
223static WindowDesc _endgame_desc(
224 WDP_MANUAL, {}, 0, 0,
226 {},
227 _nested_highscore_widgets
228);
229
235void ShowHighscoreTable(int difficulty, int8_t ranking)
236{
238 new HighScoreWindow(_highscore_desc, difficulty, ranking);
239}
240
246{
247 /* Dedicated server doesn't need the highscore window and neither does -v null. */
249
252 new EndGameWindow(_endgame_desc);
253}
254
255static const IntervalTimer<TimerGameCalendar> _check_end_game({TimerGameCalendar::YEAR, TimerGameCalendar::Priority::NONE}, [](auto)
256{
257 /* 0 = never */
259
260 /* Show the end-game chart at the end of the ending year (hence the + 1). */
263 }
264});
constexpr Timpl & Reset()
Reset all bits.
An interval timer will fire every interval, and will continue to fire until it is deleted.
Definition timer.h:76
static Year year
Current year, starting at 0.
Functions related to commands.
Definition of stuff that is very close to a company, like the company struct itself.
CompanyID _local_company
Company controlled by the human player at this client. Can also be COMPANY_SPECTATOR.
Functions related to companies.
static constexpr CompanyID COMPANY_SPECTATOR
The client is spectating.
static constexpr int SCORE_MAX
The max score that can be in the performance history.
int GetCharacterHeight(FontSize size)
Get height of a character for a given font size.
Definition fontcache.cpp:77
Dimension GetSpriteSize(SpriteID sprid, Point *offset, ZoomLevel zoom)
Get the size of a sprite.
Definition gfx.cpp:958
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:658
void DrawSprite(SpriteID img, PaletteID pal, int x, int y, const SubSprite *sub, ZoomLevel zoom)
Draw a sprite, not in a viewport.
Definition gfx.cpp:1024
PauseModes _pause_mode
The current pause mode.
Definition gfx.cpp:50
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:775
Functions related to the gfx engine.
uint32_t SpriteID
The number of a sprite, without mapping bits and colourtables.
Definition gfx_type.h:17
@ FS_LARGE
Index of the large font in the font tables.
Definition gfx_type.h:253
@ SA_CENTER
Center both horizontally and vertically.
Definition gfx_type.h:393
TextColour
Colour of the strings, see _string_colourmap in table/string_colours.h or docs/ottd-colourtext-palett...
Definition gfx_type.h:302
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,...
constexpr NWidgetPart SetResize(int16_t dx, int16_t dy)
Widget part function for setting the resize step.
void MarkWholeScreenDirty()
This function mark the whole screen as dirty.
Definition gfx.cpp:1535
int8_t SaveHighScoreValueNetwork()
Save the highscores in a network game when it has ended.
Definition highscore.cpp:88
HighScoresTable _highscore_table
Table with all the high scores.
Definition highscore.cpp:24
int8_t SaveHighScoreValue(const Company *c)
Save the highscore for the company.
Definition highscore.cpp:58
Declaration of functions and types defined in highscore.h and highscore_gui.h.
void ShowHighscoreTable(int difficulty, int8_t ranking)
Show the highscore table for a given difficulty.
void ShowEndGameChart()
Show the endgame victory screen in 2050.
Types related to the highscore widgets.
@ WID_H_BACKGROUND
Background of the window.
Hotkey related functions.
bool IsQuitKey(uint16_t keycode)
Does the given keycode match one of the keycodes bound to 'quit game'?
Definition main_gui.cpp:541
void ShowVitalWindows()
Show the vital in-game windows.
Definition main_gui.cpp:582
Miscellaneous command definitions.
bool _networking
are we in networking mode?
Definition network.cpp:67
bool _network_dedicated
are we a dedicated server?
Definition network.cpp:70
Basic functions/variables used all over the place.
@ Normal
A game normally paused.
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:60
@ SP_CUSTOM
No profile, special "custom" highscore.
@ SP_MULTIPLAYER
Special "multiplayer" highscore. Not saved, always specific to the current game.
This file contains all sprite-related enums and defines.
Definition of base types and functions in a cross-platform compatible way.
std::string GetString(StringID string)
Resolve the given StringID into a std::string with formatting but no parameters.
Definition strings.cpp:415
Functions related to OTTD's strings.
std::array< CompanyEconomyEntry, MAX_HISTORY_QUARTERS > old_economy
Economic data of the company of the last MAX_HISTORY_QUARTERS quarters.
Dimensions (a width and height) of a rectangle in 2D.
EventState OnKeyPress(char32_t key, uint16_t keycode) override
A key has been pressed.
Point GetTopLeft(int x, int y)
Return the coordinate of the screen such that a window of 640x480 is centered at the screen.
void OnClick(Point pt, WidgetID widget, int click_count) override
A click with the left mouse button has been made on the window.
End game window shown at the end of the game.
void Close(int data=0) override
Hide the window and all its child windows, and mark them for a later deletion.
void OnPaint() override
The window must be repainted.
TimerGameCalendar::Year ending_year
scoring end date
GameCreationSettings game_creation
settings used during the creation of a game (map)
void OnPaint() override
The window must be repainted.
void Close(int data=0) override
Hide the window and all its child windows, and mark them for a later deletion.
bool game_paused_by_player
True if the game was paused by the player when the highscore window was opened.
Partial widget specification to allow NWidgets to be written nested.
Coordinates of a point in 2D.
static Titem * Get(auto index)
Returns Titem with given index.
Tindex index
Index of this pool item.
static bool IsValidID(auto index)
Tests whether given index can be used to get valid (non-nullptr) Titem.
static Titem * GetIfValid(auto index)
Returns Titem with given index.
High level window description.
Definition window_gui.h:167
Data structure for an opened window.
Definition window_gui.h:273
virtual void Close(int data=0)
Hide the window and all its child windows, and mark them for a later deletion.
Definition window.cpp:1091
void DrawWidgets() const
Paint all widgets of a window.
Definition widget.cpp:777
void InitNested(WindowNumber number=0)
Perform complete initialization of the Window with nested widgets, to allow use.
Definition window.cpp:1791
WindowFlags flags
Window flags.
Definition window_gui.h:300
int width
width of the window (number of pixels to the right in x direction)
Definition window_gui.h:311
WindowNumber window_number
Window number within the window class.
Definition window_gui.h:302
Definition of Interval and OneShot timers.
Definition of the game-calendar-timer.
@ WWT_PANEL
Simple depressed panel.
Definition widget_type.h:40
void ResizeWindow(Window *w, int delta_x, int delta_y, bool clamp_to_screen, bool schedule_resize)
Resize the window.
Definition window.cpp:2067
void CloseWindowByClass(WindowClass cls, int data)
Close all windows of a given class.
Definition window.cpp:1194
void HideVitalWindows()
Close all always on-top windows to get an empty screen.
Definition window.cpp:3364
Window functions not directly related to making/drawing windows.
Functions, definitions and such used only by the GUI.
@ WhiteBorder
Window white border counter bit mask.
@ WDP_MANUAL
Manually align the window (so no automatic location finding)
Definition window_gui.h:143
int WidgetID
Widget ID.
Definition window_type.h:20
EventState
State of handling an event.
@ ES_HANDLED
The passed event is handled.
@ ES_NOT_HANDLED
The passed event is not handled.
@ WC_HIGHSCORE
Highscore; Window numbers:
@ WC_ENDSCREEN
Endscreen; Window numbers:
@ WC_NONE
No window, redirects to WC_MAIN_WINDOW.
Definition window_type.h:47
Functions related to zooming.
int ScaleSpriteTrad(int value)
Scale traditional pixel dimensions to GUI zoom level, for drawing sprites.
Definition zoom_func.h:107