GL11ExtensionPack

Constant for use with glBlendFuncSeparate ( OES_blend_func_separate extension).

Constant for use with glBlendFuncSeparate ( OES_blend_func_separate extension).

Constant for use with glBlendEquationSeparate and glGetInteger (OES_blend_equation_separate extension).

Constant for use with glBlendEquationSeparate and glGetInteger (OES_blend_equation_separate extension).

Constant for use with glBlendEquationSeparate and glGetInteger (OES_blend_equation_separate extension). Synonym for GL_BLEND_EQUATION.

Constant for use with glBlendFuncSeparate ( OES_blend_func_separate extension).

Constant for use with glBlendFuncSeparate ( OES_blend_func_separate extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant for use with glStencilOp ( OES_stencil_wrap extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant (OES_framebuffer_object extension).

Constant accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant optionally accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant optionally accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by glGetIntegerv ( OES_framebuffer_object extension).

Constant returned by glCheckFramebufferStatusOES ( OES_framebuffer_object extension).

Constant returned by glCheckFramebufferStatusOES ( OES_framebuffer_object extension).

Constant returned by glCheckFramebufferStatusOES ( OES_framebuffer_object extension).

Constant returned by glCheckFramebufferStatusOES ( OES_framebuffer_object extension).

Constant returned by glCheckFramebufferStatusOES ( OES_framebuffer_object extension).

Constant returned by glCheckFramebufferStatusOES ( OES_framebuffer_object extension).

Constant returned by glCheckFramebufferStatusOES ( OES_framebuffer_object extension).

Constant accepted by the target parameter of glBindFramebufferOES, glCheckFramebufferStatusOES, glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant returned by glCheckFramebufferStatusOES ( OES_framebuffer_object extension).

Constant for use with glBlendEquation ( OES_blend_subtract extension).

Constant for use with glBlendEquation ( OES_blend_subtract extension).

Constant for use with glBlendEquation ( OES_blend_subtract extension).

Constant for use with glStencilOp ( OES_stencil_wrap extension).

Constant returned by glGetError ( OES_framebuffer_object extension).

Constant accepted by glGetIntegerv ( OES_framebuffer_object extension).

Constant for use with glGetIntegerv ( OES_texture_cube_map extension).

Constant accepted by glGetIntegerv ( OES_framebuffer_object extension).

Constant for use with glTexParameter and glGetTexParameter (OES_texture_mirrored_repeat extension).

Constant for use with glTexGen ( OES_texture_cube_map extension).

Constant for use with glTexGen ( OES_texture_cube_map extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by glGetIntegerv ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the target parameter of glBindRenderbufferOES, glRenderbufferStorageOES , and glGetRenderbufferParameterivOES, and returned by glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the pname parameter of glGetRenderbufferParameterivOES ( OES_framebuffer_object extension).

Constant accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant optionally accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant optionally accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant accepted by the attachment parameter of glFramebufferTexture2DOES, glFramebufferRenderbufferOES, and glGetFramebufferAttachmentParameterivOES ( OES_framebuffer_object extension).

Constant (OES_framebuffer_object extension).

Constant optionally accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant optionally accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant optionally accepted by the internalformat parameter of glRenderbufferStorageOES ( OES_framebuffer_object extension).

Constant for use with glTexGen for the OES_texture_cube_map extension.

Constant for use with glGetInteger ( OES_texture_cube_map extension).

Constant for use with glBindTexture, glTexParameter, glEnable, glDisable, and glIsEnabled ( OES_texture_cube_map extension).

Constant for use with glTexImage2D and glCompressedTexImage2D (OES_texture_cube_map extension).

Constant for use with glTexImage2D and glCompressedTexImage2D (OES_texture_cube_map extension).

Constant for use with glTexImage2D and glCompressedTexImage2D (OES_texture_cube_map extension).

Constant for use with glTexImage2D and glCompressedTexImage2D (OES_texture_cube_map extension).

Constant for use with glTexImage2D and glCompressedTexImage2D (OES_texture_cube_map extension).

Constant for use with glTexImage2D and glCompressedTexImage2D (OES_texture_cube_map extension).

Constant for use with glTexGen ( OES_texture_cube_map extension).

Constant for use with glEnable and glDisable ( OES_texture_cube_map extension).

(OES_framebuffer_object extension) Bind a framebuffer.

The operations described in chapter 4 of the OpenGL 1.5 specification affect the images attached to the framebuffer object bound to the target GL_FRAMEBUFFER_OES. By default, framebuffer bound to the target GL_FRAMEBUFFER_OES is zero, specifying the default implementation dependent framebuffer provided by the windowing system. When the framebuffer bound to target GL_FRAMEBUFFER_OES is not zero, but instead names a application-created framebuffer object, then operations affect the application-created framebuffer object rather than the default framebuffer.

The namespace for framebuffer objects is the unsigned integers, with zero reserved by the GL to refer to the default framebuffer. A framebuffer object is created by binding an unused name to the target GL_FRAMEBUFFER_OES. The binding is effected by calling glBindFramebufferOES with target set to GL_FRAMEBUFFER_OES and framebuffer set to the unused name. The resulting framebuffer object is a new state vector, comprising all the state values listed in the table below. There are GL_MAX_COLOR_ATTACHMENTS_OES color attachment points, plus one each for the depth and stencil attachment points. glBindFramebufferOES may also be used to bind an existing framebuffer object to target. If the bind is successful no change is made to the state of the bound framebuffer object and any previous binding to target is broken. The current GL_FRAMEBUFFER_OES binding can be queried using glGetIntegerv(GL_FRAMEBUFFER_BINDING_OES).

While a framebuffer object is bound to the target GL_FRAMEBUFFER_OES, GL operations on the target to which it is bound affect the images attached to the bound framebuffer object, and queries of the target to which it is bound return state from the bound object. The framebuffer object bound to the target GL_FRAMEBUFFER_OES is used as the destination of fragment operations and as the source of pixel reads such as glReadPixels. In the initial state, the reserved name zero is bound to the target GL_FRAMEBUFFER_OES. There is no application-created framebuffer object corresponding to the name zero. Instead, the name zero refers to the window-system-provided framebuffer. All queries and operations on the framebuffer while the name zero is bound to the target GL_FRAMEBUFFER_OES operate on this default framebuffer. On some implementations, the properties of the default window-system-provided framebuffer can change over time (e.g., in response to window-system events such as attaching the context to a new window-system drawable.)

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 and foremost, unlike the window-system-provided framebuffer, application-created-framebuffers have modifiable attachment points for each logical buffer in the framebuffer. Framebuffer-attachable images can be attached to and detached from these attachment points. Also, the size and format of the images attached to application-created framebuffers are controlled entirely within the GL interface, and are not affected by window-system events, such as pixel format selection, window resizes, and display mode changes.

Additionally, when rendering to or reading from an application created-framebuffer object:

• The pixel ownership test always succeeds. In other words, application-created framebuffer objects own all of their pixels.
• There are no visible color buffer bitplanes. This means there is no color buffer corresponding to the back, front, left, or right color bitplanes.
• The only color buffer bitplanes are the ones defined by the framebuffer attachment points named COLOR_ATTACHMENT0_OES through COLOR_ATTACHMENTn_OES.
• The only depth buffer bitplanes are the ones defined by the framebuffer attachment point DEPTH_ATTACHMENT_OES.
• The only stencil buffer bitplanes are the ones defined by the framebuffer attachment point STENCIL_ATTACHMENT_OES.

(OES_framebuffer_object extension) Bind a renderbuffer.

A renderbuffer is a data storage object containing a single image of a renderable internal format. GL provides the methods described below to allocate and delete a renderbuffer's image, and to attach a renderbuffer's image to a framebuffer object.

The name space for renderbuffer objects is the unsigned integers, with zero reserved for the GL. A renderbuffer object is created by binding an unused name to GL_RENDERBUFFER_OES. The binding is effected by setting target to GL_RENDERBUFFER_OES and renderbuffer set to the unused name. If renderbuffer is not zero, then the resulting renderbuffer object is a new state vector, initialized with a zero-sized memory buffer, and comprising the state values listed in Table 8.nnn of the EXT_framebuffer_object specification. Any previous binding to target is broken.

glBindRenderbufferOES may also be used to bind an existing renderbuffer object. If the bind is successful, no change is made to the state of the newly bound renderbuffer object, and any previous binding to target is broken.

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

The name zero is reserved. A renderbuffer object cannot be created with the name zero. If renderbuffer is zero, then any previous binding to target is broken and the target binding is restored to the initial state.

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

Using glGetIntegerv, the current GL_RENDERBUFFER_OES binding can be queried as GL_RENDERBUFFER_BINDING_OES.

(1.1 + OES_texture_cube_map extension) Bind a named texture to a texturing target.

The OES_texture_cube_map extension allows the value GL_TEXTURE_CUBE_MAP to be passed to the target parameter.

(1.1 + OES_blend_subtract extension) Specify the blending equation.

Blending is controlled by glBlendEquation.

glBlendEquation mode GL_FUNC_ADD defines the blend equation as

 C = Cs * S + Cd * D,
 

If mode is GL_FUNC_SUBTRACT, the blending equation is defined as

 C = Cs * S - Cd * D.
 

If mode is GL_FUNC_REVERSE_SUBTRACT, the blend equation is defined as

 C = Cd * D - Cs * S.
 

Errors

GL_INVALID_ENUM is generated if mode is not an accepted value.

Associated Gets

glGetIntegerv with argument GL_BLEND_EQUATION returns the blend equation.

(1.1 + OES_blend_equation_separate extension) Provide different blend equations for RGB and alpha.

glBlendEquationSeparate allows different blend equations to be provideded for RGB and alpha. The blend equations are those defined for glBlendEquation.

Errors

GL_INVALID_ENUM is generated if modeRGB, or modeAlpha is not an accepted value.

Associated Gets

glGetIntegerv with argument GL_BLEND_EQUATION_RGB or GL_BLEND_EQUATION returns the RGB blend equation.

glGetIntegerv with argument GL_BLEND_EQUATION_ALPHA returns the alpha blend equation.

(1.1 + GL_OES_blend_func_separate extension) Apply different blend factors to RGB and alpha.

glBlendFuncSeparate allows different blend factors to be applied to RGB and alpha. The blend factors are those defined for glBlendFunc.

Errors

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

Associated Gets

glGetIntegerv with argument GL_BLEND_SRC_RGB or GL_BLEND_SRC returns the source RGB blend function.

glGetIntegerv with argument GL_BLEND_DST_RGB or GL_BLEND_DST returns the destination RGB blend function.

glGetIntegerv with argument GL_BLEND_SRC_ALPHA returns the source alpha blend function.

glGetIntegerv with argument GL_BLEND_DST_ALPHA returns the destination alpha blend function.

(OES_framebuffer_object extension) Check the status of a framebuffer.

Returns one of GL_FRAMEBUFFER_COMPLETE_OES, GL_FRAMEBUFFER_INCOMPLETE_ATTACHMENT_OES, GL_FRAMEBUFFER_INCOMPLETE_MISSING_ATTACHMENT_OES, GL_FRAMEBUFFER_INCOMPLETE_DIMENSIONS_OES, GL_FRAMEBUFFER_INCOMPLETE_DRAW_BUFFER_OES, GL_FRAMEBUFFER_INCOMPLETE_READ_BUFFER_OES, or GL_FRAMEBUFFER_UNSUPPORTED_OES.

(1.1 + OES_texture_cube_map extension) Specify a two-dimensional compressed texture image.

The OES_texture_cube_map extension allows the values GL_TEXTURE_CUBE_MAP_{POSITIVE,NEGATIVE}_{X,Y,Z} to be passed to the target parameter.

(1.1 + OES_texture_cube_map extension) Specify a two-dimensional texture image with pixels from the color buffer.

The OES_texture_cube_map extension allows the values GL_TEXTURE_CUBE_MAP_{POSITIVE,NEGATIVE}_{X,Y,Z} to be passed to the target parameter.

(OES_framebuffer_object extension) Delete framebuffer objects.

Framebuffer objects are deleted by calling glDeleteFramebuffersOES. framebuffers contains n names of framebuffer objects to be deleted. After a framebuffer object is deleted, it has no attachments, and its name is again unused. If a framebuffer that is currently bound to the target GL_FRAMEBUFFER_OES is deleted, it is as though glBindFramebufferOES had been executed with the target of GL_FRAMEBUFFER_OES and framebuffer of zero. Unused names in framebuffers are silently ignored, as is the value zero.

(OES_framebuffer_object extension) Integer Buffer version of glDeleteFramebuffersOES.

(OES_framebuffer_object extension) Integer Buffer version of glDeleteRenderbuffersOES.

(OES_framebuffer_object extension) Delete a renderbuffer.

Renderbuffer objects are deleted by calling glDeleteRenderbuffersOES where renderbuffers contains n names of renderbuffer objects to be deleted. After a renderbuffer object is deleted, it has no contents, and its name is again unused. If a renderbuffer that is currently bound to GL_RENDERBUFFER_OES is deleted, it is as though glBindRenderbufferOES had been executed with the target GL_RENDERBUFFER_OES and name of zero. Additionally, special care must be taken when deleting a renderbuffer if the image of the renderbuffer is attached to a framebuffer object. Unused names in renderbuffers are silently ignored, as is the value zero.

(1.1 + OES_texture_cube_map extension) Enable server-side GL capabilities.

Cube-map texturing is enabled if cap assumes the value GL_TEXTURE_CUBE_MAP.

If enabled, cube-map texturing is performed for the active texture unit. See GL.glActiveTexture, GL.glTexImage2D, glCompressedTexImage2D, and glCopyTexImage2D.

Texture coordinates with be generated if cap is equal to GL_TEXTURE_GEN_STR.

(OES_framebuffer_object extension) Attach a renderbuffer to a framebuffer.

A renderbuffer can be attached as one of the logical buffers of the currently bound framebuffer object by calling glFramebufferRenderbufferOES. target must be GL_FRAMEBUFFER_OES. GL_INVALID_OPERATION is generated if the current value of GL_FRAMEBUFFER_BINDING_OES is zero when glFramebufferRenderbufferOES is called. attachment should be set to one of the attachment points of the framebuffer, one of GL_COLOR_ATTACHMENTn _OES (where n is from 0 to GL_MAX_COLOR_ATTACHMENTS_OES - 1), GL_DEPTH_ATTACHMENT_OES, or GL_STENCIL_ATTACHMENT_OES. renderbuffertarget must be GL_RENDERBUFFER_OES and renderbuffer should be set to the name of the renderbuffer object to be attached to the framebuffer. renderbuffer must be either zero or the name of an existing renderbuffer object of type renderbuffertarget, otherwise GL_INVALID_OPERATION is generated. If renderbuffer is zero, then the value of renderbuffertarget is ignored.

If renderbuffer is not zero and if glFramebufferRenderbufferOES is successful, then the renderbuffer named renderbuffer will be used as the logical buffer identified by attachment of the framebuffer currently bound to target. The value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_OES for the specified attachment point is set to GL_RENDERBUFFER_OES and the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_OES is set to renderbuffer. All other state values of the attachment point specified by attachment are set to their default values listed in the table below. No change is made to the state of the renderbuffer object and any previous attachment to the attachment logical buffer of the framebuffer object bound to framebuffer target is broken. If, on the other hand, the attachment is not successful, then no change is made to the state of either the renderbuffer object or the framebuffer object.

Calling glFramebufferRenderbufferOES with the renderbuffer name zero will detach the image, if any, identified by attachment, in the framebuffer currently bound to target. All state values of the attachment point specified by attachment in the object bound to target are set to their default values listed in the table below.

If a renderbuffer object is deleted while its image is attached to one or more attachment points in the currently bound framebuffer, then it is as if glFramebufferRenderbufferOES had been called, with a renderbuffer of 0, for each attachment point to which this image was attached in the currently bound framebuffer. In other words, this renderbuffer image is first detached from all attachment points in 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.

The values in the first column of the table below should be prefixed with GL_RENDERBUFFER_ and suffixed with OES. The get command for all values is glGetRenderbufferParameterivOES. All take on positive integral values.

 Get                        Initial
 Value                      Value         Description
 ---------------            -------       ----------------------
 ATTACHMENT_OBJECT_TYPE     GL_NONE       type of
                                          image attached to
                                          framebuffer attachment
                                          point
 
 ATTACHMENT_OBJECT_NAME     0             name of object
                                          attached to
                                          framebuffer attachment
                                          point
 
 ATTACHMENT_TEXTURE_LEVEL   0             mipmap level of
                                          texture image
                                          attached, if object
                                          attached is texture.
 
 ATTACHMENT_TEXTURE_        GL_TEXTURE_   cubemap face of
 CUBE_MAP_FACE              CUBE_MAP_     texture image
                            POSITIVE_X    attached, if object
                                          attached is cubemap
                                          texture.
 

(OES_framebuffer_object extension) Attach an image from a texture object to a framebuffer.

To render directly into a texture image, a specified image from a texture object can be attached as one of the logical buffers of the currently bound framebuffer object by calling this method.

GL_INVALID_OPERATION is generated if the current value of GL_FRAMEBUFFER_BINDING_OES is zero when glFramebufferTexture2DOES is called. attachment must be one of the attachment points of the framebuffer, either GL_COLOR_ATTACHMENTn_OES (where n is from 0 to GL_MAX_COLOR_ATTACHMENTS_OES - 1), GL_DEPTH_ATTACHMENT_OES, or GL_STENCIL_ATTACHMENT_OES.

If texture is zero, then textarget and level are ignored. If texture is not zero, then texture must either name an existing texture object with an target of textarget, or texture must name an existing cube map texture and textarget must be one of: GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z. Otherwise, GL_INVALID_OPERATION is generated.

level specifies the mipmap level of the texture image to be attached to the framebuffer and must be 0 (indicating the base MIPmap level).

If textarget is one of GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z, then level must be greater than or equal to zero and less than or equal to log base 2 of GL_MAX_CUBE_MAP_TEXTURE_SIZE. For all other values of textarget, level must be greater than or equal to zero and no larger than log base 2 of GL_MAX_TEXTURE_SIZE . Otherwise, GL_INVALID_VALUE is generated.

If texture is not zero, then textarget must be one of: GL_TEXTURE_2D, GL_TEXTURE_CUBE_MAP_POSITIVE_X, GL_TEXTURE_CUBE_MAP_POSITIVE_Y, GL_TEXTURE_CUBE_MAP_POSITIVE_Z, GL_TEXTURE_CUBE_MAP_NEGATIVE_X, GL_TEXTURE_CUBE_MAP_NEGATIVE_Y, or GL_TEXTURE_CUBE_MAP_NEGATIVE_Z.

If texture is not zero, and if glFramebufferTexture2DOES is successful, then the specified texture image will be used as the logical buffer identified by attachment of the framebuffer currently bound to target. The value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_OES for the specified attachment point is set to GL_TEXTURE and the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_OES is set to . Additionally, the value of GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_OES for the named attachment point is set to level. If texture is a cubemap texture then, the value of GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_OES the named attachment point is set to textarget. All other state values of the attachment point specified by attachment are set to their default values listed in the table below. No change is made to the state of the texture object, and any previous attachment to the attachment logical buffer of the framebuffer object bound to framebuffer target is broken. If, on the other hand, the attachment is not successful, then no change is made to the state of either the texture object or the framebuffer object.

Calling glFramebufferTexture2DOES with texture name zero will detach the image identified by attachment, if any, in the framebuffer currently bound to target. All state values of the attachment point specified by attachment are set to their default values listed in the table below.

If a texture object is deleted while its image is attached to one or more attachment points in the currently bound framebuffer, then it is as if glFramebufferTexture2DOES had been called, with a texture of 0, for each attachment point to which this image was attached in the currently bound framebuffer. In other words, this texture image is first detached from all attachment points in the currently bound framebuffer. Note that the texture image is specifically not detached from any other framebuffer objects. Detaching the texture image from any other framebuffer objects is the responsibility of the application.

The entire texture image, including border texels, if any, can be addressed with window-coordinates in the following range:

 0 <= window_x < (texture_width  + (2 * border)),
 

 0 <= window_y < (texture_height + (2 * border))
 

The values in the first column of the table below should be prefixed with GL_RENDERBUFFER_ and suffixed with OES. The get command for all values is glGetRenderbufferParameterivOES. All take on positive integral values.

 Get                        Initial
 Value                      Value         Description
 ---------------            -------       ----------------------
 ATTACHMENT_OBJECT_TYPE     GL_NONE       type of
                                          image attached to
                                          framebuffer attachment
                                          point
 
 ATTACHMENT_OBJECT_NAME     0             name of object
                                          attached to
                                          framebuffer attachment
                                          point
 
 ATTACHMENT_TEXTURE_LEVEL   0             mipmap level of
                                          texture image
                                          attached, if object
                                          attached is texture.
 
 ATTACHMENT_TEXTURE_        GL_TEXTURE_   cubemap face of
 CUBE_MAP_FACE              CUBE_MAP_     texture image
                            POSITIVE_X    attached, if object
                                          attached is cubemap
                                          texture.
 

(OES_framebuffer_object extension) Generate framebuffer names.

The command glGenFramebuffersOES returns n previously unused framebuffer object names in ids. These names are marked as used, for the purposes of glGenFramebuffersOES only, but they acquire state and type only when they are first bound, just as if they were unused.

(OES_framebuffer_object extension) Integer Buffer version of glGenFramebuffersOES.

(OES_framebuffer_object extension) Integer Buffer version of glGenRenderbuffersOES.

(OES_framebuffer_object extension) Generate renderbuffer names.

The command glGenRenderbuffersOES returns n previously unused renderbuffer object names in renderbuffers . These names are marked as used, for the purposes of glGenRenderbuffersOES only, but they acquire renderbuffer state only when they are first bound, just as if they were unused.

(OES_framebuffer_object extension) Generate mipmaps manually.

target is one of TEXTURE_2D or TEXTURE_CUBE_MAP. Mipmap generation affects the texture image attached to target. For cube map textures, INVALID_OPERATION is generated if the texture bound to target is not cube complete.

(OES_framebuffer_object extension) Query the value of a framebuffer attachment parameter.

target must be GL_FRAMEBUFFER_OES. attachment must be one of the attachment points of the framebuffer, either GL_COLOR_ATTACHMENTn _OES (where n is from 0 to GL_MAX_COLOR_ATTACHMENTS_OES - 1), GL_DEPTH_ATTACHMENT_OES, or GL_STENCIL_ATTACHMENT_OES. pname must be one of the following: GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_OES, GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_OES, GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_OES, or GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_OES.

If the framebuffer currently bound to target is zero, then GL_INVALID_OPERATION is generated.

Upon successful return from glGetFramebufferAttachmentParameterivOES, if pname is GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_OES, then param will contain one of GL_NONE, GL_TEXTURE, or GL_RENDERBUFFER_OES, identifying the type of object which contains the attached image.

If the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_OES is GL_RENDERBUFFER_OES, then:

• If pname is GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_OES, params will contain the name of the renderbuffer object which contains the attached image.
• Otherwise, GL_INVALID_ENUM is generated.

If the value of GL_FRAMEBUFFER_ATTACHMENT_OBJECT_TYPE_OES is GL_TEXTURE, then:

• If is GL_FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_OES, then will contain the name of the texture object which contains the attached image.
• If is GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_LEVEL_OES, then will contain the mipmap level of the texture object which contains the attached image.
• If is GL_FRAMEBUFFER_ATTACHMENT_TEXTURE_CUBE_MAP_FACE_OES and the texture object named FRAMEBUFFER_ATTACHMENT_OBJECT_NAME_OES is a cube map texture, then will contain the cube map face of the cubemap texture object which contains the attached image. Otherwise will contain the value zero.
• Otherwise, GL_INVALID_ENUM is generated.

(OES_framebuffer_object extension) Integer Buffer version of glGetFramebufferAttachmentParameterivOES.

(1.1 + OES_texture_cube_map, OES_blend_subtract , OES_blend_func_separate, and OES_blend_equation_separate extensions) Return the value or values of a selected parameter.

The extensions in the GL 1.1 Extension Pack add the following constants as possible values for pname:

• GL_BLEND_DST_ALPHA (1.1 + OES_blend_func_separate extension)

params returns one value, the symbolic constant identifying the destination blend function set by glBlendFunc, or the destination alpha blend function set by glBlendFuncSeparate. See glBlendFunc and glBlendFuncSeparate.

• GL_BLEND_DST_RGB (1.1 + OES_blend_func_separate extension)

params returns one value, the symbolic constant identifying the destination blend function set by glBlendFunc, or the destination RGB blend function set by glBlendFuncSeparate. See glBlendFunc and glBlendFuncSeparate.

• GL_BLEND_EQUATION (1.1 + OES_blend_subtract and OES_blend_equation_separate extensions)

params returns one value, the symbolic constant identifying the blend equation set by glBlendEquation, or the RGB blend equation set by glBlendEquationSeparate. See glBlendEquation and glBlendEquationSeparate.

• GL_BLEND_EQUATION_ALPHA (1.1 + OES_blend_equation_separate extension)

params returns one value, the symbolic constant identifying the blend equation set by glBlendEquation, or the alpha blend equation set by glBlendEquationSeparate. See glBlendEquation and glBlendEquationSeparate.

• GL_BLEND_EQUATION_RGB (1.1 + OES_blend_subtract and OES_blend_equation_separate extensions)

params returns one value, the symbolic constant identifying the blend equation set by glBlendEquation, or the RGB blend equation set by glBlendEquationSeparate. See glBlendEquation and glBlendEquationSeparate.

• GL_BLEND_SRC (1.1 only)

params returns one value, the symbolic constant identifying the source blend function set by glBlendFunc, or the source RGB blend function set by glBlendFuncSeparate. See glBlendFunc and glBlendFuncSeparate.

• GL_BLEND_SRC_ALPHA (1.1 + OES_blend_func_separate extension)

params returns one value, the symbolic constant identifying the source blend function set by glBlendFunc, or the source alpha blend function set by glBlendFuncSeparate. See glBlendFunc and glBlendFuncSeparate.

• GL_BLEND_SRC_RGB (1.1 + OES_blend_func_separate extension)

params returns one value, the symbolic constant identifying the source blend function set by glBlendFunc, or the source RGB blend function set by glBlendFuncSeparate. See glBlendFunc and glBlendFuncSeparate.

• GL_MAX_CUBE_MAP_TEXTURE_SIZE (1.1 + OES_texture_cube_map extension)

params returns one value, the maximum dimension of any face in a cube map texture. The value must be at least 64. See glTexImage2D, glCompressedTexImage2D, and glCopyTexImage2D.

• GL_MAX_PALETTE_MATRICES_OES ( OES_matrix_palette extension)

params returns the size of the matrix palette. The initial value is 32 if the OES_extended_matrix_palette extension is present.

• GL_MAX_VERTEX_UNITS_OES (OES_matrix_palette extension)

params returns the number of matrices per vertex. The initial value is 4 if the OES_extended_matrix_palette extension is present.

(1.1 + OES_texture_cube_map, OES_blend_subtract , OES_blend_func_separate, and OES_blend_equation_separate extensions) Integer Buffer version of getGetIntegerv.

(OES_framebuffer_object extension) Query a renderbuffer parameter.

target must be GL_RENDERBUFFER_OES. pname must be one of the symbolic values in the table below.

If the renderbuffer currently bound to target is zero, then GL_INVALID_OPERATION is generated.

Upon successful return from glGetRenderbufferParameterivOES, if pname is GL_RENDERBUFFER_WIDTH_OES, GL_RENDERBUFFER_HEIGHT_OES, or GL_RENDERBUFFER_INTERNAL_FORMAT_OES, then params will contain the width in pixels, height in pixels, or internal format, respectively, of the image of the renderbuffer currently bound to target.

Upon successful return from glGetRenderbufferParameterivOES, if pname is GL_RENDERBUFFER_RED_SIZE_OES, GL_RENDERBUFFER_GREEN_SIZE_OES, GL_RENDERBUFFER_BLUE_SIZE_OES, GL_RENDERBUFFER_ALPHA_SIZE_OES, GK_RENDERBUFFER_DEPTH_SIZE_OES, or GL_RENDERBUFFER_STENCIL_SIZE_OES, then params will contain the actual resolutions, (not the resolutions specified when the image array was defined), for the red, green, blue, alpha depth, or stencil components, respectively, of the image of the renderbuffer currently bound to target.

Otherwise, GL_INVALID_ENUM is generated.

The values in the first column of the table below should be prefixed with GL_RENDERBUFFER_ and suffixed with OES. The get command for all values is glGetRenderbufferParameterivOES. All take on positive integral values.

 Get               Initial
 Value             Value    Description
 ---------------   -------  ----------------------
 WIDTH             0        width of renderbuffer
 
 HEIGHT            0        height of renderbuffer
 
 INTERNAL_FORMAT   GL_RGBA  internal format
                            of renderbuffer
 
 RED_SIZE          0        size in bits of
                            renderbuffer image's
                            red component
 
 GREEN_SIZE        0        size in bits of
                            renderbuffer image's
                            green component
 
 BLUE_SIZE         0        size in bits of
                            renderbuffer image's
                            blue component
 
 ALPHA_SIZE        0        size in bits of
                            renderbuffer image's
                            alpha component
 
 DEPTH_SIZE        0        size in bits of
                            renderbuffer image's
                            depth component
 
 STENCIL_SIZE      0        size in bits of
                            renderbuffer image's
                            stencil component
 

(OES_framebuffer_object extension) Integer Buffer version of glGetRenderbufferParameterivOES.

(1.1 + OES_texture_cube_map extension) Floating-point Buffer version of glGetTexGen.

(1.1 + OES_texture_cube_map extension) Floating-point array version of glGetTexGen.

(1.1 + OES_texture_cube_map extension) Integer Buffer version of glGetTexGen.

(1.1 + OES_texture_cube_map extension) Get texture coordinate generation parameters. This method queries texture coordinate generation parameters set using glTexGen.

Errors

GL_INVALID_ENUM is generated if param or pname is not an accepted value, or if pname is GL_TEXTURE_GEN_MODE and params is not GL_REFLECTION_MAP or GL_NORMAL_MAP.

(1.1 + OES_texture_cube_map extension) Fixed-point array version of glGetTexGen.

(1.1 + OES_texture_cube_map extension) Fixed-point Buffer version of glGetTexGen.

(OES_framebuffer_object extension) Determine whether a token represents a framebuffer.

Returns true if framebuffer is the name of a framebuffer object. If framebuffer is zero, or if framebuffer is a non-zero value that is not the name of a framebuffer object, glIsFrambufferOES returns false.

(OES_framebuffer_object extension) Determine whether a token represents a renderbuffer.

Returns true if renderbuffer is the name of a renderbuffer object. If renderbuffer is zero, or if renderbuffer is a non-zero value that is not the name of a renderbuffer object, glIsRenderbufferOES returns false.

(OES_framebuffer_object extension) Establish the layout of a renderbuffer object's image.

The command glRenderbufferStorageOES establishes the data storage, format, and dimensions of a renderbuffer object's image. target must be GL_RENDERBUFFER_OES. internalformat must be one of the sized internal formats from the following tables which has a base internal format of GL_RGB, GL_RGBA, GL_DEPTH_COMPONENT, or GL_STENCIL_INDEX.

The following formats are required:

 Sized                 Base               Size in
 Internal Format       Internal format    Bits
 ---------------       ---------------    ----
 RGB565_OES            RGB                16
 RGBA4                 RGBA               16
 RGB5_A1               RGBA               16
 DEPTH_COMPONENT_16    DEPTH_COMPONENT    16
 

The following formats are optional:

 Sized                 Base               Size in
 Internal Format       Internal format    Bits
 ---------------       ---------------    ----
 RGBA8                 RGBA               32
 RGB8                  RGB                24
 DEPTH_COMPONENT_24    DEPTH_COMPONENT    24
 DEPTH_COMPONENT_32    DEPTH_COMPONENT    32
 STENCIL_INDEX1_OES    STENCIL_INDEX      1
 STENCIL_INDEX4_OES    STENCIL_INDEX      4
 STENCIL_INDEX8_OES    STENCIL_INDEX      8
 

The optional formats are described by the OES_rgb8_rgba8, OES_depth24, OES_depth32, OES_stencil1, OES_stencil4, and OES_stencil8 extensions.

If glRenderbufferStorageOES is called with an internalformat value that is not supported by the OpenGL ES implementation, a GL_INVALID_ENUM error will be generated.

width and height are the dimensions in pixels of the renderbuffer. If either width or height is greater than GL_MAX_RENDERBUFFER_SIZE_OES, then the error GL_INVALID_VALUE is generated. If the GL is unable to create a data store of the requested size, the error GL_OUT_OF_MEMORY is generated. glRenderbufferStorageOES deletes any existing data store for the renderbuffer and the contents of the data store after calling glRenderbufferStorageOES are undefined.

(OES_stencil_wrap extension) Set stencil test actions.

Two additional actions are defined by the OES_stencil_wrap extension:

• (OES_stencil_wrap extension) GL_DECR_WRAP

Decrements the current stencil buffer value, wrapping around to the maximum representable unsigned value if less than 0.

• (OES_stencil_wrap extension) GL_INCR

Increments the current stencil buffer value, wrapping around to 0 if greater than the maximum representable unsigned value.

(OES_texture_env_crossbar extension) Set texture environment parameters.

The OES_texture_env_crossbar extension adds the capability to use the texture color from other texture units as sources to the COMBINE texture function. OpenGL ES 1.1 defined texture combine functions which could use the color from the current texture unit as a source. This extension adds the ability to use the color from any texture unit as a source.

The tables that define arguments for COMBINE_RGB and COMBINE_ALPHA functions are extended to include TEXTUREn:

 SRCn_RGB           OPERANDn_RGB              Argument
 
 TEXTURE            SRC_COLOR                 Cs
                    ONE_MINUS_SRC_COLOR       1 - Cs
                    SRC_ALPHA                 As
                    ONE_MINUS_SRC_ALPHA       1 - As
 
 TEXTUREn           SRC_COLOR                 Cs^n
                    ONE_MINUS_SRC_COLOR       1 - Cs^n
                    SRC_ALPHA                 As^n
                    ONE_MINUS_SRC_ALPHA       1 - As^n
 
 CONSTANT           SRC_COLOR                 Cc
                    ONE_MINUS_SRC_COLOR       1 - Cc
                    SRC_ALPHA                 Ac
                    ONE_MINUS_SRC_ALPHA       1 - Ac
 
 PRIMARY_COLOR      SRC_COLOR                 Cf
                    ONE_MINUS_SRC_COLOR       1 - Cf
                    SRC_ALPHA                 Af
                    ONE_MINUS_SRC_ALPHA       1 - Af
 
 PREVIOUS           SRC_COLOR                 Cp
                    ONE_MINUS_SRC_COLOR       1 - Cp
                    SRC_ALPHA                 Ap
                    ONE_MINUS_SRC_ALPHA       1 - Ap
 

(OES_texture_env_crossbar extension) Floating-point array version of glTexEnv.

(OES_texture_env_crossbar extension) Floating-point Buffer version of glTexEnv.

(OES_texture_env_crossbar extension) Integer version of glTexEnv.

(OES_texture_env_crossbar extension) Fixed-point array version of glTexEnv.

(OES_texture_env_crossbar extension) Fixed-point Buffer version of glTexEnv.

(1.1 + OES_texture_cube_map extension) Floating-point version of glTexGen.

(1.1 + OES_texture_cube_map extension) Floating-point Buffer version of glTexGen.

(1.1 + OES_texture_cube_map extension) Floating-point array version of glTexGen.

(1.1 + OES_texture_cube_map extension) Specify texture coordinate generation function.

The OES_texture_cube_map extension provides a new texture generation scheme for cube map textures. Instead of the current texture providing a 2D lookup into a 2D texture image, the texture is a set of six 2D images representing the faces of a cube. The (s,t,r) texture coordinates are treated as a direction vector emanating from the center of a cube. At texture generation time, the interpolated per-fragment (s,t,r) selects one cube face 2D image based on the largest magnitude coordinate (the major axis). A new 2D (s,t) is calculated by dividing the two other coordinates (the minor axes values) by the major axis value. Then the new (s,t) is used to lookup into the selected 2D texture image face of the cube map.

Unlike a standard 2D texture that have just one target, a cube map texture has six targets, one for each of its six 2D texture image cube faces. All these targets must be consistent, complete, and have equal width and height.

This extension also provides two new texture coordinate generation modes for use in conjunction with cube map texturing. The reflection map mode generates texture coordinates (s,t,r) matching the vertex?s eyespace reflection vector. The reflection map mode is useful for environment mapping without the singularity inherent in sphere mapping. The normal map mode generates texture coordinates (s,t,r) matching the vertex?s transformed eyespace normal. The normal map mode is useful for sophisticated cube map texturing-based diffuse lighting models.

The intent of the new texgen functionality is that an application using cube map texturing can use the new texgen modes to automatically generate the reflection or normal vectors used to look up into the cube map texture.

The following texgen modes are supported: GL_REFLECTION MAP and GL_NORMAL MAP. The GL_SPHERE_MAP, GL_OBJECT LINEAR, and GL_EYE LINEAR texgen modes are not supported. Texgen supports a new coord value GL_STR. This allows the application to specify the texgen mode for the appropriate coordinates in a single call. Texgen with coord values of GL_S, GL_T, GL_R and GL_Q are not supported.

Errors

GL_INVALID_ENUM is generated if param or pname is not an accepted value, or if pname is GL_TEXTURE_GEN_MODE and params is not GL_REFLECTION_MAP or GL_NORMAL_MAP.

Associated Gets

glGetTexGen, glIsEnabled with argument GL_TEXTURE_GEN_STR.

(1.1 + OES_texture_cube_map extension) Integer Buffer version of glTexGen.

(1.1 + OES_texture_cube_map extension) Integer array version of glTexGen.

(1.1 + OES_texture_cube_map extension) Fixed-point version of glTexGen.

(1.1 + OES_texture_cube_map extension) Fixed-point array version of glTexGen.

(1.1 + OES_texture_cube_map extension) Fixed-point Buffer version of glTexGen.

(OES_texture_mirrored_repeat extension) Set texture parameters.

An additional option is accepted for GL_TEXTURE_WRAP_S and GL_TEXTURE_WRAP_T parameters. GL_MIRRORED_REPEAT effectively uses a texture map twice as large as the original image im which the additional half, for each coordinate, of the new image is a mirror image of the original image.