Light | Dark

# docs.GL

OpenGL 4
OpenGL 3
OpenGL 2

# glPointParameter

## 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 https://web.archive.org/web/20171022161616/http://oss.sgi.com/projects/FreeB/.

Think you can improve this page? Edit this page on GitHub.