src/mesa/main/texstorage.h

   1 /*
   2  * Mesa 3-D graphics library
   3  *
   4  * Copyright (C) 2011  VMware, Inc.  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 "Software"),
   8  * to deal in the Software without restriction, including without limitation
   9  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  10  * and/or sell copies of the Software, and to permit persons to whom the
  11  * Software is furnished to do so, subject to the following conditions:
  12  *
  13  * The above copyright notice and this permission notice shall be included
  14  * in all copies or substantial portions of the Software.
  15  *
  16  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  17  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  18  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  19  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  20  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  21  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  22  * OTHER DEALINGS IN THE SOFTWARE.
  23  */
  24
  25
  26 #ifndef TEXSTORAGE_H
  27 #define TEXSTORAGE_H
  28
  29 /**
  30  * \name Internal functions
  31  */
  32 /*@{*/
  33
  34 /**
  35  * Texture width, height and depth check shared with the
  36  * multisample variants of TexStorage functions.
  37  *
  38  * From OpenGL 4.5 Core spec, page 260 (section 8.19)
  39  *
  40  *     "An INVALID_VALUE error is generated if width, height, depth
  41  *     or levels are less than 1, for commands with the corresponding
  42  *     parameters."
  43  *
  44  * (referring to TextureStorage* commands, these also match values
  45  * specified for OpenGL ES 3.1.)
  46  */
  47 static inline bool
  48 _mesa_valid_tex_storage_dim(GLsizei width, GLsizei height, GLsizei depth)
  49 {
  50    if (width < 1 || height < 1 || depth < 1)
  51       return false;
  52    return true;
  53 }
  54
  55 /*@}*/
  56
  57 /**
  58  * \name API functions
  59  */
  60 /*@{*/
  61
  62 void GLAPIENTRY
  63 _mesa_TexStorage1D_no_error(GLenum target, GLsizei levels,
  64                             GLenum internalformat, GLsizei width);
  65
  66 extern void GLAPIENTRY
  67 _mesa_TexStorage1D(GLenum target, GLsizei levels, GLenum internalformat,
  68                    GLsizei width);
  69
  70 void GLAPIENTRY
  71 _mesa_TexStorage2D_no_error(GLenum target, GLsizei levels,
  72                             GLenum internalformat, GLsizei width,
  73                             GLsizei height);
  74
  75 extern void GLAPIENTRY
  76 _mesa_TexStorage2D(GLenum target, GLsizei levels, GLenum internalformat,
  77                    GLsizei width, GLsizei height);
  78
  79 void GLAPIENTRY
  80 _mesa_TexStorage3D_no_error(GLenum target, GLsizei levels,
  81                             GLenum internalformat, GLsizei width,
  82                             GLsizei height, GLsizei depth);
  83
  84 extern void GLAPIENTRY
  85 _mesa_TexStorage3D(GLenum target, GLsizei levels, GLenum internalformat,
  86                    GLsizei width, GLsizei height, GLsizei depth);
  87
  88 void GLAPIENTRY
  89 _mesa_TextureStorage1D_no_error(GLuint texture, GLsizei levels,
  90                                 GLenum internalformat, GLsizei width);
  91
  92 extern void GLAPIENTRY
  93 _mesa_TextureStorage1D(GLuint texture, GLsizei levels, GLenum internalformat,
  94                        GLsizei width);
  95
  96 void GLAPIENTRY
  97 _mesa_TextureStorage2D_no_error(GLuint texture, GLsizei levels,
  98                                 GLenum internalformat, GLsizei width,
  99                                 GLsizei height);
 100
 101 extern void GLAPIENTRY
 102 _mesa_TextureStorage2D(GLuint texture, GLsizei levels, GLenum internalformat,
 103                        GLsizei width, GLsizei height);
 104
 105 void GLAPIENTRY
 106 _mesa_TextureStorage3D_no_error(GLuint texture, GLsizei levels,
 107                                 GLenum internalformat, GLsizei width,
 108                                 GLsizei height, GLsizei depth);
 109
 110 extern void GLAPIENTRY
 111 _mesa_TextureStorage3D(GLuint texture, GLsizei levels, GLenum internalformat,
 112                        GLsizei width, GLsizei height, GLsizei depth);
 113
 114
 115 extern void GLAPIENTRY
 116 _mesa_TextureStorage1DEXT(GLuint texture, GLenum target, GLsizei levels,
 117                           GLenum internalformat,
 118                           GLsizei width);
 119
 120 extern void GLAPIENTRY
 121 _mesa_TextureStorage2DEXT(GLuint texture, GLenum target, GLsizei levels,
 122                           GLenum internalformat,
 123                           GLsizei width, GLsizei height);
 124
 125 extern void GLAPIENTRY
 126 _mesa_TextureStorage3DEXT(GLuint texture, GLenum target, GLsizei levels,
 127                           GLenum internalformat,
 128                           GLsizei width, GLsizei height, GLsizei depth);
 129
 130 extern GLboolean
 131 _mesa_is_legal_tex_storage_format(const struct gl_context *ctx,
 132                                   GLenum internalformat);
 133
 134 extern GLboolean
 135 _mesa_AllocTextureStorage_sw(struct gl_context *ctx,
 136                              struct gl_texture_object *texObj,
 137                              GLsizei levels, GLsizei width,
 138                              GLsizei height, GLsizei depth);
 139
 140 extern void
 141 _mesa_texture_storage_memory(struct gl_context *ctx, GLuint dims,
 142                              struct gl_texture_object *texObj,
 143                              struct gl_memory_object *memObj,
 144                              GLenum target, GLsizei levels,
 145                              GLenum internalformat, GLsizei width,
 146                              GLsizei height, GLsizei depth,
 147                              GLuint64 offset, bool dsa);
 148
 149 #endif /* TEXSTORAGE_H */