/* * Mesa 3-D graphics library * * Copyright (C) 1999-2004 Brian Paul All Rights Reserved. * (C) Copyright IBM Corporation 2006 * Copyright (C) 2009 VMware, Inc. 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, sublicense, * 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 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 NONINFRINGEMENT. IN NO EVENT SHALL * THE AUTHORS OR COPYRIGHT HOLDERS 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 ARRAYOBJ_H #define ARRAYOBJ_H #include "util/glheader.h" #include "mtypes.h" #include "glformats.h" #include "vbo/vbo.h" #ifdef __cplusplus extern "C" { #endif struct gl_context; /** * \file arrayobj.h * Functions for the GL_ARB_vertex_array_object extension. * * \author Ian Romanick * \author Brian Paul */ /* * Internal functions */ extern struct gl_vertex_array_object * _mesa_lookup_vao(struct gl_context *ctx, GLuint id); extern struct gl_vertex_array_object * _mesa_lookup_vao_err(struct gl_context *ctx, GLuint id, bool is_ext_dsa, const char *caller); extern struct gl_vertex_array_object * _mesa_new_vao(struct gl_context *ctx, GLuint name); extern void _mesa_unbind_array_object_vbos(struct gl_context *ctx, struct gl_vertex_array_object *obj); extern void _mesa_delete_vao(struct gl_context *ctx, struct gl_vertex_array_object *obj); extern void _mesa_reference_vao_(struct gl_context *ctx, struct gl_vertex_array_object **ptr, struct gl_vertex_array_object *vao); static inline void _mesa_reference_vao(struct gl_context *ctx, struct gl_vertex_array_object **ptr, struct gl_vertex_array_object *vao) { if (*ptr != vao) _mesa_reference_vao_(ctx, ptr, vao); } extern void _mesa_initialize_vao(struct gl_context *ctx, struct gl_vertex_array_object *obj, GLuint name); extern void _mesa_update_vao_derived_arrays(struct gl_context *ctx, struct gl_vertex_array_object *vao, bool display_list); extern void _mesa_vao_map_arrays(struct gl_context *ctx, struct gl_vertex_array_object *vao, GLbitfield access); extern void _mesa_vao_map(struct gl_context *ctx, struct gl_vertex_array_object *vao, GLbitfield access); extern void _mesa_vao_unmap_arrays(struct gl_context *ctx, struct gl_vertex_array_object *vao); extern void _mesa_vao_unmap(struct gl_context *ctx, struct gl_vertex_array_object *vao); /** * Array to apply the position/generic0 aliasing map to * an attribute value used in vertex processing inputs to an attribute * as they appear in the vao. */ extern const GLubyte _mesa_vao_attribute_map[ATTRIBUTE_MAP_MODE_MAX][VERT_ATTRIB_MAX]; /** * Apply the position/generic0 aliasing map to a bitfield from the vao. * Use for example to convert gl_vertex_array_object::Enabled * or gl_vertex_buffer_binding::_VertexBinding from the vao numbering to * the numbering used with vertex processing inputs. */ static inline GLbitfield _mesa_vao_enable_to_vp_inputs(gl_attribute_map_mode mode, GLbitfield enabled) { switch (mode) { case ATTRIBUTE_MAP_MODE_IDENTITY: return enabled; case ATTRIBUTE_MAP_MODE_POSITION: /* Copy VERT_ATTRIB_POS enable bit into GENERIC0 position */ return (enabled & ~VERT_BIT_GENERIC0) | ((enabled & VERT_BIT_POS) << VERT_ATTRIB_GENERIC0); case ATTRIBUTE_MAP_MODE_GENERIC0: /* Copy VERT_ATTRIB_GENERIC0 enable bit into POS position */ return (enabled & ~VERT_BIT_POS) | ((enabled & VERT_BIT_GENERIC0) >> VERT_ATTRIB_GENERIC0); default: return 0; } } /** * Return enabled vertex arrays. The bitmask is trimmed based on POS/GENERIC0 * remapping, and generic varyings are masked out for fixed-func shaders. */ static inline GLbitfield _mesa_get_enabled_vertex_arrays(const struct gl_context *ctx) { return ctx->VertexProgram._VPModeInputFilter & ctx->Array._DrawVAO->_EnabledWithMapMode; } /** * Return the enabled user (= non-VBO) attrib mask and the non-zero divisor * attrib mask for the draw. * * Needs a fully updated VAO ready for draw. */ static inline void _mesa_get_derived_vao_masks(const struct gl_context *ctx, const GLbitfield enabled_attribs, GLbitfield *enabled_user_attribs, GLbitfield *nonzero_divisor_attribs) { const struct gl_vertex_array_object *const vao = ctx->Array._DrawVAO; const GLbitfield enabled = vao->Enabled; const GLbitfield enabled_nonuser = enabled & vao->VertexAttribBufferMask; const GLbitfield enabled_nonzero_divisor = enabled & vao->NonZeroDivisorMask; *enabled_user_attribs = ~enabled_nonuser & enabled_attribs; *nonzero_divisor_attribs = enabled_nonzero_divisor & enabled_attribs; switch (vao->_AttributeMapMode) { case ATTRIBUTE_MAP_MODE_POSITION: /* Copy VERT_ATTRIB_POS enable bit into GENERIC0 position */ *enabled_user_attribs = (*enabled_user_attribs & ~VERT_BIT_GENERIC0) | ((*enabled_user_attribs & VERT_BIT_POS) << VERT_ATTRIB_GENERIC0); *nonzero_divisor_attribs = (*nonzero_divisor_attribs & ~VERT_BIT_GENERIC0) | ((*nonzero_divisor_attribs & VERT_BIT_POS) << VERT_ATTRIB_GENERIC0); break; case ATTRIBUTE_MAP_MODE_GENERIC0: /* Copy VERT_ATTRIB_GENERIC0 enable bit into POS position */ *enabled_user_attribs = (*enabled_user_attribs & ~VERT_BIT_POS) | ((*enabled_user_attribs & VERT_BIT_GENERIC0) >> VERT_ATTRIB_GENERIC0); *nonzero_divisor_attribs = (*nonzero_divisor_attribs & ~VERT_BIT_POS) | ((*nonzero_divisor_attribs & VERT_BIT_GENERIC0) >> VERT_ATTRIB_GENERIC0); break; default: break; } } /** * Return vertex buffer binding provided the attribute struct. * * Needs the a fully updated VAO ready for draw. */ static inline const struct gl_vertex_buffer_binding* _mesa_draw_buffer_binding_from_attrib(const struct gl_vertex_array_object *vao, const struct gl_array_attributes *attrib) { return &vao->BufferBinding[attrib->_EffBufferBindingIndex]; } /** * Return vertex array attribute provided the attribute number. */ static inline const struct gl_array_attributes* _mesa_draw_array_attrib(const struct gl_vertex_array_object *vao, gl_vert_attrib attr) { const gl_attribute_map_mode map_mode = vao->_AttributeMapMode; return &vao->VertexAttrib[_mesa_vao_attribute_map[map_mode][attr]]; } /** * Return vertex buffer binding provided an attribute number. */ static inline const struct gl_vertex_buffer_binding* _mesa_draw_buffer_binding(const struct gl_vertex_array_object *vao, gl_vert_attrib attr) { const struct gl_array_attributes *const attrib = _mesa_draw_array_attrib(vao, attr); return _mesa_draw_buffer_binding_from_attrib(vao, attrib); } /** * Return vertex attribute bits bound at the provided binding. * * Needs the a fully updated VAO ready for draw. */ static inline GLbitfield _mesa_draw_bound_attrib_bits(const struct gl_vertex_buffer_binding *binding) { return binding->_EffBoundArrays; } /** * Return the vertex offset bound at the provided binding. * * Needs the a fully updated VAO ready for draw. */ static inline GLintptr _mesa_draw_binding_offset(const struct gl_vertex_buffer_binding *binding) { return binding->_EffOffset; } /** * Return the relative offset of the provided attrib. * * Needs the a fully updated VAO ready for draw. */ static inline GLushort _mesa_draw_attributes_relative_offset(const struct gl_array_attributes *attrib) { return attrib->_EffRelativeOffset; } /** * Return a current value vertex array attribute provided the attribute number. */ static inline const struct gl_array_attributes* _mesa_draw_current_attrib(const struct gl_context *ctx, gl_vert_attrib attr) { return _vbo_current_attrib(ctx, attr); } #ifdef __cplusplus } #endif #endif /* ARRAYOBJ_H */