src/gallium/drivers/softpipe/sp_tex_tile_cache.c

   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 /**
  29  * Texture tile caching.
  30  *
  31  * Author:
  32  *    Brian Paul
  33  */
  34
  35 #include "util/u_inlines.h"
  36 #include "util/u_memory.h"
  37 #include "util/u_tile.h"
  38 #include "util/u_math.h"
  39 #include "sp_context.h"
  40 #include "sp_texture.h"
  41 #include "sp_tex_tile_cache.h"
  42
  43
  44
  45 struct softpipe_tex_tile_cache *
  46 sp_create_tex_tile_cache( struct pipe_context *pipe )
  47 {
  48    struct softpipe_tex_tile_cache *tc;
  49    uint pos;
  50
  51    tc = CALLOC_STRUCT( softpipe_tex_tile_cache );
  52    if (tc) {
  53       tc->pipe = pipe;
  54       for (pos = 0; pos < NUM_ENTRIES; pos++) {
  55          tc->entries[pos].addr.bits.invalid = 1;
  56       }
  57       tc->last_tile = &tc->entries[0]; /* any tile */
  58    }
  59    return tc;
  60 }
  61
  62
  63 void
  64 sp_destroy_tex_tile_cache(struct softpipe_tex_tile_cache *tc)
  65 {
  66    uint pos;
  67
  68    for (pos = 0; pos < NUM_ENTRIES; pos++) {
  69       /*assert(tc->entries[pos].x < 0);*/
  70    }
  71    if (tc->transfer) {
  72       tc->pipe->tex_transfer_destroy(tc->pipe, tc->transfer);
  73    }
  74    if (tc->tex_trans) {
  75       tc->pipe->tex_transfer_destroy(tc->pipe, tc->tex_trans);
  76    }
  77
  78    FREE( tc );
  79 }
  80
  81
  82
  83
  84 void
  85 sp_tex_tile_cache_map_transfers(struct softpipe_tex_tile_cache *tc)
  86 {
  87    if (tc->tex_trans && !tc->tex_trans_map)
  88       tc->tex_trans_map = tc->pipe->transfer_map(tc->pipe, tc->tex_trans);
  89 }
  90
  91
  92 void
  93 sp_tex_tile_cache_unmap_transfers(struct softpipe_tex_tile_cache *tc)
  94 {
  95    if (tc->tex_trans_map) {
  96       tc->pipe->transfer_unmap(tc->pipe, tc->tex_trans);
  97       tc->tex_trans_map = NULL;
  98    }
  99 }
 100
 101 /**
 102  * Invalidate all cached tiles for the cached texture.
 103  * Should be called when the texture is modified.
 104  */
 105 void
 106 sp_tex_tile_cache_validate_texture(struct softpipe_tex_tile_cache *tc)
 107 {
 108    unsigned i;
 109
 110    assert(tc);
 111    assert(tc->texture);
 112
 113    for (i = 0; i < NUM_ENTRIES; i++) {
 114       tc->entries[i].addr.bits.invalid = 1;
 115    }
 116 }
 117
 118 /**
 119  * Specify the texture to cache.
 120  */
 121 void
 122 sp_tex_tile_cache_set_texture(struct softpipe_tex_tile_cache *tc,
 123                           struct pipe_texture *texture)
 124 {
 125    uint i;
 126
 127    assert(!tc->transfer);
 128
 129    if (tc->texture != texture) {
 130       pipe_texture_reference(&tc->texture, texture);
 131
 132       if (tc->tex_trans) {
 133          if (tc->tex_trans_map) {
 134             tc->pipe->transfer_unmap(tc->pipe, tc->tex_trans);
 135             tc->tex_trans_map = NULL;
 136          }
 137
 138          tc->pipe->tex_transfer_destroy(tc->pipe, tc->tex_trans);
 139          tc->tex_trans = NULL;
 140       }
 141
 142       /* mark as entries as invalid/empty */
 143       /* XXX we should try to avoid this when the teximage hasn't changed */
 144       for (i = 0; i < NUM_ENTRIES; i++) {
 145          tc->entries[i].addr.bits.invalid = 1;
 146       }
 147
 148       tc->tex_face = -1; /* any invalid value here */
 149    }
 150 }
 151
 152
 153
 154
 155 /**
 156  * Flush the tile cache: write all dirty tiles back to the transfer.
 157  * any tiles "flagged" as cleared will be "really" cleared.
 158  */
 159 void
 160 sp_flush_tex_tile_cache(struct softpipe_tex_tile_cache *tc)
 161 {
 162    int pos;
 163
 164    if (tc->texture) {
 165       /* caching a texture, mark all entries as empty */
 166       for (pos = 0; pos < NUM_ENTRIES; pos++) {
 167          tc->entries[pos].addr.bits.invalid = 1;
 168       }
 169       tc->tex_face = -1;
 170    }
 171
 172 }
 173
 174
 175 /**
 176  * Given the texture face, level, zslice, x and y values, compute
 177  * the cache entry position/index where we'd hope to find the
 178  * cached texture tile.
 179  * This is basically a direct-map cache.
 180  * XXX There's probably lots of ways in which we can improve this.
 181  */
 182 static INLINE uint
 183 tex_cache_pos( union tex_tile_address addr )
 184 {
 185    uint entry = (addr.bits.x +
 186                  addr.bits.y * 9 +
 187                  addr.bits.z * 3 +
 188                  addr.bits.face +
 189                  addr.bits.level * 7);
 190
 191    return entry % NUM_ENTRIES;
 192 }
 193
 194 /**
 195  * Similar to sp_get_cached_tile() but for textures.
 196  * Tiles are read-only and indexed with more params.
 197  */
 198 const struct softpipe_tex_cached_tile *
 199 sp_find_cached_tile_tex(struct softpipe_tex_tile_cache *tc,
 200                         union tex_tile_address addr )
 201 {
 202    struct softpipe_tex_cached_tile *tile;
 203
 204    tile = tc->entries + tex_cache_pos( addr );
 205
 206    if (addr.value != tile->addr.value) {
 207
 208       /* cache miss.  Most misses are because we've invaldiated the
 209        * texture cache previously -- most commonly on binding a new
 210        * texture.  Currently we effectively flush the cache on texture
 211        * bind.
 212        */
 213 #if 0
 214       _debug_printf("miss at %u:  x=%d y=%d z=%d face=%d level=%d\n"
 215                     "   tile %u:  x=%d y=%d z=%d face=%d level=%d\n",
 216                     pos, x/TILE_SIZE, y/TILE_SIZE, z, face, level,
 217                     pos, tile->addr.bits.x, tile->addr.bits.y, tile->z, tile->face, tile->level);
 218 #endif
 219
 220       /* check if we need to get a new transfer */
 221       if (!tc->tex_trans ||
 222           tc->tex_face != addr.bits.face ||
 223           tc->tex_level != addr.bits.level ||
 224           tc->tex_z != addr.bits.z) {
 225          /* get new transfer (view into texture) */
 226
 227          if (tc->tex_trans) {
 228             if (tc->tex_trans_map) {
 229                tc->pipe->transfer_unmap(tc->pipe, tc->tex_trans);
 230                tc->tex_trans_map = NULL;
 231             }
 232
 233             tc->pipe->tex_transfer_destroy(tc->pipe, tc->tex_trans);
 234             tc->tex_trans = NULL;
 235          }
 236
 237          tc->tex_trans =
 238             tc->pipe->get_tex_transfer(tc->pipe, tc->texture,
 239                                      addr.bits.face,
 240                                      addr.bits.level,
 241                                      addr.bits.z,
 242                                      PIPE_TRANSFER_READ, 0, 0,
 243                                      u_minify(tc->texture->width0, addr.bits.level),
 244                                      u_minify(tc->texture->height0, addr.bits.level));
 245
 246          tc->tex_trans_map = tc->pipe->transfer_map(tc->pipe, tc->tex_trans);
 247
 248          tc->tex_face = addr.bits.face;
 249          tc->tex_level = addr.bits.level;
 250          tc->tex_z = addr.bits.z;
 251       }
 252
 253       /* get tile from the transfer (view into texture) */
 254       pipe_get_tile_rgba(tc->pipe,
 255                          tc->tex_trans,
 256                          addr.bits.x * TILE_SIZE,
 257                          addr.bits.y * TILE_SIZE,
 258                          TILE_SIZE, TILE_SIZE,
 259                          (float *) tile->data.color);
 260       tile->addr = addr;
 261    }
 262
 263    tc->last_tile = tile;
 264    return tile;
 265 }
 266
 267
 268