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