lp_texture.h revision 1db3a55b9c59093f7bf4df39579287eeb0cf0a2b
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 LP_TEXTURE_H 29#define LP_TEXTURE_H 30 31 32#include "pipe/p_state.h" 33#include "util/u_debug.h" 34#include "lp_limits.h" 35 36 37enum lp_texture_usage 38{ 39 LP_TEX_USAGE_READ = 100, 40 LP_TEX_USAGE_READ_WRITE, 41 LP_TEX_USAGE_WRITE_ALL 42}; 43 44 45/** Per-tile layout mode */ 46enum lp_texture_layout 47{ 48 LP_TEX_LAYOUT_NONE = 0, /**< no layout for the tile data yet */ 49 LP_TEX_LAYOUT_TILED, /**< the tile data is in tiled layout */ 50 LP_TEX_LAYOUT_LINEAR, /**< the tile data is in linear layout */ 51 LP_TEX_LAYOUT_BOTH /**< the tile data is in both modes */ 52}; 53 54 55struct pipe_context; 56struct pipe_screen; 57struct llvmpipe_context; 58 59struct sw_displaytarget; 60 61 62/** 63 * We keep one or two copies of the texture image data: one in a simple 64 * linear layout (for texture sampling) and another in a tiled layout (for 65 * render targets). We keep track of whether each image tile is linear 66 * or tiled on a per-tile basis. 67 */ 68 69 70/** A 1D/2D/3D image, one mipmap level */ 71struct llvmpipe_texture_image 72{ 73 void *data; 74}; 75 76 77/** 78 * llvmpipe subclass of pipe_resource. A texture, drawing surface, 79 * vertex buffer, const buffer, etc. 80 * Textures are stored differently than othere types of objects such as 81 * vertex buffers and const buffers. 82 * The former are tiled and have per-tile layout flags. 83 * The later are simple malloc'd blocks of memory. 84 */ 85struct llvmpipe_resource 86{ 87 struct pipe_resource base; 88 89 /** Row stride in bytes */ 90 unsigned row_stride[LP_MAX_TEXTURE_LEVELS]; 91 /** Image stride (for cube maps or 3D textures) in bytes */ 92 unsigned img_stride[LP_MAX_TEXTURE_LEVELS]; 93 unsigned tiles_per_row[LP_MAX_TEXTURE_LEVELS]; 94 unsigned tiles_per_image[LP_MAX_TEXTURE_LEVELS]; 95 /** Number of 3D slices or cube faces per level */ 96 unsigned num_slices_faces[LP_MAX_TEXTURE_LEVELS]; 97 98 /** 99 * Display target, for textures with the PIPE_BIND_DISPLAY_TARGET 100 * usage. 101 */ 102 struct sw_displaytarget *dt; 103 104 /** 105 * Malloc'ed data for regular textures, or a mapping to dt above. 106 */ 107 struct llvmpipe_texture_image tiled[LP_MAX_TEXTURE_LEVELS]; 108 struct llvmpipe_texture_image linear[LP_MAX_TEXTURE_LEVELS]; 109 110 /** 111 * Data for non-texture resources. 112 */ 113 void *data; 114 115 /** array [level][face or slice][tile_y][tile_x] of layout values) */ 116 enum lp_texture_layout *layout[LP_MAX_TEXTURE_LEVELS]; 117 118 boolean userBuffer; /** Is this a user-space buffer? */ 119 unsigned timestamp; 120 121 unsigned id; /**< temporary, for debugging */ 122}; 123 124 125struct llvmpipe_transfer 126{ 127 struct pipe_transfer base; 128 129 unsigned long offset; 130}; 131 132 133/** cast wrappers */ 134static INLINE struct llvmpipe_resource * 135llvmpipe_resource(struct pipe_resource *pt) 136{ 137 return (struct llvmpipe_resource *) pt; 138} 139 140 141static INLINE const struct llvmpipe_resource * 142llvmpipe_resource_const(const struct pipe_resource *pt) 143{ 144 return (const struct llvmpipe_resource *) pt; 145} 146 147 148static INLINE struct llvmpipe_transfer * 149llvmpipe_transfer(struct pipe_transfer *pt) 150{ 151 return (struct llvmpipe_transfer *) pt; 152} 153 154 155void llvmpipe_init_screen_resource_funcs(struct pipe_screen *screen); 156void llvmpipe_init_context_resource_funcs(struct pipe_context *pipe); 157 158static INLINE unsigned 159llvmpipe_resource_stride(struct pipe_resource *resource, 160 unsigned level) 161{ 162 struct llvmpipe_resource *lpr = llvmpipe_resource(resource); 163 assert(level < LP_MAX_TEXTURE_2D_LEVELS); 164 return lpr->row_stride[level]; 165} 166 167 168void * 169llvmpipe_resource_map(struct pipe_resource *resource, 170 unsigned face_slice, 171 unsigned level, 172 unsigned zslice, 173 enum lp_texture_usage tex_usage, 174 enum lp_texture_layout layout); 175 176void 177llvmpipe_resource_unmap(struct pipe_resource *resource, 178 unsigned face_slice, 179 unsigned level, 180 unsigned zslice); 181 182 183void * 184llvmpipe_resource_data(struct pipe_resource *resource); 185 186 187unsigned 188llvmpipe_resource_size(const struct pipe_resource *resource); 189 190 191ubyte * 192llvmpipe_get_texture_image_address(struct llvmpipe_resource *lpr, 193 unsigned face_slice, unsigned level, 194 enum lp_texture_layout layout); 195 196void * 197llvmpipe_get_texture_image(struct llvmpipe_resource *resource, 198 unsigned face_slice, unsigned level, 199 enum lp_texture_usage usage, 200 enum lp_texture_layout layout); 201 202void * 203llvmpipe_get_texture_image_all(struct llvmpipe_resource *lpr, 204 unsigned level, 205 enum lp_texture_usage usage, 206 enum lp_texture_layout layout); 207 208ubyte * 209llvmpipe_get_texture_tile_linear(struct llvmpipe_resource *lpr, 210 unsigned face_slice, unsigned level, 211 enum lp_texture_usage usage, 212 unsigned x, unsigned y); 213 214ubyte * 215llvmpipe_get_texture_tile(struct llvmpipe_resource *lpr, 216 unsigned face_slice, unsigned level, 217 enum lp_texture_usage usage, 218 unsigned x, unsigned y); 219 220 221 222extern void 223llvmpipe_init_screen_texture_funcs(struct pipe_screen *screen); 224 225extern void 226llvmpipe_init_context_texture_funcs(struct pipe_context *pipe); 227 228#endif /* LP_TEXTURE_H */ 229