Java Doc for GL11.java in  » 6.0-JDK-Modules » j2me » javax » microedition » khronos » opengles » Java Source Code / Java DocumentationJava Source Code and Java Documentation

The OES_matrix_get, OES_point_sprite and OES_point_size_array core extensions are defined as part of this interface.

Methods that are also present in OpenGL ES 1.0 are included in this interface by inheritance, but are not separately documented. Instead, the documentation from the GL10 interface specifies the functional differences between 1.0 and 1.1.

See the GL interface for a description of how to obtain an instance of this interface.

glBindBuffer lets you create or use a named buffer.

If data is non-null, then the source data is copied to the buffer object’s data store.

glBufferSubData lets you modify some or all of the data contained in a buffer object's data store.

Errors

GL_INVALID_ENUM is generated if target is not one of the allowable values.

GL_INVALID_VALUE is generated if offset or size is less than zero, or if offset + size is greater than the value of GL_BUFFER_SIZE.
Parameters:
  target - Specifies the buffer object target.

Geometry is always clipped against the boundaries of a six-plane frustum in x, y, and z.

glDeleteBuffers deletes n buffer objects named by the elements of the array buffers.

glGetBufferParameter returns in params the value or values of the buffer object parameter specified as pname.

glGetClipPlane returns in equation the four coefficients of the plane equation for plane.

Notes

It is always the case that GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i.

If an error is generated, no change is made to the contents of equation.

glGetLight returns in params the value or values of a light source parameter.

glGetMaterial returns in params the value or values of parameter pname of material face.

Five parameters are defined:

• GL_AMBIENT

params returns four values that specify the ambient RGBA reflectance of the material.

glGetPointer returns pointer information in the form of a Buffer reference.

glGetTexParameter returns in params selected values of a texture environment that was specified with glTexEnv.

glGetTexParameter returns in params the value or values of the texture parameter specified as pname.

glIsBuffer returns true if buffer is currently the name of a buffer object.

glIsEnabled returns true if cap is an enabled capability and returns false otherwise.

The following capabilities are accepted for cap:

 Constant                        See function:
 GL_ALPHA_TEST                   glAlphaFunc
 GL_ARRAY_BUFFER_BINDING         glBindBuffer
 GL_BLEND                        glBlendFunc, glLogicOp
 GL_CLIP_PLANE                   glClipPlane
 GL_COLOR_ARRAY                  glColorPointer
 GL_COLOR_LOGIC_OP               glLogicOp
 GL_COLOR_MATERIAL               glColorMaterial
 GL_CULL_FACE                    glCullFace
 GL_DEPTH_TEST                   glDepthFunc, glDepthRange
 GL_DITHER                       glEnable
 GL_FOG                          glFog
 GL_LIGHT                        glLight, glLightModel
 GL_LIGHTING                     glLight, glLightModel, glMaterial
 GL_LINE_SMOOTH                  glLineWidth
 GL_MATRIX_PALETTE_OES           glMatrixMode
 GL_MATRIX_INDEX_ARRAY_OES       glEnableClientState
 GL_MULTISAMPLE                  glEnable
 GL_NORMAL_ARRAY                 glNormalPointer
 GL_NORMALIZE                    glNormal
 GL_POINT_SIZE_ARRAY_OES         glEnableClientState
 GL_POINT_SMOOTH                 glPointSize
 GL_POINT_SPRITE_OES             glEnable, glTexEnv
 GL_POLYGON_OFFSET_FILL          glPolygonOffset
 GL_RESCALE_NORMAL               glEnable
 GL_SAMPLE_ALPHA_TO_COVERAGE     glEnable
 GL_SAMPLE_ALPHA_TO_ONE          glEnable
 GL_SAMPLE_COVERAGE              glEnable
 GL_SCISSOR_TEST                 glScissor
 GL_STENCIL_TEST                 glStencilFunc, glStencilOp
 GL_TEXTURE_2D                   glTexImage2D
 GL_TEXTURE_COORD_ARRAY          glTexCoordPointer
 GL_WEIGHT_ARRAY_OES             glEnableClientState
 GL_VERTEX_ARRAY                 glVertexPointer
 

Notes

If an error is generated, glIsEnabled returns 0.

