src/mesa/main/light.h

   1 /**
   2  * \file light.h
   3  * Lighting.
   4  */
   5
   6 /*
   7  * Mesa 3-D graphics library
   8  * Version:  3.5
   9  *
  10  * Copyright (C) 1999-2001  Brian Paul   All Rights Reserved.
  11  *
  12  * Permission is hereby granted, free of charge, to any person obtaining a
  13  * copy of this software and associated documentation files (the "Software"),
  14  * to deal in the Software without restriction, including without limitation
  15  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  16  * and/or sell copies of the Software, and to permit persons to whom the
  17  * Software is furnished to do so, subject to the following conditions:
  18  *
  19  * The above copyright notice and this permission notice shall be included
  20  * in all copies or substantial portions of the Software.
  21  *
  22  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  23  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  24  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  25  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
  26  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
  27  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
  28  */
  29
  30
  31 #ifndef LIGHT_H
  32 #define LIGHT_H
  33
  34
  35 #include "mtypes.h"
  36
  37 extern void GLAPIENTRY
  38 _mesa_ShadeModel( GLenum mode );
  39
  40 #if _HAVE_FULL_GL
  41 extern void GLAPIENTRY
  42 _mesa_ColorMaterial( GLenum face, GLenum mode );
  43
  44 extern void GLAPIENTRY
  45 _mesa_Lightf( GLenum light, GLenum pname, GLfloat param );
  46
  47 extern void GLAPIENTRY
  48 _mesa_Lightfv( GLenum light, GLenum pname, const GLfloat *params );
  49
  50 extern void GLAPIENTRY
  51 _mesa_Lightiv( GLenum light, GLenum pname, const GLint *params );
  52
  53 extern void GLAPIENTRY
  54 _mesa_Lighti( GLenum light, GLenum pname, GLint param );
  55
  56 extern void GLAPIENTRY
  57 _mesa_LightModelf( GLenum pname, GLfloat param );
  58
  59 extern void GLAPIENTRY
  60 _mesa_LightModelfv( GLenum pname, const GLfloat *params );
  61
  62 extern void GLAPIENTRY
  63 _mesa_LightModeli( GLenum pname, GLint param );
  64
  65 extern void GLAPIENTRY
  66 _mesa_LightModeliv( GLenum pname, const GLint *params );
  67
  68 extern void GLAPIENTRY
  69 _mesa_GetLightfv( GLenum light, GLenum pname, GLfloat *params );
  70
  71 extern void GLAPIENTRY
  72 _mesa_GetLightiv( GLenum light, GLenum pname, GLint *params );
  73
  74 extern void GLAPIENTRY
  75 _mesa_GetMaterialfv( GLenum face, GLenum pname, GLfloat *params );
  76
  77 extern void GLAPIENTRY
  78 _mesa_GetMaterialiv( GLenum face, GLenum pname, GLint *params );
  79
  80
  81 extern void
  82 _mesa_light(GLcontext *ctx, GLuint lnum, GLenum pname, const GLfloat *params);
  83
  84
  85 /* Lerp between adjacent values in the f(x) lookup table, giving a
  86  * continuous function, with adequeate overall accuracy.  (Though
  87  * still pretty good compared to a straight lookup).
  88  * Result should be a GLfloat.
  89  */
  90 #define GET_SHINE_TAB_ENTRY( table, dp, result )                        \
  91 do {                                                                    \
  92    struct gl_shine_tab *_tab = table;                                   \
  93    float f = (dp * (SHINE_TABLE_SIZE-1));                               \
  94    int k = (int) f;                                                     \
  95    if (k > SHINE_TABLE_SIZE-2)                                          \
  96       result = (GLfloat) _mesa_pow( dp, _tab->shininess );              \
  97    else                                                                 \
  98       result = _tab->tab[k] + (f-k)*(_tab->tab[k+1]-_tab->tab[k]);      \
  99 } while (0)
 100
 101
 102 extern GLuint _mesa_material_bitmask( GLcontext *ctx,
 103                                       GLenum face, GLenum pname,
 104                                       GLuint legal,
 105                                       const char * );
 106
 107 extern void _mesa_invalidate_spot_exp_table( struct gl_light *l );
 108
 109 extern void _mesa_invalidate_shine_table( GLcontext *ctx, GLuint i );
 110
 111 extern void _mesa_validate_all_lighting_tables( GLcontext *ctx );
 112
 113 extern void _mesa_update_lighting( GLcontext *ctx );
 114
 115 extern void _mesa_update_tnl_spaces( GLcontext *ctx, GLuint new_state );
 116
 117 extern void _mesa_update_material( GLcontext *ctx,
 118                                    GLuint bitmask );
 119
 120 extern void _mesa_copy_materials( struct gl_material *dst,
 121                                   const struct gl_material *src,
 122                                   GLuint bitmask );
 123
 124 extern void _mesa_update_color_material( GLcontext *ctx,
 125                                          const GLfloat rgba[4] );
 126
 127 extern void _mesa_init_lighting( GLcontext *ctx );
 128
 129 extern void _mesa_free_lighting_data( GLcontext *ctx );
 130
 131 extern void _mesa_allow_light_in_model( GLcontext *ctx, GLboolean flag );
 132
 133 #else
 134 #define _mesa_update_color_material( c, r ) ((void)0)
 135 #define _mesa_validate_all_lighting_tables( c ) ((void)0)
 136 #define _mesa_invalidate_spot_exp_table( l ) ((void)0)
 137 #define _mesa_material_bitmask( c, f, p, l, s ) 0
 138 #define _mesa_init_lighting( c ) ((void)0)
 139 #define _mesa_free_lighting_data( c ) ((void)0)
 140 #define _mesa_update_lighting( c ) ((void)0)
 141 #define _mesa_update_tnl_spaces( c, n ) ((void)0)
 142 #define GET_SHINE_TAB_ENTRY( table, dp, result )  ((result)=0)
 143 #endif
 144
 145 #endif