sp_tile_cache.h revision 89f244931f444056a1ccf544e608b533fa993fa2
1/**************************************************************************
2 *
3 * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
4 * All Rights Reserved.
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
13 *
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
16 * of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 *
26 **************************************************************************/
27
28#ifndef SP_TILE_CACHE_H
29#define SP_TILE_CACHE_H
30
31
32#include "pipe/p_compiler.h"
33
34
35struct softpipe_tile_cache;
36
37
38/**
39 * Cache tile size (width and height). This needs to be a power of two.
40 */
41#define TILE_SIZE 64
42
43
44/* If we need to support > 4096, just expand this to be a 64 bit
45 * union, or consider tiling in Z as well.
46 */
47union tile_address {
48   struct {
49      unsigned x:6;             /* 4096 / TILE_SIZE */
50      unsigned y:6;             /* 4096 / TILE_SIZE */
51      unsigned invalid:1;
52      unsigned pad:19;
53   } bits;
54   unsigned value;
55};
56
57
58struct softpipe_cached_tile
59{
60   union tile_address addr;
61   union {
62      float color[TILE_SIZE][TILE_SIZE][4];
63      uint color32[TILE_SIZE][TILE_SIZE];
64      uint depth32[TILE_SIZE][TILE_SIZE];
65      ushort depth16[TILE_SIZE][TILE_SIZE];
66      ubyte stencil8[TILE_SIZE][TILE_SIZE];
67      ubyte any[1];
68   } data;
69};
70
71#define NUM_ENTRIES 50
72
73
74/** XXX move these */
75#define MAX_WIDTH 4096
76#define MAX_HEIGHT 4096
77
78
79struct softpipe_tile_cache
80{
81   struct pipe_context *pipe;
82   struct pipe_surface *surface;  /**< the surface we're caching */
83   struct pipe_transfer *transfer;
84   void *transfer_map;
85
86   struct softpipe_cached_tile entries[NUM_ENTRIES];
87   uint clear_flags[(MAX_WIDTH / TILE_SIZE) * (MAX_HEIGHT / TILE_SIZE) / 32];
88   float clear_color[4];  /**< for color bufs */
89   uint clear_val;        /**< for z+stencil, or packed color clear value */
90   boolean depth_stencil; /**< Is the surface a depth/stencil format? */
91
92   struct softpipe_cached_tile tile;  /**< scratch tile for clears */
93
94   struct softpipe_cached_tile *last_tile;  /**< most recently retrieved tile */
95};
96
97
98extern struct softpipe_tile_cache *
99sp_create_tile_cache( struct pipe_context *pipe );
100
101extern void
102sp_destroy_tile_cache(struct softpipe_tile_cache *tc);
103
104extern void
105sp_tile_cache_set_surface(struct softpipe_tile_cache *tc,
106                          struct pipe_surface *sps);
107
108extern struct pipe_surface *
109sp_tile_cache_get_surface(struct softpipe_tile_cache *tc);
110
111extern void
112sp_tile_cache_map_transfers(struct softpipe_tile_cache *tc);
113
114extern void
115sp_tile_cache_unmap_transfers(struct softpipe_tile_cache *tc);
116
117extern void
118sp_flush_tile_cache(struct softpipe_tile_cache *tc);
119
120extern void
121sp_tile_cache_clear(struct softpipe_tile_cache *tc, const float *rgba,
122                    uint clearValue);
123
124extern struct softpipe_cached_tile *
125sp_find_cached_tile(struct softpipe_tile_cache *tc,
126                    union tile_address addr );
127
128
129static INLINE union tile_address
130tile_address( unsigned x,
131              unsigned y )
132{
133   union tile_address addr;
134
135   addr.value = 0;
136   addr.bits.x = x / TILE_SIZE;
137   addr.bits.y = y / TILE_SIZE;
138
139   return addr;
140}
141
142/* Quickly retrieve tile if it matches last lookup.
143 */
144static INLINE struct softpipe_cached_tile *
145sp_get_cached_tile(struct softpipe_tile_cache *tc,
146                   int x, int y )
147{
148   union tile_address addr = tile_address( x, y );
149
150   if (tc->last_tile->addr.value == addr.value)
151      return tc->last_tile;
152
153   return sp_find_cached_tile( tc, addr );
154}
155
156
157
158
159#endif /* SP_TILE_CACHE_H */
160
161