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

The OpenGL ES 1.1 Extension Pack consists of the following extensions:

• OES_texture_env_crossbar
• OES_texture_mirrored_repeat
• OES_texture_cube_map
• OES_blend_subtract
• OES_blend_func_separate
• OES_blend_equation_separate
• OES_stencil_wrap
• OES_extended_matrix_palette
• OES_framebuffer_object

The specification for the OpenGL ES 1.1 Extension Pack may be found at http://www.khronos.org/cgi-bin/fetch/fetch.cgi?opengles_spec_1_1_extension_pack.

The documentation in this class is normative with respect to instance variable names and values, method names and signatures, and exception behavior. The remaining documentation is placed here for convenience and does not replace the normative documentation found in the OpenGL ES 1.1 Extension Pack specification, OpenGL ES specification, relevant extension specifications, and the OpenGL specification versions referenced by any of the preceding specifications.

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.

A renderbuffer is a data storage object containing a single image of a renderable internal format.

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.
Parameters:
  mode - Specifies the blendequation.

glBlendEquationSeparate allows different blend equations to be provideded for RGB and alpha.

glBlendFuncSeparate allows different blend factors to be applied to RGB and alpha.

Framebuffer objects are deleted by calling glDeleteFramebuffersOES.

Renderbuffer objects are deleted by calling glDeleteRenderbuffersOES where renderbuffers contains n names of renderbuffer objects to be deleted.

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.

A renderbuffer can be attached as one of the logical buffers of the currently bound framebuffer object by calling glFramebufferRenderbufferOES.

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.

The command glGenFramebuffersOES returns n previously unused framebuffer object names in ids.

The command glGenRenderbuffersOES returns n previously unused renderbuffer object names in renderbuffers.

target is one of TEXTURE_2D or TEXTURE_CUBE_MAP.

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.

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.

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.
Parameters:
  coord - Specifies the texture coordinate or coordinates forwhich a generation parameter is being requested.

Returns true if framebuffer is the name of a framebuffer object.

Returns true if renderbuffer is the name of a renderbuffer object.

The command glRenderbufferStorageOES establishes the data storage, format, and dimensions of a renderbuffer object's image.

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.

The OES_texture_cube_map extension provides a new texture generation scheme for cube map textures.

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.

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.
Parameters:
  target - the value GL_RENDERBUFFER_OES.
Parameters:
  renderbuffer - Specifies the name of a renderbuffer.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.

The OES_texture_cube_map extension allows the value GL_TEXTURE_CUBE_MAP to be passed to the target parameter.
Parameters:
  target - additionally acceptsGL_TEXTURE_CUBE_MAP.
See Also:   GL11.glBindTexture(int targetint texture)

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.
Parameters:
  mode - Specifies the blendequation. GL_FUNC_ADD,GL_FUNC_SUBTRACT, andGL_FUNC_REVERSE_SUBTRACT are accepted.
See Also:   GL11.glBlendFunc
See Also:   GL11ExtensionPack.glBlendFuncSeparate
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_blend_subtract extension.

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.
Parameters:
  modeRGB - RGB blend equation. Must be one of the blendequations accepted by glBlendEquation.
Parameters:
  modeAlpha - Alpha blend equation. Must be one of the blendequations accepted by glBlendEquation.
See Also:   GL11ExtensionPack.glBlendEquation
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_blend_equation_separate extension.

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.
Parameters:
  srcRGB - Source RGB blend function. Must be one of the blendfunctions accepted by glBlendFunc.
Parameters:
  dstRGB - Destination RGB blend function. Must be one of the blendfunctions accepted by glBlendFunc.
Parameters:
  srcAlpha - Source alpha blend function. Must be one of theblend functions accepted by glBlendFunc.
Parameters:
  dstAlpha - Destination alpha blend function. Must be one ofthe blend functions accepted by glBlendFunc.
