Files
@ r13060:e57594b0ca84
Branch filter:
Location: cpp/openttd-patchpack/source/src/engine_gui.cpp - annotation
r13060:e57594b0ca84
9.4 KiB
text/x-c
(svn r17570) -Fix: a number of Doxygen warnings about missing parameters, which were sometimes missing and sometimes just typos
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 | r5584:545d748cc681 r5584:545d748cc681 r12768:980ae0491352 r12768:980ae0491352 r12768:980ae0491352 r12768:980ae0491352 r12768:980ae0491352 r12768:980ae0491352 r12768:980ae0491352 r9111:983de9c5a848 r6125:eb40461cb765 r5584:545d748cc681 r8107:82461791b7a2 r8224:194097dc7288 r8786:f24a6d1fba34 r9070:e059c65164f3 r8116:df67d3c5e4fd r10960:e97ebf9cf99b r5584:545d748cc681 r8114:866ed489ed98 r9380:6b24883f64de r9567:b3592d86e408 r12037:7b4fedf64d47 r12037:7b4fedf64d47 r10000:91824eb4383b r13022:11b36960dd16 r5584:545d748cc681 r8264:d493cb51fe8a r8264:d493cb51fe8a r5584:545d748cc681 r12827:19af93950884 r12827:19af93950884 r12827:19af93950884 r12827:19af93950884 r9199:7d9724de3af0 r5584:545d748cc681 r11917:612c11f7ab47 r6209:f315c4c30b43 r11725:57bc99fdc1bc r11725:57bc99fdc1bc r11725:57bc99fdc1bc r6259:e2dba394134b r10000:91824eb4383b r5584:545d748cc681 r5584:545d748cc681 r5584:545d748cc681 r11423:97fd1230114c r11423:97fd1230114c r11423:97fd1230114c r11423:97fd1230114c r11423:97fd1230114c r11423:97fd1230114c r11423:97fd1230114c r11423:97fd1230114c r11423:97fd1230114c r5584:545d748cc681 r11725:57bc99fdc1bc r11725:57bc99fdc1bc r11725:57bc99fdc1bc r12622:202e83a6cee7 r12622:202e83a6cee7 r5584:545d748cc681 r5584:545d748cc681 r5584:545d748cc681 r11512:4e2f95d920fb r11512:4e2f95d920fb r11512:4e2f95d920fb r11725:57bc99fdc1bc r11512:4e2f95d920fb r11512:4e2f95d920fb r11512:4e2f95d920fb r11512:4e2f95d920fb r12622:202e83a6cee7 r12622:202e83a6cee7 r11512:4e2f95d920fb r11512:4e2f95d920fb r11512:4e2f95d920fb r11512:4e2f95d920fb r11512:4e2f95d920fb r9302:115cfeb49cd5 r9302:115cfeb49cd5 r9302:115cfeb49cd5 r9333:a36e9b553bc9 r9302:115cfeb49cd5 r5584:545d748cc681 r9302:115cfeb49cd5 r9302:115cfeb49cd5 r9302:115cfeb49cd5 r5584:545d748cc681 r9302:115cfeb49cd5 r5584:545d748cc681 r11761:eae452e003af r5584:545d748cc681 r7059:0c2dc932a6ae r11427:99c6f58948e0 r5584:545d748cc681 r9302:115cfeb49cd5 r12825:b76c82800d1a r12828:1411e13c41d0 r5584:545d748cc681 r5584:545d748cc681 r9302:115cfeb49cd5 r9302:115cfeb49cd5 r9302:115cfeb49cd5 r11423:97fd1230114c r10499:570896340d7a r5584:545d748cc681 r11423:97fd1230114c r9302:115cfeb49cd5 r5584:545d748cc681 r5584:545d748cc681 r5584:545d748cc681 r9302:115cfeb49cd5 r5584:545d748cc681 r11368:058349c3a02c r7341:72820788b006 r5893:6c4fd9987e0f r10998:94dcb82c0e64 r11512:4e2f95d920fb r11368:058349c3a02c r5584:545d748cc681 r5584:545d748cc681 r5584:545d748cc681 r5584:545d748cc681 r9302:115cfeb49cd5 r5584:545d748cc681 r5584:545d748cc681 r11311:c4de431f8676 r9567:b3592d86e408 r9567:b3592d86e408 r9567:b3592d86e408 r12254:2375853718ac r12254:2375853718ac r9567:b3592d86e408 r9567:b3592d86e408 r9567:b3592d86e408 r9567:b3592d86e408 r9567:b3592d86e408 r9567:b3592d86e408 r12828:1411e13c41d0 r5584:545d748cc681 r10927:eb69eaf0227d r10967:2c98940d6c64 r10967:2c98940d6c64 r10967:2c98940d6c64 r5584:545d748cc681 r10927:eb69eaf0227d r5584:545d748cc681 r12828:1411e13c41d0 r9567:b3592d86e408 r11188:143f3c64befd r9720:6d491d07d0a8 r5584:545d748cc681 r5584:545d748cc681 r5584:545d748cc681 r12828:1411e13c41d0 r5584:545d748cc681 r5584:545d748cc681 r12828:1411e13c41d0 r5584:545d748cc681 r11350:df593340eca2 r11350:df593340eca2 r11350:df593340eca2 r11350:df593340eca2 r11350:df593340eca2 r11712:c05ce4b83dd6 r11712:c05ce4b83dd6 r11712:c05ce4b83dd6 r11712:c05ce4b83dd6 r11712:c05ce4b83dd6 r12828:1411e13c41d0 r11350:df593340eca2 r11350:df593340eca2 r11350:df593340eca2 r11350:df593340eca2 r11403:ba31da6812eb r11350:df593340eca2 r12828:1411e13c41d0 r11350:df593340eca2 r5584:545d748cc681 r5584:545d748cc681 r12828:1411e13c41d0 r5584:545d748cc681 r10927:eb69eaf0227d r10967:2c98940d6c64 r12828:1411e13c41d0 r11188:143f3c64befd r11709:0908d1040b1c r11709:0908d1040b1c r11188:143f3c64befd r11709:0908d1040b1c r11188:143f3c64befd r11709:0908d1040b1c r12828:1411e13c41d0 r5584:545d748cc681 r5584:545d748cc681 r12828:1411e13c41d0 r5584:545d748cc681 r10927:eb69eaf0227d r10967:2c98940d6c64 r11188:143f3c64befd r11403:ba31da6812eb r10927:eb69eaf0227d r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r12828:1411e13c41d0 r5584:545d748cc681 r5584:545d748cc681 r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r13060:e57594b0ca84 r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r12825:b76c82800d1a r13022:11b36960dd16 r9380:6b24883f64de r9380:6b24883f64de r9380:6b24883f64de r9403:e5bffa930a63 r9380:6b24883f64de r9403:e5bffa930a63 r9380:6b24883f64de r9380:6b24883f64de r9380:6b24883f64de r13022:11b36960dd16 r9380:6b24883f64de r9380:6b24883f64de r9380:6b24883f64de r9380:6b24883f64de r9380:6b24883f64de r9380:6b24883f64de r9380:6b24883f64de r9380:6b24883f64de r9403:e5bffa930a63 r9380:6b24883f64de r9404:f74e13f5c66e r9403:e5bffa930a63 r9403:e5bffa930a63 r13022:11b36960dd16 r9380:6b24883f64de r9380:6b24883f64de | /* $Id$ */
/*
* 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/>.
*/
/** @file engine_gui.cpp GUI to show engine related information. */
#include "stdafx.h"
#include "window_gui.h"
#include "gfx_func.h"
#include "engine_func.h"
#include "engine_base.h"
#include "command_func.h"
#include "news_type.h"
#include "newgrf_engine.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 "core/sort_func.hpp"
#include "table/strings.h"
#include "table/sprites.h"
/** Return the category of an engine.
* @param engine Engine to examine.
* @return String describing the category ("road veh", "train". "airplane", or "ship") of the engine.
*/
StringID GetEngineCategoryName(EngineID engine)
{
switch (Engine::Get(engine)->type) {
default: NOT_REACHED();
case VEH_ROAD: return STR_ENGINE_PREVIEW_ROAD_VEHICLE;
case VEH_AIRCRAFT: return STR_ENGINE_PREVIEW_AIRCRAFT;
case VEH_SHIP: return STR_ENGINE_PREVIEW_SHIP;
case VEH_TRAIN:
return GetRailTypeInfo(RailVehInfo(engine)->railtype)->strings.new_loco;
}
}
/** Widgets used for the engine preview window */
enum EnginePreviewWidgets {
EPW_CLOSE, ///< Close button
EPW_CAPTION, ///< Title bar/caption
EPW_BACKGROUND, ///< Background
EPW_NO, ///< No button
EPW_YES, ///< Yes button
};
static const Widget _engine_preview_widgets[] = {
{ WWT_CLOSEBOX, RESIZE_NONE, COLOUR_LIGHT_BLUE, 0, 10, 0, 13, STR_BLACK_CROSS, STR_TOOLTIP_CLOSE_WINDOW}, // EPW_CLOSE
{ WWT_CAPTION, RESIZE_NONE, COLOUR_LIGHT_BLUE, 11, 299, 0, 13, STR_ENGINE_PREVIEW_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS}, // EPW_CAPTION
{ WWT_PANEL, RESIZE_NONE, COLOUR_LIGHT_BLUE, 0, 299, 14, 191, 0x0, STR_NULL}, // EPW_BACKGROUND
{ WWT_PUSHTXTBTN, RESIZE_NONE, COLOUR_LIGHT_BLUE, 85, 144, 172, 183, STR_QUIT_NO, STR_NULL}, // EPW_NO
{ WWT_PUSHTXTBTN, RESIZE_NONE, COLOUR_LIGHT_BLUE, 155, 214, 172, 183, STR_QUIT_YES, STR_NULL}, // EPW_YES
{ WIDGETS_END},
};
static const NWidgetPart _nested_engine_preview_widgets[] = {
NWidget(NWID_HORIZONTAL),
NWidget(WWT_CLOSEBOX, COLOUR_LIGHT_BLUE, EPW_CLOSE),
NWidget(WWT_CAPTION, COLOUR_LIGHT_BLUE, EPW_CAPTION), SetDataTip(STR_ENGINE_PREVIEW_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
EndContainer(),
NWidget(WWT_PANEL, COLOUR_LIGHT_BLUE, EPW_BACKGROUND),
NWidget(NWID_SPACER), SetMinimalSize(0, 158),
NWidget(NWID_HORIZONTAL), SetPIP(85, 10, 85),
NWidget(WWT_PUSHTXTBTN, COLOUR_LIGHT_BLUE, EPW_NO), SetMinimalSize(60, 12), SetDataTip(STR_QUIT_NO, STR_NULL),
NWidget(WWT_PUSHTXTBTN, COLOUR_LIGHT_BLUE, EPW_YES), SetMinimalSize(60, 12), SetDataTip(STR_QUIT_YES, STR_NULL),
EndContainer(),
NWidget(NWID_SPACER), SetMinimalSize(0, 8),
EndContainer(),
};
struct EnginePreviewWindow : Window {
EnginePreviewWindow(const WindowDesc *desc, WindowNumber window_number) : Window(desc, window_number)
{
this->FindWindowPlacementAndResize(desc);
}
virtual void OnPaint()
{
this->DrawWidgets();
EngineID engine = this->window_number;
SetDParam(0, GetEngineCategoryName(engine));
DrawStringMultiLine(this->widget[EPW_BACKGROUND].left + 2, this->widget[EPW_BACKGROUND].right - 2, 18, 80, STR_ENGINE_PREVIEW_MESSAGE, TC_FROMSTRING, SA_CENTER);
SetDParam(0, engine);
DrawString(this->widget[EPW_BACKGROUND].left + 2, this->widget[EPW_BACKGROUND].right - 2, 80, STR_ENGINE_NAME, TC_BLACK, SA_CENTER);
int width = this->width;
DrawVehicleEngine(width >> 1, 100, engine, GetEnginePalette(engine, _local_company));
DrawStringMultiLine(this->widget[EPW_BACKGROUND].left + 26, this->widget[EPW_BACKGROUND].right - 26, 100, 170, GetEngineInfoString(engine), TC_FROMSTRING, SA_CENTER);
}
virtual void OnClick(Point pt, int widget)
{
switch (widget) {
case EPW_YES:
DoCommandP(0, this->window_number, 0, CMD_WANT_ENGINE_PREVIEW);
/* Fallthrough */
case EPW_NO:
delete this;
break;
}
}
};
static const WindowDesc _engine_preview_desc(
WDP_CENTER, WDP_CENTER, 300, 192, 300, 192,
WC_ENGINE_PREVIEW, WC_NONE,
WDF_STD_TOOLTIPS | WDF_STD_BTN | WDF_DEF_WIDGET | WDF_CONSTRUCTION,
_engine_preview_widgets, _nested_engine_preview_widgets, lengthof(_nested_engine_preview_widgets)
);
void ShowEnginePreviewWindow(EngineID engine)
{
AllocateWindowDescFront<EnginePreviewWindow>(&_engine_preview_desc, engine);
}
uint GetTotalCapacityOfArticulatedParts(EngineID engine, VehicleType type)
{
uint total = 0;
CargoArray cap = GetCapacityOfArticulatedParts(engine, type);
for (CargoID c = 0; c < NUM_CARGO; c++) {
total += cap[c];
}
return total;
}
static StringID GetTrainEngineInfoString(const Engine *e)
{
SetDParam(0, e->GetCost());
SetDParam(2, e->GetDisplayMaxSpeed());
SetDParam(3, e->GetPower());
SetDParam(1, e->GetDisplayWeight());
SetDParam(4, e->GetRunningCost());
uint capacity = GetTotalCapacityOfArticulatedParts(e->index, VEH_TRAIN);
if (capacity != 0) {
SetDParam(5, e->GetDefaultCargoType());
SetDParam(6, capacity);
} else {
SetDParam(5, CT_INVALID);
}
return STR_ENGINE_PREVIEW_COST_WEIGHT_SPEED_POWER;
}
static StringID GetAircraftEngineInfoString(const Engine *e)
{
CargoID cargo = e->GetDefaultCargoType();
if (cargo == CT_INVALID || cargo == CT_PASSENGERS) {
SetDParam(0, e->GetCost());
SetDParam(1, e->GetDisplayMaxSpeed());
SetDParam(2, CT_PASSENGERS),
SetDParam(3, e->GetDisplayDefaultCapacity());
SetDParam(4, CT_MAIL),
SetDParam(5, e->u.air.mail_capacity);
SetDParam(6, e->GetRunningCost());
return STR_ENGINE_PREVIEW_COST_MAX_SPEED_CAPACITY_CAPACITY_RUNCOST;
} else {
SetDParam(0, e->GetCost());
SetDParam(1, e->GetDisplayMaxSpeed());
SetDParam(2, cargo);
SetDParam(3, e->GetDisplayDefaultCapacity());
SetDParam(4, e->GetRunningCost());
return STR_ENGINE_PREVIEW_COST_MAX_SPEED_CAPACITY_RUNCOST;
}
}
static StringID GetRoadVehEngineInfoString(const Engine *e)
{
SetDParam(0, e->GetCost());
SetDParam(1, e->GetDisplayMaxSpeed());
uint capacity = GetTotalCapacityOfArticulatedParts(e->index, VEH_ROAD);
if (capacity != 0) {
SetDParam(2, e->GetDefaultCargoType());
SetDParam(3, capacity);
} else {
SetDParam(2, CT_INVALID);
}
SetDParam(4, e->GetRunningCost());
return STR_ENGINE_PREVIEW_COST_MAX_SPEED_CAPACITY_RUNCOST;
}
static StringID GetShipEngineInfoString(const Engine *e)
{
SetDParam(0, e->GetCost());
SetDParam(1, e->GetDisplayMaxSpeed());
SetDParam(2, e->GetDefaultCargoType());
SetDParam(3, e->GetDisplayDefaultCapacity());
SetDParam(4, e->GetRunningCost());
return STR_ENGINE_PREVIEW_COST_MAX_SPEED_CAPACITY_RUNCOST;
}
/**
* Get a multi-line string with some technical data, describing the engine.
* @param engine Engine to describe.
* @return String describing the engine.
* @post \c DParam array is set up for printing the string.
*/
StringID 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();
}
}
/**
* Draw an engine.
* @param x Horizontal position to use for drawing the engine.
* @param y Vertical position to use for drawing the engine.
* @param engine Engine to draw.
* @param pal Palette to use for drawing.
*/
void DrawVehicleEngine(int x, int y, EngineID engine, SpriteID pal)
{
const Engine *e = Engine::Get(engine);
switch (e->type) {
case VEH_TRAIN:
DrawTrainEngine(x, y, engine, pal);
break;
case VEH_ROAD:
DrawRoadVehEngine(x, y, engine, pal);
break;
case VEH_SHIP:
DrawShipEngine(x, y, engine, pal);
break;
case VEH_AIRCRAFT:
DrawAircraftEngine(x, y, engine, pal);
break;
default: NOT_REACHED();
}
}
/** Sort all items using quick sort and given 'CompareItems' function
* @param el list to be sorted
* @param compare function for evaluation of the quicksort
*/
void EngList_Sort(GUIEngineList *el, EngList_SortTypeFunction compare)
{
uint size = el->Length();
/* out-of-bounds access at the next line for size == 0 (even with operator[] at some systems)
* generally, do not sort if there are less than 2 items */
if (size < 2) return;
QSortT(el->Begin(), size, compare);
}
/** Sort selected range of items (on indices @ <begin, begin+num_items-1>)
* @param el list to be sorted
* @param compare function for evaluation of the quicksort
* @param begin start of sorting
* @param num_items count of items to be sorted
*/
void EngList_SortPartial(GUIEngineList *el, EngList_SortTypeFunction compare, uint begin, uint num_items)
{
if (num_items < 2) return;
assert(begin < el->Length());
assert(begin + num_items <= el->Length());
QSortT(el->Get(begin), num_items, compare);
}
|