OpenTTD Source  20240919-master-gdf0233f4c2
CargoesField Struct Reference

Data about a single field in the IndustryCargoesWindow panel. More...

Public Types

using Cargoes = uint16_t
 

Public Member Functions

void MakeEmpty (CargoesFieldType type)
 Make one of the empty fields (CFT_EMPTY or CFT_SMALL_EMPTY). More...
 
void MakeIndustry (IndustryType ind_type)
 Make an industry type field. More...
 
int ConnectCargo (CargoID cargo, bool producer)
 Connect a cargo from an industry to the CFT_CARGO column. More...
 
bool HasConnection ()
 Does this CFT_CARGO field have a horizontal connection? More...
 
void MakeCargo (const std::span< const CargoID > cargoes)
 Make a piece of cargo column. More...
 
void MakeCargoLabel (const std::span< const CargoID > cargoes, bool left_align)
 Make a field displaying cargo type names. More...
 
void MakeHeader (StringID textid)
 Make a header above an industry column. More...
 
int GetCargoBase (int xpos) const
 For a CFT_CARGO, compute the left position of the left-most vertical cargo connection. More...
 
void Draw (int xpos, int ypos) const
 Draw the field. More...
 
CargoID CargoClickedAt (const CargoesField *left, const CargoesField *right, Point pt) const
 Decide which cargo was clicked at in a CFT_CARGO field. More...
 
CargoID CargoLabelClickedAt (Point pt) const
 Decide what cargo the user clicked in the cargo label field. More...
 

Data Fields

CargoesFieldType type
 Type of field.
 
union {
   struct {
      IndustryType   ind_type
 Industry type (NUM_INDUSTRYTYPES means 'houses').
 
      CargoID   other_produced [MAX_CARGOES]
 Cargoes produced but not used in this figure.
 
      CargoID   other_accepted [MAX_CARGOES]
 Cargoes accepted but not used in this figure.
 
   }   industry
 Industry data (for CFT_INDUSTRY).
 
   struct {
      CargoID   vertical_cargoes [MAX_CARGOES]
 Cargoes running from top to bottom (cargo ID or #INVALID_CARGO).
 
      Cargoes   supp_cargoes
 Cargoes in vertical_cargoes entering from the left.
 
      Cargoes   cust_cargoes
 Cargoes in vertical_cargoes leaving to the right.
 
      uint8_t   num_cargoes
 Number of cargoes.
 
      uint8_t   top_end
 Stop at the top of the vertical cargoes.
 
      uint8_t   bottom_end
 Stop at the bottom of the vertical cargoes.
 
   }   cargo
 Cargo data (for CFT_CARGO).
 
   struct {
      CargoID   cargoes [MAX_CARGOES]
 Cargoes to display (or #INVALID_CARGO).
 
      bool   left_align
 Align all cargo texts to the left (else align to the right).
 
   }   cargo_label
 Label data (for CFT_CARGO_LABEL).
 
