src/mesa/drivers/dri/radeon/radeon_mipmap_tree.h

   1 /*
   2  * Copyright (C) 2008 Nicolai Haehnle.
   3  *
   4  * All Rights Reserved.
   5  *
   6  * Permission is hereby granted, free of charge, to any person obtaining
   7  * a 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, sublicense, 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
  16  * portions of the Software.
  17  *
  18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
  19  * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  20  * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
  21  * IN NO EVENT SHALL THE COPYRIGHT OWNER(S) AND/OR ITS SUPPLIERS BE
  22  * LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
  23  * OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
  24  * WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  25  *
  26  */
  27
  28 #ifndef __RADEON_MIPMAP_TREE_H_
  29 #define __RADEON_MIPMAP_TREE_H_
  30
  31 #include "radeon_common.h"
  32
  33 typedef struct _radeon_mipmap_tree radeon_mipmap_tree;
  34 typedef struct _radeon_mipmap_level radeon_mipmap_level;
  35 typedef struct _radeon_mipmap_image radeon_mipmap_image;
  36
  37 struct _radeon_mipmap_image {
  38         GLuint offset; /** Offset of this image from the start of mipmap tree buffer, in bytes */
  39 };
  40
  41 struct _radeon_mipmap_level {
  42         GLuint width;
  43         GLuint height;
  44         GLuint depth;
  45         GLuint size; /** Size of each image, in bytes */
  46         GLuint rowstride; /** in bytes */
  47         radeon_mipmap_image faces[6];
  48 };
  49
  50 /* store the max possible in the miptree */
  51 #define RADEON_MIPTREE_MAX_TEXTURE_LEVELS 13
  52
  53 /**
  54  * A mipmap tree contains texture images in the layout that the hardware
  55  * expects.
  56  *
  57  * The meta-data of mipmap trees is immutable, i.e. you cannot change the
  58  * layout on-the-fly; however, the texture contents (i.e. texels) can be
  59  * changed.
  60  */
  61 struct _radeon_mipmap_tree {
  62         radeonContextPtr radeon;
  63         radeonTexObj *t;
  64         struct radeon_bo *bo;
  65         GLuint refcount;
  66
  67         GLuint totalsize; /** total size of the miptree, in bytes */
  68
  69         GLenum target; /** GL_TEXTURE_xxx */
  70         GLenum internal_format;
  71         GLuint faces; /** # of faces: 6 for cubemaps, 1 otherwise */
  72         GLuint firstLevel; /** First mip level stored in this mipmap tree */
  73         GLuint lastLevel; /** Last mip level stored in this mipmap tree */
  74
  75         GLuint width0; /** Width of firstLevel image */
  76         GLuint height0; /** Height of firstLevel image */
  77         GLuint depth0; /** Depth of firstLevel image */
  78
  79         GLuint bpp; /** Bytes per texel */
  80         GLuint tilebits; /** RADEON_TXO_xxx_TILE */
  81         GLuint compressed; /** MESA_FORMAT_xxx indicating a compressed format, or 0 if uncompressed */
  82
  83         radeon_mipmap_level levels[RADEON_MIPTREE_MAX_TEXTURE_LEVELS];
  84 };
  85
  86 radeon_mipmap_tree* radeon_miptree_create(radeonContextPtr rmesa, radeonTexObj *t,
  87                 GLenum target, GLenum internal_format, GLuint firstLevel, GLuint lastLevel,
  88                 GLuint width0, GLuint height0, GLuint depth0,
  89                 GLuint bpp, GLuint tilebits, GLuint compressed);
  90 void radeon_miptree_reference(radeon_mipmap_tree *mt);
  91 void radeon_miptree_unreference(radeon_mipmap_tree *mt);
  92
  93 GLboolean radeon_miptree_matches_image(radeon_mipmap_tree *mt,
  94                 struct gl_texture_image *texImage, GLuint face, GLuint level);
  95 GLboolean radeon_miptree_matches_texture(radeon_mipmap_tree *mt, struct gl_texture_object *texObj);
  96 void radeon_try_alloc_miptree(radeonContextPtr rmesa, radeonTexObj *t,
  97                               radeon_texture_image *texImage, GLuint face, GLuint level);
  98 GLuint radeon_miptree_image_offset(radeon_mipmap_tree *mt,
  99                                    GLuint face, GLuint level);
 100 void radeon_miptree_depth_offsets(radeon_mipmap_tree *mt, GLuint level, GLuint *offsets);
 101 #endif /* __RADEON_MIPMAP_TREE_H_ */