1 /**************************************************************************
3 * Copyright 2007 VMware, Inc.
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:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
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 VMWARE 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.
26 **************************************************************************/
30 #include "st_context.h"
31 #include "st_format.h"
32 #include "st_texture.h"
33 #include "st_cb_fbo.h"
34 #include "main/enums.h"
36 #include "pipe/p_state.h"
37 #include "pipe/p_context.h"
38 #include "pipe/p_defines.h"
39 #include "util/u_inlines.h"
40 #include "util/u_format.h"
41 #include "util/u_rect.h"
42 #include "util/u_math.h"
43 #include "util/u_memory.h"
46 #define DBG if(0) printf
50 * Allocate a new pipe_resource object
51 * width0, height0, depth0 are the dimensions of the level 0 image
52 * (the highest resolution). last_level indicates how many mipmap levels
53 * to allocate storage for. For non-mipmapped textures, this will be zero.
55 struct pipe_resource
*
56 st_texture_create(struct st_context
*st
,
57 enum pipe_texture_target target
,
58 enum pipe_format format
,
67 struct pipe_resource pt
, *newtex
;
68 struct pipe_screen
*screen
= st
->pipe
->screen
;
70 assert(target
< PIPE_MAX_TEXTURE_TYPES
);
74 if (target
== PIPE_TEXTURE_CUBE
)
77 DBG("%s target %d format %s last_level %d\n", __FUNCTION__
,
78 (int) target
, util_format_name(format
), last_level
);
81 assert(screen
->is_format_supported(screen
, format
, target
, 0,
82 PIPE_BIND_SAMPLER_VIEW
));
84 memset(&pt
, 0, sizeof(pt
));
87 pt
.last_level
= last_level
;
91 pt
.array_size
= (target
== PIPE_TEXTURE_CUBE
? 6 : layers
);
92 pt
.usage
= PIPE_USAGE_DEFAULT
;
95 pt
.nr_samples
= nr_samples
;
97 newtex
= screen
->resource_create(screen
, &pt
);
99 assert(!newtex
|| pipe_is_referenced(&newtex
->reference
));
106 * In OpenGL the number of 1D array texture layers is the "height" and
107 * the number of 2D array texture layers is the "depth". In Gallium the
108 * number of layers in an array texture is a separate 'array_size' field.
109 * This function converts dimensions from the former to the later.
112 st_gl_texture_dims_to_pipe_dims(GLenum texture
,
123 case GL_PROXY_TEXTURE_1D
:
124 assert(heightIn
== 1);
125 assert(depthIn
== 1);
131 case GL_TEXTURE_1D_ARRAY
:
132 case GL_PROXY_TEXTURE_1D_ARRAY
:
133 assert(depthIn
== 1);
137 *layersOut
= heightIn
;
140 case GL_PROXY_TEXTURE_2D
:
141 case GL_TEXTURE_RECTANGLE
:
142 case GL_PROXY_TEXTURE_RECTANGLE
:
143 case GL_TEXTURE_EXTERNAL_OES
:
144 case GL_PROXY_TEXTURE_2D_MULTISAMPLE
:
145 case GL_TEXTURE_2D_MULTISAMPLE
:
146 assert(depthIn
== 1);
148 *heightOut
= heightIn
;
152 case GL_TEXTURE_CUBE_MAP
:
153 case GL_PROXY_TEXTURE_CUBE_MAP
:
154 case GL_TEXTURE_CUBE_MAP_POSITIVE_X
:
155 case GL_TEXTURE_CUBE_MAP_NEGATIVE_X
:
156 case GL_TEXTURE_CUBE_MAP_POSITIVE_Y
:
157 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Y
:
158 case GL_TEXTURE_CUBE_MAP_POSITIVE_Z
:
159 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Z
:
160 assert(depthIn
== 1);
162 *heightOut
= heightIn
;
166 case GL_TEXTURE_2D_ARRAY
:
167 case GL_TEXTURE_2D_MULTISAMPLE_ARRAY
:
168 case GL_PROXY_TEXTURE_2D_ARRAY
:
169 case GL_PROXY_TEXTURE_2D_MULTISAMPLE_ARRAY
:
171 *heightOut
= heightIn
;
173 *layersOut
= depthIn
;
175 case GL_TEXTURE_CUBE_MAP_ARRAY
:
176 case GL_PROXY_TEXTURE_CUBE_MAP_ARRAY
:
178 *heightOut
= heightIn
;
180 *layersOut
= depthIn
;
183 assert(0 && "Unexpected texture in st_gl_texture_dims_to_pipe_dims()");
186 case GL_PROXY_TEXTURE_3D
:
188 *heightOut
= heightIn
;
197 * Check if a texture image can be pulled into a unified mipmap texture.
200 st_texture_match_image(struct st_context
*st
,
201 const struct pipe_resource
*pt
,
202 const struct gl_texture_image
*image
)
204 GLuint ptWidth
, ptHeight
, ptDepth
, ptLayers
;
206 /* Images with borders are never pulled into mipmap textures.
211 /* Check if this image's format matches the established texture's format.
213 if (st_mesa_format_to_pipe_format(st
, image
->TexFormat
) != pt
->format
)
216 st_gl_texture_dims_to_pipe_dims(image
->TexObject
->Target
,
217 image
->Width
, image
->Height
, image
->Depth
,
218 &ptWidth
, &ptHeight
, &ptDepth
, &ptLayers
);
220 /* Test if this image's size matches what's expected in the
221 * established texture.
223 if (ptWidth
!= u_minify(pt
->width0
, image
->Level
) ||
224 ptHeight
!= u_minify(pt
->height0
, image
->Level
) ||
225 ptDepth
!= u_minify(pt
->depth0
, image
->Level
) ||
226 ptLayers
!= pt
->array_size
)
234 * Map a texture image and return the address for a particular 2D face/slice/
235 * layer. The stImage indicates the cube face and mipmap level. The slice
236 * of the 3D texture is passed in 'zoffset'.
237 * \param usage one of the PIPE_TRANSFER_x values
238 * \param x, y, w, h the region of interest of the 2D image.
239 * \return address of mapping or NULL if any error
242 st_texture_image_map(struct st_context
*st
, struct st_texture_image
*stImage
,
243 enum pipe_transfer_usage usage
,
244 GLuint x
, GLuint y
, GLuint z
,
245 GLuint w
, GLuint h
, GLuint d
,
246 struct pipe_transfer
**transfer
)
248 struct st_texture_object
*stObj
=
249 st_texture_object(stImage
->base
.TexObject
);
253 DBG("%s \n", __FUNCTION__
);
258 if (stObj
->pt
!= stImage
->pt
)
261 level
= stImage
->base
.Level
;
263 if (stObj
->base
.Immutable
) {
264 level
+= stObj
->base
.MinLevel
;
265 z
+= stObj
->base
.MinLayer
;
266 d
= MIN2(d
, stObj
->base
.NumLayers
);
269 z
+= stImage
->base
.Face
;
271 map
= pipe_transfer_map_3d(st
->pipe
, stImage
->pt
, level
, usage
,
272 x
, y
, z
, w
, h
, d
, transfer
);
274 /* Enlarge the transfer array if it's not large enough. */
275 if (z
>= stImage
->num_transfers
) {
276 unsigned new_size
= z
+ 1;
278 stImage
->transfer
= realloc(stImage
->transfer
,
279 new_size
* sizeof(struct st_texture_image_transfer
));
280 memset(&stImage
->transfer
[stImage
->num_transfers
], 0,
281 (new_size
- stImage
->num_transfers
) *
282 sizeof(struct st_texture_image_transfer
));
283 stImage
->num_transfers
= new_size
;
286 assert(!stImage
->transfer
[z
].transfer
);
287 stImage
->transfer
[z
].transfer
= *transfer
;
294 st_texture_image_unmap(struct st_context
*st
,
295 struct st_texture_image
*stImage
, unsigned slice
)
297 struct pipe_context
*pipe
= st
->pipe
;
298 struct st_texture_object
*stObj
=
299 st_texture_object(stImage
->base
.TexObject
);
300 struct pipe_transfer
**transfer
;
302 if (stObj
->base
.Immutable
)
303 slice
+= stObj
->base
.MinLayer
;
304 transfer
= &stImage
->transfer
[slice
+ stImage
->base
.Face
].transfer
;
306 DBG("%s\n", __FUNCTION__
);
308 pipe_transfer_unmap(pipe
, *transfer
);
313 /* Upload data for a particular image.
316 st_texture_image_data(struct st_context
*st
,
317 struct pipe_resource
*dst
,
321 GLuint src_row_stride
, GLuint src_image_stride
)
323 struct pipe_context
*pipe
= st
->pipe
;
325 const GLubyte
*srcUB
= src
;
328 if (dst
->target
== PIPE_TEXTURE_1D_ARRAY
||
329 dst
->target
== PIPE_TEXTURE_2D_ARRAY
||
330 dst
->target
== PIPE_TEXTURE_CUBE_ARRAY
)
331 layers
= dst
->array_size
;
333 layers
= u_minify(dst
->depth0
, level
);
335 DBG("%s\n", __FUNCTION__
);
337 for (i
= 0; i
< layers
; i
++) {
339 u_box_2d_zslice(0, 0, face
+ i
,
340 u_minify(dst
->width0
, level
),
341 u_minify(dst
->height0
, level
),
344 pipe
->transfer_inline_write(pipe
, dst
, level
, PIPE_TRANSFER_WRITE
,
345 &box
, srcUB
, src_row_stride
, 0);
347 srcUB
+= src_image_stride
;
353 * For debug only: get/print center pixel in the src resource.
356 print_center_pixel(struct pipe_context
*pipe
, struct pipe_resource
*src
)
358 struct pipe_transfer
*xfer
;
359 struct pipe_box region
;
362 region
.x
= src
->width0
/ 2;
363 region
.y
= src
->height0
/ 2;
369 map
= pipe
->transfer_map(pipe
, src
, 0, PIPE_TRANSFER_READ
, ®ion
, &xfer
);
371 printf("center pixel: %d %d %d %d\n", map
[0], map
[1], map
[2], map
[3]);
373 pipe
->transfer_unmap(pipe
, xfer
);
378 * Copy the image at level=0 in 'src' to the 'dst' resource at 'dstLevel'.
379 * This is used to copy mipmap images from one texture buffer to another.
380 * This typically happens when our initial guess at the total texture size
381 * is incorrect (see the guess_and_alloc_texture() function).
384 st_texture_image_copy(struct pipe_context
*pipe
,
385 struct pipe_resource
*dst
, GLuint dstLevel
,
386 struct pipe_resource
*src
, GLuint srcLevel
,
389 GLuint width
= u_minify(dst
->width0
, dstLevel
);
390 GLuint height
= u_minify(dst
->height0
, dstLevel
);
391 GLuint depth
= u_minify(dst
->depth0
, dstLevel
);
392 struct pipe_box src_box
;
395 if (u_minify(src
->width0
, srcLevel
) != width
||
396 u_minify(src
->height0
, srcLevel
) != height
||
397 u_minify(src
->depth0
, srcLevel
) != depth
) {
398 /* The source image size doesn't match the destination image size.
399 * This can happen in some degenerate situations such as rendering to a
400 * cube map face which was set up with mismatched texture sizes.
407 src_box
.width
= width
;
408 src_box
.height
= height
;
411 if (src
->target
== PIPE_TEXTURE_1D_ARRAY
||
412 src
->target
== PIPE_TEXTURE_2D_ARRAY
||
413 src
->target
== PIPE_TEXTURE_CUBE_ARRAY
) {
415 depth
= src
->array_size
;
418 /* Loop over 3D image slices */
419 /* could (and probably should) use "true" 3d box here -
420 but drivers can't quite handle it yet */
421 for (i
= face
; i
< face
+ depth
; i
++) {
425 print_center_pixel(pipe
, src
);
428 pipe
->resource_copy_region(pipe
,
431 0, 0, i
,/* destX, Y, Z */
439 struct pipe_resource
*
440 st_create_color_map_texture(struct gl_context
*ctx
)
442 struct st_context
*st
= st_context(ctx
);
443 struct pipe_resource
*pt
;
444 enum pipe_format format
;
445 const uint texSize
= 256; /* simple, and usually perfect */
447 /* find an RGBA texture format */
448 format
= st_choose_format(st
, GL_RGBA
, GL_NONE
, GL_NONE
,
449 PIPE_TEXTURE_2D
, 0, PIPE_BIND_SAMPLER_VIEW
,
452 /* create texture for color map/table */
453 pt
= st_texture_create(st
, PIPE_TEXTURE_2D
, format
, 0,
454 texSize
, texSize
, 1, 1, 0, PIPE_BIND_SAMPLER_VIEW
);
459 * Try to find a matching sampler view for the given context.
460 * If none is found an empty slot is initialized with a
461 * template and returned instead.
463 struct pipe_sampler_view
**
464 st_texture_get_sampler_view(struct st_context
*st
,
465 struct st_texture_object
*stObj
)
467 struct pipe_sampler_view
*used
= NULL
, **free
= NULL
;
470 for (i
= 0; i
< stObj
->num_sampler_views
; ++i
) {
471 struct pipe_sampler_view
**sv
= &stObj
->sampler_views
[i
];
472 /* Is the array entry used ? */
474 /* Yes, check if it's the right one */
475 if ((*sv
)->context
== st
->pipe
)
478 /* Wasn't the right one, but remember it as template */
481 /* Found a free slot, remember that */
486 /* Couldn't find a slot for our context, create a new one */
489 /* Haven't even found a free one, resize the array */
490 GLuint old_size
= stObj
->num_sampler_views
* sizeof(void *);
491 GLuint new_size
= old_size
+ sizeof(void *);
492 stObj
->sampler_views
= REALLOC(stObj
->sampler_views
, old_size
, new_size
);
493 free
= &stObj
->sampler_views
[stObj
->num_sampler_views
++];
497 /* Add just any sampler view to be used as a template */
499 pipe_sampler_view_reference(free
, used
);
505 st_texture_release_sampler_view(struct st_context
*st
,
506 struct st_texture_object
*stObj
)
510 for (i
= 0; i
< stObj
->num_sampler_views
; ++i
) {
511 struct pipe_sampler_view
**sv
= &stObj
->sampler_views
[i
];
513 if (*sv
&& (*sv
)->context
== st
->pipe
) {
514 pipe_sampler_view_reference(sv
, NULL
);
521 st_texture_release_all_sampler_views(struct st_texture_object
*stObj
)
525 for (i
= 0; i
< stObj
->num_sampler_views
; ++i
)
526 pipe_sampler_view_reference(&stObj
->sampler_views
[i
], NULL
);
531 st_texture_free_sampler_views(struct st_texture_object
*stObj
)
534 * We use FREE() here to match REALLOC() above. Both come from
535 * u_memory.h, not imports.h. If we mis-match MALLOC/FREE from
536 * those two headers we can trash the heap.
538 FREE(stObj
->sampler_views
);