Name

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 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/.