See Also:   GL11.glBlendFunc
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_blend_func_separate extension.

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.
Parameters:
  target - a framebuffer.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.

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.
Parameters:
  target - additionally accepts the constantsGL_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, andGL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
See Also:   GL11.glCompressedTexImage2D
exception:
  IllegalArgumentException - if data isnull.
exception:
  IllegalArgumentException - ifdata.remaining() is less thanimageSize.

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.
Parameters:
  target - additionally accepts the constantsGL_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, andGL_TEXTURE_CUBE_MAP_NEGATIVE_Z.
See Also:   GL11.glCompressedTexImage2D

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.
Parameters:
  n - the number of framebuffers to be deleted.
Parameters:
  framebuffers - a list of framebuffers.
Parameters:
  offset - the starting offset within theframebuffers array.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.
exception:
  IllegalArgumentException - if framebuffers isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if framebuffers.length- offset is less than n.

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.
Parameters:
  n - the number of renderbuffers to be deleted.
Parameters:
  renderbuffers - an array of n renderbuffer names.
Parameters:
  offset - the starting offset within therenderbuffers array.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.
exception:
  IllegalArgumentException - if renderbuffers isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if renderbuffers.length- offset is less than n.

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.
See Also:   GL11.glEnable(int cap)

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.
 

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.
 

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.
Parameters:
  n - the number of framebuffer names to be generated.
Parameters:
  framebuffers - an array to be filled in with nframebuffer names.
Parameters:
  offset - the starting offset within theframebuffers array.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.
exception:
  IllegalArgumentException - if framebuffers isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if framebuffers.length- offset is less than n.

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.
Parameters:
  n - the number of renderbuffer names to be generated.
Parameters:
  renderbuffers - an array to be filled in with nrenderbuffer names.
Parameters:
  offset - the starting offset within therenderbuffers array.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.
exception:
  IllegalArgumentException - if renderbuffers isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if renderbuffers.length- offset is less than n.

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.
Parameters:
  target - one of TEXTURE_2D orTEXTURE_CUBE_MAP.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.

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.

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.

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
 

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.
Parameters:
  coord - Specifies the texture coordinate or coordinates forwhich a generation parameter is being requested. At present, onlyGL_STR is accepted.
Parameters:
  pname - Specifies a single-valued integer texture coordinategeneration parameter. At present, onlyGL_TEXTURE_GEN_MODE is accepted.
Parameters:
  params - Returns the value or values of the specifiedparameter.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_texture_cube_map extension.
exception:
  IllegalArgumentException - if params isnull.
exception:
  IllegalArgumentException - if offset isless than 0.
exception:
  IllegalArgumentException - if params.length -offset is smaller than the number of values required bythe parameter.

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.
Parameters:
  framebuffer - an integer.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.

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.
Parameters:
  renderbuffer - an integer.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.

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.
Parameters:
  target - the value GL_RENDERBUFFER_OES.
Parameters:
  internalformat - one of GL_RGB,GL_RGBA, GL_DEPTH_COMPONENT,GL_STENCIL_INDEX, or an internal format that has oneof those as a base format.
Parameters:
  width - the width of the image.
Parameters:
  height - the height of the image.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_framebuffer_object extension.

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.

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
 

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.
Parameters:
  coord - Specifies the texture coordinate or coordinates forwhich a generation function is being specified. At present, onlyGL_STR is accepted.
Parameters:
  pname - Specifies a single-valued integer texture coordinategeneration parameter. At present, onlyGL_TEXTURE_GEN_MODE is accepted.
Parameters:
  param - Specifies the value that pname will beset to. If pname is GL_TEXTURE_GEN_MODE, thenGL_REFLECTION_MAP and GL_NORMAL_MAP areaccepted.
exception:
  UnsupportedOperationException - if the underlyingruntime engine does not support theOES_texture_cube_map extension.

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.
See Also:   GL11.glTexParameterf(int targetint pnamefloat param)