Name

glPointParameter — specify point parameters

C Specification

void glPointParameterf(GLenum pname,
 GLfloat param);
 

void glPointParameteri(GLenum pname,
 GLint param);
 

Parameters

pname

Specifies a single-valued point parameter. GL_POINT_SIZE_MIN, GL_POINT_SIZE_MAX, GL_POINT_FADE_THRESHOLD_SIZE, and GL_POINT_SPRITE_COORD_ORIGIN are accepted.

param

Specifies the value that pname will be set to.

C Specification

void glPointParameterfv(GLenum pname,
 const GLfloat * params);
 

void glPointParameteriv(GLenum pname,
 const GLint * params);
 

Parameters

pname

Specifies a point parameter. GL_POINT_SIZE_MIN, GL_POINT_SIZE_MAX, GL_POINT_DISTANCE_ATTENUATION, GL_POINT_FADE_THRESHOLD_SIZE, and GL_POINT_SPRITE_COORD_ORIGIN are accepted.

params

Specifies the value or values to be assigned to pname. GL_POINT_DISTANCE_ATTENUATION requires an array of three values. All other parameters accept an array containing only a single value.

Description

The following values are accepted for pname:

GL_POINT_SIZE_MIN

params is a single floating-point value that specifies the minimum point size. The default value is 0.0.

GL_POINT_SIZE_MAX

params is a single floating-point value that specifies the maximum point size. The default value is 1.0.

GL_POINT_FADE_THRESHOLD_SIZE

params is a single floating-point value that specifies the threshold value to which point sizes are clamped if they exceed the specified value. The default value is 1.0.

GL_POINT_DISTANCE_ATTENUATION

params is an array of three floating-point values that specify the coefficients used for scaling the computed point size. The default values are 1 0 0 .

GL_POINT_SPRITE_COORD_ORIGIN

params is a single enum specifying the point sprite texture coordinate origin, either GL_LOWER_LEFT or GL_UPPER_LEFT. The default value is GL_UPPER_LEFT.

Notes

glPointParameter is available only if the GL version is 1.4 or greater.

GL_POINT_SPRITE_COORD_ORIGIN is available only if the GL version is 2.0 or greater.

Errors

GL_INVALID_VALUE is generated If the value specified for GL_POINT_SIZE_MIN, GL_POINT_SIZE_MAX, or GL_POINT_FADE_THRESHOLD_SIZE is less than zero.

GL_INVALID_ENUM is generated If the value specified for GL_POINT_SPRITE_COORD_ORIGIN is not GL_LOWER_LEFT or GL_UPPER_LEFT.

If the value for GL_POINT_SIZE_MIN is greater than GL_POINT_SIZE_MAX, the point size after clamping is undefined, but no error is generated.

Associated Gets

glGet with argument GL_POINT_SIZE_MIN

glGet with argument GL_POINT_SIZE_MAX

glGet with argument GL_POINT_FADE_THRESHOLD_SIZE

glGet with argument GL_POINT_DISTANCE_ATTENUATION

glGet with argument GL_POINT_SPRITE_COORD_ORIGIN

See Also

glPointSize

Copyright

Copyright © 1991-2006 Silicon Graphics, Inc. This document is licensed under the SGI Free Software B License. For details, see http://oss.sgi.com/projects/FreeB/.