Errors

GL_INVALID_ENUM is generated if cap is not an accepted value.
Parameters:
  cap - Specifies a symbolic constant indicating a GL capability.

glIsTexture returns true if texture is currently the name of a texture.

glPointParameter assigns values to point parameters.

glPointParameter takes two arguments.

glPointParameter assigns values to point parameters.

glPointParameter takes two arguments.

glPointSizePointer specifies the location and data of an array of point sizes to use when rendering points.

glBindBuffer lets you create or use a named buffer. Calling glBindBuffer with target set to GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER and buffer set to the buffer name, binds the buffer name to the target.

Buffer names are unsigned integers. The value 0 is reserved for GL.

When a buffer is bound to a target, any previous binding for that target is automatically broken.

If an unused buffer name is specified, a buffer object is created. The resulting buffer object is a new state vector, initialized with a zero-sized memory buffer, and with the following state values.

GL_BUFFER_SIZE initialized to 0.

GL_BUFFER_USAGE initialized to GL_STATIC_DRAW.

GL_BUFFER_ACCESS initialized to GL_WRITE_ONLY.

glBindBuffer may also be used to bind an existing buffer object. If the bind is successful no change is made to the state of the newly bound buffer object.

While a buffer is bound, GL operations on the target to which it is bound affect the bound buffer object, and queries of the target to which a buffer object is bound return state from the bound object.

Notes

In the initial state the reserved name zero is bound to GL_ARRAY_BUFFER and GL_ELEMENT_ARRAY_BUFFER. There is no buffer object corresponding to the name zero, so client attempts to modify or query buffer object state for the target GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER while zero is bound will generate GL errors.

While a buffer object is bound, any GL operations on that object affect any other bindings of that object.

Errors

GL_INVALID_ENUM is generated if target is not one of the allowable values.
Parameters:
  target - Specifies the target to which the buffer isbound. Which must be GL_ARRAY_BUFFER orGL_ELEMENT_ARRAY_BUFFER.
Parameters:
  buffer - Specifies the name of a buffer.

If data is non-null, then the source data is copied to the buffer object’s data store. If data is null, then the contents of the buffer object’s data store are undefined.

The options for usage are:

• GL_STATIC_DRAW

Where the data store contents will be specified once by the application, and used many times as the source for GL drawing commands.

• GL_DYNAMIC_DRAW

Where the data store contents will be respecified repeatedly by the application, and used many times as the source for GL drawing commands.

glBufferData deletes any existing data store, and sets the values of the buffer object’s state variables thus:

GL_BUFFER_SIZE initialized to size.

GL_BUFFER_USAGE initialized to usage.

GL_BUFFER_ACCESS initialized to GL_WRITE_ONLY.

Clients must align data elements consistent with the requirements of the client platform, with an additional base-level requirement that an offset within a buffer to a datum comprising N basic machine units be a multiple of N.

Notes

usage is provided as a performance hint only. The specified usage value does not constrain the actual usage pattern of the data store.

Errors

GL_INVALID_ENUM is generated if target is not one of the allowable values.

GL_INVALID_ENUM is generated if usage is not one of the allowable values.

GL_OUT_OF_MEMORY is generated if the GL is unable to create a data store of the requested size.
Parameters:
  target - Specifies the buffer object target, which must beGL_ARRAY_BUFFER orGL_ELEMENT_ARRAY_BUFFER.
Parameters:
  size - Specifies the size of the data store in basic machineunits.
Parameters:
  data - Specifies the source data in client memory.
Parameters:
  usage - Specifies the expected application usage pattern ofthe data store. Accepted values are GL_STATIC_DRAWand GL_DYNAMIC_DRAW.
exception:
  IllegalArgumentException - if data isnon-null but is not a direct buffer.

glBufferSubData lets you modify some or all of the data contained in a buffer object's data store.

Errors

GL_INVALID_ENUM is generated if target is not one of the allowable values.

GL_INVALID_VALUE is generated if offset or size is less than zero, or if offset + size is greater than the value of GL_BUFFER_SIZE.
Parameters:
  target - Specifies the buffer object target. Must beGL_ARRAY_BUFFER orGL_ELEMENT_ARRAY_BUFFER.
