OpenTTD Source  20241121-master-g67a0fccfad
cargomonitor.h
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 #ifndef CARGOMONITOR_H
11 #define CARGOMONITOR_H
12 
13 #include "cargo_type.h"
14 #include "company_func.h"
15 #include "industry.h"
16 #include "town.h"
18 
19 struct Station;
20 
29 typedef uint32_t CargoMonitorID;
30 
32 typedef std::map<CargoMonitorID, OverflowSafeInt32> CargoMonitorMap;
33 
36 
37 
38 /* Constants for encoding and extracting cargo monitors. */
39 constexpr uint8_t CCB_TOWN_IND_NUMBER_START = 0;
40 constexpr uint8_t CCB_TOWN_IND_NUMBER_LENGTH = 16;
41 constexpr uint8_t CCB_IS_INDUSTRY_BIT = 16;
42 constexpr uint8_t CCB_CARGO_TYPE_START = 19;
43 constexpr uint8_t CCB_CARGO_TYPE_LENGTH = 6;
44 constexpr uint8_t CCB_COMPANY_START = 25;
45 constexpr uint8_t CCB_COMPANY_LENGTH = 4;
46 
47 static_assert(NUM_CARGO <= (1 << CCB_CARGO_TYPE_LENGTH));
48 static_assert(MAX_COMPANIES <= (1 << CCB_COMPANY_LENGTH));
49 
50 
58 inline CargoMonitorID EncodeCargoIndustryMonitor(CompanyID company, CargoID ctype, IndustryID ind)
59 {
60  assert(ctype < (1 << CCB_CARGO_TYPE_LENGTH));
61  assert(company < (1 << CCB_COMPANY_LENGTH));
62 
63  uint32_t ret = 0;
67  SB(ret, CCB_COMPANY_START, CCB_COMPANY_LENGTH, company);
68  return ret;
69 }
70 
79 {
80  assert(ctype < (1 << CCB_CARGO_TYPE_LENGTH));
81  assert(company < (1 << CCB_COMPANY_LENGTH));
82 
83  uint32_t ret = 0;
86  SB(ret, CCB_COMPANY_START, CCB_COMPANY_LENGTH, company);
87  return ret;
88 }
89 
96 {
97  return static_cast<CompanyID>(GB(num, CCB_COMPANY_START, CCB_COMPANY_LENGTH));
98 }
99 
106 {
108 }
109 
116 {
117  return HasBit(num, CCB_IS_INDUSTRY_BIT);
118 }
119 
125 inline IndustryID DecodeMonitorIndustry(CargoMonitorID num)
126 {
127  if (!MonitorMonitorsIndustry(num)) return INVALID_INDUSTRY;
129 }
130 
137 {
138  if (MonitorMonitorsIndustry(num)) return INVALID_TOWN;
140 }
141 
144 int32_t GetDeliveryAmount(CargoMonitorID monitor, bool keep_monitoring);
145 int32_t GetPickupAmount(CargoMonitorID monitor, bool keep_monitoring);
146 void AddCargoDelivery(CargoID cargo_type, CompanyID company, uint32_t amount, SourceType src_type, SourceID src, const Station *st, IndustryID dest = INVALID_INDUSTRY);
147 
148 #endif /* CARGOMONITOR_H */
constexpr debug_inline bool HasBit(const T x, const uint8_t y)
Checks if a bit in a value is set.
constexpr T SB(T &x, const uint8_t s, const uint8_t n, const U d)
Set n bits in x starting at bit s to d.
constexpr T SetBit(T &x, const uint8_t y)
Set a bit in a variable.
constexpr static debug_inline uint GB(const T x, const uint8_t s, const uint8_t n)
Fetch n bits from x, started at bit s.
Types related to cargoes...
uint8_t CargoID
Cargo slots to indicate a cargo type within a game.
Definition: cargo_type.h:22
uint16_t SourceID
Contains either industry ID, town ID or company ID (or INVALID_SOURCE)
Definition: cargo_type.h:143
static const CargoID NUM_CARGO
Maximum number of cargo types in a game.
Definition: cargo_type.h:74
SourceType
Types of cargo source and destination.
Definition: cargo_type.h:137
constexpr uint8_t CCB_COMPANY_START
Start bit of the company field.
Definition: cargomonitor.h:44
CargoID DecodeMonitorCargoType(CargoMonitorID num)
Extract the cargo type from the cargo monitor.
Definition: cargomonitor.h:105
void ClearCargoDeliveryMonitoring(CompanyID company=INVALID_OWNER)
Clear all delivery cargo monitors.
void AddCargoDelivery(CargoID cargo_type, CompanyID company, uint32_t amount, SourceType src_type, SourceID src, const Station *st, IndustryID dest=INVALID_INDUSTRY)
Cargo was delivered to its final destination, update the pickup and delivery maps.
CargoMonitorID EncodeCargoTownMonitor(CompanyID company, CargoID ctype, TownID town)
Encode a cargo monitoring number for pickup or delivery at a town.
Definition: cargomonitor.h:78
constexpr uint8_t CCB_TOWN_IND_NUMBER_START
Start bit of the town or industry number.
Definition: cargomonitor.h:39
constexpr uint8_t CCB_IS_INDUSTRY_BIT
Bit indicating the town/industry number is an industry.
Definition: cargomonitor.h:41
CargoMonitorMap _cargo_deliveries
Map of monitored deliveries to the amount since last query/activation.
void ClearCargoPickupMonitoring(CompanyID company=INVALID_OWNER)
Clear all pick-up cargo monitors.
constexpr uint8_t CCB_CARGO_TYPE_LENGTH
Number of bits of the cargo type field.
Definition: cargomonitor.h:43
IndustryID DecodeMonitorIndustry(CargoMonitorID num)
Extract the industry number from the cargo monitor.
Definition: cargomonitor.h:125
bool MonitorMonitorsIndustry(CargoMonitorID num)
Does the cargo number monitor an industry or a town?
Definition: cargomonitor.h:115
uint32_t CargoMonitorID
Unique number for a company / cargo type / (town or industry).
Definition: cargomonitor.h:19
constexpr uint8_t CCB_TOWN_IND_NUMBER_LENGTH
Number of bits of the town or industry number.
Definition: cargomonitor.h:40
int32_t GetPickupAmount(CargoMonitorID monitor, bool keep_monitoring)
Get the amount of cargo picked up for the given cargo monitor since activation or last query.
int32_t GetDeliveryAmount(CargoMonitorID monitor, bool keep_monitoring)
Get the amount of cargo delivered for the given cargo monitor since activation or last query.
CargoMonitorMap _cargo_pickups
Map of monitored pick-ups to the amount since last query/activation.
CargoMonitorID EncodeCargoIndustryMonitor(CompanyID company, CargoID ctype, IndustryID ind)
Encode a cargo monitor for pickup or delivery at an industry.
Definition: cargomonitor.h:58
constexpr uint8_t CCB_CARGO_TYPE_START
Start bit of the cargo type field.
Definition: cargomonitor.h:42
std::map< CargoMonitorID, OverflowSafeInt32 > CargoMonitorMap
Map type for storing and updating active cargo monitor numbers and their amounts.
Definition: cargomonitor.h:32
CompanyID DecodeMonitorCompany(CargoMonitorID num)
Extract the company from the cargo monitor.
Definition: cargomonitor.h:95
TownID DecodeMonitorTown(CargoMonitorID num)
Extract the town number from the cargo monitor.
Definition: cargomonitor.h:136
constexpr uint8_t CCB_COMPANY_LENGTH
Number of bits of the company field.
Definition: cargomonitor.h:45
Functions related to companies.
Owner
Enum for all companies/owners.
Definition: company_type.h:18
@ INVALID_OWNER
An invalid owner.
Definition: company_type.h:29
@ MAX_COMPANIES
Maximum number of companies.
Definition: company_type.h:23
Base of all industries.
An overflow safe integer-like type.
Town * town
The town this station is associated with.
Station data structure.
Definition: station_base.h:439
Base of the town class.