Package org.lwjgl.opengles

Class EXTClearTexture

java.lang.Object

org.lwjgl.opengles.EXTClearTexture

public class EXTClearTexture
extends java.lang.Object

Native bindings to the EXT_clear_texture extension.

Texture objects are fundamental to the operation of OpenGL. They are used as a source for texture sampling and destination for rendering as well as being accessed in shaders for image load/store operations It is also possible to invalidate the contents of a texture. It is currently only possible to set texture image data to known values by uploading some or all of a image array from application memory or by attaching it to a framebuffer object and using the Clear or ClearBuffer commands.

Both uploading initial texture data and clearing by attaching to a framebuffer have potential disadvantages when one simply wants to initialize texture data to a known value. Uploading initial data requires the application to allocate a (potentially large) chunk of memory and transferring that to the GL. This can be a costly operation both in terms of memory bandwidth and power usage. Alternatively, attaching a texture level to a framebuffer to clear it may not be possible if the texture format isn't supported for rendering, or even if it is, attaching the image to a framebuffer object may cause the texture to be allocated in certain types of memory, which it may otherwise not need to be placed in.

This extension solves these problems by providing a mechanism whereby the contents of a texture image array can be set to known values by using the ClearTexImageEXT or ClearTexSubImageEXT commands. These commands can also be useful for initializing an image that will be used for atomic shader operations.

Requires GLES 3.1.

Method Summary

Modifier and Type	Method	Description
static void	glClearTexImageEXT(int texture, int level, int format, int type, float[] data)	Array version of: ClearTexImageEXT
static void	glClearTexImageEXT(int texture, int level, int format, int type, int[] data)	Array version of: ClearTexImageEXT
static void	glClearTexImageEXT(int texture, int level, int format, int type, short[] data)	Array version of: ClearTexImageEXT
static void	glClearTexImageEXT(int texture, int level, int format, int type, java.nio.ByteBuffer data)
static void	glClearTexImageEXT(int texture, int level, int format, int type, java.nio.FloatBuffer data)
static void	glClearTexImageEXT(int texture, int level, int format, int type, java.nio.IntBuffer data)
static void	glClearTexImageEXT(int texture, int level, int format, int type, java.nio.ShortBuffer data)
static void	glClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, float[] data)	Array version of: ClearTexSubImageEXT
static void	glClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, int[] data)	Array version of: ClearTexSubImageEXT
static void	glClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, short[] data)	Array version of: ClearTexSubImageEXT
static void	glClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.ByteBuffer data)
static void	glClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.FloatBuffer data)
static void	glClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.IntBuffer data)
static void	glClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, java.nio.ShortBuffer data)
static void	nglClearTexImageEXT(int texture, int level, int format, int type, long data)
static void	nglClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, long data)

Methods inherited from class java.lang.Object

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

Method Detail

nglClearTexImageEXT

public static void nglClearTexImageEXT(int texture,
                                       int level,
                                       int format,
                                       int type,
                                       long data)

glClearTexImageEXT

public static void glClearTexImageEXT(int texture,
                                      int level,
                                      int format,
                                      int type,
                                      @Nullable
                                      java.nio.ByteBuffer data)

glClearTexImageEXT

public static void glClearTexImageEXT(int texture,
                                      int level,
                                      int format,
                                      int type,
                                      @Nullable
                                      java.nio.ShortBuffer data)

glClearTexImageEXT

public static void glClearTexImageEXT(int texture,
                                      int level,
                                      int format,
                                      int type,
                                      @Nullable
                                      java.nio.IntBuffer data)

glClearTexImageEXT

public static void glClearTexImageEXT(int texture,
                                      int level,
                                      int format,
                                      int type,
                                      @Nullable
                                      java.nio.FloatBuffer data)

nglClearTexSubImageEXT

public static void nglClearTexSubImageEXT(int texture,
                                          int level,
                                          int xoffset,
                                          int yoffset,
                                          int zoffset,
                                          int width,
                                          int height,
                                          int depth,
                                          int format,
                                          int type,
                                          long data)

glClearTexSubImageEXT

public static void glClearTexSubImageEXT(int texture,
                                         int level,
                                         int xoffset,
                                         int yoffset,
                                         int zoffset,
                                         int width,
                                         int height,
                                         int depth,
                                         int format,
                                         int type,
                                         @Nullable
                                         java.nio.ByteBuffer data)

glClearTexSubImageEXT

public static void glClearTexSubImageEXT(int texture,
                                         int level,
                                         int xoffset,
                                         int yoffset,
                                         int zoffset,
                                         int width,
                                         int height,
                                         int depth,
                                         int format,
                                         int type,
                                         @Nullable
                                         java.nio.ShortBuffer data)

glClearTexSubImageEXT

public static void glClearTexSubImageEXT(int texture,
                                         int level,
                                         int xoffset,
                                         int yoffset,
                                         int zoffset,
                                         int width,
                                         int height,
                                         int depth,
                                         int format,
                                         int type,
                                         @Nullable
                                         java.nio.IntBuffer data)

glClearTexSubImageEXT

public static void glClearTexSubImageEXT(int texture,
                                         int level,
                                         int xoffset,
                                         int yoffset,
                                         int zoffset,
                                         int width,
                                         int height,
                                         int depth,
                                         int format,
                                         int type,
                                         @Nullable
                                         java.nio.FloatBuffer data)

glClearTexImageEXT

public static void glClearTexImageEXT(int texture,
                                      int level,
                                      int format,
                                      int type,
                                      @Nullable
                                      short[] data)

public static void glClearTexImageEXT(int texture,
                                      int level,
                                      int format,
                                      int type,
                                      @Nullable
                                      int[] data)

public static void glClearTexImageEXT(int texture,
                                      int level,
                                      int format,
                                      int type,
                                      @Nullable
                                      float[] data)

Array version of: ClearTexImageEXT

glClearTexSubImageEXT

public static void glClearTexSubImageEXT(int texture,
                                         int level,
                                         int xoffset,
                                         int yoffset,
                                         int zoffset,
                                         int width,
                                         int height,
                                         int depth,
                                         int format,
                                         int type,
                                         @Nullable
                                         short[] data)

public static void glClearTexSubImageEXT(int texture,
                                         int level,
                                         int xoffset,
                                         int yoffset,
                                         int zoffset,
                                         int width,
                                         int height,
                                         int depth,
                                         int format,
                                         int type,
                                         @Nullable
                                         int[] data)

public static void glClearTexSubImageEXT(int texture,
                                         int level,
                                         int xoffset,
                                         int yoffset,
                                         int zoffset,
                                         int width,
                                         int height,
                                         int depth,
                                         int format,
                                         int type,
                                         @Nullable
                                         float[] data)

Array version of: ClearTexSubImageEXT