OpenTTD Source: src/sprite.cpp Source File

OpenTTD Source 13.1

sprite.cpp
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 #include "stdafx.h"
11 #include "sprite.h"
12 #include "viewport_func.h"
13 #include "landscape.h"
14 #include "spritecache.h"
15 #include "zoom_func.h"
16
17 #include "safeguards.h"
18
19
30 void DrawCommonTileSeq(const TileInfo *ti, const DrawTileSprites *dts, TransparencyOption to, int32 orig_offset, uint32 newgrf_offset, PaletteID default_palette, bool child_offset_is_unsigned)
31 {
32 bool parent_sprite_encountered = false;
33 const DrawTileSeqStruct *dtss;
34 bool skip_childs = false;
35 foreach_draw_tile_seq(dtss, dts->seq) {
36 SpriteID image = dtss->image.sprite;
37 PaletteID pal = dtss->image.pal;
38
39 if (skip_childs) {
40 if (!dtss->IsParentSprite()) continue;
41 skip_childs = false;
42 }
43
44 /* TTD sprite 0 means no sprite */
45 if ((GB(image, 0, SPRITE_WIDTH) == 0 && !HasBit(image, SPRITE_MODIFIER_CUSTOM_SPRITE)) ||
46 (IsInvisibilitySet(to) && !HasBit(image, SPRITE_MODIFIER_OPAQUE))) {
47 skip_childs = dtss->IsParentSprite();
48 continue;
49 }
50
51 image += (HasBit(image, SPRITE_MODIFIER_CUSTOM_SPRITE) ? newgrf_offset : orig_offset);
52 if (HasBit(pal, SPRITE_MODIFIER_CUSTOM_SPRITE)) pal += newgrf_offset;
53
54 pal = SpriteLayoutPaletteTransform(image, pal, default_palette);
55
56 if (dtss->IsParentSprite()) {
57 parent_sprite_encountered = true;
58 AddSortableSpriteToDraw(
59 image, pal,
60 ti->x + dtss->delta_x, ti->y + dtss->delta_y,
61 dtss->size_x, dtss->size_y,
62 dtss->size_z, ti->z + dtss->delta_z,
63 !HasBit(image, SPRITE_MODIFIER_OPAQUE) && IsTransparencySet(to)
64 );
65 } else {
66 int offs_x = child_offset_is_unsigned ? (uint8)dtss->delta_x : dtss->delta_x;
67 int offs_y = child_offset_is_unsigned ? (uint8)dtss->delta_y : dtss->delta_y;
68 bool transparent = !HasBit(image, SPRITE_MODIFIER_OPAQUE) && IsTransparencySet(to);
69 if (parent_sprite_encountered) {
70 AddChildSpriteScreen(image, pal, offs_x, offs_y, transparent);
71 } else {
72 if (transparent) {
73 SetBit(image, PALETTE_MODIFIER_TRANSPARENT);
74 pal = PALETTE_TO_TRANSPARENT;
75 }
76 DrawGroundSprite(image, pal, nullptr, offs_x, offs_y);
77 }
78 }
79 }
80 }
81
92 void DrawCommonTileSeqInGUI(int x, int y, const DrawTileSprites *dts, int32 orig_offset, uint32 newgrf_offset, PaletteID default_palette, bool child_offset_is_unsigned)
93 {
94 const DrawTileSeqStruct *dtss;
95 Point child_offset = {0, 0};
96
97 bool skip_childs = false;
98 foreach_draw_tile_seq(dtss, dts->seq) {
99 SpriteID image = dtss->image.sprite;
100 PaletteID pal = dtss->image.pal;
101
102 if (skip_childs) {
103 if (!dtss->IsParentSprite()) continue;
104 skip_childs = false;
105 }
106
107 /* TTD sprite 0 means no sprite */
108 if (GB(image, 0, SPRITE_WIDTH) == 0 && !HasBit(image, SPRITE_MODIFIER_CUSTOM_SPRITE)) {
109 skip_childs = dtss->IsParentSprite();
110 continue;
111 }
112
113 image += (HasBit(image, SPRITE_MODIFIER_CUSTOM_SPRITE) ? newgrf_offset : orig_offset);
114 if (HasBit(pal, SPRITE_MODIFIER_CUSTOM_SPRITE)) pal += newgrf_offset;
115
116 pal = SpriteLayoutPaletteTransform(image, pal, default_palette);
117
118 if (dtss->IsParentSprite()) {
119 Point pt = RemapCoords(dtss->delta_x, dtss->delta_y, dtss->delta_z);
120 DrawSprite(image, pal, x + UnScaleGUI(pt.x), y + UnScaleGUI(pt.y));
121
122 const Sprite *spr = GetSprite(image & SPRITE_MASK, ST_NORMAL);
123 child_offset.x = UnScaleGUI(pt.x + spr->x_offs);
124 child_offset.y = UnScaleGUI(pt.y + spr->y_offs);
125 } else {
126 int offs_x = child_offset_is_unsigned ? (uint8)dtss->delta_x : dtss->delta_x;
127 int offs_y = child_offset_is_unsigned ? (uint8)dtss->delta_y : dtss->delta_y;
128 DrawSprite(image, pal, x + child_offset.x + ScaleSpriteTrad(offs_x), y + child_offset.y + ScaleSpriteTrad(offs_y));
129 }
130 }
131 }
DrawCommonTileSeq
void DrawCommonTileSeq(const TileInfo *ti, const DrawTileSprites *dts, TransparencyOption to, int32 orig_offset, uint32 newgrf_offset, PaletteID default_palette, bool child_offset_is_unsigned)
Draws a tile sprite sequence.
Definition: sprite.cpp:30
TileInfo::z
int z
Height.
Definition: tile_cmd.h:47
SPRITE_MASK
@ SPRITE_MASK
The mask to for the main sprite.
Definition: sprites.h:1548
GB
static uint GB(const T x, const uint8 s, const uint8 n)
Fetch n bits from x, started at bit s.
Definition: bitmath_func.hpp:32
DrawCommonTileSeqInGUI
void DrawCommonTileSeqInGUI(int x, int y, const DrawTileSprites *dts, int32 orig_offset, uint32 newgrf_offset, PaletteID default_palette, bool child_offset_is_unsigned)
Draws a tile sprite sequence in the GUI.
Definition: sprite.cpp:92
TileInfo::x
uint x
X position of the tile in unit coordinates.
Definition: tile_cmd.h:43
DrawTileSeqStruct::IsParentSprite
bool IsParentSprite() const
Check whether this is a parent sprite with a boundingbox.
Definition: sprite.h:47
TileInfo
Tile information, used while rendering the tile.
Definition: tile_cmd.h:42
SPRITE_WIDTH
@ SPRITE_WIDTH
number of bits for the sprite number
Definition: sprites.h:1523
sprite.h
SpriteLayoutPaletteTransform
static PaletteID SpriteLayoutPaletteTransform(SpriteID image, PaletteID pal, PaletteID default_pal)
Applies PALETTE_MODIFIER_TRANSPARENT and PALETTE_MODIFIER_COLOUR to a palette entry of a sprite layou...
Definition: sprite.h:149
IsTransparencySet
static bool IsTransparencySet(TransparencyOption to)
Check if the transparency option bit is set and if we aren't in the game menu (there's never transpar...
Definition: transparency.h:48
RemapCoords
static Point RemapCoords(int x, int y, int z)
Map 3D world or tile coordinate to equivalent 2D coordinate as used in the viewports and smallmap.
Definition: landscape.h:82
PalSpriteID::sprite
SpriteID sprite
The 'real' sprite.
Definition: gfx_type.h:23
HasBit
static bool HasBit(const T x, const uint8 y)
Checks if a bit in a value is set.
Definition: bitmath_func.hpp:103
UnScaleGUI
static int UnScaleGUI(int value)
Short-hand to apply GUI zoom level.
Definition: zoom_func.h:77
PALETTE_TO_TRANSPARENT
static const PaletteID PALETTE_TO_TRANSPARENT
This sets the sprite to transparent.
Definition: sprites.h:1595
zoom_func.h
Sprite::x_offs
int16 x_offs
Number of pixels to shift the sprite to the right.
Definition: spritecache.h:20
TileInfo::y
uint y
Y position of the tile in unit coordinates.
Definition: tile_cmd.h:44
ST_NORMAL
@ ST_NORMAL
The most basic (normal) sprite.
Definition: gfx_type.h:309
SpriteID
uint32 SpriteID
The number of a sprite, without mapping bits and colourtables.
Definition: gfx_type.h:17
DrawTileSeqStruct::delta_x
int8 delta_x
0x80 is sequence terminator
Definition: sprite.h:26
DrawTileSeqStruct::delta_z
int8 delta_z
0x80 identifies child sprites
Definition: sprite.h:28
SPRITE_MODIFIER_OPAQUE
@ SPRITE_MODIFIER_OPAQUE
Set when a sprite must not ever be displayed transparently.
Definition: sprites.h:1536
IsInvisibilitySet
static bool IsInvisibilitySet(TransparencyOption to)
Check if the invisibility option bit is set and if we aren't in the game menu (there's never transpar...
Definition: transparency.h:59
ScaleSpriteTrad
static int ScaleSpriteTrad(int value)
Scale traditional pixel dimensions to GUI zoom level, for drawing sprites.
Definition: zoom_func.h:107
foreach_draw_tile_seq
#define foreach_draw_tile_seq(idx, list)
Iterate through all DrawTileSeqStructs in DrawTileSprites.
Definition: sprite.h:79
safeguards.h
SPRITE_MODIFIER_CUSTOM_SPRITE
@ SPRITE_MODIFIER_CUSTOM_SPRITE
Set when a sprite originates from an Action 1.
Definition: sprites.h:1535
DrawTileSprites
Ground palette sprite of a tile, together with its sprite layout.
Definition: sprite.h:58
DrawSprite
void DrawSprite(SpriteID img, PaletteID pal, int x, int y, const SubSprite *sub, ZoomLevel zoom)
Draw a sprite, not in a viewport.
Definition: gfx.cpp:1058
Point
Coordinates of a point in 2D.
Definition: geometry_type.hpp:21
stdafx.h
landscape.h
PALETTE_MODIFIER_TRANSPARENT
@ PALETTE_MODIFIER_TRANSPARENT
when a sprite is to be displayed transparently, this bit needs to be set.
Definition: sprites.h:1537
viewport_func.h
AddSortableSpriteToDraw
void AddSortableSpriteToDraw(SpriteID image, PaletteID pal, int x, int y, int w, int h, int dz, int z, bool transparent, int bb_offset_x, int bb_offset_y, int bb_offset_z, const SubSprite *sub)
Draw a (transparent) sprite at given coordinates with a given bounding box.
Definition: viewport.cpp:667
spritecache.h
TransparencyOption
TransparencyOption
Transparency option bits: which position in _transparency_opt stands for which transparency.
Definition: transparency.h:22
PaletteID
uint32 PaletteID
The number of the palette.
Definition: gfx_type.h:18
Sprite::y_offs
int16 y_offs
Number of pixels to shift the sprite downwards.
Definition: spritecache.h:21
DrawTileSprites::seq
const DrawTileSeqStruct * seq
Array of child sprites. Terminated with a terminator entry.
Definition: sprite.h:60
SetBit
static T SetBit(T &x, const uint8 y)
Set a bit in a variable.
Definition: bitmath_func.hpp:121
AddChildSpriteScreen
void AddChildSpriteScreen(SpriteID image, PaletteID pal, int x, int y, bool transparent, const SubSprite *sub, bool scale, bool relative)
Add a child sprite to a parent sprite.
Definition: viewport.cpp:823
PalSpriteID::pal
PaletteID pal
The palette (use PAL_NONE) if not needed)
Definition: gfx_type.h:24
Sprite
Data structure describing a sprite.
Definition: spritecache.h:17
DrawGroundSprite
void DrawGroundSprite(SpriteID image, PaletteID pal, const SubSprite *sub, int extra_offs_x, int extra_offs_y)
Draws a ground sprite for the current tile.
Definition: viewport.cpp:583
DrawTileSeqStruct
A tile child sprite and palette to draw for stations etc, with 3D bounding box.
Definition: sprite.h:25