1

#ifndef SPRITE_H

     2

#define SPRITE_H

     3

     4

     5

/* The following describes bunch of sprites to be drawn together in a single 3D

     6

 * bounding box. Used especially for various multi-sprite buildings (like

     7

 * depots or stations): */

     8

     9

typedef struct DrawTileSeqStruct {

    10

	int8 delta_x; // 0x80 is sequence terminator

    11

	int8 delta_y;

    12

	int8 delta_z;

    13

	byte width,height;

    14

	byte unk; // 'depth', just z-size; TODO: rename

    15

	uint32 image;

    16

} DrawTileSeqStruct;

    17

    18

typedef struct DrawTileSprites {

    19

	SpriteID ground_sprite;

    20

	DrawTileSeqStruct const *seq;

    21

} DrawTileSprites;

    22

    23

// Iterate through all DrawTileSeqStructs in DrawTileSprites.

    24

#define foreach_draw_tile_seq(idx, list) for (idx = list; ((byte) idx->delta_x) != 0x80; idx++)

    25

    26

    27

/* This is for custom sprites: */

    28

    29

    30

struct SpriteGroup;

    31

    32

struct RealSpriteGroup {

    33

	// XXX: Would anyone ever need more than 16 spritesets? Maybe we should

    34

	// use even less, now we take whole 8kb for custom sprites table, oh my!

    35

	byte sprites_per_set; // means number of directions - 4 or 8

    36

    37

	// Loaded = in motion, loading = not moving

    38

	// Each group contains several spritesets, for various loading stages

    39

    40

	// XXX: For stations the meaning is different - loaded is for stations

    41

	// with small amount of cargo whilst loading is for stations with a lot

    42

	// of da stuff.

    43

    44

	byte loaded_count;

    45

	uint16 loaded[16]; // sprite ids

    46

	byte loading_count;

    47

	uint16 loading[16]; // sprite ids

    48

};

    49

    50

/* Shared by deterministic and random groups. */

    51

enum VarSpriteGroupScope {

    52

	VSG_SCOPE_SELF,

    53

	// Engine of consists for vehicles, city for stations.

    54

	VSG_SCOPE_PARENT,

    55

};

    56

    57

struct DeterministicSpriteGroupRanges;

    58

    59

struct DeterministicSpriteGroup {

    60

	// Take this variable:

    61

	enum VarSpriteGroupScope var_scope;

    62

	byte variable;

    63

    64

	// Do this with it:

    65

	byte shift_num;

    66

	byte and_mask;

    67

    68

	// Then do this with it:

    69

	enum DeterministicSpriteGroupOperation {

    70

		DSG_OP_NONE,

    71

		DSG_OP_DIV,

    72

		DSG_OP_MOD,

    73

	} operation;

    74

	byte add_val;

    75

	byte divmod_val;

    77

	// And apply it to this:

    78

	byte num_ranges;

    79

	struct DeterministicSpriteGroupRange *ranges; // Dynamically allocated

    80

    81

	// Dynamically allocated, this is the sole owner

    82

	struct SpriteGroup *default_group;

    83

};

    84

    85

struct RandomizedSpriteGroup {

    86

	// Take this object:

    87

	enum VarSpriteGroupScope var_scope;

    88

    89

	// Check for these triggers:

    90

	enum RandomizedSpriteGroupCompareMode {

    91

		RSG_CMP_ANY,

    92

		RSG_CMP_ALL,

    93

	} cmp_mode;

    94

	byte triggers;

    95

    96

	// Look for this in the per-object randomized bitmask:

    97

	byte lowest_randbit;

    98

	byte num_groups; // must be power of 2

    99

   100

	// Take the group with appropriate index:

   101

	struct SpriteGroup *groups;

   102

};

   103

   104

struct SpriteGroup {

   105

	enum SpriteGroupType {

   106

		SGT_REAL,

   107

		SGT_DETERMINISTIC,

   108

		SGT_RANDOMIZED,

   109

	} type;

   110

   111

	union {

   112

		struct RealSpriteGroup real;

   113

		struct DeterministicSpriteGroup determ;

   114

		struct RandomizedSpriteGroup random;

   115

	} g;

   116

};

   117

   118

struct DeterministicSpriteGroupRange {

   119

	struct SpriteGroup group;

   120

	byte low;

   121

	byte high;

   122

};

   123

   124

/* This takes value (probably of the variable specified in the group) and

   125

 * chooses corresponding SpriteGroup accordingly to the given

   126

 * DeterministicSpriteGroup. */

   127

struct SpriteGroup *EvalDeterministicSpriteGroup(struct DeterministicSpriteGroup *dsg, int value);

   128

/* Get value of a common deterministic SpriteGroup variable. */

   129

int GetDeterministicSpriteValue(byte var);

   130

   131

/* This takes randomized bitmask (probably associated with

   132

 * vehicle/station/whatever) and chooses corresponding SpriteGroup

   133

 * accordingly to the given RandomizedSpriteGroup. */

   134

struct SpriteGroup *EvalRandomizedSpriteGroup(struct RandomizedSpriteGroup *rsg, byte random_bits);

   135

/* Triggers given RandomizedSpriteGroup with given bitmask and returns and-mask

   136

 * of random bits to be reseeded, or zero if there were no triggers matched

   137

 * (then they are |ed to @waiting_triggers instead). */

   138

byte RandomizedSpriteGroupTriggeredBits(struct RandomizedSpriteGroup *rsg, byte triggers, byte *waiting_triggers);

   139

   140

#endif