1 /**
2 * \file points.c
3 * Point operations.
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 #include "glheader.h"
32 #include "context.h"
33 #include "macros.h"
34 #include "points.h"
35 #include "mtypes.h"
36
37
38 /**
39 * Set current point size.
40 * \param size point diameter in pixels
41 * \sa glPointSize().
42 */
43 static ALWAYS_INLINE void
point_size(struct gl_context * ctx,GLfloat size,bool no_error)44 point_size(struct gl_context *ctx, GLfloat size, bool no_error)
45 {
46 if (ctx->Point.Size == size)
47 return;
48
49 if (!no_error && size <= 0.0F) {
50 _mesa_error(ctx, GL_INVALID_VALUE, "glPointSize");
51 return;
52 }
53
54 FLUSH_VERTICES(ctx, _NEW_POINT);
55 ctx->Point.Size = size;
56
57 if (ctx->Driver.PointSize)
58 ctx->Driver.PointSize(ctx, size);
59 }
60
61
62 void GLAPIENTRY
_mesa_PointSize_no_error(GLfloat size)63 _mesa_PointSize_no_error(GLfloat size)
64 {
65 GET_CURRENT_CONTEXT(ctx);
66 point_size(ctx, size, true);
67 }
68
69
70 void GLAPIENTRY
_mesa_PointSize(GLfloat size)71 _mesa_PointSize( GLfloat size )
72 {
73 GET_CURRENT_CONTEXT(ctx);
74 point_size(ctx, size, false);
75 }
76
77
78 void GLAPIENTRY
_mesa_PointParameteri(GLenum pname,GLint param)79 _mesa_PointParameteri( GLenum pname, GLint param )
80 {
81 GLfloat p[3];
82 p[0] = (GLfloat) param;
83 p[1] = p[2] = 0.0F;
84 _mesa_PointParameterfv(pname, p);
85 }
86
87
88 void GLAPIENTRY
_mesa_PointParameteriv(GLenum pname,const GLint * params)89 _mesa_PointParameteriv( GLenum pname, const GLint *params )
90 {
91 GLfloat p[3];
92 p[0] = (GLfloat) params[0];
93 if (pname == GL_DISTANCE_ATTENUATION_EXT) {
94 p[1] = (GLfloat) params[1];
95 p[2] = (GLfloat) params[2];
96 }
97 _mesa_PointParameterfv(pname, p);
98 }
99
100
101 void GLAPIENTRY
_mesa_PointParameterf(GLenum pname,GLfloat param)102 _mesa_PointParameterf( GLenum pname, GLfloat param)
103 {
104 GLfloat p[3];
105 p[0] = param;
106 p[1] = p[2] = 0.0F;
107 _mesa_PointParameterfv(pname, p);
108 }
109
110
111 void GLAPIENTRY
_mesa_PointParameterfv(GLenum pname,const GLfloat * params)112 _mesa_PointParameterfv( GLenum pname, const GLfloat *params)
113 {
114 GET_CURRENT_CONTEXT(ctx);
115
116 /* Drivers that support point sprites must also support point parameters.
117 * If point parameters aren't supported, then this function shouldn't even
118 * exist.
119 */
120 assert(!(ctx->Extensions.ARB_point_sprite
121 || ctx->Extensions.NV_point_sprite)
122 || ctx->Extensions.EXT_point_parameters);
123
124 if (!ctx->Extensions.EXT_point_parameters) {
125 _mesa_error(ctx, GL_INVALID_OPERATION,
126 "unsupported function called (unsupported extension)");
127 return;
128 }
129
130 switch (pname) {
131 case GL_DISTANCE_ATTENUATION_EXT:
132 if (TEST_EQ_3V(ctx->Point.Params, params))
133 return;
134 FLUSH_VERTICES(ctx, _NEW_POINT);
135 COPY_3V(ctx->Point.Params, params);
136 ctx->Point._Attenuated = (ctx->Point.Params[0] != 1.0F ||
137 ctx->Point.Params[1] != 0.0F ||
138 ctx->Point.Params[2] != 0.0F);
139 break;
140 case GL_POINT_SIZE_MIN_EXT:
141 if (params[0] < 0.0F) {
142 _mesa_error( ctx, GL_INVALID_VALUE,
143 "glPointParameterf[v]{EXT,ARB}(param)" );
144 return;
145 }
146 if (ctx->Point.MinSize == params[0])
147 return;
148 FLUSH_VERTICES(ctx, _NEW_POINT);
149 ctx->Point.MinSize = params[0];
150 break;
151 case GL_POINT_SIZE_MAX_EXT:
152 if (params[0] < 0.0F) {
153 _mesa_error( ctx, GL_INVALID_VALUE,
154 "glPointParameterf[v]{EXT,ARB}(param)" );
155 return;
156 }
157 if (ctx->Point.MaxSize == params[0])
158 return;
159 FLUSH_VERTICES(ctx, _NEW_POINT);
160 ctx->Point.MaxSize = params[0];
161 break;
162 case GL_POINT_FADE_THRESHOLD_SIZE_EXT:
163 if (params[0] < 0.0F) {
164 _mesa_error( ctx, GL_INVALID_VALUE,
165 "glPointParameterf[v]{EXT,ARB}(param)" );
166 return;
167 }
168 if (ctx->Point.Threshold == params[0])
169 return;
170 FLUSH_VERTICES(ctx, _NEW_POINT);
171 ctx->Point.Threshold = params[0];
172 break;
173 case GL_POINT_SPRITE_R_MODE_NV:
174 /* This is one area where ARB_point_sprite and NV_point_sprite
175 * differ. In ARB_point_sprite the POINT_SPRITE_R_MODE is
176 * always ZERO. NV_point_sprite adds the S and R modes.
177 */
178 if (_mesa_is_desktop_gl(ctx) && ctx->Extensions.NV_point_sprite) {
179 GLenum value = (GLenum) params[0];
180 if (value != GL_ZERO && value != GL_S && value != GL_R) {
181 _mesa_error(ctx, GL_INVALID_VALUE,
182 "glPointParameterf[v]{EXT,ARB}(param)");
183 return;
184 }
185 if (ctx->Point.SpriteRMode == value)
186 return;
187 FLUSH_VERTICES(ctx, _NEW_POINT);
188 ctx->Point.SpriteRMode = value;
189 }
190 else {
191 _mesa_error(ctx, GL_INVALID_ENUM,
192 "glPointParameterf[v]{EXT,ARB}(pname)");
193 return;
194 }
195 break;
196 case GL_POINT_SPRITE_COORD_ORIGIN:
197 /* GL_POINT_SPRITE_COORD_ORIGIN was added to point sprites when the
198 * extension was merged into OpenGL 2.0.
199 */
200 if ((ctx->API == API_OPENGL_COMPAT && ctx->Version >= 20)
201 || ctx->API == API_OPENGL_CORE) {
202 GLenum value = (GLenum) params[0];
203 if (value != GL_LOWER_LEFT && value != GL_UPPER_LEFT) {
204 _mesa_error(ctx, GL_INVALID_VALUE,
205 "glPointParameterf[v]{EXT,ARB}(param)");
206 return;
207 }
208 if (ctx->Point.SpriteOrigin == value)
209 return;
210 FLUSH_VERTICES(ctx, _NEW_POINT);
211 ctx->Point.SpriteOrigin = value;
212 }
213 else {
214 _mesa_error(ctx, GL_INVALID_ENUM,
215 "glPointParameterf[v]{EXT,ARB}(pname)");
216 return;
217 }
218 break;
219 default:
220 _mesa_error( ctx, GL_INVALID_ENUM,
221 "glPointParameterf[v]{EXT,ARB}(pname)" );
222 return;
223 }
224
225 if (ctx->Driver.PointParameterfv)
226 ctx->Driver.PointParameterfv(ctx, pname, params);
227 }
228
229
230
231 /**
232 * Initialize the context point state.
233 *
234 * \param ctx GL context.
235 *
236 * Initializes __struct gl_contextRec::Point and point related constants in
237 * __struct gl_contextRec::Const.
238 */
239 void
_mesa_init_point(struct gl_context * ctx)240 _mesa_init_point(struct gl_context *ctx)
241 {
242 ctx->Point.SmoothFlag = GL_FALSE;
243 ctx->Point.Size = 1.0;
244 ctx->Point.Params[0] = 1.0;
245 ctx->Point.Params[1] = 0.0;
246 ctx->Point.Params[2] = 0.0;
247 ctx->Point._Attenuated = GL_FALSE;
248 ctx->Point.MinSize = 0.0;
249 ctx->Point.MaxSize
250 = MAX2(ctx->Const.MaxPointSize, ctx->Const.MaxPointSizeAA);
251 ctx->Point.Threshold = 1.0;
252
253 /* Page 403 (page 423 of the PDF) of the OpenGL 3.0 spec says:
254 *
255 * "Non-sprite points (section 3.4) - Enable/Disable targets
256 * POINT_SMOOTH and POINT_SPRITE, and all associated state. Point
257 * rasterization is always performed as though POINT_SPRITE were
258 * enabled."
259 *
260 * In a core context, the state will default to true, and the setters and
261 * getters are disabled.
262 */
263 ctx->Point.PointSprite = (ctx->API == API_OPENGL_CORE ||
264 ctx->API == API_OPENGLES2);
265
266 ctx->Point.SpriteRMode = GL_ZERO; /* GL_NV_point_sprite (only!) */
267 ctx->Point.SpriteOrigin = GL_UPPER_LEFT; /* GL_ARB_point_sprite */
268 ctx->Point.CoordReplace = 0; /* GL_ARB/NV_point_sprite */
269 }
270