Parameters:
  offset - Specifies the starting offset of the data to bereplaced in bytes.
Parameters:
  size - Specifies the size of the data to be replaced in bytes.
Parameters:
  data - Specifies a region of client memory sizebytes in length, containing the data that replace the specifiedbuffer range.
exception:
  IllegalArgumentException - if data isnull.

Geometry is always clipped against the boundaries of a six-plane frustum in x, y, and z. glClipPlane allows the specification of additional planes, not necessarily perpendicular to the x, y, or z axis, against which all geometry is clipped. To determine the maximum number of additional clipping planes, call glGet with argument GL_MAX_CLIP_PLANES. All implementations support at least one such clipping planes. Because the resulting clipping region is the intersection of the defined half-spaces, it is always convex.

glClipPlane specifies a half-space using a four-component plane equation. When glClipPlane is called, equation is transformed by the inverse of the modelview matrix and stored in the resulting eye coordinates. Subsequent changes to the modelview matrix have no effect on the stored plane-equation components. If the dot product of the eye coordinates of a vertex with the stored plane equation components is positive or zero, the vertex is in with respect to that clipping plane. Otherwise, it is out.

To enable and disable clipping planes, call glEnable and glDisable with the argument GL_CLIP_PLANEi, where i is the plane number.

All clipping planes are initially defined as (0, 0, 0, 0) in eye coordinates and are disabled.

Notes

It is always the case that GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i.

Errors

GL_INVALID_ENUM is generated if plane is not an accepted value.

Associated Gets

glGetClipPlane, glIsEnabled with argument GL_CLIP_PLANEi.
Parameters:
  plane - Specifies which clipping plane is beingpositioned. Symbolic names of the formGL_CLIP_PLANEi where 0 < i are accepted.
Parameters:
  equation - Specifies an array of four values. These valuesare interpreted as a plane equation.
Parameters:
  offset - the starting offset within theequation array.
exception:
  IllegalArgumentException - if equation isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - ifequation.length - offset is less than 4.

glDeleteBuffers deletes n buffer objects named by the elements of the array buffers. After a buffer object is deleted, it has no contents, and its name is free for reuse.

glDeleteBuffers silently ignores zero and names that do not correspond to existing buffer objects.

Notes

If a buffer object is deleted while it is bound, all bindings to that object in the current context (i.e., in the thread that called glDeleteBuffers) are reset to zero. Bindings to that buffer in other contexts and other threads are not affected, but attempting to use a deleted buffer in another thread produces undefined results, including but not limited to possible GL errors and rendering corruption. Using a deleted buffer in another context or thread may not, however, result in program termination.

Errors

GL_INVALID_VALUE is generated if n is negative.
Parameters:
  n - Specifies the number of buffer objects to be deleted.
Parameters:
  buffers - Specifies an array of buffer object names to bedeleted.
Parameters:
  offset - the starting offset within thebuffers array.
exception:
  IllegalArgumentException - if buffers isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - ifbuffers.length - offset is less than n.

glGenBuffers returns n buffer object names in buffers.

These names are marked as used, for the purposes of glGenBuffers only, but they acquire buffer state only when they are first bound, just as if they were unused.

Errors

GL_INVALID_VALUE is generated if n is negative.
Parameters:
  n - Specifies the number of buffer object names to be generated.
Parameters:
  buffers - Specifies an array in which the generated bufferobject names are stored.
Parameters:
  offset - the starting offset within thebuffers array.
exception:
  IllegalArgumentException - if buffers isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - ifbuffers.length - offset is less than n.

glGetBufferParameter returns in params the value or values of the buffer object parameter specified as pname. target defines the target buffer object, which must be GL_ARRAY_BUFFER.

• GL_BUFFER_SIZE

Returns the size of the data store in bytes.

• GL_BUFFER_USAGE

Returns the expected application usage pattern of the data store. Possible values are:

• GL_STATIC_DRAW

Where the data store contents will be specified once by the application, and used many times as the source for GL drawing commands.

• GL_DYNAMIC_DRAW

Where the data store contents will be respecified repeatedly by the application, and used many times as the source for GL drawing commands.

• GL_BUFFER_ACCESS

Returns the access capability for the data store. Will always be GL_WRITE_ONLY.

