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 */
43static ALWAYS_INLINE void
44point_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
62void GLAPIENTRY
63_mesa_PointSize_no_error(GLfloat size)
64{
65   GET_CURRENT_CONTEXT(ctx);
66   point_size(ctx, size, true);
67}
68
69
70void GLAPIENTRY
71_mesa_PointSize( GLfloat size )
72{
73   GET_CURRENT_CONTEXT(ctx);
74   point_size(ctx, size, false);
75}
76
77
78void GLAPIENTRY
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
88void GLAPIENTRY
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
101void GLAPIENTRY
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
111void GLAPIENTRY
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 */
239void
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