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
37 enum 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 */
46 enum 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
55 struct pipe_context;
56 struct pipe_screen;
57 struct llvmpipe_context;
58
59 struct 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 */
71 struct 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 */
85 struct 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 #ifdef DEBUG
124 /** for linked list */
125 struct llvmpipe_resource *prev, *next;
126 #endif
127 };
128
129
130 struct llvmpipe_transfer
131 {
132 struct pipe_transfer base;
133
134 unsigned long offset;
135 };
136
137
138 /** cast wrappers */
139 static INLINE struct llvmpipe_resource *
llvmpipe_resource(struct pipe_resource * pt)140 llvmpipe_resource(struct pipe_resource *pt)
141 {
142 return (struct llvmpipe_resource *) pt;
143 }
144
145
146 static INLINE const struct llvmpipe_resource *
llvmpipe_resource_const(const struct pipe_resource * pt)147 llvmpipe_resource_const(const struct pipe_resource *pt)
148 {
149 return (const struct llvmpipe_resource *) pt;
150 }
151
152
153 static INLINE struct llvmpipe_transfer *
llvmpipe_transfer(struct pipe_transfer * pt)154 llvmpipe_transfer(struct pipe_transfer *pt)
155 {
156 return (struct llvmpipe_transfer *) pt;
157 }
158
159
160 void llvmpipe_init_screen_resource_funcs(struct pipe_screen *screen);
161 void llvmpipe_init_context_resource_funcs(struct pipe_context *pipe);
162
163 static INLINE unsigned
llvmpipe_resource_stride(struct pipe_resource * resource,unsigned level)164 llvmpipe_resource_stride(struct pipe_resource *resource,
165 unsigned level)
166 {
167 struct llvmpipe_resource *lpr = llvmpipe_resource(resource);
168 assert(level < LP_MAX_TEXTURE_2D_LEVELS);
169 return lpr->row_stride[level];
170 }
171
172
173 void *
174 llvmpipe_resource_map(struct pipe_resource *resource,
175 unsigned level,
176 unsigned layer,
177 enum lp_texture_usage tex_usage,
178 enum lp_texture_layout layout);
179
180 void
181 llvmpipe_resource_unmap(struct pipe_resource *resource,
182 unsigned level,
183 unsigned layer);
184
185
186 void *
187 llvmpipe_resource_data(struct pipe_resource *resource);
188
189
190 unsigned
191 llvmpipe_resource_size(const struct pipe_resource *resource);
192
193
194 ubyte *
195 llvmpipe_get_texture_image_address(struct llvmpipe_resource *lpr,
196 unsigned face_slice, unsigned level,
197 enum lp_texture_layout layout);
198
199 void *
200 llvmpipe_get_texture_image(struct llvmpipe_resource *resource,
201 unsigned face_slice, unsigned level,
202 enum lp_texture_usage usage,
203 enum lp_texture_layout layout);
204
205 void *
206 llvmpipe_get_texture_image_all(struct llvmpipe_resource *lpr,
207 unsigned level,
208 enum lp_texture_usage usage,
209 enum lp_texture_layout layout);
210
211 ubyte *
212 llvmpipe_get_texture_tile_linear(struct llvmpipe_resource *lpr,
213 unsigned face_slice, unsigned level,
214 enum lp_texture_usage usage,
215 unsigned x, unsigned y);
216
217 ubyte *
218 llvmpipe_get_texture_tile(struct llvmpipe_resource *lpr,
219 unsigned face_slice, unsigned level,
220 enum lp_texture_usage usage,
221 unsigned x, unsigned y);
222
223
224 void
225 llvmpipe_unswizzle_cbuf_tile(struct llvmpipe_resource *lpr,
226 unsigned face_slice, unsigned level,
227 unsigned x, unsigned y,
228 uint8_t *tile);
229
230 void
231 llvmpipe_swizzle_cbuf_tile(struct llvmpipe_resource *lpr,
232 unsigned face_slice, unsigned level,
233 unsigned x, unsigned y,
234 uint8_t *tile);
235
236 extern void
237 llvmpipe_print_resources(void);
238
239
240 extern void
241 llvmpipe_init_screen_texture_funcs(struct pipe_screen *screen);
242
243 extern void
244 llvmpipe_init_context_texture_funcs(struct pipe_context *pipe);
245
246
247 #define LP_UNREFERENCED 0
248 #define LP_REFERENCED_FOR_READ (1 << 0)
249 #define LP_REFERENCED_FOR_WRITE (1 << 1)
250
251 unsigned int
252 llvmpipe_is_resource_referenced( struct pipe_context *pipe,
253 struct pipe_resource *presource,
254 unsigned level, int layer);
255
256 #endif /* LP_TEXTURE_H */
257