1 /* 2 * Common image-related functions. 3 * 4 * Copyright (C) 2018 Paul Boddie <paul@boddie.org.uk> 5 * 6 * This program is free software: you can redistribute it and/or modify 7 * it under the terms of the GNU General Public License as published by 8 * the Free Software Foundation, either version 3 of the License, or 9 * (at your option) any later version. 10 * 11 * This program is distributed in the hope that it will be useful, 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 14 * GNU General Public License for more details. 15 * 16 * You should have received a copy of the GNU General Public License 17 * along with this program. If not, see <http://www.gnu.org/licenses/>. 18 */ 19 20 #ifndef __IMAGE_H__ 21 #define __IMAGE_H__ 22 23 #include <stdint.h> 24 25 26 27 /* Image data type. */ 28 29 typedef struct 30 { 31 /* Image width and height. */ 32 33 uint32_t width, height; 34 35 /* Image data. */ 36 37 uint8_t image[]; 38 39 } image_t; 40 41 42 43 /* Stored display regions. */ 44 45 typedef struct 46 { 47 /* Position of the stored region on the screen. */ 48 49 int x, y; 50 51 } position_t; 52 53 typedef struct 54 { 55 /* Stored region overplotted by the sprite. */ 56 57 uint8_t *image; 58 uint32_t size; 59 60 /* Number of stored frames. */ 61 62 int stored; 63 64 } stored_regions_t; 65 66 67 68 /* A simple sprite abstraction. */ 69 70 typedef struct 71 { 72 /* The sprite image. */ 73 74 image_t *image; 75 76 /* The stored regions to be used to unplot the sprite. */ 77 78 stored_regions_t *regions; 79 80 /* Sprite frame positions. */ 81 82 position_t *pos; 83 84 /* Colour key for transparency. */ 85 86 int key; 87 88 /* The display associated with the sprite. */ 89 90 display_config_t *cfg; 91 92 } sprite_t; 93 94 95 96 /* Initialise stored regions, allocating memory and a structure to access it. 97 98 Stored_Regions(<name>, int frames, int size) 99 */ 100 101 #define Stored_Regions(NAME, FRAMES, SIZE) \ 102 uint8_t __##NAME##_image[(FRAMES) * (SIZE)]; \ 103 stored_regions_t NAME = { \ 104 .image = __##NAME##_image, \ 105 .size = SIZE, \ 106 .stored = 0}; 107 108 /* Access functions. */ 109 110 position_t *image_get_stored_position(sprite_t *s, int frame); 111 112 uint8_t *image_get_stored_region(stored_regions_t *r, int frame); 113 114 115 116 /* Initialise a sprite object using an existing image without the capability of 117 storing regions of the screen. 118 119 SpriteOverwriting(<name>, image_t *image, display_config_t *cfg, int frames, 120 int key) 121 */ 122 123 #define SpriteOverwriting(NAME, IMAGE, CFG, FRAMES, KEY) \ 124 position_t __##NAME##_pos[FRAMES]; \ 125 \ 126 sprite_t NAME = { \ 127 .image = IMAGE, \ 128 .regions = 0, \ 129 .key = KEY, \ 130 .cfg = CFG, \ 131 .pos = __##NAME##_pos}; 132 133 /* Initialise a sprite object using an existing image, creating stored regions 134 for the animation of the sprite. 135 136 Sprite(<name>, image_t *image, display_config_t *cfg, int frames, int key) 137 */ 138 139 #define Sprite(NAME, IMAGE, CFG, FRAMES, KEY) \ 140 Stored_Regions(__##NAME##_regions, FRAMES, \ 141 (IMAGE)->width * (IMAGE)->height); \ 142 position_t __##NAME##_pos[FRAMES]; \ 143 \ 144 sprite_t NAME = { \ 145 .image = IMAGE, \ 146 .regions = &(__##NAME##_regions), \ 147 .key = KEY, \ 148 .cfg = CFG, \ 149 .pos = __##NAME##_pos}; 150 151 /* Sprite plotting operations. */ 152 153 void image_plot_sprite(sprite_t *s); 154 155 void image_unplot_sprite(sprite_t *s); 156 157 void image_unplot_sprite_from_image(sprite_t *s, sprite_t *bg, 158 int xorigin, int yorigin); 159 160 /* Update operations. */ 161 162 position_t *image_get_sprite_position(sprite_t *s); 163 164 void image_set_sprite_position(sprite_t *s, int x, int y); 165 166 /* Convenience operations. */ 167 168 void image_plot_sprite_section(sprite_t *s, 169 int xstart, int ystart, int xsize, int ysize, 170 int x, int y, int key); 171 172 void image_tile_sprite(sprite_t *s, int xsource, int ysource, 173 int width, int height, 174 int xdisplay, int ydisplay); 175 176 void image_update_scrolled_tiled_image(sprite_t *s, int xorigin, int yorigin, 177 int xstep, int ystep); 178 179 void image_update_tiled_image(sprite_t *s, int xorigin, int yorigin, 180 int width, int height, 181 int xdisplay, int ydisplay); 182 183 #endif /* __IMAGE_H__ */