Errors

GL_INVALID_ENUM is generated if target or pname is not one of the accepted defined values.
Parameters:
  target - Specifies the buffer object target. Which must beGL_ARRAY_BUFFER.
Parameters:
  pname - Specifies the symbolic name of a buffer objectparameter. Which can be either GL_BUFFER_SIZE,GL_BUFFER_USAGE, or GL_BUFFER_ACCESS.
Parameters:
  params - returns the buffer object parameters.
exception:
  IllegalArgumentException - if params isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if params.length -offset is smaller than the number of values required bythe parameter.

glGetClipPlane returns in equation the four coefficients of the plane equation for plane.

Notes

It is always the case that GL_CLIP_PLANEi = GL_CLIP_PLANE0 + i.

If an error is generated, no change is made to the contents of equation.

Errors

GL_INVALID_ENUM is generated if plane is not an accepted value.
Parameters:
  plane - Specifies a clipping plane. The number of clippingplanes depends on the implementation, but at least six clippingplanes are supported. They are identified by symbolic names ofthe form GL_CLIP_PLANEi where 0 <i < GL_MAX_CLIP_PLANES
Parameters:
  equation - Returns four values that are the coefficients ofthe plane equation of plane in eye coordinates. The initial valueis (0, 0, 0, 0).
Parameters:
  offset - the starting offset within theequation array.
exception:
  IllegalArgumentException - if equation isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - ifequation.length - offset is less than 4.

glGetLight returns in params the value or values of a light source parameter. light names the light and is a symbolic name of the form GL_LIGHTi for 0 < i < GL_MAX_LIGHTS where GL_MAX_LIGHTS is an implementation dependent constant that is greater than or equal to eight. pname specifies one of ten light source parameters, again by symbolic name. The ten light parameters are defined:

• GL_AMBIENT

params returns four values that specify the ambient RGBA intensity of the light. Both fixed-point and floating-point values are mapped directly. Neither fixed-point nor floating-point values are clamped. The initial ambient light intensity is (0, 0, 0, 1).

• GL_DIFFUSE

params returns four values that specify the diffuse RGBA intensity of the light. Both fixed-point and floating-point values are mapped directly. Neither fixed-point nor floating-point values are clamped. The initial value for GL_LIGHT0 is (1, 1, 1, 1). For other lights, the initial value is (0, 0, 0, 0).

• GL_SPECULAR

params returns four values that specify the specular RGBA intensity of the light. Both fixed-point and floating-point values are mapped directly. Neither fixed-point nor floating-point values are clamped. The initial value for GL_LIGHT0 is (1, 1, 1, 1). For other lights, the initial value is (0, 0, 0, 0).

• GL_EMISSION

params returns four values representing the emitted light intensity of the material. Both fixed-point and floating-point values are mapped directly. The initial value is (0, 0, 0, 1).

• GL_SPOT_DIRECTION

params returns three values that specify the direction of the light in homogeneous object coordinates. Both fixed-point and floating-point values are mapped directly. Neither fixed-point nor floating-point values are clamped. The initial direction is (0, 0, -1).

• GL_SPOT_EXPONENT

params returns a single value that specifies the intensity distribution of the light. Fixed-point and floating-point values are mapped directly. Only values in the range [0, 128] are accepted. The initial spot exponent is 0.

• GL_SPOT_CUTOFF

params returns a single value that specifies the maximum spread angle of a light source. Fixed-point and floating-point values are mapped directly. Only values in the range [0, 90] and the special value 180 are accepted. If the angle between the direction of the light and the direction from the light to the vertex being lighted is greater than the spot cutoff angle, the light is completely masked. Otherwise, its intensity is controlled by the spot exponent and the attenuation factors. The initial spot cutoff is 180.

• GL_CONSTANT_ATTENUATION, GL_LINEAR_ATTENUATION, GL_QUADRATIC_ATTENUATION

params returns a single value that specifies one of the three light attenuation factors. Fixed-point and floating-point values are mapped directly. Only nonnegative values are accepted. If the light is positional, rather than directional, its intensity is attenuated by the reciprocal of the sum of the constant factor, the linear factor times the distance between the light and the vertex being lighted, and the quadratic factor times the square of the same distance. The initial attenuation factors are (1, 0, 0).

