light.h revision 7117f1b4 
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
37extern void GLAPIENTRY
38_mesa_ShadeModel( GLenum mode );
39
40#if _HAVE_FULL_GL
41extern void GLAPIENTRY
42_mesa_ColorMaterial( GLenum face, GLenum mode );
43
44extern void GLAPIENTRY
45_mesa_Lightf( GLenum light, GLenum pname, GLfloat param );
46
47extern void GLAPIENTRY
48_mesa_Lightfv( GLenum light, GLenum pname, const GLfloat *params );
49
50extern void GLAPIENTRY
51_mesa_Lightiv( GLenum light, GLenum pname, const GLint *params );
52
53extern void GLAPIENTRY
54_mesa_Lighti( GLenum light, GLenum pname, GLint param );
55
56extern void GLAPIENTRY
57_mesa_LightModelf( GLenum pname, GLfloat param );
58
59extern void GLAPIENTRY
60_mesa_LightModelfv( GLenum pname, const GLfloat *params );
61
62extern void GLAPIENTRY
63_mesa_LightModeli( GLenum pname, GLint param );
64
65extern void GLAPIENTRY
66_mesa_LightModeliv( GLenum pname, const GLint *params );
67
68extern void GLAPIENTRY
69_mesa_GetLightfv( GLenum light, GLenum pname, GLfloat *params );
70
71extern void GLAPIENTRY
72_mesa_GetLightiv( GLenum light, GLenum pname, GLint *params );
73
74extern void GLAPIENTRY
75_mesa_GetMaterialfv( GLenum face, GLenum pname, GLfloat *params );
76
77extern void GLAPIENTRY
78_mesa_GetMaterialiv( GLenum face, GLenum pname, GLint *params );
79
80
81extern 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 )			\
91do {									\
92   struct gl_shine_tab *_tab = table;					\
93   float f = (dp * (SHINE_TABLE_SIZE-1));				\
94   int k = (int) f;							\
95   if (k < 0 /* gcc may cast an overflow float value to negative int value*/ \
96	|| k > SHINE_TABLE_SIZE-2)					\
97      result = (GLfloat) _mesa_pow( dp, _tab->shininess );		\
98   else									\
99      result = _tab->tab[k] + (f-k)*(_tab->tab[k+1]-_tab->tab[k]);	\
100} while (0)
101
102
103extern GLuint _mesa_material_bitmask( GLcontext *ctx,
104                                      GLenum face, GLenum pname,
105                                      GLuint legal,
106                                      const char * );
107
108extern void _mesa_invalidate_spot_exp_table( struct gl_light *l );
109
110extern void _mesa_invalidate_shine_table( GLcontext *ctx, GLuint i );
111
112extern void _mesa_validate_all_lighting_tables( GLcontext *ctx );
113
114extern void _mesa_update_lighting( GLcontext *ctx );
115
116extern void _mesa_update_tnl_spaces( GLcontext *ctx, GLuint new_state );
117
118extern void _mesa_update_material( GLcontext *ctx,
119                                   GLuint bitmask );
120
121extern void _mesa_copy_materials( struct gl_material *dst,
122				  const struct gl_material *src,
123				  GLuint bitmask );
124
125extern void _mesa_update_color_material( GLcontext *ctx,
126                                         const GLfloat rgba[4] );
127
128extern void _mesa_init_lighting( GLcontext *ctx );
129
130extern void _mesa_free_lighting_data( GLcontext *ctx );
131
132extern void _mesa_allow_light_in_model( GLcontext *ctx, GLboolean flag );
133
134#else
135#define _mesa_update_color_material( c, r ) ((void)0)
136#define _mesa_validate_all_lighting_tables( c ) ((void)0)
137#define _mesa_invalidate_spot_exp_table( l ) ((void)0)
138#define _mesa_material_bitmask( c, f, p, l, s ) 0
139#define _mesa_init_lighting( c ) ((void)0)
140#define _mesa_free_lighting_data( c ) ((void)0)
141#define _mesa_update_lighting( c ) ((void)0)
142#define _mesa_update_tnl_spaces( c, n ) ((void)0)
143#define GET_SHINE_TAB_ENTRY( table, dp, result )  ((result)=0)
144#endif
145
146#endif
147