1 /**************************************************************************
3 * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
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 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.
26 **************************************************************************/
28 #include "main/mfeatures.h"
29 #include "main/bufferobj.h"
30 #include "main/enums.h"
31 #include "main/fbobject.h"
32 #include "main/formats.h"
33 #include "main/image.h"
34 #include "main/imports.h"
35 #include "main/macros.h"
36 #include "main/mipmap.h"
37 #include "main/pack.h"
39 #include "main/pixeltransfer.h"
40 #include "main/texcompress.h"
41 #include "main/texgetimage.h"
42 #include "main/teximage.h"
43 #include "main/texobj.h"
44 #include "main/texstore.h"
46 #include "state_tracker/st_debug.h"
47 #include "state_tracker/st_context.h"
48 #include "state_tracker/st_cb_fbo.h"
49 #include "state_tracker/st_cb_flush.h"
50 #include "state_tracker/st_cb_texture.h"
51 #include "state_tracker/st_format.h"
52 #include "state_tracker/st_texture.h"
53 #include "state_tracker/st_gen_mipmap.h"
54 #include "state_tracker/st_atom.h"
56 #include "pipe/p_context.h"
57 #include "pipe/p_defines.h"
58 #include "util/u_inlines.h"
59 #include "pipe/p_shader_tokens.h"
60 #include "util/u_tile.h"
61 #include "util/u_blit.h"
62 #include "util/u_format.h"
63 #include "util/u_surface.h"
64 #include "util/u_sampler.h"
65 #include "util/u_math.h"
66 #include "util/u_box.h"
68 #define DBG if (0) printf
71 static enum pipe_texture_target
72 gl_target_to_pipe(GLenum target)
76 return PIPE_TEXTURE_1D;
78 case GL_TEXTURE_EXTERNAL_OES:
79 return PIPE_TEXTURE_2D;
80 case GL_TEXTURE_RECTANGLE_NV:
81 return PIPE_TEXTURE_RECT;
83 return PIPE_TEXTURE_3D;
84 case GL_TEXTURE_CUBE_MAP_ARB:
85 return PIPE_TEXTURE_CUBE;
86 case GL_TEXTURE_1D_ARRAY_EXT:
87 return PIPE_TEXTURE_1D_ARRAY;
88 case GL_TEXTURE_2D_ARRAY_EXT:
89 return PIPE_TEXTURE_2D_ARRAY;
90 case GL_TEXTURE_BUFFER:
99 /** called via ctx->Driver.NewTextureImage() */
100 static struct gl_texture_image *
101 st_NewTextureImage(struct gl_context * ctx)
103 DBG("%s\n", __FUNCTION__);
105 return (struct gl_texture_image *) ST_CALLOC_STRUCT(st_texture_image);
109 /** called via ctx->Driver.DeleteTextureImage() */
111 st_DeleteTextureImage(struct gl_context * ctx, struct gl_texture_image *img)
113 /* nothing special (yet) for st_texture_image */
114 _mesa_delete_texture_image(ctx, img);
118 /** called via ctx->Driver.NewTextureObject() */
119 static struct gl_texture_object *
120 st_NewTextureObject(struct gl_context * ctx, GLuint name, GLenum target)
122 struct st_texture_object *obj = ST_CALLOC_STRUCT(st_texture_object);
124 DBG("%s\n", __FUNCTION__);
125 _mesa_initialize_texture_object(&obj->base, name, target);
130 /** called via ctx->Driver.DeleteTextureObject() */
132 st_DeleteTextureObject(struct gl_context *ctx,
133 struct gl_texture_object *texObj)
135 struct st_context *st = st_context(ctx);
136 struct st_texture_object *stObj = st_texture_object(texObj);
138 pipe_resource_reference(&stObj->pt, NULL);
139 if (stObj->sampler_view) {
140 pipe_sampler_view_release(st->pipe, &stObj->sampler_view);
142 _mesa_delete_texture_object(ctx, texObj);
146 /** called via ctx->Driver.FreeTextureImageBuffer() */
148 st_FreeTextureImageBuffer(struct gl_context *ctx,
149 struct gl_texture_image *texImage)
151 struct st_texture_image *stImage = st_texture_image(texImage);
153 DBG("%s\n", __FUNCTION__);
156 pipe_resource_reference(&stImage->pt, NULL);
159 if (stImage->TexData) {
160 _mesa_align_free(stImage->TexData);
161 stImage->TexData = NULL;
166 /** called via ctx->Driver.MapTextureImage() */
168 st_MapTextureImage(struct gl_context *ctx,
169 struct gl_texture_image *texImage,
170 GLuint slice, GLuint x, GLuint y, GLuint w, GLuint h,
172 GLubyte **mapOut, GLint *rowStrideOut)
174 struct st_context *st = st_context(ctx);
175 struct st_texture_image *stImage = st_texture_image(texImage);
180 if (mode & GL_MAP_READ_BIT)
181 pipeMode |= PIPE_TRANSFER_READ;
182 if (mode & GL_MAP_WRITE_BIT)
183 pipeMode |= PIPE_TRANSFER_WRITE;
184 if (mode & GL_MAP_INVALIDATE_RANGE_BIT)
185 pipeMode |= PIPE_TRANSFER_DISCARD_RANGE;
187 map = st_texture_image_map(st, stImage, slice, pipeMode, x, y, w, h);
190 *rowStrideOut = stImage->transfer->stride;
199 /** called via ctx->Driver.UnmapTextureImage() */
201 st_UnmapTextureImage(struct gl_context *ctx,
202 struct gl_texture_image *texImage,
205 struct st_context *st = st_context(ctx);
206 struct st_texture_image *stImage = st_texture_image(texImage);
207 st_texture_image_unmap(st, stImage);
212 * Return default texture resource binding bitmask for the given format.
215 default_bindings(struct st_context *st, enum pipe_format format)
217 struct pipe_screen *screen = st->pipe->screen;
218 const unsigned target = PIPE_TEXTURE_2D;
221 if (util_format_is_depth_or_stencil(format))
222 bindings = PIPE_BIND_SAMPLER_VIEW | PIPE_BIND_DEPTH_STENCIL;
224 bindings = PIPE_BIND_SAMPLER_VIEW | PIPE_BIND_RENDER_TARGET;
226 if (screen->is_format_supported(screen, format, target, 0, bindings))
230 format = util_format_linear(format);
232 if (screen->is_format_supported(screen, format, target, 0, bindings))
235 return PIPE_BIND_SAMPLER_VIEW;
240 /** Return number of image dimensions (1, 2 or 3) for a texture target. */
242 get_texture_dims(GLenum target)
246 case GL_TEXTURE_1D_ARRAY_EXT:
247 case GL_TEXTURE_BUFFER:
250 case GL_TEXTURE_CUBE_MAP_ARB:
251 case GL_TEXTURE_CUBE_MAP_POSITIVE_X_ARB:
252 case GL_TEXTURE_CUBE_MAP_NEGATIVE_X_ARB:
253 case GL_TEXTURE_CUBE_MAP_POSITIVE_Y_ARB:
254 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Y_ARB:
255 case GL_TEXTURE_CUBE_MAP_POSITIVE_Z_ARB:
256 case GL_TEXTURE_CUBE_MAP_NEGATIVE_Z_ARB:
257 case GL_TEXTURE_RECTANGLE_NV:
258 case GL_TEXTURE_2D_ARRAY_EXT:
259 case GL_TEXTURE_EXTERNAL_OES:
264 assert(0 && "invalid texture target in get_texture_dims()");
271 * Given the size of a mipmap image, try to compute the size of the level=0
274 * Note that this isn't always accurate for odd-sized, non-POW textures.
275 * For example, if level=1 and width=40 then the level=0 width may be 80 or 81.
277 * \return GL_TRUE for success, GL_FALSE for failure
280 guess_base_level_size(GLenum target,
281 GLuint width, GLuint height, GLuint depth, GLuint level,
282 GLuint *width0, GLuint *height0, GLuint *depth0)
284 const GLuint dims = get_texture_dims(target);
291 /* Depending on the image's size, we can't always make a guess here */
292 if ((dims >= 1 && width == 1) ||
293 (dims >= 2 && height == 1) ||
294 (dims >= 3 && depth == 1)) {
295 /* we can't determine the image size at level=0 */
299 /* grow the image size until we hit level = 0 */
320 * Try to allocate a pipe_resource object for the given st_texture_object.
322 * We use the given st_texture_image as a clue to determine the size of the
323 * mipmap image at level=0.
325 * \return GL_TRUE for success, GL_FALSE if out of memory.
328 guess_and_alloc_texture(struct st_context *st,
329 struct st_texture_object *stObj,
330 const struct st_texture_image *stImage)
332 GLuint lastLevel, width, height, depth;
334 GLuint ptWidth, ptHeight, ptDepth, ptLayers;
335 enum pipe_format fmt;
337 DBG("%s\n", __FUNCTION__);
341 if (!guess_base_level_size(stObj->base.Target,
342 stImage->base.Width2,
343 stImage->base.Height2,
344 stImage->base.Depth2,
346 &width, &height, &depth)) {
347 /* we can't determine the image size at level=0 */
348 stObj->width0 = stObj->height0 = stObj->depth0 = 0;
349 /* this is not an out of memory error */
353 /* At this point, (width x height x depth) is the expected size of
354 * the level=0 mipmap image.
357 /* Guess a reasonable value for lastLevel. With OpenGL we have no
358 * idea how many mipmap levels will be in a texture until we start
359 * to render with it. Make an educated guess here but be prepared
360 * to re-allocating a texture buffer with space for more (or fewer)
361 * mipmap levels later.
363 if ((stObj->base.Sampler.MinFilter == GL_NEAREST ||
364 stObj->base.Sampler.MinFilter == GL_LINEAR ||
365 stImage->base._BaseFormat == GL_DEPTH_COMPONENT ||
366 stImage->base._BaseFormat == GL_DEPTH_STENCIL_EXT) &&
367 !stObj->base.GenerateMipmap &&
368 stImage->base.Level == 0) {
369 /* only alloc space for a single mipmap level */
373 /* alloc space for a full mipmap */
374 GLuint l2width = util_logbase2(width);
375 GLuint l2height = util_logbase2(height);
376 GLuint l2depth = util_logbase2(depth);
377 lastLevel = MAX2(MAX2(l2width, l2height), l2depth);
380 /* Save the level=0 dimensions */
381 stObj->width0 = width;
382 stObj->height0 = height;
383 stObj->depth0 = depth;
385 fmt = st_mesa_format_to_pipe_format(stImage->base.TexFormat);
387 bindings = default_bindings(st, fmt);
389 st_gl_texture_dims_to_pipe_dims(stObj->base.Target,
390 width, height, depth,
391 &ptWidth, &ptHeight, &ptDepth, &ptLayers);
393 stObj->pt = st_texture_create(st,
394 gl_target_to_pipe(stObj->base.Target),
403 stObj->lastLevel = lastLevel;
405 DBG("%s returning %d\n", __FUNCTION__, (stObj->pt != NULL));
407 return stObj->pt != NULL;
412 * Called via ctx->Driver.AllocTextureImageBuffer().
413 * If the texture object/buffer already has space for the indicated image,
414 * we're done. Otherwise, allocate memory for the new texture image.
417 st_AllocTextureImageBuffer(struct gl_context *ctx,
418 struct gl_texture_image *texImage)
420 struct st_context *st = st_context(ctx);
421 struct st_texture_image *stImage = st_texture_image(texImage);
422 struct st_texture_object *stObj = st_texture_object(texImage->TexObject);
423 const GLuint level = texImage->Level;
424 GLuint width = texImage->Width;
425 GLuint height = texImage->Height;
426 GLuint depth = texImage->Depth;
428 DBG("%s\n", __FUNCTION__);
430 assert(!stImage->TexData);
431 assert(!stImage->pt); /* xxx this might be wrong */
433 /* Look if the parent texture object has space for this image */
435 level <= stObj->pt->last_level &&
436 st_texture_match_image(stObj->pt, texImage)) {
437 /* this image will fit in the existing texture object's memory */
438 pipe_resource_reference(&stImage->pt, stObj->pt);
442 /* The parent texture object does not have space for this image */
444 pipe_resource_reference(&stObj->pt, NULL);
445 pipe_sampler_view_release(st->pipe, &stObj->sampler_view);
447 if (!guess_and_alloc_texture(st, stObj, stImage)) {
448 /* Probably out of memory.
449 * Try flushing any pending rendering, then retry.
452 if (!guess_and_alloc_texture(st, stObj, stImage)) {
453 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexImage");
459 st_texture_match_image(stObj->pt, texImage)) {
460 /* The image will live in the object's mipmap memory */
461 pipe_resource_reference(&stImage->pt, stObj->pt);
466 /* Create a new, temporary texture/resource/buffer to hold this
467 * one texture image. Note that when we later access this image
468 * (either for mapping or copying) we'll want to always specify
469 * mipmap level=0, even if the image represents some other mipmap
472 enum pipe_format format =
473 st_mesa_format_to_pipe_format(texImage->TexFormat);
474 GLuint bindings = default_bindings(st, format);
475 GLuint ptWidth, ptHeight, ptDepth, ptLayers;
477 st_gl_texture_dims_to_pipe_dims(stObj->base.Target,
478 width, height, depth,
479 &ptWidth, &ptHeight, &ptDepth, &ptLayers);
481 stImage->pt = st_texture_create(st,
482 gl_target_to_pipe(stObj->base.Target),
490 return stImage->pt != NULL;
496 * Preparation prior to glTexImage. Basically check the 'surface_based'
497 * field and switch to a "normal" tex image if necessary.
500 prep_teximage(struct gl_context *ctx, struct gl_texture_image *texImage,
501 GLenum format, GLenum type)
503 struct gl_texture_object *texObj = texImage->TexObject;
504 struct st_texture_object *stObj = st_texture_object(texObj);
506 /* switch to "normal" */
507 if (stObj->surface_based) {
508 const GLenum target = texObj->Target;
509 const GLuint level = texImage->Level;
512 _mesa_clear_texture_object(ctx, texObj);
513 pipe_resource_reference(&stObj->pt, NULL);
515 /* oops, need to init this image again */
516 texFormat = _mesa_choose_texture_format(ctx, texObj, target, level,
517 texImage->InternalFormat, format,
520 _mesa_init_teximage_fields(ctx, texImage,
521 texImage->Width, texImage->Height,
522 texImage->Depth, texImage->Border,
523 texImage->InternalFormat, texFormat);
525 stObj->surface_based = GL_FALSE;
531 st_TexImage(struct gl_context * ctx, GLuint dims,
532 struct gl_texture_image *texImage,
533 GLenum format, GLenum type, const void *pixels,
534 const struct gl_pixelstore_attrib *unpack)
536 prep_teximage(ctx, texImage, format, type);
537 _mesa_store_teximage(ctx, dims, texImage, format, type, pixels, unpack);
542 st_CompressedTexImage(struct gl_context *ctx, GLuint dims,
543 struct gl_texture_image *texImage,
544 GLsizei imageSize, const GLvoid *data)
546 prep_teximage(ctx, texImage, GL_NONE, GL_NONE);
547 _mesa_store_compressed_teximage(ctx, dims, texImage, imageSize, data);
553 * glGetTexImage() helper: decompress a compressed texture by rendering
554 * a textured quad. Store the results in the user's buffer.
557 decompress_with_blit(struct gl_context * ctx,
558 GLenum format, GLenum type, GLvoid *pixels,
559 struct gl_texture_image *texImage)
561 struct st_context *st = st_context(ctx);
562 struct pipe_context *pipe = st->pipe;
563 struct st_texture_image *stImage = st_texture_image(texImage);
564 struct st_texture_object *stObj = st_texture_object(texImage->TexObject);
565 struct pipe_sampler_view *src_view;
566 const GLuint width = texImage->Width;
567 const GLuint height = texImage->Height;
568 struct pipe_surface *dst_surface;
569 struct pipe_resource *dst_texture;
570 struct pipe_transfer *tex_xfer;
571 unsigned bind = (PIPE_BIND_RENDER_TARGET | /* util_blit may choose to render */
572 PIPE_BIND_TRANSFER_READ);
574 /* create temp / dest surface */
575 if (!util_create_rgba_surface(pipe, width, height, bind,
576 &dst_texture, &dst_surface)) {
577 _mesa_problem(ctx, "util_create_rgba_surface() failed "
578 "in decompress_with_blit()");
582 /* Disable conditional rendering. */
583 if (st->render_condition) {
584 pipe->render_condition(pipe, NULL, 0);
587 /* Create sampler view that limits fetches to the source mipmap level */
589 struct pipe_sampler_view sv_temp;
591 u_sampler_view_default_template(&sv_temp, stObj->pt, stObj->pt->format);
593 sv_temp.format = util_format_linear(sv_temp.format);
594 sv_temp.u.tex.first_level =
595 sv_temp.u.tex.last_level = texImage->Level;
597 src_view = pipe->create_sampler_view(pipe, stObj->pt, &sv_temp);
599 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glGetTexImage");
604 /* blit/render/decompress */
605 util_blit_pixels_tex(st->blit,
606 src_view, /* pipe_resource (src) */
607 0, 0, /* src x0, y0 */
608 width, height, /* src x1, y1 */
609 dst_surface, /* pipe_surface (dst) */
610 0, 0, /* dst x0, y0 */
611 width, height, /* dst x1, y1 */
613 PIPE_TEX_MIPFILTER_NEAREST);
615 /* Restore conditional rendering state. */
616 if (st->render_condition) {
617 pipe->render_condition(pipe, st->render_condition,
621 /* map the dst_surface so we can read from it */
622 tex_xfer = pipe_get_transfer(pipe,
625 0, 0, width, height);
627 pixels = _mesa_map_pbo_dest(ctx, &ctx->Pack, pixels);
629 /* copy/pack data into user buffer */
630 if (_mesa_format_matches_format_and_type(stImage->base.TexFormat,
632 ctx->Pack.SwapBytes)) {
634 const uint bytesPerRow = width * util_format_get_blocksize(stImage->pt->format);
635 ubyte *map = pipe_transfer_map(pipe, tex_xfer);
637 for (row = 0; row < height; row++) {
638 GLvoid *dest = _mesa_image_address2d(&ctx->Pack, pixels, width,
639 height, format, type, row, 0);
640 memcpy(dest, map, bytesPerRow);
641 map += tex_xfer->stride;
643 pipe_transfer_unmap(pipe, tex_xfer);
646 /* format translation via floats */
648 enum pipe_format pformat = util_format_linear(dst_texture->format);
651 rgba = (GLfloat *) malloc(width * 4 * sizeof(GLfloat));
653 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glGetTexImage()");
657 for (row = 0; row < height; row++) {
658 const GLbitfield transferOps = 0x0; /* bypassed for glGetTexImage() */
659 GLvoid *dest = _mesa_image_address2d(&ctx->Pack, pixels, width,
660 height, format, type, row, 0);
662 if (ST_DEBUG & DEBUG_FALLBACK)
663 debug_printf("%s: fallback format translation\n", __FUNCTION__);
665 /* get float[4] rgba row from surface */
666 pipe_get_tile_rgba_format(pipe, tex_xfer, 0, row, width, 1,
669 _mesa_pack_rgba_span_float(ctx, width, (GLfloat (*)[4]) rgba, format,
670 type, dest, &ctx->Pack, transferOps);
677 _mesa_unmap_pbo_dest(ctx, &ctx->Pack);
679 pipe->transfer_destroy(pipe, tex_xfer);
681 /* destroy the temp / dest surface */
682 util_destroy_rgba_surface(dst_texture, dst_surface);
684 pipe_sampler_view_release(pipe, &src_view);
690 * Called via ctx->Driver.GetTexImage()
693 st_GetTexImage(struct gl_context * ctx,
694 GLenum format, GLenum type, GLvoid * pixels,
695 struct gl_texture_image *texImage)
697 struct st_texture_image *stImage = st_texture_image(texImage);
699 if (stImage->pt && util_format_is_s3tc(stImage->pt->format)) {
700 /* Need to decompress the texture.
701 * We'll do this by rendering a textured quad (which is hopefully
702 * faster than using the fallback code in texcompress.c).
703 * Note that we only expect RGBA formats (no Z/depth formats).
705 decompress_with_blit(ctx, format, type, pixels, texImage);
708 _mesa_get_teximage(ctx, format, type, pixels, texImage);
714 * Do a CopyTexSubImage operation using a read transfer from the source,
715 * a write transfer to the destination and get_tile()/put_tile() to access
718 * Note: srcY=0=TOP of renderbuffer
721 fallback_copy_texsubimage(struct gl_context *ctx,
722 struct st_renderbuffer *strb,
723 struct st_texture_image *stImage,
725 GLint destX, GLint destY, GLint destZ,
726 GLint srcX, GLint srcY,
727 GLsizei width, GLsizei height)
729 struct st_context *st = st_context(ctx);
730 struct pipe_context *pipe = st->pipe;
731 struct pipe_transfer *src_trans;
733 enum pipe_transfer_usage transfer_usage;
735 if (ST_DEBUG & DEBUG_FALLBACK)
736 debug_printf("%s: fallback processing\n", __FUNCTION__);
738 if (st_fb_orientation(ctx->ReadBuffer) == Y_0_TOP) {
739 srcY = strb->Base.Height - srcY - height;
742 src_trans = pipe_get_transfer(pipe,
745 strb->rtt_face + strb->rtt_slice,
750 if ((baseFormat == GL_DEPTH_COMPONENT ||
751 baseFormat == GL_DEPTH_STENCIL) &&
752 util_format_is_depth_and_stencil(stImage->pt->format))
753 transfer_usage = PIPE_TRANSFER_READ_WRITE;
755 transfer_usage = PIPE_TRANSFER_WRITE;
757 /* XXX this used to ignore destZ param */
758 texDest = st_texture_image_map(st, stImage, destZ, transfer_usage,
759 destX, destY, width, height);
761 if (baseFormat == GL_DEPTH_COMPONENT ||
762 baseFormat == GL_DEPTH_STENCIL) {
763 const GLboolean scaleOrBias = (ctx->Pixel.DepthScale != 1.0F ||
764 ctx->Pixel.DepthBias != 0.0F);
768 /* determine bottom-to-top vs. top-to-bottom order for src buffer */
769 if (st_fb_orientation(ctx->ReadBuffer) == Y_0_TOP) {
778 data = (uint *) malloc(width * sizeof(uint));
781 /* To avoid a large temp memory allocation, do copy row by row */
782 for (row = 0; row < height; row++, srcY += yStep) {
783 pipe_get_tile_z(pipe, src_trans, 0, srcY, width, 1, data);
785 _mesa_scale_and_bias_depth_uint(ctx, width, data);
787 pipe_put_tile_z(pipe, stImage->transfer, 0, row, width, 1, data);
791 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glCopyTexSubImage()");
799 (GLfloat *) malloc(width * height * 4 * sizeof(GLfloat));
801 if (tempSrc && texDest) {
802 const GLint dims = 2;
803 const GLint dstRowStride = stImage->transfer->stride;
804 struct gl_texture_image *texImage = &stImage->base;
805 struct gl_pixelstore_attrib unpack = ctx->DefaultPacking;
807 if (st_fb_orientation(ctx->ReadBuffer) == Y_0_TOP) {
808 unpack.Invert = GL_TRUE;
811 /* get float/RGBA image from framebuffer */
812 /* XXX this usually involves a lot of int/float conversion.
813 * try to avoid that someday.
815 pipe_get_tile_rgba_format(pipe, src_trans, 0, 0, width, height,
816 util_format_linear(strb->texture->format),
819 /* Store into texture memory.
820 * Note that this does some special things such as pixel transfer
821 * ops and format conversion. In particular, if the dest tex format
822 * is actually RGBA but the user created the texture as GL_RGB we
823 * need to fill-in/override the alpha channel with 1.0.
825 _mesa_texstore(ctx, dims,
826 texImage->_BaseFormat,
829 (GLubyte **) &texDest,
831 GL_RGBA, GL_FLOAT, tempSrc, /* src */
835 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexSubImage");
842 st_texture_image_unmap(st, stImage);
843 pipe->transfer_destroy(pipe, src_trans);
849 * If the format of the src renderbuffer and the format of the dest
850 * texture are compatible (in terms of blitting), return a TGSI writemask
851 * to be used during the blit.
852 * If the src/dest are incompatible, return 0.
855 compatible_src_dst_formats(struct gl_context *ctx,
856 const struct gl_renderbuffer *src,
857 const struct gl_texture_image *dst)
859 /* Get logical base formats for the src and dest.
860 * That is, use the user-requested formats and not the actual, device-
862 * For example, the user may have requested an A8 texture but the
863 * driver may actually be using an RGBA texture format. When we
864 * copy/blit to that texture, we only want to copy the Alpha channel
865 * and not the RGB channels.
867 * Similarly, when the src FBO was created an RGB format may have been
868 * requested but the driver actually chose an RGBA format. In that case,
869 * we don't want to copy the undefined Alpha channel to the dest texture
870 * (it should be 1.0).
872 const GLenum srcFormat = _mesa_base_fbo_format(ctx, src->InternalFormat);
873 const GLenum dstFormat = _mesa_base_tex_format(ctx, dst->InternalFormat);
876 * XXX when we have red-only and red/green renderbuffers we'll need
877 * to add more cases here (or implement a general-purpose routine that
878 * queries the existance of the R,G,B,A channels in the src and dest).
880 if (srcFormat == dstFormat) {
881 /* This is the same as matching_base_formats, which should
882 * always pass, as it did previously.
884 return TGSI_WRITEMASK_XYZW;
886 else if (srcFormat == GL_RGB && dstFormat == GL_RGBA) {
887 /* Make sure that A in the dest is 1. The actual src format
888 * may be RGBA and have undefined A values.
890 return TGSI_WRITEMASK_XYZ;
892 else if (srcFormat == GL_RGBA && dstFormat == GL_RGB) {
893 /* Make sure that A in the dest is 1. The actual dst format
894 * may be RGBA and will need A=1 to provide proper alpha values
895 * when sampled later.
897 return TGSI_WRITEMASK_XYZ;
900 if (ST_DEBUG & DEBUG_FALLBACK)
901 debug_printf("%s failed for src %s, dst %s\n",
903 _mesa_lookup_enum_by_nr(srcFormat),
904 _mesa_lookup_enum_by_nr(dstFormat));
915 * Do a CopyTex[Sub]Image1/2/3D() using a hardware (blit) path if possible.
916 * Note that the region to copy has already been clipped so we know we
917 * won't read from outside the source renderbuffer's bounds.
919 * Note: srcY=0=Bottom of renderbuffer (GL convention)
922 st_CopyTexSubImage(struct gl_context *ctx, GLuint dims,
923 struct gl_texture_image *texImage,
924 GLint destX, GLint destY, GLint destZ,
925 struct gl_renderbuffer *rb,
926 GLint srcX, GLint srcY, GLsizei width, GLsizei height)
928 struct st_texture_image *stImage = st_texture_image(texImage);
929 const GLenum texBaseFormat = texImage->_BaseFormat;
930 struct gl_framebuffer *fb = ctx->ReadBuffer;
931 struct st_renderbuffer *strb;
932 struct st_context *st = st_context(ctx);
933 struct pipe_context *pipe = st->pipe;
934 struct pipe_screen *screen = pipe->screen;
935 enum pipe_format dest_format, src_format;
936 GLboolean matching_base_formats;
937 GLuint color_writemask, zs_writemask, sample_count;
938 struct pipe_surface *dest_surface = NULL;
939 GLboolean do_flip = (st_fb_orientation(ctx->ReadBuffer) == Y_0_TOP);
940 struct pipe_surface surf_tmpl;
941 unsigned int dst_usage;
944 /* make sure finalize_textures has been called?
946 if (0) st_validate_state(st);
948 /* determine if copying depth or color data */
949 if (texBaseFormat == GL_DEPTH_COMPONENT ||
950 texBaseFormat == GL_DEPTH_STENCIL) {
951 strb = st_renderbuffer(fb->Attachment[BUFFER_DEPTH].Renderbuffer);
954 /* texBaseFormat == GL_RGB, GL_RGBA, GL_ALPHA, etc */
955 strb = st_renderbuffer(fb->_ColorReadBuffer);
958 if (!strb || !strb->surface || !stImage->pt) {
959 debug_printf("%s: null strb or stImage\n", __FUNCTION__);
963 sample_count = strb->surface->texture->nr_samples;
964 /* I believe this would be legal, presumably would need to do a resolve
965 for color, and for depth/stencil spec says to just use one of the
966 depth/stencil samples per pixel? Need some transfer clarifications. */
967 assert(sample_count < 2);
970 assert(strb->surface);
973 src_format = strb->surface->format;
974 dest_format = stImage->pt->format;
977 * Determine if the src framebuffer and dest texture have the same
978 * base format. We need this to detect a case such as the framebuffer
979 * being GL_RGBA but the texture being GL_RGB. If the actual hardware
980 * texture format stores RGBA we need to set A=1 (overriding the
981 * framebuffer's alpha values). We can't do that with the blit or
982 * textured-quad paths.
984 matching_base_formats =
985 (_mesa_get_format_base_format(strb->Base.Format) ==
986 _mesa_get_format_base_format(texImage->TexFormat));
988 if (ctx->_ImageTransferState) {
992 if (matching_base_formats &&
993 src_format == dest_format &&
995 /* use surface_copy() / blit */
996 struct pipe_box src_box;
999 u_box_2d_zslice(srcX, srcY, strb->surface->u.tex.first_layer,
1000 width, height, &src_box);
1002 /* If stImage->pt is an independent image (not a pointer into a full
1003 * mipmap) stImage->pt.last_level will be zero and we need to use that
1004 * as the dest level.
1006 dstLevel = MIN2(stImage->base.Level, stImage->pt->last_level);
1008 /* for resource_copy_region(), y=0=top, always */
1009 pipe->resource_copy_region(pipe,
1013 destX, destY, destZ + stImage->base.Face,
1016 strb->surface->u.tex.level,
1021 if (texBaseFormat == GL_DEPTH_STENCIL) {
1025 if (texBaseFormat == GL_DEPTH_COMPONENT) {
1026 color_writemask = 0;
1027 zs_writemask = BLIT_WRITEMASK_Z;
1028 dst_usage = PIPE_BIND_DEPTH_STENCIL;
1031 color_writemask = compatible_src_dst_formats(ctx, &strb->Base, texImage);
1033 dst_usage = PIPE_BIND_RENDER_TARGET;
1036 if ((!color_writemask && !zs_writemask) ||
1037 !screen->is_format_supported(screen, src_format,
1038 PIPE_TEXTURE_2D, sample_count,
1039 PIPE_BIND_SAMPLER_VIEW) ||
1040 !screen->is_format_supported(screen, dest_format,
1047 srcY1 = strb->Base.Height - srcY - height;
1048 srcY0 = srcY1 + height;
1052 srcY1 = srcY0 + height;
1055 /* Disable conditional rendering. */
1056 if (st->render_condition) {
1057 pipe->render_condition(pipe, NULL, 0);
1060 memset(&surf_tmpl, 0, sizeof(surf_tmpl));
1061 surf_tmpl.format = util_format_linear(stImage->pt->format);
1062 surf_tmpl.usage = dst_usage;
1063 surf_tmpl.u.tex.level = stImage->base.Level;
1064 surf_tmpl.u.tex.first_layer = stImage->base.Face + destZ;
1065 surf_tmpl.u.tex.last_layer = stImage->base.Face + destZ;
1067 dest_surface = pipe->create_surface(pipe, stImage->pt,
1069 util_blit_pixels(st->blit,
1071 strb->surface->u.tex.level,
1073 srcX + width, srcY1,
1074 strb->surface->u.tex.first_layer,
1077 destX + width, destY + height,
1078 0.0, PIPE_TEX_MIPFILTER_NEAREST,
1079 color_writemask, zs_writemask);
1080 pipe_surface_reference(&dest_surface, NULL);
1082 /* Restore conditional rendering state. */
1083 if (st->render_condition) {
1084 pipe->render_condition(pipe, st->render_condition,
1085 st->condition_mode);
1091 /* software fallback */
1092 fallback_copy_texsubimage(ctx,
1093 strb, stImage, texBaseFormat,
1094 destX, destY, destZ,
1095 srcX, srcY, width, height);
1100 * Copy image data from stImage into the texture object 'stObj' at level
1104 copy_image_data_to_texture(struct st_context *st,
1105 struct st_texture_object *stObj,
1107 struct st_texture_image *stImage)
1111 const struct gl_texture_image *dstImage =
1112 stObj->base.Image[stImage->base.Face][dstLevel];
1114 assert(dstImage->Width == stImage->base.Width);
1115 assert(dstImage->Height == stImage->base.Height);
1116 assert(dstImage->Depth == stImage->base.Depth);
1120 /* Copy potentially with the blitter:
1123 if (stImage->pt != stObj->pt)
1126 src_level = stImage->base.Level;
1128 st_texture_image_copy(st->pipe,
1129 stObj->pt, dstLevel, /* dest texture, level */
1130 stImage->pt, src_level, /* src texture, level */
1131 stImage->base.Face);
1133 pipe_resource_reference(&stImage->pt, NULL);
1135 else if (stImage->TexData) {
1136 /* Copy from malloc'd memory */
1137 /* XXX this should be re-examined/tested with a compressed format */
1138 GLuint blockSize = util_format_get_blocksize(stObj->pt->format);
1139 GLuint srcRowStride = stImage->base.Width * blockSize;
1140 GLuint srcSliceStride = stImage->base.Height * srcRowStride;
1141 st_texture_image_data(st,
1148 _mesa_align_free(stImage->TexData);
1149 stImage->TexData = NULL;
1152 pipe_resource_reference(&stImage->pt, stObj->pt);
1157 * Called during state validation. When this function is finished,
1158 * the texture object should be ready for rendering.
1159 * \return GL_TRUE for success, GL_FALSE for failure (out of mem)
1162 st_finalize_texture(struct gl_context *ctx,
1163 struct pipe_context *pipe,
1164 struct gl_texture_object *tObj)
1166 struct st_context *st = st_context(ctx);
1167 struct st_texture_object *stObj = st_texture_object(tObj);
1168 const GLuint nr_faces = (stObj->base.Target == GL_TEXTURE_CUBE_MAP) ? 6 : 1;
1170 struct st_texture_image *firstImage;
1171 enum pipe_format firstImageFormat;
1172 GLuint ptWidth, ptHeight, ptDepth, ptLayers;
1174 if (_mesa_is_texture_complete(tObj, &tObj->Sampler)) {
1175 /* The texture is complete and we know exactly how many mipmap levels
1176 * are present/needed. This is conditional because we may be called
1177 * from the st_generate_mipmap() function when the texture object is
1178 * incomplete. In that case, we'll have set stObj->lastLevel before
1181 if (stObj->base.Sampler.MinFilter == GL_LINEAR ||
1182 stObj->base.Sampler.MinFilter == GL_NEAREST)
1183 stObj->lastLevel = stObj->base.BaseLevel;
1185 stObj->lastLevel = stObj->base._MaxLevel;
1188 firstImage = st_texture_image(stObj->base.Image[0][stObj->base.BaseLevel]);
1191 /* If both firstImage and stObj point to a texture which can contain
1192 * all active images, favour firstImage. Note that because of the
1193 * completeness requirement, we know that the image dimensions
1196 if (firstImage->pt &&
1197 firstImage->pt != stObj->pt &&
1198 (!stObj->pt || firstImage->pt->last_level >= stObj->pt->last_level)) {
1199 pipe_resource_reference(&stObj->pt, firstImage->pt);
1200 pipe_sampler_view_release(st->pipe, &stObj->sampler_view);
1203 /* Find gallium format for the Mesa texture */
1204 firstImageFormat = st_mesa_format_to_pipe_format(firstImage->base.TexFormat);
1206 /* Find size of level=0 Gallium mipmap image, plus number of texture layers */
1208 GLuint width, height, depth;
1209 if (!guess_base_level_size(stObj->base.Target,
1210 firstImage->base.Width2,
1211 firstImage->base.Height2,
1212 firstImage->base.Depth2,
1213 firstImage->base.Level,
1214 &width, &height, &depth)) {
1215 width = stObj->width0;
1216 height = stObj->height0;
1217 depth = stObj->depth0;
1219 /* convert GL dims to Gallium dims */
1220 st_gl_texture_dims_to_pipe_dims(stObj->base.Target, width, height, depth,
1221 &ptWidth, &ptHeight, &ptDepth, &ptLayers);
1224 /* If we already have a gallium texture, check that it matches the texture
1225 * object's format, target, size, num_levels, etc.
1228 if (stObj->pt->target != gl_target_to_pipe(stObj->base.Target) ||
1229 !st_sampler_compat_formats(stObj->pt->format, firstImageFormat) ||
1230 stObj->pt->last_level < stObj->lastLevel ||
1231 stObj->pt->width0 != ptWidth ||
1232 stObj->pt->height0 != ptHeight ||
1233 stObj->pt->depth0 != ptDepth ||
1234 stObj->pt->array_size != ptLayers)
1236 /* The gallium texture does not match the Mesa texture so delete the
1237 * gallium texture now. We'll make a new one below.
1239 pipe_resource_reference(&stObj->pt, NULL);
1240 pipe_sampler_view_release(st->pipe, &stObj->sampler_view);
1241 st->dirty.st |= ST_NEW_FRAMEBUFFER;
1245 /* May need to create a new gallium texture:
1248 GLuint bindings = default_bindings(st, firstImageFormat);
1250 stObj->pt = st_texture_create(st,
1251 gl_target_to_pipe(stObj->base.Target),
1261 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexImage");
1266 /* Pull in any images not in the object's texture:
1268 for (face = 0; face < nr_faces; face++) {
1270 for (level = stObj->base.BaseLevel; level <= stObj->lastLevel; level++) {
1271 struct st_texture_image *stImage =
1272 st_texture_image(stObj->base.Image[face][level]);
1274 /* Need to import images in main memory or held in other textures.
1276 if (stImage && stObj->pt != stImage->pt) {
1278 (stImage->base.Width == u_minify(stObj->width0, level) &&
1279 stImage->base.Height == u_minify(stObj->height0, level) &&
1280 stImage->base.Depth == u_minify(stObj->depth0, level))) {
1281 /* src image fits expected dest mipmap level size */
1282 copy_image_data_to_texture(st, stObj, level, stImage);
1293 * Called via ctx->Driver.AllocTextureStorage() to allocate texture memory
1294 * for a whole mipmap stack.
1297 st_AllocTextureStorage(struct gl_context *ctx,
1298 struct gl_texture_object *texObj,
1299 GLsizei levels, GLsizei width,
1300 GLsizei height, GLsizei depth)
1302 const GLuint numFaces = (texObj->Target == GL_TEXTURE_CUBE_MAP) ? 6 : 1;
1303 struct st_context *st = st_context(ctx);
1304 struct st_texture_object *stObj = st_texture_object(texObj);
1305 GLuint ptWidth, ptHeight, ptDepth, ptLayers, bindings;
1306 enum pipe_format fmt;
1311 /* Save the level=0 dimensions */
1312 stObj->width0 = width;
1313 stObj->height0 = height;
1314 stObj->depth0 = depth;
1315 stObj->lastLevel = levels - 1;
1317 fmt = st_mesa_format_to_pipe_format(texObj->Image[0][0]->TexFormat);
1319 bindings = default_bindings(st, fmt);
1321 st_gl_texture_dims_to_pipe_dims(texObj->Target,
1322 width, height, depth,
1323 &ptWidth, &ptHeight, &ptDepth, &ptLayers);
1325 stObj->pt = st_texture_create(st,
1326 gl_target_to_pipe(texObj->Target),
1337 /* Set image resource pointers */
1338 for (level = 0; level < levels; level++) {
1340 for (face = 0; face < numFaces; face++) {
1341 struct st_texture_image *stImage =
1342 st_texture_image(texObj->Image[face][level]);
1343 pipe_resource_reference(&stImage->pt, stObj->pt);
1353 st_init_texture_functions(struct dd_function_table *functions)
1355 functions->ChooseTextureFormat = st_ChooseTextureFormat;
1356 functions->TexImage = st_TexImage;
1357 functions->TexSubImage = _mesa_store_texsubimage;
1358 functions->CompressedTexSubImage = _mesa_store_compressed_texsubimage;
1359 functions->CopyTexSubImage = st_CopyTexSubImage;
1360 functions->GenerateMipmap = st_generate_mipmap;
1362 functions->GetTexImage = st_GetTexImage;
1364 /* compressed texture functions */
1365 functions->CompressedTexImage = st_CompressedTexImage;
1366 functions->GetCompressedTexImage = _mesa_get_compressed_teximage;
1368 functions->NewTextureObject = st_NewTextureObject;
1369 functions->NewTextureImage = st_NewTextureImage;
1370 functions->DeleteTextureImage = st_DeleteTextureImage;
1371 functions->DeleteTexture = st_DeleteTextureObject;
1372 functions->AllocTextureImageBuffer = st_AllocTextureImageBuffer;
1373 functions->FreeTextureImageBuffer = st_FreeTextureImageBuffer;
1374 functions->MapTextureImage = st_MapTextureImage;
1375 functions->UnmapTextureImage = st_UnmapTextureImage;
1377 /* XXX Temporary until we can query pipe's texture sizes */
1378 functions->TestProxyTexImage = _mesa_test_proxy_teximage;
1380 functions->AllocTextureStorage = st_AllocTextureStorage;