Notes

It is always the case that GL_LIGHTi = GL_LIGHT0 + i.

If an error is generated, no change is made to the contents of params.

Errors

GL_INVALID_ENUM is generated if light or pname is not an accepted value.
Parameters:
  light - Specifies a light source. The number of possiblelights depends on the implementation, but at least eight lightsare supported. They are identified by symbolic names of the formGL_LIGHTi where 0 < i .
Parameters:
  pname - Specifies a light source parameter forlight. Accepted symbolic names are GL_AMBIENT,GL_DIFFUSE, GL_SPECULAR,GL_EMISSION, GL_SPOT_DIRECTION,GL_SPOT_EXPONENT, GL_SPOT_CUTOFF,GL_CONSTANT_ATTENUATION,GL_LINEAR_ATTENUATION, andGL_QUADRATIC_ATTENUATION.
Parameters:
  params - returns the requested data.
Parameters:
  offset - the starting offset within theparams array.
exception:
  IllegalArgumentException - if params isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if params.length -offset is smaller than the number of values required bythe parameter.

glGetMaterial returns in params the value or values of parameter pname of material face.

Five parameters are defined:

• GL_AMBIENT

params returns four values that specify the ambient RGBA reflectance of the material. The values are not clamped. The initial ambient reflectance is (0.2, 0.2, 0.2, 1.0).

• GL_DIFFUSE

params returns four values that specify the diffuse RGBA reflectance of the material. The values are not clamped. The initial diffuse reflectance is (0.8, 0.8, 0.8, 1.0).

• GL_SPECULAR

params returns four values that specify the specular RGBA reflectance of the material. The values are not clamped. The initial specular reflectance is (0, 0, 0, 1).

• GL_EMISSION

params returns four values that specify the RGBA emitted light intensity of the material. The values are not clamped. The initial emission intensity is (0, 0, 0, 1).

• GL_SHININESS

params returns a single value that specifies the RGBA specular exponent of the material. The initial specular exponent is 0.

Notes

If an error is generated, no change is made to the contents of params.

Errors

glGetPointer returns pointer information in the form of a Buffer reference. pname is a symbolic constant indicating the pointer to be returned, and params is an array of Buffers in which the returned data will be placed in element 0.

Notes

The pointers are all client-side state.

The initial value for each pointer is null.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.
Parameters:
  pname - Specifies the array or buffer pointer to bereturned. Accepted symbolic names areGL11.GL_COLOR_ARRAY_POINTER,GL11.GL_NORMAL_ARRAY_POINTER,GL11.GL_TEXTURE_COORD_ARRAY_POINTER,GL11.GL_VERTEX_ARRAY_POINTER,GL11.GL_POINT_SIZE_ARRAY_POINTER_OES,GL11Ext.GL_MATRIX_INDEX_ARRAY_POINTER_OES, andGL11Ext.GL_WEIGHT_ARRAY_POINTER_OES.
Parameters:
  params - a non-null array of Bufferscontaining at least one element.
exception:
  IllegalArgumentException - if params isnull or has length less than 1.

glGetTexParameter returns in params selected values of a texture environment that was specified with glTexEnv. target specifies a texture environment. Currently, only one texture environment is defined and supported: GL_TEXTURE_ENV.

pname names a specific texture environment parameter, as follows:

params returns the single-valued texture environment mode, a symbolic constant. The initial value is GL_MODULATE.

params returns four fixed or floating-point values that are the texture environment color. The initial value is (0, 0, 0, 0).

Notes

If an error is generated, no change is made to the contents of params.

Errors

GL_INVALID_ENUM is generated if target or pname is not one of the accepted defined values.
Parameters:
  env - Specifies a texture environment, which must beGL_TEXTURE_ENV.
Parameters:
  pname - Specifies the symbolic name of a texture environmentparameter. pname can be one of the following:GL_TEXTURE_ENV_MODE,GL_TEXTURE_ENV_COLOR,GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T,or GL_GENERATE_MIPMAP.
Parameters:
  params - returns the requested data.
Parameters:
  offset - the starting offset within theparams array.
exception:
  IllegalArgumentException - if params isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if params.length -offset is smaller than the number of values required bythe parameter.

