2003-2004 Silicon Graphics, Inc.
glPointSizePointerOES 3G
glPointSizePointerOES glPointSizePointerOES define an array of point sizes

## C Specification

void `glPointSizePointerOES` GLenum type GLsizei stride const GLvoid * pointer

## Parameters

type

  Specifies the data type of each point size in the array. Symbolic constant `GL_FIXED` is accepted. However, the common profile also accepts the symbolic constant `GL_FLOAT`. The initial value is `GL_FIXED` for the common lite profile, or `GL_FLOAT` for the common profile.

stride

  Specifies the byte offset between consecutive point sizes. If stride is 0, the point sizes are understood to be tightly packed in the array. The initial value is `0`.

pointer

  Specifies a pointer to the point size of the first vertex in the array. The initial value is `0`.

## Description

`glPointSizePointerOES` specifies the location and data of an array of point sizes to use when rendering points. type specifies the data type of the coordinates. stride specifies the byte stride from one point size to the next, allowing vertices and attributes to be packed into a single array or stored in separate arrays. (Single-array storage may be more efficient on some implementations.)

The point sizes supplied in the point size arrays will be the sizes used to render both points and point sprites.

Distance-based attenuation works in conjunction with `GL_POINT_SIZE_ARRAY_OES`. If distance-based attenuation is enabled the point size from the point size array will be attenuated as defined by glPointParameter, to compute the final point size.

When a point size array is specified, type, stride, and pointer are saved as client-side state.

If the point size array is enabled, it is used to control the sizes used to render points and point sprites. To enable and disable the point size array, call glEnableClientState and glDisableClientState with the argument `GL_POINT_SIZE_ARRAY_OES`. The point size array is initially disabled.

## Notes

`glPointSizePointerOES` is only supported if the OpenGL ES version number is 1.1 or greater.

If point size array is enabled, the point size defined by `glPointSize` is ignored.

`glPointSizePointerOES` is typically implemented on the client side.

## Errors

`GL_INVALID_ENUM` is generated if type is not an accepted value.

`GL_INVALID_VALUE` is generated if stride is negative.

## See Also

glDrawArrays, glDrawElements, glPointParameter, glPointSize,

## Copyright

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