OpenTTD Source 20250205-master-gfd85ab1e2c
palette_func.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 PALETTE_FUNC_H
11#define PALETTE_FUNC_H
12
13#include "core/enum_type.hpp"
14#include "gfx_type.h"
15#include "strings_type.h"
16#include "string_type.h"
17
18extern Palette _cur_palette;
19
20bool CopyPalette(Palette &local_palette, bool force_copy = false);
21void GfxInitPalettes();
22
23uint8_t GetNearestColourIndex(uint8_t r, uint8_t g, uint8_t b);
24uint8_t GetNearestColourReshadeIndex(uint8_t b);
25
26inline uint8_t GetNearestColourIndex(const Colour colour)
27{
28 return GetNearestColourIndex(colour.r, colour.g, colour.b);
29}
30
31static constexpr int DEFAULT_BRIGHTNESS = 128;
32
33Colour ReallyAdjustBrightness(Colour colour, int brightness);
34
35static inline Colour AdjustBrightness(Colour colour, uint8_t brightness)
36{
37 /* Shortcut for normal brightness */
38 if (brightness == DEFAULT_BRIGHTNESS) return colour;
39
40 return ReallyAdjustBrightness(colour, brightness);
41}
42
49static inline uint8_t GetColourBrightness(Colour colour)
50{
51 uint8_t rgb_max = std::max(colour.r, std::max(colour.g, colour.b));
52
53 /* Black pixel (8bpp or old 32bpp image), so use default value */
54 if (rgb_max == 0) rgb_max = DEFAULT_BRIGHTNESS;
55
56 return rgb_max;
57}
58
65inline bool IsValidColours(Colours colours)
66{
67 return colours < COLOUR_END;
68}
69
70TextColour GetContrastColour(uint8_t background, uint8_t threshold = 128);
71
72enum ColourShade : uint8_t {
73 SHADE_BEGIN = 0,
74 SHADE_DARKEST = SHADE_BEGIN,
75 SHADE_DARKER,
76 SHADE_DARK,
77 SHADE_NORMAL,
78 SHADE_LIGHT,
79 SHADE_LIGHTER,
80 SHADE_LIGHTEST,
81 SHADE_LIGHTEREST,
82 SHADE_END,
83};
85
86uint8_t GetColourGradient(Colours colour, ColourShade shade);
87void SetColourGradient(Colours colour, ColourShade shade, uint8_t palette_colour);
88
94#define GREY_SCALE(level) (level)
95
96static const uint8_t PC_BLACK = GREY_SCALE(1);
97static const uint8_t PC_DARK_GREY = GREY_SCALE(6);
98static const uint8_t PC_GREY = GREY_SCALE(10);
99static const uint8_t PC_WHITE = GREY_SCALE(15);
100
101static const uint8_t PC_VERY_DARK_RED = 0xB2;
102static const uint8_t PC_DARK_RED = 0xB4;
103static const uint8_t PC_RED = 0xB8;
104
105static const uint8_t PC_VERY_DARK_BROWN = 0x56;
106
107static const uint8_t PC_ORANGE = 0xC2;
108
109static const uint8_t PC_YELLOW = 0xBF;
110static const uint8_t PC_LIGHT_YELLOW = 0x44;
111static const uint8_t PC_VERY_LIGHT_YELLOW = 0x45;
112
113static const uint8_t PC_GREEN = 0xD0;
114
115static const uint8_t PC_VERY_DARK_BLUE = 0x9A;
116static const uint8_t PC_DARK_BLUE = 0x9D;
117static const uint8_t PC_LIGHT_BLUE = 0x98;
118
119static const uint8_t PC_ROUGH_LAND = 0x52;
120static const uint8_t PC_GRASS_LAND = 0x54;
121static const uint8_t PC_BARE_LAND = 0x37;
122static const uint8_t PC_RAINFOREST = 0x5C;
123static const uint8_t PC_FIELDS = 0x25;
124static const uint8_t PC_TREES = 0x57;
125static const uint8_t PC_WATER = 0xC9;
126
127#endif /* PALETTE_FUNC_H */
Type (helpers) for enums.
#define DECLARE_INCREMENT_DECREMENT_OPERATORS(enum_type)
For some enums it is useful to have pre/post increment/decrement operators.
Definition enum_type.hpp:61
Types related to the graphics and/or input devices.
TextColour
Colour of the strings, see _string_colourmap in table/string_colours.h or docs/ottd-colourtext-palett...
Definition gfx_type.h:294
static uint8_t GetColourBrightness(Colour colour)
Get the brightness of a colour.
static const uint8_t PC_VERY_DARK_RED
Almost-black red palette colour.
static const uint8_t PC_LIGHT_YELLOW
Light yellow palette colour.
static const uint8_t PC_TREES
Green palette colour for trees.
static const uint8_t PC_GREY
Grey palette colour.
static const uint8_t PC_GREEN
Green palette colour.
static const uint8_t PC_WHITE
White palette colour.
bool CopyPalette(Palette &local_palette, bool force_copy=false)
Copy the current palette if the palette was updated.
Definition palette.cpp:225
static const uint8_t PC_DARK_GREY
Dark grey palette colour.
static const uint8_t PC_WATER
Dark blue palette colour for water.
static const uint8_t PC_LIGHT_BLUE
Light blue palette colour.
uint8_t GetColourGradient(Colours colour, ColourShade shade)
Get colour gradient palette index.
Definition palette.cpp:387
static const uint8_t PC_FIELDS
Light brown palette colour for fields.
bool IsValidColours(Colours colours)
Checks if a Colours value is valid.
static const uint8_t PC_DARK_BLUE
Dark blue palette colour.
static const uint8_t PC_BLACK
Black palette colour.
static const uint8_t PC_DARK_RED
Dark red palette colour.
Colour ReallyAdjustBrightness(Colour colour, int brightness)
Adjust brightness of colour.
Definition palette.cpp:177
static const uint8_t PC_ROUGH_LAND
Dark green palette colour for rough land.
Palette _cur_palette
Current palette.
Definition palette.cpp:24
uint8_t GetNearestColourReshadeIndex(uint8_t b)
Get nearest colour palette index from a brightness level.
Definition palette.cpp:164
static const uint8_t PC_BARE_LAND
Brown palette colour for bare land.
static const uint8_t PC_ORANGE
Orange palette colour.
static const uint8_t PC_RED
Red palette colour.
static const uint8_t PC_VERY_DARK_BLUE
Almost-black blue palette colour.
TextColour GetContrastColour(uint8_t background, uint8_t threshold=128)
Determine a contrasty text colour for a coloured background.
Definition palette.cpp:360
static const uint8_t PC_VERY_DARK_BROWN
Almost-black brown palette colour.
uint8_t GetNearestColourIndex(uint8_t r, uint8_t g, uint8_t b)
Get nearest colour palette index from an RGB colour.
Definition palette.cpp:151
static const uint8_t PC_YELLOW
Yellow palette colour.
static const uint8_t PC_GRASS_LAND
Dark green palette colour for grass land.
void SetColourGradient(Colours colour, ColourShade shade, uint8_t palette_colour)
Set colour gradient palette index.
Definition palette.cpp:398
static const uint8_t PC_RAINFOREST
Pale green palette colour for rainforest.
#define GREY_SCALE(level)
Return the colour for a particular greyscale level.
static const uint8_t PC_VERY_LIGHT_YELLOW
Almost-white yellow palette colour.
Types for strings.
Types related to strings.
Information about the currently used palette.
Definition gfx_type.h:360