cargotype.h

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/>.
 */
 
#ifndef CARGOTYPE_H
#define CARGOTYPE_H
 
#include "economy_type.h"
#include "cargo_type.h"
#include "gfx_type.h"
#include "strings_type.h"
#include "landscape_type.h"
#include "core/bitmath_func.hpp"
 
enum TownAcceptanceEffect : uint8_t {
  TAE_BEGIN = 0,
  TAE_NONE = TAE_BEGIN, 
  TAE_PASSENGERS, 
  TAE_MAIL, 
  TAE_GOODS, 
  TAE_WATER, 
  TAE_FOOD, 
  TAE_END, 
  NUM_TAE = TAE_END, 
};
 
enum TownProductionEffect : uint8_t {
  TPE_NONE, 
  TPE_PASSENGERS, 
  TPE_MAIL, 
  NUM_TPE,
 
  INVALID_TPE,
};
 
enum CargoClass : uint16_t {
  CC_NOAVAILABLE  = 0,       
  CC_PASSENGERS   = 1 <<  0, 
  CC_MAIL         = 1 <<  1, 
  CC_EXPRESS      = 1 <<  2, 
  CC_ARMOURED     = 1 <<  3, 
  CC_BULK         = 1 <<  4, 
  CC_PIECE_GOODS  = 1 <<  5, 
  CC_LIQUID       = 1 <<  6, 
  CC_REFRIGERATED = 1 <<  7, 
  CC_HAZARDOUS    = 1 <<  8, 
  CC_COVERED      = 1 <<  9, 
  CC_OVERSIZED    = 1 << 10, 
  CC_POWDERIZED   = 1 << 11, 
  CC_NOT_POURABLE = 1 << 12, 
  CC_POTABLE      = 1 << 13, 
  CC_NON_POTABLE  = 1 << 14, 
  CC_SPECIAL      = 1 << 15, 
};
 
using CargoClasses = uint16_t;
 
static const uint8_t INVALID_CARGO_BITNUM = 0xFF; 
 
static const uint TOWN_PRODUCTION_DIVISOR = 256;
 
struct CargoSpec {
  CargoLabel label;                
  uint8_t bitnum = INVALID_CARGO_BITNUM; 
  uint8_t legend_colour;
  uint8_t rating_colour;
  uint8_t weight;                    
  uint16_t multiplier = 0x100; 
  CargoClasses classes; 
  int32_t initial_payment;           
  uint8_t transit_periods[2];
 
  bool is_freight;                 
  TownAcceptanceEffect town_acceptance_effect; 
  TownProductionEffect town_production_effect = INVALID_TPE; 
  uint16_t town_production_multiplier = TOWN_PRODUCTION_DIVISOR; 
  uint8_t callback_mask;             
 
  StringID name;                   
  StringID name_single;            
  StringID units_volume;           
  StringID quantifier;             
  StringID abbrev;                 
 
  SpriteID sprite;                 
 
  const struct GRFFile *grffile;   
  const struct SpriteGroup *group;
 
  Money current_payment;
 
  inline CargoID Index() const
  {
    return this - CargoSpec::array;
  }
 
  inline bool IsValid() const
  {
    return this->bitnum != INVALID_CARGO_BITNUM;
  }
 
  static inline size_t GetArraySize()
  {
    return lengthof(CargoSpec::array);
  }
 
  static inline CargoSpec *Get(size_t index)
  {
    assert(index < lengthof(CargoSpec::array));
    return &CargoSpec::array[index];
  }
 
  SpriteID GetCargoIcon() const;
 
  inline uint64_t WeightOfNUnits(uint32_t n) const
  {
    return n * this->weight / 16u;
  }
 
  uint64_t WeightOfNUnitsInTrain(uint32_t n) const;
 
  struct Iterator {
    typedef CargoSpec value_type;
    typedef CargoSpec *pointer;
    typedef CargoSpec &reference;
    typedef size_t difference_type;
    typedef std::forward_iterator_tag iterator_category;
 
    explicit Iterator(size_t index) : index(index)
    {
      this->ValidateIndex();
    };
 
    bool operator==(const Iterator &other) const { return this->index == other.index; }
    bool operator!=(const Iterator &other) const { return !(*this == other); }
    CargoSpec * operator*() const { return CargoSpec::Get(this->index); }
    Iterator & operator++() { this->index++; this->ValidateIndex(); return *this; }
 
  private:
    size_t index;
    void ValidateIndex() { while (this->index < CargoSpec::GetArraySize() && !(CargoSpec::Get(this->index)->IsValid())) this->index++; }
  };
 
  /*
   * Iterable ensemble of all valid CargoSpec
   */
  struct IterateWrapper {
    size_t from;
    IterateWrapper(size_t from = 0) : from(from) {}
    Iterator begin() { return Iterator(this->from); }
    Iterator end() { return Iterator(CargoSpec::GetArraySize()); }
    bool empty() { return this->begin() == this->end(); }
  };
 
  static IterateWrapper Iterate(size_t from = 0) { return IterateWrapper(from); }
 
  static std::array<std::vector<const CargoSpec *>, NUM_TPE> town_production_cargoes;
 
private:
  static CargoSpec array[NUM_CARGO]; 
  static inline std::map<CargoLabel, CargoID> label_map{}; 
 
  friend void SetupCargoForClimate(LandscapeID l);
  friend void BuildCargoLabelMap();
  friend inline CargoID GetCargoIDByLabel(CargoLabel ct);
  friend void FinaliseCargoArray();
};
 
extern CargoTypes _cargo_mask;
extern CargoTypes _standard_cargo_mask;
 
void SetupCargoForClimate(LandscapeID l);
bool IsDefaultCargo(CargoID cid);
void BuildCargoLabelMap();
 
std::optional<std::string> BuildCargoAcceptanceString(const CargoArray &acceptance, StringID label);
 
inline CargoID GetCargoIDByLabel(CargoLabel label)
{
  auto found = CargoSpec::label_map.find(label);
  if (found != std::end(CargoSpec::label_map)) return found->second;
  return INVALID_CARGO;
}
 
Dimension GetLargestCargoIconSize();
 
void InitializeSortedCargoSpecs();
extern std::array<uint8_t, NUM_CARGO> _sorted_cargo_types;
extern std::vector<const CargoSpec *> _sorted_cargo_specs;
extern std::span<const CargoSpec *> _sorted_standard_cargo_specs;
 
inline bool IsCargoInClass(CargoID c, CargoClass cc)
{
  return (CargoSpec::Get(c)->classes & cc) != 0;
}
 
using SetCargoBitIterator = SetBitIterator<CargoID, CargoTypes>;
 
struct CargoIDComparator {
  bool operator() (const CargoID &lhs, const CargoID &rhs) const { return _sorted_cargo_types[lhs] < _sorted_cargo_types[rhs]; }
};
 
#endif /* CARGOTYPE_H */