glGetTexParameter returns in params the value or values of the texture parameter specified as pname. target defines the target texture, which must be GL_TEXTURE_2D which specifies two-dimensional texturing. pname accepts the same symbols as glTexParameter, with the same interpretations:

• GL_TEXTURE_MIN_FILTER

Returns the texture minifying function. Which can one of the following: GL_NEAREST, GL_LINEAR, GL_NEAREST_MIPMAP_NEAREST, GL_LINEAR_MIPMAP_NEAREST, GL_NEAREST_MIPMAP_LINEAR, or GL_LINEAR_MIPMAP_LINEAR. The initial value is GL_NEAREST_MIPMAP_LINEAR.

• GL_TEXTURE_MAG_FILTER

Returns the texture magnification function. Which can be either GL_NEAREST or GL_LINEAR. The initial value is GL_LINEAR.

• GL_TEXTURE_WRAP_S

Returns the wrap parameter for texture coordinate s. Which can be either: GL_CLAMP, GL_CLAMP_TO_EDGE, or GL_REPEAT. The initial value is GL_REPEAT.

• GL_TEXTURE_WRAP_T

Returns the wrap parameter for texture coordinate t. Which can be either: GL_CLAMP, GL_CLAMP_TO_EDGE, or GL_REPEAT. The initial value is GL_REPEAT.

• GL_GENERATE_MIPMAP

Returns the automatic mipmap generation parameter. The initial value is GL_FALSE.

Notes

If an error is generated, no change is made to the contents of params.

Errors

GL_INVALID_ENUM is generated if target or pname is not one of the accepted defined values.
Parameters:
  target - Specifies the target texture, which must beGL_TEXTURE_2D.
Parameters:
  pname - Specifies the symbolic name of a textureparameter. pname can be one of the following:GL_TEXTURE_MIN_FILTER,GL_TEXTURE_MAG_FILTER,GL_TEXTURE_WRAP_S, GL_TEXTURE_WRAP_T,or GL_GENERATE_MIPMAP.
Parameters:
  params - returns the texture parameters.
Parameters:
  offset - the starting offset within theparams array.
exception:
  IllegalArgumentException - if params isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if params.length -offset is smaller than the number of values required bythe parameter.

glIsBuffer returns true if buffer is currently the name of a buffer object. If buffer is zero, or is a non-zero value that is not currently the name of a buffer object, glIsBuffer returns false.
Parameters:
  buffer - Specifies a value that may be the name of a buffer object. true if buffer is the name of abuffer object.

glIsEnabled returns true if cap is an enabled capability and returns false otherwise.

The following capabilities are accepted for cap:

 Constant                        See function:
 GL_ALPHA_TEST                   glAlphaFunc
 GL_ARRAY_BUFFER_BINDING         glBindBuffer
 GL_BLEND                        glBlendFunc, glLogicOp
 GL_CLIP_PLANE                   glClipPlane
 GL_COLOR_ARRAY                  glColorPointer
 GL_COLOR_LOGIC_OP               glLogicOp
 GL_COLOR_MATERIAL               glColorMaterial
 GL_CULL_FACE                    glCullFace
 GL_DEPTH_TEST                   glDepthFunc, glDepthRange
 GL_DITHER                       glEnable
 GL_FOG                          glFog
 GL_LIGHT                        glLight, glLightModel
 GL_LIGHTING                     glLight, glLightModel, glMaterial
 GL_LINE_SMOOTH                  glLineWidth
 GL_MATRIX_PALETTE_OES           glMatrixMode
 GL_MATRIX_INDEX_ARRAY_OES       glEnableClientState
 GL_MULTISAMPLE                  glEnable
 GL_NORMAL_ARRAY                 glNormalPointer
 GL_NORMALIZE                    glNormal
 GL_POINT_SIZE_ARRAY_OES         glEnableClientState
 GL_POINT_SMOOTH                 glPointSize
 GL_POINT_SPRITE_OES             glEnable, glTexEnv
 GL_POLYGON_OFFSET_FILL          glPolygonOffset
 GL_RESCALE_NORMAL               glEnable
 GL_SAMPLE_ALPHA_TO_COVERAGE     glEnable
 GL_SAMPLE_ALPHA_TO_ONE          glEnable
 GL_SAMPLE_COVERAGE              glEnable
 GL_SCISSOR_TEST                 glScissor
 GL_STENCIL_TEST                 glStencilFunc, glStencilOp
 GL_TEXTURE_2D                   glTexImage2D
 GL_TEXTURE_COORD_ARRAY          glTexCoordPointer
 GL_WEIGHT_ARRAY_OES             glEnableClientState
 GL_VERTEX_ARRAY                 glVertexPointer
 

