org.lwjgl.opengles

Class IMGMultisampledRenderToTexture

java.lang.Object

org.lwjgl.opengles.IMGMultisampledRenderToTexture

public class IMGMultisampledRenderToTexture
extends java.lang.Object

Native bindings to the IMG_multisampled_render_to_texture extension.

This extension introduces functionality to perform multisampled rendering to a color renderable texture, without requiring an explicit resolve of multisample data.

Some GPU architectures - such as tile-based renderers - are capable of performing multisampled rendering by storing multisample data in internal high-speed memory and downsampling the data when writing out to external memory after rendering has finished. Since per-sample data is never written out to external memory, this approach saves bandwidth and storage space. In this case multisample data gets discarded, however this is acceptable in most cases.

The extension provides a new command, FramebufferTexture2DMultisampleIMG, which attaches a texture level to a framebuffer and enables multisampled rendering to that texture level.

When the texture level is used as a source or destination for any operation other than drawing to it, an implicit resolve of multisampled color data is performed. After such a resolve, the multisampled color data is discarded.

In order to allow the use of multisampled depth and stencil buffers when performing multisampled rendering to a texture, the extension also adds the command RenderbufferStorageMultisampleIMG.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE_IMG Returned by CheckFramebufferStatus.
static int	GL_MAX_SAMPLES_IMG Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.
static int	GL_RENDERBUFFER_SAMPLES_IMG Accepted by the pname parameter of GetRenderbufferParameteriv.
static int	GL_TEXTURE_SAMPLES_IMG Accepted by the pname parameter of GetFramebufferAttachmentParameteriv.

Method Summary

Modifier and Type	Method and Description
static void	glFramebufferTexture2DMultisampleIMG(int target, int attachment, int textarget, int texture, int level, int samples)
static void	glRenderbufferStorageMultisampleIMG(int target, int samples, int internalformat, int width, int height)

Methods inherited from class java.lang.Object

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

Field Detail

GL_RENDERBUFFER_SAMPLES_IMG

public static final int GL_RENDERBUFFER_SAMPLES_IMG

Accepted by the pname parameter of GetRenderbufferParameteriv.

See Also:

Constant Field Values

GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE_IMG

public static final int GL_FRAMEBUFFER_INCOMPLETE_MULTISAMPLE_IMG

Returned by CheckFramebufferStatus.

See Also:

Constant Field Values

GL_MAX_SAMPLES_IMG

public static final int GL_MAX_SAMPLES_IMG

Accepted by the pname parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev.

See Also:

Constant Field Values

GL_TEXTURE_SAMPLES_IMG

public static final int GL_TEXTURE_SAMPLES_IMG

Accepted by the pname parameter of GetFramebufferAttachmentParameteriv.

See Also:

Constant Field Values

Method Detail

glRenderbufferStorageMultisampleIMG

public static void glRenderbufferStorageMultisampleIMG(int target,
                                                       int samples,
                                                       int internalformat,
                                                       int width,
                                                       int height)

glFramebufferTexture2DMultisampleIMG

public static void glFramebufferTexture2DMultisampleIMG(int target,
                                                        int attachment,
                                                        int textarget,
                                                        int texture,
                                                        int level,
                                                        int samples)