   StringID   header
 Header text (for CFT_HEADER).
 
u
 

Static Public Attributes

static int vert_inter_industry_space
 Amount of space between two industries in a column.
 
static int blob_distance
 Distance of the industry legend colour from the edge of the industry box.
 
static Dimension legend
 Dimension of the legend blob.
 
static Dimension cargo_border
 Dimensions of border between cargo lines and industry boxes.
 
static Dimension cargo_line
 Dimensions of cargo lines.
 
static Dimension cargo_space
 Dimensions of space between cargo lines.
 
static Dimension cargo_stub
 Dimensions of cargo stub (unconnected cargo line.)
 
static const int INDUSTRY_LINE_COLOUR = PC_YELLOW
 Line colour of the industry type box.
 
static const int CARGO_LINE_COLOUR = PC_YELLOW
 Line colour around the cargo.
 
static int small_height
 Height of the header row.
 
static int normal_height
 Height of the non-header rows.
 
static int cargo_field_width
 Width of a cargo field.
 
static int industry_width
 Width of an industry field.
 
static uint max_cargoes
 Largest number of cargoes actually on any industry.
 

Static Private Member Functions

static void DrawHorConnection (int left, int right, int top, const CargoSpec *csp)
 Draw a horizontal cargo connection. More...
 

Detailed Description

Data about a single field in the IndustryCargoesWindow panel.

Definition at line 1989 of file industry_gui.cpp.

Member Function Documentation

◆ CargoClickedAt()

CargoID CargoesField::CargoClickedAt ( const CargoesField left,
const CargoesField right,
Point  pt 
) const
inline

Decide which cargo was clicked at in a CFT_CARGO field.

Parameters
leftLeft industry neighbour if available (else nullptr should be supplied).
rightRight industry neighbour if available (else nullptr should be supplied).
ptClick position in the cargo field.
Returns
Cargo clicked at, or #INVALID_CARGO if none.

Definition at line 2301 of file industry_gui.cpp.

References cargo_border, cargo_line, cargo_space, CFT_CARGO, GetCargoBase(), MAX_CARGOES, and vert_inter_industry_space.

◆ CargoLabelClickedAt()

CargoID CargoesField::CargoLabelClickedAt ( Point  pt) const
inline

Decide what cargo the user clicked in the cargo label field.

Parameters
ptClick position in the cargo label field.
Returns
Cargo clicked at, or #INVALID_CARGO if none.

Definition at line 2359 of file industry_gui.cpp.

References cargo_border, CFT_CARGO_LABEL, MAX_CARGOES, and vert_inter_industry_space.

◆ ConnectCargo()

int CargoesField::ConnectCargo ( CargoID  cargo,
bool  producer 
)
inline

Connect a cargo from an industry to the CFT_CARGO column.

Parameters
cargoCargo to connect.
producerCargo is produced (if false, cargo is assumed to be accepted).
Returns
Horizontal connection index, or -1 if not accepted at all.

Definition at line 2060 of file industry_gui.cpp.

References cargo, CFT_CARGO, HasBit(), IsValidCargoID(), and SetBit().

◆ Draw()

void CargoesField::Draw ( int  xpos,
int  ypos 
) const
inline

Draw the field.

Parameters
xposPosition of the left edge.
yposPosition of the top edge.

Definition at line 2158 of file industry_gui.cpp.

References CFT_EMPTY, CFT_HEADER, CFT_SMALL_EMPTY, DrawString(), FS_NORMAL, GetCharacterHeight(), industry_width, and small_height.

◆ DrawHorConnection()

static void CargoesField::DrawHorConnection ( int  left,
int  right,
int  top,
const CargoSpec csp 
)
inlinestaticprivate

Draw a horizontal cargo connection.

Parameters
leftLeft-most coordinate to draw.
rightRight-most coordinate to draw.
topTop coordinate of the cargo connection.
cspCargo to draw.

Definition at line 2382 of file industry_gui.cpp.

◆ GetCargoBase()

int CargoesField::GetCargoBase ( int  xpos) const
inline

For a CFT_CARGO, compute the left position of the left-most vertical cargo connection.

Parameters
xposLeft position of the field.
Returns
Left position of the left-most vertical cargo column.

Definition at line 2145 of file industry_gui.cpp.

References cargo_field_width, cargo_line, cargo_space, and CFT_CARGO.

Referenced by CargoClickedAt().

◆ HasConnection()

bool CargoesField::HasConnection ( )
inline

Does this CFT_CARGO field have a horizontal connection?

Returns
true if a horizontal connection exists, false otherwise.

Definition at line 2089 of file industry_gui.cpp.

References CFT_CARGO.

◆ MakeCargo()

void CargoesField::MakeCargo ( const std::span< const CargoID cargoes)
inline

Make a piece of cargo column.

Parameters
cargoesSpan of CargoID (may contain #INVALID_CARGO).
Note
supp_cargoes and cust_cargoes should be filled in later.

Definition at line 2101 of file industry_gui.cpp.

References cargoes, CFT_CARGO, and IsValidCargoID().

Referenced by IndustryCargoesWindow::ComputeCargoDisplay(), and IndustryCargoesWindow::ComputeIndustryDisplay().

◆ MakeCargoLabel()

void CargoesField::MakeCargoLabel ( const std::span< const CargoID cargoes,
bool  left_align 
)
inline

Make a field displaying cargo type names.

Parameters
cargoesSpan of CargoID (may contain #INVALID_CARGO).
left_alignALign texts to the left (else to the right).

Definition at line 2121 of file industry_gui.cpp.

References cargoes, and CFT_CARGO_LABEL.

◆ MakeEmpty()

void CargoesField::MakeEmpty ( CargoesFieldType  type)
inline

Make one of the empty fields (CFT_EMPTY or CFT_SMALL_EMPTY).

Parameters
typeType of empty field.

Definition at line 2036 of file industry_gui.cpp.

References type.

Referenced by IndustryCargoesWindow::ComputeCargoDisplay(), and IndustryCargoesWindow::ComputeIndustryDisplay().

◆ MakeHeader()

void CargoesField::MakeHeader ( StringID  textid)
inline

Make a header above an industry column.

Parameters
textidText to display.

Definition at line 2134 of file industry_gui.cpp.

References CFT_HEADER.

Referenced by IndustryCargoesWindow::ComputeCargoDisplay(), and IndustryCargoesWindow::ComputeIndustryDisplay().

◆ MakeIndustry()

void CargoesField::MakeIndustry ( IndustryType  ind_type)
inline

Make an industry type field.

Parameters
ind_typeIndustry type (NUM_INDUSTRYTYPES means 'houses').
Note
other_accepted and other_produced should be filled later.

Definition at line 2046 of file industry_gui.cpp.

References CFT_INDUSTRY, and ind_type.


The documentation for this struct was generated from the following file: