OpenTTD

gfx_func.h
Go to the documentation of this file.
1 /* $Id: gfx_func.h 27829 2017-03-25 23:19:41Z peter1138 $ */
2
3 /*
4 * This file is part of OpenTTD.
5 * 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.
6 * 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.
7 * 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/>.
8 */
9
42 #ifndef GFX_FUNC_H
43 #define GFX_FUNC_H
44
45 #include "gfx_type.h"
46 #include "strings_type.h"
47 #include "string_type.h"
48
49 void GameLoop();
50
51 void CreateConsole();
52
53 extern byte _dirkeys;
54 extern bool _fullscreen;
55 extern byte _support8bpp;
56 extern CursorVars _cursor;
57 extern bool _ctrl_pressed;
58 extern bool _shift_pressed;
59 extern byte _fast_forward;
60
61 extern bool _left_button_down;
62 extern bool _left_button_clicked;
63 extern bool _right_button_down;
64 extern bool _right_button_clicked;
65
66 extern DrawPixelInfo _screen;
67 extern bool _screen_disable_anim;
68
69 extern int _num_resolutions;
70 extern Dimension _resolutions[32];
71 extern Dimension _cur_resolution;
72 extern Palette _cur_palette;
73
74 void HandleKeypress(uint keycode, WChar key);
75 void HandleTextInput(const char *str, bool marked = false, const char *caret = NULL, const char *insert_location = NULL, const char *replacement_end = NULL);
76 void HandleCtrlChanged();
77 void HandleMouseEvents();
78 void CSleep(int milliseconds);
79 void UpdateWindows();
80
81 void DrawMouseCursor();
82 void ScreenSizeChanged();
83 void GameSizeChanged();
84 void UndrawMouseCursor();
85
87 static const int DRAW_STRING_BUFFER = 2048;
88
89 void RedrawScreenRect(int left, int top, int right, int bottom);
90 void GfxScroll(int left, int top, int width, int height, int xo, int yo);
91
92 Dimension GetSpriteSize(SpriteID sprid, Point *offset = NULL, ZoomLevel zoom = ZOOM_LVL_GUI);
93 void DrawSpriteViewport(SpriteID img, PaletteID pal, int x, int y, const SubSprite *sub = NULL);
94 void DrawSprite(SpriteID img, PaletteID pal, int x, int y, const SubSprite *sub = NULL, ZoomLevel zoom = ZOOM_LVL_GUI);
95
97 enum StringAlignment {
98 SA_LEFT = 0 << 0,
99 SA_HOR_CENTER = 1 << 0,
100 SA_RIGHT = 2 << 0,
101 SA_HOR_MASK = 3 << 0,
102
103 SA_TOP = 0 << 2,
104 SA_VERT_CENTER = 1 << 2,
105 SA_BOTTOM = 2 << 2,
106 SA_VERT_MASK = 3 << 2,
107
108 SA_CENTER = SA_HOR_CENTER | SA_VERT_CENTER,
109
110 SA_FORCE = 1 << 4,
111 };
112 DECLARE_ENUM_AS_BIT_SET(StringAlignment)
113
114 int DrawString(int left, int right, int top, const char *str, TextColour colour = TC_FROMSTRING, StringAlignment align = SA_LEFT, bool underline = false, FontSize fontsize = FS_NORMAL);
115 int DrawString(int left, int right, int top, StringID str, TextColour colour = TC_FROMSTRING, StringAlignment align = SA_LEFT, bool underline = false, FontSize fontsize = FS_NORMAL);
116 int DrawStringMultiLine(int left, int right, int top, int bottom, const char *str, TextColour colour = TC_FROMSTRING, StringAlignment align = (SA_TOP | SA_LEFT), bool underline = false, FontSize fontsize = FS_NORMAL);
117 int DrawStringMultiLine(int left, int right, int top, int bottom, StringID str, TextColour colour = TC_FROMSTRING, StringAlignment align = (SA_TOP | SA_LEFT), bool underline = false, FontSize fontsize = FS_NORMAL);
118
119 void DrawCharCentered(uint32 c, int x, int y, TextColour colour);
120
121 void GfxFillRect(int left, int top, int right, int bottom, int colour, FillRectMode mode = FILLRECT_OPAQUE);
122 void GfxDrawLine(int left, int top, int right, int bottom, int colour, int width = 1, int dash = 0);
123 void DrawBox(int x, int y, int dx1, int dy1, int dx2, int dy2, int dx3, int dy3);
124
125 Dimension GetStringBoundingBox(const char *str, FontSize start_fontsize = FS_NORMAL);
126 Dimension GetStringBoundingBox(StringID strid);
127 int GetStringHeight(const char *str, int maxw, FontSize fontsize = FS_NORMAL);
128 int GetStringHeight(StringID str, int maxw);
129 int GetStringLineCount(StringID str, int maxw);
130 Dimension GetStringMultiLineBoundingBox(StringID str, const Dimension &suggestion);
131 Dimension GetStringMultiLineBoundingBox(const char *str, const Dimension &suggestion);
132 void LoadStringWidthTable(bool monospace = false);
133 Point GetCharPosInString(const char *str, const char *ch, FontSize start_fontsize = FS_NORMAL);
134 const char *GetCharAtPosition(const char *str, int x, FontSize start_fontsize = FS_NORMAL);
135
136 void DrawDirtyBlocks();
137 void SetDirtyBlocks(int left, int top, int right, int bottom);
138 void MarkWholeScreenDirty();
139
140 void GfxInitPalettes();
141 void CheckBlitter();
142
143 bool FillDrawPixelInfo(DrawPixelInfo *n, int left, int top, int width, int height);
144
152 static inline int CenterBounds(int min, int max, int size)
153 {
154 return min + (max - min - size + 1) / 2;
155 }
156
157 /* window.cpp */
158 void DrawOverlappedWindowForAll(int left, int top, int right, int bottom);
159
160 void SetMouseCursorBusy(bool busy);
161 void SetMouseCursor(CursorID cursor, PaletteID pal);
162 void SetAnimatedMouseCursor(const AnimCursor *table);
163 void CursorTick();
164 void UpdateCursorSize();
165 bool ChangeResInGame(int w, int h);
166 void SortResolutions(int count);
167 bool ToggleFullScreen(bool fs);
168
169 /* gfx.cpp */
170 byte GetCharacterWidth(FontSize size, uint32 key);
171 byte GetDigitWidth(FontSize size = FS_NORMAL);
172 void GetBroadestDigit(uint *front, uint *next, FontSize size = FS_NORMAL);
173
174 int GetCharacterHeight(FontSize size);
175
177 #define FONT_HEIGHT_SMALL (GetCharacterHeight(FS_SMALL))
178
180 #define FONT_HEIGHT_NORMAL (GetCharacterHeight(FS_NORMAL))
181
183 #define FONT_HEIGHT_LARGE (GetCharacterHeight(FS_LARGE))
184
186 #define FONT_HEIGHT_MONO (GetCharacterHeight(FS_MONO))
187
188 extern DrawPixelInfo *_cur_dpi;
189
190 TextColour GetContrastColour(uint8 background);
191
196 extern byte _colour_gradient[COLOUR_END][8];
197
198 extern bool _palette_remap_grf[];
199
205 #define GREY_SCALE(level) (level)
206
207 static const uint8 PC_BLACK = GREY_SCALE(1);
208 static const uint8 PC_DARK_GREY = GREY_SCALE(6);
209 static const uint8 PC_GREY = GREY_SCALE(10);
210 static const uint8 PC_WHITE = GREY_SCALE(15);
211
212 static const uint8 PC_VERY_DARK_RED = 0xB2;
213 static const uint8 PC_DARK_RED = 0xB4;
214 static const uint8 PC_RED = 0xB8;
215
216 static const uint8 PC_VERY_DARK_BROWN = 0x56;
217
218 static const uint8 PC_ORANGE = 0xC2;
219
220 static const uint8 PC_YELLOW = 0xBF;
221 static const uint8 PC_LIGHT_YELLOW = 0x44;
222 static const uint8 PC_VERY_LIGHT_YELLOW = 0x45;
223
224 static const uint8 PC_GREEN = 0xD0;
225
226 static const uint8 PC_DARK_BLUE = 0x9D;
227 static const uint8 PC_LIGHT_BLUE = 0x98;
228
229 #endif /* GFX_FUNC_H */
GetContrastColour
TextColour GetContrastColour(uint8 background)
Determine a contrasty text colour for a coloured background.
Definition: gfx.cpp:1116
_ctrl_pressed
bool _ctrl_pressed
Is Ctrl pressed?
Definition: gfx.cpp:36
_right_button_clicked
bool _right_button_clicked
Is right mouse button clicked?
Definition: gfx.cpp:42
GetStringBoundingBox
Dimension GetStringBoundingBox(const char *str, FontSize start_fontsize=FS_NORMAL)
Return the string dimension in pixels.
Definition: gfx.cpp:699
HandleTextInput
void HandleTextInput(const char *str, bool marked=false, const char *caret=NULL, const char *insert_location=NULL, const char *replacement_end=NULL)
Handle text input.
Definition: window.cpp:2713
PaletteID
uint32 PaletteID
The number of the palette.
Definition: gfx_type.h:20
DECLARE_ENUM_AS_BIT_SET
DECLARE_ENUM_AS_BIT_SET(GenderEthnicity) enum CompanyManagerFaceVariable
Bitgroups of the CompanyManagerFace variable.
Definition: company_manager_face.h:31
DrawSprite
void DrawSprite(SpriteID img, PaletteID pal, int x, int y, const SubSprite *sub=NULL, ZoomLevel zoom=ZOOM_LVL_GUI)
Draw a sprite, not in a viewport.
Definition: gfx.cpp:833
DrawPixelInfo
Data about how and where to blit pixels.
Definition: gfx_type.h:156
PC_WHITE
static const uint8 PC_WHITE
White palette colour.
Definition: gfx_func.h:210
SA_HOR_CENTER
Horizontally center the text.
Definition: gfx_func.h:99
Palette
Information about the currently used palette.
Definition: gfx_type.h:309
GetCharPosInString
Point GetCharPosInString(const char *str, const char *ch, FontSize start_fontsize=FS_NORMAL)
Get the leading corner of a character in a single-line string relative to the start of the string...
Definition: gfx.cpp:727
_right_button_down
bool _right_button_down
Is right mouse button pressed?
Definition: gfx.cpp:41
GetCharacterWidth
byte GetCharacterWidth(FontSize size, uint32 key)
Return width of character glyph.
Definition: gfx.cpp:1148
StringAlignment
StringAlignment
How to align the to-be drawn text.
Definition: gfx_func.h:97
SA_HOR_MASK
Mask for horizontal alignment.
Definition: gfx_func.h:101
SetMouseCursorBusy
void SetMouseCursorBusy(bool busy)
Set or unset the ZZZ cursor.
Definition: gfx.cpp:1602
_num_resolutions
int _num_resolutions
The number of resolutions.
Definition: driver.cpp:22
PC_LIGHT_BLUE
static const uint8 PC_LIGHT_BLUE
Light blue palette colour.
Definition: gfx_func.h:227
DRAW_STRING_BUFFER
static const int DRAW_STRING_BUFFER
Size of the buffer used for drawing strings.
Definition: gfx_func.h:87
DrawDirtyBlocks
void DrawDirtyBlocks()
Repaints the rectangle blocks which are marked as &#39;dirty&#39;.
Definition: gfx.cpp:1307
SetMouseCursor
void SetMouseCursor(CursorID cursor, PaletteID pal)
Assign a single non-animated sprite to the cursor.
Definition: gfx.cpp:1617
UpdateCursorSize
void UpdateCursorSize()
Update cursor dimension.
Definition: gfx.cpp:1530
PC_LIGHT_YELLOW
static const uint8 PC_LIGHT_YELLOW
Light yellow palette colour.
Definition: gfx_func.h:221
GetStringMultiLineBoundingBox
Dimension GetStringMultiLineBoundingBox(StringID str, const Dimension &suggestion)
Calculate string bounding box for multi-line strings.
Definition: gfx.cpp:587
DrawSpriteViewport
void DrawSpriteViewport(SpriteID img, PaletteID pal, int x, int y, const SubSprite *sub=NULL)
Draw a sprite in a viewport.
Definition: gfx.cpp:806
max
static T max(const T a, const T b)
Returns the maximum of two values.
Definition: math_func.hpp:26
GREY_SCALE
#define GREY_SCALE(level)
Return the colour for a particular greyscale level.
Definition: gfx_func.h:205
FillRectMode
FillRectMode
Define the operation GfxFillRect performs.
Definition: gfx_type.h:282
SetAnimatedMouseCursor
void SetAnimatedMouseCursor(const AnimCursor *table)
Assign an animation to the cursor.
Definition: gfx.cpp:1630
SA_FORCE
Force the alignment, i.e. don&#39;t swap for RTL languages.
Definition: gfx_func.h:110
PC_GREEN
static const uint8 PC_GREEN
Green palette colour.
Definition: gfx_func.h:224
CursorVars
Collection of variables for cursor-display and -animation.
Definition: gfx_type.h:117
PC_DARK_GREY
static const uint8 PC_DARK_GREY
Dark grey palette colour.
Definition: gfx_func.h:208
GfxFillRect
void GfxFillRect(int left, int top, int right, int bottom, int colour, FillRectMode mode=FILLRECT_OPAQUE)
Applies a certain FillRectMode-operation to a rectangle [left, right] x [top, bottom] on the screen...
Definition: gfx.cpp:112
GetStringHeight
int GetStringHeight(const char *str, int maxw, FontSize fontsize=FS_NORMAL)
Calculates height of string (in pixels).
Definition: gfx.cpp:547
FILLRECT_OPAQUE
Fill rectangle with a single colour.
Definition: gfx_type.h:283
DrawStringMultiLine
int DrawStringMultiLine(int left, int right, int top, int bottom, const char *str, TextColour colour=TC_FROMSTRING, StringAlignment align=(SA_TOP|SA_LEFT), bool underline=false, FontSize fontsize=FS_NORMAL)
Draw string, possibly over multiple lines.
Definition: gfx.cpp:620
GetSpriteSize
Dimension GetSpriteSize(SpriteID sprid, Point *offset=NULL, ZoomLevel zoom=ZOOM_LVL_GUI)
Get the size of a sprite.
Definition: gfx.cpp:768
SA_CENTER
Center both horizontally and vertically.
Definition: gfx_func.h:108
SA_BOTTOM
Bottom align the text.
Definition: gfx_func.h:105
SA_TOP
Top align the text.
Definition: gfx_func.h:103
TextColour
TextColour
Colour of the strings, see _string_colourmap in table/string_colours.h or docs/ottd-colourtext-palett...
Definition: gfx_type.h:247
_cur_palette
Palette _cur_palette
Current palette.
Definition: gfx.cpp:49
GetStringLineCount
int GetStringLineCount(StringID str, int maxw)
Calculates number of lines of string.
Definition: gfx.cpp:572
HandleKeypress
void HandleKeypress(uint keycode, WChar key)
Handle keyboard input.
Definition: window.cpp:2625
_palette_remap_grf
bool _palette_remap_grf[]
Whether the given NewGRFs must get a palette remap from windows to DOS or not.
Definition: gfxinit.cpp:32
LoadStringWidthTable
void LoadStringWidthTable(bool monospace=false)
Initialize _stringwidth_table cache.
Definition: gfx.cpp:1130
AnimCursor
A single sprite of a list of animated cursors.
Definition: gfx_type.h:110
HandleMouseEvents
void HandleMouseEvents()
Handle a mouse event from the video driver.
Definition: window.cpp:2922
SA_VERT_MASK
Mask for vertical alignment.
Definition: gfx_func.h:106
_screen_disable_anim
bool _screen_disable_anim
Disable palette animation (important for 32bpp-anim blitter during giant screenshot) ...
Definition: gfx.cpp:44
min
static T min(const T a, const T b)
Returns the minimum of two values.
Definition: math_func.hpp:42
FillDrawPixelInfo
bool FillDrawPixelInfo(DrawPixelInfo *n, int left, int top, int width, int height)
Set up a clipping area for only drawing into a certain area.
Definition: gfx.cpp:1480
StringID
uint32 StringID
Numeric value that represents a string, independent of the selected language.
Definition: strings_type.h:18
DrawBox
void DrawBox(int x, int y, int dx1, int dy1, int dx2, int dy2, int dx3, int dy3)
Draws the projection of a parallelepiped.
Definition: gfx.cpp:278
_resolutions
Dimension _resolutions[32]
List of resolutions.
Definition: driver.cpp:23
PC_BLACK
static const uint8 PC_BLACK
Black palette colour.
Definition: gfx_func.h:207
DrawOverlappedWindowForAll
void DrawOverlappedWindowForAll(int left, int top, int right, int bottom)
From a rectangle that needs redrawing, find the windows that intersect with the rectangle.
Definition: window.cpp:937
_dirkeys
byte _dirkeys
1 = left, 2 = up, 4 = right, 8 = down
Definition: gfx.cpp:32
DrawString
int DrawString(int left, int right, int top, const char *str, TextColour colour=TC_FROMSTRING, StringAlignment align=SA_LEFT, bool underline=false, FontSize fontsize=FS_NORMAL)
Draw string, possibly truncated to make it fit in its allocated space.
Definition: gfx.cpp:499
_shift_pressed
bool _shift_pressed
Is Shift pressed?
Definition: gfx.cpp:37
DrawCharCentered
void DrawCharCentered(uint32 c, int x, int y, TextColour colour)
Draw single character horizontally centered around (x,y)
Definition: gfx.cpp:755
PC_VERY_DARK_RED
static const uint8 PC_VERY_DARK_RED
Almost-black red palette colour.
Definition: gfx_func.h:212
CenterBounds
static int CenterBounds(int min, int max, int size)
Determine where to draw a centred object inside a widget.
Definition: gfx_func.h:152
PC_GREY
static const uint8 PC_GREY
Grey palette colour.
Definition: gfx_func.h:209
PC_DARK_BLUE
static const uint8 PC_DARK_BLUE
Dark blue palette colour.
Definition: gfx_func.h:226
PC_YELLOW
static const uint8 PC_YELLOW
Yellow palette colour.
Definition: gfx_func.h:220
HandleCtrlChanged
void HandleCtrlChanged()
State of CONTROL key has changed.
Definition: window.cpp:2682
PC_DARK_RED
static const uint8 PC_DARK_RED
Dark red palette colour.
Definition: gfx_func.h:213
ZoomLevel
ZoomLevel
All zoom levels we know.
Definition: zoom_type.h:21
GetDigitWidth
byte GetDigitWidth(FontSize size=FS_NORMAL)
Return the maximum width of single digit.
Definition: gfx.cpp:1161
_left_button_down
bool _left_button_down
Is left mouse button pressed?
Definition: gfx.cpp:39
SpriteID
uint32 SpriteID
The number of a sprite, without mapping bits and colourtables.
Definition: gfx_type.h:19
PC_ORANGE
static const uint8 PC_ORANGE
Orange palette colour.
Definition: gfx_func.h:218
PC_VERY_DARK_BROWN
static const uint8 PC_VERY_DARK_BROWN
Almost-black brown palette colour.
Definition: gfx_func.h:216
PC_RED
static const uint8 PC_RED
Red palette colour.
Definition: gfx_func.h:214
FontSize
FontSize
Available font sizes.
Definition: gfx_type.h:203
GetCharAtPosition
const char * GetCharAtPosition(const char *str, int x, FontSize start_fontsize=FS_NORMAL)
Get the character from a string that is drawn at a specific position.
Definition: gfx.cpp:740
FS_NORMAL
Index of the normal font in the font tables.
Definition: gfx_type.h:204
SubSprite
Used to only draw a part of the sprite.
Definition: gfx_type.h:219
GetBroadestDigit
void GetBroadestDigit(uint *front, uint *next, FontSize size=FS_NORMAL)
Determine the broadest digits for guessing the maximum width of a n-digit number. ...
Definition: gfx.cpp:1176
_colour_gradient
byte _colour_gradient[COLOUR_END][8]
All 16 colour gradients 8 colours per gradient from darkest (0) to lightest (7)
Definition: gfx.cpp:53
CursorID
uint32 CursorID
The number of the cursor (sprite)
Definition: gfx_type.h:21
Point
Coordinates of a point in 2D.
Definition: geometry_type.hpp:28
strings_type.h
Types related to strings.
GameSizeChanged
void GameSizeChanged()
Size of the application screen changed.
Definition: main_gui.cpp:591
string_type.h
Types for strings.
_left_button_clicked
bool _left_button_clicked
Is left mouse button clicked?
Definition: gfx.cpp:40
SA_RIGHT
Right align the text (must be a single bit).
Definition: gfx_func.h:100
_cur_resolution
Dimension _cur_resolution
The current resolution.
Definition: driver.cpp:24
SA_LEFT
Left align the text.
Definition: gfx_func.h:98
SA_VERT_CENTER
Vertically center the text.
Definition: gfx_func.h:104
GetCharacterHeight
int GetCharacterHeight(FontSize size)
Get height of a character for a given font size.
Definition: fontcache.cpp:63
SetDirtyBlocks
void SetDirtyBlocks(int left, int top, int right, int bottom)
This function extends the internal _invalid_rect rectangle as it now contains the rectangle defined b...
Definition: gfx.cpp:1418
WChar
uint32 WChar
Type for wide characters, i.e.
Definition: string_type.h:35
PC_VERY_LIGHT_YELLOW
static const uint8 PC_VERY_LIGHT_YELLOW
Almost-white yellow palette colour.
Definition: gfx_func.h:222
Dimension
Dimensions (a width and height) of a rectangle in 2D.
Definition: geometry_type.hpp:34
CheckBlitter
void CheckBlitter()
Check whether we still use the right blitter, or use another (better) one.
Definition: gfxinit.cpp:327
gfx_type.h
Types related to the graphics and/or input devices.
MarkWholeScreenDirty
void MarkWholeScreenDirty()
This function mark the whole screen as dirty.
Definition: gfx.cpp:1461
UpdateWindows
void UpdateWindows()
Update the continuously changing contents of the windows, such as the viewports.
Definition: window.cpp:3067