Notes

If an error is generated, glIsEnabled returns 0.

Errors

GL_INVALID_ENUM is generated if cap is not an accepted value.
Parameters:
  cap - Specifies a symbolic constant indicating a GL capability. true if the given capability is enabled.

glIsTexture returns true if texture is currently the name of a texture. If texture is zero, or is a non-zero value that is not currently the name of a texture, or if an error occurs, glIsTexture returns false.
Parameters:
  texture - Specifies a value that may be the name of a texture. true if texture is the name of atexture object.

glPointParameter assigns values to point parameters.

glPointParameter takes two arguments. pname specifies which of several parameters will be modified. param specifies what value will be assigned to the specified parameter.

The parameters that can be specified using glPointParameter, and their interpretations are as follows:

• GL_POINT_SIZE_MIN

param specifies the lower bound to which the derived point size is clamped.

• GL_POINT_SIZE_MAX

param specifies the upper bound to which the derived point size is clamped.

• GL_POINT_FADE_THRESHOLD_SIZE

param specifies to the point fade threshold.

Notes

If the point size lower bound is greater than the upper bound, then the point size after clamping is undefined.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if assigned values for

GL_POINT_SIZE_MIN, GL_POINT_SIZE_MAX, or GL_POINT_FADE_THRESHOLD_SIZE are less then zero.
Parameters:
  pname - Specifies the single-valued parameter to beupdated. Can be either GL_POINT_SIZE_MIN,GL_POINT_SIZE_MAX, orGL_POINT_FADE_THRESHOLD_SIZE.
Parameters:
  param - Specifies the value that the parameter will be setto.

glPointParameter assigns values to point parameters.

glPointParameter takes two arguments. pname specifies which of several parameters will be modified. params specifies what values will be assigned to the specified parameter.

The parameters that can be specified using glPointParameter, and their interpretations are as follows:

• GL_POINT_SIZE_MIN

params contains the lower bound to which the derived point size is clamped.

• GL_POINT_SIZE_MAX

params contains the upper bound to which the derived point size is clamped.

• GL_POINT_FADE_THRESHOLD_SIZE

params contains the point fade threshold.

• GL_POINT_DISTANCE_ATTENUATION

params contains the distance attenuation function coefficients a, b, and c.

Notes

If the point size lower bound is greater than the upper bound, then the point size after clamping is undefined.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if assigned values for

GL_POINT_SIZE_MIN, GL_POINT_SIZE_MAX, or GL_POINT_FADE_THRESHOLD_SIZE are less then zero.
Parameters:
  pname - Specifies the parameter to be updated. Can be eitherGL_POINT_SIZE_MIN, GL_POINT_SIZE_MAX,GL_POINT_FADE_THRESHOLD_SIZE, orGL_POINT_DISTANCE_ATTENUATION.
Parameters:
  params - Specifies an array of values thatpname will be set to.
exception:
  IllegalArgumentException - if params isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if params.length -offset is smaller than the number of values required bythe parameter.

glPointSizePointer specifies the location and data of an array of point sizes to use when rendering points. type is 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

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

glPointSizePointer 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.
Parameters:
  type - Specifies the data type of each point size in thearray. Symbolic constants GL_FIXED andGL_FLOAT are accepted. The initial value isGL_FLOAT.
Parameters:
  stride - Specifies the byte offset between consecutive pointsizes. If stride is 0, the point sizes areunderstood to be tightly packed in the array. The initial valueis 0.
Parameters:
  pointer - Specifies a Buffer containing thepoint sizes starting at the first vertex in the array. Theinitial value is 0.
exception:
  IllegalArgumentException - if pointer isnull.
exception:
  IllegalStateException - if VBOs are enabled.