texstorage.h revision 01e04c3f 
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 */
47static 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
62void GLAPIENTRY
63_mesa_TexStorage1D_no_error(GLenum target, GLsizei levels,
64                            GLenum internalformat, GLsizei width);
65
66extern void GLAPIENTRY
67_mesa_TexStorage1D(GLenum target, GLsizei levels, GLenum internalformat,
68                   GLsizei width);
69
70void GLAPIENTRY
71_mesa_TexStorage2D_no_error(GLenum target, GLsizei levels,
72                            GLenum internalformat, GLsizei width,
73                            GLsizei height);
74
75extern void GLAPIENTRY
76_mesa_TexStorage2D(GLenum target, GLsizei levels, GLenum internalformat,
77                   GLsizei width, GLsizei height);
78
79void GLAPIENTRY
80_mesa_TexStorage3D_no_error(GLenum target, GLsizei levels,
81                            GLenum internalformat, GLsizei width,
82                            GLsizei height, GLsizei depth);
83
84extern void GLAPIENTRY
85_mesa_TexStorage3D(GLenum target, GLsizei levels, GLenum internalformat,
86                   GLsizei width, GLsizei height, GLsizei depth);
87
88void GLAPIENTRY
89_mesa_TextureStorage1D_no_error(GLuint texture, GLsizei levels,
90                                GLenum internalformat, GLsizei width);
91
92extern void GLAPIENTRY
93_mesa_TextureStorage1D(GLuint texture, GLsizei levels, GLenum internalformat,
94                       GLsizei width);
95
96void GLAPIENTRY
97_mesa_TextureStorage2D_no_error(GLuint texture, GLsizei levels,
98                                GLenum internalformat, GLsizei width,
99                                GLsizei height);
100
101extern void GLAPIENTRY
102_mesa_TextureStorage2D(GLuint texture, GLsizei levels, GLenum internalformat,
103                       GLsizei width, GLsizei height);
104
105void GLAPIENTRY
106_mesa_TextureStorage3D_no_error(GLuint texture, GLsizei levels,
107                                GLenum internalformat, GLsizei width,
108                                GLsizei height, GLsizei depth);
109
110extern void GLAPIENTRY
111_mesa_TextureStorage3D(GLuint texture, GLsizei levels, GLenum internalformat,
112                       GLsizei width, GLsizei height, GLsizei depth);
113
114
115extern void GLAPIENTRY
116_mesa_TextureStorage1DEXT(GLuint texture, GLenum target, GLsizei levels,
117                          GLenum internalformat,
118                          GLsizei width);
119
120extern void GLAPIENTRY
121_mesa_TextureStorage2DEXT(GLuint texture, GLenum target, GLsizei levels,
122                          GLenum internalformat,
123                          GLsizei width, GLsizei height);
124
125extern void GLAPIENTRY
126_mesa_TextureStorage3DEXT(GLuint texture, GLenum target, GLsizei levels,
127                          GLenum internalformat,
128                          GLsizei width, GLsizei height, GLsizei depth);
129
130extern GLboolean
131_mesa_is_legal_tex_storage_format(const struct gl_context *ctx,
132                                  GLenum internalformat);
133
134extern 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
140extern 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 */
150