st_cb_texture.c revision b1ed72ebe2599ec178f51d86fd42f26486b9a19b
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#include "main/mfeatures.h"
29#include "main/bufferobj.h"
30#if FEATURE_convolve
31#include "main/convolve.h"
32#endif
33#include "main/enums.h"
34#include "main/formats.h"
35#include "main/image.h"
36#include "main/imports.h"
37#include "main/macros.h"
38#include "main/mipmap.h"
39#include "main/pixel.h"
40#include "main/texcompress.h"
41#include "main/texfetch.h"
42#include "main/texformat.h"
43#include "main/texgetimage.h"
44#include "main/teximage.h"
45#include "main/texobj.h"
46#include "main/texstore.h"
47
48#include "state_tracker/st_debug.h"
49#include "state_tracker/st_context.h"
50#include "state_tracker/st_cb_fbo.h"
51#include "state_tracker/st_cb_texture.h"
52#include "state_tracker/st_format.h"
53#include "state_tracker/st_public.h"
54#include "state_tracker/st_texture.h"
55#include "state_tracker/st_gen_mipmap.h"
56#include "state_tracker/st_inlines.h"
57#include "state_tracker/st_atom.h"
58
59#include "pipe/p_context.h"
60#include "pipe/p_defines.h"
61#include "pipe/p_inlines.h"
62#include "pipe/p_shader_tokens.h"
63#include "util/u_tile.h"
64#include "util/u_blit.h"
65#include "util/u_format.h"
66#include "util/u_surface.h"
67#include "util/u_math.h"
68
69
70#define DBG if (0) printf
71
72
73static enum pipe_texture_target
74gl_target_to_pipe(GLenum target)
75{
76   switch (target) {
77   case GL_TEXTURE_1D:
78      return PIPE_TEXTURE_1D;
79
80   case GL_TEXTURE_2D:
81   case GL_TEXTURE_RECTANGLE_NV:
82      return PIPE_TEXTURE_2D;
83
84   case GL_TEXTURE_3D:
85      return PIPE_TEXTURE_3D;
86
87   case GL_TEXTURE_CUBE_MAP_ARB:
88      return PIPE_TEXTURE_CUBE;
89
90   default:
91      assert(0);
92      return 0;
93   }
94}
95
96
97/** called via ctx->Driver.NewTextureImage() */
98static struct gl_texture_image *
99st_NewTextureImage(GLcontext * ctx)
100{
101   DBG("%s\n", __FUNCTION__);
102   (void) ctx;
103   return (struct gl_texture_image *) ST_CALLOC_STRUCT(st_texture_image);
104}
105
106
107/** called via ctx->Driver.NewTextureObject() */
108static struct gl_texture_object *
109st_NewTextureObject(GLcontext * ctx, GLuint name, GLenum target)
110{
111   struct st_texture_object *obj = ST_CALLOC_STRUCT(st_texture_object);
112
113   DBG("%s\n", __FUNCTION__);
114   _mesa_initialize_texture_object(&obj->base, name, target);
115
116   return &obj->base;
117}
118
119/** called via ctx->Driver.DeleteTextureImage() */
120static void
121st_DeleteTextureObject(GLcontext *ctx,
122                       struct gl_texture_object *texObj)
123{
124   struct st_texture_object *stObj = st_texture_object(texObj);
125   if (stObj->pt)
126      pipe_texture_reference(&stObj->pt, NULL);
127
128   _mesa_delete_texture_object(ctx, texObj);
129}
130
131
132/** called via ctx->Driver.FreeTexImageData() */
133static void
134st_FreeTextureImageData(GLcontext * ctx, struct gl_texture_image *texImage)
135{
136   struct st_texture_image *stImage = st_texture_image(texImage);
137
138   DBG("%s\n", __FUNCTION__);
139
140   if (stImage->pt) {
141      pipe_texture_reference(&stImage->pt, NULL);
142   }
143
144   if (texImage->Data) {
145      _mesa_align_free(texImage->Data);
146      texImage->Data = NULL;
147   }
148}
149
150
151/**
152 * From linux kernel i386 header files, copes with odd sizes better
153 * than COPY_DWORDS would:
154 * XXX Put this in src/mesa/main/imports.h ???
155 */
156#if defined(PIPE_CC_GCC) && defined(PIPE_ARCH_X86)
157static INLINE void *
158__memcpy(void *to, const void *from, size_t n)
159{
160   int d0, d1, d2;
161   __asm__ __volatile__("rep ; movsl\n\t"
162                        "testb $2,%b4\n\t"
163                        "je 1f\n\t"
164                        "movsw\n"
165                        "1:\ttestb $1,%b4\n\t"
166                        "je 2f\n\t"
167                        "movsb\n" "2:":"=&c"(d0), "=&D"(d1), "=&S"(d2)
168                        :"0"(n / 4), "q"(n), "1"((long) to), "2"((long) from)
169                        :"memory");
170   return (to);
171}
172#else
173#define __memcpy(a,b,c) memcpy(a,b,c)
174#endif
175
176
177/**
178 * The system memcpy (at least on ubuntu 5.10) has problems copying
179 * to agp (writecombined) memory from a source which isn't 64-byte
180 * aligned - there is a 4x performance falloff.
181 *
182 * The x86 __memcpy is immune to this but is slightly slower
183 * (10%-ish) than the system memcpy.
184 *
185 * The sse_memcpy seems to have a slight cliff at 64/32 bytes, but
186 * isn't much faster than x86_memcpy for agp copies.
187 *
188 * TODO: switch dynamically.
189 */
190static void *
191do_memcpy(void *dest, const void *src, size_t n)
192{
193   if ((((unsigned long) src) & 63) || (((unsigned long) dest) & 63)) {
194      return __memcpy(dest, src, n);
195   }
196   else
197      return memcpy(dest, src, n);
198}
199
200
201/**
202 * Return default texture usage bitmask for the given texture format.
203 */
204static GLuint
205default_usage(enum pipe_format fmt)
206{
207   GLuint usage = PIPE_TEXTURE_USAGE_SAMPLER;
208   if (util_format_is_depth_or_stencil(fmt))
209      usage |= PIPE_TEXTURE_USAGE_DEPTH_STENCIL;
210   else
211      usage |= PIPE_TEXTURE_USAGE_RENDER_TARGET;
212   return usage;
213}
214
215
216/**
217 * Allocate a pipe_texture object for the given st_texture_object using
218 * the given st_texture_image to guess the mipmap size/levels.
219 *
220 * [comments...]
221 * Otherwise, store it in memory if (Border != 0) or (any dimension ==
222 * 1).
223 *
224 * Otherwise, if max_level >= level >= min_level, create texture with
225 * space for images from min_level down to max_level.
226 *
227 * Otherwise, create texture with space for images from (level 0)..(1x1).
228 * Consider pruning this texture at a validation if the saving is worth it.
229 */
230static void
231guess_and_alloc_texture(struct st_context *st,
232			struct st_texture_object *stObj,
233			const struct st_texture_image *stImage)
234{
235   GLuint firstLevel;
236   GLuint lastLevel;
237   GLuint width = stImage->base.Width2;  /* size w/out border */
238   GLuint height = stImage->base.Height2;
239   GLuint depth = stImage->base.Depth2;
240   GLuint i, usage;
241   enum pipe_format fmt;
242
243   DBG("%s\n", __FUNCTION__);
244
245   assert(!stObj->pt);
246
247   if (stObj->pt &&
248       (GLint) stImage->level > stObj->base.BaseLevel &&
249       (stImage->base.Width == 1 ||
250        (stObj->base.Target != GL_TEXTURE_1D &&
251         stImage->base.Height == 1) ||
252        (stObj->base.Target == GL_TEXTURE_3D &&
253         stImage->base.Depth == 1)))
254      return;
255
256   /* If this image disrespects BaseLevel, allocate from level zero.
257    * Usually BaseLevel == 0, so it's unlikely to happen.
258    */
259   if ((GLint) stImage->level < stObj->base.BaseLevel)
260      firstLevel = 0;
261   else
262      firstLevel = stObj->base.BaseLevel;
263
264
265   /* Figure out image dimensions at start level.
266    */
267   for (i = stImage->level; i > firstLevel; i--) {
268      if (width != 1)
269         width <<= 1;
270      if (height != 1)
271         height <<= 1;
272      if (depth != 1)
273         depth <<= 1;
274   }
275
276   if (width == 0 || height == 0 || depth == 0) {
277      /* no texture needed */
278      return;
279   }
280
281   /* Guess a reasonable value for lastLevel.  This is probably going
282    * to be wrong fairly often and might mean that we have to look at
283    * resizable buffers, or require that buffers implement lazy
284    * pagetable arrangements.
285    */
286   if ((stObj->base.MinFilter == GL_NEAREST ||
287        stObj->base.MinFilter == GL_LINEAR ||
288        stImage->base._BaseFormat == GL_DEPTH_COMPONENT ||
289        stImage->base._BaseFormat == GL_DEPTH_STENCIL_EXT) &&
290       !stObj->base.GenerateMipmap &&
291       stImage->level == firstLevel) {
292      /* only alloc space for a single mipmap level */
293      lastLevel = firstLevel;
294   }
295   else {
296      /* alloc space for a full mipmap */
297      GLuint l2width = util_logbase2(width);
298      GLuint l2height = util_logbase2(height);
299      GLuint l2depth = util_logbase2(depth);
300      lastLevel = firstLevel + MAX2(MAX2(l2width, l2height), l2depth);
301   }
302
303   fmt = st_mesa_format_to_pipe_format(stImage->base.TexFormat);
304
305   usage = default_usage(fmt);
306
307   stObj->pt = st_texture_create(st,
308                                 gl_target_to_pipe(stObj->base.Target),
309                                 fmt,
310                                 lastLevel,
311                                 width,
312                                 height,
313                                 depth,
314                                 usage);
315
316   DBG("%s - success\n", __FUNCTION__);
317}
318
319
320/**
321 * Adjust pixel unpack params and image dimensions to strip off the
322 * texture border.
323 * Gallium doesn't support texture borders.  They've seldem been used
324 * and seldom been implemented correctly anyway.
325 * \param unpackNew  returns the new pixel unpack parameters
326 */
327static void
328strip_texture_border(GLint border,
329                     GLint *width, GLint *height, GLint *depth,
330                     const struct gl_pixelstore_attrib *unpack,
331                     struct gl_pixelstore_attrib *unpackNew)
332{
333   assert(border > 0);  /* sanity check */
334
335   *unpackNew = *unpack;
336
337   if (unpackNew->RowLength == 0)
338      unpackNew->RowLength = *width;
339
340   if (depth && unpackNew->ImageHeight == 0)
341      unpackNew->ImageHeight = *height;
342
343   unpackNew->SkipPixels += border;
344   if (height)
345      unpackNew->SkipRows += border;
346   if (depth)
347      unpackNew->SkipImages += border;
348
349   assert(*width >= 3);
350   *width = *width - 2 * border;
351   if (height && *height >= 3)
352      *height = *height - 2 * border;
353   if (depth && *depth >= 3)
354      *depth = *depth - 2 * border;
355}
356
357
358/**
359 * Try to do texture compression via rendering.  If the Gallium driver
360 * can render into a compressed surface this will allow us to do texture
361 * compression.
362 * \return GL_TRUE for success, GL_FALSE for failure
363 */
364static GLboolean
365compress_with_blit(GLcontext * ctx,
366                   GLenum target, GLint level,
367                   GLint xoffset, GLint yoffset, GLint zoffset,
368                   GLint width, GLint height, GLint depth,
369                   GLenum format, GLenum type, const void *pixels,
370                   const struct gl_pixelstore_attrib *unpack,
371                   struct gl_texture_image *texImage)
372{
373   const GLuint dstImageOffsets[1] = {0};
374   struct st_texture_image *stImage = st_texture_image(texImage);
375   struct pipe_screen *screen = ctx->st->pipe->screen;
376   gl_format mesa_format;
377   struct pipe_texture templ;
378   struct pipe_texture *src_tex;
379   struct pipe_surface *dst_surface;
380   struct pipe_transfer *tex_xfer;
381   void *map;
382
383   if (!stImage->pt) {
384      /* XXX: Can this happen? Should we assert? */
385      return GL_FALSE;
386   }
387
388   /* get destination surface (in the compressed texture) */
389   dst_surface = screen->get_tex_surface(screen, stImage->pt,
390                                         stImage->face, stImage->level, 0,
391                                         PIPE_BUFFER_USAGE_GPU_WRITE);
392   if (!dst_surface) {
393      /* can't render into this format (or other problem) */
394      return GL_FALSE;
395   }
396
397   /* Choose format for the temporary RGBA texture image.
398    */
399   mesa_format = st_ChooseTextureFormat(ctx, GL_RGBA, format, type);
400   assert(mesa_format);
401   if (!mesa_format)
402      return GL_FALSE;
403
404   /* Create the temporary source texture
405    */
406   memset(&templ, 0, sizeof(templ));
407   templ.target = PIPE_TEXTURE_2D;
408   templ.format = st_mesa_format_to_pipe_format(mesa_format);
409   templ.width0 = width;
410   templ.height0 = height;
411   templ.depth0 = 1;
412   templ.last_level = 0;
413   templ.tex_usage = PIPE_TEXTURE_USAGE_SAMPLER;
414   src_tex = screen->texture_create(screen, &templ);
415
416   if (!src_tex)
417      return GL_FALSE;
418
419   /* Put user's tex data into the temporary texture
420    */
421   tex_xfer = st_cond_flush_get_tex_transfer(st_context(ctx), src_tex,
422					     0, 0, 0, /* face, level are zero */
423					     PIPE_TRANSFER_WRITE,
424					     0, 0, width, height); /* x, y, w, h */
425   map = screen->transfer_map(screen, tex_xfer);
426
427   _mesa_texstore(ctx, 2, GL_RGBA, mesa_format,
428                  map,              /* dest ptr */
429                  0, 0, 0,          /* dest x/y/z offset */
430                  tex_xfer->stride, /* dest row stride (bytes) */
431                  dstImageOffsets,  /* image offsets (for 3D only) */
432                  width, height, 1, /* size */
433                  format, type,     /* source format/type */
434                  pixels,           /* source data */
435                  unpack);          /* source data packing */
436
437   screen->transfer_unmap(screen, tex_xfer);
438   screen->tex_transfer_destroy(tex_xfer);
439
440   /* copy / compress image */
441   util_blit_pixels_tex(ctx->st->blit,
442                        src_tex,          /* pipe_texture (src) */
443                        0, 0,             /* src x0, y0 */
444                        width, height,    /* src x1, y1 */
445                        dst_surface,      /* pipe_surface (dst) */
446                        xoffset, yoffset, /* dst x0, y0 */
447                        xoffset + width,  /* dst x1 */
448                        yoffset + height, /* dst y1 */
449                        0.0,              /* z */
450                        PIPE_TEX_MIPFILTER_NEAREST);
451
452   pipe_surface_reference(&dst_surface, NULL);
453   pipe_texture_reference(&src_tex, NULL);
454
455   return GL_TRUE;
456}
457
458
459/**
460 * Do glTexImage1/2/3D().
461 */
462static void
463st_TexImage(GLcontext * ctx,
464            GLint dims,
465            GLenum target, GLint level,
466            GLint internalFormat,
467            GLint width, GLint height, GLint depth,
468            GLint border,
469            GLenum format, GLenum type, const void *pixels,
470            const struct gl_pixelstore_attrib *unpack,
471            struct gl_texture_object *texObj,
472            struct gl_texture_image *texImage,
473            GLsizei imageSize, GLboolean compressed_src)
474{
475   struct pipe_screen *screen = ctx->st->pipe->screen;
476   struct st_texture_object *stObj = st_texture_object(texObj);
477   struct st_texture_image *stImage = st_texture_image(texImage);
478   GLint postConvWidth, postConvHeight;
479   GLint texelBytes, sizeInBytes;
480   GLuint dstRowStride = 0;
481   struct gl_pixelstore_attrib unpackNB;
482   enum pipe_transfer_usage transfer_usage = 0;
483
484   DBG("%s target %s level %d %dx%dx%d border %d\n", __FUNCTION__,
485       _mesa_lookup_enum_by_nr(target), level, width, height, depth, border);
486
487   /* switch to "normal" */
488   if (stObj->surface_based) {
489      _mesa_clear_texture_object(ctx, texObj);
490      stObj->surface_based = GL_FALSE;
491   }
492
493   /* gallium does not support texture borders, strip it off */
494   if (border) {
495      strip_texture_border(border, &width, &height, &depth, unpack, &unpackNB);
496      unpack = &unpackNB;
497      texImage->Width = width;
498      texImage->Height = height;
499      texImage->Depth = depth;
500      texImage->Border = 0;
501      border = 0;
502   }
503
504   postConvWidth = width;
505   postConvHeight = height;
506
507   stImage->face = _mesa_tex_target_to_face(target);
508   stImage->level = level;
509
510#if FEATURE_convolve
511   if (ctx->_ImageTransferState & IMAGE_CONVOLUTION_BIT) {
512      _mesa_adjust_image_for_convolution(ctx, dims, &postConvWidth,
513                                         &postConvHeight);
514   }
515#endif
516
517   _mesa_set_fetch_functions(texImage, dims);
518
519   if (_mesa_is_format_compressed(texImage->TexFormat)) {
520      /* must be a compressed format */
521      texelBytes = 0;
522   }
523   else {
524      texelBytes = _mesa_get_format_bytes(texImage->TexFormat);
525
526      /* Minimum pitch of 32 bytes */
527      if (postConvWidth * texelBytes < 32) {
528	 postConvWidth = 32 / texelBytes;
529	 texImage->RowStride = postConvWidth;
530      }
531
532      /* we'll set RowStride elsewhere when the texture is a "mapped" state */
533      /*assert(texImage->RowStride == postConvWidth);*/
534   }
535
536   /* Release the reference to a potentially orphaned buffer.
537    * Release any old malloced memory.
538    */
539   if (stImage->pt) {
540      pipe_texture_reference(&stImage->pt, NULL);
541      assert(!texImage->Data);
542   }
543   else if (texImage->Data) {
544      _mesa_align_free(texImage->Data);
545   }
546
547   if (width == 0 || height == 0 || depth == 0) {
548      /* stop after freeing old image */
549      return;
550   }
551
552   /* If this is the only mipmap level in the texture, could call
553    * bmBufferData with NULL data to free the old block and avoid
554    * waiting on any outstanding fences.
555    */
556   if (stObj->pt) {
557      if (stObj->teximage_realloc ||
558          level > (GLint) stObj->pt->last_level ||
559          (stObj->pt->last_level == level &&
560           stObj->pt->target != PIPE_TEXTURE_CUBE &&
561           !st_texture_match_image(stObj->pt, &stImage->base,
562                                   stImage->face, stImage->level))) {
563         DBG("release it\n");
564         pipe_texture_reference(&stObj->pt, NULL);
565         assert(!stObj->pt);
566         stObj->teximage_realloc = FALSE;
567      }
568   }
569
570   if (!stObj->pt) {
571      guess_and_alloc_texture(ctx->st, stObj, stImage);
572      if (!stObj->pt) {
573         /* Probably out of memory.
574          * Try flushing any pending rendering, then retry.
575          */
576         st_finish(ctx->st);
577         guess_and_alloc_texture(ctx->st, stObj, stImage);
578         if (!stObj->pt) {
579            _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexImage");
580            return;
581         }
582      }
583   }
584
585   assert(!stImage->pt);
586
587   if (stObj->pt &&
588       st_texture_match_image(stObj->pt, &stImage->base,
589                                 stImage->face, stImage->level)) {
590
591      pipe_texture_reference(&stImage->pt, stObj->pt);
592      assert(stImage->pt);
593   }
594
595   if (!stImage->pt)
596      DBG("XXX: Image did not fit into texture - storing in local memory!\n");
597
598   /* st_CopyTexImage calls this function with pixels == NULL, with
599    * the expectation that the texture will be set up but nothing
600    * more will be done.  This is where those calls return:
601    */
602   if (compressed_src) {
603      pixels = _mesa_validate_pbo_compressed_teximage(ctx, imageSize, pixels,
604						      unpack,
605						      "glCompressedTexImage");
606   }
607   else {
608      pixels = _mesa_validate_pbo_teximage(ctx, dims, width, height, 1,
609					   format, type,
610					   pixels, unpack, "glTexImage");
611   }
612
613   /* Note: we can't check for pixels==NULL until after we've allocated
614    * memory for the texture.
615    */
616
617   /* See if we can do texture compression with a blit/render.
618    */
619   if (!compressed_src &&
620       !ctx->Mesa_DXTn &&
621       _mesa_is_format_compressed(texImage->TexFormat) &&
622       screen->is_format_supported(screen,
623                                   stImage->pt->format,
624                                   stImage->pt->target,
625                                   PIPE_TEXTURE_USAGE_RENDER_TARGET, 0)) {
626      if (!pixels)
627         goto done;
628
629      if (compress_with_blit(ctx, target, level, 0, 0, 0, width, height, depth,
630                             format, type, pixels, unpack, texImage)) {
631         goto done;
632      }
633   }
634
635   if (stImage->pt) {
636      if (format == GL_DEPTH_COMPONENT &&
637          util_format_is_depth_and_stencil(stImage->pt->format))
638         transfer_usage = PIPE_TRANSFER_READ_WRITE;
639      else
640         transfer_usage = PIPE_TRANSFER_WRITE;
641
642      texImage->Data = st_texture_image_map(ctx->st, stImage, 0,
643                                            transfer_usage, 0, 0,
644                                            stImage->base.Width,
645                                            stImage->base.Height);
646      if(stImage->transfer)
647         dstRowStride = stImage->transfer->stride;
648   }
649   else {
650      /* Allocate regular memory and store the image there temporarily.   */
651      if (_mesa_is_format_compressed(texImage->TexFormat)) {
652         sizeInBytes = _mesa_format_image_size(texImage->TexFormat,
653                                               texImage->Width,
654                                               texImage->Height,
655                                               texImage->Depth);
656         dstRowStride = _mesa_format_row_stride(texImage->TexFormat, width);
657         assert(dims != 3);
658      }
659      else {
660         dstRowStride = postConvWidth * texelBytes;
661         sizeInBytes = depth * dstRowStride * postConvHeight;
662      }
663
664      texImage->Data = _mesa_align_malloc(sizeInBytes, 16);
665   }
666
667   if (!texImage->Data) {
668      _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexImage");
669      return;
670   }
671
672   if (!pixels)
673      goto done;
674
675   DBG("Upload image %dx%dx%d row_len %x pitch %x\n",
676       width, height, depth, width * texelBytes, dstRowStride);
677
678   /* Copy data.  Would like to know when it's ok for us to eg. use
679    * the blitter to copy.  Or, use the hardware to do the format
680    * conversion and copy:
681    */
682   if (compressed_src) {
683      memcpy(texImage->Data, pixels, imageSize);
684   }
685   else {
686      const GLuint srcImageStride =
687         _mesa_image_image_stride(unpack, width, height, format, type);
688      GLint i;
689      const GLubyte *src = (const GLubyte *) pixels;
690
691      for (i = 0; i < depth; i++) {
692	 if (!_mesa_texstore(ctx, dims,
693                             texImage->_BaseFormat,
694                             texImage->TexFormat,
695                             texImage->Data,
696                             0, 0, 0, /* dstX/Y/Zoffset */
697                             dstRowStride,
698                             texImage->ImageOffsets,
699                             width, height, 1,
700                             format, type, src, unpack)) {
701	    _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexImage");
702	 }
703
704	 if (stImage->pt && i + 1 < depth) {
705            /* unmap this slice */
706	    st_texture_image_unmap(ctx->st, stImage);
707            /* map next slice of 3D texture */
708	    texImage->Data = st_texture_image_map(ctx->st, stImage, i + 1,
709                                                  transfer_usage, 0, 0,
710                                                  stImage->base.Width,
711                                                  stImage->base.Height);
712	    src += srcImageStride;
713	 }
714      }
715   }
716
717done:
718   _mesa_unmap_teximage_pbo(ctx, unpack);
719
720   if (stImage->pt && texImage->Data) {
721      st_texture_image_unmap(ctx->st, stImage);
722      texImage->Data = NULL;
723   }
724}
725
726
727static void
728st_TexImage3D(GLcontext * ctx,
729              GLenum target, GLint level,
730              GLint internalFormat,
731              GLint width, GLint height, GLint depth,
732              GLint border,
733              GLenum format, GLenum type, const void *pixels,
734              const struct gl_pixelstore_attrib *unpack,
735              struct gl_texture_object *texObj,
736              struct gl_texture_image *texImage)
737{
738   st_TexImage(ctx, 3, target, level, internalFormat, width, height, depth,
739               border, format, type, pixels, unpack, texObj, texImage,
740               0, GL_FALSE);
741}
742
743
744static void
745st_TexImage2D(GLcontext * ctx,
746              GLenum target, GLint level,
747              GLint internalFormat,
748              GLint width, GLint height, GLint border,
749              GLenum format, GLenum type, const void *pixels,
750              const struct gl_pixelstore_attrib *unpack,
751              struct gl_texture_object *texObj,
752              struct gl_texture_image *texImage)
753{
754   st_TexImage(ctx, 2, target, level, internalFormat, width, height, 1, border,
755               format, type, pixels, unpack, texObj, texImage, 0, GL_FALSE);
756}
757
758
759static void
760st_TexImage1D(GLcontext * ctx,
761              GLenum target, GLint level,
762              GLint internalFormat,
763              GLint width, GLint border,
764              GLenum format, GLenum type, const void *pixels,
765              const struct gl_pixelstore_attrib *unpack,
766              struct gl_texture_object *texObj,
767              struct gl_texture_image *texImage)
768{
769   st_TexImage(ctx, 1, target, level, internalFormat, width, 1, 1, border,
770               format, type, pixels, unpack, texObj, texImage, 0, GL_FALSE);
771}
772
773
774static void
775st_CompressedTexImage2D(GLcontext *ctx, GLenum target, GLint level,
776                        GLint internalFormat,
777                        GLint width, GLint height, GLint border,
778                        GLsizei imageSize, const GLvoid *data,
779                        struct gl_texture_object *texObj,
780                        struct gl_texture_image *texImage)
781{
782   st_TexImage(ctx, 2, target, level, internalFormat, width, height, 1, border,
783               0, 0, data, &ctx->Unpack, texObj, texImage, imageSize, GL_TRUE);
784}
785
786
787
788/**
789 * glGetTexImage() helper: decompress a compressed texture by rendering
790 * a textured quad.  Store the results in the user's buffer.
791 */
792static void
793decompress_with_blit(GLcontext * ctx, GLenum target, GLint level,
794                     GLenum format, GLenum type, GLvoid *pixels,
795                     struct gl_texture_object *texObj,
796                     struct gl_texture_image *texImage)
797{
798   struct pipe_screen *screen = ctx->st->pipe->screen;
799   struct st_texture_image *stImage = st_texture_image(texImage);
800   const GLuint width = texImage->Width;
801   const GLuint height = texImage->Height;
802   struct pipe_surface *dst_surface;
803   struct pipe_texture *dst_texture;
804   struct pipe_transfer *tex_xfer;
805
806   /* create temp / dest surface */
807   if (!util_create_rgba_surface(screen, width, height,
808                                 &dst_texture, &dst_surface)) {
809      _mesa_problem(ctx, "util_create_rgba_surface() failed "
810                    "in decompress_with_blit()");
811      return;
812   }
813
814   /* blit/render/decompress */
815   util_blit_pixels_tex(ctx->st->blit,
816                        stImage->pt,      /* pipe_texture (src) */
817                        0, 0,             /* src x0, y0 */
818                        width, height,    /* src x1, y1 */
819                        dst_surface,      /* pipe_surface (dst) */
820                        0, 0,             /* dst x0, y0 */
821                        width, height,    /* dst x1, y1 */
822                        0.0,              /* z */
823                        PIPE_TEX_MIPFILTER_NEAREST);
824
825   /* map the dst_surface so we can read from it */
826   tex_xfer = st_cond_flush_get_tex_transfer(st_context(ctx),
827					     dst_texture, 0, 0, 0,
828					     PIPE_TRANSFER_READ,
829					     0, 0, width, height);
830
831   pixels = _mesa_map_pbo_dest(ctx, &ctx->Pack, pixels);
832
833   /* copy/pack data into user buffer */
834   if (st_equal_formats(stImage->pt->format, format, type)) {
835      /* memcpy */
836      const uint bytesPerRow = width * util_format_get_blocksize(stImage->pt->format);
837      ubyte *map = screen->transfer_map(screen, tex_xfer);
838      GLuint row;
839      for (row = 0; row < height; row++) {
840         GLvoid *dest = _mesa_image_address2d(&ctx->Pack, pixels, width,
841                                              height, format, type, row, 0);
842         memcpy(dest, map, bytesPerRow);
843         map += tex_xfer->stride;
844      }
845      screen->transfer_unmap(screen, tex_xfer);
846   }
847   else {
848      /* format translation via floats */
849      GLuint row;
850      for (row = 0; row < height; row++) {
851         const GLbitfield transferOps = 0x0; /* bypassed for glGetTexImage() */
852         GLfloat rgba[4 * MAX_WIDTH];
853         GLvoid *dest = _mesa_image_address2d(&ctx->Pack, pixels, width,
854                                              height, format, type, row, 0);
855
856         if (ST_DEBUG & DEBUG_FALLBACK)
857            debug_printf("%s: fallback format translation\n", __FUNCTION__);
858
859         /* get float[4] rgba row from surface */
860         pipe_get_tile_rgba(tex_xfer, 0, row, width, 1, rgba);
861
862         _mesa_pack_rgba_span_float(ctx, width, (GLfloat (*)[4]) rgba, format,
863                                    type, dest, &ctx->Pack, transferOps);
864      }
865   }
866
867   _mesa_unmap_pbo_dest(ctx, &ctx->Pack);
868
869   /* destroy the temp / dest surface */
870   util_destroy_rgba_surface(dst_texture, dst_surface);
871}
872
873
874
875/**
876 * Need to map texture image into memory before copying image data,
877 * then unmap it.
878 */
879static void
880st_get_tex_image(GLcontext * ctx, GLenum target, GLint level,
881                 GLenum format, GLenum type, GLvoid * pixels,
882                 struct gl_texture_object *texObj,
883                 struct gl_texture_image *texImage, GLboolean compressed_dst)
884{
885   struct st_texture_image *stImage = st_texture_image(texImage);
886   const GLuint dstImageStride =
887      _mesa_image_image_stride(&ctx->Pack, texImage->Width, texImage->Height,
888                               format, type);
889   GLuint depth, i;
890   GLubyte *dest;
891
892   if (stImage->pt &&
893       util_format_is_compressed(stImage->pt->format) &&
894       !compressed_dst) {
895      /* Need to decompress the texture.
896       * We'll do this by rendering a textured quad.
897       * Note that we only expect RGBA formats (no Z/depth formats).
898       */
899      decompress_with_blit(ctx, target, level, format, type, pixels,
900                           texObj, texImage);
901      return;
902   }
903
904   /* Map */
905   if (stImage->pt) {
906      /* Image is stored in hardware format in a buffer managed by the
907       * kernel.  Need to explicitly map and unmap it.
908       */
909      unsigned face = _mesa_tex_target_to_face(target);
910
911      st_teximage_flush_before_map(ctx->st, stImage->pt, face, level,
912				   PIPE_TRANSFER_READ);
913
914      texImage->Data = st_texture_image_map(ctx->st, stImage, 0,
915                                            PIPE_TRANSFER_READ, 0, 0,
916                                            stImage->base.Width,
917                                            stImage->base.Height);
918      texImage->RowStride = stImage->transfer->stride / util_format_get_blocksize(stImage->pt->format);
919   }
920   else {
921      /* Otherwise, the image should actually be stored in
922       * texImage->Data.  This is pretty confusing for
923       * everybody, I'd much prefer to separate the two functions of
924       * texImage->Data - storage for texture images in main memory
925       * and access (ie mappings) of images.  In other words, we'd
926       * create a new texImage->Map field and leave Data simply for
927       * storage.
928       */
929      assert(texImage->Data);
930   }
931
932   depth = texImage->Depth;
933   texImage->Depth = 1;
934
935   dest = (GLubyte *) pixels;
936
937   for (i = 0; i < depth; i++) {
938      if (compressed_dst) {
939	 _mesa_get_compressed_teximage(ctx, target, level, dest,
940				       texObj, texImage);
941      }
942      else {
943	 _mesa_get_teximage(ctx, target, level, format, type, dest,
944			    texObj, texImage);
945      }
946
947      if (stImage->pt && i + 1 < depth) {
948         /* unmap this slice */
949	 st_texture_image_unmap(ctx->st, stImage);
950         /* map next slice of 3D texture */
951	 texImage->Data = st_texture_image_map(ctx->st, stImage, i + 1,
952                                               PIPE_TRANSFER_READ, 0, 0,
953                                               stImage->base.Width,
954                                               stImage->base.Height);
955	 dest += dstImageStride;
956      }
957   }
958
959   texImage->Depth = depth;
960
961   /* Unmap */
962   if (stImage->pt) {
963      st_texture_image_unmap(ctx->st, stImage);
964      texImage->Data = NULL;
965   }
966}
967
968
969static void
970st_GetTexImage(GLcontext * ctx, GLenum target, GLint level,
971               GLenum format, GLenum type, GLvoid * pixels,
972               struct gl_texture_object *texObj,
973               struct gl_texture_image *texImage)
974{
975   st_get_tex_image(ctx, target, level, format, type, pixels, texObj, texImage,
976                    GL_FALSE);
977}
978
979
980static void
981st_GetCompressedTexImage(GLcontext *ctx, GLenum target, GLint level,
982                         GLvoid *pixels,
983                         struct gl_texture_object *texObj,
984                         struct gl_texture_image *texImage)
985{
986   st_get_tex_image(ctx, target, level, 0, 0, pixels, texObj, texImage,
987                    GL_TRUE);
988}
989
990
991
992static void
993st_TexSubimage(GLcontext *ctx, GLint dims, GLenum target, GLint level,
994               GLint xoffset, GLint yoffset, GLint zoffset,
995               GLint width, GLint height, GLint depth,
996               GLenum format, GLenum type, const void *pixels,
997               const struct gl_pixelstore_attrib *packing,
998               struct gl_texture_object *texObj,
999               struct gl_texture_image *texImage)
1000{
1001   struct pipe_screen *screen = ctx->st->pipe->screen;
1002   struct st_texture_image *stImage = st_texture_image(texImage);
1003   GLuint dstRowStride;
1004   const GLuint srcImageStride =
1005      _mesa_image_image_stride(packing, width, height, format, type);
1006   GLint i;
1007   const GLubyte *src;
1008   /* init to silence warning only: */
1009   enum pipe_transfer_usage transfer_usage = PIPE_TRANSFER_WRITE;
1010
1011   DBG("%s target %s level %d offset %d,%d %dx%d\n", __FUNCTION__,
1012       _mesa_lookup_enum_by_nr(target),
1013       level, xoffset, yoffset, width, height);
1014
1015   pixels =
1016      _mesa_validate_pbo_teximage(ctx, dims, width, height, depth, format,
1017                                  type, pixels, packing, "glTexSubImage2D");
1018   if (!pixels)
1019      return;
1020
1021   /* See if we can do texture compression with a blit/render.
1022    */
1023   if (!ctx->Mesa_DXTn &&
1024       _mesa_is_format_compressed(texImage->TexFormat) &&
1025       screen->is_format_supported(screen,
1026                                   stImage->pt->format,
1027                                   stImage->pt->target,
1028                                   PIPE_TEXTURE_USAGE_RENDER_TARGET, 0)) {
1029      if (compress_with_blit(ctx, target, level,
1030                             xoffset, yoffset, zoffset,
1031                             width, height, depth,
1032                             format, type, pixels, packing, texImage)) {
1033         goto done;
1034      }
1035   }
1036
1037   /* Map buffer if necessary.  Need to lock to prevent other contexts
1038    * from uploading the buffer under us.
1039    */
1040   if (stImage->pt) {
1041      unsigned face = _mesa_tex_target_to_face(target);
1042
1043      if (format == GL_DEPTH_COMPONENT &&
1044          util_format_is_depth_and_stencil(stImage->pt->format))
1045         transfer_usage = PIPE_TRANSFER_READ_WRITE;
1046      else
1047         transfer_usage = PIPE_TRANSFER_WRITE;
1048
1049      st_teximage_flush_before_map(ctx->st, stImage->pt, face, level,
1050				   transfer_usage);
1051      texImage->Data = st_texture_image_map(ctx->st, stImage, zoffset,
1052                                            transfer_usage,
1053                                            xoffset, yoffset,
1054                                            width, height);
1055   }
1056
1057   if (!texImage->Data) {
1058      _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexSubImage");
1059      goto done;
1060   }
1061
1062   src = (const GLubyte *) pixels;
1063   dstRowStride = stImage->transfer->stride;
1064
1065   for (i = 0; i < depth; i++) {
1066      if (!_mesa_texstore(ctx, dims, texImage->_BaseFormat,
1067                          texImage->TexFormat,
1068                          texImage->Data,
1069                          0, 0, 0,
1070                          dstRowStride,
1071                          texImage->ImageOffsets,
1072                          width, height, 1,
1073                          format, type, src, packing)) {
1074	 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexSubImage");
1075      }
1076
1077      if (stImage->pt && i + 1 < depth) {
1078         /* unmap this slice */
1079	 st_texture_image_unmap(ctx->st, stImage);
1080         /* map next slice of 3D texture */
1081	 texImage->Data = st_texture_image_map(ctx->st, stImage,
1082                                               zoffset + i + 1,
1083                                               transfer_usage,
1084                                               xoffset, yoffset,
1085                                               width, height);
1086	 src += srcImageStride;
1087      }
1088   }
1089
1090done:
1091   _mesa_unmap_teximage_pbo(ctx, packing);
1092
1093   if (stImage->pt) {
1094      st_texture_image_unmap(ctx->st, stImage);
1095      texImage->Data = NULL;
1096   }
1097}
1098
1099
1100
1101static void
1102st_TexSubImage3D(GLcontext *ctx, GLenum target, GLint level,
1103                 GLint xoffset, GLint yoffset, GLint zoffset,
1104                 GLsizei width, GLsizei height, GLsizei depth,
1105                 GLenum format, GLenum type, const GLvoid *pixels,
1106                 const struct gl_pixelstore_attrib *packing,
1107                 struct gl_texture_object *texObj,
1108                 struct gl_texture_image *texImage)
1109{
1110   st_TexSubimage(ctx, 3, target, level, xoffset, yoffset, zoffset,
1111                  width, height, depth, format, type,
1112                  pixels, packing, texObj, texImage);
1113}
1114
1115
1116static void
1117st_TexSubImage2D(GLcontext *ctx, GLenum target, GLint level,
1118                 GLint xoffset, GLint yoffset,
1119                 GLsizei width, GLsizei height,
1120                 GLenum format, GLenum type, const GLvoid * pixels,
1121                 const struct gl_pixelstore_attrib *packing,
1122                 struct gl_texture_object *texObj,
1123                 struct gl_texture_image *texImage)
1124{
1125   st_TexSubimage(ctx, 2, target, level, xoffset, yoffset, 0,
1126                  width, height, 1, format, type,
1127                  pixels, packing, texObj, texImage);
1128}
1129
1130
1131static void
1132st_TexSubImage1D(GLcontext *ctx, GLenum target, GLint level,
1133                 GLint xoffset, GLsizei width, GLenum format, GLenum type,
1134                 const GLvoid * pixels,
1135                 const struct gl_pixelstore_attrib *packing,
1136                 struct gl_texture_object *texObj,
1137                 struct gl_texture_image *texImage)
1138{
1139   st_TexSubimage(ctx, 1, target, level, xoffset, 0, 0, width, 1, 1,
1140                  format, type, pixels, packing, texObj, texImage);
1141}
1142
1143
1144static void
1145st_CompressedTexSubImage1D(GLcontext *ctx, GLenum target, GLint level,
1146                           GLint xoffset, GLsizei width,
1147                           GLenum format,
1148                           GLsizei imageSize, const GLvoid *data,
1149                           struct gl_texture_object *texObj,
1150                           struct gl_texture_image *texImage)
1151{
1152   assert(0);
1153}
1154
1155
1156static void
1157st_CompressedTexSubImage2D(GLcontext *ctx, GLenum target, GLint level,
1158                           GLint xoffset, GLint yoffset,
1159                           GLsizei width, GLint height,
1160                           GLenum format,
1161                           GLsizei imageSize, const GLvoid *data,
1162                           struct gl_texture_object *texObj,
1163                           struct gl_texture_image *texImage)
1164{
1165   struct st_texture_image *stImage = st_texture_image(texImage);
1166   int srcBlockStride;
1167   int dstBlockStride;
1168   int y;
1169   enum pipe_format pformat= stImage->pt->format;
1170
1171   if (stImage->pt) {
1172      unsigned face = _mesa_tex_target_to_face(target);
1173
1174      st_teximage_flush_before_map(ctx->st, stImage->pt, face, level,
1175				   PIPE_TRANSFER_WRITE);
1176      texImage->Data = st_texture_image_map(ctx->st, stImage, 0,
1177                                            PIPE_TRANSFER_WRITE,
1178                                            xoffset, yoffset,
1179                                            width, height);
1180
1181      srcBlockStride = util_format_get_stride(pformat, width);
1182      dstBlockStride = stImage->transfer->stride;
1183   } else {
1184      assert(stImage->pt);
1185      /* TODO find good values for block and strides */
1186      /* TODO also adjust texImage->data for yoffset/xoffset */
1187      return;
1188   }
1189
1190   if (!texImage->Data) {
1191      _mesa_error(ctx, GL_OUT_OF_MEMORY, "glCompressedTexSubImage");
1192      return;
1193   }
1194
1195   assert(xoffset % util_format_get_blockwidth(pformat) == 0);
1196   assert(yoffset % util_format_get_blockheight(pformat) == 0);
1197   assert(width % util_format_get_blockwidth(pformat) == 0);
1198   assert(height % util_format_get_blockheight(pformat) == 0);
1199
1200   for (y = 0; y < height; y += util_format_get_blockheight(pformat)) {
1201      /* don't need to adjust for xoffset and yoffset as st_texture_image_map does that */
1202      const char *src = (const char*)data + srcBlockStride * util_format_get_nblocksy(pformat, y);
1203      char *dst = (char*)texImage->Data + dstBlockStride * util_format_get_nblocksy(pformat, y);
1204      memcpy(dst, src, util_format_get_stride(pformat, width));
1205   }
1206
1207   if (stImage->pt) {
1208      st_texture_image_unmap(ctx->st, stImage);
1209      texImage->Data = NULL;
1210   }
1211}
1212
1213
1214static void
1215st_CompressedTexSubImage3D(GLcontext *ctx, GLenum target, GLint level,
1216                           GLint xoffset, GLint yoffset, GLint zoffset,
1217                           GLsizei width, GLint height, GLint depth,
1218                           GLenum format,
1219                           GLsizei imageSize, const GLvoid *data,
1220                           struct gl_texture_object *texObj,
1221                           struct gl_texture_image *texImage)
1222{
1223   assert(0);
1224}
1225
1226
1227
1228/**
1229 * Do a CopyTexSubImage operation using a read transfer from the source,
1230 * a write transfer to the destination and get_tile()/put_tile() to access
1231 * the pixels/texels.
1232 *
1233 * Note: srcY=0=TOP of renderbuffer
1234 */
1235static void
1236fallback_copy_texsubimage(GLcontext *ctx, GLenum target, GLint level,
1237                          struct st_renderbuffer *strb,
1238                          struct st_texture_image *stImage,
1239                          GLenum baseFormat,
1240                          GLint destX, GLint destY, GLint destZ,
1241                          GLint srcX, GLint srcY,
1242                          GLsizei width, GLsizei height)
1243{
1244   struct pipe_context *pipe = ctx->st->pipe;
1245   struct pipe_screen *screen = pipe->screen;
1246   struct pipe_transfer *src_trans;
1247   GLvoid *texDest;
1248   enum pipe_transfer_usage transfer_usage;
1249
1250   if (ST_DEBUG & DEBUG_FALLBACK)
1251      debug_printf("%s: fallback processing\n", __FUNCTION__);
1252
1253   assert(width <= MAX_WIDTH);
1254
1255   if (st_fb_orientation(ctx->ReadBuffer) == Y_0_TOP) {
1256      srcY = strb->Base.Height - srcY - height;
1257   }
1258
1259   src_trans = st_cond_flush_get_tex_transfer( st_context(ctx),
1260					       strb->texture,
1261					       0, 0, 0,
1262					       PIPE_TRANSFER_READ,
1263					       srcX, srcY,
1264					       width, height);
1265
1266   if ((baseFormat == GL_DEPTH_COMPONENT ||
1267        baseFormat == GL_DEPTH_STENCIL) &&
1268       util_format_is_depth_and_stencil(stImage->pt->format))
1269      transfer_usage = PIPE_TRANSFER_READ_WRITE;
1270   else
1271      transfer_usage = PIPE_TRANSFER_WRITE;
1272
1273   st_teximage_flush_before_map(ctx->st, stImage->pt, 0, 0,
1274				transfer_usage);
1275
1276   texDest = st_texture_image_map(ctx->st, stImage, 0, transfer_usage,
1277                                  destX, destY, width, height);
1278
1279   if (baseFormat == GL_DEPTH_COMPONENT ||
1280       baseFormat == GL_DEPTH_STENCIL) {
1281      const GLboolean scaleOrBias = (ctx->Pixel.DepthScale != 1.0F ||
1282                                     ctx->Pixel.DepthBias != 0.0F);
1283      GLint row, yStep;
1284
1285      /* determine bottom-to-top vs. top-to-bottom order for src buffer */
1286      if (st_fb_orientation(ctx->ReadBuffer) == Y_0_TOP) {
1287         srcY = height - 1;
1288         yStep = -1;
1289      }
1290      else {
1291         srcY = 0;
1292         yStep = 1;
1293      }
1294
1295      /* To avoid a large temp memory allocation, do copy row by row */
1296      for (row = 0; row < height; row++, srcY += yStep) {
1297         uint data[MAX_WIDTH];
1298         pipe_get_tile_z(src_trans, 0, srcY, width, 1, data);
1299         if (scaleOrBias) {
1300            _mesa_scale_and_bias_depth_uint(ctx, width, data);
1301         }
1302         pipe_put_tile_z(stImage->transfer, 0, row, width, 1, data);
1303      }
1304   }
1305   else {
1306      /* RGBA format */
1307      GLfloat *tempSrc =
1308         (GLfloat *) _mesa_malloc(width * height * 4 * sizeof(GLfloat));
1309
1310      if (tempSrc && texDest) {
1311         const GLint dims = 2;
1312         const GLint dstRowStride = stImage->transfer->stride;
1313         struct gl_texture_image *texImage = &stImage->base;
1314         struct gl_pixelstore_attrib unpack = ctx->DefaultPacking;
1315
1316         if (st_fb_orientation(ctx->ReadBuffer) == Y_0_TOP) {
1317            unpack.Invert = GL_TRUE;
1318         }
1319
1320         /* get float/RGBA image from framebuffer */
1321         /* XXX this usually involves a lot of int/float conversion.
1322          * try to avoid that someday.
1323          */
1324         pipe_get_tile_rgba(src_trans, 0, 0, width, height, tempSrc);
1325
1326         /* Store into texture memory.
1327          * Note that this does some special things such as pixel transfer
1328          * ops and format conversion.  In particular, if the dest tex format
1329          * is actually RGBA but the user created the texture as GL_RGB we
1330          * need to fill-in/override the alpha channel with 1.0.
1331          */
1332         _mesa_texstore(ctx, dims,
1333                        texImage->_BaseFormat,
1334                        texImage->TexFormat,
1335                        texDest,
1336                        0, 0, 0,
1337                        dstRowStride,
1338                        texImage->ImageOffsets,
1339                        width, height, 1,
1340                        GL_RGBA, GL_FLOAT, tempSrc, /* src */
1341                        &unpack);
1342      }
1343      else {
1344         _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexSubImage");
1345      }
1346
1347      if (tempSrc)
1348         _mesa_free(tempSrc);
1349   }
1350
1351   st_texture_image_unmap(ctx->st, stImage);
1352   screen->tex_transfer_destroy(src_trans);
1353}
1354
1355
1356static unsigned
1357compatible_src_dst_formats(const struct gl_renderbuffer *src,
1358                           const struct gl_texture_image *dst)
1359{
1360   const GLenum srcFormat = _mesa_get_format_base_format(src->Format);
1361   const GLenum dstLogicalFormat = _mesa_get_format_base_format(dst->TexFormat);
1362
1363   if (srcFormat == dstLogicalFormat) {
1364      /* This is the same as matching_base_formats, which should
1365       * always pass, as it did previously.
1366       */
1367      return TGSI_WRITEMASK_XYZW;
1368   }
1369   else if (srcFormat == GL_RGBA &&
1370            dstLogicalFormat == GL_RGB) {
1371      /* Add a single special case to cope with RGBA->RGB transfers,
1372       * setting A to 1.0 to cope with situations where the RGB
1373       * destination is actually stored as RGBA.
1374       */
1375      return TGSI_WRITEMASK_XYZ; /* A ==> 1.0 */
1376   }
1377   else {
1378      if (ST_DEBUG & DEBUG_FALLBACK)
1379         debug_printf("%s failed for src %s, dst %s\n",
1380                      __FUNCTION__,
1381                      _mesa_lookup_enum_by_nr(srcFormat),
1382                      _mesa_lookup_enum_by_nr(dstLogicalFormat));
1383
1384      /* Otherwise fail.
1385       */
1386      return 0;
1387   }
1388}
1389
1390
1391
1392/**
1393 * Do a CopyTex[Sub]Image1/2/3D() using a hardware (blit) path if possible.
1394 * Note that the region to copy has already been clipped so we know we
1395 * won't read from outside the source renderbuffer's bounds.
1396 *
1397 * Note: srcY=0=Bottom of renderbuffer (GL convention)
1398 */
1399static void
1400st_copy_texsubimage(GLcontext *ctx,
1401                    GLenum target, GLint level,
1402                    GLint destX, GLint destY, GLint destZ,
1403                    GLint srcX, GLint srcY,
1404                    GLsizei width, GLsizei height)
1405{
1406   struct gl_texture_unit *texUnit =
1407      &ctx->Texture.Unit[ctx->Texture.CurrentUnit];
1408   struct gl_texture_object *texObj =
1409      _mesa_select_tex_object(ctx, texUnit, target);
1410   struct gl_texture_image *texImage =
1411      _mesa_select_tex_image(ctx, texObj, target, level);
1412   struct st_texture_image *stImage = st_texture_image(texImage);
1413   const GLenum texBaseFormat = texImage->_BaseFormat;
1414   struct gl_framebuffer *fb = ctx->ReadBuffer;
1415   struct st_renderbuffer *strb;
1416   struct pipe_context *pipe = ctx->st->pipe;
1417   struct pipe_screen *screen = pipe->screen;
1418   enum pipe_format dest_format, src_format;
1419   GLboolean use_fallback = GL_TRUE;
1420   GLboolean matching_base_formats;
1421   GLuint format_writemask;
1422   struct pipe_surface *dest_surface = NULL;
1423   GLboolean do_flip = (st_fb_orientation(ctx->ReadBuffer) == Y_0_TOP);
1424
1425   /* any rendering in progress must flushed before we grab the fb image */
1426   st_flush(ctx->st, PIPE_FLUSH_RENDER_CACHE, NULL);
1427
1428   /* make sure finalize_textures has been called?
1429    */
1430   if (0) st_validate_state(ctx->st);
1431
1432   /* determine if copying depth or color data */
1433   if (texBaseFormat == GL_DEPTH_COMPONENT ||
1434       texBaseFormat == GL_DEPTH_STENCIL) {
1435      strb = st_renderbuffer(fb->_DepthBuffer);
1436   }
1437   else {
1438      /* texBaseFormat == GL_RGB, GL_RGBA, GL_ALPHA, etc */
1439      strb = st_renderbuffer(fb->_ColorReadBuffer);
1440   }
1441
1442   if (!strb || !strb->surface || !stImage->pt) {
1443      debug_printf("%s: null strb or stImage\n", __FUNCTION__);
1444      return;
1445   }
1446
1447   if (srcX < 0) {
1448      width -= -srcX;
1449      destX += -srcX;
1450      srcX = 0;
1451   }
1452
1453   if (srcY < 0) {
1454      height -= -srcY;
1455      destY += -srcY;
1456      srcY = 0;
1457   }
1458
1459   if (destX < 0) {
1460      width -= -destX;
1461      srcX += -destX;
1462      destX = 0;
1463   }
1464
1465   if (destY < 0) {
1466      height -= -destY;
1467      srcY += -destY;
1468      destY = 0;
1469   }
1470
1471   if (width < 0 || height < 0)
1472      return;
1473
1474
1475   assert(strb);
1476   assert(strb->surface);
1477   assert(stImage->pt);
1478
1479   src_format = strb->surface->format;
1480   dest_format = stImage->pt->format;
1481
1482   /*
1483    * Determine if the src framebuffer and dest texture have the same
1484    * base format.  We need this to detect a case such as the framebuffer
1485    * being GL_RGBA but the texture being GL_RGB.  If the actual hardware
1486    * texture format stores RGBA we need to set A=1 (overriding the
1487    * framebuffer's alpha values).  We can't do that with the blit or
1488    * textured-quad paths.
1489    */
1490   matching_base_formats =
1491      (_mesa_get_format_base_format(strb->Base.Format) ==
1492       _mesa_get_format_base_format(texImage->TexFormat));
1493   format_writemask = compatible_src_dst_formats(&strb->Base, texImage);
1494
1495   if (ctx->_ImageTransferState == 0x0) {
1496
1497      if (pipe->surface_copy &&
1498          matching_base_formats &&
1499          src_format == dest_format &&
1500          !do_flip)
1501      {
1502         /* use surface_copy() / blit */
1503
1504         dest_surface = screen->get_tex_surface(screen, stImage->pt,
1505                                                stImage->face, stImage->level,
1506                                                destZ,
1507                                                PIPE_BUFFER_USAGE_GPU_WRITE);
1508
1509         /* for surface_copy(), y=0=top, always */
1510         pipe->surface_copy(pipe,
1511                            /* dest */
1512                            dest_surface,
1513                            destX, destY,
1514                            /* src */
1515                            strb->surface,
1516                            srcX, srcY,
1517                            /* size */
1518                            width, height);
1519         use_fallback = GL_FALSE;
1520      }
1521      else if (format_writemask &&
1522               texBaseFormat != GL_DEPTH_COMPONENT &&
1523               texBaseFormat != GL_DEPTH_STENCIL &&
1524               screen->is_format_supported(screen, src_format,
1525                                           PIPE_TEXTURE_2D,
1526                                           PIPE_TEXTURE_USAGE_SAMPLER,
1527                                           0) &&
1528               screen->is_format_supported(screen, dest_format,
1529                                           PIPE_TEXTURE_2D,
1530                                           PIPE_TEXTURE_USAGE_RENDER_TARGET,
1531                                           0)) {
1532         /* draw textured quad to do the copy */
1533         GLint srcY0, srcY1;
1534
1535         dest_surface = screen->get_tex_surface(screen, stImage->pt,
1536                                                stImage->face, stImage->level,
1537                                                destZ,
1538                                                PIPE_BUFFER_USAGE_GPU_WRITE);
1539
1540         if (do_flip) {
1541            srcY1 = strb->Base.Height - srcY - height;
1542            srcY0 = srcY1 + height;
1543         }
1544         else {
1545            srcY0 = srcY;
1546            srcY1 = srcY0 + height;
1547         }
1548         util_blit_pixels_writemask(ctx->st->blit,
1549                                    strb->surface,
1550                                    srcX, srcY0,
1551                                    srcX + width, srcY1,
1552                                    dest_surface,
1553                                    destX, destY,
1554                                    destX + width, destY + height,
1555                                    0.0, PIPE_TEX_MIPFILTER_NEAREST,
1556                                    format_writemask);
1557         use_fallback = GL_FALSE;
1558      }
1559
1560      if (dest_surface)
1561         pipe_surface_reference(&dest_surface, NULL);
1562   }
1563
1564   if (use_fallback) {
1565      /* software fallback */
1566      fallback_copy_texsubimage(ctx, target, level,
1567                                strb, stImage, texBaseFormat,
1568                                destX, destY, destZ,
1569                                srcX, srcY, width, height);
1570   }
1571}
1572
1573
1574
1575static void
1576st_CopyTexImage1D(GLcontext * ctx, GLenum target, GLint level,
1577                  GLenum internalFormat,
1578                  GLint x, GLint y, GLsizei width, GLint border)
1579{
1580   struct gl_texture_unit *texUnit =
1581      &ctx->Texture.Unit[ctx->Texture.CurrentUnit];
1582   struct gl_texture_object *texObj =
1583      _mesa_select_tex_object(ctx, texUnit, target);
1584   struct gl_texture_image *texImage =
1585      _mesa_select_tex_image(ctx, texObj, target, level);
1586
1587   /* Setup or redefine the texture object, texture and texture
1588    * image.  Don't populate yet.
1589    */
1590   ctx->Driver.TexImage1D(ctx, target, level, internalFormat,
1591                          width, border,
1592                          GL_RGBA, CHAN_TYPE, NULL,
1593                          &ctx->DefaultPacking, texObj, texImage);
1594
1595   st_copy_texsubimage(ctx, target, level,
1596                       0, 0, 0,  /* destX,Y,Z */
1597                       x, y, width, 1);  /* src X, Y, size */
1598}
1599
1600
1601static void
1602st_CopyTexImage2D(GLcontext * ctx, GLenum target, GLint level,
1603                  GLenum internalFormat,
1604                  GLint x, GLint y, GLsizei width, GLsizei height,
1605                  GLint border)
1606{
1607   struct gl_texture_unit *texUnit =
1608      &ctx->Texture.Unit[ctx->Texture.CurrentUnit];
1609   struct gl_texture_object *texObj =
1610      _mesa_select_tex_object(ctx, texUnit, target);
1611   struct gl_texture_image *texImage =
1612      _mesa_select_tex_image(ctx, texObj, target, level);
1613
1614   /* Setup or redefine the texture object, texture and texture
1615    * image.  Don't populate yet.
1616    */
1617   ctx->Driver.TexImage2D(ctx, target, level, internalFormat,
1618                          width, height, border,
1619                          GL_RGBA, CHAN_TYPE, NULL,
1620                          &ctx->DefaultPacking, texObj, texImage);
1621
1622   st_copy_texsubimage(ctx, target, level,
1623                       0, 0, 0,  /* destX,Y,Z */
1624                       x, y, width, height);  /* src X, Y, size */
1625}
1626
1627
1628static void
1629st_CopyTexSubImage1D(GLcontext * ctx, GLenum target, GLint level,
1630                     GLint xoffset, GLint x, GLint y, GLsizei width)
1631{
1632   const GLint yoffset = 0, zoffset = 0;
1633   const GLsizei height = 1;
1634   st_copy_texsubimage(ctx, target, level,
1635                       xoffset, yoffset, zoffset,  /* destX,Y,Z */
1636                       x, y, width, height);  /* src X, Y, size */
1637}
1638
1639
1640static void
1641st_CopyTexSubImage2D(GLcontext * ctx, GLenum target, GLint level,
1642                     GLint xoffset, GLint yoffset,
1643                     GLint x, GLint y, GLsizei width, GLsizei height)
1644{
1645   const GLint zoffset = 0;
1646   st_copy_texsubimage(ctx, target, level,
1647                       xoffset, yoffset, zoffset,  /* destX,Y,Z */
1648                       x, y, width, height);  /* src X, Y, size */
1649}
1650
1651
1652static void
1653st_CopyTexSubImage3D(GLcontext * ctx, GLenum target, GLint level,
1654                     GLint xoffset, GLint yoffset, GLint zoffset,
1655                     GLint x, GLint y, GLsizei width, GLsizei height)
1656{
1657   st_copy_texsubimage(ctx, target, level,
1658                       xoffset, yoffset, zoffset,  /* destX,Y,Z */
1659                       x, y, width, height);  /* src X, Y, size */
1660}
1661
1662
1663static void
1664copy_image_data_to_texture(struct st_context *st,
1665			   struct st_texture_object *stObj,
1666                           GLuint dstLevel,
1667			   struct st_texture_image *stImage)
1668{
1669   if (stImage->pt) {
1670      /* Copy potentially with the blitter:
1671       */
1672      st_texture_image_copy(st->pipe,
1673                            stObj->pt, dstLevel,  /* dest texture, level */
1674                            stImage->pt, /* src texture */
1675                            stImage->face
1676                            );
1677
1678      pipe_texture_reference(&stImage->pt, NULL);
1679   }
1680   else if (stImage->base.Data) {
1681      /* More straightforward upload.
1682       */
1683
1684      st_teximage_flush_before_map(st, stObj->pt, stImage->face, dstLevel,
1685				   PIPE_TRANSFER_WRITE);
1686
1687
1688      st_texture_image_data(st,
1689                            stObj->pt,
1690                            stImage->face,
1691                            dstLevel,
1692                            stImage->base.Data,
1693                            stImage->base.RowStride *
1694                            util_format_get_blocksize(stObj->pt->format),
1695                            stImage->base.RowStride *
1696                            stImage->base.Height *
1697                            util_format_get_blocksize(stObj->pt->format));
1698      _mesa_align_free(stImage->base.Data);
1699      stImage->base.Data = NULL;
1700   }
1701
1702   pipe_texture_reference(&stImage->pt, stObj->pt);
1703}
1704
1705
1706/**
1707 * Called during state validation.  When this function is finished,
1708 * the texture object should be ready for rendering.
1709 * \return GL_TRUE for success, GL_FALSE for failure (out of mem)
1710 */
1711GLboolean
1712st_finalize_texture(GLcontext *ctx,
1713		    struct pipe_context *pipe,
1714		    struct gl_texture_object *tObj,
1715		    GLboolean *needFlush)
1716{
1717   struct st_texture_object *stObj = st_texture_object(tObj);
1718   const GLuint nr_faces = (stObj->base.Target == GL_TEXTURE_CUBE_MAP) ? 6 : 1;
1719   GLuint blockSize, face;
1720   struct st_texture_image *firstImage;
1721
1722   *needFlush = GL_FALSE;
1723
1724   if (stObj->base._Complete) {
1725      /* The texture is complete and we know exactly how many mipmap levels
1726       * are present/needed.  This is conditional because we may be called
1727       * from the st_generate_mipmap() function when the texture object is
1728       * incomplete.  In that case, we'll have set stObj->lastLevel before
1729       * we get here.
1730       */
1731      if (stObj->base.MinFilter == GL_LINEAR ||
1732          stObj->base.MinFilter == GL_NEAREST)
1733         stObj->lastLevel = stObj->base.BaseLevel;
1734      else
1735         stObj->lastLevel = stObj->base._MaxLevel - stObj->base.BaseLevel;
1736   }
1737
1738   firstImage = st_texture_image(stObj->base.Image[0][stObj->base.BaseLevel]);
1739
1740   /* If both firstImage and stObj point to a texture which can contain
1741    * all active images, favour firstImage.  Note that because of the
1742    * completeness requirement, we know that the image dimensions
1743    * will match.
1744    */
1745   if (firstImage->pt &&
1746       firstImage->pt != stObj->pt &&
1747       firstImage->pt->last_level >= stObj->lastLevel) {
1748      pipe_texture_reference(&stObj->pt, firstImage->pt);
1749   }
1750
1751   /* bytes per pixel block (blocks are usually 1x1) */
1752   blockSize = _mesa_get_format_bytes(firstImage->base.TexFormat);
1753
1754   /* If we already have a gallium texture, check that it matches the texture
1755    * object's format, target, size, num_levels, etc.
1756    */
1757   if (stObj->pt) {
1758      const enum pipe_format fmt =
1759         st_mesa_format_to_pipe_format(firstImage->base.TexFormat);
1760      if (stObj->pt->target != gl_target_to_pipe(stObj->base.Target) ||
1761          stObj->pt->format != fmt ||
1762          stObj->pt->last_level < stObj->lastLevel ||
1763          stObj->pt->width0 != firstImage->base.Width2 ||
1764          stObj->pt->height0 != firstImage->base.Height2 ||
1765          stObj->pt->depth0 != firstImage->base.Depth2)
1766      {
1767         pipe_texture_reference(&stObj->pt, NULL);
1768         ctx->st->dirty.st |= ST_NEW_FRAMEBUFFER;
1769      }
1770   }
1771
1772   /* May need to create a new gallium texture:
1773    */
1774   if (!stObj->pt) {
1775      const enum pipe_format fmt =
1776         st_mesa_format_to_pipe_format(firstImage->base.TexFormat);
1777      GLuint usage = default_usage(fmt);
1778
1779      stObj->pt = st_texture_create(ctx->st,
1780                                    gl_target_to_pipe(stObj->base.Target),
1781                                    fmt,
1782                                    stObj->lastLevel,
1783                                    firstImage->base.Width2,
1784                                    firstImage->base.Height2,
1785                                    firstImage->base.Depth2,
1786                                    usage);
1787
1788      if (!stObj->pt) {
1789         _mesa_error(ctx, GL_OUT_OF_MEMORY, "glTexImage");
1790         return GL_FALSE;
1791      }
1792   }
1793
1794   /* Pull in any images not in the object's texture:
1795    */
1796   for (face = 0; face < nr_faces; face++) {
1797      GLuint level;
1798      for (level = 0; level <= stObj->lastLevel; level++) {
1799         struct st_texture_image *stImage =
1800            st_texture_image(stObj->base.Image[face][stObj->base.BaseLevel + level]);
1801
1802         /* Need to import images in main memory or held in other textures.
1803          */
1804         if (stImage && stObj->pt != stImage->pt) {
1805            copy_image_data_to_texture(ctx->st, stObj, level, stImage);
1806	    *needFlush = GL_TRUE;
1807         }
1808      }
1809   }
1810
1811   return GL_TRUE;
1812}
1813
1814
1815/**
1816 * Returns pointer to a default/dummy texture.
1817 * This is typically used when the current shader has tex/sample instructions
1818 * but the user has not provided a (any) texture(s).
1819 */
1820struct gl_texture_object *
1821st_get_default_texture(struct st_context *st)
1822{
1823   if (!st->default_texture) {
1824      static const GLenum target = GL_TEXTURE_2D;
1825      GLubyte pixels[16][16][4];
1826      struct gl_texture_object *texObj;
1827      struct gl_texture_image *texImg;
1828      GLuint i, j;
1829
1830      /* The ARB_fragment_program spec says (0,0,0,1) should be returned
1831       * when attempting to sample incomplete textures.
1832       */
1833      for (i = 0; i < 16; i++) {
1834         for (j = 0; j < 16; j++) {
1835            pixels[i][j][0] = 0;
1836            pixels[i][j][1] = 0;
1837            pixels[i][j][2] = 0;
1838            pixels[i][j][3] = 255;
1839         }
1840      }
1841
1842      texObj = st->ctx->Driver.NewTextureObject(st->ctx, 0, target);
1843
1844      texImg = _mesa_get_tex_image(st->ctx, texObj, target, 0);
1845
1846      _mesa_init_teximage_fields(st->ctx, target, texImg,
1847                                 16, 16, 1, 0,  /* w, h, d, border */
1848                                 GL_RGBA);
1849
1850      st_TexImage(st->ctx, 2, target,
1851                  0, GL_RGBA,    /* level, intformat */
1852                  16, 16, 1, 0,  /* w, h, d, border */
1853                  GL_RGBA, GL_UNSIGNED_BYTE, pixels,
1854                  &st->ctx->DefaultPacking,
1855                  texObj, texImg,
1856                  0, 0);
1857
1858      texObj->MinFilter = GL_NEAREST;
1859      texObj->MagFilter = GL_NEAREST;
1860      texObj->_Complete = GL_TRUE;
1861
1862      st->default_texture = texObj;
1863   }
1864   return st->default_texture;
1865}
1866
1867
1868void
1869st_init_texture_functions(struct dd_function_table *functions)
1870{
1871   functions->ChooseTextureFormat = st_ChooseTextureFormat;
1872   functions->TexImage1D = st_TexImage1D;
1873   functions->TexImage2D = st_TexImage2D;
1874   functions->TexImage3D = st_TexImage3D;
1875   functions->TexSubImage1D = st_TexSubImage1D;
1876   functions->TexSubImage2D = st_TexSubImage2D;
1877   functions->TexSubImage3D = st_TexSubImage3D;
1878   functions->CompressedTexSubImage1D = st_CompressedTexSubImage1D;
1879   functions->CompressedTexSubImage2D = st_CompressedTexSubImage2D;
1880   functions->CompressedTexSubImage3D = st_CompressedTexSubImage3D;
1881   functions->CopyTexImage1D = st_CopyTexImage1D;
1882   functions->CopyTexImage2D = st_CopyTexImage2D;
1883   functions->CopyTexSubImage1D = st_CopyTexSubImage1D;
1884   functions->CopyTexSubImage2D = st_CopyTexSubImage2D;
1885   functions->CopyTexSubImage3D = st_CopyTexSubImage3D;
1886   functions->GenerateMipmap = st_generate_mipmap;
1887
1888   functions->GetTexImage = st_GetTexImage;
1889
1890   /* compressed texture functions */
1891   functions->CompressedTexImage2D = st_CompressedTexImage2D;
1892   functions->GetCompressedTexImage = st_GetCompressedTexImage;
1893
1894   functions->NewTextureObject = st_NewTextureObject;
1895   functions->NewTextureImage = st_NewTextureImage;
1896   functions->DeleteTexture = st_DeleteTextureObject;
1897   functions->FreeTexImageData = st_FreeTextureImageData;
1898   functions->UpdateTexturePalette = 0;
1899
1900   functions->TextureMemCpy = do_memcpy;
1901
1902   /* XXX Temporary until we can query pipe's texture sizes */
1903   functions->TestProxyTexImage = _mesa_test_proxy_teximage;
1904}
1905