net.rim.device.api.opengles
Interface GL20

All Superinterfaces:
GL

public interface GL20
extends GL

The GL20 interface contains Java™ programming language bindings for OpenGL® ES 2.0 functionality. The bindings are similar to the bindings described for OpenGL ES 1.1 in JSR 239.

See the GL interface documentation to learn how to get an object that implements this interface.

The glGetVertexAttribPointerv(int index, int pname, void** pointer) OpenGL ES 2.0 method is not implemented.

Since:
BlackBerry API 7.0.0

Field Summary
static int GL_ACTIVE_ATTRIBUTES
          OpenGL ES 2.0 constant.
static int GL_ACTIVE_ATTRIBUTE_MAX_LENGTH
          OpenGL ES 2.0 constant.
static int GL_ACTIVE_TEXTURE
          OpenGL ES 2.0 constant.
static int GL_ACTIVE_UNIFORMS
          OpenGL ES 2.0 constant.
static int GL_ACTIVE_UNIFORM_MAX_LENGTH
          OpenGL ES 2.0 constant.
static int GL_ALIASED_LINE_WIDTH_RANGE
          OpenGL ES 2.0 constant.
static int GL_ALIASED_POINT_SIZE_RANGE
          OpenGL ES 2.0 constant.
static int GL_ALPHA
          OpenGL ES 2.0 constant.
static int GL_ALPHA_BITS
          OpenGL ES 2.0 constant.
static int GL_ALWAYS
          OpenGL ES 2.0 constant.
static int GL_ARRAY_BUFFER
          OpenGL ES 2.0 constant.
static int GL_ARRAY_BUFFER_BINDING
          OpenGL ES 2.0 constant.
static int GL_ATTACHED_SHADERS
          OpenGL ES 2.0 constant.
static int GL_BACK
          OpenGL ES 2.0 constant.
static int GL_BLEND
          OpenGL ES 2.0 constant.
static int GL_BLEND_COLOR
          OpenGL ES 2.0 constant.
static int GL_BLEND_DST_ALPHA
          OpenGL ES 2.0 constant.
static int GL_BLEND_DST_RGB
          OpenGL ES 2.0 constant.
static int GL_BLEND_EQUATION
          OpenGL ES 2.0 constant.
static int GL_BLEND_EQUATION_ALPHA
          OpenGL ES 2.0 constant.
static int GL_BLEND_EQUATION_RGB
          OpenGL ES 2.0 constant.
static int GL_BLEND_SRC_ALPHA
          OpenGL ES 2.0 constant.
static int GL_BLEND_SRC_RGB
          OpenGL ES 2.0 constant.
static int GL_BLUE_BITS
          OpenGL ES 2.0 constant.
static int GL_BOOL
          OpenGL ES 2.0 constant.
static int GL_BOOL_VEC2
          OpenGL ES 2.0 constant.
static int GL_BOOL_VEC3
          OpenGL ES 2.0 constant.
static int GL_BOOL_VEC4
          OpenGL ES 2.0 constant.
static int GL_BUFFER_SIZE
          OpenGL ES 2.0 constant.
static int GL_BUFFER_USAGE
          OpenGL ES 2.0 constant.
static int GL_BYTE
          OpenGL ES 2.0 constant.
static int GL_CCW
          OpenGL ES 2.0 constant.
static int GL_CLAMP_TO_EDGE
          OpenGL ES 2.0 constant.
static int GL_COLOR_ATTACHMENT0
          OpenGL ES 2.0 constant.
static int GL_COLOR_BUFFER_BIT
          OpenGL ES 2.0 constant.
static int GL_COLOR_CLEAR_VALUE
          OpenGL ES 2.0 constant.
static int GL_COLOR_WRITEMASK
          OpenGL ES 2.0 constant.
static int GL_COMPILE_STATUS
          OpenGL ES 2.0 constant.
static int GL_COMPRESSED_TEXTURE_FORMATS
          OpenGL ES 2.0 constant.
static int GL_CONSTANT_ALPHA
          OpenGL ES 2.0 constant.
static int GL_CONSTANT_COLOR
          OpenGL ES 2.0 constant.
static int GL_CULL_FACE
          OpenGL ES 2.0 constant.
static int GL_CULL_FACE_MODE
          OpenGL ES 2.0 constant.
static int GL_CURRENT_PROGRAM
          OpenGL ES 2.0 constant.
static int GL_CURRENT_VERTEX_ATTRIB
          OpenGL ES 2.0 constant.
static int GL_CW
          OpenGL ES 2.0 constant.
static int GL_DECR
          OpenGL ES 2.0 constant.
static int GL_DECR_WRAP
          OpenGL ES 2.0 constant.
static int GL_DELETE_STATUS
          OpenGL ES 2.0 constant.
static int GL_DEPTH_ATTACHMENT
          OpenGL ES 2.0 constant.
static int GL_DEPTH_BITS
          OpenGL ES 2.0 constant.
static int GL_DEPTH_BUFFER_BIT
          OpenGL ES 2.0 constant.
static int GL_DEPTH_CLEAR_VALUE
          OpenGL ES 2.0 constant.
static int GL_DEPTH_COMPONENT
          OpenGL ES 2.0 constant.
static int GL_DEPTH_COMPONENT16
          OpenGL ES 2.0 constant.
static int GL_DEPTH_FUNC
          OpenGL ES 2.0 constant.
static int GL_DEPTH_RANGE
          OpenGL ES 2.0 constant.
static int GL_DEPTH_TEST
          OpenGL ES 2.0 constant.
static int GL_DEPTH_WRITEMASK
          OpenGL ES 2.0 constant.
static int GL_DITHER
          OpenGL ES 2.0 constant.
static int GL_DONT_CARE
          OpenGL ES 2.0 constant.
static int GL_DST_ALPHA
          OpenGL ES 2.0 constant.
static int GL_DST_COLOR
          OpenGL ES 2.0 constant.
static int GL_DYNAMIC_DRAW
          OpenGL ES 2.0 constant.
static int GL_ELEMENT_ARRAY_BUFFER
          OpenGL ES 2.0 constant.
static int GL_ELEMENT_ARRAY_BUFFER_BINDING
          OpenGL ES 2.0 constant.
static int GL_EQUAL
          OpenGL ES 2.0 constant.
static int GL_ES_VERSION_2_0
          OpenGL ES 2.0 constant.
static int GL_EXTENSIONS
          OpenGL ES 2.0 constant.
static int GL_FALSE
          OpenGL ES 2.0 constant.
static int GL_FASTEST
          OpenGL ES 2.0 constant.
static int GL_FIXED
          OpenGL ES 2.0 constant.
static int GL_FLOAT
          OpenGL ES 2.0 constant.
static int GL_FLOAT_MAT2
          OpenGL ES 2.0 constant.
static int GL_FLOAT_MAT3
          OpenGL ES 2.0 constant.
static int GL_FLOAT_MAT4
          OpenGL ES 2.0 constant.
static int GL_FLOAT_VEC2
          OpenGL ES 2.0 constant.
static int GL_FLOAT_VEC3
          OpenGL ES 2.0 constant.
static int GL_FLOAT_VEC4
          OpenGL ES 2.0 constant.
static int GL_FRAGMENT_SHADER
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_BINDING
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_COMPLETE
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT
          OpenGL ES 2.0 constant.
static int GL_FRAMEBUFFER_UNSUPPORTED
          OpenGL ES 2.0 constant.
static int GL_FRONT
          OpenGL ES 2.0 constant.
static int GL_FRONT_AND_BACK
          OpenGL ES 2.0 constant.
static int GL_FRONT_FACE
          OpenGL ES 2.0 constant.
static int GL_FUNC_ADD
          OpenGL ES 2.0 constant.
static int GL_FUNC_REVERSE_SUBTRACT
          OpenGL ES 2.0 constant.
static int GL_FUNC_SUBTRACT
          OpenGL ES 2.0 constant.
static int GL_GENERATE_MIPMAP_HINT
          OpenGL ES 2.0 constant.
static int GL_GEQUAL
          OpenGL ES 2.0 constant.
static int GL_GREATER
          OpenGL ES 2.0 constant.
static int GL_GREEN_BITS
          OpenGL ES 2.0 constant.
static int GL_HIGH_FLOAT
          OpenGL ES 2.0 constant.
static int GL_HIGH_INT
          OpenGL ES 2.0 constant.
static int GL_IMPLEMENTATION_COLOR_READ_FORMAT
          OpenGL ES 2.0 constant.
static int GL_IMPLEMENTATION_COLOR_READ_TYPE
          OpenGL ES 2.0 constant.
static int GL_INCR
          OpenGL ES 2.0 constant.
static int GL_INCR_WRAP
          OpenGL ES 2.0 constant.
static int GL_INFO_LOG_LENGTH
          OpenGL ES 2.0 constant.
static int GL_INT
          OpenGL ES 2.0 constant.
static int GL_INT_VEC2
          OpenGL ES 2.0 constant.
static int GL_INT_VEC3
          OpenGL ES 2.0 constant.
static int GL_INT_VEC4
          OpenGL ES 2.0 constant.
static int GL_INVALID_ENUM
          OpenGL ES 2.0 constant.
static int GL_INVALID_FRAMEBUFFER_OPERATION
          OpenGL ES 2.0 constant.
static int GL_INVALID_OPERATION
          OpenGL ES 2.0 constant.
static int GL_INVALID_VALUE
          OpenGL ES 2.0 constant.
static int GL_INVERT
          OpenGL ES 2.0 constant.
static int GL_KEEP
          OpenGL ES 2.0 constant.
static int GL_LEQUAL
          OpenGL ES 2.0 constant.
static int GL_LESS
          OpenGL ES 2.0 constant.
static int GL_LINEAR
          OpenGL ES 2.0 constant.
static int GL_LINEAR_MIPMAP_LINEAR
          OpenGL ES 2.0 constant.
static int GL_LINEAR_MIPMAP_NEAREST
          OpenGL ES 2.0 constant.
static int GL_LINES
          OpenGL ES 2.0 constant.
static int GL_LINE_LOOP
          OpenGL ES 2.0 constant.
static int GL_LINE_STRIP
          OpenGL ES 2.0 constant.
static int GL_LINE_WIDTH
          OpenGL ES 2.0 constant.
static int GL_LINK_STATUS
          OpenGL ES 2.0 constant.
static int GL_LOW_FLOAT
          OpenGL ES 2.0 constant.
static int GL_LOW_INT
          OpenGL ES 2.0 constant.
static int GL_LUMINANCE
          OpenGL ES 2.0 constant.
static int GL_LUMINANCE_ALPHA
          OpenGL ES 2.0 constant.
static int GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS
          OpenGL ES 2.0 constant.
static int GL_MAX_CUBE_MAP_TEXTURE_SIZE
          OpenGL ES 2.0 constant.
static int GL_MAX_FRAGMENT_UNIFORM_VECTORS
          OpenGL ES 2.0 constant.
static int GL_MAX_RENDERBUFFER_SIZE
          OpenGL ES 2.0 constant.
static int GL_MAX_TEXTURE_IMAGE_UNITS
          OpenGL ES 2.0 constant.
static int GL_MAX_TEXTURE_SIZE
          OpenGL ES 2.0 constant.
static int GL_MAX_VARYING_VECTORS
          OpenGL ES 2.0 constant.
static int GL_MAX_VERTEX_ATTRIBS
          OpenGL ES 2.0 constant.
static int GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS
          OpenGL ES 2.0 constant.
static int GL_MAX_VERTEX_UNIFORM_VECTORS
          OpenGL ES 2.0 constant.
static int GL_MAX_VIEWPORT_DIMS
          OpenGL ES 2.0 constant.
static int GL_MEDIUM_FLOAT
          OpenGL ES 2.0 constant.
static int GL_MEDIUM_INT
          OpenGL ES 2.0 constant.
static int GL_MIRRORED_REPEAT
          OpenGL ES 2.0 constant.
static int GL_NEAREST
          OpenGL ES 2.0 constant.
static int GL_NEAREST_MIPMAP_LINEAR
          OpenGL ES 2.0 constant.
static int GL_NEAREST_MIPMAP_NEAREST
          OpenGL ES 2.0 constant.
static int GL_NEVER
          OpenGL ES 2.0 constant.
static int GL_NICEST
          OpenGL ES 2.0 constant.
static int GL_NONE
          OpenGL ES 2.0 constant.
static int GL_NOTEQUAL
          OpenGL ES 2.0 constant.
static int GL_NO_ERROR
          OpenGL ES 2.0 constant.
static int GL_NUM_COMPRESSED_TEXTURE_FORMATS
          OpenGL ES 2.0 constant.
static int GL_NUM_SHADER_BINARY_FORMATS
          OpenGL ES 2.0 constant.
static int GL_ONE
          OpenGL ES 2.0 constant.
static int GL_ONE_MINUS_CONSTANT_ALPHA
          OpenGL ES 2.0 constant.
static int GL_ONE_MINUS_CONSTANT_COLOR
          OpenGL ES 2.0 constant.
static int GL_ONE_MINUS_DST_ALPHA
          OpenGL ES 2.0 constant.
static int GL_ONE_MINUS_DST_COLOR
          OpenGL ES 2.0 constant.
static int GL_ONE_MINUS_SRC_ALPHA
          OpenGL ES 2.0 constant.
static int GL_ONE_MINUS_SRC_COLOR
          OpenGL ES 2.0 constant.
static int GL_OUT_OF_MEMORY
          OpenGL ES 2.0 constant.
static int GL_PACK_ALIGNMENT
          OpenGL ES 2.0 constant.
static int GL_POINTS
          OpenGL ES 2.0 constant.
static int GL_POLYGON_OFFSET_FACTOR
          OpenGL ES 2.0 constant.
static int GL_POLYGON_OFFSET_FILL
          OpenGL ES 2.0 constant.
static int GL_POLYGON_OFFSET_UNITS
          OpenGL ES 2.0 constant.
static int GL_RED_BITS
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_ALPHA_SIZE
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_BINDING
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_BLUE_SIZE
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_DEPTH_SIZE
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_GREEN_SIZE
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_HEIGHT
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_INTERNAL_FORMAT
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_RED_SIZE
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_STENCIL_SIZE
          OpenGL ES 2.0 constant.
static int GL_RENDERBUFFER_WIDTH
          OpenGL ES 2.0 constant.
static int GL_RENDERER
          OpenGL ES 2.0 constant.
static int GL_REPEAT
          OpenGL ES 2.0 constant.
static int GL_REPLACE
          OpenGL ES 2.0 constant.
static int GL_RGB
          OpenGL ES 2.0 constant.
static int GL_RGB565
          OpenGL ES 2.0 constant.
static int GL_RGB5_A1
          OpenGL ES 2.0 constant.
static int GL_RGBA
          OpenGL ES 2.0 constant.
static int GL_RGBA4
          OpenGL ES 2.0 constant.
static int GL_SAMPLER_2D
          OpenGL ES 2.0 constant.
static int GL_SAMPLER_CUBE
          OpenGL ES 2.0 constant.
static int GL_SAMPLES
          OpenGL ES 2.0 constant.
static int GL_SAMPLE_ALPHA_TO_COVERAGE
          OpenGL ES 2.0 constant.
static int GL_SAMPLE_BUFFERS
          OpenGL ES 2.0 constant.
static int GL_SAMPLE_COVERAGE
          OpenGL ES 2.0 constant.
static int GL_SAMPLE_COVERAGE_INVERT
          OpenGL ES 2.0 constant.
static int GL_SAMPLE_COVERAGE_VALUE
          OpenGL ES 2.0 constant.
static int GL_SCISSOR_BOX
          OpenGL ES 2.0 constant.
static int GL_SCISSOR_TEST
          OpenGL ES 2.0 constant.
static int GL_SHADER_BINARY_FORMATS
          OpenGL ES 2.0 constant.
static int GL_SHADER_COMPILER
          OpenGL ES 2.0 constant.
static int GL_SHADER_SOURCE_LENGTH
          OpenGL ES 2.0 constant.
static int GL_SHADER_TYPE
          OpenGL ES 2.0 constant.
static int GL_SHADING_LANGUAGE_VERSION
          OpenGL ES 2.0 constant.
static int GL_SHORT
          OpenGL ES 2.0 constant.
static int GL_SRC_ALPHA
          OpenGL ES 2.0 constant.
static int GL_SRC_ALPHA_SATURATE
          OpenGL ES 2.0 constant.
static int GL_SRC_COLOR
          OpenGL ES 2.0 constant.
static int GL_STATIC_DRAW
          OpenGL ES 2.0 constant.
static int GL_STENCIL_ATTACHMENT
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BACK_FAIL
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BACK_FUNC
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BACK_PASS_DEPTH_FAIL
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BACK_PASS_DEPTH_PASS
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BACK_REF
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BACK_VALUE_MASK
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BACK_WRITEMASK
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BITS
          OpenGL ES 2.0 constant.
static int GL_STENCIL_BUFFER_BIT
          OpenGL ES 2.0 constant.
static int GL_STENCIL_CLEAR_VALUE
          OpenGL ES 2.0 constant.
static int GL_STENCIL_FAIL
          OpenGL ES 2.0 constant.
static int GL_STENCIL_FUNC
          OpenGL ES 2.0 constant.
static int GL_STENCIL_INDEX
          OpenGL ES 2.0 constant.
static int GL_STENCIL_INDEX8
          OpenGL ES 2.0 constant.
static int GL_STENCIL_PASS_DEPTH_FAIL
          OpenGL ES 2.0 constant.
static int GL_STENCIL_PASS_DEPTH_PASS
          OpenGL ES 2.0 constant.
static int GL_STENCIL_REF
          OpenGL ES 2.0 constant.
static int GL_STENCIL_TEST
          OpenGL ES 2.0 constant.
static int GL_STENCIL_VALUE_MASK
          OpenGL ES 2.0 constant.
static int GL_STENCIL_WRITEMASK
          OpenGL ES 2.0 constant.
static int GL_STREAM_DRAW
          OpenGL ES 2.0 constant.
static int GL_SUBPIXEL_BITS
          OpenGL ES 2.0 constant.
static int GL_TEXTURE
          OpenGL ES 2.0 constant.
static int GL_TEXTURE0
          OpenGL ES 2.0 constant.
static int GL_TEXTURE1
          OpenGL ES 2.0 constant.
static int GL_TEXTURE10
          OpenGL ES 2.0 constant.
static int GL_TEXTURE11
          OpenGL ES 2.0 constant.
static int GL_TEXTURE12
          OpenGL ES 2.0 constant.
static int GL_TEXTURE13
          OpenGL ES 2.0 constant.
static int GL_TEXTURE14
          OpenGL ES 2.0 constant.
static int GL_TEXTURE15
          OpenGL ES 2.0 constant.
static int GL_TEXTURE16
          OpenGL ES 2.0 constant.
static int GL_TEXTURE17
          OpenGL ES 2.0 constant.
static int GL_TEXTURE18
          OpenGL ES 2.0 constant.
static int GL_TEXTURE19
          OpenGL ES 2.0 constant.
static int GL_TEXTURE2
          OpenGL ES 2.0 constant.
static int GL_TEXTURE20
          OpenGL ES 2.0 constant.
static int GL_TEXTURE21
          OpenGL ES 2.0 constant.
static int GL_TEXTURE22
          OpenGL ES 2.0 constant.
static int GL_TEXTURE23
          OpenGL ES 2.0 constant.
static int GL_TEXTURE24
          OpenGL ES 2.0 constant.
static int GL_TEXTURE25
          OpenGL ES 2.0 constant.
static int GL_TEXTURE26
          OpenGL ES 2.0 constant.
static int GL_TEXTURE27
          OpenGL ES 2.0 constant.
static int GL_TEXTURE28
          OpenGL ES 2.0 constant.
static int GL_TEXTURE29
          OpenGL ES 2.0 constant.
static int GL_TEXTURE3
          OpenGL ES 2.0 constant.
static int GL_TEXTURE30
          OpenGL ES 2.0 constant.
static int GL_TEXTURE31
          OpenGL ES 2.0 constant.
static int GL_TEXTURE4
          OpenGL ES 2.0 constant.
static int GL_TEXTURE5
          OpenGL ES 2.0 constant.
static int GL_TEXTURE6
          OpenGL ES 2.0 constant.
static int GL_TEXTURE7
          OpenGL ES 2.0 constant.
static int GL_TEXTURE8
          OpenGL ES 2.0 constant.
static int GL_TEXTURE9
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_2D
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_BINDING_2D
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_BINDING_CUBE_MAP
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_CUBE_MAP
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_CUBE_MAP_NEGATIVE_X
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_CUBE_MAP_NEGATIVE_Y
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_CUBE_MAP_NEGATIVE_Z
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_CUBE_MAP_POSITIVE_X
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_CUBE_MAP_POSITIVE_Y
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_CUBE_MAP_POSITIVE_Z
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_MAG_FILTER
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_MIN_FILTER
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_WRAP_S
          OpenGL ES 2.0 constant.
static int GL_TEXTURE_WRAP_T
          OpenGL ES 2.0 constant.
static int GL_TRIANGLES
          OpenGL ES 2.0 constant.
static int GL_TRIANGLE_FAN
          OpenGL ES 2.0 constant.
static int GL_TRIANGLE_STRIP
          OpenGL ES 2.0 constant.
static int GL_TRUE
          OpenGL ES 2.0 constant.
static int GL_UNPACK_ALIGNMENT
          OpenGL ES 2.0 constant.
static int GL_UNSIGNED_BYTE
          OpenGL ES 2.0 constant.
static int GL_UNSIGNED_INT
          OpenGL ES 2.0 constant.
static int GL_UNSIGNED_SHORT
          OpenGL ES 2.0 constant.
static int GL_UNSIGNED_SHORT_4_4_4_4
          OpenGL ES 2.0 constant.
static int GL_UNSIGNED_SHORT_5_5_5_1
          OpenGL ES 2.0 constant.
static int GL_UNSIGNED_SHORT_5_6_5
          OpenGL ES 2.0 constant.
static int GL_VALIDATE_STATUS
          OpenGL ES 2.0 constant.
static int GL_VENDOR
          OpenGL ES 2.0 constant.
static int GL_VERSION
          OpenGL ES 2.0 constant.
static int GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING
          OpenGL ES 2.0 constant.
static int GL_VERTEX_ATTRIB_ARRAY_ENABLED
          OpenGL ES 2.0 constant.
static int GL_VERTEX_ATTRIB_ARRAY_NORMALIZED
          OpenGL ES 2.0 constant.
static int GL_VERTEX_ATTRIB_ARRAY_POINTER
          OpenGL ES 2.0 constant.
static int GL_VERTEX_ATTRIB_ARRAY_SIZE
          OpenGL ES 2.0 constant.
static int GL_VERTEX_ATTRIB_ARRAY_STRIDE
          OpenGL ES 2.0 constant.
static int GL_VERTEX_ATTRIB_ARRAY_TYPE
          OpenGL ES 2.0 constant.
static int GL_VERTEX_SHADER
          OpenGL ES 2.0 constant.
static int GL_VIEWPORT
          OpenGL ES 2.0 constant.
static int GL_ZERO
          OpenGL ES 2.0 constant.
 
Method Summary
 void glActiveTexture(int texture)
          Select active texture unit.
 void glAttachShader(int program, int shader)
          Attach a shader object to a program object.
 void glBindAttribLocation(int program, int index, String name)
          Associate a generic vertex attribute index with a named attribute variable.
 void glBindBuffer(int target, int buffer)
          Bind a named buffer object.
 void glBindFramebuffer(int target, int framebuffer)
          Bind a named framebuffer object.
 void glBindRenderbuffer(int target, int renderbuffer)
          Bind a named renderbuffer object.
 void glBindTexture(int target, int texture)
          Bind a named texture to a texturing target.
 void glBlendColor(float red, float green, float blue, float alpha)
          Set the blend color.
 void glBlendEquation(int mode)
          Specify the equation used for both the RGB blend equation and the Alpha blend equation.
 void glBlendEquationSeparate(int modeRGB, int modeAlpha)
          Set the RGB blend equation and the alpha blend equation separately.
 void glBlendFunc(int sfactor, int dfactor)
          Specify pixel arithmetic.
 void glBlendFuncSeparate(int srcRGB, int dstRGB, int srcAlpha, int dstAlpha)
          Specify pixel arithmetic for RGB and alpha components separately.
 void glBufferData(int target, int size, Buffer data, int usage)
          Create and initialize a buffer object's data store.
 void glBufferSubData(int target, int offset, int size, Buffer data)
          Update a subset of a buffer object's data store.
 int glCheckFramebufferStatus(int target)
          Return the framebuffer completeness status of a framebuffer object.
 void glClear(int mask)
          Clear buffers to preset values.
 void glClearColor(float red, float green, float blue, float alpha)
          Specify clear values for the color buffers.
 void glClearDepthf(float depth)
          Specify the clear value for the depth buffer.
 void glClearStencil(int s)
          Specify the clear value for the stencil buffer.
 void glColorMask(boolean red, boolean green, boolean blue, boolean alpha)
          Enable and disable writing of frame buffer color components.
 void glCompileShader(int shader)
          Compile a shader object.
 void glCompressedTexImage2D(int target, int level, int internalformat, int width, int height, int border, int imageSize, Buffer data)
          Specify a two-dimensional texture image in a compressed format.
 void glCompressedTexSubImage2D(int target, int level, int xoffset, int yoffset, int width, int height, int format, int imageSize, Buffer data)
          Specify a two-dimensional texture subimage in a compressed format.
 void glCopyTexImage2D(int target, int level, int internalformat, int x, int y, int width, int height, int border)
          Copy pixels into a 2D texture image.
 void glCopyTexSubImage2D(int target, int level, int xoffset, int yoffset, int x, int y, int width, int height)
          Copy a two-dimensional texture subimage.
 int glCreateProgram()
          Create a program object.
 int glCreateShader(int type)
          Create a shader object.
 void glCullFace(int mode)
          Specify whether front- or back-facing facets can be culled.
 void glDeleteBuffers(int n, int[] buffers, int offset)
          Delete named buffer objects.
 void glDeleteBuffers(int n, IntBuffer buffers)
          Integer Buffer version of glDeleteBuffers.
 void glDeleteFramebuffers(int n, int[] framebuffers, int offset)
          Delete named framebuffer objects.
 void glDeleteFramebuffers(int n, IntBuffer framebuffers)
          Integer Buffer version of glDeleteFramebuffers.
 void glDeleteProgram(int program)
          Delete a program object.
 void glDeleteRenderbuffers(int n, int[] renderbuffers, int offset)
          Delete named renderbuffer objects Description glDeleteRenderbuffers deletes n renderbuffer objects named by the elements of the array renderbuffers.
 void glDeleteRenderbuffers(int n, IntBuffer renderbuffers)
          Integer Buffer version of glDeleteRenderbuffers.
 void glDeleteShader(int shader)
          Delete a shader object.
 void glDeleteTextures(int n, int[] textures, int offset)
          Delete named textures.
 void glDeleteTextures(int n, IntBuffer textures)
          Integer Buffer version of glDeleteTextures.
 void glDepthFunc(int func)
          Specify the value used for depth buffer comparisons.
 void glDepthMask(boolean flag)
          Enable or disable writing into the depth buffer.
 void glDepthRangef(float zNear, float zFar)
          Specify mapping of depth values from normalized device coordinates to window coordinates.
 void glDetachShader(int program, int shader)
          Detach a shader object from a program object.
 void glDisable(int cap)
          Disable server-side GL capabilities.
 void glDisableVertexAttribArray(int index)
          Disable a generic vertex attribute array.
 void glDrawArrays(int mode, int first, int count)
          Render primitives from array data.
 void glDrawElements(int mode, int count, int type, int offset)
          VBO version of glDrawElements.
 void glDrawElements(int mode, int count, int type, Buffer indices)
          Render primitives from array data.
 void glEnable(int cap)
          Enable server-side GL capabilities.
 void glEnableVertexAttribArray(int index)
          Enables a generic vertex attribute array.
 void glFinish()
          Block until all GL execution is complete.
 void glFlush()
          Force execution of GL commands in finite time.
 void glFramebufferRenderbuffer(int target, int attachment, int renderbuffertarget, int renderbuffer)
          Attach a renderbuffer object to a framebuffer object.
 void glFramebufferTexture2D(int target, int attachment, int textarget, int texture, int level)
          Attach a texture image to a framebuffer object.
 void glFrontFace(int mode)
          Define front- and back-facing polygons.
 void glGenBuffers(int n, int[] buffers, int offset)
          Generate buffer object names.
 void glGenBuffers(int n, IntBuffer buffers)
          Integer Buffer version of glGenBuffers.
 void glGenFramebuffers(int n, int[] framebuffers, int offset)
          Generate framebuffer object names Description glGenFramebuffers returns n framebuffer object names in framebuffers.
 void glGenFramebuffers(int n, IntBuffer framebuffers)
          Integer Buffer version of glGenBuffers.
 void glGenRenderbuffers(int n, int[] renderbuffers, int offset)
          Generate renderbuffer object names.
 void glGenRenderbuffers(int n, IntBuffer renderbuffers)
          Integer Buffer version of glGenRenderbuffers.
 void glGenTextures(int n, int[] textures, int offset)
          Generate texture names.
 void glGenTextures(int n, IntBuffer textures)
          Integer Buffer version of glGenTextures.
 void glGenerateMipmap(int target)
          Generate a complete set of mipmaps for a texture object.
 void glGetActiveAttrib(int program, int index, int bufSize, int[] length, int lengthOffset, int[] size, int sizeOffset, int[] type, int typeOffset, byte[] name, int nameOffset)
          Return information about an active attribute variable.
 String glGetActiveAttrib(int program, int index, int[] size, int sizeOffset, int[] type, int typeOffset)
          Return information about an active attribute variable.
 void glGetActiveUniform(int program, int index, int bufSize, int[] length, int lengthOffset, int[] size, int sizeOffset, int[] type, int typeOffset, byte[] name, int nameOffset)
          Return information about an active uniform variable.
 String glGetActiveUniform(int program, int index, int[] size, int sizeOffset, int[] type, int typeOffset)
          Return information about an active uniform variable.
 void glGetAttachedShaders(int program, int maxcount, int[] count, int countOffset, int[] shaders, int shadersOffset)
          Return the handles of the shader objects attached to a program object Description glGetAttachedShaders returns the names of the shader objects attached to program.
 void glGetAttachedShaders(int program, int maxcount, IntBuffer count, IntBuffer shaders)
          Integer Buffer version of glGetAttachedShaders.
 int glGetAttribLocation(int program, String name)
          Return the location of an attribute variable.
 void glGetBooleanv(int pname, boolean[] params, int offset)
          Boolean version of glGetIntegerv.
 void glGetBooleanv(int pname, IntBuffer params)
          Boolean version of glGetIntegerv.
 void glGetBufferParameteriv(int target, int pname, int[] params, int offset)
          Return parameters of a buffer object.
 void glGetBufferParameteriv(int target, int pname, IntBuffer params)
          Integer Buffer version of glGetBufferParameteriv.
 int glGetError()
          Return error information.
 void glGetFloatv(int pname, float[] params, int offset)
          Floating-point version of glGetIntegerv.
 void glGetFloatv(int pname, FloatBuffer params)
          Floating-point version of glGetIntegerv.
 void glGetFramebufferAttachmentParameteriv(int target, int attachment, int pname, int[] params, int offset)
          Return attachment parameters of a framebuffer object.
 void glGetFramebufferAttachmentParameteriv(int target, int attachment, int pname, IntBuffer params)
          Integer Buffer version of glGetFramebufferAttachmentParameteriv.
 void glGetIntegerv(int pname, int[] params, int offset)
          Return the value or values of a selected parameter.
 void glGetIntegerv(int pname, IntBuffer params)
          Integer Buffer version of glGetIntegerv.
 String glGetProgramInfoLog(int program)
          Return the information log for a program object.
 void glGetProgramInfoLog(int program, int maxsize, int[] length, byte[] infolog)
          Return the information log for a program object.
 void glGetProgramiv(int program, int pname, int[] params, int offset)
          Return a parameter from a program object.
 void glGetProgramiv(int program, int pname, IntBuffer params)
          Integer Buffer version of glGetProgramiv.
 void glGetRenderbufferParameteriv(int target, int pname, int[] params, int offset)
          Return parameters of a renderbuffer object.
 void glGetRenderbufferParameteriv(int target, int pname, IntBuffer params)
          Integer Buffer version of glGetRenderbufferParameteriv.
 String glGetShaderInfoLog(int shader)
          Return the information log for a shader object.
 void glGetShaderInfoLog(int shader, int maxsize, int[] length, byte[] infolog)
          Return the information log for a shader object.
 void glGetShaderPrecisionFormat(int shadertype, int precisiontype, int[] range, int rangeOffset, int[] precision, int precisionOffset)
          Return the range and precision for different shader numeric formats.
 String glGetShaderSource(int shader)
          Return the source code string from a shader object.
 void glGetShaderSource(int shader, int bufSize, int[] length, byte[] source)
          Return the source code string from a shader object.
 void glGetShaderiv(int shader, int pname, int[] params, int offset)
          Return a parameter from a shader object Description glGetShaderiv returns in params the value of a parameter for a specific shader object.
 void glGetShaderiv(int shader, int pname, IntBuffer params)
          Integer Buffer version of glGetShaderiv.
 String glGetString(int name)
          Return a string describing the current GL connection.
 void glGetTexParameterfv(int target, int pname, float[] params, int offset)
          Floating-point version of glGetTexParameteriv.
 void glGetTexParameterfv(int target, int pname, FloatBuffer params)
          Floating-point version of glGetTexParameteriv.
 void glGetTexParameteriv(int target, int pname, int[] params, int offset)
          Return texture parameter values.
 void glGetTexParameteriv(int target, int pname, IntBuffer params)
          Integer Buffer version of glGetTexParameteriv.
 int glGetUniformLocation(int program, String name)
          Return the location of a uniform variable.
 void glGetUniformfv(int program, int location, int count, float[] params, int offset)
          Floating-point version of glGetUniformiv.
 void glGetUniformfv(int program, int location, int count, FloatBuffer params)
          Floating-point version of glGetUniformiv.
 void glGetUniformiv(int program, int location, int count, int[] params, int offset)
          Return the value of a uniform variable.
 void glGetUniformiv(int program, int location, int count, IntBuffer params)
          Int Buffer version of glGetUniformiv.
 void glGetVertexAttribfv(int index, int pname, float[] params, int offset)
          Floating-point version of glGetVertexAttribiv.
 void glGetVertexAttribfv(int index, int pname, FloatBuffer params)
          Floating-point version of glGetVertexAttribiv.
 void glGetVertexAttribiv(int index, int pname, int[] params, int offset)
          Return a generic vertex attribute parameter.
 void glGetVertexAttribiv(int index, int pname, IntBuffer params)
          Integer Buffer version of glGetVertexAttribiv.
 void glHint(int target, int mode)
          Specify implementation-specific hints.
 boolean glIsBuffer(int buffer)
          Determine if a name corresponds to a buffer object.
 boolean glIsEnabled(int cap)
          Test whether a capability is enabled glIsEnabled returns true if cap is an enabled capability and returns false otherwise.
 boolean glIsFramebuffer(int framebuffer)
          Determine if a name corresponds to a framebuffer object.
 boolean glIsProgram(int program)
          Determine if a name corresponds to a program object.
 boolean glIsRenderbuffer(int renderbuffer)
          Determine if a name corresponds to a renderbuffer object.
 boolean glIsShader(int shader)
          Determine if a name corresponds to a shader object.
 boolean glIsTexture(int texture)
          Determine if a name corresponds to a texture.
 void glLineWidth(float width)
          Specify the width of rasterized lines Description glLineWidth specifies the rasterized width of lines.
 void glLinkProgram(int program)
          Link a program object.
 void glPixelStorei(int pname, int param)
          Set pixel storage modes.
 void glPolygonOffset(float factor, float units)
          Set the scale and units used to calculate depth values.
 void glReadPixels(int x, int y, int width, int height, int format, int type, Buffer pixels)
          Read a block of pixels from the frame buffer.
 void glReleaseShaderCompiler()
          Release resources allocated by the shader compiler.
 void glRenderbufferStorage(int target, int internalformat, int width, int height)
          Create and initialize a renderbuffer object's data store.
 void glSampleCoverage(float value, boolean invert)
          Specify multisample coverage parameters Description Multisampling samples a pixel multiple times at various implementation-dependent subpixel locations to generate antialiasing effects.
 void glScissor(int x, int y, int width, int height)
          Define the scissor box.
 void glShaderBinary(int n, int[] shaders, int shadersOffset, int binaryformat, Buffer binary, int length)
          Load a precompiled shader binary.
 void glShaderBinary(int n, IntBuffer shaders, int binaryformat, Buffer binary, int length)
          Integer Buffer version of glShaderBinary.
 void glShaderSource(int shader, int count, String[] strings, int[] lengths)
          Replace the source code in a shader object.
 void glShaderSource(int shader, String source)
          Replace the source code in a shader object.
 void glStencilFunc(int func, int ref, int mask)
          Set front and back function and reference value for stencil testing.
 void glStencilFuncSeparate(int face, int func, int ref, int mask)
          Set front and/or back function and reference value for stencil testing.
 void glStencilMask(int mask)
          Control the front and back writing of individual bits in the stencil planes.
 void glStencilMaskSeparate(int face, int mask)
          Control the front and/or back writing of individual bits in the stencil planes.
 void glStencilOp(int fail, int zfail, int zpass)
          Set front and back stencil test actions.
 void glStencilOpSeparate(int face, int fail, int zfail, int zpass)
          Set front and/or back stencil test actions.
 void glTexImage2D(int target, int level, int internalformat, int width, int height, int border, int format, int type, Buffer data)
          Specify a two-dimensional texture image.
 void glTexParameterf(int target, int pname, float param)
          Set texture parameters.
 void glTexParameterfv(int target, int pname, float[] params, int offset)
          Floating-point array version of glTexParameterf.
 void glTexParameterfv(int target, int pname, FloatBuffer params)
          Floating-point Buffer version of glTexParameterfv.
 void glTexParameteri(int target, int pname, int param)
          Integer version of glTexParameterf.
 void glTexParameteriv(int target, int pname, int[] params, int offset)
          Integer array version of glTexParameteri.
 void glTexParameteriv(int target, int pname, IntBuffer params)
          Integer Buffer version of glTexParameteriv.
 void glTexSubImage2D(int target, int level, int xoffset, int yoffset, int width, int height, int format, int type, Buffer data)
          Specify a two-dimensional texture subimage.
 void glUniform1f(int location, float x)
          Specify the value of a uniform variable for the current program object.
 void glUniform1fv(int location, int count, float[] v, int offset)
          Floating-point 1 value array version of glUniform1f.
 void glUniform1fv(int location, int count, FloatBuffer v)
          Floating-point 1 value Buffer version of glUniform1f.
 void glUniform1i(int location, int x)
          Integer 1 value version of glUniform1f.
 void glUniform1iv(int location, int count, int[] v, int offset)
          Ingteger 1 value array version of glUniform1f.
 void glUniform1iv(int location, int count, IntBuffer v)
          Integer 1 value Buffer version of glUniform1f.
 void glUniform2f(int location, float x, float y)
          Floating-point 2 value version of glUniform1f.
 void glUniform2fv(int location, int count, float[] v, int offset)
          Floating-point 2 value array version of glUniform1f.
 void glUniform2fv(int location, int count, FloatBuffer v)
          Floating-point 2 value Buffer version of glUniform1f.
 void glUniform2i(int location, int x, int y)
          Integer 2 value version of glUniform1f.
 void glUniform2iv(int location, int count, int[] v, int offset)
          Ingteger 2 value array version of glUniform1f.
 void glUniform2iv(int location, int count, IntBuffer v)
          Integer 2 value Buffer version of glUniform1f.
 void glUniform3f(int location, float x, float y, float z)
          Floating-point 3 value version of glUniform1f.
 void glUniform3fv(int location, int count, float[] v, int offset)
          Floating-point 3 value array version of glUniform1f.
 void glUniform3fv(int location, int count, FloatBuffer v)
          Floating-point 3 value Buffer version of glUniform1f.
 void glUniform3i(int location, int x, int y, int z)
          Integer 3 value version of glUniform1f.
 void glUniform3iv(int location, int count, int[] v, int offset)
          Ingteger 3 value array version of glUniform1f.
 void glUniform3iv(int location, int count, IntBuffer v)
          Integer 3 value Buffer version of glUniform1f.
 void glUniform4f(int location, float x, float y, float z, float w)
          Floating-point 4 value version of glUniform1f.
 void glUniform4fv(int location, int count, float[] v, int offset)
          Floating-point 4 value array version of glUniform1f.
 void glUniform4fv(int location, int count, FloatBuffer v)
          Floating-point 4 value Buffer version of glUniform1f.
 void glUniform4i(int location, int x, int y, int z, int w)
          Integer 4 value version of glUniform1f.
 void glUniform4iv(int location, int count, int[] v, int offset)
          Integer 4 value array version of glUniform1f.
 void glUniform4iv(int location, int count, IntBuffer v)
          Integer 4 value Buffer version of glUniform1f.
 void glUniformMatrix2fv(int location, int count, boolean transpose, float[] value, int offset)
          Floating-point 2x2 matrix array version of glUniform1f.
 void glUniformMatrix2fv(int location, int count, boolean transpose, FloatBuffer value)
          Floating-point 2x2 matrix Buffer version of glUniform1f.
 void glUniformMatrix3fv(int location, int count, boolean transpose, float[] value, int offset)
          Floating-point 3x3 matrix array version of glUniform1f.
 void glUniformMatrix3fv(int location, int count, boolean transpose, FloatBuffer value)
          Floating-point 3x3 matrix Buffer version of glUniform1f.
 void glUniformMatrix4fv(int location, int count, boolean transpose, float[] value, int offset)
          Floating-point 4x4 matrix array version of glUniform1f.
 void glUniformMatrix4fv(int location, int count, boolean transpose, FloatBuffer value)
          Floating-point 4x4 matrix Buffer version of glUniform1f.
 void glUseProgram(int program)
          Install a program object as part of current rendering state.
 void glValidateProgram(int program)
          Validate a program object.
 void glVertexAttrib1f(int index, float x)
          Specify the value of a generic vertex attribute.
 void glVertexAttrib1fv(int index, float[] values, int offset)
          Floating-point 1 value array version of glVertexAttrib1f.
 void glVertexAttrib1fv(int index, FloatBuffer values)
          Floating-point 1 value Buffer version of glVertexAttrib1f.
 void glVertexAttrib2f(int index, float x, float y)
          Floating-point 2 value version of glVertexAttrib1f.
 void glVertexAttrib2fv(int index, float[] values, int offset)
          Floating-point 2 value array version of glVertexAttrib1f.
 void glVertexAttrib2fv(int index, FloatBuffer values)
          Floating-point 2 value Buffer version of glVertexAttrib1f.
 void glVertexAttrib3f(int index, float x, float y, float z)
          Floating-point 3 value version of glVertexAttrib1f.
 void glVertexAttrib3fv(int index, float[] values, int offset)
          Floating-point 3 value array version of glVertexAttrib1f.
 void glVertexAttrib3fv(int index, FloatBuffer values)
          Floating-point 3 value Buffer version of glVertexAttrib1f.
 void glVertexAttrib4f(int index, float x, float y, float z, float w)
          Floating-point 4 value version of glVertexAttrib1f.
 void glVertexAttrib4fv(int index, float[] values, int offset)
          Floating-point 4 value array version of glVertexAttrib1f.
 void glVertexAttrib4fv(int index, FloatBuffer values)
          Floating-point 4 value Buffer version of glVertexAttrib1f.
 void glVertexAttribPointer(int index, int size, int type, boolean normalized, int stride, int offset)
          VBO version of glVertexAttribPointer.
 void glVertexAttribPointer(int index, int size, int type, boolean normalized, int stride, Buffer data)
          Define an array of generic vertex attribute data.
 void glViewport(int x, int y, int width, int height)
          Set the viewport.
 



Field Detail

GL_ES_VERSION_2_0

static final int GL_ES_VERSION_2_0
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_BUFFER_BIT

static final int GL_DEPTH_BUFFER_BIT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BUFFER_BIT

static final int GL_STENCIL_BUFFER_BIT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_COLOR_BUFFER_BIT

static final int GL_COLOR_BUFFER_BIT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FALSE

static final int GL_FALSE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TRUE

static final int GL_TRUE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_POINTS

static final int GL_POINTS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LINES

static final int GL_LINES
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LINE_LOOP

static final int GL_LINE_LOOP
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LINE_STRIP

static final int GL_LINE_STRIP
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TRIANGLES

static final int GL_TRIANGLES
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TRIANGLE_STRIP

static final int GL_TRIANGLE_STRIP
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TRIANGLE_FAN

static final int GL_TRIANGLE_FAN
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ZERO

static final int GL_ZERO
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ONE

static final int GL_ONE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SRC_COLOR

static final int GL_SRC_COLOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ONE_MINUS_SRC_COLOR

static final int GL_ONE_MINUS_SRC_COLOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SRC_ALPHA

static final int GL_SRC_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ONE_MINUS_SRC_ALPHA

static final int GL_ONE_MINUS_SRC_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DST_ALPHA

static final int GL_DST_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ONE_MINUS_DST_ALPHA

static final int GL_ONE_MINUS_DST_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DST_COLOR

static final int GL_DST_COLOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ONE_MINUS_DST_COLOR

static final int GL_ONE_MINUS_DST_COLOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SRC_ALPHA_SATURATE

static final int GL_SRC_ALPHA_SATURATE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FUNC_ADD

static final int GL_FUNC_ADD
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND_EQUATION

static final int GL_BLEND_EQUATION
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND_EQUATION_RGB

static final int GL_BLEND_EQUATION_RGB
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND_EQUATION_ALPHA

static final int GL_BLEND_EQUATION_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FUNC_SUBTRACT

static final int GL_FUNC_SUBTRACT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FUNC_REVERSE_SUBTRACT

static final int GL_FUNC_REVERSE_SUBTRACT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND_DST_RGB

static final int GL_BLEND_DST_RGB
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND_SRC_RGB

static final int GL_BLEND_SRC_RGB
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND_DST_ALPHA

static final int GL_BLEND_DST_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND_SRC_ALPHA

static final int GL_BLEND_SRC_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CONSTANT_COLOR

static final int GL_CONSTANT_COLOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ONE_MINUS_CONSTANT_COLOR

static final int GL_ONE_MINUS_CONSTANT_COLOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CONSTANT_ALPHA

static final int GL_CONSTANT_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ONE_MINUS_CONSTANT_ALPHA

static final int GL_ONE_MINUS_CONSTANT_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND_COLOR

static final int GL_BLEND_COLOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ARRAY_BUFFER

static final int GL_ARRAY_BUFFER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ELEMENT_ARRAY_BUFFER

static final int GL_ELEMENT_ARRAY_BUFFER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ARRAY_BUFFER_BINDING

static final int GL_ARRAY_BUFFER_BINDING
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ELEMENT_ARRAY_BUFFER_BINDING

static final int GL_ELEMENT_ARRAY_BUFFER_BINDING
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STREAM_DRAW

static final int GL_STREAM_DRAW
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STATIC_DRAW

static final int GL_STATIC_DRAW
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DYNAMIC_DRAW

static final int GL_DYNAMIC_DRAW
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BUFFER_SIZE

static final int GL_BUFFER_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BUFFER_USAGE

static final int GL_BUFFER_USAGE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CURRENT_VERTEX_ATTRIB

static final int GL_CURRENT_VERTEX_ATTRIB
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRONT

static final int GL_FRONT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BACK

static final int GL_BACK
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRONT_AND_BACK

static final int GL_FRONT_AND_BACK
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_2D

static final int GL_TEXTURE_2D
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CULL_FACE

static final int GL_CULL_FACE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLEND

static final int GL_BLEND
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DITHER

static final int GL_DITHER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_TEST

static final int GL_STENCIL_TEST
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_TEST

static final int GL_DEPTH_TEST
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SCISSOR_TEST

static final int GL_SCISSOR_TEST
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_POLYGON_OFFSET_FILL

static final int GL_POLYGON_OFFSET_FILL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SAMPLE_ALPHA_TO_COVERAGE

static final int GL_SAMPLE_ALPHA_TO_COVERAGE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SAMPLE_COVERAGE

static final int GL_SAMPLE_COVERAGE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NO_ERROR

static final int GL_NO_ERROR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INVALID_ENUM

static final int GL_INVALID_ENUM
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INVALID_VALUE

static final int GL_INVALID_VALUE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INVALID_OPERATION

static final int GL_INVALID_OPERATION
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_OUT_OF_MEMORY

static final int GL_OUT_OF_MEMORY
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CW

static final int GL_CW
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CCW

static final int GL_CCW
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LINE_WIDTH

static final int GL_LINE_WIDTH
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ALIASED_POINT_SIZE_RANGE

static final int GL_ALIASED_POINT_SIZE_RANGE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ALIASED_LINE_WIDTH_RANGE

static final int GL_ALIASED_LINE_WIDTH_RANGE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CULL_FACE_MODE

static final int GL_CULL_FACE_MODE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRONT_FACE

static final int GL_FRONT_FACE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_RANGE

static final int GL_DEPTH_RANGE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_WRITEMASK

static final int GL_DEPTH_WRITEMASK
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_CLEAR_VALUE

static final int GL_DEPTH_CLEAR_VALUE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_FUNC

static final int GL_DEPTH_FUNC
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_CLEAR_VALUE

static final int GL_STENCIL_CLEAR_VALUE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_FUNC

static final int GL_STENCIL_FUNC
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_FAIL

static final int GL_STENCIL_FAIL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_PASS_DEPTH_FAIL

static final int GL_STENCIL_PASS_DEPTH_FAIL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_PASS_DEPTH_PASS

static final int GL_STENCIL_PASS_DEPTH_PASS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_REF

static final int GL_STENCIL_REF
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_VALUE_MASK

static final int GL_STENCIL_VALUE_MASK
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_WRITEMASK

static final int GL_STENCIL_WRITEMASK
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BACK_FUNC

static final int GL_STENCIL_BACK_FUNC
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BACK_FAIL

static final int GL_STENCIL_BACK_FAIL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BACK_PASS_DEPTH_FAIL

static final int GL_STENCIL_BACK_PASS_DEPTH_FAIL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BACK_PASS_DEPTH_PASS

static final int GL_STENCIL_BACK_PASS_DEPTH_PASS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BACK_REF

static final int GL_STENCIL_BACK_REF
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BACK_VALUE_MASK

static final int GL_STENCIL_BACK_VALUE_MASK
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BACK_WRITEMASK

static final int GL_STENCIL_BACK_WRITEMASK
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VIEWPORT

static final int GL_VIEWPORT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SCISSOR_BOX

static final int GL_SCISSOR_BOX
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_COLOR_CLEAR_VALUE

static final int GL_COLOR_CLEAR_VALUE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_COLOR_WRITEMASK

static final int GL_COLOR_WRITEMASK
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_UNPACK_ALIGNMENT

static final int GL_UNPACK_ALIGNMENT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_PACK_ALIGNMENT

static final int GL_PACK_ALIGNMENT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_TEXTURE_SIZE

static final int GL_MAX_TEXTURE_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_VIEWPORT_DIMS

static final int GL_MAX_VIEWPORT_DIMS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SUBPIXEL_BITS

static final int GL_SUBPIXEL_BITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RED_BITS

static final int GL_RED_BITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_GREEN_BITS

static final int GL_GREEN_BITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BLUE_BITS

static final int GL_BLUE_BITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ALPHA_BITS

static final int GL_ALPHA_BITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_BITS

static final int GL_DEPTH_BITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_BITS

static final int GL_STENCIL_BITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_POLYGON_OFFSET_UNITS

static final int GL_POLYGON_OFFSET_UNITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_POLYGON_OFFSET_FACTOR

static final int GL_POLYGON_OFFSET_FACTOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_BINDING_2D

static final int GL_TEXTURE_BINDING_2D
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SAMPLE_BUFFERS

static final int GL_SAMPLE_BUFFERS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SAMPLES

static final int GL_SAMPLES
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SAMPLE_COVERAGE_VALUE

static final int GL_SAMPLE_COVERAGE_VALUE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SAMPLE_COVERAGE_INVERT

static final int GL_SAMPLE_COVERAGE_INVERT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NUM_COMPRESSED_TEXTURE_FORMATS

static final int GL_NUM_COMPRESSED_TEXTURE_FORMATS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_COMPRESSED_TEXTURE_FORMATS

static final int GL_COMPRESSED_TEXTURE_FORMATS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DONT_CARE

static final int GL_DONT_CARE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FASTEST

static final int GL_FASTEST
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NICEST

static final int GL_NICEST
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_GENERATE_MIPMAP_HINT

static final int GL_GENERATE_MIPMAP_HINT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BYTE

static final int GL_BYTE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_UNSIGNED_BYTE

static final int GL_UNSIGNED_BYTE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SHORT

static final int GL_SHORT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_UNSIGNED_SHORT

static final int GL_UNSIGNED_SHORT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INT

static final int GL_INT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_UNSIGNED_INT

static final int GL_UNSIGNED_INT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FLOAT

static final int GL_FLOAT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FIXED

static final int GL_FIXED
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_COMPONENT

static final int GL_DEPTH_COMPONENT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ALPHA

static final int GL_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RGB

static final int GL_RGB
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RGBA

static final int GL_RGBA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LUMINANCE

static final int GL_LUMINANCE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LUMINANCE_ALPHA

static final int GL_LUMINANCE_ALPHA
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_UNSIGNED_SHORT_4_4_4_4

static final int GL_UNSIGNED_SHORT_4_4_4_4
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_UNSIGNED_SHORT_5_5_5_1

static final int GL_UNSIGNED_SHORT_5_5_5_1
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_UNSIGNED_SHORT_5_6_5

static final int GL_UNSIGNED_SHORT_5_6_5
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAGMENT_SHADER

static final int GL_FRAGMENT_SHADER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERTEX_SHADER

static final int GL_VERTEX_SHADER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_VERTEX_ATTRIBS

static final int GL_MAX_VERTEX_ATTRIBS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_VERTEX_UNIFORM_VECTORS

static final int GL_MAX_VERTEX_UNIFORM_VECTORS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_VARYING_VECTORS

static final int GL_MAX_VARYING_VECTORS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS

static final int GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS

static final int GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_TEXTURE_IMAGE_UNITS

static final int GL_MAX_TEXTURE_IMAGE_UNITS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_FRAGMENT_UNIFORM_VECTORS

static final int GL_MAX_FRAGMENT_UNIFORM_VECTORS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SHADER_TYPE

static final int GL_SHADER_TYPE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DELETE_STATUS

static final int GL_DELETE_STATUS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LINK_STATUS

static final int GL_LINK_STATUS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VALIDATE_STATUS

static final int GL_VALIDATE_STATUS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ATTACHED_SHADERS

static final int GL_ATTACHED_SHADERS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ACTIVE_UNIFORMS

static final int GL_ACTIVE_UNIFORMS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ACTIVE_UNIFORM_MAX_LENGTH

static final int GL_ACTIVE_UNIFORM_MAX_LENGTH
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ACTIVE_ATTRIBUTES

static final int GL_ACTIVE_ATTRIBUTES
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ACTIVE_ATTRIBUTE_MAX_LENGTH

static final int GL_ACTIVE_ATTRIBUTE_MAX_LENGTH
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SHADING_LANGUAGE_VERSION

static final int GL_SHADING_LANGUAGE_VERSION
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CURRENT_PROGRAM

static final int GL_CURRENT_PROGRAM
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NEVER

static final int GL_NEVER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LESS

static final int GL_LESS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_EQUAL

static final int GL_EQUAL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LEQUAL

static final int GL_LEQUAL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_GREATER

static final int GL_GREATER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NOTEQUAL

static final int GL_NOTEQUAL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_GEQUAL

static final int GL_GEQUAL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ALWAYS

static final int GL_ALWAYS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_KEEP

static final int GL_KEEP
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_REPLACE

static final int GL_REPLACE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INCR

static final int GL_INCR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DECR

static final int GL_DECR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INVERT

static final int GL_INVERT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INCR_WRAP

static final int GL_INCR_WRAP
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DECR_WRAP

static final int GL_DECR_WRAP
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VENDOR

static final int GL_VENDOR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERER

static final int GL_RENDERER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERSION

static final int GL_VERSION
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_EXTENSIONS

static final int GL_EXTENSIONS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NEAREST

static final int GL_NEAREST
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LINEAR

static final int GL_LINEAR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NEAREST_MIPMAP_NEAREST

static final int GL_NEAREST_MIPMAP_NEAREST
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LINEAR_MIPMAP_NEAREST

static final int GL_LINEAR_MIPMAP_NEAREST
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NEAREST_MIPMAP_LINEAR

static final int GL_NEAREST_MIPMAP_LINEAR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LINEAR_MIPMAP_LINEAR

static final int GL_LINEAR_MIPMAP_LINEAR
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_MAG_FILTER

static final int GL_TEXTURE_MAG_FILTER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_MIN_FILTER

static final int GL_TEXTURE_MIN_FILTER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_WRAP_S

static final int GL_TEXTURE_WRAP_S
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_WRAP_T

static final int GL_TEXTURE_WRAP_T
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE

static final int GL_TEXTURE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_CUBE_MAP

static final int GL_TEXTURE_CUBE_MAP
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_BINDING_CUBE_MAP

static final int GL_TEXTURE_BINDING_CUBE_MAP
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_CUBE_MAP_POSITIVE_X

static final int GL_TEXTURE_CUBE_MAP_POSITIVE_X
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_CUBE_MAP_NEGATIVE_X

static final int GL_TEXTURE_CUBE_MAP_NEGATIVE_X
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_CUBE_MAP_POSITIVE_Y

static final int GL_TEXTURE_CUBE_MAP_POSITIVE_Y
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_CUBE_MAP_NEGATIVE_Y

static final int GL_TEXTURE_CUBE_MAP_NEGATIVE_Y
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_CUBE_MAP_POSITIVE_Z

static final int GL_TEXTURE_CUBE_MAP_POSITIVE_Z
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE_CUBE_MAP_NEGATIVE_Z

static final int GL_TEXTURE_CUBE_MAP_NEGATIVE_Z
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_CUBE_MAP_TEXTURE_SIZE

static final int GL_MAX_CUBE_MAP_TEXTURE_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE0

static final int GL_TEXTURE0
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE1

static final int GL_TEXTURE1
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE2

static final int GL_TEXTURE2
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE3

static final int GL_TEXTURE3
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE4

static final int GL_TEXTURE4
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE5

static final int GL_TEXTURE5
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE6

static final int GL_TEXTURE6
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE7

static final int GL_TEXTURE7
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE8

static final int GL_TEXTURE8
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE9

static final int GL_TEXTURE9
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE10

static final int GL_TEXTURE10
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE11

static final int GL_TEXTURE11
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE12

static final int GL_TEXTURE12
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE13

static final int GL_TEXTURE13
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE14

static final int GL_TEXTURE14
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE15

static final int GL_TEXTURE15
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE16

static final int GL_TEXTURE16
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE17

static final int GL_TEXTURE17
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE18

static final int GL_TEXTURE18
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE19

static final int GL_TEXTURE19
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE20

static final int GL_TEXTURE20
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE21

static final int GL_TEXTURE21
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE22

static final int GL_TEXTURE22
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE23

static final int GL_TEXTURE23
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE24

static final int GL_TEXTURE24
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE25

static final int GL_TEXTURE25
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE26

static final int GL_TEXTURE26
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE27

static final int GL_TEXTURE27
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE28

static final int GL_TEXTURE28
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE29

static final int GL_TEXTURE29
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE30

static final int GL_TEXTURE30
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_TEXTURE31

static final int GL_TEXTURE31
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_ACTIVE_TEXTURE

static final int GL_ACTIVE_TEXTURE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_REPEAT

static final int GL_REPEAT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_CLAMP_TO_EDGE

static final int GL_CLAMP_TO_EDGE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MIRRORED_REPEAT

static final int GL_MIRRORED_REPEAT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FLOAT_VEC2

static final int GL_FLOAT_VEC2
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FLOAT_VEC3

static final int GL_FLOAT_VEC3
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FLOAT_VEC4

static final int GL_FLOAT_VEC4
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INT_VEC2

static final int GL_INT_VEC2
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INT_VEC3

static final int GL_INT_VEC3
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INT_VEC4

static final int GL_INT_VEC4
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BOOL

static final int GL_BOOL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BOOL_VEC2

static final int GL_BOOL_VEC2
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BOOL_VEC3

static final int GL_BOOL_VEC3
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_BOOL_VEC4

static final int GL_BOOL_VEC4
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FLOAT_MAT2

static final int GL_FLOAT_MAT2
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FLOAT_MAT3

static final int GL_FLOAT_MAT3
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FLOAT_MAT4

static final int GL_FLOAT_MAT4
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SAMPLER_2D

static final int GL_SAMPLER_2D
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SAMPLER_CUBE

static final int GL_SAMPLER_CUBE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERTEX_ATTRIB_ARRAY_ENABLED

static final int GL_VERTEX_ATTRIB_ARRAY_ENABLED
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERTEX_ATTRIB_ARRAY_SIZE

static final int GL_VERTEX_ATTRIB_ARRAY_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERTEX_ATTRIB_ARRAY_STRIDE

static final int GL_VERTEX_ATTRIB_ARRAY_STRIDE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERTEX_ATTRIB_ARRAY_TYPE

static final int GL_VERTEX_ATTRIB_ARRAY_TYPE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERTEX_ATTRIB_ARRAY_NORMALIZED

static final int GL_VERTEX_ATTRIB_ARRAY_NORMALIZED
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERTEX_ATTRIB_ARRAY_POINTER

static final int GL_VERTEX_ATTRIB_ARRAY_POINTER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING

static final int GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_IMPLEMENTATION_COLOR_READ_TYPE

static final int GL_IMPLEMENTATION_COLOR_READ_TYPE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_IMPLEMENTATION_COLOR_READ_FORMAT

static final int GL_IMPLEMENTATION_COLOR_READ_FORMAT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_COMPILE_STATUS

static final int GL_COMPILE_STATUS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INFO_LOG_LENGTH

static final int GL_INFO_LOG_LENGTH
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SHADER_SOURCE_LENGTH

static final int GL_SHADER_SOURCE_LENGTH
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SHADER_COMPILER

static final int GL_SHADER_COMPILER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_SHADER_BINARY_FORMATS

static final int GL_SHADER_BINARY_FORMATS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NUM_SHADER_BINARY_FORMATS

static final int GL_NUM_SHADER_BINARY_FORMATS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LOW_FLOAT

static final int GL_LOW_FLOAT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MEDIUM_FLOAT

static final int GL_MEDIUM_FLOAT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_HIGH_FLOAT

static final int GL_HIGH_FLOAT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_LOW_INT

static final int GL_LOW_INT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MEDIUM_INT

static final int GL_MEDIUM_INT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_HIGH_INT

static final int GL_HIGH_INT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER

static final int GL_FRAMEBUFFER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER

static final int GL_RENDERBUFFER
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RGBA4

static final int GL_RGBA4
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RGB5_A1

static final int GL_RGB5_A1
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RGB565

static final int GL_RGB565
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_COMPONENT16

static final int GL_DEPTH_COMPONENT16
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_INDEX

static final int GL_STENCIL_INDEX
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_INDEX8

static final int GL_STENCIL_INDEX8
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_WIDTH

static final int GL_RENDERBUFFER_WIDTH
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_HEIGHT

static final int GL_RENDERBUFFER_HEIGHT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_INTERNAL_FORMAT

static final int GL_RENDERBUFFER_INTERNAL_FORMAT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_RED_SIZE

static final int GL_RENDERBUFFER_RED_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_GREEN_SIZE

static final int GL_RENDERBUFFER_GREEN_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_BLUE_SIZE

static final int GL_RENDERBUFFER_BLUE_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_ALPHA_SIZE

static final int GL_RENDERBUFFER_ALPHA_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_DEPTH_SIZE

static final int GL_RENDERBUFFER_DEPTH_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_STENCIL_SIZE

static final int GL_RENDERBUFFER_STENCIL_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE

static final int GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME

static final int GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL

static final int GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE

static final int GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_COLOR_ATTACHMENT0

static final int GL_COLOR_ATTACHMENT0
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_DEPTH_ATTACHMENT

static final int GL_DEPTH_ATTACHMENT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_STENCIL_ATTACHMENT

static final int GL_STENCIL_ATTACHMENT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_NONE

static final int GL_NONE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_COMPLETE

static final int GL_FRAMEBUFFER_COMPLETE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT

static final int GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT

static final int GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS

static final int GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_UNSUPPORTED

static final int GL_FRAMEBUFFER_UNSUPPORTED
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_FRAMEBUFFER_BINDING

static final int GL_FRAMEBUFFER_BINDING
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_RENDERBUFFER_BINDING

static final int GL_RENDERBUFFER_BINDING
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_MAX_RENDERBUFFER_SIZE

static final int GL_MAX_RENDERBUFFER_SIZE
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0

GL_INVALID_FRAMEBUFFER_OPERATION

static final int GL_INVALID_FRAMEBUFFER_OPERATION
OpenGL ES 2.0 constant.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0


Method Detail

glActiveTexture

void glActiveTexture(int texture)
Select active texture unit.

Description

glActiveTexture selects which texture unit subsequent texture state calls will affect. The number of texture units an implementation supports is implementation dependent, but must be at least 2.

Errors

GL_INVALID_ENUM is generated if texture is not one of GL_TEXTUREi, where i ranges from 0 to (GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1).

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_ACTIVE_TEXTURE or GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS.

Parameters:
texture - Specifies which texture unit to make active. The number of texture units is implementation dependent, but must be at least two. texture must be one of GL_TEXTUREi, where i ranges from 0 to (GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS - 1). The initial value is GL_TEXTURE0.
See Also:
GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, int[], int), GL20.glTexParameteriv(int, int, IntBuffer)
Since:
BlackBerry API 7.0.0

glAttachShader

void glAttachShader(int program,
                    int shader)
Attach a shader object to a program object.

Description

In order to create an executable, there must be a way to specify the list of things that will be linked together. Program objects provide this mechanism. Shaders that are to be linked together in a program object must first be attached to that program object. glAttachShader attaches the shader object specified by shader to the program object specified by program. This indicates that shader will be included in link operations that will be performed on program.

All operations that can be performed on a shader object are valid whether or not the shader object is attached to a program object. It is permissible to attach a shader object to a program object before source code has been loaded into the shader object or before the shader object has been compiled. It is permissible to attach multiple shader objects of the same type because each may contain a portion of the complete shader. It is also permissible to attach a shader object to more than one program object. If a shader object is deleted while it is attached to a program object, it will be flagged for deletion, and deletion will not occur until glDetachShader is called to detach it from all program objects to which it is attached.

Errors

GL_INVALID_VALUE is generated if either program or shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_OPERATION is generated if shader is not a shader object.

GL_INVALID_OPERATION is generated if shader is already attached to program.

Associated Gets

glGetAttachedShaders/ glGetAttachedShaders with the handle of a valid program object.

glIsProgram

glIsShader

Parameters:
program - Specifies the program object to which a shader object will be attached.
shader - Specifies the shader object that is to be attached.
See Also:
GL20.glCompileShader(int), GL20.glDetachShader(int, int), GL20.glLinkProgram(int), GL20.glShaderSource(int, int, String[], int[]), GL20.glShaderBinary(int, IntBuffer, int, Buffer, int), GL20.glShaderBinary(int, int[], int, int, Buffer, int)
Since:
BlackBerry API 7.0.0

glBindAttribLocation

void glBindAttribLocation(int program,
                          int index,
                          String name)
Associate a generic vertex attribute index with a named attribute variable.

Description

glBindAttribLocation is used to associate a user-defined attribute variable in the program object specified by program with a generic vertex attribute index. The name of the user-defined attribute variable is passed as a string in name. The generic vertex attribute index to be bound to this variable is specified by index. When program is made part of current state, values provided via the generic vertex attribute index will modify the value of the user-defined attribute variable specified by name.

If name refers to a matrix attribute variable, index refers to the first column of the matrix. Other matrix columns are then automatically bound to locations index+1 for a matrix of type mat2; index+1 and index+2 for a matrix of type mat3; and index+1, index+2, and index+3 for a matrix of type mat4.

This command makes it possible for vertex shaders to use descriptive names for attribute variables rather than generic variables that are numbered from 0 to GL_MAX_VERTEX_ATTRIBS -1. The values sent to each generic attribute index are part of current state, just like standard vertex attributes such as color, normal, and vertex position. If a different program object is made current by calling glUseProgram, the generic vertex attributes are tracked in such a way that the same values will be observed by attributes in the new program object that are also bound to index.

Attribute variable name-to-generic attribute index bindings for a program object can be explicitly assigned at any time by calling glBindAttribLocation. Attribute bindings do not go into effect until glLinkProgram is called. After a program object has been linked successfully, the index values for generic attributes remain fixed (and their values can be queried) until the next link command occurs.

Applications are not allowed to bind any of the standard OpenGL vertex attributes using this command, as they are bound automatically when needed. Any attribute binding that occurs after the program object has been linked will not take effect until the next time the program object is linked.

Notes

glBindAttribLocation can be called before any vertex shader objects are bound to the specified program object. It is also permissible to bind a generic attribute index to an attribute variable name that is never used in a vertex shader.

If name was bound previously, that information is lost. Thus you cannot bind one user-defined attribute variable to multiple indices, but you can bind multiple user-defined attribute variables to the same index.

Applications are allowed to bind more than one user-defined attribute variable to the same generic vertex attribute index. This is called aliasing, and it is allowed only if just one of the aliased attributes is active in the executable program, or if no path through the shader consumes more than one attribute of a set of attributes aliased to the same location. The compiler and linker are allowed to assume that no aliasing is done and are free to employ optimizations that work only in the absence of aliasing. OpenGL implementations are not required to do error checking to detect aliasing. Because there is no way to bind standard attributes, it is not possible to alias generic attributes with conventional ones (except for generic attribute 0).

Active attributes that are not explicitly bound will be bound by the linker when glLinkProgram is called. The locations assigned can be queried by calling glGetAttribLocation.

Errors

GL_INVALID_VALUE is generated if index is greater than or equal to GL_MAX_VERTEX_ATTRIBS.

GL_INVALID_OPERATION is generated if name starts with the reserved prefix "gl_".

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_VERTEX_ATTRIBS

glGetActiveAttrib with argument program

glGetAttribLocation with arguments program and name

glIsProgram

Parameters:
program - Specifies the handle of the program object in which the association is to be made.
index - Specifies the index of the generic vertex attribute to be bound.
name - Specifies a string containing the name of the vertex shader attribute variable to which index is to be bound.
See Also:
GL20.glDisableVertexAttribArray(int), GL20.glEnableVertexAttribArray(int), GL20.glUseProgram(int), GL20.glVertexAttrib1f(int, float), GL20.glVertexAttrib1fv(int, FloatBuffer), GL20.glVertexAttrib1fv(int, float[], int), GL20.glVertexAttrib2f(int, float, float), GL20.glVertexAttrib2fv(int, FloatBuffer), GL20.glVertexAttrib2fv(int, float[], int), GL20.glVertexAttrib3f(int, float, float, float), GL20.glVertexAttrib3fv(int, FloatBuffer), GL20.glVertexAttrib3fv(int, float[], int), GL20.glVertexAttrib4f(int, float, float, float, float), GL20.glVertexAttrib4fv(int, FloatBuffer), GL20.glVertexAttrib4fv(int, float[], int), GL20.glVertexAttribPointer(int, int, int, boolean, int, Buffer), GL20.glVertexAttribPointer(int, int, int, boolean, int, int)
Since:
BlackBerry API 7.0.0

glBindBuffer

void glBindBuffer(int target,
                  int buffer)
Bind a named buffer object.

Description

glBindBuffer lets you create or use a named buffer object. Calling glBindBuffer with target set to GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER and buffer set to the name of the new buffer object binds the buffer object name to the target. When a buffer object is bound to a target, the previous binding for that target is automatically broken.

Buffer object names are unsigned integers. The value zero is reserved, but there is no default buffer object for each buffer object target. Instead, buffer set to zero effectively unbinds any buffer object previously bound, and restores client memory usage for that buffer object target. Buffer object names and the corresponding buffer object contents are local to the shared object space of the current GL rendering context.

You may use glGenBuffers/ glGenBuffers to generate a set of new buffer object names.

The state of a buffer object immediately after it is first bound is a zero-sized memory buffer with GL_STATIC_DRAW usage.

While a non-zero buffer object name is bound, GL operations on the target to which it is bound affect the bound buffer object, and queries of the target to which it is bound return state from the bound buffer object. While buffer object name zero is bound, as in the initial state, attempts to modify or query state on the target to which it is bound generates an GL_INVALID_OPERATION error.

When vertex array pointer state is changed by a call to glVertexAttribPointer/ glVertexAttribPointer, the current buffer object binding (GL_ARRAY_BUFFER_BINDING) is copied into the corresponding client state for the vertex attrib array being changed, one of the indexed GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDINGs. While a non-zero buffer object is bound to the GL_ARRAY_BUFFER target, the vertex array pointer parameter that is traditionally interpreted as a pointer to client-side memory is instead interpreted as an offset within the buffer object measured in basic machine units.

While a non-zero buffer object is bound to the GL_ELEMENT_ARRAY_BUFFER target, the indices parameter of glDrawElements/ glDrawElements that is traditionally interpreted as a pointer to client-side memory is instead interpreted as an offset within the buffer object measured in basic machine units.

A buffer object binding created with glBindBuffer remains active until a different buffer object name is bound to the same target, or until the bound buffer object is deleted with glDeleteBuffers/ glDeleteBuffers.

Once created, a named buffer object may be re-bound to any target as often as needed. However, the GL implementation may make choices about how to optimize the storage of a buffer object based on its initial binding target.

Errors

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

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_ARRAY_BUFFER_BINDING

glGetIntegerv/glGetIntegerv with argument GL_ELEMENT_ARRAY_BUFFER_BINDING

Parameters:
target - Specifies the target to which the buffer object is bound. The symbolic constant must be GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER.
buffer - Specifies the name of a buffer object.
See Also:
GL20.glDeleteBuffers(int, IntBuffer), GL20.glDeleteBuffers(int, int[], int), GL20.glGenBuffers(int, IntBuffer), GL20.glGenBuffers(int, int[], int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int), GL20.glIsBuffer(int)
Since:
BlackBerry API 7.0.0

glBindFramebuffer

void glBindFramebuffer(int target,
                       int framebuffer)
Bind a named framebuffer object.

Description

glBindFramebuffer lets you create or use a named framebuffer object. Calling glBindFramebuffer with target set to GL_FRAMEBUFFER and framebuffer set to the name of the new framebuffer object binds the framebuffer object name. When a framebuffer object is bound, the previous binding is automatically broken.

Framebuffer object names are unsigned integers. The value zero is reserved to represent the default framebuffer provided by the windowing system. Framebuffer object names and the corresponding framebuffer object contents are local to the shared object space of the current GL rendering context.

You may use glGenFramebuffers/ glGenFramebuffers to generate a set of new framebuffer object names.

The state of a framebuffer object immediately after it is first bound is three attachment points (GL_COLOR_ATTACHMENT0, GL_DEPTH_ATTACHMENT, and GL_STENCIL_ATTACHMENT) each with GL_NONE as the object type.

While a non-zero framebuffer object name is bound, GL operations on target GL_FRAMEBUFFER affect the bound framebuffer object, and queries of target GL_FRAMEBUFFER or of framebuffer details such as GL_DEPTH_BITS return state from the bound framebuffer object. While framebuffer object name zero is bound, as in the initial state, attempts to modify or query state on target GL_FRAMEBUFFER generates an GL_INVALID_OPERATION error.

While a non-zero framebuffer object name is bound, all rendering to the framebuffer (with glDrawArrays and glDrawElements/ glDrawElements) and reading from the framebuffer (with glReadPixels, glCopyTexImage2D, or glCopyTexSubImage2D) use the images attached to the application-created framebuffer object rather than the default window-system-provided framebuffer.

Application created framebuffer objects (i.e. those with a non-zero name) differ from the default window-system-provided framebuffer in a few important ways. First, they have modifiable attachment points for a color buffer, a depth buffer, and a stencil buffer to which framebuffer attachable images may be attached and detached. Second, the size and format of the attached images are controlled entirely within the GL and are not affected by window-system events, such as pixel format selection, window resizes, and display mode changes. Third, when rendering to or reading from an application created framebuffer object, the pixel ownership test always succeeds (i.e. they own all their pixels). Fourth, there are no visible color buffer bitplanes, only a single "off-screen" color image attachment, so there is no sense of front and back buffers or swapping. Finally, there is no multisample buffer, so the value of the implementation-dependent state variables GL_SAMPLES and GL_SAMPLE_BUFFERS are both zero for application created framebuffer objects.

A framebuffer object binding created with glBindFramebuffer remains active until a different framebuffer object name is bound, or until the bound framebuffer object is deleted with glDeleteFramebuffers/ glDeleteFramebuffers.

Notes

Queries of implementation-dependent pixel depths and related state are derived from the currently bound framebuffer object. These include GL_RED_BITS, GL_GREEN_BITS, GL_BLUE_BITS, GL_ALPHA_BITS, GL_DEPTH_BITS, GL_STENCIL_BITS, GL_IMPLEMENTATION_COLOR_READ_TYPE, GL_IMPLEMENTATION_COLOR_READ_FORMAT, GL_SAMPLES, and GL_SAMPLE_BUFFERS.

Errors

GL_INVALID_ENUM is generated if target is not GL_FRAMEBUFFER.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_FRAMEBUFFER_BINDING

Parameters:
target - Specifies the target to which the framebuffer object is bound. The symbolic constant must be GL_FRAMEBUFFER.
framebuffer - Specifies the name of a framebuffer object.
See Also:
GL20.glDeleteFramebuffers(int, IntBuffer), GL20.glDeleteFramebuffers(int, int[], int), GL20.glFramebufferRenderbuffer(int, int, int, int), GL20.glFramebufferTexture2D(int, int, int, int, int), GL20.glGenFramebuffers(int, IntBuffer), GL20.glGenFramebuffers(int, int[], int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, IntBuffer), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, int[], int), GL20.glIsFramebuffer(int)
Since:
BlackBerry API 7.0.0

glBindRenderbuffer

void glBindRenderbuffer(int target,
                        int renderbuffer)
Bind a named renderbuffer object.

Description

A renderbuffer is a data storage object containing a single image of a renderable internal format. A renderbuffer's image may be attached to a framebuffer object to use as a destination for rendering and as a source for reading.

glBindRenderbuffer lets you create or use a named renderbuffer object. Calling glBindRenderbuffer with target set to GL_RENDERBUFFER and renderbuffer set to the name of the new renderbuffer object binds the renderbuffer object name. When a renderbuffer object is bound, the previous binding is automatically broken.

Renderbuffer object names are unsigned integers. The value zero is reserved, but there is no default renderbuffer object. Instead, renderbuffer set to zero effectively unbinds any renderbuffer object previously bound. Renderbuffer object names and the corresponding renderbuffer object contents are local to the shared object space of the current GL rendering context.

You may use glGenRenderbuffers/ glGenRenderbuffers to generate a set of new renderbuffer object names.

The state of a renderbuffer object immediately after it is first bound is a zero-sized memory buffer with format GL_RGBA4 and zero-sized red, green, blue, alpha, depth, and stencil pixel depths.

While a non-zero renderbuffer object name is bound, GL operations on target GL_RENDERBUFFER affect the bound renderbuffer object, and queries of target GL_RENDERBUFFER return state from the bound renderbuffer object. While renderbuffer object name zero is bound, as in the initial state, attempts to modify or query state on target GL_RENDERBUFFER generates an GL_INVALID_OPERATION error.

A renderbuffer object binding created with glBindRenderbuffer remains active until a different renderbuffer object name is bound, or until the bound renderbuffer object is deleted with glDeleteRenderbuffers/ glDeleteRenderbuffers.

Errors

GL_INVALID_ENUM is generated if target is not GL_RENDERBUFFER.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_RENDERBUFFER_BINDING

Parameters:
target - Specifies the target to which the renderbuffer object is bound. The symbolic constant must be GL_RENDERBUFFER.
renderbuffer - Specifies the name of a renderbuffer object.
See Also:
GL20.glDeleteRenderbuffers(int, IntBuffer), GL20.glDeleteRenderbuffers(int, int[], int), GL20.glFramebufferRenderbuffer(int, int, int, int), GL20.glGenRenderbuffers(int, IntBuffer), GL20.glGenRenderbuffers(int, int[], int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int), GL20.glGetRenderbufferParameteriv(int, int, IntBuffer), GL20.glGetRenderbufferParameteriv(int, int, int[], int), GL20.glIsRenderbuffer(int), GL20.glRenderbufferStorage(int, int, int, int)
Since:
BlackBerry API 7.0.0

glBindTexture

void glBindTexture(int target,
                   int texture)
Bind a named texture to a texturing target.

Description

glBindTexture lets you create or use a named texture. Calling glBindTexture with target set to GL_TEXTURE_2D or GL_TEXTURE_CUBE_MAP and texture set to the name of the new texture binds the texture name to the target. When a texture is bound to a target, the previous binding for that target is automatically broken.

Texture names are unsigned integers. The value zero is reserved to represent the default texture for each texture target. Texture names and the corresponding texture contents are local to the shared object space of the current GL rendering context.

You may use glGenTextures/ glGenTextures to generate a set of new texture names.

When a texture is first bound, it assumes the specified target: A texture first bound to GL_TEXTURE_2D becomes a two-dimensional texture and a texture first bound to GL_TEXTURE_CUBE_MAP becomes a cube-mapped texture. The state of a two-dimensional texture immediately after it is first bound is equivalent to the state of the default GL_TEXTURE_2D at GL initialization, and similarly for cube-mapped textures.

While a texture is bound, GL operations on the target to which it is bound affect the bound texture, and queries of the target to which it is bound return state from the bound texture. If texture mapping is active on the target to which a texture is bound, the bound texture is used. In effect, the texture targets become aliases for the textures currently bound to them, and the texture name zero refers to the default textures that were bound to them at initialization.

A texture binding created with glBindTexture remains active until a different texture is bound to the same target, or until the bound texture is deleted with glDeleteTextures/ glDeleteTextures.

Once created, a named texture may be re-bound to its same original target as often as needed. It is usually much faster to use glBindTexture to bind an existing named texture to one of the texture targets than it is to reload the texture image using glTexImage2D.

Errors

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

GL_INVALID_OPERATION is generated if texture was previously created with a target that doesn't match that of target.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_TEXTURE_BINDING_2D

Parameters:
target - Specifies the target of the active texture unit to which the texture is bound. Must be either GL_TEXTURE_2D or GL_TEXTURE_CUBE_MAP.
texture - Specifies the name of a texture.
See Also:
GL20.glDeleteTextures(int, IntBuffer), GL20.glDeleteTextures(int, int[], int), GL20.glGenTextures(int, IntBuffer), GL20.glGenTextures(int, int[], int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int), GL20.glGetTexParameterfv(int, int, FloatBuffer), GL20.glGetTexParameterfv(int, int, float[], int), GL20.glGetTexParameteriv(int, int, IntBuffer), GL20.glGetTexParameteriv(int, int, int[], int), GL20.glIsTexture(int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glBlendColor

void glBlendColor(float red,
                  float green,
                  float blue,
                  float alpha)
Set the blend color.

The GL_BLEND_COLOR may be used to calculate the source and destination blending factors. The color components are clamped to the range [0, 1] before being stored. See glBlendFunc for a complete description of the blending operations. Initially the GL_BLEND_COLOR is set to (0, 0, 0, 0).

Associated Gets

glGetIntegerv/ glGetIntegerv with an argument of GL_BLEND_COLOR

Parameters:
red - Specifies the red component of GL_BLEND_COLOR.
green - Specifies the green component of GL_BLEND_COLOR.
blue - Specifies the blue component of GL_BLEND_COLOR.
alpha - Specifies the alpha component of GL_BLEND_COLOR.
See Also:
GL20.glBlendEquation(int), GL20.glBlendFunc(int, int), GL20.glGetString(int)
Since:
BlackBerry API 7.0.0

glBlendEquation

void glBlendEquation(int mode)
Specify the equation used for both the RGB blend equation and the Alpha blend equation.

Description

The blend equations determine how a new pixel (the "source" color) is combined with a pixel already in the framebuffer (the "destination" color). This function sets both the RGB blend equation and the alpha blend equation to a single equation.

These equations use the source and destination blend factors specified by either glBlendFunc or glBlendFuncSeparate. See glBlendFunc or glBlendFuncSeparate for a description of the various blend factors.

In the equations that follow, source and destination color components are referred to as (Rs, Gs, Bs, As) and (Rd, Gd, Bd, Ad), respectively. The result color is referred to as (Rr, Gr, Br, Ar). The source and destination blend factors are denoted (sR, sG, sB, sA) and (dR, dG, dB, dA), respectively. For these equations all color components are understood to have values in the range [0, 1].

ModeRGB ComponentsAlpha Component
GL_FUNC_ADD
  Rr = Rs*sR + Rd*dR      
  Gr = Gs*sG + Gd*dG
  Br = Bs*sB + Bd*dB
  
Ar = As*sA + Ad*dA
GL_FUNC_SUBTRACT
  Rr = Rs*sR - Rd*dR
  Gr = Gs*sG - Gd*dG
  Br = Bs*sB - Bd*dB
  
Ar = As*sA - Ad*dA
GL_FUNC_REVERSE_SUBTRACT
  Rr = Rd*dR - Rs*sR
  Gr = Gd*dG - Gs*sG
  Br = Bd*dB - Bs*sB
  
Ar = Ad*dA - As*sA

The results of these equations are clamped to the range [0, 1].

The GL_FUNC_ADD equation is useful for antialiasing and transparency, among other things.

Initially, both the RGB blend equation and the alpha blend equation are set to GL_FUNC_ADD.

Errors

GL_INVALID_ENUM is generated if mode is not one of GL_FUNC_ADD, GL_FUNC_SUBTRACT, or GL_FUNC_REVERSE_SUBTRACT.

Associated Gets

glGetIntegerv/glGetIntegerv with an argument of GL_BLEND_EQUATION_RGB

glGetIntegerv/glGetIntegerv with an argument of GL_BLEND_EQUATION_ALPHA

Parameters:
mode - Specifies how source and destination colors are combined. It must be GL_FUNC_ADD, GL_FUNC_SUBTRACT, or GL_FUNC_REVERSE_SUBTRACT.
See Also:
GL20.glGetString(int), GL20.glBlendColor(float, float, float, float), GL20.glBlendEquationSeparate(int, int), GL20.glBlendFunc(int, int), GL20.glBlendFuncSeparate(int, int, int, int)
Since:
BlackBerry API 7.0.0

glBlendEquationSeparate

void glBlendEquationSeparate(int modeRGB,
                             int modeAlpha)
Set the RGB blend equation and the alpha blend equation separately.

Description

The blend equations determines how a new pixel (the "source" color) is combined with a pixel already in the framebuffer (the "destination" color). This function specifies one blend equation for the RGB-color components and one blend equation for the alpha component.

The blend equations use the source and destination blend factors specified by either glBlendFunc or glBlendFuncSeparate. See glBlendFunc or glBlendFuncSeparate for a description of the various blend factors.

In the equations that follow, source and destination color components are referred to as (Rs, Gs, Bs, As) and (Rd, Gd, Bd, Ad), respectively. The result color is referred to as (Rr, Gr, Br, Ar). The source and destination blend factors are denoted (sR, sG, sB, sA) and (dR, dG, dB, dA), respectively. For these equations all color components are understood to have values in the range [0, 1].

ModeRGB ComponentsAlpha Component
GL_FUNC_ADD
  Rr = Rs*sR + Rd*dR      
  Gr = Gs*sG + Gd*dG
  Br = Bs*sB + Bd*dB
  
Ar = As*sA + Ad*dA
GL_FUNC_SUBTRACT
  Rr = Rs*sR - Rd*dR
  Gr = Gs*sG - Gd*dG
  Br = Bs*sB - Bd*dB
  
Ar = As*sA - Ad*dA
GL_FUNC_REVERSE_SUBTRACT
  Rr = Rd*dR - Rs*sR
  Gr = Gd*dG - Gs*sG
  Br = Bd*dB - Bs*sB
  
Ar = Ad*dA - As*sA

The results of these equations are clamped to the range [0, 1].

The GL_FUNC_ADD equation is useful for antialiasing and transparency, among other things.

Initially, both the RGB blend equation and the alpha blend equation are set to GL_FUNC_ADD.

Errors

GL_INVALID_ENUM is generated if either modeRGB or modeAlpha is not one of GL_FUNC_ADD, GL_FUNC_SUBTRACT, or GL_FUNC_REVERSE_SUBTRACT.

Associated Gets

glGetIntegerv/glGetIntegerv with an argument of GL_BLEND_EQUATION_RGB

glGetIntegerv/glGetIntegerv with an argument of GL_BLEND_EQUATION_ALPHA

Parameters:
modeRGB - Specifies the RGB blend equation, how the red, green, and blue components of the source and destination colors are combined. It must be GL_FUNC_ADD, GL_FUNC_SUBTRACT, or GL_FUNC_REVERSE_SUBTRACT.
modeAlpha - Specifies the alpha blend equation, how the alpha component of the source and destination colors are combined. It must be GL_FUNC_ADD, GL_FUNC_SUBTRACT, or GL_FUNC_REVERSE_SUBTRACT.
See Also:
GL20.glGetString(int), GL20.glBlendColor(float, float, float, float), GL20.glBlendEquation(int), GL20.glBlendFunc(int, int), GL20.glBlendFuncSeparate(int, int, int, int)
Since:
BlackBerry API 7.0.0

glBlendFunc

void glBlendFunc(int sfactor,
                 int dfactor)
Specify pixel arithmetic.

Description

Pixels can be drawn using a function that blends the incoming (source) RGBA values with the RGBA values that are already in the frame buffer (the destination values). Blending is initially disabled. Use glEnable and glDisable with argument GL_BLEND to enable and disable blending.

glBlendFunc defines the operation of blending when it is enabled. sfactor specifies which method is used to scale the source color components. dfactor specifies which method is used to scale the destination color components. The possible methods are described in the following table. Each method defines four scale factors, one each for red, green, blue, and alpha. In the table and in subsequent equations, source and destination color components are referred to as (Rs, Gs, Bs, As) and (Rd, Gd, Bd, Ad). The color specified by glBlendColor is referred to as (Rc, Gc, Bc, Ac). They are understood to have integer values between 0 and (kR, kG, kB, kA), where

kc = 2^mc - 1

and (mR, mG, mB, mA) is the number of red, green, blue, and alpha bitplanes.

Source and destination scale factors are referred to as (sR, sG, sB, sA) and (dR, dG, dB, dA). The scale factors described in the table, denoted (fR, fG, fB, fA), represent either source or destination factors. All scale factors have range [0, 1].

Parameter
(fR, fG, fB, fA)
GL_ZERO
(0, 0, 0, 0)
GL_ONE
(1, 1, 1, 1)
GL_SRC_COLOR
(Rs/kR, Gs/kG, Bs/kB, As/kA)
GL_ONE_MINUS_SRC_COLOR
(1, 1, 1, 1) - (Rs/kR, Gs/kG, Bs/kB, As/kA)
GL_DST_COLOR
(Rd/kR, Gd/kG, Bd/kB, Ad/kA)
GL_ONE_MINUS_DST_COLOR
(1, 1, 1, 1) - (Rd/kR, Gd/kG, Bd/kB, Ad/kA)
GL_SRC_ALPHA
(As/kA, As/kA, As/kA, As/kA)
GL_ONE_MINUS_SRC_ALPHA
(1, 1, 1, 1) - (As/kA, As/kA, As/kA, As/kA)
GL_DST_ALPHA
(Ad/kA, Ad/kA, Ad/kA, Ad/kA)
GL_ONE_MINUS_DST_ALPHA
(1, 1, 1, 1) - (Ad/kA, Ad/kA, Ad/kA, Ad/kA)
GL_CONSTANT_COLOR
(Rc, Gc, Bc, Ac)
GL_ONE_MINUS_CONSTANT_COLOR
(1, 1, 1, 1) - (Rc, Gc, Bc, Ac)
GL_CONSTANT_ALPHA
(Ac, Ac, Ac, Ac)
GL_ONE_MINUS_CONSTANT_ALPHA
(1, 1, 1, 1) - (Ac, Ac, Ac, Ac)
GL_SRC_ALPHA_SATURATE
(i, i, i, 1)

In the table,

i = min(As, kA - Ad) / kA.

To determine the blended RGBA values of a pixel, the system uses one of the equations set by glBlendEquation or glBlendEquationSeparate.

Blending arithmetic is not exactly specified, because blending operates with imprecise integer color values. However, a blend factor that should be equal to 1 is guaranteed not to modify its multiplicand, and a blend factor equal to 0 reduces its multiplicand to 0.

Notes

Incoming (source) alpha is correctly thought of as a material opacity, ranging from 1.0 (KA), representing complete opacity, to 0.0 (0), representing complete transparency.

Transparency is best implemented using blend function (GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA) with primitives sorted from farthest to nearest. Note that this transparency calculation does not require the presence of alpha bitplanes in the frame buffer.

Errors

GL_INVALID_ENUM is generated if either sfactor or dfactor is not an accepted value.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_BLEND_SRC_RGB or GL_BLEND_SRC_ALPHA

glGetIntegerv/glGetIntegerv with argument GL_BLEND_DST_RGB or GL_BLEND_DST_ALPHA

glIsEnabled with argument GL_BLEND

Parameters:
sfactor - Specifies how the red, green, blue, and alpha source blending factors are computed. The following symbolic constants are accepted: GL_ZERO, GL_ONE, GL_SRC_COLOR, GL_ONE_MINUS_SRC_COLOR, GL_DST_COLOR, GL_ONE_MINUS_DST_COLOR, GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA, GL_DST_ALPHA, GL_ONE_MINUS_DST_ALPHA, GL_CONSTANT_COLOR, GL_ONE_MINUS_CONSTANT_COLOR, GL_CONSTANT_ALPHA, GL_ONE_MINUS_CONSTANT_ALPHA, and GL_SRC_ALPHA_SATURATE. The initial value is GL_ONE.
dfactor - Specifies how the red, green, blue, and alpha destination blending factors are computed. The following symbolic constants are accepted: GL_ZERO, GL_ONE, GL_SRC_COLOR, GL_ONE_MINUS_SRC_COLOR, GL_DST_COLOR, GL_ONE_MINUS_DST_COLOR, GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA, GL_DST_ALPHA, GL_ONE_MINUS_DST_ALPHA, GL_CONSTANT_COLOR, GL_ONE_MINUS_CONSTANT_COLOR, GL_CONSTANT_ALPHA, and GL_ONE_MINUS_CONSTANT_ALPHA. The initial value is GL_ZERO.
See Also:
GL20.glBlendColor(float, float, float, float), GL20.glBlendEquation(int), GL20.glBlendEquationSeparate(int, int), GL20.glBlendFuncSeparate(int, int, int, int), GL20.glClear(int), GL20.glEnable(int), GL20.glStencilFunc(int, int, int)
Since:
BlackBerry API 7.0.0

glBlendFuncSeparate

void glBlendFuncSeparate(int srcRGB,
                         int dstRGB,
                         int srcAlpha,
                         int dstAlpha)
Specify pixel arithmetic for RGB and alpha components separately.

Description

Pixels can be drawn using a function that blends the incoming (source) RGBA values with the RGBA values that are already in the frame buffer (the destination values). Blending is initially disabled. Use glEnable and glDisable with argument GL_BLEND to enable and disable blending.

glBlendFuncSeparate defines the operation of blending when it is enabled. srcRGB specifies which method is used to scale the source RGB-color components. dstRGB specifies which method is used to scale the destination RGB-color components. Likewise, srcAlpha specifies which method is used to scale the source alpha color component, and dstAlpha specifies which method is used to scale the destination alpha component. The possible methods are described in the following table. Each method defines four scale factors, one each for red, green, blue, and alpha.

In the table and in subsequent equations, source and destination color components are referred to as (Rs, Gs, Bs, As) and (Rd, Gd, Bd, Ad). The color specified by glBlendColor is referred to as (Rc, Gc, Bc, Ac). They are understood to have integer values between 0 and (kR, kG, kB, kA), where

kc = 2^mc - 1

and (mR, mG, mB, mA) is the number of red, green, blue, and alpha bitplanes.

Source and destination scale factors are referred to as (sR, sG, sB, sA) and (dR, dG, dB, dA). All scale factors have range [0, 1].

Parameter RGB Factor Alpha Factor
GL_ZERO
(0, 0, 0)
0
GL_ONE
(1, 1, 1)
1
GL_SRC_COLOR
(Rs/kR, Gs/kG, Bs/kB)
As/kA
GL_ONE_MINUS_SRC_COLOR
(1, 1, 1) - (Rs/kR, Gs/kG, Bs/kB)
1 - As/kA
GL_DST_COLOR
(Rd/kR, Gd/kG, Bd/kB)
Ad/kA
GL_ONE_MINUS_DST_COLOR
(1, 1, 1) - (Rd/kR, Gd/kG, Bd/kB)
1 - Ad/kA
GL_SRC_ALPHA
(As/kA, As/kA, As/kA)
As/kA
GL_ONE_MINUS_SRC_ALPHA
(1, 1, 1) - (As/kA, As/kA, As/kA)
1 - As/kA
GL_DST_ALPHA
(Ad/kA, Ad/kA, Ad/kA)
Ad/kA
GL_ONE_MINUS_DST_ALPHA
(1, 1, 1) - (Ad/kA, Ad/kA, Ad/kA)
1 - Ad/kA
GL_CONSTANT_COLOR
(Rc, Gc, Bc)
Ac
GL_ONE_MINUS_CONSTANT_COLOR
(1, 1, 1) - (Rc, Gc, Bc)
1 - Ac
GL_CONSTANT_ALPHA
(Ac, Ac, Ac)
Ac
GL_ONE_MINUS_CONSTANT_ALPHA
(1, 1, 1) - (Ac, Ac, Ac)
1 - Ac
GL_SRC_ALPHA_SATURATE
(i, i, i)
1

In the table,

i = min(As, kA - Ad) / kA.

To determine the blended RGBA values of a pixel, the system uses one of the equations set by glBlendEquation or glBlendEquationSeparate.

Despite the apparent precision of the above equations, blending arithmetic is not exactly specified, because blending operates with imprecise integer color values. However, a blend factor that should be equal to 1 is guaranteed not to modify its multiplicand, and a blend factor equal to 0 reduces its multiplicand to 0.

Notes

Incoming (source) alpha is correctly thought of as a material opacity, ranging from 1.0 (KA), representing complete opacity, to 0.0 (0), representing complete transparency.

Errors

GL_INVALID_ENUM is generated if srcRGB, dstRGB, srcAlpha, or dstAlpha is not an accepted value.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_BLEND_SRC_RGB

glGetIntegerv/glGetIntegerv with argument GL_BLEND_SRC_ALPHA

glGetIntegerv/glGetIntegerv with argument GL_BLEND_DST_RGB

glGetIntegerv/glGetIntegerv with argument GL_BLEND_DST_ALPHA

glIsEnabled with argument GL_BLEND

Parameters:
srcRGB - Specifies how the red, green, and blue source blending factors are computed. The following symbolic constants are accepted: GL_ZERO, GL_ONE, GL_SRC_COLOR, GL_ONE_MINUS_SRC_COLOR, GL_DST_COLOR, GL_ONE_MINUS_DST_COLOR, GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA, GL_DST_ALPHA, GL_ONE_MINUS_DST_ALPHA, GL_CONSTANT_COLOR, GL_ONE_MINUS_CONSTANT_COLOR, GL_CONSTANT_ALPHA, GL_ONE_MINUS_CONSTANT_ALPHA, and GL_SRC_ALPHA_SATURATE. The initial value is GL_ONE.
dstRGB - Specifies how the red, green, and blue destination blending factors are computed. The following symbolic constants are accepted: GL_ZERO, GL_ONE, GL_SRC_COLOR, GL_ONE_MINUS_SRC_COLOR, GL_DST_COLOR, GL_ONE_MINUS_DST_COLOR, GL_SRC_ALPHA, GL_ONE_MINUS_SRC_ALPHA, GL_DST_ALPHA, GL_ONE_MINUS_DST_ALPHA, GL_CONSTANT_COLOR, GL_ONE_MINUS_CONSTANT_COLOR, GL_CONSTANT_ALPHA, and GL_ONE_MINUS_CONSTANT_ALPHA. The initial value is GL_ZERO.
srcAlpha - Specifies how the alpha source blending factor is computed. The same symbolic constants are accepted as for srcRGB. The initial value is GL_ONE.
dstAlpha - Specifies how the alpha destination blending factor is computed. The same symbolic constants are accepted as for dstRGB. The initial value is GL_ZERO.
See Also:
GL20.glBlendColor(float, float, float, float), GL20.glBlendEquation(int), GL20.glBlendEquationSeparate(int, int), GL20.glBlendFunc(int, int), GL20.glClear(int), GL20.glEnable(int), GL20.glStencilFunc(int, int, int)
Since:
BlackBerry API 7.0.0

glBufferData

void glBufferData(int target,
                  int size,
                  Buffer data,
                  int usage)
Create and initialize a buffer object's data store.

Description

glBufferData creates a new data store for the buffer object currently bound to target. Any pre-existing data store is deleted. The new data store is created with the specified size in bytes and usage. If data is not null, the data store is initialized with data from this buffer.

usage is a hint to the GL implementation as to how a buffer object's data store will be accessed. This enables the GL implementation to make more intelligent decisions that may significantly impact buffer object performance. It does not, however, constrain the actual usage of the data store. usage can be broken down into two parts: first, the frequency of access (modification and usage), and second, the nature of that access. The frequency of access may be one of these:

STREAM

The data store contents will be modified once and used at most a few times.

STATIC

The data store contents will be modified once and used many times.

DYNAMIC

The data store contents will be modified repeatedly and used many times.

The nature of access must be:

DRAW

The data store contents are modified by the application, and used as the source for GL drawing and image specification commands.

Notes

If data is null, a data store of the specified size is still created, but its contents remain uninitialized and thus undefined.

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 be a multiple of N.

Errors

GL_INVALID_ENUM is generated if target is not GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER.

GL_INVALID_ENUM is generated if usage is not GL_STREAM_DRAW, GL_STATIC_DRAW, or GL_DYNAMIC_DRAW.

GL_INVALID_VALUE is generated if size is negative.

GL_INVALID_OPERATION is generated if the reserved buffer object name 0 is bound to target.

GL_OUT_OF_MEMORY is generated if the GL is unable to create a data store with the specified size.

Associated Gets

glGetBufferParameteriv/ glGetBufferParameteriv with argument GL_BUFFER_SIZE or GL_BUFFER_USAGE

Parameters:
target - Specifies the target buffer object. The symbolic constant must be GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER.
size - Specifies the size in bytes of the buffer object's new data store.
data - Specifies the data that will be copied into the data store for initialization, or null if no data is to be copied.
usage - Specifies the expected usage pattern of the data store. The symbolic constant must be GL_STREAM_DRAW, GL_STATIC_DRAW, or GL_DYNAMIC_DRAW.
Throws:
IllegalArgumentException - If data.remaining() is less than size.
See Also:
GL20.glBindBuffer(int, int), GL20.glBufferSubData(int, int, int, Buffer)
Since:
BlackBerry API 7.0.0

glBufferSubData

void glBufferSubData(int target,
                     int offset,
                     int size,
                     Buffer data)
Update a subset of a buffer object's data store.

Description

glBufferSubData redefines some or all of the data store for the buffer object currently bound to target. Data starting at byte offset offset and extending for size bytes is copied to the data store from the data buffer data. An error is thrown if offset and size together define a range beyond the bounds of the buffer object's data store.

Notes

When replacing the entire data store, consider using glBufferSubData rather than completely recreating the data store with glBufferData. This avoids the cost of reallocating the data store.

Consider using multiple buffer objects to avoid stalling the rendering pipeline during data store updates. If any rendering in the pipeline makes reference to data in the buffer object being updated by glBufferSubData, especially from the specific region being updated, that rendering must drain from the pipeline before the data store can be updated.

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 be a multiple of N.

Errors

GL_INVALID_ENUM if target is not GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER.

GL_INVALID_VALUE is generated if offset or size is negative, or if together they define a region of memory that extends beyond the buffer object's allocated data store.

GL_INVALID_OPERATION is generated if the reserved buffer object name 0 is bound to target.

Parameters:
target - Specifies the target buffer object. The symbolic constant must be GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER.
offset - Specifies the offset into the buffer object's data store where data replacement will begin, measured in bytes.
size - Specifies the size in bytes of the data store region being replaced.
data - Specifies the new data that will be copied into the data store.
Throws:
IllegalArgumentException - If data is null.
IllegalArgumentException - If data.remaining() is less than size.
See Also:
GL20.glBindBuffer(int, int), GL20.glBufferData(int, int, Buffer, int)
Since:
BlackBerry API 7.0.0

glCheckFramebufferStatus

int glCheckFramebufferStatus(int target)
Return the framebuffer completeness status of a framebuffer object.

glCheckFramebufferStatus returns a symbolic constant that identifies whether or not the currently bound framebuffer is framebuffer complete, and if not, which of the rules of framebuffer completeness is violated.

If the framebuffer is complete, then GL_FRAMEBUFFER_COMPLETE is returned. If the framebuffer is not complete, the return values are as follows:

GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT

Not all framebuffer attachment points are framebuffer attachment complete. This means that at least one attachment point with a renderbuffer or texture attached has its attached object no longer in existence or has an attached image with a width or height of zero, or the color attachment point has a non-color-renderable image attached, or the depth attachment point has a non-depth-renderable image attached, or the stencil attachment point has a non-stencil-renderable image attached.

Color-renderable formats include GL_RGBA4, GL_RGB5_A1, and GL_RGB565. GL_DEPTH_COMPONENT16 is the only depth-renderable format. GL_STENCIL_INDEX8 is the only stencil-renderable format.

GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS

Not all attached images have the same width and height.

GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT

No images are attached to the framebuffer.

GL_FRAMEBUFFER_UNSUPPORTED

The combination of internal formats of the attached images violates an implementation-dependent set of restrictions.

If the currently bound framebuffer is not framebuffer complete, then it is an error to attempt to use the framebuffer for writing or reading. This means that rendering commands (glDrawArrays and glDrawElements/ glDrawElements) as well as commands that read the framebuffer (glReadPixels, glCopyTexImage2D, and glCopyTexSubImage2D) will generate the error GL_INVALID_FRAMEBUFFER_OPERATION if called while the framebuffer is not framebuffer complete.

Notes

It is strongly advised, thought not required, that an application call glCheckFramebufferStatus to see if the framebuffer is complete prior to rendering. This is because some implementations may not support rendering to particular combinations of internal formats. In this case, GL_FRAMEBUFFER_UNSUPPORTED is returned.

The default window-system-provided framebuffer is always framebuffer complete, and thus GL_FRAMEBUFFER_COMPLETE is returned when GL_FRAMEBUFFER_BINDING is 0.

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

Errors

GL_INVALID_ENUM is generated if target is not GL_FRAMEBUFFER.

Parameters:
target - Specifies the target framebuffer object. The symbolic constant must be GL_FRAMEBUFFER.
Returns:
The framebuffer completeness status of a framebuffer object.
See Also:
GL20.glBindRenderbuffer(int, int), GL20.glCopyTexImage2D(int, int, int, int, int, int, int, int), GL20.glCopyTexSubImage2D(int, int, int, int, int, int, int, int), GL20.glDrawArrays(int, int, int), GL20.glDrawElements(int, int, int, Buffer), GL20.glDrawElements(int, int, int, int), GL20.glReadPixels(int, int, int, int, int, int, Buffer), GL20.glRenderbufferStorage(int, int, int, int)
Since:
BlackBerry API 7.0.0

glClear

void glClear(int mask)
Clear buffers to preset values.

Description

glClear sets the bitplane area of the window to values previously selected by glClearColor, glClearDepthf, and glClearStencil.

The pixel ownership test, the scissor test, dithering, and the buffer writemasks affect the operation of glClear. The scissor box bounds the cleared region. Blend function, stenciling, fragment shading, and depth-buffering are ignored by glClear.

glClear takes a single argument that is the bitwise OR of several values indicating which buffer is to be cleared.

The values are as follows:

GL_COLOR_BUFFER_BIT

Indicates the buffers currently enabled for color writing.

GL_DEPTH_BUFFER_BIT

Indicates the depth buffer.

GL_STENCIL_BUFFER_BIT

Indicates the stencil buffer.

The value to which each buffer is cleared depends on the setting of the clear value for that buffer.

Notes

If a buffer is not present, then a glClear directed at that buffer has no effect.

Errors

GL_INVALID_VALUE is generated if any bit other than the three defined bits is set in mask.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_DEPTH_CLEAR_VALUE glGetIntegerv/glGetIntegerv with argument GL_COLOR_CLEAR_VALUE glGetIntegerv/glGetIntegerv with argument GL_STENCIL_CLEAR_VALUE

Parameters:
mask - Bitwise OR of masks that indicate the buffers to be cleared. The three masks are GL_COLOR_BUFFER_BIT, GL_DEPTH_BUFFER_BIT, and GL_STENCIL_BUFFER_BIT.
See Also:
GL20.glClearColor(float, float, float, float), GL20.glClearDepthf(float), GL20.glClearStencil(int), GL20.glColorMask(boolean, boolean, boolean, boolean), GL20.glDepthMask(boolean), GL20.glScissor(int, int, int, int), GL20.glStencilMask(int)
Since:
BlackBerry API 7.0.0

glClearColor

void glClearColor(float red,
                  float green,
                  float blue,
                  float alpha)
Specify clear values for the color buffers.

Description

glClearColor specifies the red, green, blue, and alpha values used by glClear to clear the color buffers. Values specified by glClearColor are clamped to the range [0, 1].

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_COLOR_CLEAR_VALUE

Parameters:
red - Specifies the red value used when the color buffers are cleared. The initial value is 0.
green - Specifies the green value used when the color buffers are cleared. The initial value is 0.
blue - Specifies the blue value used when the color buffers are cleared. The initial value is 0.
alpha - Specifies the alpha value used when the color buffers are cleared. The initial value is 0.
See Also:
GL20.glClear(int)
Since:
BlackBerry API 7.0.0

glClearDepthf

void glClearDepthf(float depth)
Specify the clear value for the depth buffer.

Description

glClearDepthf specifies the depth value used by glClear to clear the depth buffer. Values specified by glClearDepthf are clamped to the range [0, 1].

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_DEPTH_CLEAR_VALUE

Parameters:
depth - Specifies the depth value used when the depth buffer is cleared. The initial value is 1.
See Also:
GL20.glClear(int)
Since:
BlackBerry API 7.0.0

glClearStencil

void glClearStencil(int s)
Specify the clear value for the stencil buffer.

Description

glClearStencil specifies the index used by glClear to clear the stencil buffer. s is masked with 2^m - 1, where m is the number of bits in the stencil buffer.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_STENCIL_CLEAR_VALUE

glGetIntegerv/glGetIntegerv with argument GL_STENCIL_BITS

Parameters:
s - Specifies the index used when the stencil buffer is cleared. The initial value is 0.
See Also:
GL20.glClear(int), GL20.glStencilFunc(int, int, int), GL20.glStencilFuncSeparate(int, int, int, int), GL20.glStencilMask(int), GL20.glStencilMaskSeparate(int, int), GL20.glStencilOp(int, int, int), GL20.glStencilOpSeparate(int, int, int, int)
Since:
BlackBerry API 7.0.0

glColorMask

void glColorMask(boolean red,
                 boolean green,
                 boolean blue,
                 boolean alpha)
Enable and disable writing of frame buffer color components.

Description

glColorMask specifies whether the individual color components in the frame buffer can or cannot be written. If red is GL_FALSE, for example, no change is made to the red component of any pixel in any of the color buffers, regardless of the drawing operation attempted.

Changes to individual bits of components cannot be controlled. Rather, changes are either enabled or disabled for entire color components.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_COLOR_WRITEMASK

Parameters:
red - Specifies whether red can or cannot be written into the frame buffer. The initial value is GL_TRUE, indicating that the color component can be written.
green - Specifies whether green can or cannot be written into the frame buffer. The initial value is GL_TRUE, indicating that the color component can be written.
blue - Specifies whether blue can or cannot be written into the frame buffer. The initial value is GL_TRUE, indicating that the color component can be written.
alpha - Specifies whether alpha can or cannot be written into the frame buffer. The initial value is GL_TRUE, indicating that the color component can be written.
See Also:
GL20.glClear(int), GL20.glDepthMask(boolean), GL20.glStencilMask(int)
Since:
BlackBerry API 7.0.0

glCompileShader

void glCompileShader(int shader)
Compile a shader object.

Description

For implementations that support a shader compiler, glCompileShader compiles the source code strings that have been stored in the shader object specified by shader.

The compilation status will be stored as part of the shader object's state. This value will be set to GL_TRUE if the shader was compiled without errors and is ready for use, and GL_FALSE otherwise. It can be queried by calling glGetShaderiv/ glGetShaderiv with arguments shader and GL_COMPILE_STATUS.

Compilation of a shader can fail for a number of reasons as specified by the OpenGL ES Shading Language Specification. Whether or not the compilation was successful, information about the compilation can be obtained from the shader object's information log by calling glGetShaderInfoLog.

Notes

Shader compiler support is optional, and thus must be queried before use by calling glGetIntegerv/ glGetIntegerv with argument GL_SHADER_COMPILER. glShaderSource, glCompileShader, glGetShaderPrecisionFormat, and glReleaseShaderCompiler will each generate GL_INVALID_OPERATION on implementations that do not support a shader compiler. Such implementations instead offer the glShaderBinary/ glShaderBinary alternative for supplying a pre-compiled shader binary.

Errors

GL_INVALID_OPERATION is generated if a shader compiler is not supported.

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if shader is not a shader object.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_SHADER_COMPILER

glGetShaderInfoLog with argument shader

glGetShaderiv/glGetShaderiv with arguments shader and GL_COMPILE_STATUS

glIsShader

Parameters:
shader - Specifies the shader object to be compiled.
See Also:
GL20.glCreateShader(int), GL20.glLinkProgram(int), GL20.glReleaseShaderCompiler(), GL20.glShaderSource(int, int, String[], int[]), GL20.glGetShaderPrecisionFormat(int, int, int[], int, int[], int)
Since:
BlackBerry API 7.0.0

glCompressedTexImage2D

void glCompressedTexImage2D(int target,
                            int level,
                            int internalformat,
                            int width,
                            int height,
                            int border,
                            int imageSize,
                            Buffer data)
Specify a two-dimensional texture image in a compressed format.

Description

Texturing maps a portion of a specified texture image onto each graphical primitive for which texturing is active. Texturing is active when the current fragment shader or vertex shader makes use of built-in texture lookup functions.

glCompressedTexImage2D defines a two-dimensional texture image or cube-map texture image using compressed image data from client memory. The texture image is decoded according to the extension specification defining the specified internalformat. OpenGL ES defines no specific compressed texture formats, but does provide a mechanism to obtain symbolic constants for such formats provided by extensions. The number of compressed texture formats supported can be obtained by querying the value of GL_NUM_COMPRESSED_TEXTURE_FORMATS. The list of specific compressed texture formats supported can be obtained by querying the value of GL_COMPRESSED_TEXTURE_FORMATS.

Notes

A GL implementation may choose to store the texture array at any internal resolution it chooses.

glCompressedTexImage2D specifies a two-dimensional or cube-map texture for the current texture unit, specified with glActiveTexture.

Errors

GL_INVALID_ENUM is generated if target is not GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.

GL_INVALID_ENUM is generated if internalformat is not a supported format returned in GL_COMPRESSED_TEXTURE_FORMATS.

GL_INVALID_VALUE is generated if level is less than 0.

GL_INVALID_VALUE may be generated if level is greater than log_2(max), where max is the returned value of GL_MAX_TEXTURE_SIZE when target is GL_TEXTURE_2D or GL_MAX_CUBE_MAP_TEXTURE_SIZE when target is not GL_TEXTURE_2D.

GL_INVALID_VALUE is generated if width or height is less than 0 or greater than GL_MAX_TEXTURE_SIZE when target is GL_TEXTURE_2D or GL_MAX_CUBE_MAP_TEXTURE_SIZE when target is not GL_TEXTURE_2D.

GL_INVALID_VALUE is generated if border is not 0.

GL_INVALID_VALUE is generated if imageSize is not consistent with the format, dimensions, and contents of the specified compressed image data.

GL_INVALID_OPERATION is generated if parameter combinations are not supported by the specific compressed internal format as specified in the specific texture compression extension.

Undefined results, including abnormal program termination, are generated if data is not encoded in a manner consistent with the extension specification defining the internal compression format.

Associated Gets

glGetIntegerv/glGetIntegerv with arguments GL_NUM_COMPRESSED_TEXTURE_FORMATS and GL_COMPRESSED_TEXTURE_FORMATS

glGetIntegerv/glGetIntegerv with argument GL_MAX_TEXTURE_SIZE or GL_MAX_CUBE_MAP_TEXTURE_SIZE

Parameters:
target - Specifies the target texture of the active texture unit. Must be GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
level - Specifies the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
internalformat - Specifies the format of the compressed image data stored at address data.
width - Specifies the width of the texture image. All implementations support 2D texture images that are at least 64 texels wide and cube-mapped texture images that are at least 16 texels wide.
height - Specifies the height of the texture image. All implementations support 2D texture images that are at least 64 texels high and cube-mapped texture images that are at least 16 texels high.
border - Specifies the width of the border. Must be 0.
imageSize - Specifies the number of unsigned bytes of image data starting at the address specified by data.
data - Specifies the compressed image data as a buffer.
Throws:
IllegalArgumentException - If data is null.
IllegalArgumentException - If data.remaining() is less than imageSize.
See Also:
GL20.glActiveTexture(int), GL20.glCompressedTexSubImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glCopyTexImage2D(int, int, int, int, int, int, int, int), GL20.glCopyTexSubImage2D(int, int, int, int, int, int, int, int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexSubImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glCompressedTexSubImage2D

void glCompressedTexSubImage2D(int target,
                               int level,
                               int xoffset,
                               int yoffset,
                               int width,
                               int height,
                               int format,
                               int imageSize,
                               Buffer data)
Specify a two-dimensional texture subimage in a compressed format.

Description

Texturing maps a portion of a specified texture image onto each graphical primitive for which texturing is active. Texturing is active when the current fragment shader or vertex shader makes use of built-in texture lookup functions.

glCompressedTexSubImage2D redefines a contiguous subregion of an existing two-dimensional texture image. The texels referenced by data replace the portion of the existing texture array with x indices xoffset and xoffset + width - 1, and the y indices yoffset and yoffset + height - 1, inclusive. This region may not include any texels outside the range of the texture array as it was originally specified. It is not an error to specify a subtexture with width of 0, but such a specification has no effect.

format must be the same extension-specified compressed-texture format previously specified by glCompressedTexImage2D.

Notes

glCompressedTexSubImage2D specifies a two-dimensional or cube-map texture for the current texture unit, specified with glActiveTexture.

Errors

GL_INVALID_ENUM is generated if target is not GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.

GL_INVALID_ENUM is generated if format is not a supported format returned in GL_COMPRESSED_TEXTURE_FORMATS.

GL_INVALID_VALUE is generated if level is less than 0.

GL_INVALID_VALUE may be generated if level is greater than log_2(max), where max is the returned value of GL_MAX_TEXTURE_SIZE when target is GL_TEXTURE_2D or GL_MAX_CUBE_MAP_TEXTURE_SIZE when target is not GL_TEXTURE_2D.

GL_INVALID_VALUE is generated if xoffset < 0, xoffset + width > w, yoffset < 0, or yoffset + height > h, where w is the width and h is the height of the texture image being modified.

GL_INVALID_VALUE is generated if width or height is less than 0.

GL_INVALID_VALUE is generated if imageSize is not consistent with the format, dimensions, and contents of the specified compressed image data.

GL_INVALID_OPERATION is generated if the texture array has not been defined by a previous glCompressedTexImage2D operation whose internalformat matches the format of glCompressedTexSubImage2D.

GL_INVALID_OPERATION is generated if parameter combinations are not supported by the specific compressed internal format as specified in the specific texture compression extension.

Undefined results, including abnormal program termination, are generated if data is not encoded in a manner consistent with the extension specification defining the internal compression format.

Associated Gets

glGetIntegerv/glGetIntegerv with arguments GL_NUM_COMPRESSED_TEXTURE_FORMATS and GL_COMPRESSED_TEXTURE_FORMATS

glGetIntegerv/glGetIntegerv with argument GL_MAX_TEXTURE_SIZE or GL_MAX_CUBE_MAP_TEXTURE_SIZE

Parameters:
target - Specifies the target texture of the active texture unit. Must be GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
level - Specifies the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
xoffset - Specifies a texel offset in the x direction within the texture array.
yoffset - Specifies a texel offset in the y direction within the texture array.
width - Specifies the width of the texture subimage.
height - Specifies the height of the texture subimage.
format - Specifies the format of the compressed image data stored in the buffer data.
imageSize - Specifies the number of unsigned bytes of image data in the buffer data.
data - Specifies the compressed image data as a buffer.
Throws:
IllegalArgumentException - If data is null.
IllegalArgumentException - If data.remaining() is less than imageSize.
See Also:
GL20.glActiveTexture(int), GL20.glCompressedTexImage2D(int, int, int, int, int, int, int, Buffer), GL20.glCopyTexImage2D(int, int, int, int, int, int, int, int), GL20.glCopyTexSubImage2D(int, int, int, int, int, int, int, int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexSubImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glCopyTexImage2D

void glCopyTexImage2D(int target,
                      int level,
                      int internalformat,
                      int x,
                      int y,
                      int width,
                      int height,
                      int border)
Copy pixels into a 2D texture image.

Description

Texturing maps a portion of a specified texture image onto each graphical primitive for which texturing is active. Texturing is active when the current fragment shader or vertex shader makes use of built-in texture lookup functions.

glCopyTexImage2D defines a two-dimensional texture image or cube-map texture image with pixels from the current framebuffer (rather than from client memory, as is the case for glTexImage2D).

The screen-aligned pixel rectangle with lower left corner at (x, y) and with a width of width and a height of height defines the texture array at the mipmap level specified by level. internalformat specifies the internal format of the texture array.

The pixels in the rectangle are processed exactly as if glReadPixels had been called with format set to GL_RGBA, but the process stops just after conversion of RGBA values. Subsequent processing is identical to that described for glTexImage2D, beginning with the clamping of the R, G, B, and A values to the range [0, 1] and then conversion to the texture's internal format for storage in the texel array.

The components required for internalformat must be a subset of those present in the framebuffer's format. For example, a GL_RGBA framebuffer can be used to supply components for any internalformat. However, a GL_RGB framebuffer can only be used to supply components for GL_RGB or GL_LUMINANCE base internal format textures, not GL_ALPHA, GL_LUMINANCE_ALPHA, or GL_RGBA textures.

Pixel ordering is such that lower x and y screen coordinates correspond to lower s and t texture coordinates.

If any of the pixels within the specified rectangle are outside the framebuffer associated with the current rendering context, then the values obtained for those pixels are undefined.

Notes

A GL implementation may choose to store the texture array at any internal resolution it chooses.

An image with height or width of 0 indicates a null texture.

glCopyTexImage2D specifies a two-dimensional or cube-map texture for the current texture unit, specified with glActiveTexture.

Errors

GL_INVALID_ENUM is generated if target is not GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.

GL_INVALID_ENUM is generated if internalformat is not an accepted format.

GL_INVALID_VALUE is generated if target is one of the six cube map 2D image targets and the width and height parameters are not equal.

GL_INVALID_VALUE is generated if level is less than 0.

GL_INVALID_VALUE may be generated if level is greater than log_2(max), where max is the returned value of GL_MAX_TEXTURE_SIZE when target is GL_TEXTURE_2D or GL_MAX_CUBE_MAP_TEXTURE_SIZE when target is not GL_TEXTURE_2D.

GL_INVALID_VALUE is generated if width or height is less than 0 or greater than GL_MAX_TEXTURE_SIZE when target is GL_TEXTURE_2D or GL_MAX_CUBE_MAP_TEXTURE_SIZE when target is not GL_TEXTURE_2D.

GL_INVALID_VALUE is generated if border is not 0.

GL_INVALID_OPERATION is generated if the currently bound framebuffer's format does not contain a superset of the components required by the base format of internalformat.

GL_INVALID_FRAMEBUFFER_OPERATION is generated if the currently bound framebuffer is not framebuffer complete (i.e. the return value from glCheckFramebufferStatus is not GL_FRAMEBUFFER_COMPLETE).

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_TEXTURE_SIZE or GL_MAX_CUBE_MAP_TEXTURE_SIZE

Parameters:
target - Specifies the target texture. Must be GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
level - Specifies the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
internalformat - Specifies the internal format of the texture. Must be one of the following symbolic constants: GL_ALPHA, GL_LUMINANCE, GL_LUMINANCE_ALPHA, GL_RGB, or GL_RGBA.
x - Specifies the x window coordinate of the lower left corner of the rectangular region of pixels to be copied.
y - Specifies the y window coordinate of the lower left corner of the rectangular region of pixels to be copied.
width - Specifies the width of the texture image. All implementations support 2D texture images that are at least 64 texels wide and cube-mapped texture images that are at least 16 texels wide.
height - Specifies the height of the texture image. All implementations support 2D texture images that are at least 64 texels high and cube-mapped texture images that are at least 16 texels high.
border - Specifies the width of the border. Must be 0.
See Also:
GL20.glActiveTexture(int), GL20.glCheckFramebufferStatus(int), GL20.glCompressedTexImage2D(int, int, int, int, int, int, int, Buffer), GL20.glCompressedTexSubImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glCopyTexSubImage2D(int, int, int, int, int, int, int, int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int), GL20.glTexSubImage2D(int, int, int, int, int, int, int, int, Buffer)
Since:
BlackBerry API 7.0.0

glCopyTexSubImage2D

void glCopyTexSubImage2D(int target,
                         int level,
                         int xoffset,
                         int yoffset,
                         int x,
                         int y,
                         int width,
                         int height)
Copy a two-dimensional texture subimage.

Description

Texturing maps a portion of a specified texture image onto each graphical primitive for which texturing is active. Texturing is active when the current fragment shader or vertex shader makes use of built-in texture lookup functions.

glCopyTexSubImage2D replaces a rectangular portion of a two-dimensional texture image or cube-map texture image with pixels from the current framebuffer (rather than from client memory, as is the case for glTexSubImage2D).

The screen-aligned pixel rectangle with lower left corner at (x, y) and with width width and height height replaces the portion of the texture array with x indices xoffset through xoffset + width - 1, inclusive, and y indices yoffset through yoffset + height - 1, inclusive, at the mipmap level specified by level.

The pixels in the rectangle are processed exactly as if glReadPixels had been called with format set to GL_RGBA, but the process stops just after conversion of RGBA values. Subsequent processing is identical to that described for glTexSubImage2D, beginning with the clamping of the R, G, B, and A values to the range [0, 1]and then conversion to the texture's internal format for storage in the texel array.

The destination rectangle in the texture array may not include any texels outside the texture array as it was originally specified. It is not an error to specify a subtexture with zero width or height, but such a specification has no effect.

If any of the pixels within the specified rectangle are outside the framebuffer associated with the current rendering context, then the values obtained for those pixels are undefined.

No change is made to the internalformat, width, or height parameters of the specified texture array or to texel values outside the specified subregion.

Notes

glCopyTexSubImage2D specifies the two-dimensional or cube-map texture for the current texture unit, specified with glActiveTexture.

Errors

GL_INVALID_ENUM is generated if target is not GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.

GL_INVALID_VALUE is generated if level is less than 0.

GL_INVALID_VALUE may be generated if level > log_2(max) , where max is the returned value of GL_MAX_TEXTURE_SIZE.

GL_INVALID_VALUE is generated if xoffset < 0, xoffset + width > w, yoffset < 0, or yoffset + height > h, where w is the width and h is the height of the texture image being modified.

GL_INVALID_VALUE is generated if width or height is less than 0.

GL_INVALID_OPERATION is generated if the texture array has not been defined by a previous glTexImage2D or glCopyTexImage2D operation.

GL_INVALID_OPERATION is generated if the currently bound framebuffer's format does not contain a superset of the components required by the texture's base internal format.

GL_INVALID_FRAMEBUFFER_OPERATION is generated if the currently bound framebuffer is not framebuffer complete (i.e. the return value from glCheckFramebufferStatus is not GL_FRAMEBUFFER_COMPLETE).

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_TEXTURE_SIZE or GL_MAX_CUBE_MAP_TEXTURE_SIZE

Parameters:
target - Specifies the target texture. Must be GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
level - Specifies the level-of-detail number. Level 0 is the base image level. Level n is the nth mipmap reduction image.
xoffset - Specifies a texel offset in the x direction within the texture array.
yoffset - Specifies a texel offset in the y direction within the texture array.
x - Specifies the x window coordinate of the lower left corner of the rectangular region of pixels to be copied.
y - Specifies the y window coordinate of the lower left corner of the rectangular region of pixels to be copied.
width - Specifies the width of the texture subimage.
height - Specifies the height of the texture subimage.
See Also:
GL20.glActiveTexture(int), GL20.glCheckFramebufferStatus(int), GL20.glCopyTexImage2D(int, int, int, int, int, int, int, int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int), GL20.glTexSubImage2D(int, int, int, int, int, int, int, int, Buffer)
Since:
BlackBerry API 7.0.0

glCreateProgram

int glCreateProgram()
Create a program object.

Description

glCreateProgram creates an empty program object and returns a non-zero value by which it can be referenced. A program object is an object to which shader objects can be attached. This provides a mechanism to specify the shader objects that will be linked to create a program. It also provides a means for checking the compatibility of the shaders that will be used to create a program (for instance, checking the compatibility between a vertex shader and a fragment shader). When no longer needed as part of a program object, shader objects can be detached.

One or more executables are created in a program object by successfully attaching shader objects to it with glAttachShader, successfully compiling the shader objects with glCompileShader, and successfully linking the program object with glLinkProgram. These executables are made part of current state when glUseProgram is called. Program objects can be deleted by calling glDeleteProgram. The memory associated with the program object will be deleted when it is no longer part of current rendering state for any context.

Notes

Like texture objects, the name space for program objects may be shared across a set of contexts, as long as the server sides of the contexts share the same address space. If the name space is shared across contexts, any attached objects and the data associated with those attached objects are shared as well.

Applications are responsible for providing the synchronization across API calls when objects are accessed from different execution threads.

Errors

This function returns 0 if an error occurs creating the program object.

Associated Gets

glGetIntegerv/glGetIntegerv with the argument GL_CURRENT_PROGRAM

glGetActiveAttrib with a valid program object and the index of an active attribute variable

glGetActiveUniform with a valid program object and the index of an active uniform variable

glGetAttachedShaders/ glGetAttachedShaders with a valid program object

glGetAttribLocation with a valid program object and the name of an attribute variable

glGetProgramiv/ glGetProgramiv with a valid program object and the parameter to be queried

glGetProgramInfoLog with a valid program object

glGetUniform/ glGetUniform/ glGetUniform/ glGetUniform with a valid program object and the location of a uniform variable

glGetUniformLocation with a valid program object and the name of a uniform variable

glIsProgram

Returns:
A non-zero value by which it can be referenced; zero if an error occurs.
See Also:
GL20.glAttachShader(int, int), GL20.glBindAttribLocation(int, int, String), GL20.glCreateShader(int), GL20.glDeleteProgram(int), GL20.glDetachShader(int, int), GL20.glLinkProgram(int), GL20.glUniform1f(int, float), GL20.glUniform1fv(int, int, FloatBuffer), GL20.glUniform1fv(int, int, float[], int), GL20.glUniform1i(int, int), GL20.glUniform1iv(int, int, IntBuffer), GL20.glUniform1iv(int, int, int[], int), GL20.glUniform2f(int, float, float), GL20.glUniform2fv(int, int, FloatBuffer), GL20.glUniform2fv(int, int, float[], int), GL20.glUniform2i(int, int, int), GL20.glUniform2iv(int, int, IntBuffer), GL20.glUniform2iv(int, int, int[], int), GL20.glUniform3f(int, float, float, float), GL20.glUniform3fv(int, int, FloatBuffer), GL20.glUniform3fv(int, int, float[], int), GL20.glUniform3i(int, int, int, int), GL20.glUniform3iv(int, int, IntBuffer), GL20.glUniform3iv(int, int, int[], int), GL20.glUniform4f(int, float, float, float, float), GL20.glUniform4fv(int, int, FloatBuffer), GL20.glUniform4fv(int, int, float[], int), GL20.glUniform4i(int, int, int, int, int), GL20.glUniform4iv(int, int, IntBuffer), GL20.glUniform4iv(int, int, int[], int), GL20.glUniformMatrix2fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix2fv(int, int, boolean, float[], int), GL20.glUniformMatrix3fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix3fv(int, int, boolean, float[], int), GL20.glUniformMatrix4fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix4fv(int, int, boolean, float[], int), GL20.glUseProgram(int), GL20.glValidateProgram(int)
Since:
BlackBerry API 7.0.0

glCreateShader

int glCreateShader(int type)
Create a shader object.

glCreateShader creates an empty shader object and returns a non-zero value by which it can be referenced. A shader object is used to maintain the source code strings that define a shader. shaderType indicates the type of shader to be created. Two types of shaders are supported. A shader of type GL_VERTEX_SHADER is a shader that is intended to run on the programmable vertex processor. A shader of type GL_FRAGMENT_SHADER is a shader that is intended to run on the programmable fragment processor.

When created, a shader object's GL_SHADER_TYPE parameter is set to either GL_VERTEX_SHADER or GL_FRAGMENT_SHADER, depending on the value of shaderType.

Notes

Like texture objects, the name space for shader objects may be shared across a set of contexts, as long as the server sides of the contexts share the same address space. If the name space is shared across contexts, any attached objects and the data associated with those attached objects are shared as well.

Applications are responsible for providing the synchronization across API calls when objects are accessed from different execution threads.

Errors

This function returns 0 if an error occurs creating the shader object.

GL_INVALID_ENUM is generated if shaderType is not an accepted value.

Associated Gets

glGetShaderiv/glGetShaderiv with a valid shader object and the parameter to be queried

glGetShaderInfoLog with a valid shader object

glGetShaderSource with a valid shader object

glIsShader

Parameters:
type - Specifies the type of shader to be created. Must be either GL_VERTEX_SHADER or GL_FRAGMENT_SHADER.
Returns:
A non-zero value by which it can be referenced; zero if an error occurs.
See Also:
GL20.glAttachShader(int, int), GL20.glCompileShader(int), GL20.glDeleteShader(int), GL20.glDetachShader(int, int), GL20.glShaderSource(int, int, String[], int[]), GL20.glShaderBinary(int, IntBuffer, int, Buffer, int), GL20.glShaderBinary(int, int[], int, int, Buffer, int)
Since:
BlackBerry API 7.0.0

glCullFace

void glCullFace(int mode)
Specify whether front- or back-facing facets can be culled.

Description

glCullFace specifies whether front- or back-facing facets are culled (as specified by mode) when facet culling is enabled. Facet culling is initially disabled. To enable and disable facet culling, call the glEnable and glDisable commands with the argument GL_CULL_FACE. Facets include triangles, quadrilaterals, polygons, and rectangles.

glFrontFace specifies which of the clockwise and counterclockwise facets are front-facing and back-facing. See glFrontFace.

Notes

If mode is GL_FRONT_AND_BACK, no facets are drawn, but other primitives such as points and lines are drawn.

Errors

GL_INVALID_ENUM is generated if mode is not an accepted value.

Associated Gets

glIsEnabled with argument GL_CULL_FACE

glGetIntegerv/glGetIntegerv with argument GL_CULL_FACE_MODE

Parameters:
mode - Specifies whether front- or back-facing facets are candidates for culling. Symbolic constants GL_FRONT, GL_BACK, and GL_FRONT_AND_BACK are accepted. The initial value is GL_BACK.
See Also:
GL20.glEnable(int), GL20.glFrontFace(int)
Since:
BlackBerry API 7.0.0

glDeleteBuffers

void glDeleteBuffers(int n,
                     int[] buffers,
                     int offset)
Delete named buffer objects.

Description

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 (for example by glGenBuffers/glGenBuffers). If a buffer object that is currently bound is deleted, the binding reverts to 0 (the absence of any buffer object, which reverts to client memory usage).

glDeleteBuffers silently ignores 0's and names that do not correspond to existing buffer objects.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsBuffer

Parameters:
n - Specifies the number of buffer objects to be deleted.
buffers - Specifies an array of buffer objects to be deleted.
offset - The starting offset within the buffers array.
Throws:
IllegalArgumentException - If buffers is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If buffers.length - offset is less than n.
See Also:
GL20.glBindBuffer(int, int), GL20.glDeleteBuffers(int, int[], int), GL20.glGenBuffers(int, IntBuffer), GL20.glGenBuffers(int, int[], int), GL20.glIsBuffer(int)
Since:
BlackBerry API 7.0.0

glDeleteBuffers

void glDeleteBuffers(int n,
                     IntBuffer buffers)
Integer Buffer version of glDeleteBuffers.

Errors

GL_INVALID_VALUE is generated if n is negative.

Parameters:
n - Specifies the number of buffer objects to be deleted.
buffers - Specifies the buffer objects to be deleted.
Throws:
IllegalArgumentException - If buffers is null.
IllegalArgumentException - If buffers.remaining() is less than n.
See Also:
GL20.glDeleteBuffers(int, IntBuffer)
Since:
BlackBerry API 7.0.0

glDeleteFramebuffers

void glDeleteFramebuffers(int n,
                          int[] framebuffers,
                          int offset)
Delete named framebuffer objects.

Description

glDeleteFramebuffers deletes n framebuffer objects named by the elements of the array framebuffers. After a framebuffer object is deleted, it has no attachments, and its name is free for reuse (for example by glGenFramebuffers/ glGenFramebuffers). If a framebuffer object that is currently bound is deleted, the binding reverts to 0 (the window-system-provided framebuffer).

glDeleteFramebuffers silently ignores 0's and names that do not correspond to existing framebuffer objects.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsFramebuffer

Parameters:
n - Specifies the number of framebuffer objects to be deleted.
framebuffers - Specifies an array of framebuffer objects to be deleted.
offset - The starting offset within the framebuffers array.
Throws:
IllegalArgumentException - If framebuffers is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If framebuffers.length - offset is less than n.
See Also:
GL20.glBindFramebuffer(int, int), GL20.glDeleteFramebuffers(int, IntBuffer), GL20.glGenFramebuffers(int, IntBuffer), GL20.glGenFramebuffers(int, int[], int), GL20.glIsFramebuffer(int)
Since:
BlackBerry API 7.0.0

glDeleteFramebuffers

void glDeleteFramebuffers(int n,
                          IntBuffer framebuffers)
Integer Buffer version of glDeleteFramebuffers.

Errors

GL_INVALID_VALUE is generated if n is negative.

Parameters:
n - Specifies the number of framebuffer objects to be deleted.
framebuffers - Specifies the framebuffer objects to be deleted.
Throws:
IllegalArgumentException - If framebuffers is null.
IllegalArgumentException - If framebuffers.remaining() is less than n.
See Also:
GL20.glDeleteFramebuffers(int, int[], int)
Since:
BlackBerry API 7.0.0

glDeleteProgram

void glDeleteProgram(int program)
Delete a program object.

Description

glDeleteProgram frees the memory and invalidates the name associated with the program object specified by program. This command effectively undoes the effects of a call to glCreateProgram.

If a program object is in use as part of current rendering state, it will be flagged for deletion, but it will not be deleted until it is no longer part of current state for any rendering context. If a program object to be deleted has shader objects attached to it, those shader objects will be automatically detached but not deleted unless they have already been flagged for deletion by a previous call to glDeleteShader. A value of 0 for program will be silently ignored.

To determine whether a program object has been flagged for deletion, call glGetProgramiv/ glGetProgramiv with arguments program and GL_DELETE_STATUS.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_CURRENT_PROGRAM

glGetProgramiv/ glGetProgramiv with arguments program and GL_DELETE_STATUS

glIsProgram

Parameters:
program - Specifies the program object to be deleted.
See Also:
GL20.glCreateShader(int), GL20.glDetachShader(int, int), GL20.glUseProgram(int)
Since:
BlackBerry API 7.0.0

glDeleteRenderbuffers

void glDeleteRenderbuffers(int n,
                           int[] renderbuffers,
                           int offset)
Delete named renderbuffer objects

Description

glDeleteRenderbuffers deletes n renderbuffer objects named by the elements of the array renderbuffers. After a renderbuffer object is deleted, it has no contents, and its name is free for reuse (for example by glGenRenderBuffers/ glGenRenderbuffers).

If a renderbuffer object that is currently bound is deleted, the binding reverts to 0 (the absence of any renderbuffer object). Additionally, special care must be taken when deleting a renderbuffer object if the image of the renderbuffer is attached to a framebuffer object. In this case, if the deleted renderbuffer object is attached to the currently bound framebuffer object, it is automatically detached. However, attachments to any other framebuffer objects are the responsibility of the application.

glDeleteRenderbuffers silently ignores 0's and names that do not correspond to existing renderbuffer objects.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsRenderbuffer

Parameters:
n - Specifies the number of renderbuffer objects to be deleted.
renderbuffers - Specifies an array of renderbuffer objects to be deleted.
offset - The starting offset within the renderbuffers array.
Throws:
IllegalArgumentException - If renderbuffers is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If renderbuffers.length - offset is less than n.
See Also:
GL20.glBindRenderbuffer(int, int), GL20.glDeleteRenderbuffers(int, IntBuffer), GL20.glGenRenderbuffers(int, IntBuffer), GL20.glGenRenderbuffers(int, int[], int), GL20.glIsRenderbuffer(int)
Since:
BlackBerry API 7.0.0

glDeleteRenderbuffers

void glDeleteRenderbuffers(int n,
                           IntBuffer renderbuffers)
Integer Buffer version of glDeleteRenderbuffers.

Errors

GL_INVALID_VALUE is generated if n is negative.

Parameters:
n - Specifies the number of renderbuffer objects to be deleted.
renderbuffers - Specifies the renderbuffer objects to be deleted.
Throws:
IllegalArgumentException - If framebuffers is null.
IllegalArgumentException - If framebuffers.remaining() is less than n.
See Also:
GL20.glDeleteRenderbuffers(int, int[], int)
Since:
BlackBerry API 7.0.0

glDeleteShader

void glDeleteShader(int shader)
Delete a shader object.

Description

glDeleteShader frees the memory and invalidates the name associated with the shader object specified by shader. This command effectively undoes the effects of a call to glCreateShader.

If a shader object to be deleted is attached to a program object, it will be flagged for deletion, but it will not be deleted until it is no longer attached to any program object, for any rendering context (i.e., it must be detached from wherever it was attached before it will be deleted). A value of 0 for shader will be silently ignored.

To determine whether an object has been flagged for deletion, call glGetShaderiv/ glGetShaderiv with arguments shader and GL_DELETE_STATUS.

Errors

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

Associated Gets

glGetAttachedShaders/ glGetAttachedShaders with the program object to be queried

glGetShaderiv/ glGetShaderiv with arguments shader and GL_DELETE_STATUS

glIsShader

Parameters:
shader - Specifies the shader object to be deleted.
See Also:
GL20.glCreateProgram(), GL20.glCreateShader(int), GL20.glDetachShader(int, int), GL20.glUseProgram(int)
Since:
BlackBerry API 7.0.0

glDeleteTextures

void glDeleteTextures(int n,
                      int[] textures,
                      int offset)
Delete named textures.

Description

glDeleteTextures deletes n textures named by the elements of the array textures. After a texture is deleted, it has no contents or dimensionality, and its name is free for reuse (for example by glGenTextures/ glGenTextures). If a texture that is currently bound is deleted, the binding reverts to 0 (the default texture).

glDeleteTextures silently ignores 0's and names that do not correspond to existing textures.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsTexture

Parameters:
n - Specifies the number of textures to be deleted.
textures - Specifies an array of textures to be deleted.
offset - The starting offset within the textures array.
Throws:
IllegalArgumentException - If textures is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If textures.length - offset is less than n.
See Also:
GL20.glBindTexture(int, int), GL20.glDeleteTextures(int, IntBuffer), GL20.glGenTextures(int, IntBuffer), GL20.glGenTextures(int, int[], int), GL20.glIsTexture(int)
Since:
BlackBerry API 7.0.0

glDeleteTextures

void glDeleteTextures(int n,
                      IntBuffer textures)
Integer Buffer version of glDeleteTextures.

Errors

GL_INVALID_VALUE is generated if n is negative.

Parameters:
n - Specifies the number of textures to be deleted.
textures - Specifies the textures to be deleted.
Throws:
IllegalArgumentException - If textures is null.
IllegalArgumentException - If textures.remaining() is less than n.
See Also:
GL20.glDeleteTextures(int, int[], int)
Since:
BlackBerry API 7.0.0

glDepthFunc

void glDepthFunc(int func)
Specify the value used for depth buffer comparisons.

Description

glDepthFunc specifies the function used to compare each incoming pixel depth value with the depth value present in the depth buffer. The comparison is performed only if depth testing is enabled. (See glEnable and glDisable of GL_DEPTH_TEST.)

func specifies the conditions under which the pixel will be drawn. The comparison functions are as follows:

GL_NEVER

Never passes.

GL_LESS

Passes if the incoming depth value is less than the stored depth value.

GL_EQUAL

Passes if the incoming depth value is equal to the stored depth value.

GL_LEQUAL

Passes if the incoming depth value is less than or equal to the stored depth value.

GL_GREATER

Passes if the incoming depth value is greater than the stored depth value.

GL_NOTEQUAL

Passes if the incoming depth value is not equal to the stored depth value.

GL_GEQUAL

Passes if the incoming depth value is greater than or equal to the stored depth value.

GL_ALWAYS

Always passes.

The initial value of func is GL_LESS. Initially, depth testing is disabled. If depth testing is disabled or no depth buffer exists, it is as if the depth test always passes.

Notes

Even if the depth buffer exists and the depth mask is non-zero, the depth buffer is not updated if the depth test is disabled.

Errors

GL_INVALID_ENUM is generated if func is not an accepted value.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_DEPTH_FUNC

glIsEnabled with argument GL_DEPTH_TEST

Parameters:
func - Specifies the depth comparison function. Symbolic constants GL_NEVER, GL_LESS, GL_EQUAL, GL_LEQUAL, GL_GREATER, GL_NOTEQUAL, GL_GEQUAL, and GL_ALWAYS are accepted. The initial value is GL_LESS.
See Also:
GL20.glDepthRangef(float, float), GL20.glEnable(int), GL20.glPolygonOffset(float, float)
Since:
BlackBerry API 7.0.0

glDepthMask

void glDepthMask(boolean flag)
Enable or disable writing into the depth buffer.

Description

glDepthMask specifies whether the depth buffer is enabled for writing. If flag is GL_FALSE, depth buffer writing is disabled. Otherwise, it is enabled. Initially, depth buffer writing is enabled.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_DEPTH_WRITEMASK

Parameters:
flag - Specifies whether the depth buffer is enabled for writing. If flag is GL_FALSE, depth buffer writing is disabled. Otherwise, it is enabled. Initially, depth buffer writing is enabled.
See Also:
GL20.glColorMask(boolean, boolean, boolean, boolean), GL20.glDepthFunc(int), GL20.glDepthRangef(float, float), GL20.glStencilMask(int)
Since:
BlackBerry API 7.0.0

glDepthRangef

void glDepthRangef(float zNear,
                   float zFar)
Specify mapping of depth values from normalized device coordinates to window coordinates.

Description

After clipping and division by w, depth coordinates range from -1 to 1, corresponding to the near and far clipping planes. glDepthRangef specifies a linear mapping of the normalized depth coordinates in this range to window depth coordinates. Regardless of the actual depth buffer implementation, window coordinate depth values are treated as though they range from 0 through 1 (like color components). Thus, the values accepted by glDepthRangef are both clamped to this range before they are accepted.

The setting of (0,1) maps the near plane to 0 and the far plane to 1. With this mapping, the depth buffer range is fully utilized.

Notes

It is not necessary that nearVal be less than farVal. Reverse mappings such as nearVal = 1, and farVal = 0 are acceptable.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_DEPTH_RANGE

Parameters:
zNear - Specifies the mapping of the near clipping plane to window coordinates. The initial value is 0.
zFar - Specifies the mapping of the far clipping plane to window coordinates. The initial value is 1.
See Also:
GL20.glDepthFunc(int), GL20.glPolygonOffset(float, float), GL20.glViewport(int, int, int, int)
Since:
BlackBerry API 7.0.0

glDetachShader

void glDetachShader(int program,
                    int shader)
Detach a shader object from a program object.

Description

glDetachShader detaches the shader object specified by shader from the program object specified by program. This command can be used to undo the effect of the command glAttachShader.

If shader has already been flagged for deletion by a call to glDeleteShader and it is not attached to any other program object, it will be deleted after it has been detached.

Errors

GL_INVALID_VALUE is generated if either program or shader is a value that was not generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_OPERATION is generated if shader is not a shader object.

GL_INVALID_OPERATION is generated if shader is not attached to program.

Associated Gets

glGetAttachedShaders/ glGetAttachedShaders with the handle of a valid program object

glGetShaderiv/ glGetShaderiv with arguments shader and GL_DELETE_STATUS

glIsProgram

glIsShader

Parameters:
program - Specifies the program object from which to detach the shader object.
shader - Specifies the shader object to be detached.
See Also:
GL20.glAttachShader(int, int)
Since:
BlackBerry API 7.0.0

glDisable

void glDisable(int cap)
Disable server-side GL capabilities.

Description

glDisable disables various capabilities. Use glIsEnabled or glGetBooleanv/glGetBooleanv to determine the current setting of any capability. The initial value for each capability with the exception of GL_DITHER is GL_FALSE. The initial value for GL_DITHER is GL_TRUE.

cap can assume one of the following values:

GL_BLEND

If enabled, blend the computed fragment color values with the values in the color buffers. See glBlendFunc.

GL_CULL_FACE

If enabled, cull polygons based on their winding in window coordinates. See glCullFace.

GL_DEPTH_TEST

If enabled, do depth comparisons and update the depth buffer. Note that even if the depth buffer exists and the depth mask is non-zero, the depth buffer is not updated if the depth test is disabled. See glDepthFunc and glDepthRangef.

GL_DITHER

If enabled, dither color components or indices before they are written to the color buffer.

GL_POLYGON_OFFSET_FILL

If enabled, an offset is added to depth values of a polygon's fragments produced by rasterization. See glPolygonOffset.

GL_SAMPLE_ALPHA_TO_COVERAGE

If enabled, compute a temporary coverage value where each bit is determined by the alpha value at the corresponding sample location. The temporary coverage value is then ANDed with the fragment coverage value.

GL_SAMPLE_COVERAGE

If enabled, the fragment's coverage is ANDed with the temporary coverage value. If GL_SAMPLE_COVERAGE_INVERT is set to GL_TRUE, invert the coverage value. See glSampleCoverage.

GL_SCISSOR_TEST

If enabled, discard fragments that are outside the scissor rectangle. See glScissor.

GL_STENCIL_TEST

If enabled, do stencil testing and update the stencil buffer. See glStencilFunc and glStencilOp.

Errors

GL_INVALID_ENUM is generated if cap is not one of the values listed previously.

Associated Gets

glIsEnabled

glGetBooleanv/glGetBooleanv

Parameters:
cap - Specifies a symbolic constant indicating a GL capability.
See Also:
GL20.glActiveTexture(int), GL20.glBlendFunc(int, int), GL20.glCullFace(int), GL20.glDepthFunc(int), GL20.glDepthRangef(float, float), GL20.glGetBooleanv(int, IntBuffer), GL20.glGetBooleanv(int, boolean[], int), GL20.glIsEnabled(int), GL20.glLineWidth(float), GL20.glPolygonOffset(float, float), GL20.glScissor(int, int, int, int), GL20.glStencilFunc(int, int, int), GL20.glStencilOp(int, int, int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer)
Since:
BlackBerry API 7.0.0

glDisableVertexAttribArray

void glDisableVertexAttribArray(int index)
Disable a generic vertex attribute array.

Description

glDisableVertexAttribArray disables the generic vertex attribute array specified by index. By default, all client-side capabilities are disabled, including all generic vertex attribute arrays. If enabled, the values in the generic vertex attribute array will be accessed and used for rendering when calls are made to vertex array commands such as glDrawArrays or glDrawElements/glDrawElements.

Errors

GL_INVALID_VALUE is generated if index is greater than or equal to GL_MAX_VERTEX_ATTRIBS.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_VERTEX_ATTRIBS

glGetVertexAttrib/ glGetVertexAttrib/ glGetVertexAttrib/ glGetVertexAttrib with arguments index and GL_VERTEX_ATTRIB_ARRAY_ENABLED

Parameters:
index - Specifies the index of the generic vertex attribute to be disabled.
See Also:
GL20.glBindAttribLocation(int, int, String), GL20.glDrawArrays(int, int, int), GL20.glDrawElements(int, int, int, Buffer), GL20.glDrawElements(int, int, int, int), GL20.glVertexAttrib1f(int, float), GL20.glVertexAttrib1fv(int, FloatBuffer), GL20.glVertexAttrib1fv(int, float[], int), GL20.glVertexAttrib2f(int, float, float), GL20.glVertexAttrib2fv(int, FloatBuffer), GL20.glVertexAttrib2fv(int, float[], int), GL20.glVertexAttrib3f(int, float, float, float), GL20.glVertexAttrib3fv(int, FloatBuffer), GL20.glVertexAttrib3fv(int, float[], int), GL20.glVertexAttrib4f(int, float, float, float, float), GL20.glVertexAttrib4fv(int, FloatBuffer), GL20.glVertexAttrib4fv(int, float[], int), GL20.glVertexAttribPointer(int, int, int, boolean, int, Buffer), GL20.glVertexAttribPointer(int, int, int, boolean, int, int)
Since:
BlackBerry API 7.0.0

glDrawArrays

void glDrawArrays(int mode,
                  int first,
                  int count)
Render primitives from array data.

Description

glDrawArrays specifies multiple geometric primitives with very few subroutine calls. Instead of calling a GL procedure to pass each individual vertex attribute, you can use glVertexAttribPointer/ glVertexAttribPointer to prespecify separate arrays of vertices, normals, and colors and use them to construct a sequence of primitives with a single call to glDrawArrays.

When glDrawArrays is called, it uses count sequential elements from each enabled array to construct a sequence of geometric primitives, beginning with element first. mode specifies what kind of primitives are constructed and how the array elements construct those primitives.

To enable and disable a generic vertex attribute array, call glEnableVertexAttribArray and glDisableVertexAttribArray.

Notes

If the current program object, as set by glUseProgram, is invalid, rendering results are undefined. However, no error is generated for this case.

Errors

GL_INVALID_ENUM is generated if mode is not an accepted value.

GL_INVALID_VALUE is generated if count is negative.

GL_INVALID_FRAMEBUFFER_OPERATION is generated if the currently bound framebuffer is not framebuffer complete (i.e. the return value from glCheckFramebufferStatus is not GL_FRAMEBUFFER_COMPLETE).

Parameters:
mode - Specifies what kind of primitives to render. Symbolic constants GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, and GL_TRIANGLES are accepted.
first - Specifies the starting index in the enabled arrays.
count - Specifies the number of indices to be rendered.
Throws:
ArrayIndexOutOfBoundsException - If any index in the sequence first, ..., first + count - 1 will result in a reference to an entry outside of the enabled generic vertex attribute data array(s).
See Also:
GL20.glCheckFramebufferStatus(int), GL20.glDisableVertexAttribArray(int), GL20.glDrawElements(int, int, int, Buffer), GL20.glDrawElements(int, int, int, int), GL20.glEnableVertexAttribArray(int), GL20.glUseProgram(int), GL20.glVertexAttribPointer(int, int, int, boolean, int, Buffer), GL20.glVertexAttribPointer(int, int, int, boolean, int, int)
Since:
BlackBerry API 7.0.0

glDrawElements

void glDrawElements(int mode,
                    int count,
                    int type,
                    Buffer indices)
Render primitives from array data.

Description

glDrawElements specifies multiple geometric primitives with very few subroutine calls. Instead of calling a GL function to pass each vertex attribute, you can use glVertexAttribPointer/ glVertexAttribPointer to prespecify separate arrays of vertex attributes and use them to construct a sequence of primitives with a single call to glDrawElements.

When glDrawElements is called, it uses count elements from an enabled array, accessing the elements specified by indices to construct a sequence of geometric primitives. mode specifies what kind of primitives are constructed and how the array elements construct these primitives. If more than one array is enabled, each is used.

To enable and disable a generic vertex attribute array, call glEnableVertexAttribArray and glDisableVertexAttribArray.

Notes

If the current program object, as set by glUseProgram, is invalid, rendering results are undefined. However, no error is generated for this case.

Errors

GL_INVALID_ENUM is generated if mode is not an accepted value.

GL_INVALID_ENUM is generated if type is not GL_UNSIGNED_BYTE or GL_UNSIGNED_SHORT.

GL_INVALID_VALUE is generated if count is negative.

GL_INVALID_FRAMEBUFFER_OPERATION is generated if the currently bound framebuffer is not framebuffer complete (i.e. the return value from glCheckFramebufferStatus is not GL_FRAMEBUFFER_COMPLETE).

Parameters:
mode - Specifies what kind of primitives to render. Symbolic constants GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, and GL_TRIANGLES are accepted.
count - Specifies the number of elements to be rendered.
type - Specifies the type of the values in indices. Must be GL_UNSIGNED_BYTE or GL_UNSIGNED_SHORT.
indices - Specifies the indices as a buffer.
Throws:
IllegalStateException - If the most recent call to glBindBuffer for the GL_ELEMENT_ARRAY_BUFFER target had a non-zero buffer parameter (i.e., an index buffer is bound).
IllegalArgumentException - If indices is null.
ArrayIndexOutOfBoundsException - If any index in the sequence of indices from 0 to count - 1 would result in a reference to an entry outside of the currently bound index array or the enabled generic vertex attribute data array(s).
See Also:
GL20.glCheckFramebufferStatus(int), GL20.glDisableVertexAttribArray(int), GL20.glDrawArrays(int, int, int), GL20.glDrawElements(int, int, int, int), GL20.glEnableVertexAttribArray(int), GL20.glUseProgram(int), GL20.glVertexAttribPointer(int, int, int, boolean, int, Buffer), GL20.glVertexAttribPointer(int, int, int, boolean, int, int)
Since:
BlackBerry API 7.0.0

glDrawElements

void glDrawElements(int mode,
                    int count,
                    int type,
                    int offset)
VBO version of glDrawElements.

Errors

GL_INVALID_ENUM is generated if mode is not an accepted value.

GL_INVALID_ENUM is generated if type is not GL_UNSIGNED_BYTE or GL_UNSIGNED_SHORT.

GL_INVALID_VALUE is generated if count is negative.

GL_INVALID_FRAMEBUFFER_OPERATION is generated if the currently bound framebuffer is not framebuffer complete (i.e. the return value from glCheckFramebufferStatus is not GL_FRAMEBUFFER_COMPLETE).

Parameters:
mode - Specifies what kind of primitives to render. Symbolic constants GL_POINTS, GL_LINE_STRIP, GL_LINE_LOOP, GL_LINES, GL_TRIANGLE_STRIP, GL_TRIANGLE_FAN, and GL_TRIANGLES are accepted.
count - Specifies the number of elements to be rendered.
type - Specifies the type of the values in currently bound index buffer. Must be GL_UNSIGNED_BYTE or GL_UNSIGNED_SHORT.
offset - Specifies the offset into the currently bound index buffer.
Throws:
IllegalStateException - If the most recent call to glBindBuffer for the GL_ELEMENT_ARRAY_BUFFER target had a buffer parameter of 0 (i.e., an index buffer is not bound).
ArrayIndexOutOfBoundsException - If any index in the sequence of indices from offset to offset + count - 1 would result in a reference to an entry outside of indices or the enabled generic vertex attribute data array(s), where indices refers to the set of values bound to the GL_ELEMENT_ARRAY_BUFFER target.
See Also:
GL20.glDrawElements(int, int, int, Buffer)
Since:
BlackBerry API 7.0.0

glEnable

void glEnable(int cap)
Enable server-side GL capabilities.

Description

glEnable enables various capabilities. Use glIsEnabled or glGetBooleanv/glGetBooleanv to determine the current setting of any capability. The initial value for each capability with the exception of GL_DITHER is GL_FALSE. The initial value for GL_DITHER is GL_TRUE.

cap can assume one of the following values:

GL_BLEND

If enabled, blend the computed fragment color values with the values in the color buffers. See glBlendFunc.

GL_CULL_FACE

If enabled, cull polygons based on their winding in window coordinates. See glCullFace.

GL_DEPTH_TEST

If enabled, do depth comparisons and update the depth buffer. Note that even if the depth buffer exists and the depth mask is non-zero, the depth buffer is not updated if the depth test is disabled. See glDepthFunc and glDepthRangef.

GL_DITHER

If enabled, dither color components or indices before they are written to the color buffer.

GL_POLYGON_OFFSET_FILL

If enabled, an offset is added to depth values of a polygon's fragments produced by rasterization. See glPolygonOffset.

GL_SAMPLE_ALPHA_TO_COVERAGE

If enabled, compute a temporary coverage value where each bit is determined by the alpha value at the corresponding sample location. The temporary coverage value is then ANDed with the fragment coverage value.

GL_SAMPLE_COVERAGE

If enabled, the fragment's coverage is ANDed with the temporary coverage value. If GL_SAMPLE_COVERAGE_INVERT is set to GL_TRUE, invert the coverage value. See glSampleCoverage.

GL_SCISSOR_TEST

If enabled, discard fragments that are outside the scissor rectangle. See glScissor.

GL_STENCIL_TEST

If enabled, do stencil testing and update the stencil buffer. See glStencilFunc and glStencilOp.

Errors

GL_INVALID_ENUM is generated if cap is not one of the values listed previously.

Associated Gets

glIsEnabled

glGetBooleanv/glGetBooleanv

Parameters:
cap - Specifies a symbolic constant indicating a GL capability.
See Also:
GL20.glActiveTexture(int), GL20.glBlendFunc(int, int), GL20.glCullFace(int), GL20.glDepthFunc(int), GL20.glDepthRangef(float, float), GL20.glGetBooleanv(int, IntBuffer), GL20.glGetBooleanv(int, boolean[], int), GL20.glIsEnabled(int), GL20.glLineWidth(float), GL20.glPolygonOffset(float, float), GL20.glScissor(int, int, int, int), GL20.glStencilFunc(int, int, int), GL20.glStencilOp(int, int, int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer)
Since:
BlackBerry API 7.0.0

glEnableVertexAttribArray

void glEnableVertexAttribArray(int index)
Enables a generic vertex attribute array.

Description

glEnableVertexAttribArray enables the generic vertex attribute array specified by index. By default, all client-side capabilities are disabled, including all generic vertex attribute arrays. If enabled, the values in the generic vertex attribute array will be accessed and used for rendering when calls are made to vertex array commands such as glDrawArrays or glDrawElements/glDrawElements.

Errors

GL_INVALID_VALUE is generated if index is greater than or equal to GL_MAX_VERTEX_ATTRIBS.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_VERTEX_ATTRIBS

glGetVertexAttrib/ glGetVertexAttrib/ glGetVertexAttrib/ glGetVertexAttrib with arguments index and GL_VERTEX_ATTRIB_ARRAY_ENABLED

Parameters:
index - Specifies the index of the generic vertex attribute to be enabled.
See Also:
GL20.glBindAttribLocation(int, int, String), GL20.glDrawArrays(int, int, int), GL20.glDrawElements(int, int, int, Buffer), GL20.glDrawElements(int, int, int, int), GL20.glVertexAttrib1f(int, float), GL20.glVertexAttrib1fv(int, FloatBuffer), GL20.glVertexAttrib1fv(int, float[], int), GL20.glVertexAttrib2f(int, float, float), GL20.glVertexAttrib2fv(int, FloatBuffer), GL20.glVertexAttrib2fv(int, float[], int), GL20.glVertexAttrib3f(int, float, float, float), GL20.glVertexAttrib3fv(int, FloatBuffer), GL20.glVertexAttrib3fv(int, float[], int), GL20.glVertexAttrib4f(int, float, float, float, float), GL20.glVertexAttrib4fv(int, FloatBuffer), GL20.glVertexAttrib4fv(int, float[], int), GL20.glVertexAttribPointer(int, int, int, boolean, int, Buffer), GL20.glVertexAttribPointer(int, int, int, boolean, int, int)
Since:
BlackBerry API 7.0.0

glFinish

void glFinish()
Block until all GL execution is complete.

Description

glFinish does not return until the effects of all previously called GL commands are complete. Such effects include all changes to GL state, all changes to connection state, and all changes to the frame buffer contents.

Notes

glFinish requires a round trip to the server.

See Also:
GL20.glFlush()
Since:
BlackBerry API 7.0.0

glFlush

void glFlush()
Force execution of GL commands in finite time.

Description

Different GL implementations buffer commands in several different locations, including network buffers and the graphics accelerator itself. glFlush empties all of these buffers, causing all issued commands to be executed as quickly as they are accepted by the actual rendering engine. Though this execution may not be completed in any particular time period, it does complete in finite time.

Because any GL program might be executed over a network, or on an accelerator that buffers commands, all programs should call glFlush whenever they count on having all of their previously issued commands completed. For example, call glFlush before waiting for user input that depends on the generated image.

Notes

glFlush can return at any time. It does not wait until the execution of all previously issued GL commands is complete.

See Also:
GL20.glFinish()
Since:
BlackBerry API 7.0.0

glFramebufferRenderbuffer

void glFramebufferRenderbuffer(int target,
                               int attachment,
                               int renderbuffertarget,
                               int renderbuffer)
Attach a renderbuffer object to a framebuffer object.

Description

glFramebufferRenderbuffer attaches the renderbuffer specified by renderbuffer as one of the logical buffers of the currently bound framebuffer object. attachment specifies whether the renderbuffer should be attached to the framebuffer object's color, depth, or stencil buffer. A renderbuffer may not be attached to the default framebuffer object name 0.

If renderbuffer is not 0, the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE for the specified attachment point is set to GL_RENDERBUFFER and the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME is set to renderbuffer. GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL and GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE are set to the default values 0 and GL_TEXTURE_CUBE_MAP_POSITIVE_X, respectively. Any previous attachment to the attachment logical buffer of the currently bound framebuffer object is broken.

If renderbuffer is 0, the current image, if any, attached to the attachment logical buffer of the currently bound framebuffer object is detached. The value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is set to GL_NONE. The value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME is set to 0. GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL and GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE are set to the default values 0 and GL_TEXTURE_CUBE_MAP_POSITIVE_X, respectively.

Notes

If a renderbuffer object is deleted while its image is attached to the currently bound framebuffer, then it is as if glFramebufferRenderbuffer had been called with a renderbuffer of 0 for the attachment point to which this image was attached in the currently bound framebuffer object. In other words, the renderbuffer image is detached from the currently bound framebuffer. Note that the renderbuffer image is specifically not detached from any non-bound framebuffers. Detaching the image from any non-bound framebuffers is the responsibility of the application.

Errors

GL_INVALID_ENUM is generated if target is not GL_FRAMEBUFFER.

GL_INVALID_ENUM is generated if renderbuffertarget is not GL_RENDERBUFFER and renderbuffer is not 0.

GL_INVALID_ENUM is generated if attachment is not an accepted attachment point.

GL_INVALID_OPERATION is generated if the default framebuffer object name 0 is bound.

GL_INVALID_OPERATION is generated if renderbuffer is neither 0 nor the name of an existing renderbuffer object.

Associated Gets

glGetFramebufferAttachmentParameteriv/ glGetFramebufferAttachmentParameteriv

Parameters:
target - Specifies the framebuffer target. The symbolic constant must be GL_FRAMEBUFFER.
attachment - Specifies the attachment point to which renderbuffer should be attached. Must be one of the following symbolic constants: GL_COLOR_ATTACHMENT0, GL_DEPTH_ATTACHMENT, or GL_STENCIL_ATTACHMENT.
renderbuffertarget - Specifies the renderbuffer target. The symbolic constant must be GL_RENDERBUFFER.
renderbuffer - Specifies the renderbuffer object that is to be attached.
See Also:
GL20.glBindFramebuffer(int, int), GL20.glBindRenderbuffer(int, int), GL20.glCheckFramebufferStatus(int), GL20.glDeleteFramebuffers(int, IntBuffer), GL20.glDeleteFramebuffers(int, int[], int), GL20.glDeleteRenderbuffers(int, IntBuffer), GL20.glDeleteRenderbuffers(int, int[], int), GL20.glFramebufferTexture2D(int, int, int, int, int), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, IntBuffer), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, int[], int), GL20.glRenderbufferStorage(int, int, int, int)
Since:
BlackBerry API 7.0.0

glFramebufferTexture2D

void glFramebufferTexture2D(int target,
                            int attachment,
                            int textarget,
                            int texture,
                            int level)
Attach a texture image to a framebuffer object.

Description

glFramebufferTexture2D attaches the texture image specified by texture and level as one of the logical buffers of the currently bound framebuffer object. attachment specifies whether the texture image should be attached to the framebuffer object's color, depth, or stencil buffer. A texture image may not be attached to the default framebuffer object name 0.

If texture is not 0, the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE for the specified attachment point is set to GL_TEXTURE, the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME is set to texture, and the value of GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL is set to level. If texture is a cube map texture, the value of GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE is set to textarget; otherwise it is set to the default value GL_TEXTURE_CUBE_MAP_POSITIVE_X. Any previous attachment to the attachment logical buffer of the currently bound framebuffer object is broken.

If texture is 0, the current image, if any, attached to the attachment logical buffer of the currently bound framebuffer object is detached. The value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is set to GL_NONE. The value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME is set to 0. GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL and GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE are set to the default values 0 and GL_TEXTURE_CUBE_MAP_POSITIVE_X, respectively.

Notes

Special precautions need to be taken to avoid attaching a texture image to the currently bound framebuffer while the texture object is currently bound and potentially sampled by the current vertex or fragment shader. Doing so could lead to the creation of a "feedback loop" between the writing of pixels by rendering operations and the simultaneous reading of those same pixels when used as texels in the currently bound texture. In this scenario, the framebuffer will be considered framebuffer complete, but the values of fragments rendered while in this state will be undefined. The values of texture samples may be undefined as well.

If a texture object is deleted while its image is attached to the currently bound framebuffer, then it is as if glFramebufferTexture2D had been called with a texture of 0 for the attachment point to which this image was attached in the currently bound framebuffer object. In other words, the texture image is detached from the currently bound framebuffer. Note that the texture image is specifically not detached from any non-bound framebuffers. Detaching the image from any non-bound framebuffers is the responsibility of the application.

Errors

GL_INVALID_ENUM is generated if target is not GL_FRAMEBUFFER.

GL_INVALID_ENUM is generated if textarget is not an accepted texture target and texture is not 0.

GL_INVALID_ENUM is generated if attachment is not an accepted attachment point.

GL_INVALID_VALUE is generated if level is not 0 and texture is not 0.

GL_INVALID_OPERATION is generated if the default framebuffer object name 0 is bound.

GL_INVALID_OPERATION is generated if texture is neither 0 nor the name of an existing texture object.

GL_INVALID_OPERATION is generated if texture is the name of an existing two-dimensional texture object but textarget is not GL_TEXTURE_2D or if texture is the name of an existing cube map texture object but textarget is GL_TEXTURE_2D.

Associated Gets

glGetFramebufferAttachmentParameteriv/ glGetFramebufferAttachmentParameteriv

Parameters:
target - Specifies the framebuffer target. The symbolic constant must be GL_FRAMEBUFFER.
attachment - Specifies the attachment point to which an image from texture should be attached. Must be one of the following symbolic constants: GL_COLOR_ATTACHMENT0, GL_DEPTH_ATTACHMENT, or GL_STENCIL_ATTACHMENT.
textarget - Specifies the texture target. Must be one of the following symbolic constants: GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
texture - Specifies the texture object whose image is to be attached.
level - Specifies the mipmap level of the texture image to be attached, which must be 0.
See Also:
GL20.glBindFramebuffer(int, int), GL20.glBindTexture(int, int), GL20.glCheckFramebufferStatus(int), GL20.glDeleteFramebuffers(int, IntBuffer), GL20.glDeleteFramebuffers(int, int[], int), GL20.glDeleteTextures(int, IntBuffer), GL20.glDeleteTextures(int, int[], int), GL20.glFramebufferRenderbuffer(int, int, int, int), GL20.glGenerateMipmap(int), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, IntBuffer), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, int[], int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer)
Since:
BlackBerry API 7.0.0

glFrontFace

void glFrontFace(int mode)
Define front- and back-facing polygons.

Description

In a scene composed entirely of opaque closed surfaces, back-facing polygons are never visible. Eliminating these invisible polygons has the obvious benefit of speeding up the rendering of the image. To enable and disable elimination of back-facing polygons, call glEnable and glDisable with argument GL_CULL_FACE.

The projection of a polygon to window coordinates is said to have clockwise winding if an imaginary object following the path from its first vertex, its second vertex, and so on, to its last vertex, and finally back to its first vertex, moves in a clockwise direction about the interior of the polygon. The polygon's winding is said to be counterclockwise if the imaginary object following the same path moves in a counterclockwise direction about the interior of the polygon. glFrontFace specifies whether polygons with clockwise winding in window coordinates, or counterclockwise winding in window coordinates, are taken to be front-facing. Passing GL_CCW to mode selects counterclockwise polygons as front-facing; GL_CW selects clockwise polygons as front-facing. By default, counterclockwise polygons are taken to be front-facing.

Errors

GL_INVALID_ENUM is generated if mode is not an accepted value.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_FRONT_FACE

Parameters:
mode - Specifies the orientation of front-facing polygons. GL_CW and GL_CCW are accepted. The initial value is GL_CCW.
See Also:
GL20.glCullFace(int)
Since:
BlackBerry API 7.0.0

glGenBuffers

void glGenBuffers(int n,
                  int[] buffers,
                  int offset)
Generate buffer object names.

Description

glGenBuffers returns n buffer object names in buffers. There is no guarantee that the names form a contiguous set of integers; however, it is guaranteed that none of the returned names was in use immediately before the call to glGenBuffers.

Buffer object names returned by a call to glGenBuffers are not returned by subsequent calls, unless they are first deleted with glDeleteBuffers/ glDeleteBuffers.

No buffer objects are associated with the returned buffer object names until they are first bound by calling glBindBuffer.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsBuffer

Parameters:
n - Specifies the number of buffer object names to be generated.
buffers - Specifies an array in which the generated buffer object names are stored.
offset - The starting offset within the buffers array.
Throws:
IllegalArgumentException - If buffers is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If buffers.length - offset is less than n.
See Also:
GL20.glBindBuffer(int, int), GL20.glDeleteBuffers(int, IntBuffer), GL20.glDeleteBuffers(int, int[], int), GL20.glGenBuffers(int, IntBuffer), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int)
Since:
BlackBerry API 7.0.0

glGenBuffers

void glGenBuffers(int n,
                  IntBuffer buffers)
Integer Buffer version of glGenBuffers.

Errors

GL_INVALID_VALUE is generated if n is negative.

Parameters:
n - Specifies the number of buffer object names to be generated.
buffers - Specifies a buffer in which the generated buffer object names are stored.
Throws:
IllegalArgumentException - If buffers is null.
IllegalArgumentException - If buffers.remaining() is less than n.
See Also:
GL20.glGenBuffers(int, int[], int)
Since:
BlackBerry API 7.0.0

glGenFramebuffers

void glGenFramebuffers(int n,
                       int[] framebuffers,
                       int offset)
Generate framebuffer object names

Description

glGenFramebuffers returns n framebuffer object names in framebuffers. There is no guarantee that the names form a contiguous set of integers; however, it is guaranteed that none of the returned names was in use immediately before the call to glGenFramebuffers.

Framebuffer object names returned by a call to glGenFramebuffers are not returned by subsequent calls, unless they are first deleted with glDeleteFramebuffers/ glDeleteFramebuffers.

No framebuffer objects are associated with the returned framebuffer object names until they are first bound by calling glBindFramebuffer.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsFramebuffer

Parameters:
n - Specifies the number of framebuffer object names to be generated.
framebuffers - Specifies an array in which the generated framebuffer object names are stored.
offset - The starting offset within the framebuffers array.
Throws:
IllegalArgumentException - If framebuffers is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If framebuffers.length - offset is less than n.
See Also:
GL20.glBindFramebuffer(int, int), GL20.glDeleteFramebuffers(int, IntBuffer), GL20.glDeleteFramebuffers(int, int[], int), GL20.glGenFramebuffers(int, IntBuffer), GL20.glIsFramebuffer(int)
Since:
BlackBerry API 7.0.0

glGenFramebuffers

void glGenFramebuffers(int n,
                       IntBuffer framebuffers)
Integer Buffer version of glGenBuffers.

Errors

GL_INVALID_VALUE is generated if n is negative.

Parameters:
n - Specifies the number of framebuffer object names to be generated.
framebuffers - Specifies the buffer in which the generated framebuffer object names are stored.
Throws:
IllegalArgumentException - If framebuffers is null.
IllegalArgumentException - If framebuffers.remaining() is less than n.
See Also:
GL20.glGenFramebuffers(int, int[], int)
Since:
BlackBerry API 7.0.0

glGenRenderbuffers

void glGenRenderbuffers(int n,
                        int[] renderbuffers,
                        int offset)
Generate renderbuffer object names.

Description

glGenRenderbuffers returns n renderbuffer object names in renderbuffers. There is no guarantee that the names form a contiguous set of integers; however, it is guaranteed that none of the returned names was in use immediately before the call to glGenRenderbuffers.

Renderbuffer object names returned by a call to glGenRenderbuffers are not returned by subsequent calls, unless they are first deleted with glDeleteRenderbuffers/ glDeleteRenderbuffers.

No renderbuffer objects are associated with the returned renderbuffer object names until they are first bound by calling glBindRenderbuffer.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsRenderbuffer

Parameters:
n - Specifies the number of renderbuffer object names to be generated.
renderbuffers - Specifies an array in which the generated renderbuffer object names are stored.
offset - The starting offset within the renderbuffers array.
Throws:
IllegalArgumentException - If renderbuffers is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If renderbuffers.length - offset is less than n.
See Also:
GL20.glBindRenderbuffer(int, int), GL20.glDeleteRenderbuffers(int, IntBuffer), GL20.glDeleteRenderbuffers(int, int[], int), GL20.glGenRenderbuffers(int, IntBuffer), GL20.glIsRenderbuffer(int)
Since:
BlackBerry API 7.0.0

glGenRenderbuffers

void glGenRenderbuffers(int n,
                        IntBuffer renderbuffers)
Integer Buffer version of glGenRenderbuffers.

Errors

GL_INVALID_VALUE is generated if n is negative.

Parameters:
n - Specifies Specifies the number of renderbuffer object names to be generated.
renderbuffers - Specifies the buffer in which the generated renderbuffer object names are stored.
Throws:
IllegalArgumentException - If renderbuffers is null.
IllegalArgumentException - If renderbuffers.remaining() is less than n.
See Also:
GL20.glGenRenderbuffers(int, int[], int)
Since:
BlackBerry API 7.0.0

glGenTextures

void glGenTextures(int n,
                   int[] textures,
                   int offset)
Generate texture names.

Description

glGenTextures returns n texture names in textures. There is no guarantee that the names form a contiguous set of integers; however, it is guaranteed that none of the returned names was in use immediately before the call to glGenTextures.

The generated textures have no dimensionality; they assume the dimensionality of the texture target to which they are first bound (see glBindTexture).

Texture names returned by a call to glGenTextures are not returned by subsequent calls, unless they are first deleted with glDeleteTextures/glDeleteTextures.

Errors

GL_INVALID_VALUE is generated if n is negative.

Associated Gets

glIsTexture

Parameters:
n - Specifies the number of texture names to be generated.
textures - Specifies an array in which the generated texture names are stored.
offset - The starting offset within the textures array.
Throws:
IllegalArgumentException - If textures is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If textures.length - offset is less than n.
See Also:
GL20.glBindTexture(int, int), GL20.glCopyTexImage2D(int, int, int, int, int, int, int, int), GL20.glDeleteTextures(int, IntBuffer), GL20.glDeleteTextures(int, int[], int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int), GL20.glGetTexParameterfv(int, int, float[], int), GL20.glGetTexParameterfv(int, int, FloatBuffer), GL20.glGetTexParameteriv(int, int, int[], int), GL20.glGetTexParameteriv(int, int, IntBuffer), GL20.glGenTextures(int, IntBuffer), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGenTextures

void glGenTextures(int n,
                   IntBuffer textures)
Integer Buffer version of glGenTextures.

Errors

GL_INVALID_VALUE is generated if n is negative.

Parameters:
n - Specifies the number of texture names to be generated.
textures - Specifies the buffer in which the generated texture names are stored.
Throws:
IllegalArgumentException - If textures is null.
IllegalArgumentException - If textures.remaining() is less than n.
See Also:
GL20.glGenTextures(int, int[], int)
Since:
BlackBerry API 7.0.0

glGenerateMipmap

void glGenerateMipmap(int target)
Generate a complete set of mipmaps for a texture object.

Description

glGenerateMipmap computes a complete set of mipmap arrays derived from the zero level array. Array levels up to and including the 1x1 dimension texture image are replaced with the derived arrays, regardless of previous contents. The zero level texture image is left unchanged.

The internal formats of the derived mipmap arrays all match those of the zero level texture image. The dimensions of the derived arrays are computed by halving the width and height of the zero level texture image, then in turn halving the dimensions of each array level until the 1x1 dimension texture image is reached.

The contents of the derived arrays are computed by repeated filtered reduction of the zero level array. No particular filter algorithm is required, though a box filter is recommended. glHint may be called to express a preference for speed or quality of filtering.

Errors

GL_INVALID_ENUM is generated if target is not GL_TEXTURE_2D or GL_TEXTURE_CUBE_MAP.

GL_INVALID_OPERATION is generated if the texture bound to target is a cube map, but its six faces do not share indentical widths, heights, formats, and types.

GL_INVALID_OPERATION is generated if either the width or height of the zero level array is not a power of two.

GL_INVALID_OPERATION is generated if the zero level array is stored in a compressed internal format.

Parameters:
target - Specifies the texture target of the texture object whose mipmaps will be generated. Must be one of the following symbolic constants: GL_TEXTURE_2D or GL_TEXTURE_CUBE_MAP.
See Also:
GL20.glBindTexture(int, int), GL20.glFramebufferTexture2D(int, int, int, int, int), GL20.glHint(int, int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetActiveAttrib

String glGetActiveAttrib(int program,
                         int index,
                         int[] size,
                         int sizeOffset,
                         int[] type,
                         int typeOffset)
Return information about an active attribute variable.

Description

glGetActiveAttrib returns information about an active attribute variable in the program object specified by program. The number of active attributes can be obtained by calling glGetProgramiv/ glGetProgramiv with the value GL_ACTIVE_ATTRIBUTES. A value of 0 for index selects the first active attribute variable. Permissible values for index range from 0 to the number of active attribute variables minus 1.

Attribute variables have arbitrary names and obtain their values through numbered generic vertex attributes. An attribute variable is considered active if it is determined during the link operation that it may be accessed during program execution. Therefore, program should have previously been the target of a call to glLinkProgram, but it is not necessary for it to have been linked successfully.

glGetActiveAttrib returns the name of the attribute variable indicated by index.

The type argument will return the attribute variable's data type. The symbolic constants GL_FLOAT, GL_FLOAT_VEC2, GL_FLOAT_VEC3, GL_FLOAT_VEC4, GL_FLOAT_MAT2, GL_FLOAT_MAT3, or GL_FLOAT_MAT4 may be returned. The size argument will return the size of the attribute, in units of the type returned in type.

This function will return as much information as it can about the specified active attribute variable. If no information is available then an empty string wil be returned. This situation could occur if this function is called after a link operation that failed. If an error occurs, the return values size and type will be unmodified and an empty string will be returned.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_VALUE is generated if index is greater than or equal to the number of active attribute variables in program.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_VERTEX_ATTRIBS.

glGetProgramiv/ glGetProgramiv with argument GL_ACTIVE_ATTRIBUTES or GL_ACTIVE_ATTRIBUTE_MAX_LENGTH.

glIsProgram

Parameters:
program - Specifies the program object to be queried.
index - Specifies the index of the attribute variable to be queried.
size - An int array of length at least 1. Returns the size of the attribute variable. May be null.
sizeOffset - The starting offset within the size array.
type - An int array of length at least 1. Returns the data type of the attribute variable. May be null.
typeOffset - The starting offset within the type array.
Returns:
A String containing the name of the attribute variable.
Throws:
IllegalArgumentException - If size is non-null but size.length - sizeOffset is smaller than 1.
IllegalArgumentException - If sizeOffset is less than 0.
IllegalArgumentException - If type is non-null but type.length - typeOffset is smaller than 1.
IllegalArgumentException - If typeOffset is less than 0.
See Also:
GL20.glGetActiveAttrib(int, int, int, int[], int, int[], int, int[], int, byte[], int), GL20.glBindAttribLocation(int, int, String), GL20.glGetActiveUniform(int, int, int[], int, int[], int), GL20.glLinkProgram(int), GL20.glVertexAttrib1f(int, float), GL20.glVertexAttrib1fv(int, FloatBuffer), GL20.glVertexAttrib1fv(int, float[], int), GL20.glVertexAttrib2f(int, float, float), GL20.glVertexAttrib2fv(int, FloatBuffer), GL20.glVertexAttrib2fv(int, float[], int), GL20.glVertexAttrib3f(int, float, float, float), GL20.glVertexAttrib3fv(int, FloatBuffer), GL20.glVertexAttrib3fv(int, float[], int), GL20.glVertexAttrib4f(int, float, float, float, float), GL20.glVertexAttrib4fv(int, FloatBuffer), GL20.glVertexAttrib4fv(int, float[], int), GL20.glVertexAttribPointer(int, int, int, boolean, int, Buffer), GL20.glVertexAttribPointer(int, int, int, boolean, int, int)
Since:
BlackBerry API 7.0.0

glGetActiveAttrib

void glGetActiveAttrib(int program,
                       int index,
                       int bufSize,
                       int[] length,
                       int lengthOffset,
                       int[] size,
                       int sizeOffset,
                       int[] type,
                       int typeOffset,
                       byte[] name,
                       int nameOffset)
Return information about an active attribute variable.

Description

glGetActiveAttrib returns information about an active attribute variable in the program object specified by program. The number of active attributes can be obtained by calling glGetProgramiv/ glGetProgramiv with the value GL_ACTIVE_ATTRIBUTES. A value of 0 for index selects the first active attribute variable. Permissible values for index range from 0 to the number of active attribute variables minus 1.

Attribute variables have arbitrary names and obtain their values through numbered generic vertex attributes. An attribute variable is considered active if it is determined during the link operation that it may be accessed during program execution. Therefore, program should have previously been the target of a call to glLinkProgram, but it is not necessary for it to have been linked successfully.

The size of the character buffer required to store the longest attribute variable name in program can be obtained by calling glGetProgramiv/ glGetProgramiv with the value GL_ACTIVE_ATTRIBUTE_MAX_LENGTH. This value should be used to allocate a buffer of sufficient size to store the returned attribute name. The size of this character buffer is passed in bufSize, and the character buffer is passed in name.

glGetActiveAttrib returns the name of the attribute variable indicated by index, storing it in the character buffer specified by name. The actual number of characters written into this buffer is returned in length. If the length of the returned string is not required, a value of null can be passed in the length argument.

The type argument will return the attribute variable's data type. The symbolic constants GL_FLOAT, GL_FLOAT_VEC2, GL_FLOAT_VEC3, GL_FLOAT_VEC4, GL_FLOAT_MAT2, GL_FLOAT_MAT3, or GL_FLOAT_MAT4 may be returned. The size argument will return the size of the attribute, in units of the type returned in type.

This function will return as much information as it can about the specified active attribute variable. If no information is available, length will be 0, and name will be an empty string. This situation could occur if this function is called after a link operation that failed. If an error occurs, the return values length, size, type, and name will be unmodified.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_VALUE is generated if index is greater than or equal to the number of active attribute variables in program.

GL_INVALID_VALUE is generated if bufSize is less than 0.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_VERTEX_ATTRIBS.

glGetProgramiv/ glGetProgramiv with argument GL_ACTIVE_ATTRIBUTES or GL_ACTIVE_ATTRIBUTE_MAX_LENGTH.

glIsProgram

Parameters:
program - Specifies the program object to be queried.
index - Specifies the index of the attribute variable to be queried.
bufSize - Specifies the maximum number of characters OpenGL is allowed to write in the character buffer indicated by name.
length - An int array of length at least 1. Returns the number of characters actually written by OpenGL in the string indicated by name if a value other than null is passed. May be null.
lengthOffset - The starting offset within the length array.
size - An int array of length at least 1. Returns the size of the attribute variable. May be null.
sizeOffset - The starting offset within the size array.
type - An int array of length at least 1. Returns the data type of the attribute variable. May be null.
typeOffset - The starting offset within the type array.
name - Returns a byte[] containing the name of the attribute variable.
nameOffset - The starting offset within the name array.
Throws:
IllegalArgumentException - If length is non-null but but length.length - lengthOffset is smaller than 1.
IllegalArgumentException - If lengthOffset is less than 0.
IllegalArgumentException - If size is non-null but size.length - sizeOffset is smaller than 1.
IllegalArgumentException - If sizeOffset is less than 0.
IllegalArgumentException - If type is non-null but type.length - typeOffset is smaller than 1.
IllegalArgumentException - If typeOffset is less than 0.
IllegalArgumentException - If name is null.
IllegalArgumentException - If nameOffset is less than 0.
See Also:
GL20.glGetActiveAttrib(int, int, int[], int, int[], int), GL20.glBindAttribLocation(int, int, String), GL20.glGetActiveUniform(int, int, int[], int, int[], int), GL20.glLinkProgram(int), GL20.glVertexAttrib1f(int, float), GL20.glVertexAttrib1fv(int, FloatBuffer), GL20.glVertexAttrib1fv(int, float[], int), GL20.glVertexAttrib2f(int, float, float), GL20.glVertexAttrib2fv(int, FloatBuffer), GL20.glVertexAttrib2fv(int, float[], int), GL20.glVertexAttrib3f(int, float, float, float), GL20.glVertexAttrib3fv(int, FloatBuffer), GL20.glVertexAttrib3fv(int, float[], int), GL20.glVertexAttrib4f(int, float, float, float, float), GL20.glVertexAttrib4fv(int, FloatBuffer), GL20.glVertexAttrib4fv(int, float[], int), GL20.glVertexAttribPointer(int, int, int, boolean, int, Buffer), GL20.glVertexAttribPointer(int, int, int, boolean, int, int)
Since:
BlackBerry API 7.0.0

glGetActiveUniform

String glGetActiveUniform(int program,
                          int index,
                          int[] size,
                          int sizeOffset,
                          int[] type,
                          int typeOffset)
Return information about an active uniform variable.

Description

glGetActiveUniform returns information about an active uniform variable in the program object specified by program. The number of active uniform variables can be obtained by calling glGetProgramiv/ glGetProgramiv with the value GL_ACTIVE_UNIFORMS. A value of 0 for index selects the first active uniform variable. Permissible values for index range from 0 to the number of active uniform variables minus 1.

Shaders may use either built-in uniform variables, user-defined uniform variables, or both. Built-in uniform variables have a prefix of "gl_" and reference existing OpenGL state or values derived from such state (e.g., gl_DepthRange). User-defined uniform variables have arbitrary names and obtain their values from the application through calls to glUniform1f/ glUniform1fv/ glUniform1fv/ glUniform1i/ glUniform1iv/ glUniform1iv/ glUniform2f/ glUniform2fv/ glUniform2fv/ glUniform2i/ glUniform2iv/ glUniform2iv/ glUniform3f/ glUniform3fv/ glUniform3fv/ glUniform3i/ glUniform3iv/ glUniform3iv/ glUniform4f/ glUniform4fv/ glUniform4fv/ glUniform4i/ glUniform4iv/ glUniform4iv/ glUniformMatrix2fv/ glUniformMatrix2fv/ glUniformMatrix3fv/ glUniformMatrix3fv/ glUniformMatrix4fv/ glUniformMatrix4fv. A uniform variable (either built-in or user-defined) is considered active if it is determined during the link operation that it may be accessed during program execution. Therefore, program should have previously been the target of a call to glLinkProgram, but it is not necessary for it to have been linked successfully.

glGetActiveUniform returns the name of the uniform variable indicated by index.

The type argument will return the uniform variable's data type. The symbolic constants GL_FLOAT, GL_FLOAT_VEC2, GL_FLOAT_VEC3, GL_FLOAT_VEC4, GL_INT, GL_INT_VEC2, GL_INT_VEC3, GL_INT_VEC4, GL_BOOL, GL_BOOL_VEC2, GL_BOOL_VEC3, GL_BOOL_VEC4, GL_FLOAT_MAT2, GL_FLOAT_MAT3, GL_FLOAT_MAT4, GL_SAMPLER_2D, or GL_SAMPLER_CUBE may be returned.

If one or more elements of an array are active, the name of the array is returned, the type is returned in type, and the size parameter returns the highest array element index used, plus one, as determined by the compiler and/or linker. Only one active uniform variable will be reported for a uniform array.

Uniform variables that are declared as structures or arrays of structures will not be returned directly by this function. Instead, each of these uniform variables will be reduced to its fundamental components containing the "." and "[]" operators such that each of the names is valid as an argument to glGetUniformLocation. Each of these reduced uniform variables is counted as one active uniform variable and is assigned an index. A valid name cannot be a structure, an array of structures, or a subcomponent of a vector or matrix.

The size of the uniform variable will be returned in size. Uniform variables other than arrays will have a size of 1. Structures and arrays of structures will be reduced as described earlier, such that each of the names returned will be a data type in the earlier list. If this reduction results in an array, the size returned will be as described for uniform arrays; otherwise, the size returned will be 1.

The list of active uniform variables may include both built-in uniform variables (which begin with the prefix "gl_") as well as user-defined uniform variable names.

This function will return as much information as it can about the specified active uniform variable. If no information is available then an empty string will be returned. This situation could occur if this function is called after a link operation that failed. If an error occurs, the return values size and type will be unmodified and an empty string will be returned.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_VALUE is generated if index is greater than or equal to the number of active uniform variables in program.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_VERTEX_UNIFORM_VECTORS or GL_MAX_FRAGMENT_UNIFORM_VECTORS.

glGetProgramiv/ glGetProgramiv with argument GL_ACTIVE_UNIFORMS or GL_ACTIVE_UNIFORM_MAX_LENGTH.

glIsProgram

Parameters:
program - Specifies the program object to be queried.
index - Specifies the index of the uniform variable to be queried.
size - An int array of length at least 1. Returns the size of the uniform variable. May be null.
sizeOffset - The starting offset within the size array.
type - An int array of length at least 1. Returns the data type of the uniform variable. May be null.
typeOffset - The starting offset within the type array.
Returns:
A String containing the name of the uniform variable.
Throws:
IllegalArgumentException - If size is non-null but size.length - sizeOffset is smaller than 1.
IllegalArgumentException - If sizeOffset is less than 0.
IllegalArgumentException - If type is non-null but type.length - typeOffset is smaller than 1.
IllegalArgumentException - If typeOffset is less than 0.
See Also:
GL20.glGetActiveUniform(int, int, int, int[], int, int[], int, int[], int, byte[], int), GL20.glGetActiveAttrib(int, int, int[], int, int[], int), GL20.glGetUniformfv(int, int, int, FloatBuffer), GL20.glGetUniformfv(int, int, int, float[], int), GL20.glGetUniformiv(int, int, int, IntBuffer), GL20.glGetUniformiv(int, int, int, int[], int), GL20.glGetUniformLocation(int, String), GL20.glLinkProgram(int), GL20.glUniform1f(int, float), GL20.glUniform1fv(int, int, FloatBuffer), GL20.glUniform1fv(int, int, float[], int), GL20.glUniform1i(int, int), GL20.glUniform1iv(int, int, IntBuffer), GL20.glUniform1iv(int, int, int[], int), GL20.glUniform2f(int, float, float), GL20.glUniform2fv(int, int, FloatBuffer), GL20.glUniform2fv(int, int, float[], int), GL20.glUniform2i(int, int, int), GL20.glUniform2iv(int, int, IntBuffer), GL20.glUniform2iv(int, int, int[], int), GL20.glUniform3f(int, float, float, float), GL20.glUniform3fv(int, int, FloatBuffer), GL20.glUniform3fv(int, int, float[], int), GL20.glUniform3i(int, int, int, int), GL20.glUniform3iv(int, int, IntBuffer), GL20.glUniform3iv(int, int, int[], int), GL20.glUniform4f(int, float, float, float, float), GL20.glUniform4fv(int, int, FloatBuffer), GL20.glUniform4fv(int, int, float[], int), GL20.glUniform4i(int, int, int, int, int), GL20.glUniform4iv(int, int, IntBuffer), GL20.glUniform4iv(int, int, int[], int), GL20.glUniformMatrix2fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix2fv(int, int, boolean, float[], int), GL20.glUniformMatrix3fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix3fv(int, int, boolean, float[], int), GL20.glUniformMatrix4fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix4fv(int, int, boolean, float[], int), GL20.glUseProgram(int)
Since:
BlackBerry API 7.0.0

glGetActiveUniform

void glGetActiveUniform(int program,
                        int index,
                        int bufSize,
                        int[] length,
                        int lengthOffset,
                        int[] size,
                        int sizeOffset,
                        int[] type,
                        int typeOffset,
                        byte[] name,
                        int nameOffset)
Return information about an active uniform variable.

Description

glGetActiveUniform returns information about an active uniform variable in the program object specified by program. The number of active uniform variables can be obtained by calling glGetProgramiv/ glGetProgramiv with the value GL_ACTIVE_UNIFORMS. A value of 0 for index selects the first active uniform variable. Permissible values for index range from 0 to the number of active uniform variables minus 1.

Shaders may use either built-in uniform variables, user-defined uniform variables, or both. Built-in uniform variables have a prefix of "gl_" and reference existing OpenGL state or values derived from such state (e.g., gl_DepthRange). User-defined uniform variables have arbitrary names and obtain their values from the application through calls to glUniform1f/ glUniform1fv/ glUniform1fv/ glUniform1i/ glUniform1iv/ glUniform1iv/ glUniform2f/ glUniform2fv/ glUniform2fv/ glUniform2i/ glUniform2iv/ glUniform2iv/ glUniform3f/ glUniform3fv/ glUniform3fv/ glUniform3i/ glUniform3iv/ glUniform3iv/ glUniform4f/ glUniform4fv/ glUniform4fv/ glUniform4i/ glUniform4iv/ glUniform4iv/ glUniformMatrix2fv/ glUniformMatrix2fv/ glUniformMatrix3fv/ glUniformMatrix3fv/ glUniformMatrix4fv/ glUniformMatrix4fv. A uniform variable (either built-in or user-defined) is considered active if it is determined during the link operation that it may be accessed during program execution. Therefore, program should have previously been the target of a call to glLinkProgram, but it is not necessary for it to have been linked successfully.

The size of the character buffer required to store the longest uniform variable name in program can be obtained by calling glGetProgramiv/ glGetProgramiv with the value GL_ACTIVE_UNIFORM_MAX_LENGTH. This value should be used to allocate a buffer of sufficient size to store the returned uniform variable name. The size of this character buffer is passed in bufSize, and the character buffer itself is passed in name.

glGetActiveUniform returns the name of the uniform variable indicated by index, storing it in the character buffer specified by name. The actual number of characters written into this buffer is returned in length. If the length of the returned string is not required, a value of null can be passed in the length argument.

The type argument will return the uniform variable's data type. The symbolic constants GL_FLOAT, GL_FLOAT_VEC2, GL_FLOAT_VEC3, GL_FLOAT_VEC4, GL_INT, GL_INT_VEC2, GL_INT_VEC3, GL_INT_VEC4, GL_BOOL, GL_BOOL_VEC2, GL_BOOL_VEC3, GL_BOOL_VEC4, GL_FLOAT_MAT2, GL_FLOAT_MAT3, GL_FLOAT_MAT4, GL_SAMPLER_2D, or GL_SAMPLER_CUBE may be returned.

If one or more elements of an array are active, the name of the array is returned in name, the type is returned in type, and the size parameter returns the highest array element index used, plus one, as determined by the compiler and/or linker. Only one active uniform variable will be reported for a uniform array.

Uniform variables that are declared as structures or arrays of structures will not be returned directly by this function. Instead, each of these uniform variables will be reduced to its fundamental components containing the "." and "[]" operators such that each of the names is valid as an argument to glGetUniformLocation. Each of these reduced uniform variables is counted as one active uniform variable and is assigned an index. A valid name cannot be a structure, an array of structures, or a subcomponent of a vector or matrix.

The size of the uniform variable will be returned in size. Uniform variables other than arrays will have a size of 1. Structures and arrays of structures will be reduced as described earlier, such that each of the names returned will be a data type in the earlier list. If this reduction results in an array, the size returned will be as described for uniform arrays; otherwise, the size returned will be 1.

The list of active uniform variables may include both built-in uniform variables (which begin with the prefix "gl_") as well as user-defined uniform variable names.

This function will return as much information as it can about the specified active uniform variable. If no information is available, length will be 0, and name will be an empty string. This situation could occur if this function is called after a link operation that failed. If an error occurs, the return values length, size, type, and name will be unmodified.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_VALUE is generated if index is greater than or equal to the number of active uniform variables in program.

GL_INVALID_VALUE is generated if bufSize is less than 0.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_VERTEX_UNIFORM_VECTORS or GL_MAX_FRAGMENT_UNIFORM_VECTORS.

glGetProgramiv/ glGetProgramiv with argument GL_ACTIVE_UNIFORMS or GL_ACTIVE_UNIFORM_MAX_LENGTH.

glIsProgram

Parameters:
program - Specifies the program object to be queried.
index - Specifies the index of the uniform variable to be queried.
bufSize - Specifies the maximum number of characters OpenGL is allowed to write in the character buffer indicated by name.
length - An int array of length at least 1. Returns the number of characters actually written by OpenGL in the string indicated by name if a value other than null is passed. May be null.
lengthOffset - The starting offset within the length array.
size - An int array of length at least 1. Returns the size of the uniform variable. May be null.
sizeOffset - The starting offset within the size array.
type - An int array of length at least 1. Returns the data type of the uniform variable. May be null.
typeOffset - The starting offset within the type array.
name - Returns a byte[] containing the name of the uniform variable.
nameOffset - The starting offset within the name array.
Throws:
IllegalArgumentException - If length is non-null but length.length - lengthOffset is smaller than 1.
IllegalArgumentException - If lengthOffset is less than 0.
IllegalArgumentException - If size is non-null but size.length - sizeOffset is smaller than 1.
IllegalArgumentException - If sizeOffset is less than 0.
IllegalArgumentException - If type is non-null but type.length - typeOffset is smaller than 1.
IllegalArgumentException - If typeOffset is less than 0.
IllegalArgumentException - If name is null.
IllegalArgumentException - If nameOffset is less than 0.
See Also:
GL20.glGetActiveUniform(int, int, int[], int, int[], int), GL20.glGetActiveAttrib(int, int, int[], int, int[], int), GL20.glGetUniformfv(int, int, int, FloatBuffer), GL20.glGetUniformfv(int, int, int, float[], int), GL20.glGetUniformiv(int, int, int, IntBuffer), GL20.glGetUniformiv(int, int, int, int[], int), GL20.glGetUniformLocation(int, String), GL20.glLinkProgram(int), GL20.glUniform1f(int, float), GL20.glUniform1fv(int, int, FloatBuffer), GL20.glUniform1fv(int, int, float[], int), GL20.glUniform1i(int, int), GL20.glUniform1iv(int, int, IntBuffer), GL20.glUniform1iv(int, int, int[], int), GL20.glUniform2f(int, float, float), GL20.glUniform2fv(int, int, FloatBuffer), GL20.glUniform2fv(int, int, float[], int), GL20.glUniform2i(int, int, int), GL20.glUniform2iv(int, int, IntBuffer), GL20.glUniform2iv(int, int, int[], int), GL20.glUniform3f(int, float, float, float), GL20.glUniform3fv(int, int, FloatBuffer), GL20.glUniform3fv(int, int, float[], int), GL20.glUniform3i(int, int, int, int), GL20.glUniform3iv(int, int, IntBuffer), GL20.glUniform3iv(int, int, int[], int), GL20.glUniform4f(int, float, float, float, float), GL20.glUniform4fv(int, int, FloatBuffer), GL20.glUniform4fv(int, int, float[], int), GL20.glUniform4i(int, int, int, int, int), GL20.glUniform4iv(int, int, IntBuffer), GL20.glUniform4iv(int, int, int[], int), GL20.glUniformMatrix2fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix2fv(int, int, boolean, float[], int), GL20.glUniformMatrix3fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix3fv(int, int, boolean, float[], int), GL20.glUniformMatrix4fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix4fv(int, int, boolean, float[], int), GL20.glUseProgram(int)
Since:
BlackBerry API 7.0.0

glGetAttachedShaders

void glGetAttachedShaders(int program,
                          int maxcount,
                          int[] count,
                          int countOffset,
                          int[] shaders,
                          int shadersOffset)
Return the handles of the shader objects attached to a program object

Description

glGetAttachedShaders returns the names of the shader objects attached to program. The names of shader objects that are attached to program will be returned in shaders. The actual number of shader names written into shaders is returned in count. If no shader objects are attached to program, count is set to 0. The maximum number of shader names that may be returned in shaders is specified by maxcount.

If the number of names actually returned is not required (for instance, if it has just been obtained by calling glGetProgramiv/ glGetProgramiv), a value of null may be passed for count. If no shader objects are attached to program, a value of 0 will be returned in count. The actual number of attached shaders can be obtained by calling glGetProgramiv/ glGetProgramiv with the value GL_ATTACHED_SHADERS.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_VALUE is generated if maxcount is less than 0.

Associated Gets

glGetProgramiv/ glGetProgramiv with argument GL_ATTACHED_SHADERS

glIsProgram

Parameters:
program - Specifies the program object to be queried.
maxcount - Specifies the size of the array for storing the returned object names.
count - An int array of length at least 1. Returns the number of names actually returned in shaders. May be null.
countOffset - The starting offset within the count array.
shaders - Specifies an array that is used to return the names of attached shader objects.
shadersOffset - The starting offset within the shaders array.
Throws:
IllegalArgumentException - If countOffset is less than 0.
IllegalArgumentException - If count is non-null but count.length - countOffset is smaller than 1.
IllegalArgumentException - If shaders is null.
IllegalArgumentException - If shadersOffset is less than 0.
IllegalArgumentException - If shaders.length - shadersOffset is less than n.
See Also:
GL20.glAttachShader(int, int), GL20.glDetachShader(int, int), GL20.glGetAttachedShaders(int, int, IntBuffer, IntBuffer)
Since:
BlackBerry API 7.0.0

glGetAttachedShaders

void glGetAttachedShaders(int program,
                          int maxcount,
                          IntBuffer count,
                          IntBuffer shaders)
Integer Buffer version of glGetAttachedShaders.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_VALUE is generated if maxcount is less than 0.

Parameters:
program - Specifies the program object to be queried.
maxcount - Specifies the size of the array for storing the returned object names.
count - Specifies the buffer that is used to return the number of names actually returned in shaders. May be null.
shaders - Specifies the buffer that is used to return the names of attached shader objects.
Throws:
IllegalArgumentException - If count is non-null but count.remaining() is less than 1.
IllegalArgumentException - If shaders is null.
IllegalArgumentException - If shaders.remaining() is less than n.
See Also:
GL20.glGetAttachedShaders(int, int, int[], int, int[], int)
Since:
BlackBerry API 7.0.0

glGetAttribLocation

int glGetAttribLocation(int program,
                        String name)
Return the location of an attribute variable.

Description

glGetAttribLocation queries the previously linked program object specified by program for the attribute variable specified by name and returns the index of the generic vertex attribute that is bound to that attribute variable. If name is a matrix attribute variable, the index of the first column of the matrix is returned. If the named attribute variable is not an active attribute in the specified program object or if name starts with the reserved prefix "gl_", a value of -1 is returned.

The association between an attribute variable name and a generic attribute index can be specified at any time by calling glBindAttribLocation. Attribute bindings do not go into effect until glLinkProgram is called. After a program object has been linked successfully, the index values for attribute variables remain fixed until the next link command occurs. The attribute values can only be queried after a link if the link was successful. glGetAttribLocation returns the binding that actually went into effect the last time glLinkProgram was called for the specified program object. Attribute bindings that have been specified since the last link operation are not returned by glGetAttribLocation.

Errors

GL_INVALID_OPERATION is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_OPERATION is generated if program has not been successfully linked.

Associated Gets

glGetActiveAttrib with argument program and the index of an active attribute

glIsProgram

Parameters:
program - Specifies the program object to be queried.
name - A string containing the name of the attribute variable whose location is to be queried.
Returns:
The location of an attribute variable.
Throws:
IllegalArgumentException - If name is null.
See Also:
GL20.glBindAttribLocation(int, int, String), GL20.glLinkProgram(int), GL20.glVertexAttrib1f(int, float), GL20.glVertexAttrib1fv(int, FloatBuffer), GL20.glVertexAttrib1fv(int, float[], int), GL20.glVertexAttrib2f(int, float, float), GL20.glVertexAttrib2fv(int, FloatBuffer), GL20.glVertexAttrib2fv(int, float[], int), GL20.glVertexAttrib3f(int, float, float, float), GL20.glVertexAttrib3fv(int, FloatBuffer), GL20.glVertexAttrib3fv(int, float[], int), GL20.glVertexAttrib4f(int, float, float, float, float), GL20.glVertexAttrib4fv(int, FloatBuffer), GL20.glVertexAttrib4fv(int, float[], int), GL20.glVertexAttribPointer(int, int, int, boolean, int, Buffer), GL20.glVertexAttribPointer(int, int, int, boolean, int, int)
Since:
BlackBerry API 7.0.0

glGetBooleanv

void glGetBooleanv(int pname,
                   boolean[] params,
                   int offset)
Boolean version of glGetIntegerv.

Note: Type conversion is performed if params has a different type than the state variable value being requested. When glGetBooleanv is called, a floating-point (or integer) value is converted to GL_FALSE if and only if it is 0.0 (or 0). Otherwise, it is converted to GL_TRUE.

Errors

GL_INVALID_ENUM is generated if pname is not one of the values listed in the documention for GL20.glGetIntegerv(int, int[], int).

Parameters:
pname - Specifies the parameter value to be returned. The symbolic constants in the list above are accepted.
params - Returns the value or values of the specified parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glGetIntegerv(int, int[], int)
Since:
BlackBerry API 7.0.0

glGetBooleanv

void glGetBooleanv(int pname,
                   IntBuffer params)
Boolean version of glGetIntegerv. A value of 0 represents false and a value of 1 represents true.

Errors

GL_INVALID_ENUM is generated if pname is not one of the values listed in the documention for GL20.glGetIntegerv(int, int[], int).

Parameters:
pname - Specifies the parameter value to be returned. The symbolic constants in the list above are accepted.
params - Returns the value or values of the specified parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetIntegerv(int, IntBuffer)
Since:
BlackBerry API 7.0.0

glGetBufferParameteriv

void glGetBufferParameteriv(int target,
                            int pname,
                            int[] params,
                            int offset)
Return parameters of a buffer object.

Description

glGetBufferParameteriv returns in data a selected parameter of the buffer object specified by target.

value names a specific buffer object parameter, as follows:

GL_BUFFER_SIZE

params returns the size of the buffer object, measured in bytes. The initial value is 0.

GL_BUFFER_USAGE

params returns the buffer object's usage pattern. The initial value is GL_STATIC_DRAW.

Notes

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

Errors

GL_INVALID_ENUM is generated if target or pname is not an accepted value.

GL_INVALID_OPERATION is generated if the reserved buffer object name 0 is bound to target.

Parameters:
target - Specifies the target buffer object. The symbolic constant must be GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER.
pname - Specifies the symbolic name of a buffer object parameter. Accepted values are GL_BUFFER_SIZE or GL_BUFFER_USAGE.
params - Returns the requested parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glBindBuffer(int, int), GL20.glBufferData(int, int, Buffer, int), GL20.glGetBufferParameteriv(int, int, IntBuffer)
Since:
BlackBerry API 7.0.0

glGetBufferParameteriv

void glGetBufferParameteriv(int target,
                            int pname,
                            IntBuffer params)
Integer Buffer version of glGetBufferParameteriv.

Errors

GL_INVALID_ENUM is generated if target or pname is not an accepted value.

GL_INVALID_OPERATION is generated if the reserved buffer object name 0 is bound to target.

Parameters:
target - Specifies the target buffer object. The symbolic constant must be GL_ARRAY_BUFFER or GL_ELEMENT_ARRAY_BUFFER.
pname - Specifies the symbolic name of a buffer object parameter. Accepted values are GL_BUFFER_SIZE or GL_BUFFER_USAGE.
params - Returns the requested parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glBindBuffer(int, int), GL20.glBufferData(int, int, Buffer, int), GL20.glGetBufferParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetError

int glGetError()
Return error information.

Description

glGetError returns the value of the error flag. Each detectable error is assigned a numeric code and symbolic name. When an error occurs, the error flag is set to the appropriate error code value. No other errors are recorded until glGetError is called, the error code is returned, and the flag is reset to GL_NO_ERROR. If a call to glGetError returns GL_NO_ERROR, there has been no detectable error since the last call to glGetError, or since the GL was initialized.

To allow for distributed implementations, there may be several error flags. If any single error flag has recorded an error, the value of that flag is returned and that flag is reset to GL_NO_ERROR when glGetError is called. If more than one flag has recorded an error, glGetError returns and clears an arbitrary error flag value. Thus, glGetError should always be called in a loop, until it returns GL_NO_ERROR, if all error flags are to be reset.

Initially, all error flags are set to GL_NO_ERROR.

The following errors are currently defined:

GL_NO_ERROR

No error has been recorded. The value of this symbolic constant is guaranteed to be 0.

GL_INVALID_ENUM

An unacceptable value is specified for an enumerated argument. The offending command is ignored and has no other side effect than to set the error flag.

GL_INVALID_VALUE

A numeric argument is out of range. The offending command is ignored and has no other side effect than to set the error flag.

GL_INVALID_OPERATION

The specified operation is not allowed in the current state. The offending command is ignored and has no other side effect than to set the error flag.

GL_INVALID_FRAMEBUFFER_OPERATION

The command is trying to render to or read from the framebuffer while the currently bound framebuffer is not framebuffer complete (i.e. the return value from glCheckFramebufferStatus is not GL_FRAMEBUFFER_COMPLETE). The offending command is ignored and has no other side effect than to set the error flag.

GL_OUT_OF_MEMORY

There is not enough memory left to execute the command. The state of the GL is undefined, except for the state of the error flags, after this error is recorded.

When an error flag is set, results of a GL operation are undefined only if GL_OUT_OF_MEMORY has occurred. In all other cases, the command generating the error is ignored and has no effect on the GL state or frame buffer contents. If the generating command returns a value, it returns 0.

Returns:
The value of the error flag.
See Also:
GL20.glCheckFramebufferStatus(int)
Since:
BlackBerry API 7.0.0

glGetFloatv

void glGetFloatv(int pname,
                 float[] params,
                 int offset)
Floating-point version of glGetIntegerv.

Note: Type conversion is performed if params has a different type than the state variable value being requested. When glGetFloatv is called, boolean values are returned as GL_TRUE or GL_FALSE, and integer values are converted to floating-point values.

Errors

GL_INVALID_ENUM is generated if pname is not one of the values listed in the documention for glGetIntegerv.

Parameters:
pname - Specifies the parameter value to be returned. The symbolic constants in the list above are accepted.
params - Returns the value or values of the specified parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glGetIntegerv(int, int[], int)
Since:
BlackBerry API 7.0.0

glGetFloatv

void glGetFloatv(int pname,
                 FloatBuffer params)
Floating-point version of glGetIntegerv.

Errors

GL_INVALID_ENUM is generated if pname is not one of the values listed in the documention for glGetIntegerv.

Parameters:
pname - Specifies the parameter value to be returned. The symbolic constants in the list above are accepted.
params - Returns the value or values of the specified parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetIntegerv(int, IntBuffer)
Since:
BlackBerry API 7.0.0

glGetFramebufferAttachmentParameteriv

void glGetFramebufferAttachmentParameteriv(int target,
                                           int attachment,
                                           int pname,
                                           int[] params,
                                           int offset)
Return attachment parameters of a framebuffer object.

Description

glGetFramebufferAttachmentParameteriv returns in params a selected attachment parameter of the attachpoint point attachment of the currently bound framebuffer object.

pname names a specific framebuffer object attachment parameter, as follows:

GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE

params returns the type of object which contains the attached image, either GL_RENDERBUFFER, GL_TEXTURE, or if no image is attached, GL_NONE. The initial value is GL_NONE.

GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME

If the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is GL_RENDERBUFFER, params returns the name of the renderbuffer object which contains the attached image. If the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is GL_TEXTURE, params returns the name of the texture object which contains the attached image. The initial value is zero.

GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL

If the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is GL_TEXTURE, params returns the mipmap level of the texture object which contains the attached image. The initial value is zero.

GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE

If the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE is GL_TEXTURE and GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME is the name of a cube-map texture, params returns the cube map face of the cube-map texture object which contains the attached image. If the attached image is from a texture object but not a cube-map, params returns 0. The initial value is GL_TEXTURE_CUBE_MAP_POSITIVE_X.

Notes

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

Errors

GL_INVALID_ENUM is generated if target is not GL_FRAMEBUFFER.

GL_INVALID_ENUM is generated if attachment is not GL_COLOR_ATTACHMENT0, GL_DEPTH_ATTACHMENT, or GL_STENCIL_ATTACHMENT.

GL_INVALID_ENUM is generated if the attached object at the named attachment point is GL_RENDERBUFFER and pname is not GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE or GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME.

GL_INVALID_ENUM is generated if the attached object at the named attachment point is GL_TEXTURE and pname is not GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE, GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME, GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL, or GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE.

GL_INVALID_ENUM is generated if there is no attached object at the named attachment point and pname is not GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE.

GL_INVALID_OPERATION is generated if the default framebuffer object name 0 is bound.

Parameters:
target - Specifies the target framebuffer object. The symbolic constant must be GL_FRAMEBUFFER.
attachment - Specifies the symbolic name of a framebuffer object attachment point. Accepted values are GL_COLOR_ATTACHMENT0, GL_DEPTH_ATTACHMENT, and GL_STENCIL_ATTACHMENT.
pname - Specifies the symbolic name of a framebuffer object attachment parameter. Accepted values are GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE, GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME, GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL, and GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE.
params - Returns the requested parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glBindFramebuffer(int, int), GL20.glFramebufferRenderbuffer(int, int, int, int), GL20.glFramebufferTexture2D(int, int, int, int, int), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, IntBuffer)
Since:
BlackBerry API 7.0.0

glGetFramebufferAttachmentParameteriv

void glGetFramebufferAttachmentParameteriv(int target,
                                           int attachment,
                                           int pname,
                                           IntBuffer params)
Integer Buffer version of glGetFramebufferAttachmentParameteriv.

Errors

GL_INVALID_ENUM is generated if target is not GL_FRAMEBUFFER.

GL_INVALID_ENUM is generated if attachment is not GL_COLOR_ATTACHMENT0, GL_DEPTH_ATTACHMENT, or GL_STENCIL_ATTACHMENT.

GL_INVALID_ENUM is generated if the attached object at the named attachment point is GL_RENDERBUFFER and pname is not GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE or GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME.

GL_INVALID_ENUM is generated if the attached object at the named attachment point is GL_TEXTURE and pname is not GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE, GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME, GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL, or GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE.

GL_INVALID_ENUM is generated if there is no attached object at the named attachment point and pname is not GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE.

GL_INVALID_OPERATION is generated if the default framebuffer object name 0 is bound.

Parameters:
target - Specifies the target framebuffer object. The symbolic constant must be GL_FRAMEBUFFER.
attachment - Specifies the symbolic name of a framebuffer object attachment point. Accepted values are GL_COLOR_ATTACHMENT0, GL_DEPTH_ATTACHMENT, and GL_STENCIL_ATTACHMENT.
pname - Specifies the symbolic name of a framebuffer object attachment parameter. Accepted values are GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE, GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME, GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL, and GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE.
params - Returns the requested parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glBindFramebuffer(int, int), GL20.glFramebufferRenderbuffer(int, int, int, int), GL20.glFramebufferTexture2D(int, int, int, int, int), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetIntegerv

void glGetIntegerv(int pname,
                   int[] params,
                   int offset)
Return the value or values of a selected parameter.

Description

This command (and its corresponding boolean, float, and buffer commands) return values for simple state variables in GL. pname is a symbolic constant indicating the state variable to be returned, and params is an array in which to place the returned data.

Type conversion is performed if params has a different type than the state variable value being requested. When glGetIntegerv is called, boolean values are returned as GL_TRUE or GL_FALSE, and most floating-point values are rounded to the nearest integer value. Floating-point colors and normals, however, are returned with a linear mapping that maps 1.0 to the most positive representable integer value and -1.0 to the most negative representable integer value.

The following symbolic constants are accepted by pname:

GL_ACTIVE_TEXTURE

params returns a single value indicating the active multitexture unit. The initial value is GL_TEXTURE0. See glActiveTexture.

GL_ALIASED_LINE_WIDTH_RANGE

params returns two values, the smallest and largest supported widths for aliased lines. The range must include width 1.

GL_ALIASED_POINT_SIZE_RANGE

params returns two values, the smallest and largest supported sizes for aliased points. The range must include size 1.

GL_ALPHA_BITS

params returns one value, the number of alpha bitplanes in the color buffer of the currently bound framebuffer.

GL_ARRAY_BUFFER_BINDING

params returns a single value, the name of the buffer object currently bound to the target GL_ARRAY_BUFFER. If no buffer object is bound to this target, 0 is returned. The initial value is 0. See glBindBuffer.

GL_BLEND

params returns a single boolean value indicating whether blending is enabled. The initial value is GL_FALSE. See glBlendFunc.

GL_BLEND_COLOR

params returns four values, the red, green, blue, and alpha values which are the components of the blend color. See glBlendColor.

GL_BLEND_DST_ALPHA

params returns one value, the symbolic constant identifying the alpha destination blend function. The initial value is GL_ZERO. See glBlendFunc and glBlendFuncSeparate.

GL_BLEND_DST_RGB

params returns one value, the symbolic constant identifying the RGB destination blend function. The initial value is GL_ZERO. See glBlendFunc and glBlendFuncSeparate.

GL_BLEND_EQUATION_ALPHA

params returns one value, a symbolic constant indicating whether the Alpha blend equation is GL_FUNC_ADD, GL_FUNC_SUBTRACT, or GL_FUNC_REVERSE_SUBTRACT. See glBlendEquationSeparate.

GL_BLEND_EQUATION_RGB

params returns one value, a symbolic constant indicating whether the RGB blend equation is GL_FUNC_ADD, GL_FUNC_SUBTRACT, or GL_FUNC_REVERSE_SUBTRACT. See glBlendEquationSeparate.

GL_BLEND_SRC_ALPHA

params returns one value, the symbolic constant identifying the alpha source blend function. The initial value is GL_ONE. See glBlendFunc and glBlendFuncSeparate.

GL_BLEND_SRC_RGB

params returns one value, the symbolic constant identifying the RGB source blend function. The initial value is GL_ONE. See glBlendFunc and glBlendFuncSeparate.

GL_BLUE_BITS

params returns one value, the number of blue bitplanes in the color buffer of the currently bound framebuffer.

GL_COLOR_CLEAR_VALUE

params returns four values: the red, green, blue, and alpha values used to clear the color buffers. Integer values, if requested, are linearly mapped from the internal floating-point representation such that 1.0 returns the most positive representable integer value, and -1.0 returns the most negative representable integer value. The initial value is (0, 0, 0, 0). See glClearColor.

GL_COLOR_WRITEMASK

params returns four boolean values: the red, green, blue, and alpha write enables for the color buffers. The initial value is (GL_TRUE, GL_TRUE, GL_TRUE, GL_TRUE). See glColorMask.

GL_COMPRESSED_TEXTURE_FORMATS

params returns a list of symbolic constants of length GL_NUM_COMPRESSED_TEXTURE_FORMATS indicating which compressed texture formats are available. See glCompressedTexImage2D.

GL_CULL_FACE

params returns a single boolean value indicating whether polygon culling is enabled. The initial value is GL_FALSE. See glCullFace.

GL_CULL_FACE_MODE

params returns one value, a symbolic constant indicating which polygon faces are to be culled. The initial value is GL_BACK. See glCullFace.

GL_CURRENT_PROGRAM

params returns one value, the name of the program object that is currently active, or 0 if no program object is active. See glUseProgram.

GL_DEPTH_BITS

params returns one value, the number of bitplanes in the depth buffer of the currently bound framebuffer.

GL_DEPTH_CLEAR_VALUE

params returns one value, the value that is used to clear the depth buffer. Integer values, if requested, are linearly mapped from the internal floating-point representation such that 1.0 returns the most positive representable integer value, and -1.0 returns the most negative representable integer value. The initial value is 1. See glClearDepthf.

GL_DEPTH_FUNC

params returns one value, the symbolic constant that indicates the depth comparison function. The initial value is GL_LESS. See glDepthFunc.

GL_DEPTH_RANGE

params returns two values: the near and far mapping limits for the depth buffer. Integer values, if requested, are linearly mapped from the internal floating-point representation such that 1.0 returns the most positive representable integer value, and -1.0 returns the most negative representable integer value. The initial value is (0, 1). See glDepthRangef.

GL_DEPTH_TEST

params returns a single boolean value indicating whether depth testing of fragments is enabled. The initial value is GL_FALSE. See glDepthFunc and glDepthRangef.

GL_DEPTH_WRITEMASK

params returns a single boolean value indicating if the depth buffer is enabled for writing. The initial value is GL_TRUE. See glDepthMask.

GL_DITHER

params returns a single boolean value indicating whether dithering of fragment colors and indices is enabled. The initial value is GL_TRUE.

GL_ELEMENT_ARRAY_BUFFER_BINDING

params returns a single value, the name of the buffer object currently bound to the target GL_ELEMENT_ARRAY_BUFFER. If no buffer object is bound to this target, 0 is returned. The initial value is 0. See glBindBuffer.

GL_FRAMEBUFFER_BINDING

params returns a single value, the name of the currently bound framebuffer. The initial value is 0, indicating the default framebuffer. See glBindFramebuffer.

GL_FRONT_FACE

params returns one value, a symbolic constant indicating whether clockwise or counterclockwise polygon winding is treated as front-facing. The initial value is GL_CCW. See glFrontFace.

GL_GENERATE_MIPMAP_HINT

params returns one value, a symbolic constant indicating the mode of the mipmap generation filtering hint. The initial value is GL_DONT_CARE. See glHint.

GL_GREEN_BITS

params returns one value, the number of green bitplanes in the color buffer of the currently bound framebuffer.

GL_IMPLEMENTATION_COLOR_READ_FORMAT

params returns one value, the format chosen by the implementation in which pixels may be read from the color buffer of the currently bound framebuffer in conjunction with GL_IMPLEMENTATION_COLOR_READ_TYPE. In addition to this implementation-dependent format/type pair, format GL_RGBA in conjunction with type GL_UNSIGNED_BYTE is always allowed by every implementation, regardless of the currently bound render surface. See glReadPixels.

GL_IMPLEMENTATION_COLOR_READ_TYPE

params returns one value, the type chosen by the implementation with which pixels may be read from the color buffer of the currently bound framebuffer in conjunction with GL_IMPLEMENTATION_COLOR_READ_FORMAT. In addition to this implementation-dependent format/type pair, format GL_RGBA in conjunction with type GL_UNSIGNED_BYTE is always allowed by every implementation, regardless of the currently bound render surface. See glReadPixels.

GL_LINE_WIDTH

params returns one value, the line width as specified with glLineWidth. The initial value is 1.

GL_MAX_COMBINED_TEXTURE_IMAGE_UNITS

params returns one value, the maximum supported texture image units that can be used to access texture maps from the vertex shader and the fragment processor combined. If both the vertex shader and the fragment processing stage access the same texture image unit, then that counts as using two texture image units against this limit. The value must be at least 8. See glActiveTexture.

GL_MAX_CUBE_MAP_TEXTURE_SIZE

params returns one value. The value gives a rough estimate of the largest cube-map texture that the GL can handle. The value must be at least 16. See glTexImage2D.

GL_MAX_FRAGMENT_UNIFORM_VECTORS

params returns one value, the maximum number of four-element floating-point, integer, or boolean vectors that can be held in uniform variable storage for a fragment shader. The value must be at least 16. See glUniform1f/ glUniform1fv/ glUniform1fv/ glUniform1i/ glUniform1iv/ glUniform1iv/ glUniform2f/ glUniform2fv/ glUniform2fv/ glUniform2i/ glUniform2iv/ glUniform2iv/ glUniform3f/ glUniform3fv/ glUniform3fv/ glUniform3i/ glUniform3iv/ glUniform3iv/ glUniform4f/ glUniform4fv/ glUniform4fv/ glUniform4i/ glUniform4iv/ glUniform4iv/ glUniformMatrix2fv/ glUniformMatrix2fv/ glUniformMatrix3fv/ glUniformMatrix3fv/ glUniformMatrix4fv/ glUniformMatrix4fv.

GL_MAX_RENDERBUFFER_SIZE

params returns one value. The value indicates the largest renderbuffer width and height that the GL can handle. The value must be at least 1. See glRenderbufferStorage.

GL_MAX_TEXTURE_IMAGE_UNITS

params returns one value, the maximum supported texture image units that can be used to access texture maps from the fragment shader. The value must be at least 8. See glActiveTexture.

GL_MAX_TEXTURE_SIZE

params returns one value. The value gives a rough estimate of the largest texture that the GL can handle. The value must be at least 64. See glTexImage2D.

GL_MAX_VARYING_VECTORS

params returns one value, the maximum number four-element floating-point vectors available for interpolating varying variables used by vertex and fragment shaders. Varying variables declared as matrices or arrays will consume multiple interpolators. The value must be at least 8.

GL_MAX_VERTEX_ATTRIBS

params returns one value, the maximum number of 4-component generic vertex attributes accessible to a vertex shader. The value must be at least 8. See glVertexAttrib1f/ glVertexAttrib1fv/ glVertexAttrib1fv/ glVertexAttrib2f/ glVertexAttrib2fv/ glVertexAttrib2fv/ glVertexAttrib3f/ glVertexAttrib3fv/ glVertexAttrib3fv/ glVertexAttrib4f/ glVertexAttrib4fv/ glVertexAttrib4fv.

GL_MAX_VERTEX_TEXTURE_IMAGE_UNITS

params returns one value, the maximum supported texture image units that can be used to access texture maps from the vertex shader. The value may be 0. See glActiveTexture.

GL_MAX_VERTEX_UNIFORM_VECTORS

params returns one value, the maximum number of four-element floating-point, integer, or boolean vectors that can be held in uniform variable storage for a vertex shader. The value must be at least 128. See glUniform1f/ glUniform1fv/ glUniform1fv/ glUniform1i/ glUniform1iv/ glUniform1iv/ glUniform2f/ glUniform2fv/ glUniform2fv/ glUniform2i/ glUniform2iv/ glUniform2iv/ glUniform3f/ glUniform3fv/ glUniform3fv/ glUniform3i/ glUniform3iv/ glUniform3iv/ glUniform4f/ glUniform4fv/ glUniform4fv/ glUniform4i/ glUniform4iv/ glUniform4iv/ glUniformMatrix2fv/ glUniformMatrix2fv/ glUniformMatrix3fv/ glUniformMatrix3fv/ glUniformMatrix4fv/ glUniformMatrix4fv.

GL_MAX_VIEWPORT_DIMS

params returns two values: the maximum supported width and height of the viewport. These must be at least as large as the visible dimensions of the display being rendered to. See glViewport.

GL_NUM_COMPRESSED_TEXTURE_FORMATS

params returns a single integer value indicating the number of available compressed texture formats. The minimum value is 0. See glCompressedTexImage2D.

GL_NUM_SHADER_BINARY_FORMATS

params returns a single integer value indicating the number of available shader binary formats. The minimum value is 0. See glShaderBinary/ glShaderBinary.

GL_PACK_ALIGNMENT

params returns one value, the byte alignment used for writing pixel data to memory. The initial value is 4. See glPixelStorei.

GL_POLYGON_OFFSET_FACTOR

params returns one value, the scaling factor used to determine the variable offset that is added to the depth value of each fragment generated when a polygon is rasterized. The initial value is 0. See glPolygonOffset.

GL_POLYGON_OFFSET_FILL

params returns a single boolean value indicating whether polygon offset is enabled for polygons in fill mode. The initial value is GL_FALSE. See glPolygonOffset.

GL_POLYGON_OFFSET_UNITS

params returns one value. This value is multiplied by an implementation-specific value and then added to the depth value of each fragment generated when a polygon is rasterized. The initial value is 0. See glPolygonOffset.

GL_RED_BITS

params returns one value, the number of red bitplanes in the color buffer of the currently bound framebuffer.

GL_RENDERBUFFER_BINDING

params returns a single value, the name of the currently bound renderbuffer. The initial value is 0, indicating no renderbuffer is bound. See glBindRenderbuffer.

GL_SAMPLE_ALPHA_TO_COVERAGE

params returns a single boolean value indicating if the fragment coverage value should be ANDed with a temporary coverage value based on the fragment's alpha value. The initial value is GL_FALSE. See glSampleCoverage.

GL_SAMPLE_BUFFERS

params returns a single integer value indicating the number of sample buffers associated with the currently bound framebuffer. See glSampleCoverage.

GL_SAMPLE_COVERAGE

params returns a single boolean value indicating if the fragment coverage value should be ANDed with a temporary coverage value based on the current sample coverage value. The initial value is GL_FALSE. See glSampleCoverage.

GL_SAMPLE_COVERAGE_INVERT

params returns a single boolean value indicating if the temporary coverage value should be inverted. See glSampleCoverage.

GL_SAMPLE_COVERAGE_VALUE

params returns a single positive floating-point value indicating the current sample coverage value. See glSampleCoverage.

GL_SAMPLES

params returns a single integer value indicating the coverage mask size of the currently bound framebuffer. See glSampleCoverage.

GL_SCISSOR_BOX

params returns four values: the x and y window coordinates of the scissor box, followed by its width and height. Initially the x and y window coordinates are both 0 and the width and height are set to the size of the window. See glScissor.

GL_SCISSOR_TEST

params returns a single boolean value indicating whether scissoring is enabled. The initial value is GL_FALSE. See glScissor.

GL_SHADER_BINARY_FORMATS

params returns a list of symbolic constants of length GL_NUM_SHADER_BINARY_FORMATS indicating which shader binary formats are available. See glShaderBinary/ glShaderBinary.

GL_SHADER_COMPILER

params returns a single boolean value indicating whether a shader compiler is supported. GL_FALSE indicates that any call to glShaderSource, glCompileShader, or glReleaseShaderCompiler will result in a GL_INVALID_OPERATION error being generated.

GL_STENCIL_BACK_FAIL

params returns one value, a symbolic constant indicating what action is taken for back-facing polygons when the stencil test fails. The initial value is GL_KEEP. See glStencilOpSeparate.

GL_STENCIL_BACK_FUNC

params returns one value, a symbolic constant indicating what function is used for back-facing polygons to compare the stencil reference value with the stencil buffer value. The initial value is GL_ALWAYS. See glStencilFuncSeparate.

GL_STENCIL_BACK_PASS_DEPTH_FAIL

params returns one value, a symbolic constant indicating what action is taken for back-facing polygons when the stencil test passes, but the depth test fails. The initial value is GL_KEEP. See glStencilOpSeparate.

GL_STENCIL_BACK_PASS_DEPTH_PASS

params returns one value, a symbolic constant indicating what action is taken for back-facing polygons when the stencil test passes and the depth test passes. The initial value is GL_KEEP. See glStencilOpSeparate.

GL_STENCIL_BACK_REF

params returns one value, the reference value that is compared with the contents of the stencil buffer for back-facing polygons. The initial value is 0. See glStencilFuncSeparate.

GL_STENCIL_BACK_VALUE_MASK

params returns one value, the mask that is used for back-facing polygons to mask both the stencil reference value and the stencil buffer value before they are compared. The initial value is all 1's. See glStencilFuncSeparate.

GL_STENCIL_BACK_WRITEMASK

params returns one value, the mask that controls writing of the stencil bitplanes for back-facing polygons. The initial value is all 1's. See glStencilMaskSeparate.

GL_STENCIL_BITS

params returns one value, the number of bitplanes in the stencil buffer of the currently bound framebuffer.

GL_STENCIL_CLEAR_VALUE

params returns one value, the index to which the stencil bitplanes are cleared. The initial value is 0. See glClearStencil.

GL_STENCIL_FAIL

params returns one value, a symbolic constant indicating what action is taken when the stencil test fails for front-facing polygons and non-polygons. The initial value is GL_KEEP. See glStencilOp and glStencilOpSeparate.

GL_STENCIL_FUNC

params returns one value, a symbolic constant indicating what function is used to compare the stencil reference value with the stencil buffer value for front-facing polygons and non-polygons. The initial value is GL_ALWAYS. See glStencilFunc and glStencilFuncSeparate.

GL_STENCIL_PASS_DEPTH_FAIL

params returns one value, a symbolic constant indicating what action is taken when the stencil test passes, but the depth test fails for front-facing polygons and non-polygons. The initial value is GL_KEEP. See glStencilOp and glStencilOpSeparate.

GL_STENCIL_PASS_DEPTH_PASS

params returns one value, a symbolic constant indicating what action is taken when the stencil test passes and the depth test passes for front-facing polygons and non-polygons. The initial value is GL_KEEP. See glStencilOp and glStencilOpSeparate.

GL_STENCIL_REF

params returns one value, the reference value that is compared with the contents of the stencil buffer for front-facing polygons and non-polygons. The initial value is 0. See glStencilFunc and glStencilFuncSeparate.

GL_STENCIL_TEST

params returns a single boolean value indicating whether stencil testing of fragments is enabled. The initial value is GL_FALSE. See glStencilFunc and glStencilOp.

GL_STENCIL_VALUE_MASK

params returns one value, the mask that is used to mask both the stencil reference value and the stencil buffer value before they are compared for front-facing polygons and non-polygons. The initial value is all 1's. See glStencilFunc and glStencilFuncSeparate.

GL_STENCIL_WRITEMASK

params returns one value, the mask that controls writing of the stencil bitplanes for front-facing polygons and non-polygons. The initial value is all 1's. See glStencilMask and glStencilMaskSeparate.

GL_SUBPIXEL_BITS

params returns one value, an estimate of the number of bits of subpixel resolution that are used to position rasterized geometry in window coordinates. The value must be at least 4.

GL_TEXTURE_BINDING_2D

params returns a single value, the name of the texture currently bound to the target GL_TEXTURE_2D for the active multitexture unit. The initial value is 0. See glBindTexture.

GL_TEXTURE_BINDING_CUBE_MAP

params returns a single value, the name of the texture currently bound to the target GL_TEXTURE_CUBE_MAP for the active multitexture unit. The initial value is 0. See glBindTexture.

GL_UNPACK_ALIGNMENT

params returns one value, the byte alignment used for reading pixel data from memory. The initial value is 4. See glPixelStorei.

GL_VIEWPORT

params returns four values: the x and y window coordinates of the viewport, followed by its width and height. Initially the x and y window coordinates are both set to 0, and the width and height are set to the width and height of the window into which the GL will do its rendering. See glViewport.

Many of the boolean parameters can also be queried more easily using glIsEnabled.

Errors

GL_INVALID_ENUM is generated if pname is not one of the values listed previously.

Parameters:
pname - Specifies the parameter value to be returned. The symbolic constants in the list above are accepted.
params - Returns the value or values of the specified parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glGetActiveAttrib(int, int, int[], int, int[], int), GL20.glGetActiveUniform(int, int, int[], int, int[], int), GL20.glGetAttachedShaders(int, int, IntBuffer, IntBuffer), GL20.glGetAttachedShaders(int, int, int[], int, int[], int), GL20.glGetAttribLocation(int, String), GL20.glGetBufferParameteriv(int, int, IntBuffer), GL20.glGetBufferParameteriv(int, int, int[], int), GL20.glGetError(), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, IntBuffer), GL20.glGetFramebufferAttachmentParameteriv(int, int, int, int[], int), GL20.glGetProgramiv(int, int, IntBuffer), GL20.glGetProgramiv(int, int, int[], int), GL20.glGetProgramInfoLog(int), GL20.glGetRenderbufferParameteriv(int, int, IntBuffer), GL20.glGetRenderbufferParameteriv(int, int, int[], int), GL20.glGetShaderiv(int, int, IntBuffer), GL20.glGetShaderiv(int, int, int[], int), GL20.glGetShaderInfoLog(int), GL20.glGetShaderSource(int, int, int[], byte[]), GL20.glGetString(int), GL20.glGetTexParameterfv(int, int, FloatBuffer), GL20.glGetTexParameterfv(int, int, float[], int), GL20.glGetTexParameteriv(int, int, IntBuffer), GL20.glGetTexParameteriv(int, int, int[], int), GL20.glGetUniformfv(int, int, int, FloatBuffer), GL20.glGetUniformfv(int, int, int, float[], int), GL20.glGetUniformiv(int, int, int, IntBuffer), GL20.glGetUniformiv(int, int, int, int[], int), GL20.glGetUniformLocation(int, String), GL20.glGetVertexAttribfv(int, int, FloatBuffer), GL20.glGetVertexAttribfv(int, int, float[], int), GL20.glGetVertexAttribiv(int, int, IntBuffer), GL20.glGetVertexAttribiv(int, int, int[], int), GL20.glIsEnabled(int)
Since:
BlackBerry API 7.0.0

glGetIntegerv

void glGetIntegerv(int pname,
                   IntBuffer params)
Integer Buffer version of glGetIntegerv.

Errors

GL_INVALID_ENUM is generated if pname is not one of the values listed in the documention for glGetIntegerv.

Parameters:
pname - Specifies the parameter value to be returned. The symbolic constants in the list above are accepted.
params - Returns the value or values of the specified parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetIntegerv(int, int[], int)
Since:
BlackBerry API 7.0.0

glGetProgramiv

void glGetProgramiv(int program,
                    int pname,
                    int[] params,
                    int offset)
Return a parameter from a program object.

Description

glGetProgramiv returns in params the value of a parameter for a specific program object. The following parameters are defined:

GL_DELETE_STATUS

params returns GL_TRUE if program is currently flagged for deletion, and GL_FALSE otherwise.

GL_LINK_STATUS

params returns GL_TRUE if the last link operation on program was successful, and GL_FALSE otherwise.

GL_VALIDATE_STATUS

params returns GL_TRUE or if the last validation operation on program was successful, and GL_FALSE otherwise.

GL_INFO_LOG_LENGTH

params returns the number of characters in the information log for program (i.e., the size of the character buffer required to store the information log). If program has no information log, a value of 0 is returned.

GL_ATTACHED_SHADERS

params returns the number of shader objects attached to program.

GL_ACTIVE_ATTRIBUTES

params returns the number of active attribute variables for program.

GL_ACTIVE_ATTRIBUTE_MAX_LENGTH

params returns the length of the longest active attribute name for program, (i.e., the size of the character buffer required to store the longest attribute name). If no active attributes exist, 0 is returned.

GL_ACTIVE_UNIFORMS

params returns the number of active uniform variables for program.

GL_ACTIVE_UNIFORM_MAX_LENGTH

params returns the length of the longest active uniform variable name for program, (i.e., the size of the character buffer required to store the longest uniform variable name). If no active uniform variables exist, 0 is returned.

Notes

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

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program does not refer to a program object.

Associated Gets

glGetActiveAttrib with argument program

glGetActiveUniform with argument program

glGetAttachedShaders/ glGetAttachedShaders with argument program

glGetProgramInfoLog with argument program

glIsProgram

Parameters:
program - Specifies the program object to be queried.
pname - Specifies the object parameter. Accepted symbolic names are GL_DELETE_STATUS, GL_LINK_STATUS, GL_VALIDATE_STATUS, GL_INFO_LOG_LENGTH, GL_ATTACHED_SHADERS, GL_ACTIVE_ATTRIBUTES, GL_ACTIVE_ATTRIBUTE_MAX_LENGTH, GL_ACTIVE_UNIFORMS, GL_ACTIVE_UNIFORM_MAX_LENGTH.
params - Returns the requested object parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glAttachShader(int, int), GL20.glCreateProgram(), GL20.glDeleteProgram(int), GL20.glGetProgramiv(int, int, IntBuffer), GL20.glGetShaderiv(int, int, IntBuffer), GL20.glGetShaderiv(int, int, int[], int), GL20.glLinkProgram(int), GL20.glValidateProgram(int)
Since:
BlackBerry API 7.0.0

glGetProgramiv

void glGetProgramiv(int program,
                    int pname,
                    IntBuffer params)
Integer Buffer version of glGetProgramiv.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program does not refer to a program object.

Parameters:
program - Specifies the program object to be queried.
pname - Specifies the object parameter. Accepted symbolic names are GL_DELETE_STATUS, GL_LINK_STATUS, GL_VALIDATE_STATUS, GL_INFO_LOG_LENGTH, GL_ATTACHED_SHADERS, GL_ACTIVE_ATTRIBUTES, GL_ACTIVE_ATTRIBUTE_MAX_LENGTH, GL_ACTIVE_UNIFORMS, GL_ACTIVE_UNIFORM_MAX_LENGTH.
params - Returns the requested object parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetProgramiv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetProgramInfoLog

String glGetProgramInfoLog(int program)
Return the information log for a program object.

Description

glGetProgramInfoLog returns the information log for the specified program object. The information log for a program object is modified when the program object is linked or validated.

The information log for a program object is either an empty string, or a string containing information about the last link operation, or a string containing information about the last validation operation. It may contain diagnostic messages, warning messages, and other information. When a program object is created, its information log will be a string of length 0.

Notes

The information log for a program object is the OpenGL implementer's primary mechanism for conveying information about linking and validating. Therefore, the information log can be helpful to application developers during the development process, even when these operations are successful. Application developers should not expect different OpenGL implementations to produce identical information logs.

Errors

GL_INVALID_VALUE if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

Associated Gets

glGetProgramiv/glGetProgramiv with argument GL_INFO_LOG_LENGTH

glIsProgram

Parameters:
program - Specifies the program object whose information log is to be queried.
Returns:
A String containing the information log.
See Also:
GL20.glCompileShader(int), GL20.glGetShaderInfoLog(int), GL20.glLinkProgram(int), GL20.glValidateProgram(int)
Since:
BlackBerry API 7.0.0

glGetProgramInfoLog

void glGetProgramInfoLog(int program,
                         int maxsize,
                         int[] length,
                         byte[] infolog)
Return the information log for a program object.

Description

glGetProgramInfoLog returns the information log for the specified program object. The information log for a program object is modified when the program object is linked or validated.

glGetProgramInfoLog returns in infolog as much of the information log as it can, up to a maximum of maxsize characters. The number of characters actually returned is specified by length. If the length of the returned string is not required, a value of null can be passed in the length argument. The size of the buffer required to store the returned information log can be obtained by calling glGetProgramiv/ glGetProgramiv with the value GL_INFO_LOG_LENGTH.

The information log for a program object is either an empty string, or a string containing information about the last link operation, or a string containing information about the last validation operation. It may contain diagnostic messages, warning messages, and other information. When a program object is created, its information log will be a string of length 0.

Notes

The information log for a program object is the OpenGL implementer's primary mechanism for conveying information about linking and validating. Therefore, the information log can be helpful to application developers during the development process, even when these operations are successful. Application developers should not expect different OpenGL implementations to produce identical information logs.

Errors

GL_INVALID_VALUE if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_VALUE is generated if maxsize is less than 0.

Associated Gets

glGetProgramiv/glGetProgramiv with argument GL_INFO_LOG_LENGTH

glIsProgram

Parameters:
program - Specifies the program object whose information log is to be queried.
maxsize - Specifies the size of the character buffer for storing the returned information log.
length - Returns (in the first element of the array) the length of the string returned in infolog. If non-null, it must have length at least 1. May be null.
infolog - Specifies an array of characters that is used to return the information log.
Throws:
IllegalArgumentException - If length is non-null but has length less than 1.
IllegalArgumentException - If infolog is null.
See Also:
GL20.glCompileShader(int), GL20.glGetShaderInfoLog(int, int, int[], byte[]), GL20.glLinkProgram(int), GL20.glValidateProgram(int)
Since:
BlackBerry API 7.0.0

glGetRenderbufferParameteriv

void glGetRenderbufferParameteriv(int target,
                                  int pname,
                                  int[] params,
                                  int offset)
Return parameters of a renderbuffer object.

Description

glGetRenderbufferParameteriv returns in params a selected parameter of the currently bound renderbuffer object.

pname names a specific renderbuffer object parameter, as follows:

GL_RENDERBUFFER_WIDTH

params returns the width in pixels of the image of the currently bound renderbuffer. The initial value is 0.

GL_RENDERBUFFER_HEIGHT

params returns the height in pixels of the image of the currently bound renderbuffer. The initial value is 0.

GL_RENDERBUFFER_INTERNAL_FORMAT

params returns the internal format of the image of the currently bound renderbuffer. The initial value is GL_RGBA4.

GL_RENDERBUFFER_RED_SIZE

params returns the resolution in bits for the red component of the image of the currently bound renderbuffer. The initial value is 0.

GL_RENDERBUFFER_GREEN_SIZE

params returns the resolution in bits for the green component of the image of the currently bound renderbuffer. The initial value is 0.

GL_RENDERBUFFER_BLUE_SIZE

params returns the resolution in bits for the blue component of the image of the currently bound renderbuffer. The initial value is 0.

GL_RENDERBUFFER_ALPHA_SIZE

params returns the resolution in bits for the alpha component of the image of the currently bound renderbuffer. The initial value is 0.

GL_RENDERBUFFER_DEPTH_SIZE

params returns the resolution in bits for the depth component of the image of the currently bound renderbuffer. The initial value is 0.

GL_RENDERBUFFER_STENCIL_SIZE

params returns the resolution in bits for the stencil component of the image of the currently bound renderbuffer. The initial value is 0.

Notes

The resolution of components reported by glGetRenderbufferParameteriv are the actual resolutions at which the components are stored, which may be different than those requested by the internalformat parameter of glRenderbufferStorage.

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

Errors

GL_INVALID_ENUM is generated if target is not GL_RENDERBUFFER.

GL_INVALID_ENUM is generated if pname is not GL_RENDERBUFFER_WIDTH, GL_RENDERBUFFER_HEIGHT, GL_RENDERBUFFER_INTERNAL_FORMAT, GL_RENDERBUFFER_RED_SIZE, GL_RENDERBUFFER_GREEN_SIZE, GL_RENDERBUFFER_BLUE_SIZE, GL_RENDERBUFFER_ALPHA_SIZE, GL_RENDERBUFFER_DEPTH_SIZE, or GL_RENDERBUFFER_STENCIL_SIZE.

GL_INVALID_OPERATION is generated if the reserved renderbuffer object name 0 is bound.

Parameters:
target - Specifies the target renderbuffer object. The symbolic constant must be GL_RENDERBUFFER.
pname - Specifies the symbolic name of a renderbuffer object parameter. Accepted values are GL_RENDERBUFFER_WIDTH, GL_RENDERBUFFER_HEIGHT, GL_RENDERBUFFER_INTERNAL_FORMAT, GL_RENDERBUFFER_RED_SIZE, GL_RENDERBUFFER_GREEN_SIZE, GL_RENDERBUFFER_BLUE_SIZE, GL_RENDERBUFFER_ALPHA_SIZE, GL_RENDERBUFFER_DEPTH_SIZE, or GL_RENDERBUFFER_STENCIL_SIZE
params - Returns the requested parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glBindRenderbuffer(int, int), GL20.glGetRenderbufferParameteriv(int, int, IntBuffer), GL20.glRenderbufferStorage(int, int, int, int)
Since:
BlackBerry API 7.0.0

glGetRenderbufferParameteriv

void glGetRenderbufferParameteriv(int target,
                                  int pname,
                                  IntBuffer params)
Integer Buffer version of glGetRenderbufferParameteriv.

Errors

GL_INVALID_ENUM is generated if target is not GL_RENDERBUFFER.

GL_INVALID_ENUM is generated if pname is not GL_RENDERBUFFER_WIDTH, GL_RENDERBUFFER_HEIGHT, GL_RENDERBUFFER_INTERNAL_FORMAT, GL_RENDERBUFFER_RED_SIZE, GL_RENDERBUFFER_GREEN_SIZE, GL_RENDERBUFFER_BLUE_SIZE, GL_RENDERBUFFER_ALPHA_SIZE, GL_RENDERBUFFER_DEPTH_SIZE, or GL_RENDERBUFFER_STENCIL_SIZE.

GL_INVALID_OPERATION is generated if the reserved renderbuffer object name 0 is bound.

Parameters:
target - Specifies the target renderbuffer object. The symbolic constant must be GL_RENDERBUFFER.
pname - Specifies the symbolic name of a renderbuffer object parameter. Accepted values are GL_RENDERBUFFER_WIDTH, GL_RENDERBUFFER_HEIGHT, GL_RENDERBUFFER_INTERNAL_FORMAT, GL_RENDERBUFFER_RED_SIZE, GL_RENDERBUFFER_GREEN_SIZE, GL_RENDERBUFFER_BLUE_SIZE, GL_RENDERBUFFER_ALPHA_SIZE, GL_RENDERBUFFER_DEPTH_SIZE, or GL_RENDERBUFFER_STENCIL_SIZE
params - Returns the requested parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetRenderbufferParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetShaderiv

void glGetShaderiv(int shader,
                   int pname,
                   int[] params,
                   int offset)
Return a parameter from a shader object

Description

glGetShaderiv returns in params the value of a parameter for a specific shader object. The following parameters are defined:

GL_SHADER_TYPE

params returns GL_VERTEX_SHADER if shader is a vertex shader object, and GL_FRAGMENT_SHADER if shader is a fragment shader object.

GL_DELETE_STATUS

params returns GL_TRUE if shader is currently flagged for deletion, and GL_FALSE otherwise.

GL_COMPILE_STATUS

For implementations that support a shader compiler, params returns GL_TRUE if the last compile operation on shader was successful, and GL_FALSE otherwise.

GL_INFO_LOG_LENGTH

For implementations that support a shader compiler, params returns the number of characters in the information log for shader (i.e., the size of the character buffer required to store the information log). If shader has no information log, a value of 0 is returned.

GL_SHADER_SOURCE_LENGTH

For implementations that support a shader compiler, params returns the length of the concatenation of the source strings that make up the shader source for shader (i.e., the size of the character buffer required to store the shader source). If no source code exists, 0 is returned.

Notes

Shader compiler support is optional, and thus must be queried before use by calling glGetIntegerv/glGetIntegerv with argument GL_SHADER_COMPILER. glShaderSource, glCompileShader, glGetShaderPrecisionFormat, and glReleaseShaderCompiler will each generate GL_INVALID_OPERATION on implementations that do not support a shader compiler, as will glGetShaderiv queries of GL_COMPILE_STATUS, GL_INFO_LOG_LENGTH, and GL_SHADER_SOURCE_LENGTH. Such implementations instead offer the glShaderBinary/ glShaderBinary alternative for supplying a pre-compiled shader binary.

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

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if pname is GL_COMPILE_STATUS, GL_INFO_LOG_LENGTH, or GL_SHADER_SOURCE_LENGTH but a shader compiler is not supported.

GL_INVALID_OPERATION is generated if shader does not refer to a shader object.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_SHADER_COMPILER

glGetShaderInfoLog with argument shader

glGetShaderSource with argument shader

glIsShader

Parameters:
shader - Specifies the shader object to be queried.
pname - Specifies the object parameter. Accepted symbolic names are GL_SHADER_TYPE, GL_DELETE_STATUS, GL_COMPILE_STATUS, GL_INFO_LOG_LENGTH, GL_SHADER_SOURCE_LENGTH.
params - Returns the requested object parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glCompileShader(int), GL20.glCreateShader(int), GL20.glDeleteShader(int), GL20.glGetProgramiv(int, int, IntBuffer), GL20.glGetProgramiv(int, int, int[], int), GL20.glShaderSource(int, int, String[], int[]), GL20.glShaderBinary(int, IntBuffer, int, Buffer, int), GL20.glShaderBinary(int, int[], int, int, Buffer, int)
Since:
BlackBerry API 7.0.0

glGetShaderiv

void glGetShaderiv(int shader,
                   int pname,
                   IntBuffer params)
Integer Buffer version of glGetShaderiv.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if pname is GL_COMPILE_STATUS, GL_INFO_LOG_LENGTH, or GL_SHADER_SOURCE_LENGTH but a shader compiler is not supported.

GL_INVALID_OPERATION is generated if shader does not refer to a shader object.

Parameters:
shader - Specifies the shader object to be queried.
pname - Specifies the object parameter. Accepted symbolic names are GL_SHADER_TYPE, GL_DELETE_STATUS, GL_COMPILE_STATUS, GL_INFO_LOG_LENGTH, GL_SHADER_SOURCE_LENGTH.
params - Returns the requested object parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetShaderiv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetShaderInfoLog

String glGetShaderInfoLog(int shader)
Return the information log for a shader object.

Description

glGetShaderInfoLog returns the information log for the specified shader object. The information log for a shader object is modified when the shader is compiled.

The information log for a shader object is a string that may contain diagnostic messages, warning messages, and other information about the last compile operation. When a shader object is created, its information log will be a string of length 0.

Notes

The information log for a shader object is the OpenGL implementer's primary mechanism for conveying information about the compilation process. Therefore, the information log can be helpful to application developers during the development process, even when compilation is successful. Application developers should not expect different OpenGL implementations to produce identical information logs.

Errors

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if shader is not a shader object.

Associated Gets

glGetShaderiv/glGetShaderiv with argument GL_INFO_LOG_LENGTH

glIsShader

Parameters:
shader - Specifies the shader object whose information log is to be queried.
Returns:
A String containing the information log.
See Also:
GL20.glCompileShader(int), GL20.glGetProgramInfoLog(int), GL20.glLinkProgram(int), GL20.glValidateProgram(int)
Since:
BlackBerry API 7.0.0

glGetShaderInfoLog

void glGetShaderInfoLog(int shader,
                        int maxsize,
                        int[] length,
                        byte[] infolog)
Return the information log for a shader object.

Description

glGetShaderInfoLog returns the information log for the specified shader object. The information log for a shader object is modified when the shader is compiled.

glGetShaderInfoLog returns in infolog as much of the information log as it can, up to a maximum of maxsize characters. The number of characters actually returned is specified by length. If the length of the returned string is not required, a value of null can be passed in the length argument. The size of the buffer required to store the returned information log can be obtained by calling glGetShaderiv/ glGetShaderiv with the value GL_INFO_LOG_LENGTH.

The information log for a shader object is a string that may contain diagnostic messages, warning messages, and other information about the last compile operation. When a shader object is created, its information log will be a string of length 0.

Notes

The information log for a shader object is the OpenGL implementer's primary mechanism for conveying information about the compilation process. Therefore, the information log can be helpful to application developers during the development process, even when compilation is successful. Application developers should not expect different OpenGL implementations to produce identical information logs.

Errors

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if shader is not a shader object.

GL_INVALID_VALUE is generated if maxsize is less than 0.

Associated Gets

glGetShaderiv/glGetShaderiv with argument GL_INFO_LOG_LENGTH

glIsShader

Parameters:
shader - Specifies the shader object whose information log is to be queried.
maxsize - Specifies the size of the character buffer for storing the returned information log.
length - Returns the length of the string returned in infolog. If non-null, it must have length at least 1. May be null.
infolog - Specifies an array of characters that is used to return the information log.
Throws:
IllegalArgumentException - If length is non-null but has length less than 1.
IllegalArgumentException - If infolog is null.
See Also:
GL20.glCompileShader(int), GL20.glGetProgramInfoLog(int, int, int[], byte[]), GL20.glLinkProgram(int), GL20.glValidateProgram(int)
Since:
BlackBerry API 7.0.0

glGetShaderPrecisionFormat

void glGetShaderPrecisionFormat(int shadertype,
                                int precisiontype,
                                int[] range,
                                int rangeOffset,
                                int[] precision,
                                int precisionOffset)
Return the range and precision for different shader numeric formats.

Description

glGetShaderPrecisionFormat returns range and precision limits for floating-point and integer shader variable formats with low, medium, and high precision qualifiers. When minRep and maxRep are the minimum and maximum representable values of the format, floor(log_2(|minRep|)) and floor(log_2(|maxRep|)) are returned in range as the first and second elements, respectively.

If the smallest representable value greater than 1 is (1 + ϵ) then floor(-log_2(ϵ)) is returned in precision. An integer format will have an ϵ of 1, and thus will return 0. Floating-point formats will return values greater than 0.

Notes

The minimum range and precision required for different formats is described in the OpenGL ES Shading Language Specification.

If a high precision floating-point format is not supported for fragment shaders, calling glGetShaderPrecisionFormat with arguments GL_FRAGMENT_SHADER and GL_HIGH_FLOAT will return 0 for both range and precision. Support for a high precision floating-point format is mandatory for vertex shaders.

Shader compiler support is optional, and thus must be queried before use by calling glGetIntegerv/ glGetIntegerv with argument GL_SHADER_COMPILER. glShaderSource, glCompileShader, glGetShaderPrecisionFormat, and glReleaseShaderCompiler will each generate GL_INVALID_OPERATION on implementations that do not support a shader compiler. Such implementations instead offer the glShaderBinary/ glShaderBinary alternative for supplying a pre-compiled shader binary.

If an error is generated, no change is made to the contents of range or precision.

Errors

GL_INVALID_OPERATION is generated if a shader compiler is not supported.

GL_INVALID_ENUM is generated if shadertype or precisiontype is not an accepted value.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_SHADER_COMPILER

Parameters:
shadertype - Specifies the type of shader to query. Must be either GL_VERTEX_SHADER or GL_FRAGMENT_SHADER.
precisiontype - Specifies the numeric format to query, corresponding to a shader precision qualifier and variable type. Must be one of GL_LOW_FLOAT, GL_MEDIUM_FLOAT, GL_HIGH_FLOAT, GL_LOW_INT, GL_MEDIUM_INT, or GL_HIGH_INT.
range - An int array of length at least 2. Specifies the two-element array in which the log_2 of the minimum and maximum representable magnitudes of the format are returned. May be null.
rangeOffset - The starting offset within the range array.
precision - An int array of length at least 1. Specifies the one-element array in which the log_2 of the precision of the format is returned. May be null.
precisionOffset - The starting offset within the precision array.
Throws:
IllegalArgumentException - If rangeOffset is less than 0.
IllegalArgumentException - If range is non-null but range.length - rangeOffset is smaller than 2.
IllegalArgumentException - If precisionOffset is less than 0.
IllegalArgumentException - If precision is non-null but but precision.length - precisionOffset is smaller than 1.
See Also:
GL20.glCompileShader(int), GL20.glShaderSource(int, int, String[], int[])
Since:
BlackBerry API 7.0.0

glGetShaderSource

String glGetShaderSource(int shader)
Return the source code string from a shader object.

Description

glGetShaderSource returns the concatenation of the source code strings from the shader object specified by shader. The source code strings for a shader object are the result of a previous call to glShaderSource.

Errors

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if shader is not a shader object.

Associated Gets

glGetShaderiv/glGetShaderiv with argument GL_SHADER_SOURCE_LENGTH

glIsShader

Parameters:
shader - Specifies the shader object to be queried.
Returns:
A String containing the shader source.
See Also:
GL20.glCreateShader(int), GL20.glShaderSource(int, int, String[], int[])
Since:
BlackBerry API 7.0.0

glGetShaderSource

void glGetShaderSource(int shader,
                       int bufSize,
                       int[] length,
                       byte[] source)
Return the source code string from a shader object.

Description

glGetShaderSource returns the concatenation of the source code strings from the shader object specified by shader. The source code strings for a shader object are the result of a previous call to glShaderSource.

glGetShaderSource returns in source as much of the source code string as it can, up to a maximum of bufSize characters. The number of characters actually returned is specified by length. If the length of the returned string is not required, a value of null can be passed in the length argument. The size of the buffer required to store the returned source code string can be obtained by calling glGetShaderiv/ glGetShaderiv with the value GL_SHADER_SOURCE_LENGTH.

Errors

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if shader is not a shader object.

GL_INVALID_VALUE is generated if bufSize is less than 0.

Associated Gets

glGetShaderiv/glGetShaderiv with argument GL_SHADER_SOURCE_LENGTH

glIsShader

Parameters:
shader - Specifies the shader object to be queried.
bufSize - Specifies the size of the character buffer for storing the returned source code string.
length - Returns the length of the string returned in source. If non-null, it must have length at least 1. May be null.
source - Specifies an array of characters that is used to return the source code string.
Throws:
IllegalArgumentException - If length is non-null but has length less than 1.
IllegalArgumentException - If source is null.
See Also:
GL20.glCreateShader(int), GL20.glShaderSource(int, int, String[], int[])
Since:
BlackBerry API 7.0.0

glGetString

String glGetString(int name)
Return a string describing the current GL connection.

Description

The GL string is converted to UTF8 format to produce a standard Java String object.

glGetString returns a string describing some aspect of the current GL connection. name can be one of the following:

GL_VENDOR

Returns the company responsible for this GL implementation. This name does not change from release to release.

GL_RENDERER

Returns the name of the renderer. This name is typically specific to a particular configuration of a hardware platform. It does not change from release to release.

GL_VERSION

Returns a version or release number of the form OpenGL<space>ES<space><version number><space><vendor-specific information>.

GL_SHADING_LANGUAGE_VERSION

Returns a version or release number for the shading language of the form OpenGL<space>ES<space>GLSL<space>ES<space><version number><space><vendor-specific information>.

GL_EXTENSIONS

Returns a space-separated list of supported extensions to GL.

Because the GL does not include queries for the performance characteristics of an implementation, some applications are written to recognize known platforms and modify their GL usage based on known performance characteristics of these platforms. Strings GL_VENDOR and GL_RENDERER together uniquely specify a platform. They do not change from release to release and should be used by platform-recognition algorithms.

Some applications want to make use of features that are not part of the standard GL. These features may be implemented as extensions to the standard GL. The GL_EXTENSIONS string is a space-separated list of supported GL extensions. (Extension names never contain a space character.)

Notes

If an error is generated, glGetString returns null.

The client and server may support different versions or extensions. glGetString always returns a compatible version number or list of extensions. The release number always describes the server.

Errors

GL_INVALID_ENUM is generated if name is not an accepted value.

Parameters:
name - Specifies a symbolic constant, one of GL_VENDOR, GL_RENDERER, GL_VERSION, GL_SHADING_LANGUAGE_VERSION, or GL_EXTENSIONS.
Returns:
A String formatted as described above.
Since:
BlackBerry API 7.0.0

glGetTexParameterfv

void glGetTexParameterfv(int target,
                         int pname,
                         float[] params,
                         int offset)
Floating-point version of glGetTexParameteriv.

Errors

GL_INVALID_ENUM is generated if target or pname is not an accepted value.

Parameters:
target - Specifies the symbolic name of the target texture. GL_TEXTURE_2D and GL_TEXTURE_CUBE_MAP are accepted.
pname - Specifies the symbolic name of a texture parameter. GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_WRAP_S, and GL_TEXTURE_WRAP_T are accepted.
params - Returns the texture parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glGetTexParameterfv(int, int, FloatBuffer), GL20.glGetTexParameteriv(int, int, IntBuffer), GL20.glGetTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetTexParameterfv

void glGetTexParameterfv(int target,
                         int pname,
                         FloatBuffer params)
Floating-point version of glGetTexParameteriv.

Errors

GL_INVALID_ENUM is generated if target or pname is not an accepted value.

Parameters:
target - Specifies the symbolic name of the target texture. GL_TEXTURE_2D and GL_TEXTURE_CUBE_MAP are accepted.
pname - Specifies the symbolic name of a texture parameter. GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_WRAP_S, and GL_TEXTURE_WRAP_T are accepted.
params - Returns the texture parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetTexParameterfv(int, int, float[], int), GL20.glGetTexParameteriv(int, int, IntBuffer), GL20.glGetTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetTexParameteriv

void glGetTexParameteriv(int target,
                         int pname,
                         int[] params,
                         int offset)
Return texture parameter values.

glGetTexParameter returns in params the value of the texture parameter specified as pname. target defines the target texture, either GL_TEXTURE_2D or GL_TEXTURE_CUBE_MAP, to specify two-dimensional or cube-mapped texturing. pname accepts the same symbols as glTexParameterf/ glTexParameterfv/ glTexParameterfv/ glTexParameteri/ glTexParameteriv/ glTexParameteriv, with the same interpretations:

GL_TEXTURE_MAG_FILTER

Returns the single-valued texture magnification filter, a symbolic constant. The initial value is GL_LINEAR.

GL_TEXTURE_MIN_FILTER

Returns the single-valued texture minification filter, a symbolic constant. The initial value is GL_NEAREST_MIPMAP_LINEAR.

GL_TEXTURE_WRAP_S

Returns the single-valued wrapping function for texture coordinate s, a symbolic constant. The initial value is GL_REPEAT.

GL_TEXTURE_WRAP_T

Returns the single-valued wrapping function for texture coordinate t, a symbolic constant. The initial value is GL_REPEAT.

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 an accepted value.

Parameters:
target - Specifies the symbolic name of the target texture. GL_TEXTURE_2D and GL_TEXTURE_CUBE_MAP are accepted.
pname - Specifies the symbolic name of a texture parameter. GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_WRAP_S, and GL_TEXTURE_WRAP_T are accepted.
params - Returns the texture parameter.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glGetTexParameterfv(int, int, FloatBuffer), GL20.glGetTexParameterfv(int, int, float[], int), GL20.glGetTexParameteriv(int, int, IntBuffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetTexParameteriv

void glGetTexParameteriv(int target,
                         int pname,
                         IntBuffer params)
Integer Buffer version of glGetTexParameteriv.

Errors

GL_INVALID_ENUM is generated if target or pname is not an accepted value.

Parameters:
target - Specifies the symbolic name of the target texture. GL_TEXTURE_2D and GL_TEXTURE_CUBE_MAP are accepted.
pname - Specifies the symbolic name of a texture parameter. GL_TEXTURE_MAG_FILTER, GL_TEXTURE_MIN_FILTER, GL_TEXTURE_WRAP_S, and GL_TEXTURE_WRAP_T are accepted.
params - Returns the texture parameter.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetTexParameterfv(int, int, FloatBuffer), GL20.glGetTexParameterfv(int, int, float[], int), GL20.glGetTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetUniformfv

void glGetUniformfv(int program,
                    int location,
                    int count,
                    float[] params,
                    int offset)
Floating-point version of glGetUniformiv.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_OPERATION is generated if program has not been successfully linked.

GL_INVALID_OPERATION is generated if location does not correspond to a valid uniform variable location for the specified program object.

Parameters:
program - Specifies the program object to be queried.
location - Specifies the location of the uniform variable to be queried.
count - Specifies the number of values to be returned.
params - Returns the value of the specified uniform variable.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glGetUniformfv(int, int, int, FloatBuffer), GL20.glGetUniformiv(int, int, int, IntBuffer), GL20.glGetUniformiv(int, int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetUniformfv

void glGetUniformfv(int program,
                    int location,
                    int count,
                    FloatBuffer params)
Floating-point version of glGetUniformiv.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_OPERATION is generated if program has not been successfully linked.

GL_INVALID_OPERATION is generated if location does not correspond to a valid uniform variable location for the specified program object.

Parameters:
program - Specifies the program object to be queried.
location - Specifies the location of the uniform variable to be queried.
count - Specifies the number of values to be returned.
params - Returns the value of the specified uniform variable.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetUniformfv(int, int, int, FloatBuffer), GL20.glGetUniformfv(int, int, int, float[], int), GL20.glGetUniformiv(int, int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetUniformiv

void glGetUniformiv(int program,
                    int location,
                    int count,
                    int[] params,
                    int offset)
Return the value of a uniform variable.

Description

glGetUniform returns in params the value(s) of the specified uniform variable. The type of the uniform variable specified by location determines the number of values returned. If the uniform variable is defined in the shader as a boolean, int, or float, a single value will be returned. If it is defined as a vec2, ivec2, or bvec2, two values will be returned. If it is defined as a vec3, ivec3, or bvec3, three values will be returned, and so on. To query values stored in uniform variables declared as arrays, call glGetUniform for each element of the array. To query values stored in uniform variables declared as structures, call glGetUniform for each field in the structure. The values for uniform variables declared as a matrix will be returned in column major order.

The locations assigned to uniform variables are not known until the program object is linked. After linking has occurred, the command glGetUniformLocation can be used to obtain the location of a uniform variable. This location value can then be passed to glGetUniform in order to query the current value of the uniform variable. After a program object has been linked successfully, the index values for uniform variables remain fixed until the next link command occurs. The uniform variable values can only be queried after a link if the link was successful.

Notes

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

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_OPERATION is generated if program has not been successfully linked.

GL_INVALID_OPERATION is generated if location does not correspond to a valid uniform variable location for the specified program object.

Associated Gets

glGetActiveUniform with arguments program and the index of an active uniform variable

glGetProgramiv/glGetProgramiv with arguments program and GL_ACTIVE_UNIFORMS or GL_ACTIVE_UNIFORM_MAX_LENGTH

glGetUniformLocation with arguments program and the name of a uniform variable

glIsProgram

Parameters:
program - Specifies the program object to be queried.
location - Specifies the location of the uniform variable to be queried.
count - Specifies the number of values to be returned.
params - Returns the value of the specified uniform variable.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glCreateProgram(), GL20.glGetUniformfv(int, int, int, FloatBuffer), GL20.glGetUniformfv(int, int, int, float[], int), GL20.glGetUniformiv(int, int, int, IntBuffer), GL20.glLinkProgram(int), GL20.glUniform1f(int, float), GL20.glUniform1fv(int, int, FloatBuffer), GL20.glUniform1fv(int, int, float[], int), GL20.glUniform1i(int, int), GL20.glUniform1iv(int, int, IntBuffer), GL20.glUniform1iv(int, int, int[], int), GL20.glUniform2f(int, float, float), GL20.glUniform2fv(int, int, FloatBuffer), GL20.glUniform2fv(int, int, float[], int), GL20.glUniform2i(int, int, int), GL20.glUniform2iv(int, int, IntBuffer), GL20.glUniform2iv(int, int, int[], int), GL20.glUniform3f(int, float, float, float), GL20.glUniform3fv(int, int, FloatBuffer), GL20.glUniform3fv(int, int, float[], int), GL20.glUniform3i(int, int, int, int), GL20.glUniform3iv(int, int, IntBuffer), GL20.glUniform3iv(int, int, int[], int), GL20.glUniform4f(int, float, float, float, float), GL20.glUniform4fv(int, int, FloatBuffer), GL20.glUniform4fv(int, int, float[], int), GL20.glUniform4i(int, int, int, int, int), GL20.glUniform4iv(int, int, IntBuffer), GL20.glUniform4iv(int, int, int[], int), GL20.glUniformMatrix2fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix2fv(int, int, boolean, float[], int), GL20.glUniformMatrix3fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix3fv(int, int, boolean, float[], int), GL20.glUniformMatrix4fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix4fv(int, int, boolean, float[], int)
Since:
BlackBerry API 7.0.0

glGetUniformiv

void glGetUniformiv(int program,
                    int location,
                    int count,
                    IntBuffer params)
Int Buffer version of glGetUniformiv.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_OPERATION is generated if program has not been successfully linked.

GL_INVALID_OPERATION is generated if location does not correspond to a valid uniform variable location for the specified program object.

Parameters:
program - Specifies the program object to be queried.
location - Specifies the location of the uniform variable to be queried.
count - Specifies the number of values to be returned.
params - Returns the value of the specified uniform variable.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetUniformfv(int, int, int, FloatBuffer), GL20.glGetUniformfv(int, int, int, float[], int), GL20.glGetUniformiv(int, int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetUniformLocation

int glGetUniformLocation(int program,
                         String name)
Return the location of a uniform variable.

Description

glGetUniformLocation returns an integer that represents the location of a specific uniform variable within a program object. name must be a string that contains no white space. name must be an active uniform variable name in program that is not a structure, an array of structures, or a subcomponent of a vector or a matrix. This function returns -1 if name does not correspond to an active uniform variable in program or if name starts with the reserved prefix "gl_".

Uniform variables that are structures or arrays of structures may be queried by calling glGetUniformLocation for each field within the structure. The array element operator "[]" and the structure field operator "." may be used in name in order to select elements within an array or fields within a structure. The result of using these operators is not allowed to be another structure, an array of structures, or a subcomponent of a vector or a matrix. Except if the last part of name indicates a uniform variable array, the location of the first element of an array can be retrieved by using the name of the array, or by using the name appended by "[0]".

The actual locations assigned to uniform variables are not known until the program object is linked successfully. After linking has occurred, the command glGetUniformLocation can be used to obtain the location of a uniform variable. This location value can then be passed to glUniform1f/ glUniform1fv/ glUniform1fv/ glUniform1i/ glUniform1iv/ glUniform1iv/ glUniform2f/ glUniform2fv/ glUniform2fv/ glUniform2i/ glUniform2iv/ glUniform2iv/ glUniform3f/ glUniform3fv/ glUniform3fv/ glUniform3i/ glUniform3iv/ glUniform3iv/ glUniform4f/ glUniform4fv/ glUniform4fv/ glUniform4i/ glUniform4iv/ glUniform4iv/ glUniformMatrix2fv/ glUniformMatrix2fv/ glUniformMatrix3fv/ glUniformMatrix3fv/ glUniformMatrix4fv/ glUniformMatrix4fv to set the value of the uniform variable or to glGetUniformfv/ glGetUniformfv/ glGetUniformiv/ glGetUniformiv in order to query the current value of the uniform variable. After a program object has been linked successfully, the index values for uniform variables remain fixed until the next link command occurs. Uniform variable locations and values can only be queried after a link if the link was successful.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

GL_INVALID_OPERATION is generated if program has not been successfully linked.

Associated Gets

glGetActiveUniform with arguments program and the index of an active uniform variable

glGetProgramiv/glGetProgramiv with arguments program and GL_ACTIVE_UNIFORMS or GL_ACTIVE_UNIFORM_MAX_LENGTH

glGetUniformfv/ glGetUniformfv/ glGetUniformiv/ glGetUniformiv with arguments program and the name of a uniform variable

glIsProgram

Parameters:
program - Specifies the program object to be queried.
name - Specifies a String containing the name of the uniform whose location is to be queried.
Returns:
Returns the uniform location.
Throws:
IllegalArgumentException - If name is null.
See Also:
GL20.glLinkProgram(int), GL20.glUniform1f(int, float), GL20.glUniform1fv(int, int, FloatBuffer), GL20.glUniform1fv(int, int, float[], int), GL20.glUniform1i(int, int), GL20.glUniform1iv(int, int, IntBuffer), GL20.glUniform1iv(int, int, int[], int), GL20.glUniform2f(int, float, float), GL20.glUniform2fv(int, int, FloatBuffer), GL20.glUniform2fv(int, int, float[], int), GL20.glUniform2i(int, int, int), GL20.glUniform2iv(int, int, IntBuffer), GL20.glUniform2iv(int, int, int[], int), GL20.glUniform3f(int, float, float, float), GL20.glUniform3fv(int, int, FloatBuffer), GL20.glUniform3fv(int, int, float[], int), GL20.glUniform3i(int, int, int, int), GL20.glUniform3iv(int, int, IntBuffer), GL20.glUniform3iv(int, int, int[], int), GL20.glUniform4f(int, float, float, float, float), GL20.glUniform4fv(int, int, FloatBuffer), GL20.glUniform4fv(int, int, float[], int), GL20.glUniform4i(int, int, int, int, int), GL20.glUniform4iv(int, int, IntBuffer), GL20.glUniform4iv(int, int, int[], int), GL20.glUniformMatrix2fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix2fv(int, int, boolean, float[], int), GL20.glUniformMatrix3fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix3fv(int, int, boolean, float[], int), GL20.glUniformMatrix4fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix4fv(int, int, boolean, float[], int)
Since:
BlackBerry API 7.0.0

glGetVertexAttribfv

void glGetVertexAttribfv(int index,
                         int pname,
                         float[] params,
                         int offset)
Floating-point version of glGetVertexAttribiv.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if index is greater than or equal to GL_MAX_VERTEX_ATTRIBS.

Parameters:
index - Specifies the generic vertex attribute parameter to be queried.
pname - Specifies the symbolic name of the vertex attribute parameter to be queried. Accepted values are GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING, GL_VERTEX_ATTRIB_ARRAY_ENABLED, GL_VERTEX_ATTRIB_ARRAY_SIZE, GL_VERTEX_ATTRIB_ARRAY_STRIDE, GL_VERTEX_ATTRIB_ARRAY_TYPE, GL_VERTEX_ATTRIB_ARRAY_NORMALIZED, or GL_CURRENT_VERTEX_ATTRIB.
params - Returns the requested data.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glGetVertexAttribfv(int, int, FloatBuffer), GL20.glGetVertexAttribiv(int, int, IntBuffer), GL20.glGetVertexAttribiv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetVertexAttribfv

void glGetVertexAttribfv(int index,
                         int pname,
                         FloatBuffer params)
Floating-point version of glGetVertexAttribiv.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if index is greater than or equal to GL_MAX_VERTEX_ATTRIBS.

Parameters:
index - Specifies the generic vertex attribute parameter to be queried.
pname - Specifies the symbolic name of the vertex attribute parameter to be queried. Accepted values are GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING, GL_VERTEX_ATTRIB_ARRAY_ENABLED, GL_VERTEX_ATTRIB_ARRAY_SIZE, GL_VERTEX_ATTRIB_ARRAY_STRIDE, GL_VERTEX_ATTRIB_ARRAY_TYPE, GL_VERTEX_ATTRIB_ARRAY_NORMALIZED, or GL_CURRENT_VERTEX_ATTRIB.
params - Returns the requested data.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetVertexAttribfv(int, int, float[], int), GL20.glGetVertexAttribiv(int, int, IntBuffer), GL20.glGetVertexAttribiv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glGetVertexAttribiv

void glGetVertexAttribiv(int index,
                         int pname,
                         int[] params,
                         int offset)
Return a generic vertex attribute parameter.

Description

glGetVertexAttrib returns in params the value of a generic vertex attribute parameter. The generic vertex attribute to be queried is specified by index, and the parameter to be queried is specified by pname.

The accepted parameter names are as follows:

GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING

params returns a single value, the name of the buffer object currently bound to the binding point corresponding to generic vertex attribute array index. If no buffer object is bound, 0 is returned. The initial value is 0.

GL_VERTEX_ATTRIB_ARRAY_ENABLED

params returns a single value that is non-zero (true) if the vertex attribute array for index is enabled and 0 (false) if it is disabled. The initial value is GL_FALSE.

GL_VERTEX_ATTRIB_ARRAY_SIZE

params returns a single value, the size of the vertex attribute array for index. The size is the number of values for each element of the vertex attribute array, and it will be 1, 2, 3, or 4. The initial value is 4.

GL_VERTEX_ATTRIB_ARRAY_STRIDE

params returns a single value, the array stride for (number of bytes between successive elements in) the vertex attribute array for index. A value of 0 indicates that the array elements are stored sequentially in memory. The initial value is 0.

GL_VERTEX_ATTRIB_ARRAY_TYPE

params returns a single value, a symbolic constant indicating the array type for the vertex attribute array for index. Possible values are GL_BYTE, GL_UNSIGNED_BYTE, GL_SHORT, GL_UNSIGNED_SHORT, GL_FIXED, and GL_FLOAT. The initial value is GL_FLOAT.

GL_VERTEX_ATTRIB_ARRAY_NORMALIZED

params returns a single value that is non-zero (true) if fixed-point data types for the vertex attribute array indicated by index are normalized when they are converted to floating point, and 0 (false) otherwise. The initial value is GL_FALSE.

GL_CURRENT_VERTEX_ATTRIB

params returns four values that represent the current value for the generic vertex attribute specified by index. The initial value is (0,0,0,1).

All of the parameters except GL_CURRENT_VERTEX_ATTRIB represent client-side state.

Notes

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

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if index is greater than or equal to GL_MAX_VERTEX_ATTRIBS.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_MAX_VERTEX_ATTRIBS

Parameters:
index - Specifies the generic vertex attribute parameter to be queried.
pname - Specifies the symbolic name of the vertex attribute parameter to be queried. Accepted values are GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING, GL_VERTEX_ATTRIB_ARRAY_ENABLED, GL_VERTEX_ATTRIB_ARRAY_SIZE, GL_VERTEX_ATTRIB_ARRAY_STRIDE, GL_VERTEX_ATTRIB_ARRAY_TYPE, GL_VERTEX_ATTRIB_ARRAY_NORMALIZED, or GL_CURRENT_VERTEX_ATTRIB.
params - Returns the requested data.
offset - The starting offset within the params array.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If offset is less than 0.
IllegalArgumentException - If params.length - offset is smaller than the number of values required by the parameter.
See Also:
GL20.glBindAttribLocation(int, int, String), GL20.glBindBuffer(int, int), GL20.glDisableVertexAttribArray(int), GL20.glEnableVertexAttribArray(int), GL20.glGetVertexAttribfv(int, int, FloatBuffer), GL20.glGetVertexAttribfv(int, int, float[], int), GL20.glGetVertexAttribiv(int, int, IntBuffer), GL20.glVertexAttrib1f(int, float), GL20.glVertexAttrib1fv(int, FloatBuffer), GL20.glVertexAttrib1fv(int, float[], int), GL20.glVertexAttrib2f(int, float, float), GL20.glVertexAttrib2fv(int, FloatBuffer), GL20.glVertexAttrib2fv(int, float[], int), GL20.glVertexAttrib3f(int, float, float, float), GL20.glVertexAttrib3fv(int, FloatBuffer), GL20.glVertexAttrib3fv(int, float[], int), GL20.glVertexAttrib4f(int, float, float, float, float), GL20.glVertexAttrib4fv(int, FloatBuffer), GL20.glVertexAttrib4fv(int, float[], int)
Since:
BlackBerry API 7.0.0

glGetVertexAttribiv

void glGetVertexAttribiv(int index,
                         int pname,
                         IntBuffer params)
Integer Buffer version of glGetVertexAttribiv.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if index is greater than or equal to GL_MAX_VERTEX_ATTRIBS.

Parameters:
index - Specifies the generic vertex attribute parameter to be queried.
pname - Specifies the symbolic name of the vertex attribute parameter to be queried. Accepted values are GL_VERTEX_ATTRIB_ARRAY_BUFFER_BINDING, GL_VERTEX_ATTRIB_ARRAY_ENABLED, GL_VERTEX_ATTRIB_ARRAY_SIZE, GL_VERTEX_ATTRIB_ARRAY_STRIDE, GL_VERTEX_ATTRIB_ARRAY_TYPE, GL_VERTEX_ATTRIB_ARRAY_NORMALIZED, or GL_CURRENT_VERTEX_ATTRIB.
params - Returns the requested data.
Throws:
IllegalArgumentException - If params is null.
IllegalArgumentException - If params.remaining() is smaller than the number of values required by the parameter.
See Also:
GL20.glGetVertexAttribfv(int, int, FloatBuffer), GL20.glGetVertexAttribfv(int, int, float[], int), GL20.glGetVertexAttribiv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glHint

void glHint(int target,
            int mode)
Specify implementation-specific hints.

Description

Certain aspects of GL behavior, when there is room for interpretation, can be controlled with hints. A hint is specified with two arguments. target is a symbolic constant indicating the behavior to be controlled, and mode is another symbolic constant indicating the desired behavior. The initial value for each target is GL_DONT_CARE. mode can be one of the following:

GL_FASTEST

The most efficient option should be chosen.

GL_NICEST

The most correct, or highest quality, option should be chosen.

GL_DONT_CARE

No preference.

Though the implementation aspects that can be hinted are well defined, the interpretation of the hints depends on the implementation. The hint aspects that can be specified with target, along with suggested semantics, are as follows:

GL_GENERATE_MIPMAP_HINT

Indicates the quality of filtering when generating mipmap images with glGenerateMipmap.

Notes

The interpretation of hints depends on the implementation. Some implementations ignore glHint settings.

Errors

GL_INVALID_ENUM is generated if either target or mode is not an accepted value.

Parameters:
target - Specifies a symbolic constant indicating the behavior to be controlled. GL_GENERATE_MIPMAP_HINT is accepted.
mode - Specifies a symbolic constant indicating the desired behavior. GL_FASTEST, GL_NICEST, and GL_DONT_CARE are accepted.
See Also:
GL20.glGenerateMipmap(int)
Since:
BlackBerry API 7.0.0

glIsBuffer

boolean glIsBuffer(int buffer)
Determine if a name corresponds to a buffer object.

Description

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, or if an error occurs, glIsBuffer returns false.

A name returned by glGenBuffers/ glGenBuffers, but not yet associated with a buffer object by calling glBindBuffer, is not the name of a buffer object.

Parameters:
buffer - Specifies a value that may be the name of a buffer object.
Returns:
true if buffer is the name of a buffer object.
See Also:
GL20.glBindBuffer(int, int), GL20.glDeleteBuffers(int, IntBuffer), GL20.glDeleteBuffers(int, int[], int), GL20.glGenBuffers(int, IntBuffer), GL20.glGenBuffers(int, int[], int), GL20.glGetBooleanv(int, IntBuffer), GL20.glGetBooleanv(int, boolean[], int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int)
Since:
BlackBerry API 7.0.0

glIsEnabled

boolean glIsEnabled(int cap)
Test whether a capability is enabled

glIsEnabled returns true if cap is an enabled capability and returns false otherwise. Initially all capabilities except GL_DITHER are disabled; GL_DITHER is initially enabled.

The following capabilities are accepted for cap:

ConstantSee
GL_BLENDglBlendFunc
GL_CULL_FACEglCullFace
GL_DEPTH_TEST glDepthFunc, glDepthRangef
GL_DITHERglEnable
GL_POLYGON_OFFSET_FILLglPolygonOffset
GL_SAMPLE_ALPHA_TO_COVERAGEglSampleCoverage
GL_SAMPLE_COVERAGEglSampleCoverage
GL_SCISSOR_TESTglScissor
GL_STENCIL_TEST glStencilFunc, glStencilOp

Notes

If an error is generated, glIsEnabled returns false.

Errors

GL_INVALID_ENUM is generated if cap is not an accepted value.

Parameters:
cap - Specifies a symbolic constant indicating a GL capability.
Returns:
true if the given capability is enabled.
See Also:
GL20.glEnable(int), GL20.glGetBooleanv(int, IntBuffer), GL20.glGetBooleanv(int, boolean[], int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int)
Since:
BlackBerry API 7.0.0

glIsFramebuffer

boolean glIsFramebuffer(int framebuffer)
Determine if a name corresponds to a framebuffer object.

Description

glIsFramebuffer returns true if framebuffer is currently the name of a framebuffer object. If framebuffer is zero, or is a non-zero value that is not currently the name of a framebuffer object, or if an error occurs, glIsFramebuffer returns false.

A name returned by glGenFramebuffers/ glGenFramebuffers, but not yet associated with a framebuffer object by calling glBindFramebuffer, is not the name of a framebuffer object.

Parameters:
framebuffer - Specifies a value that may be the name of a framebuffer object.
Returns:
true if framebuffer is the name of a framebuffer object.
See Also:
GL20.glBindFramebuffer(int, int), GL20.glDeleteFramebuffers(int, IntBuffer), GL20.glDeleteFramebuffers(int, int[], int), GL20.glGenFramebuffers(int, IntBuffer), GL20.glGenFramebuffers(int, int[], int)
Since:
BlackBerry API 7.0.0

glIsProgram

boolean glIsProgram(int program)
Determine if a name corresponds to a program object.

Description

glIsProgram returns true if program is the name of a program object previously created with glCreateProgram and not yet deleted with glDeleteProgram. If program is zero or a non-zero value that is not the name of a program object, or if an error occurs, glIsProgram returns false.

Notes

No error is generated if program is not a valid program object name.

A program object marked for deletion with glDeleteProgram but still in use as part of current rendering state is still considered a program object and glIsProgram will return true.

Parameters:
program - Specifies a potential program object.
Returns:
true if program is the name of a program object.
See Also:
GL20.glCreateProgram(), GL20.glDeleteProgram(int), GL20.glUseProgram(int)
Since:
BlackBerry API 7.0.0

glIsRenderbuffer

boolean glIsRenderbuffer(int renderbuffer)
Determine if a name corresponds to a renderbuffer object.

Description

glIsRenderbuffer returns true if renderbuffer is currently the name of a renderbuffer object. If renderbuffer is zero, or is a non-zero value that is not currently the name of a renderbuffer object, or if an error occurs, glIsRenderbuffer returns false.

A name returned by glGenRenderbuffers/ glGenRenderbuffers, but not yet associated with a renderbuffer object by calling glBindRenderbuffer, is not the name of a renderbuffer object.

Parameters:
renderbuffer - Specifies a value that may be the name of a renderbuffer object.
Returns:
true if renderbuffer is the name of a renderbuffer object.
See Also:
GL20.glBindRenderbuffer(int, int), GL20.glDeleteRenderbuffers(int, IntBuffer), GL20.glDeleteRenderbuffers(int, int[], int), GL20.glGenRenderbuffers(int, IntBuffer), GL20.glGenRenderbuffers(int, int[], int)
Since:
BlackBerry API 7.0.0

glIsShader

boolean glIsShader(int shader)
Determine if a name corresponds to a shader object.

Description

glIsShader returns true if shader is the name of a shader object previously created with glCreateShader and not yet deleted with glDeleteShader. If shader is zero or a non-zero value that is not the name of a shader object, or if an error occurs, glIsShader returns false.

Notes

No error is generated if shader is not a valid shader object name.

A shader object marked for deletion with glDeleteShader but still attached to a program object is still considered a shader object and glIsShader will return true.

Parameters:
shader - Specifies a potential shader object.
Returns:
true if shader is the name of a shader object.
See Also:
GL20.glCreateShader(int), GL20.glDeleteShader(int)
Since:
BlackBerry API 7.0.0

glIsTexture

boolean glIsTexture(int texture)
Determine if a name corresponds to a texture.

Description

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.

A name returned by glGenTextures/glGenTextures, but not yet associated with a texture by calling glBindTexture, is not the name of a texture.

Parameters:
texture - Specifies a value that may be the name of a texture.
Returns:
true if texture is the name of a texture object.
See Also:
GL20.glBindTexture(int, int), GL20.glCopyTexImage2D(int, int, int, int, int, int, int, int), GL20.glDeleteTextures(int, IntBuffer), GL20.glDeleteTextures(int, int[], int), GL20.glGenTextures(int, IntBuffer), GL20.glGenTextures(int, int[], int), GL20.glGetBooleanv(int, IntBuffer), GL20.glGetBooleanv(int, boolean[], int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int), GL20.glGetTexParameterfv(int, int, FloatBuffer), GL20.glGetTexParameterfv(int, int, float[], int), GL20.glGetTexParameteriv(int, int, IntBuffer), GL20.glGetTexParameteriv(int, int, int[], int), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexParameterf(int, int, float), GL20.glTexParameterfv(int, int, FloatBuffer), GL20.glTexParameterfv(int, int, float[], int), GL20.glTexParameteri(int, int, int), GL20.glTexParameteriv(int, int, IntBuffer), GL20.glTexParameteriv(int, int, int[], int)
Since:
BlackBerry API 7.0.0

glLineWidth

void glLineWidth(float width)
Specify the width of rasterized lines

Description

glLineWidth specifies the rasterized width of lines.

The actual width is determined by rounding the supplied width to the nearest integer. (If the rounding results in the value 0, it is as if the line width were 1.) If Δx >= Δy, i pixels are filled in each column that is rasterized, where i is the rounded value of width. Otherwise, i pixels are filled in each row that is rasterized.

There is a range of supported line widths. Only width 1 is guaranteed to be supported; others depend on the implementation. To query the range of supported widths, call glGetIntegerv/glGetIntegerv with argument GL_ALIASED_LINE_WIDTH_RANGE.

Notes

The line width specified by glLineWidth is always returned when GL_LINE_WIDTH is queried. Clamping and rounding have no effect on the specified value.

Line width may be clamped to an implementation-dependent maximum. Call glGetIntegerv/glGetIntegerv with GL_ALIASED_LINE_WIDTH_RANGE to determine the maximum width.

Errors

GL_INVALID_VALUE is generated if width is less than or equal to 0.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_LINE_WIDTH

glGetIntegerv/glGetIntegerv with argument GL_ALIASED_LINE_WIDTH_RANGE

Parameters:
width - Specifies the width of rasterized lines. The initial value is 1.
See Also:
GL20.glEnable(int)
Since:
BlackBerry API 7.0.0

glLinkProgram

void glLinkProgram(int program)
Link a program object.

Description

glLinkProgram links the program object specified by program. Shader objects of type GL_VERTEX_SHADER attached to program are used to create an executable that will run on the programmable vertex processor. Shader objects of type GL_FRAGMENT_SHADER attached to program are used to create an executable that will run on the programmable fragment processor.

The status of the link operation will be stored as part of the program object's state. This value will be set to GL_TRUE if the program object was linked without errors and is ready for use, and GL_FALSE otherwise. It can be queried by calling glGetProgramiv/ glGetProgramiv with arguments program and GL_LINK_STATUS.

As a result of a successful link operation, all active user-defined uniform variables belonging to program will be initialized to 0, and each of the program object's active uniform variables will be assigned a location that can be queried by calling glGetUniformLocation. Also, any active user-defined attribute variables that have not been bound to a generic vertex attribute index will be bound to one at this time.

Linking of a program object can fail for a number of reasons as specified in the OpenGL ES Shading Language Specification. The following lists some of the conditions that will cause a link error.

  • A vertex shader and a fragment shader are not both present in the program object.

  • The number of active attribute variables supported by the implementation has been exceeded.

  • The storage limit for uniform variables has been exceeded.

  • The number of active uniform variables supported by the implementation has been exceeded.

  • The main function is missing for the vertex shader or the fragment shader.

  • A varying variable actually used in the fragment shader is not declared in the same way (or is not declared at all) in the vertex shader.

  • A reference to a function or variable name is unresolved.

  • A shared global is declared with two different types or two different initial values.

  • One or more of the attached shader objects has not been successfully compiled (via glCompileShader) or loaded with a pre-compiled shader binary (via glShaderBinary/ glShaderBinary).

  • Binding a generic attribute matrix caused some rows of the matrix to fall outside the allowed maximum of GL_MAX_VERTEX_ATTRIBS.

  • Not enough contiguous vertex attribute slots could be found to bind attribute matrices.

When a program object has been successfully linked, the program object can be made part of current state by calling glUseProgram. Whether or not the link operation was successful, the program object's information log will be overwritten. The information log can be retrieved by calling glGetProgramInfoLog.

glLinkProgram will also install the generated executables as part of the current rendering state if the link operation was successful and the specified program object is already currently in use as a result of a previous call to glUseProgram. If the program object currently in use is relinked unsuccessfully, its link status will be set to GL_FALSE, but the executables and associated state will remain part of the current state until a subsequent call to glUseProgram removes it from use. After it is removed from use, it cannot be made part of current state until it has been successfully relinked.

The program object's information log is updated and the program is generated at the time of the link operation. After the link operation, applications are free to modify attached shader objects, compile attached shader objects, detach shader objects, delete shader objects, and attach additional shader objects. None of these operations affects the information log or the program that is part of the program object.

Notes

If the link operation is unsuccessful, any information about a previous link operation on program is lost (i.e., a failed link does not restore the old state of program). Certain information can still be retrieved from program even after an unsuccessful link operation. See for instance glGetActiveAttrib and glGetActiveUniform.

Errors

GL_INVALID_VALUE is generated if program is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if program is not a program object.

Associated Gets

glGetIntegerv/glGetIntegerv with the argument GL_CURRENT_PROGRAM

glGetActiveAttrib with argument program and the index of an active attribute variable

glGetActiveUniform with argument program and the index of an active uniform variable

glGetAttachedShaders/ glGetAttachedShaders with argument program

glGetAttribLocation with argument program and an attribute variable name

glGetProgramiv/glGetProgramiv with arguments program and GL_LINK_STATUS

glGetProgramInfoLog with argument program

glGetUniformfv/ glGetUniformfv/ glGetUniformiv/ glGetUniformiv with argument program and a uniform variable location

glGetUniformLocation with argument program and a uniform variable name

glIsProgram

Parameters:
program - Specifies the handle of the program object to be linked.
See Also:
GL20.glAttachShader(int, int), GL20.glBindAttribLocation(int, int, String), GL20.glCompileShader(int), GL20.glShaderBinary(int, IntBuffer, int, Buffer, int), GL20.glShaderBinary(int, int[], int, int, Buffer, int), GL20.glCreateProgram(), GL20.glDeleteProgram(int), GL20.glDetachShader(int, int), GL20.glUniform1f(int, float), GL20.glUniform1fv(int, int, FloatBuffer), GL20.glUniform1fv(int, int, float[], int), GL20.glUniform1i(int, int), GL20.glUniform1iv(int, int, IntBuffer), GL20.glUniform1iv(int, int, int[], int), GL20.glUniform2f(int, float, float), GL20.glUniform2fv(int, int, FloatBuffer), GL20.glUniform2fv(int, int, float[], int), GL20.glUniform2i(int, int, int), GL20.glUniform2iv(int, int, IntBuffer), GL20.glUniform2iv(int, int, int[], int), GL20.glUniform3f(int, float, float, float), GL20.glUniform3fv(int, int, FloatBuffer), GL20.glUniform3fv(int, int, float[], int), GL20.glUniform3i(int, int, int, int), GL20.glUniform3iv(int, int, IntBuffer), GL20.glUniform3iv(int, int, int[], int), GL20.glUniform4f(int, float, float, float, float), GL20.glUniform4fv(int, int, FloatBuffer), GL20.glUniform4fv(int, int, float[], int), GL20.glUniform4i(int, int, int, int, int), GL20.glUniform4iv(int, int, IntBuffer), GL20.glUniform4iv(int, int, int[], int), GL20.glUniformMatrix2fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix2fv(int, int, boolean, float[], int), GL20.glUniformMatrix3fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix3fv(int, int, boolean, float[], int), GL20.glUniformMatrix4fv(int, int, boolean, FloatBuffer), GL20.glUniformMatrix4fv(int, int, boolean, float[], int), GL20.glUseProgram(int), GL20.glValidateProgram(int)
Since:
BlackBerry API 7.0.0

glPixelStorei

void glPixelStorei(int pname,
                   int param)
Set pixel storage modes.

Description

glPixelStorei sets pixel storage modes that affect the operation of subsequent glReadPixels as well as the unpacking of texture patterns (see glTexImage2D and glTexSubImage2D).

pname is a symbolic constant indicating the parameter to be set, and param is the new value. One storage parameter affects how pixel data is returned to client memory:

GL_PACK_ALIGNMENT

Specifies the alignment requirements for the start of each pixel row in memory. The allowable values are 1 (byte-alignment), 2 (rows aligned to even-numbered bytes), 4 (word-alignment), and 8 (rows start on double-word boundaries).

The other storage parameter affects how pixel data is read from client memory:

GL_UNPACK_ALIGNMENT

Specifies the alignment requirements for the start of each pixel row in memory. The allowable values are 1 (byte-alignment), 2 (rows aligned to even-numbered bytes), 4 (word-alignment), and 8 (rows start on double-word boundaries).

The following table gives the type, initial value, and range of valid values for each storage parameter that can be set with glPixelStorei.

pnameTypeInitial ValueValid Range
GL_PACK_ALIGNMENTinteger41, 2, 4, or 8
GL_UNPACK_ALIGNMENTinteger41, 2, 4, or 8

Boolean parameters are set to false if param is 0 and true otherwise.

Errors

GL_INVALID_ENUM is generated if pname is not an accepted value.

GL_INVALID_VALUE is generated if alignment is specified as other than 1, 2, 4, or 8.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_PACK_ALIGNMENT or GL_UNPACK_ALIGNMENT

Parameters:
pname - Specifies the symbolic name of the parameter to be set. One value affects the packing of pixel data into memory: GL_PACK_ALIGNMENT. The other affects the unpacking of pixel data from memory: GL_UNPACK_ALIGNMENT.
param - Specifies the value that pname is set to.
See Also:
GL20.glReadPixels(int, int, int, int, int, int, Buffer), GL20.glTexImage2D(int, int, int, int, int, int, int, int, Buffer), GL20.glTexSubImage2D(int, int, int, int, int, int, int, int, Buffer)
Since:
BlackBerry API 7.0.0

glPolygonOffset

void glPolygonOffset(float factor,
                     float units)
Set the scale and units used to calculate depth values.

Description

When GL_POLYGON_OFFSET_FILL is enabled, each fragment's depth value will be offset after it is interpolated from the depth values of the appropriate vertices. The value of the offset is factor DZ + r units, where DZ is a measurement of the change in depth relative to the screen area of the polygon, and r is the smallest value that is guaranteed to produce a resolvable offset for a given implementation. The offset is added before the depth test is performed and before the value is written into the depth buffer.

glPolygonOffset is useful for rendering hidden-line images, for applying decals to surfaces, and for rendering solids with highlighted edges.

Associated Gets

glIsEnabled with argument GL_POLYGON_OFFSET_FILL.

glGetIntegerv/glGetIntegerv with argument GL_POLYGON_OFFSET_FACTOR or GL_POLYGON_OFFSET_UNITS.

Parameters:
factor - Specifies a scale factor that is used to create a variable depth offset for each polygon. The initial value is 0.
units - Is multiplied by an implementation-specific value to create a constant depth offset. The initial value is 0.
See Also:
GL20.glDepthFunc(int), GL20.glEnable(int), GL20.glGetIntegerv(int, IntBuffer), GL20.glGetIntegerv(int, int[], int), GL20.glIsEnabled(int)
Since:
BlackBerry API 7.0.0

glReadPixels

void glReadPixels(int x,
                  int y,
                  int width,
                  int height,
                  int format,
                  int type,
                  Buffer pixels)
Read a block of pixels from the frame buffer.

Description

glReadPixels returns pixel data from the frame buffer, starting with the pixel whose lower left corner is at location (x, y), into client memory in the buffer data. The GL_PACK_ALIGNMENT parameter, set with the glPixelStorei command, affects the processing of the pixel data before it is placed into client memory.

glReadPixels returns values from each pixel with lower left corner at (x + i, y + j) for 0 <= i < width and 0 <= j < height. This pixel is said to be the ith pixel in the jth row. Pixels are returned in row order from the lowest to the highest row, left to right in each row.

format specifies the format for the returned pixel values; accepted values are:

GL_ALPHA
GL_RGB
GL_RGBA

RGBA color components are read from the color buffer. Each color component is converted to floating point such that zero intensity maps to 0.0 and full intensity maps to 1.0.

Unneeded data is then discarded. For example, GL_ALPHA discards the red, green, and blue components, while GL_RGB discards only the alpha component. The final values are clamped to the range [0, 1].

Finally, the components are converted to the proper format, as specified by type. When type is GL_UNSIGNED_BYTE, each component is multiplied by 2^8 - 1. When type is GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_4_4_4_4, or GL_UNSIGNED_SHORT_5_5_5_1, each component is multiplied by 2^N - 1, where N is the number of bits in the bitfield.

Return values are placed in memory as follows. If format is GL_ALPHA, a single value is returned and the data for the ith pixel in the jth row is placed in location j width + i. GL_RGB returns three values and GL_RGBA returns four values for each pixel, with all values corresponding to a single pixel occupying contiguous space in data. Storage parameter GL_PACK_ALIGNMENT, set by glPixelStorei, affects the way that data is written into memory. See glPixelStorei for a description.

Notes

If the currently bound framebuffer is not the default framebuffer object, color components are read from the color image attached to the GL_COLOR_ATTACHMENT0 attachment point.

Only two format/type parameter pairs are accepted. GL_RGBA/GL_UNSIGNED_BYTE is always accepted, and the other acceptable pair can be discovered by querying GL_IMPLEMENTATION_COLOR_READ_FORMAT and GL_IMPLEMENTATION_COLOR_READ_TYPE.

Values for pixels that lie outside the window connected to the current GL context are undefined.

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

Errors

GL_INVALID_ENUM is generated if format or type is not an accepted value.

GL_INVALID_VALUE is generated if either width or height is negative.

GL_INVALID_OPERATION is generated if type is GL_UNSIGNED_SHORT_5_6_5 and format is not GL_RGB.

GL_INVALID_OPERATION is generated if type is GL_UNSIGNED_SHORT_4_4_4_4 or GL_UNSIGNED_SHORT_5_5_5_1 and format is not GL_RGBA.

GL_INVALID_OPERATION is generated if format and type are neither GL_RGBA and GL_UNSIGNED_BYTE, respectively, nor the format/type pair returned by querying GL_IMPLEMENTATION_COLOR_READ_FORMAT and GL_IMPLEMENTATION_COLOR_READ_TYPE.

GL_INVALID_FRAMEBUFFER_OPERATION is generated if the currently bound framebuffer is not framebuffer complete (i.e. the return value from glCheckFramebufferStatus is not GL_FRAMEBUFFER_COMPLETE).

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_IMPLEMENTATION_COLOR_READ_FORMAT or GL_IMPLEMENTATION_COLOR_READ_TYPE

glGetIntegerv/glGetIntegerv with argument GL_PACK_ALIGNMENT

Parameters:
x - Specifies the x window coordinate of the first pixel that is read from the frame buffer. This location is the lower left corner of a rectangular block of pixels.
y - Specifies the y window coordinate of the first pixel that is read from the frame buffer. This location is the lower left corner of a rectangular block of pixels.
width - Specifies the width of the pixel rectangle. A width and height of one correspond to a single pixel.
height - Specifies the height dimension of the pixel rectangle. A width and height of one correspond to a single pixel.
format - Specifies the format of the pixel data. The following symbolic values are accepted: GL_ALPHA, GL_RGB, and GL_RGBA.
type - Specifies the data type of the pixel data. Must be one of GL_UNSIGNED_BYTE, GL_UNSIGNED_SHORT_5_6_5, GL_UNSIGNED_SHORT_4_4_4_4, or GL_UNSIGNED_SHORT_5_5_5_1.
pixels - Returns the pixel data.
Throws:
IllegalArgumentException - If pixels is null.
IllegalArgumentException - If pixels does not contain enough room for the pixel data.
See Also:
GL20.glCheckFramebufferStatus(int), GL20.glPixelStorei(int, int)
Since:
BlackBerry API 7.0.0

glReleaseShaderCompiler

void glReleaseShaderCompiler()
Release resources allocated by the shader compiler.

Description

For implementations that support a shader compiler, glReleaseShaderCompiler frees resources allocated by the shader compiler. This is a hint from the application that additional shader compilations are unlikely to occur, at least for some period of time, and that the resources consumed by the shader compiler may be released and put to better use elsewhere.

However, if a call to glCompileShader is made after a call to glReleaseShaderCompiler, the shader compiler must be restored to service the compilation request as if glReleaseShaderCompiler had never been called.

Notes

Shader compiler support is optional, and thus must be queried before use by calling glGetIntegerv/ glGetIntegerv with argument GL_SHADER_COMPILER. glShaderSource, glCompileShader, glGetShaderPrecisionFormat, and glReleaseShaderCompiler will each generate GL_INVALID_OPERATION on implementations that do not support a shader compiler. Such implementations instead offer the glShaderBinary alternative for supplying a pre-compiled shader binary.

Errors

GL_INVALID_OPERATION is generated if a shader compiler is not supported.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_SHADER_COMPILER

See Also:
GL20.glCompileShader(int), GL20.glShaderSource(int, int, String[], int[])
Since:
BlackBerry API 7.0.0

glRenderbufferStorage

void glRenderbufferStorage(int target,
                           int internalformat,
                           int width,
                           int height)
Create and initialize a renderbuffer object's data store.

Description

glRenderbufferStorage establishes the data storage, format, and dimensions of a renderbuffer object's image. Any existing data store for the renderbuffer is deleted and the contents of the new data store are undefined.

An implementation may vary its allocation of internal component resolution based on any glRenderbufferStorage parameter (except target), but the allocation and chosen internal format must not be a function of any other state and cannot be changed once they are established. The actual resolution in bits of each component of the allocated image can be queried with glGetRenderbufferParameteriv/ glGetRenderbufferParameteriv.

Errors

GL_INVALID_ENUM is generated if target is not GL_RENDERBUFFER.

GL_INVALID_ENUM is generated if internalformat is not an accepted format.

GL_INVALID_VALUE is generated if width or height is less than zero or greater than GL_MAX_RENDERBUFFER_SIZE.

GL_OUT_OF_MEMORY is generated if the implementation is unable to create a data store with the requested width and height.

GL_INVALID_OPERATION is generated if the reserved renderbuffer object name 0 is bound.

Associated Gets

glGetRenderbufferParameteriv/ glGetRenderbufferParameteriv

Parameters:
target - Specifies the renderbuffer target. The symbolic constant must be GL_RENDERBUFFER.
internalformat - Specifies the color-renderable, depth-renderable, or stencil-renderable format of the renderbuffer. Must be one of the following symbolic constants: GL_RGBA4, GL_RGB565, GL_RGB5_A1, GL_DEPTH_COMPONENT16, or GL_STENCIL_INDEX8.
width - Specifies the width of the renderbuffer in pixels.
height - Specifies the height of the renderbuffer in pixels.
See Also:
GL20.glBindRenderbuffer(int, int), GL20.glDeleteRenderbuffers(int, IntBuffer), GL20.glDeleteRenderbuffers(int, int[], int), GL20.glFramebufferRenderbuffer(int, int, int, int), GL20.glGenRenderbuffers(int, IntBuffer), GL20.glGenRenderbuffers(int, int[], int), GL20.glGetRenderbufferParameteriv(int, int, IntBuffer), GL20.glGetRenderbufferParameteriv(int, int, int[], int), GL20.glIsRenderbuffer(int)
Since:
BlackBerry API 7.0.0

glSampleCoverage

void glSampleCoverage(float value,
                      boolean invert)
Specify multisample coverage parameters

Description

Multisampling samples a pixel multiple times at various implementation-dependent subpixel locations to generate antialiasing effects. Multisampling transparently antialiases points, lines, and polygons if it is enabled.

value is used in constructing a temporary mask used in determining which samples will be used in resolving the final fragment color. This mask is bitwise-anded with the coverage mask generated from the multisampling computation. If the invert flag is set, the temporary mask is inverted (all bits flipped) and then the bitwise-and is computed.

If an implementation does not have any multisample buffers available, or multisampling is disabled, rasterization occurs with only a single sample computing a pixel's final RGB color.

Provided an implementation supports multisample buffers, and multisampling is enabled, then a pixel's final color is generated by combining several samples per pixel. Each sample contains color, depth, and stencil information, allowing those operations to be performed on each sample.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_SAMPLE_COVERAGE_VALUE

glGetIntegerv/glGetIntegerv with argument GL_SAMPLE_COVERAGE_INVERT

glIsEnabled with argument GL_SAMPLE_ALPHA_TO_COVERAGE

glIsEnabled with argument GL_SAMPLE_COVERAGE

Parameters:
value - Specifies a single floating-point sample coverage value. The value is clamped to the range [0, 1]. The initial value is 1.0.
invert - Specifies a single boolean value representing if the coverage masks should be inverted. GL_TRUE and GL_FALSE are accepted. The initial value is GL_FALSE.
See Also:
GL20.glEnable(int)
Since:
BlackBerry API 7.0.0

glScissor

void glScissor(int x,
               int y,
               int width,
               int height)
Define the scissor box.

Description

glScissor defines a rectangle, called the scissor box, in window coordinates. The first two arguments, x and y, specify the lower left corner of the box. width and height specify the width and height of the box.

To enable and disable the scissor test, call glEnable and glDisable with argument GL_SCISSOR_TEST. The test is initially disabled. While the test is enabled, only pixels that lie within the scissor box can be modified by drawing commands. Window coordinates have integer values at the shared corners of frame buffer pixels. glScissor(0,0,1,1) allows modification of only the lower left pixel in the window, and glScissor(0,0,0,0) doesn't allow modification of any pixels in the window.

When the scissor test is disabled, it is as though the scissor box includes the entire window.

Errors

GL_INVALID_VALUE is generated if either width or height is negative.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_SCISSOR_BOX glIsEnabled with argument GL_SCISSOR_TEST

Parameters:
x - Specifies the x coordinate of the lower left corner of the scissor box. Initially 0.
y - Specifies the y coordinate of the lower left corner of the scissor box. Initially 0.
width - Specifies the width of the scissor box. When a GL context is first attached to a window, width is set to the width of that window.
height - Specifies the width of the scissor box. When a GL context is first attached to a window, height is set to the height of that window.
See Also:
GL20.glEnable(int), GL20.glViewport(int, int, int, int)
Since:
BlackBerry API 7.0.0

glShaderBinary

void glShaderBinary(int n,
                    int[] shaders,
                    int shadersOffset,
                    int binaryformat,
                    Buffer binary,
                    int length)
Load a precompiled shader binary.

Description

For implementations that support them, glShaderBinary loads precompiled shader binaries. shaders contains a list of n shader object handles. Each handle refers to a unique shader type (vertex shader or fragment shader). binary contains precompiled binary shader code in client memory, and binaryformat denotes the format of the pre-compiled code.

The binary image is decoded according to the extension specification defining the specified binaryformat. OpenGL ES defines no specific binary formats, but does provide a mechanism to obtain symbolic constants for such formats provided by extensions. The number of shader binary formats supported can be obtained by querying the value of GL_NUM_SHADER_BINARY_FORMATS. The list of specific binary formats supported can be obtained by querying the value of GL_SHADER_BINARY_FORMATS.

Depending on the types of the shader objects in shaders, glShaderBinary will individually load binary vertex or fragment shaders, or load an executable binary that contains an optimized pair of vertex and fragment shaders stored in the same binary.

If glShaderBinary fails, the old state of shader objects for which the binary was being loaded will not be restored.

Notes

Shader binary support is optional and thus must be queried before use by calling glGetIntegerv/glGetIntegerv with arguments GL_NUM_SHADER_BINARY_FORMATS and GL_SHADER_BINARY_FORMATS. glShaderBinary generates GL_INVALID_OPERATION on implementations that do not support any shader binary formats. Such implementations instead offer the glShaderSource alternative for supplying OpenGL ES Shading Language shader source for compilation.

If shader binary formats are supported, then an implementation may require that an optimized pair of vertex and fragment shader binaries that were compiled together to be specified to glLinkProgram. Not specifying an optimized pair my cause glLinkProgram to fail. Such a restriction, if it exists, will be documented in the extension specification defining binaryformat.

OpenGL copies the shader binary data when glShaderBinary is called, so an application may free its copy of the data immediately after the function returns.

Errors

GL_INVALID_ENUM is generated if binaryformat is not a supported format returned in GL_SHADER_BINARY_FORMATS.

GL_INVALID_VALUE is generated if any value in shaders is not a value generated by OpenGL.

GL_INVALID_VALUE is generated if the format of the data pointed to by binary does not match binaryformat.

GL_INVALID_VALUE is generated if n or length is negative.

GL_INVALID_OPERATION is generated if any value in shaders is not a shader object, or if there is more than one vertex shader object handle or more than one fragment shader object handle in shaders.

Associated Gets

glGetIntegerv/glGetIntegerv with arguments GL_NUM_SHADER_BINARY_FORMATS and GL_SHADER_BINARY_FORMATS

glIsShader

Parameters:
n - Specifies the number of shader object handles present in shaders.
shaders - Specifies an array of shader object handles into which the shader binary will be loaded.
shadersOffset - the starting offset within the shaders array.
binaryformat - Specifies the shader binary format.
binary - Specifies the shader binary data as a buffer in client memory.
length - Specifies the length of the shader binary data in bytes.
Throws:
IllegalArgumentException - If shaders is null.
IllegalArgumentException - If shaders is less than 0.
IllegalArgumentException - If shaders.length - shadersOffset is smaller than the number of values required by the parameter.
IllegalArgumentException - If binary is null.
IllegalArgumentException - If binary.remaining() is smaller than length.
See Also:
GL20.glCreateShader(int), GL20.glDeleteShader(int), GL20.glLinkProgram(int)
Since:
BlackBerry API 7.0.0

glShaderBinary

void glShaderBinary(int n,
                    IntBuffer shaders,
                    int binaryformat,
                    Buffer binary,
                    int length)
Integer Buffer version of glShaderBinary.

Errors

GL_INVALID_ENUM is generated if binaryformat is not a supported format returned in GL_SHADER_BINARY_FORMATS.

GL_INVALID_VALUE is generated if any value in shaders is not a value generated by OpenGL.

GL_INVALID_VALUE is generated if the format of the data pointed to by binary does not match binaryformat.

GL_INVALID_VALUE is generated if n or length is negative.

GL_INVALID_OPERATION is generated if any value in shaders is not a shader object, or if there is more than one vertex shader object handle or more than one fragment shader object handle in shaders.

Parameters:
n - Specifies the number of shader object handles present in shaders.
shaders - Specifies a buffer containing shader object handles into which the shader binary will be loaded.
binaryformat - Specifies the shader binary format.
binary - Specifies the shader binary data as a buffer in client memory.
length - Specifies the length of the shader binary data in bytes.
Throws:
IllegalArgumentException - If shaders is null.
IllegalArgumentException - If shaders.remaining() is smaller than the n.
IllegalArgumentException - If binary is null.
IllegalArgumentException - If binary.remaining() is smaller than length.
See Also:
GL20.glShaderBinary(int, int[], int, int, Buffer, int)
Since:
BlackBerry API 7.0.0

glShaderSource

void glShaderSource(int shader,
                    int count,
                    String[] strings,
                    int[] lengths)
Replace the source code in a shader object.

Description

For implementations that support a shader compiler, glShaderSource sets the source code in shader to the source code in the array of strings specified by strings. Any source code previously stored in the shader object is completely replaced. The number of strings in the array is specified by count. If lengths is null, the entirety of each string in strings is used. If lengths is a value other than null, it points to an array containing a string length for each of the corresponding elements of strings. The source code strings are not scanned or parsed at this time; they are simply copied into the specified shader object.

Notes

Shader compiler support is optional, and thus must be queried before use by calling glGetIntegerv/ glGetIntegerv with argument GL_SHADER_COMPILER. glShaderSource, glCompileShader, glGetShaderPrecisionFormat, and glReleaseShaderCompiler will each generate GL_INVALID_OPERATION on implementations that do not support a shader compiler. Such implementations instead offer the glShaderBinary/ glShaderBinary alternative for supplying a pre-compiled shader binary.

OpenGL copies the shader source code strings when glShaderSource is called, so an application may free its copy of the source code strings immediately after the function returns.

Errors

GL_INVALID_OPERATION is generated if a shader compiler is not supported.

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if shader is not a shader object.

GL_INVALID_VALUE is generated if count is less than 0.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_SHADER_COMPILER

glGetShaderiv/ glGetShaderiv with arguments shader and GL_SHADER_SOURCE_LENGTH

glGetShaderSource with argument shader

glIsShader

Parameters:
shader - Specifies the handle of the shader object whose source code is to be replaced.
count - Specifies the number of elements in the strings and lengths arrays.
strings - Specifies an array of strings containing the source code to be loaded into the shader.
lengths - Specifies an array of string lengths. May be null.
Throws:
IllegalArgumentException - If strings is null.
IllegalArgumentException - If strings.length() or lengths.length() is smaller than count.
IllegalArgumentException - If any element in strings in the range [0, count - 1] is null.
See Also:
GL20.glCompileShader(int), GL20.glGetShaderPrecisionFormat(int, int, int[], int, int[], int), GL20.glCreateShader(int), GL20.glDeleteShader(int)
Since:
BlackBerry API 7.0.0

glShaderSource

void glShaderSource(int shader,
                    String source)
Replace the source code in a shader object.

Description

For implementations that support a shader compiler, glShaderSource sets the source code in shader to the source code in source. Any source code previously stored in the shader object is completely replaced. The source code strings are not scanned or parsed at this time; they are simply copied into the specified shader object.

Notes

Shader compiler support is optional, and thus must be queried before use by calling glGetIntegerv/ glGetIntegerv with argument GL_SHADER_COMPILER. glShaderSource, glCompileShader, glGetShaderPrecisionFormat, and glReleaseShaderCompiler will each generate GL_INVALID_OPERATION on implementations that do not support a shader compiler. Such implementations instead offer the glShaderBinary/ glShaderBinary alternative for supplying a pre-compiled shader binary.

OpenGL copies the shader source code strings when glShaderSource is called, so an application may free its copy of the source code strings immediately after the function returns.

Errors

GL_INVALID_OPERATION is generated if a shader compiler is not supported.

GL_INVALID_VALUE is generated if shader is not a value generated by OpenGL.

GL_INVALID_OPERATION is generated if shader is not a shader object.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_SHADER_COMPILER

glGetShaderiv/ glGetShaderiv with arguments shader and GL_SHADER_SOURCE_LENGTH

glGetShaderSource with argument shader

glIsShader

Parameters:
shader - Specifies the handle of the shader object whose source code is to be replaced.
source - The source code to be loaded into the shader.
Throws:
IllegalArgumentException - If source is null.
See Also:
GL20.glCompileShader(int), GL20.glGetShaderPrecisionFormat(int, int, int[], int, int[], int), GL20.glCreateShader(int), GL20.glDeleteShader(int)
Since:
BlackBerry API 7.0.0

glStencilFunc

void glStencilFunc(int func,
                   int ref,
                   int mask)
Set front and back function and reference value for stencil testing.

Description

Stenciling, like depth-buffering, enables and disables drawing on a per-pixel basis. Stencil planes are first drawn into using GL drawing primitives, then geometry and images are rendered using the stencil planes to mask out portions of the screen. Stenciling is typically used in multipass rendering algorithms to achieve special effects, such as decals, outlining, and constructive solid geometry rendering.

The stencil test conditionally eliminates a pixel based on the outcome of a comparison between the reference value and the value in the stencil buffer. To enable and disable the test, call glEnable and glDisable with argument GL_STENCIL_TEST. To specify actions based on the outcome of the stencil test, call glStencilOp or glStencilOpSeparate.

There can be two separate sets of func, ref, and mask parameters; one affects back-facing polygons, and the other affects front-facing polygons as well as other non-polygon primitives. glStencilFunc sets both front and back stencil state to the same values. Use glStencilFuncSeparate to set front and back stencil state to different values.

func is a symbolic constant that determines the stencil comparison function. It accepts one of eight values, shown in the following list. ref is an integer reference value that is used in the stencil comparison. It is clamped to the range [0, 2^n - 1], where n is the number of bitplanes in the stencil buffer. mask is bitwise ANDed with both the reference value and the stored stencil value, with the ANDed values participating in the comparison.

If stencil represents the value stored in the corresponding stencil buffer location, the following list shows the effect of each comparison function that can be specified by func. Only if the comparison succeeds is the pixel passed through to the next stage in the rasterization process (see glStencilOp). All tests treat stencil values as unsigned integers in the range [0, 2^n - 1], where n is the number of bitplanes in the stencil buffer.

The following values are accepted by func:

GL_NEVER

Always fails.

GL_LESS

Passes if ( ref & mask ) < ( stencil & mask ).

GL_LEQUAL

Passes if ( ref & mask ) <= ( stencil & mask ).

GL_GREATER

Passes if ( ref & mask ) > ( stencil & mask ).

GL_GEQUAL

Passes if ( ref & mask ) >= ( stencil & mask ).

GL_EQUAL

Passes if ( ref & mask ) = ( stencil & mask ).

GL_NOTEQUAL

Passes if ( ref & mask ) != ( stencil & mask ).

GL_ALWAYS

Always passes.

Notes

Initially, the stencil test is disabled. If there is no stencil buffer, no stencil modification can occur and it is as if the stencil test always passes.

glStencilFunc is the same as calling glStencilFuncSeparate with face set to GL_FRONT_AND_BACK.

Errors

GL_INVALID_ENUM is generated if func is not one of the eight accepted values.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_STENCIL_FUNC, GL_STENCIL_VALUE_MASK, GL_STENCIL_REF, GL_STENCIL_BACK_FUNC, GL_STENCIL_BACK_VALUE_MASK, GL_STENCIL_BACK_REF, or GL_STENCIL_BITS

glIsEnabled with argument GL_STENCIL_TEST.

Parameters:
func - Specifies the test function. Eight symbolic constants are valid: GL_NEVER, GL_LESS, GL_LEQUAL, GL_GREATER, GL_GEQUAL, GL_EQUAL, GL_NOTEQUAL, and GL_ALWAYS. The initial value is GL_ALWAYS.
ref - Specifies the reference value for the stencil test. ref is clamped to the range [0, 2^n - 1], where n is the number of bitplanes in the stencil buffer. The initial value is 0.
mask - Specifies a mask that is ANDed with both the reference value and the stored stencil value when the test is done. The initial value is all 1's.
See Also:
GL20.glBlendFunc(int, int), GL20.glDepthFunc(int), GL20.glEnable(int), GL20.glStencilFuncSeparate(int, int, int, int), GL20.glStencilMask(int), GL20.glStencilMaskSeparate(int, int), GL20.glStencilOp(int, int, int), GL20.glStencilOpSeparate(int, int, int, int)
Since:
BlackBerry API 7.0.0

glStencilFuncSeparate

void glStencilFuncSeparate(int face,
                           int func,
                           int ref,
                           int mask)
Set front and/or back function and reference value for stencil testing.

Description

Stenciling, like depth-buffering, enables and disables drawing on a per-pixel basis. You draw into the stencil planes using GL drawing primitives, then render geometry and images, using the stencil planes to mask out portions of the screen. Stenciling is typically used in multipass rendering algorithms to achieve special effects, such as decals, outlining, and constructive solid geometry rendering.

The stencil test conditionally eliminates a pixel based on the outcome of a comparison between the reference value and the value in the stencil buffer. To enable and disable the test, call glEnable and glDisable with argument GL_STENCIL_TEST. To specify actions based on the outcome of the stencil test, call glStencilOp or glStencilOpSeparate.

There can be two separate sets of func, ref, and mask parameters; one affects back-facing polygons, and the other affects front-facing polygons as well as other non-polygon primitives. glStencilFunc sets both front and back stencil state to the same values, as if glStencilFuncSeparate were called with face set to GL_FRONT_AND_BACK.

func is a symbolic constant that determines the stencil comparison function. It accepts one of eight values, shown in the following list. ref is an integer reference value that is used in the stencil comparison. It is clamped to the range [0, 2^n - 1], where n is the number of bitplanes in the stencil buffer. mask is bitwise ANDed with both the reference value and the stored stencil value, with the ANDed values participating in the comparison.

If stencil represents the value stored in the corresponding stencil buffer location, the following list shows the effect of each comparison function that can be specified by func. Only if the comparison succeeds is the pixel passed through to the next stage in the rasterization process (see glStencilOp). All tests treat stencil values as unsigned integers in the range [0, 2^n - 1], where n is the number of bitplanes in the stencil buffer.

The following values are accepted by func:

GL_NEVER

Always fails.

GL_LESS

Passes if ( ref & mask ) < ( stencil & mask ).

GL_LEQUAL

Passes if ( ref & mask ) <= ( stencil & mask ).

GL_GREATER

Passes if ( ref & mask ) > ( stencil & mask ).

GL_GEQUAL

Passes if ( ref & mask ) >= ( stencil & mask ).

GL_EQUAL

Passes if ( ref & mask ) = ( stencil & mask ).

GL_NOTEQUAL

Passes if ( ref & mask ) != ( stencil & mask ).

GL_ALWAYS

Always passes.

Notes

Initially, the stencil test is disabled. If there is no stencil buffer, no stencil modification can occur and it is as if the stencil test always passes.

Errors

GL_INVALID_ENUM is generated if face is not GL_FRONT, GL_BACK, or GL_FRONT_AND_BACK.

GL_INVALID_ENUM is generated if func is not one of the eight accepted values.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_STENCIL_FUNC, GL_STENCIL_VALUE_MASK, GL_STENCIL_REF, GL_STENCIL_BACK_FUNC, GL_STENCIL_BACK_VALUE_MASK, GL_STENCIL_BACK_REF, or GL_STENCIL_BITS

glIsEnabled with argument GL_STENCIL_TEST

Parameters:
face - Specifies whether front and/or back stencil state is updated. Three symbolic constants are valid: GL_FRONT, GL_BACK, and GL_FRONT_AND_BACK.
func - Specifies the test function. Eight symbolic constants are valid: GL_NEVER, GL_LESS, GL_LEQUAL, GL_GREATER, GL_GEQUAL, GL_EQUAL, GL_NOTEQUAL, and GL_ALWAYS. The initial value is GL_ALWAYS.
ref - Specifies the reference value for the stencil test. ref is clamped to the range [0, 2^n - 1], where n is the number of bitplanes in the stencil buffer. The initial value is 0.
mask - Specifies a mask that is ANDed with both the reference value and the stored stencil value when the test is done. The initial value is all 1's.
See Also:
GL20.glBlendFunc(int, int), GL20.glDepthFunc(int), GL20.glEnable(int), GL20.glStencilFunc(int, int, int), GL20.glStencilMask(int), GL20.glStencilMaskSeparate(int, int), GL20.glStencilOp(int, int, int), GL20.glStencilOpSeparate(int, int, int, int)
Since:
BlackBerry API 7.0.0

glStencilMask

void glStencilMask(int mask)
Control the front and back writing of individual bits in the stencil planes.

Description

glStencilMask controls the writing of individual bits in the stencil planes. The least significant n bits of mask, where n is the number of bits in the stencil buffer, specify a mask. Where a 1 appears in the mask, it's possible to write to the corresponding bit in the stencil buffer. Where a 0 appears, the corresponding bit is write-protected. Initially, all bits are enabled for writing.

There can be two separate mask writemasks; one affects back-facing polygons, and the other affects front-facing polygons as well as other non-polygon primitives. glStencilMask sets both front and back stencil writemasks to the same values. Use glStencilMaskSeparate to set front and back stencil writemasks to different values.

Notes

glStencilMask is the same as calling glStencilMaskSeparate with face set to GL_FRONT_AND_BACK.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_STENCIL_WRITEMASK, GL_STENCIL_BACK_WRITEMASK, or GL_STENCIL_BITS

Parameters:
mask - Specifies a bit mask to enable and disable writing of individual bits in the stencil planes. Initially, the mask is all 1's.
See Also:
GL20.glColorMask(boolean, boolean, boolean, boolean), GL20.glDepthMask(boolean), GL20.glStencilFunc(int, int, int), GL20.glStencilFuncSeparate(int, int, int, int), GL20.glStencilMaskSeparate(int, int), GL20.glStencilOp(int, int, int), GL20.glStencilOpSeparate(int, int, int, int)
Since:
BlackBerry API 7.0.0

glStencilMaskSeparate

void glStencilMaskSeparate(int face,
                           int mask)
Control the front and/or back writing of individual bits in the stencil planes.

Description

glStencilMaskSeparate controls the writing of individual bits in the stencil planes. The least significant n bits of mask, where n is the number of bits in the stencil buffer, specify a mask. Where a 1 appears in the mask, it's possible to write to the corresponding bit in the stencil buffer. Where a 0 appears, the corresponding bit is write-protected. Initially, all bits are enabled for writing.

There can be two separate mask writemasks; one affects back-facing polygons, and the other affects front-facing polygons as well as other non-polygon primitives. glStencilMask sets both front and back stencil writemasks to the same values, as if glStencilMaskSeparate were called with face set to GL_FRONT_AND_BACK.

Errors

GL_INVALID_ENUM is generated if face is not GL_FRONT, GL_BACK, or GL_FRONT_AND_BACK.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_STENCIL_WRITEMASK, GL_STENCIL_BACK_WRITEMASK, or GL_STENCIL_BITS

Parameters:
face - Specifies whether the front and/or back stencil writemask is updated. Three symbolic constants are valid: GL_FRONT, GL_BACK, and GL_FRONT_AND_BACK.
mask - Specifies a bit mask to enable and disable writing of individual bits in the stencil planes. Initially, the mask is all 1's.
See Also:
GL20.glColorMask(boolean, boolean, boolean, boolean), GL20.glDepthMask(boolean), GL20.glStencilFunc(int, int, int), GL20.glStencilFuncSeparate(int, int, int, int), GL20.glStencilMask(int), GL20.glStencilMaskSeparate(int, int), GL20.glStencilOp(int, int, int), GL20.glStencilOpSeparate(int, int, int, int)
Since:
BlackBerry API 7.0.0

glStencilOp

void glStencilOp(int fail,
                 int zfail,
                 int zpass)
Set front and back stencil test actions.

Description

Stenciling, like depth-buffering, enables and disables drawing on a per-pixel basis. You draw into the stencil planes using GL drawing primitives, then render geometry and images, using the stencil planes to mask out portions of the screen. Stenciling is typically used in multipass rendering algorithms to achieve special effects, such as decals, outlining, and constructive solid geometry rendering.

The stencil test conditionally eliminates a pixel based on the outcome of a comparison between the value in the stencil buffer and a reference value. To enable and disable the test, call glEnable and glDisable with argument GL_STENCIL_TEST; to control it, call glStencilFunc or glStencilFuncSeparate.

There can be two separate sets of fail, zfail, and zpass parameters; one affects back-facing polygons, and the other affects front-facing polygons as well as other non-polygon primitives. glStencilOp sets both front and back stencil state to the same values. Use glStencilOpSeparate to set front and back stencil state to different values.

glStencilOp takes three arguments that indicate what happens to the stored stencil value while stenciling is enabled. If the stencil test fails, no change is made to the pixel's color or depth buffers, and fail specifies what happens to the stencil buffer contents. The following eight actions are possible.

GL_KEEP

Keeps the current value.

GL_ZERO

Sets the stencil buffer value to 0.

GL_REPLACE

Sets the stencil buffer value to ref, as specified by glStencilFunc.

GL_INCR

Increments the current stencil buffer value. Clamps to the maximum representable unsigned value.

GL_INCR_WRAP

Increments the current stencil buffer value. Wraps stencil buffer value to zero when incrementing the maximum representable unsigned value.

GL_DECR

Decrements the current stencil buffer value. Clamps to 0.

GL_DECR_WRAP

Decrements the current stencil buffer value. Wraps stencil buffer value to the maximum representable unsigned value when decrementing a stencil buffer value of zero.

GL_INVERT

Bitwise inverts the current stencil buffer value.

Stencil buffer values are treated as unsigned integers. When incremented and decremented, values are clamped to the range [0, 2^n - 1], where n is the value returned by querying GL_STENCIL_BITS.

The other two arguments to glStencilOp specify stencil buffer actions that depend on whether subsequent depth buffer tests succeed (zpass) or fail (zfail) (see glDepthFunc). The actions are specified using the same eight symbolic constants as fail. Note that zfail is ignored when there is no depth buffer, or when the depth buffer is not enabled. In these cases, fail and zpass specify stencil action when the stencil test fails and passes, respectively.

Notes

Initially the stencil test is disabled. If there is no stencil buffer, no stencil modification can occur and it is as if the stencil tests always pass, regardless of any call to glStencilOp.

glStencilOp is the same as calling glStencilOpSeparate with face set to GL_FRONT_AND_BACK.

Errors

GL_INVALID_ENUM is generated if fail, zfail, or zpass is any value other than the eight defined symbolic constant values.

Associated Gets

glGetIntegerv/glGetIntegerv with argument GL_STENCIL_FAIL, GL_STENCIL_PASS_DEPTH_PASS, GL_STENCIL_PASS_DEPTH_FAIL, GL_STENCIL_BACK_FAIL, GL_STENCIL_BACK_PASS_DEPTH_PASS, GL_STENCIL_BACK_PASS_DEPTH_FAIL, or GL_STENCIL_BITS

glIsEnabled with argument GL_STENCIL_TEST

Parameters:
fail - Specifies the action to take when the stencil test fails. Eight symbolic constants are accepted: GL_KEEP, GL_ZERO, GL_REPLACE, GL_INCR, GL_INCR_WRAP, GL_DECR, GL_DECR_WRAP, and GL_INVERT. The initial value is GL_KEEP.
zfail - Specifies the stencil action when the stencil test passes, but the depth test fails. zfail accepts the same symbolic constants as fail. The initial value is GL_KEEP.
zpass - Specifies the stencil action when both the stencil test and the depth test pass, or when the stencil test passes and either there is no depth buffer or depth testing is not enabled. zpass accepts the same symbolic constants as fail. The initial value is GL_KEEP.
See Also: