OpenTTD Source  20241121-master-g67a0fccfad
cargotype.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 "cargotype.h"
12 #include "core/geometry_func.hpp"
13 #include "newgrf_cargo.h"
14 #include "string_func.h"
15 #include "strings_func.h"
16 #include "settings_type.h"
17 
18 #include "table/sprites.h"
19 #include "table/strings.h"
20 #include "table/cargo_const.h"
21 
22 #include "safeguards.h"
23 
25 std::array<std::vector<const CargoSpec *>, NUM_TPE> CargoSpec::town_production_cargoes{};
26 
31 CargoTypes _cargo_mask;
32 
37 
42 static std::vector<CargoLabel> _default_cargo_labels;
43 
49 static std::array<CargoLabel, 12> _v7_cargo_labels;
50 
56 static std::array<CargoLabel, 32> _v8_cargo_labels;
57 
63 {
64  assert(l < lengthof(_default_climate_cargo));
65 
66  _cargo_mask = 0;
67  _default_cargo_labels.clear();
70 
71  /* Copy from default cargo by label or index. */
72  auto insert = std::begin(CargoSpec::array);
73  for (const auto &cl : _default_climate_cargo[l]) {
74 
75  struct visitor {
76  const CargoSpec &operator()(const int &index)
77  {
78  /* Copy the default cargo by index. */
79  return _default_cargo[index];
80  }
81  const CargoSpec &operator()(const CargoLabel &label)
82  {
83  /* Search for label in default cargo types and copy if found. */
84  auto found = std::ranges::find(_default_cargo, label, &CargoSpec::label);
85  if (found != std::end(_default_cargo)) return *found;
86 
87  /* Index or label is invalid, this should not happen. */
88  NOT_REACHED();
89  }
90  };
91 
92  *insert = std::visit(visitor{}, cl);
93 
94  if (insert->IsValid()) {
95  SetBit(_cargo_mask, insert->Index());
96  _default_cargo_labels.push_back(insert->label);
97  _v7_cargo_labels[insert->Index()] = insert->label;
98  _v8_cargo_labels[insert->bitnum] = insert->label;
99  }
100  ++insert;
101  }
102 
103  /* Reset and disable remaining cargo types. */
104  std::fill(insert, std::end(CargoSpec::array), CargoSpec{});
105 
107 }
108 
114 std::span<const CargoLabel> GetDefaultCargoTranslationTable(uint8_t grf_version)
115 {
116  if (grf_version < 8) return _v7_cargo_labels;
117  return _v8_cargo_labels;
118 }
119 
126 {
127  CargoSpec::label_map.clear();
128  for (const CargoSpec &cs : CargoSpec::array) {
129  /* During initialization, CargoSpec can be marked valid before the label has been set. */
130  if (!cs.IsValid() || cs.label == CargoLabel{0} || cs.label == CT_INVALID) continue;
131  /* Label already exists, don't addd again. */
132  if (CargoSpec::label_map.count(cs.label) != 0) continue;
133 
134  CargoSpec::label_map.emplace(cs.label, cs.Index());
135  }
136 }
137 
144 {
145  auto cs = CargoSpec::Get(cid);
146  if (!cs->IsValid()) return false;
147 
148  CargoLabel label = cs->label;
149  return std::any_of(std::begin(_default_cargo_labels), std::end(_default_cargo_labels), [&label](const CargoLabel &cl) { return cl == label; });
150 }
151 
157 {
158  Dimension size = {0, 0};
159  for (const CargoSpec *cs : _sorted_cargo_specs) {
160  size = maxdim(size, GetSpriteSize(cs->GetCargoIcon()));
161  }
162  return size;
163 }
164 
170 {
171  SpriteID sprite = this->sprite;
172  if (sprite == 0xFFFF) {
173  /* A value of 0xFFFF indicates we should draw a custom icon */
175  }
176 
177  if (sprite == 0) sprite = SPR_CARGO_GOODS;
178 
179  return sprite;
180 }
181 
182 std::array<uint8_t, NUM_CARGO> _sorted_cargo_types;
183 std::vector<const CargoSpec *> _sorted_cargo_specs;
184 std::span<const CargoSpec *> _sorted_standard_cargo_specs;
185 
187 static bool CargoSpecNameSorter(const CargoSpec * const &a, const CargoSpec * const &b)
188 {
189  std::string a_name = GetString(a->name);
190  std::string b_name = GetString(b->name);
191 
192  int res = StrNaturalCompare(a_name, b_name); // Sort by name (natural sorting).
193 
194  /* If the names are equal, sort by cargo bitnum. */
195  return (res != 0) ? res < 0 : (a->bitnum < b->bitnum);
196 }
197 
199 static bool CargoSpecClassSorter(const CargoSpec * const &a, const CargoSpec * const &b)
200 {
201  int res = (b->classes & CC_PASSENGERS) - (a->classes & CC_PASSENGERS);
202  if (res == 0) {
203  res = (b->classes & CC_MAIL) - (a->classes & CC_MAIL);
204  if (res == 0) {
205  res = (a->classes & CC_SPECIAL) - (b->classes & CC_SPECIAL);
206  if (res == 0) {
207  return CargoSpecNameSorter(a, b);
208  }
209  }
210  }
211 
212  return res < 0;
213 }
214 
217 {
218  for (auto &tpc : CargoSpec::town_production_cargoes) tpc.clear();
219  _sorted_cargo_specs.clear();
220  /* Add each cargo spec to the list, and determine the largest cargo icon size. */
221  for (const CargoSpec *cargo : CargoSpec::Iterate()) {
222  _sorted_cargo_specs.push_back(cargo);
223  }
224 
225  /* Sort cargo specifications by cargo class and name. */
227 
228  /* Populate */
229  for (auto it = std::begin(_sorted_cargo_specs); it != std::end(_sorted_cargo_specs); ++it) {
230  _sorted_cargo_types[(*it)->Index()] = static_cast<uint8_t>(it - std::begin(_sorted_cargo_specs));
231  }
232 
233  /* Count the number of standard cargos and fill the mask. */
235  uint8_t nb_standard_cargo = 0;
236  for (const auto &cargo : _sorted_cargo_specs) {
237  assert(cargo->town_production_effect != INVALID_TPE);
238  CargoSpec::town_production_cargoes[cargo->town_production_effect].push_back(cargo);
239  if (cargo->classes & CC_SPECIAL) break;
240  nb_standard_cargo++;
241  SetBit(_standard_cargo_mask, cargo->Index());
242  }
243 
244  /* _sorted_standard_cargo_specs is a subset of _sorted_cargo_specs. */
245  _sorted_standard_cargo_specs = { _sorted_cargo_specs.data(), nb_standard_cargo };
246 }
247 
248 uint64_t CargoSpec::WeightOfNUnitsInTrain(uint32_t n) const
249 {
251  return this->WeightOfNUnits(n);
252 }
constexpr T SetBit(T &x, const uint8_t y)
Set a bit in a variable.
Table of all default cargo types.
static const CargoSpec _default_cargo[]
Cargo types available by default.
Definition: cargo_const.h:52
static const std::variant< CargoLabel, int > _default_climate_cargo[NUM_LANDSCAPE][NUM_ORIGINAL_CARGO]
Table of cargo types available in each climate, by default.
Definition: cargo_const.h:99
static constexpr CargoLabel CT_INVALID
Invalid cargo type.
Definition: cargo_type.h:71
uint8_t CargoID
Cargo slots to indicate a cargo type within a game.
Definition: cargo_type.h:22
static const CargoID NUM_CARGO
Maximum number of cargo types in a game.
Definition: cargo_type.h:74
bool IsDefaultCargo(CargoID cid)
Test if a cargo is a default cargo type.
Definition: cargotype.cpp:143
static std::vector< CargoLabel > _default_cargo_labels
List of default cargo labels, used when setting up cargo types for default vehicles.
Definition: cargotype.cpp:42
std::array< uint8_t, NUM_CARGO > _sorted_cargo_types
Sort order of cargoes by cargo ID.
Definition: cargotype.cpp:182
static bool CargoSpecClassSorter(const CargoSpec *const &a, const CargoSpec *const &b)
Sort cargo specifications by their cargo class.
Definition: cargotype.cpp:199
Dimension GetLargestCargoIconSize()
Get dimensions of largest cargo icon.
Definition: cargotype.cpp:156
std::span< const CargoLabel > GetDefaultCargoTranslationTable(uint8_t grf_version)
Get default cargo translation table for a NewGRF, used if the NewGRF does not provide its own.
Definition: cargotype.cpp:114
std::span< const CargoSpec * > _sorted_standard_cargo_specs
Standard cargo specifications sorted alphabetically by name.
Definition: cargotype.cpp:184
CargoTypes _standard_cargo_mask
Bitmask of real cargo types available.
Definition: cargotype.cpp:36
void BuildCargoLabelMap()
Build cargo label map.
Definition: cargotype.cpp:125
static std::array< CargoLabel, 32 > _v8_cargo_labels
Default cargo translation for version 8+ NewGRFs.
Definition: cargotype.cpp:56
std::vector< const CargoSpec * > _sorted_cargo_specs
Cargo specifications sorted alphabetically by name.
Definition: cargotype.cpp:183
static bool CargoSpecNameSorter(const CargoSpec *const &a, const CargoSpec *const &b)
Sort cargo specifications by their name.
Definition: cargotype.cpp:187
void InitializeSortedCargoSpecs()
Initialize the list of sorted cargo specifications.
Definition: cargotype.cpp:216
void SetupCargoForClimate(LandscapeID l)
Set up the default cargo types for the given landscape type.
Definition: cargotype.cpp:62
static std::array< CargoLabel, 12 > _v7_cargo_labels
Default cargo translation for upto version 7 NewGRFs.
Definition: cargotype.cpp:49
CargoTypes _cargo_mask
Bitmask of cargo types available.
Definition: cargotype.cpp:31
Types/functions related to cargoes.
@ CC_MAIL
Mail.
Definition: cargotype.h:51
@ CC_PASSENGERS
Passengers.
Definition: cargotype.h:50
@ CC_SPECIAL
Special bit used for livery refit tricks instead of normal cargoes.
Definition: cargotype.h:60
@ INVALID_TPE
Invalid town production effect.
Definition: cargotype.h:44
Dimension maxdim(const Dimension &d1, const Dimension &d2)
Compute bounding box of both dimensions.
Geometry functions.
Dimension GetSpriteSize(SpriteID sprid, Point *offset, ZoomLevel zoom)
Get the size of a sprite.
Definition: gfx.cpp:922
uint32_t SpriteID
The number of a sprite, without mapping bits and colourtables.
Definition: gfx_type.h:18
uint8_t LandscapeID
Landscape type.
SpriteID GetCustomCargoSprite(const CargoSpec *cs)
Get the custom sprite for the given cargo type.
Cargo support for NewGRFs.
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:57
Types related to global configuration settings.
This file contains all sprite-related enums and defines.
Definition of base types and functions in a cross-platform compatible way.
#define lengthof(array)
Return the length of an fixed size array.
Definition: stdafx.h:280
int StrNaturalCompare(std::string_view s1, std::string_view s2, bool ignore_garbage_at_front)
Compares two strings using case insensitive natural sort.
Definition: string.cpp:589
Functions related to low-level strings.
std::string GetString(StringID string)
Resolve the given StringID into a std::string with all the associated DParam lookups and formatting.
Definition: strings.cpp:319
Functions related to OTTD's strings.
Specification of a cargo type.
Definition: cargotype.h:71
CargoClasses classes
Classes of this cargo type.
Definition: cargotype.h:78
uint8_t bitnum
Cargo bit number, is INVALID_CARGO_BITNUM for a non-used spec.
Definition: cargotype.h:73
SpriteID GetCargoIcon() const
Get sprite for showing cargo of this type.
Definition: cargotype.cpp:169
SpriteID sprite
Icon to display this cargo type, may be 0xFFF (which means to resolve an action123 chain).
Definition: cargotype.h:94
bool is_freight
Cargo type is considered to be freight (affects train freight multiplier).
Definition: cargotype.h:82
CargoLabel label
Unique label of the cargo type.
Definition: cargotype.h:72
static IterateWrapper Iterate(size_t from=0)
Returns an iterable ensemble of all valid CargoSpec.
Definition: cargotype.h:190
static CargoSpec array[NUM_CARGO]
Array holding all CargoSpecs.
Definition: cargotype.h:196
static CargoSpec * Get(size_t index)
Retrieve cargo details for the given cargo ID.
Definition: cargotype.h:134
StringID name
Name of this type of cargo.
Definition: cargotype.h:88
static std::map< CargoLabel, CargoID > label_map
Translation map from CargoLabel to Cargo ID.
Definition: cargotype.h:197
static std::array< std::vector< const CargoSpec * >, NUM_TPE > town_production_cargoes
List of cargo specs for each Town Product Effect.
Definition: cargotype.h:193
Dimensions (a width and height) of a rectangle in 2D.
VehicleSettings vehicle
options for vehicles
uint8_t freight_trains
value to multiply the weight of cargo by