org.lwjgl.opengles.EXTTextureStorage 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
A royalty-free, cross-platform API for full-function 2D and 3D graphics on embedded systems - including consoles, phones, appliances and vehicles.
There is a newer version: 3.3.4
Show newest version
/*
 * Copyright LWJGL. All rights reserved.
 * License terms: https://www.lwjgl.org/license
 * MACHINE GENERATED FILE, DO NOT EDIT
 */
package org.lwjgl.opengles;

import org.lwjgl.system.*;

import static org.lwjgl.system.Checks.*;

/**
 * Native bindings to the EXT_texture_storage extension.
 * 
 * The texture image specification commands in OpenGL allow each level to be separately specified with different sizes, formats, types and so on, and only
 * imposes consistency checks at draw time. This adds overhead for implementations.
 * 
 * This extension provides a mechanism for specifying the entire structure of a texture in a single call, allowing certain consistency checks and memory
 * allocations to be done up front. Once specified, the format and dimensions of the image array become immutable, to simplify completeness checks in the
 * implementation.
 * 
 * When using this extension, it is no longer possible to supply texture data using TexImage*. Instead, data can be uploaded using TexSubImage*, or
 * produced by other means (such as render-to-texture, mipmap generation, or rendering to a sibling EGLImage).
 * 
 * This extension has complicated interactions with other extensions. The goal of most of these interactions is to ensure that a texture is always mipmap
 * complete (and cube complete for cubemap textures).
 * 
 * Requires {@link GLES20 GLES 2.0}.
 */
public class EXTTextureStorage {

    /** Accepted by the {@code value} parameter of GetTexParameter{if}v. */
    public static final int GL_TEXTURE_IMMUTABLE_FORMAT_EXT = 0x912F;

    /** Accepted by the {@code internalformat} parameter of TexStorage when implemented on OpenGL ES. */
    public static final int
        GL_ALPHA8_EXT             = 0x803C,
        GL_LUMINANCE8_EXT         = 0x8040,
        GL_LUMINANCE8_ALPHA8_EXT  = 0x8045,
        GL_RGBA32F_EXT            = 0x8814,
        GL_RGB32F_EXT             = 0x8815,
        GL_ALPHA32F_EXT           = 0x8816,
        GL_LUMINANCE32F_EXT       = 0x8818,
        GL_LUMINANCE_ALPHA32F_EXT = 0x8819,
        GL_RGBA16F_EXT            = 0x881A,
        GL_RGB16F_EXT             = 0x881B,
        GL_ALPHA16F_EXT           = 0x881C,
        GL_LUMINANCE16F_EXT       = 0x881E,
        GL_LUMINANCE_ALPHA16F_EXT = 0x881F,
        GL_RGB10_A2_EXT           = 0x8059,
        GL_RGB10_EXT              = 0x8052,
        GL_BGRA8_EXT              = 0x93A1,
        GL_R8_EXT                 = 0x8229,
        GL_RG8_EXT                = 0x822B,
        GL_R32F_EXT               = 0x822E,
        GL_RG32F_EXT              = 0x8230,
        GL_R16F_EXT               = 0x822D,
        GL_RG16F_EXT              = 0x822F,
        GL_RGB_RAW_422_APPLE      = 0x8A51;

    static { GLES.initialize(); }

    protected EXTTextureStorage() {
        throw new UnsupportedOperationException();
    }

    static boolean isAvailable(GLESCapabilities caps, java.util.Set ext) {
        return checkFunctions(
            caps.glTexStorage1DEXT, caps.glTexStorage2DEXT, caps.glTexStorage3DEXT, caps.hasDSA(ext) ? caps.glTextureStorage1DEXT : -1L, 
            caps.hasDSA(ext) ? caps.glTextureStorage2DEXT : -1L, caps.hasDSA(ext) ? caps.glTextureStorage3DEXT : -1L
        );
    }

    // --- [ glTexStorage1DEXT ] ---

    public static native void glTexStorage1DEXT(@NativeType("GLenum") int target, @NativeType("GLsizei") int levels, @NativeType("GLenum") int internalformat, @NativeType("GLsizei") int width);

    // --- [ glTexStorage2DEXT ] ---

    public static native void glTexStorage2DEXT(@NativeType("GLenum") int target, @NativeType("GLsizei") int levels, @NativeType("GLenum") int internalformat, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height);

    // --- [ glTexStorage3DEXT ] ---

    public static native void glTexStorage3DEXT(@NativeType("GLenum") int target, @NativeType("GLsizei") int levels, @NativeType("GLenum") int internalformat, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth);

    // --- [ glTextureStorage1DEXT ] ---

    public static native void glTextureStorage1DEXT(@NativeType("GLuint") int texture, @NativeType("GLenum") int target, @NativeType("GLsizei") int levels, @NativeType("GLenum") int internalformat, @NativeType("GLsizei") int width);

    // --- [ glTextureStorage2DEXT ] ---

    public static native void glTextureStorage2DEXT(@NativeType("GLuint") int texture, @NativeType("GLenum") int target, @NativeType("GLsizei") int levels, @NativeType("GLenum") int internalformat, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height);

    // --- [ glTextureStorage3DEXT ] ---

    public static native void glTextureStorage3DEXT(@NativeType("GLuint") int texture, @NativeType("GLenum") int target, @NativeType("GLsizei") int levels, @NativeType("GLenum") int internalformat, @NativeType("GLsizei") int width, @NativeType("GLsizei") int height, @NativeType("GLsizei") int depth);

}