1 /* 2 * Mesa 3-D graphics library 3 * 4 * Copyright (C) 2010 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 BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN 20 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 21 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 22 */ 23 24 25 #ifndef UNIFORMS_H 26 #define UNIFORMS_H 27 28 #include "glheader.h" 29 #include "program/prog_parameter.h" 30 #include "../glsl/glsl_types.h" 31 #include "../glsl/ir_uniform.h" 32 33 #ifdef __cplusplus 34 extern "C" { 35 #endif 36 37 38 struct gl_program; 39 struct _glapi_table; 40 41 extern void GLAPIENTRY 42 _mesa_Uniform1fARB(GLint, GLfloat); 43 44 extern void GLAPIENTRY 45 _mesa_Uniform2fARB(GLint, GLfloat, GLfloat); 46 47 extern void GLAPIENTRY 48 _mesa_Uniform3fARB(GLint, GLfloat, GLfloat, GLfloat); 49 50 extern void GLAPIENTRY 51 _mesa_Uniform4fARB(GLint, GLfloat, GLfloat, GLfloat, GLfloat); 52 53 extern void GLAPIENTRY 54 _mesa_Uniform1iARB(GLint, GLint); 55 56 extern void GLAPIENTRY 57 _mesa_Uniform2iARB(GLint, GLint, GLint); 58 59 extern void GLAPIENTRY 60 _mesa_Uniform3iARB(GLint, GLint, GLint, GLint); 61 62 extern void GLAPIENTRY 63 _mesa_Uniform4iARB(GLint, GLint, GLint, GLint, GLint); 64 65 extern void GLAPIENTRY 66 _mesa_Uniform1fvARB(GLint, GLsizei, const GLfloat *); 67 68 extern void GLAPIENTRY 69 _mesa_Uniform2fvARB(GLint, GLsizei, const GLfloat *); 70 71 extern void GLAPIENTRY 72 _mesa_Uniform3fvARB(GLint, GLsizei, const GLfloat *); 73 74 extern void GLAPIENTRY 75 _mesa_Uniform4fvARB(GLint, GLsizei, const GLfloat *); 76 77 extern void GLAPIENTRY 78 _mesa_Uniform1ivARB(GLint, GLsizei, const GLint *); 79 80 extern void GLAPIENTRY 81 _mesa_Uniform2ivARB(GLint, GLsizei, const GLint *); 82 83 extern void GLAPIENTRY 84 _mesa_Uniform3ivARB(GLint, GLsizei, const GLint *); 85 86 extern void GLAPIENTRY 87 _mesa_Uniform4ivARB(GLint, GLsizei, const GLint *); 88 89 extern void GLAPIENTRY 90 _mesa_Uniform1ui(GLint location, GLuint v0); 91 92 extern void GLAPIENTRY 93 _mesa_Uniform2ui(GLint location, GLuint v0, GLuint v1); 94 95 extern void GLAPIENTRY 96 _mesa_Uniform3ui(GLint location, GLuint v0, GLuint v1, GLuint v2); 97 98 extern void GLAPIENTRY 99 _mesa_Uniform4ui(GLint location, GLuint v0, GLuint v1, GLuint v2, GLuint v3); 100 101 extern void GLAPIENTRY 102 _mesa_Uniform1uiv(GLint location, GLsizei count, const GLuint *value); 103 104 extern void GLAPIENTRY 105 _mesa_Uniform2uiv(GLint location, GLsizei count, const GLuint *value); 106 107 extern void GLAPIENTRY 108 _mesa_Uniform3uiv(GLint location, GLsizei count, const GLuint *value); 109 110 extern void GLAPIENTRY 111 _mesa_Uniform4uiv(GLint location, GLsizei count, const GLuint *value); 112 113 114 extern void GLAPIENTRY 115 _mesa_UniformMatrix2fvARB(GLint, GLsizei, GLboolean, const GLfloat *); 116 117 extern void GLAPIENTRY 118 _mesa_UniformMatrix3fvARB(GLint, GLsizei, GLboolean, const GLfloat *); 119 120 extern void GLAPIENTRY 121 _mesa_UniformMatrix4fvARB(GLint, GLsizei, GLboolean, const GLfloat *); 122 123 extern void GLAPIENTRY 124 _mesa_UniformMatrix2x3fv(GLint location, GLsizei count, GLboolean transpose, 125 const GLfloat *value); 126 127 extern void GLAPIENTRY 128 _mesa_UniformMatrix3x2fv(GLint location, GLsizei count, GLboolean transpose, 129 const GLfloat *value); 130 131 extern void GLAPIENTRY 132 _mesa_UniformMatrix2x4fv(GLint location, GLsizei count, GLboolean transpose, 133 const GLfloat *value); 134 135 extern void GLAPIENTRY 136 _mesa_UniformMatrix4x2fv(GLint location, GLsizei count, GLboolean transpose, 137 const GLfloat *value); 138 139 extern void GLAPIENTRY 140 _mesa_UniformMatrix3x4fv(GLint location, GLsizei count, GLboolean transpose, 141 const GLfloat *value); 142 143 extern void GLAPIENTRY 144 _mesa_UniformMatrix4x3fv(GLint location, GLsizei count, GLboolean transpose, 145 const GLfloat *value); 146 147 148 extern void GLAPIENTRY 149 _mesa_GetActiveUniformARB(GLhandleARB, GLuint, GLsizei, GLsizei *, 150 GLint *, GLenum *, GLcharARB *); 151 152 extern void GLAPIENTRY 153 _mesa_GetActiveUniformsiv(GLuint program, 154 GLsizei uniformCount, 155 const GLuint *uniformIndices, 156 GLenum pname, 157 GLint *params); 158 159 extern void GLAPIENTRY 160 _mesa_GetUniformfvARB(GLhandleARB, GLint, GLfloat *); 161 162 extern void GLAPIENTRY 163 _mesa_GetnUniformfvARB(GLhandleARB, GLint, GLsizei, GLfloat *); 164 165 extern void GLAPIENTRY 166 _mesa_GetUniformivARB(GLhandleARB, GLint, GLint *); 167 168 extern void GLAPIENTRY 169 _mesa_GetnUniformivARB(GLhandleARB, GLint, GLsizei, GLint *); 170 171 extern void GLAPIENTRY 172 _mesa_GetUniformuiv(GLhandleARB, GLint, GLuint *); 173 174 extern void GLAPIENTRY 175 _mesa_GetnUniformuivARB(GLhandleARB, GLint, GLsizei, GLuint *); 176 177 extern void GLAPIENTRY 178 _mesa_GetUniformdv(GLhandleARB, GLint, GLdouble *); 179 180 extern void GLAPIENTRY 181 _mesa_GetnUniformdvARB(GLhandleARB, GLint, GLsizei, GLdouble *); 182 183 extern GLint GLAPIENTRY 184 _mesa_GetUniformLocationARB(GLhandleARB, const GLcharARB *); 185 186 unsigned 187 _mesa_get_uniform_location(struct gl_context *ctx, struct gl_shader_program *shProg, 188 const GLchar *name, unsigned *offset); 189 190 void 191 _mesa_uniform(struct gl_context *ctx, struct gl_shader_program *shader_program, 192 GLint location, GLsizei count, 193 const GLvoid *values, GLenum type); 194 195 void 196 _mesa_uniform_matrix(struct gl_context *ctx, struct gl_shader_program *shProg, 197 GLuint cols, GLuint rows, 198 GLint location, GLsizei count, 199 GLboolean transpose, const GLfloat *values); 200 201 void 202 _mesa_get_uniform(struct gl_context *ctx, GLuint program, GLint location, 203 GLsizei bufSize, enum glsl_base_type returnType, 204 GLvoid *paramsOut); 205 206 extern void 207 _mesa_uniform_attach_driver_storage(struct gl_uniform_storage *, 208 unsigned element_stride, 209 unsigned vector_stride, 210 enum gl_uniform_driver_format format, 211 void *data); 212 213 extern void 214 _mesa_uniform_detach_all_driver_storage(struct gl_uniform_storage *uni); 215 216 extern void 217 _mesa_propagate_uniforms_to_driver_storage(struct gl_uniform_storage *uni, 218 unsigned array_index, 219 unsigned count); 220 221 extern void 222 _mesa_update_shader_textures_used(struct gl_shader_program *shProg, 223 struct gl_program *prog); 224 225 extern bool 226 _mesa_sampler_uniforms_are_valid(const struct gl_shader_program *shProg, 227 char *errMsg, size_t errMsgLength); 228 229 extern void 230 _mesa_init_shader_uniform_dispatch(const struct gl_context *ctx, 231 struct _glapi_table *exec); 232 233 extern const struct gl_program_parameter * 234 get_uniform_parameter(struct gl_shader_program *shProg, GLint index); 235 236 struct gl_builtin_uniform_element { 237 const char *field; 238 int tokens[STATE_LENGTH]; 239 int swizzle; 240 }; 241 242 struct gl_builtin_uniform_desc { 243 const char *name; 244 struct gl_builtin_uniform_element *elements; 245 unsigned int num_elements; 246 }; 247 248 extern const struct gl_builtin_uniform_desc _mesa_builtin_uniform_desc[]; 249 250 /** 251 * \name GLSL uniform arrays and structs require special handling. 252 * 253 * The GL_ARB_shader_objects spec says that if you use 254 * glGetUniformLocation to get the location of an array, you CANNOT 255 * access other elements of the array by adding an offset to the 256 * returned location. For example, you must call 257 * glGetUniformLocation("foo[16]") if you want to set the 16th element 258 * of the array with glUniform(). 259 * 260 * HOWEVER, some other OpenGL drivers allow accessing array elements 261 * by adding an offset to the returned array location. And some apps 262 * seem to depend on that behaviour. 263 * 264 * Mesa's gl_uniform_list doesn't directly support this since each 265 * entry in the list describes one uniform variable, not one uniform 266 * element. We could insert dummy entries in the list for each array 267 * element after [0] but that causes complications elsewhere. 268 * 269 * We solve this problem by encoding two values in the location that's 270 * returned by glGetUniformLocation(): 271 * a) index into gl_uniform_list::Uniforms[] for the uniform 272 * b) an array/field offset (0 for simple types) 273 * 274 * These two values are encoded in the high and low halves of a GLint. 275 * By putting the uniform number in the high part and the offset in the 276 * low part, we can support the unofficial ability to index into arrays 277 * by adding offsets to the location value. 278 */ 279 /*@{*/ 280 /** 281 * Combine the uniform's base location and the offset 282 */ 283 static inline GLint 284 _mesa_uniform_merge_location_offset(unsigned base_location, unsigned offset) 285 { 286 return (base_location << 16) | offset; 287 } 288 289 /** 290 * Separate the uniform base location and parameter offset 291 */ 292 static inline void 293 _mesa_uniform_split_location_offset(GLint location, unsigned *base_location, 294 unsigned *offset) 295 { 296 *offset = location & 0xffff; 297 *base_location = location >> 16; 298 } 299 /*@}*/ 300 301 302 #ifdef __cplusplus 303 } 304 #endif 305 306 307 #endif /* UNIFORMS_H */ 308
