src/mesa/main/texstate.h

   1 /**
   2  * \file texstate.h
   3  * Texture state management.
   4  */
   5
   6 /*
   7  * Mesa 3-D graphics library
   8  *
   9  * Copyright (C) 1999-2007  Brian Paul   All Rights Reserved.
  10  *
  11  * Permission is hereby granted, free of charge, to any person obtaining a
  12  * copy of this software and associated documentation files (the "Software"),
  13  * to deal in the Software without restriction, including without limitation
  14  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  15  * and/or sell copies of the Software, and to permit persons to whom the
  16  * Software is furnished to do so, subject to the following conditions:
  17  *
  18  * The above copyright notice and this permission notice shall be included
  19  * in all copies or substantial portions of the Software.
  20  *
  21  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  22  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  23  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  24  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
  25  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  26  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  27  * OTHER DEALINGS IN THE SOFTWARE.
  28  */
  29
  30
  31 #ifndef TEXSTATE_H
  32 #define TEXSTATE_H
  33
  34
  35 #include "compiler.h"
  36 #include "enums.h"
  37 #include "macros.h"
  38 #include "mtypes.h"
  39
  40
  41 static inline struct gl_texture_unit *
  42 _mesa_get_tex_unit(struct gl_context *ctx, GLuint unit)
  43 {
  44    assert(unit < ARRAY_SIZE(ctx->Texture.Unit));
  45    return &(ctx->Texture.Unit[unit]);
  46 }
  47
  48 /**
  49  * Return pointer to current texture unit.
  50  * This the texture unit set by glActiveTexture(), not glClientActiveTexture().
  51  */
  52 static inline struct gl_texture_unit *
  53 _mesa_get_current_tex_unit(struct gl_context *ctx)
  54 {
  55    return _mesa_get_tex_unit(ctx, ctx->Texture.CurrentUnit);
  56 }
  57
  58 static inline GLuint
  59 _mesa_max_tex_unit(struct gl_context *ctx)
  60 {
  61    /* See OpenGL spec for glActiveTexture: */
  62    return MAX2(ctx->Const.MaxCombinedTextureImageUnits,
  63                ctx->Const.MaxTextureCoordUnits);
  64 }
  65
  66 static inline struct gl_texture_unit *
  67 _mesa_get_tex_unit_err(struct gl_context *ctx, GLuint unit, const char *func)
  68 {
  69    if (unit < _mesa_max_tex_unit(ctx))
  70       return _mesa_get_tex_unit(ctx, unit);
  71
  72    /* Note: This error is a precedent set by glBindTextures. From the GL 4.5
  73     * specification (30.10.2014) Section 8.1 ("Texture Objects"):
  74     *
  75     *    "An INVALID_OPERATION error is generated if first + count is greater
  76     *     than the number of texture image units supported by the
  77     *     implementation."
  78     */
  79    _mesa_error(ctx, GL_INVALID_OPERATION, "%s(unit=%s)", func,
  80                _mesa_lookup_enum_by_nr(GL_TEXTURE0+unit));
  81    return NULL;
  82 }
  83
  84
  85 extern void
  86 _mesa_copy_texture_state( const struct gl_context *src, struct gl_context *dst );
  87
  88 extern void
  89 _mesa_print_texunit_state( struct gl_context *ctx, GLuint unit );
  90
  91
  92
  93 /**
  94  * \name Called from API
  95  */
  96 /*@{*/
  97
  98 extern void GLAPIENTRY
  99 _mesa_ActiveTexture( GLenum target );
 100
 101 extern void GLAPIENTRY
 102 _mesa_ClientActiveTexture( GLenum target );
 103
 104 /*@}*/
 105
 106
 107 /**
 108  * \name Initialization, state maintenance
 109  */
 110 /*@{*/
 111
 112 extern void
 113 _mesa_update_texture( struct gl_context *ctx, GLuint new_state );
 114
 115 extern GLboolean
 116 _mesa_init_texture( struct gl_context *ctx );
 117
 118 extern void
 119 _mesa_free_texture_data( struct gl_context *ctx );
 120
 121 extern void
 122 _mesa_update_default_objects_texture(struct gl_context *ctx);
 123
 124 /*@}*/
 125
 126 #endif