/* * (C) Copyright IBM Corporation 2004, 2005 * All Rights Reserved. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), * to deal in the Software without restriction, including without limitation * the rights to use, copy, modify, merge, publish, distribute, sub license, * and/or sell copies of the Software, and to permit persons to whom the * Software is furnished to do so, subject to the following conditions: * * The above copyright notice and this permission notice (including the next * paragraph) shall be included in all copies or substantial portions of the * Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL * IBM, * AND/OR THEIR SUPPLIERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF * OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE * SOFTWARE. */ #ifndef _INDIRECT_VA_PRIVATE_ #define _INDIRECT_VA_PRIVATE_ /** * \file indirect_va_private.h * * \author Ian Romanick */ #include #include "glxclient.h" #include "indirect.h" #include /** * State descriptor for a single array of vertex data. */ struct array_state { /** * Pointer to the application supplied data. */ const void *data; /** * Enum representing the type of the application supplied data. */ GLenum data_type; /** * Stride value supplied by the application. This value is not used * internally. It is only kept so that it can be queried by the * application using glGet*v. */ GLsizei user_stride; /** * Calculated size, in bytes, of a single element in the array. This * is calculated based on \c count and the size of the data type * represented by \c data_type. */ GLsizei element_size; /** * Actual byte-stride from one element to the next. This value will * be equal to either \c user_stride or \c element_stride. */ GLsizei true_stride; /** * Number of data values in each element. */ GLint count; /** * "Normalized" data is on the range [0,1] (unsigned) or [-1,1] (signed). * This is used for mapping integral types to floating point types. */ GLboolean normalized; /** * Pre-calculated GLX protocol command header. */ uint32_t header[2]; /** * Size of the header data. For simple data, like glColorPointerfv, * this is 4. For complex data that requires either a count (e.g., * glWeightfvARB), an index (e.g., glVertexAttrib1fvARB), or a * selector enum (e.g., glMultiTexCoord2fv) this is 8. */ unsigned header_size; /** * Set to \c GL_TRUE if this array is enabled. Otherwise, it is set * to \c GL_FALSE. */ GLboolean enabled; /** * For multi-arrayed data (e.g., texture coordinates, generic vertex * program attributes, etc.), this specifies which array this is. */ unsigned index; /** * Per-array-type key. For most arrays, this will be the GL enum for * that array (e.g., GL_VERTEX_ARRAY for vertex data, GL_NORMAL_ARRAY * for normal data, GL_TEXTURE_COORD_ARRAY for texture coordinate data, * etc.). */ GLenum key; /** * If this array can be used with the "classic" \c glDrawArrays protocol, * this is set to \c GL_TRUE. Otherwise, it is set to \c GL_FALSE. */ GLboolean old_DrawArrays_possible; }; /** * Array state that is pushed / poped by \c glPushClientAttrib and * \c glPopClientAttrib. */ struct array_stack_state { /** * Pointer to the application supplied data. */ const void *data; /** * Enum representing the type of the application supplied data. */ GLenum data_type; /** * Stride value supplied by the application. This value is not used * internally. It is only kept so that it can be queried by the * application using glGet*v. */ GLsizei user_stride; /** * Number of data values in each element. */ GLint count; /** * Per-array-type key. For most arrays, this will be the GL enum for * that array (e.g., GL_VERTEX_ARRAY for vertex data, GL_NORMAL_ARRAY * for normal data, GL_TEXTURE_COORD_ARRAY for texture coordinate data, * etc.). */ GLenum key; /** * For multi-arrayed data (e.g., texture coordinates, generic vertex * program attributes, etc.), this specifies which array this is. */ unsigned index; /** * Set to \c GL_TRUE if this array is enabled. Otherwise, it is set * to \c GL_FALSE. */ GLboolean enabled; }; /** * Collection of all the vertex array state. */ struct array_state_vector { /** * Number of arrays tracked by \c ::arrays. */ size_t num_arrays; /** * Array of vertex array state. This array contains all of the valid * vertex arrays. If a vertex array isn't in this array, then it isn't * valid. For example, if an implementation does not support * EXT_fog_coord, there won't be a GL_FOG_COORD_ARRAY entry in this * array. */ struct array_state *arrays; /** * Number of currently enabled client-side arrays. The value of this * field is only valid if \c array_info_cache_valid is true. */ size_t enabled_client_array_count; /** * \name ARRAY_INFO cache. * * These fields track the state of the ARRAY_INFO cache. The * \c array_info_cache_size is the size of the actual data stored in * \c array_info_cache. \c array_info_cache_buffer_size is the size of * the buffer. This will always be greater than or equal to * \c array_info_cache_size. * * \note * There are some bytes of extra data before \c array_info_cache that is * used to hold the header for RenderLarge commands. This is * \b not included in \c array_info_cache_size or * \c array_info_cache_buffer_size. \c array_info_cache_base stores a * pointer to the true start of the buffer (i.e., what malloc returned). */ /*@{ */ size_t array_info_cache_size; size_t array_info_cache_buffer_size; void *array_info_cache; void *array_info_cache_base; /*@} */ /** * Is the cache of ARRAY_INFO data valid? The cache can become invalid * when one of several state changes occur. Among these chages are * modifying the array settings for an enabled array and enabling / * disabling an array. */ GLboolean array_info_cache_valid; /** * Is it possible to use the GL 1.1 / EXT_vertex_arrays protocol? Use * of this protocol is disabled with really old servers (i.e., servers * that don't support GL 1.1 or EXT_vertex_arrays) or when an environment * variable is set. * * \todo * GL 1.1 and EXT_vertex_arrays use identical protocol, but have different * opcodes for \c glDrawArrays. For servers that advertise one or the * other, there should be a way to select which opcode to use. */ GLboolean old_DrawArrays_possible; /** * Is it possible to use the new GL X.X / ARB_vertex_buffer_object * protocol? * * \todo * This protocol has not yet been defined by the ARB, but is currently a * work in progress. This field is a place-holder. */ GLboolean new_DrawArrays_possible; /** * Active texture unit set by \c glClientActiveTexture. * * \sa __glXGetActiveTextureUnit */ unsigned active_texture_unit; /** * Number of supported texture units. Even if ARB_multitexture / * GL 1.3 are not supported, this will be at least 1. When multitexture * is supported, this will be the value queried by calling * \c glGetIntegerv with \c GL_MAX_TEXTURE_UNITS. * * \todo * Investigate if this should be the value of \c GL_MAX_TEXTURE_COORDS * instead (if GL 2.0 / ARB_fragment_shader / ARB_fragment_program / * NV_fragment_program are supported). */ unsigned num_texture_units; /** * Number of generic vertex program attribs. If GL_ARB_vertex_program * is not supported, this will be zero. Otherwise it will be the value * queries by calling \c glGetProgramiv with \c GL_VERTEX_PROGRAM_ARB * and \c GL_MAX_PROGRAM_ATTRIBS_ARB. */ unsigned num_vertex_program_attribs; /** * \n Methods for implementing various GL functions. * * These method pointers are only valid \c array_info_cache_valid is set. * When each function starts, it much check \c array_info_cache_valid. * If it is not set, it must call \c fill_array_info_cache and call * the new method. * * \sa fill_array_info_cache * * \todo * Write code to plug these functions directly into the dispatch table. */ /*@{ */ void (*DrawArrays) (GLenum, GLint, GLsizei); void (*DrawElements) (GLenum mode, GLsizei count, GLenum type, const GLvoid * indices); /*@} */ struct array_stack_state *stack; unsigned active_texture_unit_stack[__GL_CLIENT_ATTRIB_STACK_DEPTH]; unsigned stack_index; }; #endif /* _INDIRECT_VA_PRIVATE_ */