Package org.lwjgl.opengles

Class OESRequiredInternalformat

java.lang.Object

org.lwjgl.opengles.OESRequiredInternalformat

public final class OESRequiredInternalformat
extends java.lang.Object

Native bindings to the OES_required_internalformat extension.

The ES 1.1 API allows an implementation to store texture data internally with arbitrary precision, regardless of the format and type of the data supplied by the application. Similarly, ES allows an implementation to choose an arbitrary precision for the internal storage of image data allocated by glRenderbufferStorageOES.

While this allows flexibility for implementations, it does mean that an application does not have a reliable means to request the implementation maintain a specific precision or to find out what precision the implementation will maintain for a given texture or renderbuffer image.

For reference, "Desktop" OpenGL uses the internalformat argument to glTexImage*, glCopyTexImage* and glRenderbufferStorageEXT as a hint, defining the particular base format and precision that the application wants the implementation to maintain when storing the image data. Further, the application can choose an internalformat with a different base internal format than the source format specified by format. The implementation is not required to exactly match the precision specified by internalformat when choosing an internal storage precision, but it is required to match the base internal format of internalformat.

In addition, ES 1.1 does not allow an implementation to fail a request to glTexImage2D for any of the legal format and type, even if the implementation does not natively support data stored in that external format and type. However, there are no additional requirements placed on the implementation. The ES implementation is free to store the texture data with lower precision than originally specified, for instance. Further, since ES removes the ability to query the texture object to find out what internal format it chose, there is no way for the application to find out that this has happened.

This extension addresses the situation in two ways:

1. This extension introduces the ability for an application to specify the desired "sized" internal formats for texture image allocation.
2. This extension guarantees to maintain at least the specified precision of all available sized internal formats.

An implementation that exports this extension is committing to support all of the legal values for internalformat, subject to the extension dependencies described herein. That is to say, the implementation is guaranteeing that choosing an internalformat argument with a value from these tables will not cause an image allocation request to fail. Furthermore, it is guaranteeing that for any sized internal format, the renderbuffer or texture data will be stored with at least the precision prescribed by the sized internal format.

Field Summary

Fields

Modifier and Type	Field	Description
static int	GL_ALPHA8_OES GL_DEPTH_COMPONENT16_OES GL_DEPTH_COMPONENT24_OES GL_DEPTH_COMPONENT32_OES GL_DEPTH24_STENCIL8_OES GL_LUMINANCE4_ALPHA4_OES GL_LUMINANCE8_ALPHA8_OES GL_LUMINANCE8_OES GL_RGB10_A2_EXT GL_RGB10_EXT GL_RGB5_A1_OES GL_RGB565_OES GL_RGB8_OES GL_RGBA4_OES GL_RGBA8_OES	Accepted by the internalformat argument of TexImage2D, TexImage3DOES, and CopyTexImage2D.

Method Summary

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

GL_ALPHA8_OES, GL_LUMINANCE8_OES, GL_LUMINANCE8_ALPHA8_OES, GL_LUMINANCE4_ALPHA4_OES, GL_RGB565_OES, GL_RGB8_OES, GL_RGBA4_OES, GL_RGB5_A1_OES, GL_RGBA8_OES, GL_DEPTH_COMPONENT16_OES, GL_DEPTH_COMPONENT24_OES, GL_DEPTH_COMPONENT32_OES, GL_DEPTH24_STENCIL8_OES, GL_RGB10_EXT, GL_RGB10_A2_EXT

Accepted by the internalformat argument of TexImage2D, TexImage3DOES, and CopyTexImage2D.