org.lwjgl.opengles.EXTClearTexture Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of lwjgl-opengles Show documentation
Show all versions of lwjgl-opengles Show documentation
A royalty-free, cross-platform API for full-function 2D and 3D graphics on embedded systems - including consoles, phones, appliances and vehicles.
/*
* Copyright LWJGL. All rights reserved.
* License terms: https://www.lwjgl.org/license
* MACHINE GENERATED FILE, DO NOT EDIT
*/
package org.lwjgl.opengles;
import javax.annotation.*;
import java.nio.*;
import org.lwjgl.system.*;
import static org.lwjgl.system.Checks.*;
import static org.lwjgl.system.JNI.*;
import static org.lwjgl.system.MemoryUtil.*;
/**
* 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 {@code Clear} or {@code 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
* {@link #glClearTexImageEXT ClearTexImageEXT} or {@link #glClearTexSubImageEXT ClearTexSubImageEXT} commands. These commands can also be useful for initializing an image that will be used for atomic shader
* operations.
*
* Requires {@link GLES31 GLES 3.1}.
*/
public class EXTClearTexture {
static { GLES.initialize(); }
protected EXTClearTexture() {
throw new UnsupportedOperationException();
}
// --- [ glClearTexImageEXT ] ---
public static native void nglClearTexImageEXT(int texture, int level, int format, int type, long data);
public static void glClearTexImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") ByteBuffer data) {
nglClearTexImageEXT(texture, level, format, type, memAddressSafe(data));
}
public static void glClearTexImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") ShortBuffer data) {
nglClearTexImageEXT(texture, level, format, type, memAddressSafe(data));
}
public static void glClearTexImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") IntBuffer data) {
nglClearTexImageEXT(texture, level, format, type, memAddressSafe(data));
}
public static void glClearTexImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") FloatBuffer data) {
nglClearTexImageEXT(texture, level, format, type, memAddressSafe(data));
}
// --- [ glClearTexSubImageEXT ] ---
public static native void nglClearTexSubImageEXT(int texture, int level, int xoffset, int yoffset, int zoffset, int width, int height, int depth, int format, int type, long data);
public static void glClearTexSubImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLint") int xoffset, @NativeType("GLint") int yoffset, @NativeType("GLint") int zoffset, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") ByteBuffer data) {
nglClearTexSubImageEXT(texture, level, xoffset, yoffset, zoffset, width, height, depth, format, type, memAddressSafe(data));
}
public static void glClearTexSubImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLint") int xoffset, @NativeType("GLint") int yoffset, @NativeType("GLint") int zoffset, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") ShortBuffer data) {
nglClearTexSubImageEXT(texture, level, xoffset, yoffset, zoffset, width, height, depth, format, type, memAddressSafe(data));
}
public static void glClearTexSubImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLint") int xoffset, @NativeType("GLint") int yoffset, @NativeType("GLint") int zoffset, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") IntBuffer data) {
nglClearTexSubImageEXT(texture, level, xoffset, yoffset, zoffset, width, height, depth, format, type, memAddressSafe(data));
}
public static void glClearTexSubImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLint") int xoffset, @NativeType("GLint") int yoffset, @NativeType("GLint") int zoffset, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") FloatBuffer data) {
nglClearTexSubImageEXT(texture, level, xoffset, yoffset, zoffset, width, height, depth, format, type, memAddressSafe(data));
}
/** Array version of: {@link #glClearTexImageEXT ClearTexImageEXT} */
public static void glClearTexImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") short[] data) {
long __functionAddress = GLES.getICD().glClearTexImageEXT;
if (CHECKS) {
check(__functionAddress);
}
callPV(texture, level, format, type, data, __functionAddress);
}
/** Array version of: {@link #glClearTexImageEXT ClearTexImageEXT} */
public static void glClearTexImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") int[] data) {
long __functionAddress = GLES.getICD().glClearTexImageEXT;
if (CHECKS) {
check(__functionAddress);
}
callPV(texture, level, format, type, data, __functionAddress);
}
/** Array version of: {@link #glClearTexImageEXT ClearTexImageEXT} */
public static void glClearTexImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") float[] data) {
long __functionAddress = GLES.getICD().glClearTexImageEXT;
if (CHECKS) {
check(__functionAddress);
}
callPV(texture, level, format, type, data, __functionAddress);
}
/** Array version of: {@link #glClearTexSubImageEXT ClearTexSubImageEXT} */
public static void glClearTexSubImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLint") int xoffset, @NativeType("GLint") int yoffset, @NativeType("GLint") int zoffset, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") short[] data) {
long __functionAddress = GLES.getICD().glClearTexSubImageEXT;
if (CHECKS) {
check(__functionAddress);
}
callPV(texture, level, xoffset, yoffset, zoffset, width, height, depth, format, type, data, __functionAddress);
}
/** Array version of: {@link #glClearTexSubImageEXT ClearTexSubImageEXT} */
public static void glClearTexSubImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLint") int xoffset, @NativeType("GLint") int yoffset, @NativeType("GLint") int zoffset, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") int[] data) {
long __functionAddress = GLES.getICD().glClearTexSubImageEXT;
if (CHECKS) {
check(__functionAddress);
}
callPV(texture, level, xoffset, yoffset, zoffset, width, height, depth, format, type, data, __functionAddress);
}
/** Array version of: {@link #glClearTexSubImageEXT ClearTexSubImageEXT} */
public static void glClearTexSubImageEXT(@NativeType("GLuint") int texture, @NativeType("GLint") int level, @NativeType("GLint") int xoffset, @NativeType("GLint") int yoffset, @NativeType("GLint") int zoffset, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth, @NativeType("GLenum") int format, @NativeType("GLenum") int type, @Nullable @NativeType("void const *") float[] data) {
long __functionAddress = GLES.getICD().glClearTexSubImageEXT;
if (CHECKS) {
check(__functionAddress);
}
callPV(texture, level, xoffset, yoffset, zoffset, width, height, depth, format, type, data, __functionAddress);
}
}