• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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