1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
|
#ifndef __TILE_H__
#define __TILE_H__
#define TILE_WIDTH 64
#define TILE_HEIGHT 64
#define TILE_DEBUG
#include <sys/types.h>
#include <glib.h>
typedef struct _Tile Tile;
struct _Tile
{
short ref_count; /* reference count. when the reference count is
* non-zero then the "data" for this tile must
* be valid. when the reference count for a tile
* is 0 then the "data" for this tile must be
* NULL.
*/
guint dirty : 1; /* is the tile dirty? has it been modified? */
guint valid : 1; /* is the tile valid? */
int ewidth; /* the effective width of the tile */
int eheight; /* the effective height of the tile */
/* a tiles effective width and height may be smaller
* (but not larger) than TILE_WIDTH and TILE_HEIGHT.
* this is to handle edge tiles of a drawable.
*/
int bpp; /* the bytes per pixel (1, 2, 3 or 4) */
int tile_num; /* the number of this tile within the drawable */
guchar *data; /* the data for the tile. this may be NULL in which
* case the tile data is on disk.
*/
int swap_num; /* the index into the file table of the file to be used
* for swapping. swap_num 1 is always the global swap file.
*/
off_t swap_offset; /* the offset within the swap file of the tile data.
* if the tile data is in memory this will be set to -1.
*/
void *tm; /* A pointer to the tile manager for this tile.
* We need this in order to call the tile managers validate
* proc whenever the tile is referenced yet invalid.
*/
};
/* Initializes the fields of a tile to "good" values.
*/
void tile_init (Tile *tile,
int bpp);
/* Referencing a tile causes the reference count to be incremented.
* If the reference count was previously 0 the tile will will be
* swapped into memory from disk.
*/
#if defined (TILE_DEBUG) && defined (__GNUC__)
#define tile_ref(t) _tile_ref (t, __PRETTY_FUNCTION__)
void _tile_ref (Tile *tile, char *func_name);
#else
void tile_ref (Tile *tile);
#endif
/* Unrefercing a tile causes the reference count to be decremented.
* When the reference count reaches 0 the tile data will be swapped
* out to disk. Note that the tile may be in the tile cache which
* also references the tile causing the reference count not to
* fall below 1 until the tile is removed from the cache.
* The dirty flag indicates whether the tile data has been dirtied
* while referenced.
*/
#if defined (TILE_DEBUG) && defined (__GNUC__)
#define tile_unref(t,d) _tile_unref (t, d, __PRETTY_FUNCTION__)
void _tile_unref (Tile *tile, int dirty, char *func_name);
#else
void tile_unref (Tile *tile, int dirty);
#endif
/* Allocate the data for the tile.
*/
void tile_alloc (Tile *tile);
/* Return the size in bytes of the tiles data.
*/
int tile_size (Tile *tile);
/* Invalidates a tile. This involves setting its invalid bit and
* a) if the tile is in memory deleting the tile data or b) if the
* tile is in the swap file, deleting the space it occupies. This
* will cause the tile data to need to be recalculated.
* This should probably only be used on sublevel tiles. Invalidating
* a toplevel tile would mean that it needs to be recalculated. But
* what do you recalculate a toplevel tile from?
*/
void tile_invalidate (Tile *tile);
#endif /* __TILE_H__ */
|
