1 
2 /*
3  * Mesa 3-D graphics library
4  * Version:  4.1
5  *
6  * Copyright (C) 1999-2002  Brian Paul   All Rights Reserved.
7  *
8  * Permission is hereby granted, free of charge, to any person obtaining a
9  * copy of this software and associated documentation files (the "Software"),
10  * to deal in the Software without restriction, including without limitation
11  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12  * and/or sell copies of the Software, and to permit persons to whom the
13  * Software is furnished to do so, subject to the following conditions:
14  *
15  * The above copyright notice and this permission notice shall be included
16  * in all copies or substantial portions of the Software.
17  *
18  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
21  * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22  * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23  * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
24  */
25 
26 
27 #include "glheader.h"
28 #include "enums.h"
29 #include "context.h"
30 #include "hint.h"
31 #include "imports.h"
32 #include "mtypes.h"
33 
34 
35 
36 void GLAPIENTRY
_mesa_Hint(GLenum target,GLenum mode)37 _mesa_Hint( GLenum target, GLenum mode )
38 {
39    GET_CURRENT_CONTEXT(ctx);
40    ASSERT_OUTSIDE_BEGIN_END(ctx);
41 
42    if (MESA_VERBOSE & VERBOSE_API)
43       _mesa_debug(ctx, "glHint %s %s\n",
44                   _mesa_lookup_enum_by_nr(target),
45                   _mesa_lookup_enum_by_nr(mode));
46 
47    if (mode != GL_NICEST && mode != GL_FASTEST && mode != GL_DONT_CARE) {
48       _mesa_error(ctx, GL_INVALID_ENUM, "glHint(mode)");
49       return;
50    }
51 
52    switch (target) {
53       case GL_FOG_HINT:
54          if (ctx->API != API_OPENGL && ctx->API != API_OPENGLES)
55             goto invalid_target;
56          if (ctx->Hint.Fog == mode)
57 	    return;
58 	 FLUSH_VERTICES(ctx, _NEW_HINT);
59          ctx->Hint.Fog = mode;
60          break;
61       case GL_LINE_SMOOTH_HINT:
62          if (!_mesa_is_desktop_gl(ctx) && ctx->API != API_OPENGLES)
63             goto invalid_target;
64          if (ctx->Hint.LineSmooth == mode)
65 	    return;
66 	 FLUSH_VERTICES(ctx, _NEW_HINT);
67          ctx->Hint.LineSmooth = mode;
68          break;
69       case GL_PERSPECTIVE_CORRECTION_HINT:
70          if (ctx->API != API_OPENGL && ctx->API != API_OPENGLES)
71             goto invalid_target;
72          if (ctx->Hint.PerspectiveCorrection == mode)
73 	    return;
74 	 FLUSH_VERTICES(ctx, _NEW_HINT);
75          ctx->Hint.PerspectiveCorrection = mode;
76          break;
77       case GL_POINT_SMOOTH_HINT:
78          if (ctx->API != API_OPENGL && ctx->API != API_OPENGLES)
79             goto invalid_target;
80          if (ctx->Hint.PointSmooth == mode)
81 	    return;
82 	 FLUSH_VERTICES(ctx, _NEW_HINT);
83          ctx->Hint.PointSmooth = mode;
84          break;
85       case GL_POLYGON_SMOOTH_HINT:
86          if (!_mesa_is_desktop_gl(ctx))
87             goto invalid_target;
88          if (ctx->Hint.PolygonSmooth == mode)
89 	    return;
90 	 FLUSH_VERTICES(ctx, _NEW_HINT);
91          ctx->Hint.PolygonSmooth = mode;
92          break;
93 
94       /* GL_EXT_clip_volume_hint */
95       case GL_CLIP_VOLUME_CLIPPING_HINT_EXT:
96          if (ctx->API != API_OPENGL)
97             goto invalid_target;
98          if (ctx->Hint.ClipVolumeClipping == mode)
99 	    return;
100 	 FLUSH_VERTICES(ctx, _NEW_HINT);
101          ctx->Hint.ClipVolumeClipping = mode;
102          break;
103 
104       /* GL_ARB_texture_compression */
105       case GL_TEXTURE_COMPRESSION_HINT_ARB:
106          if (!_mesa_is_desktop_gl(ctx))
107             goto invalid_target;
108 	 if (ctx->Hint.TextureCompression == mode)
109 	    return;
110 	 FLUSH_VERTICES(ctx, _NEW_HINT);
111 	 ctx->Hint.TextureCompression = mode;
112          break;
113 
114       /* GL_SGIS_generate_mipmap */
115       case GL_GENERATE_MIPMAP_HINT_SGIS:
116          if (ctx->API == API_OPENGL_CORE)
117             goto invalid_target;
118          if (ctx->Hint.GenerateMipmap == mode)
119             return;
120 	 FLUSH_VERTICES(ctx, _NEW_HINT);
121 	 ctx->Hint.GenerateMipmap = mode;
122          break;
123 
124       /* GL_ARB_fragment_shader */
125       case GL_FRAGMENT_SHADER_DERIVATIVE_HINT_ARB:
126          if (ctx->API == API_OPENGLES || !ctx->Extensions.ARB_fragment_shader)
127             goto invalid_target;
128          if (ctx->Hint.FragmentShaderDerivative == mode)
129             return;
130          FLUSH_VERTICES(ctx, _NEW_HINT);
131          ctx->Hint.FragmentShaderDerivative = mode;
132          break;
133 
134       default:
135          goto invalid_target;
136    }
137 
138    if (ctx->Driver.Hint) {
139       (*ctx->Driver.Hint)( ctx, target, mode );
140    }
141 
142    return;
143 
144 invalid_target:
145    _mesa_error(ctx, GL_INVALID_ENUM, "glHint(target)");
146    return;
147 }
148 
149 
150 /**********************************************************************/
151 /*****                      Initialization                        *****/
152 /**********************************************************************/
153 
_mesa_init_hint(struct gl_context * ctx)154 void _mesa_init_hint( struct gl_context * ctx )
155 {
156    /* Hint group */
157    ctx->Hint.PerspectiveCorrection = GL_DONT_CARE;
158    ctx->Hint.PointSmooth = GL_DONT_CARE;
159    ctx->Hint.LineSmooth = GL_DONT_CARE;
160    ctx->Hint.PolygonSmooth = GL_DONT_CARE;
161    ctx->Hint.Fog = GL_DONT_CARE;
162    ctx->Hint.ClipVolumeClipping = GL_DONT_CARE;
163    ctx->Hint.TextureCompression = GL_DONT_CARE;
164    ctx->Hint.GenerateMipmap = GL_DONT_CARE;
165    ctx->Hint.FragmentShaderDerivative = GL_DONT_CARE;
166 }
167