org.lwjgl.opengles.EXTSparseTexture 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_sparse_texture extension.
 * 
 * Recent advances in application complexity and a desire for higher resolutions have pushed texture sizes up considerably. Often, the amount of physical
 * memory available to a graphics processor is a limiting factor in the performance of texture-heavy applications. Once the available physical memory is
 * exhausted, paging may occur bringing performance down considerably - or worse, the application may fail. Nevertheless, the amount of address space
 * available to the graphics processor has increased to the point where many gigabytes - or even terabytes of address space may be usable even though that
 * amount of physical memory is not present.
 * 
 * This extension allows the separation of the graphics processor's address space (reservation) from the requirement that all textures must be physically
 * backed (commitment). This exposes a limited form of virtualization for textures. Use cases include sparse (or partially resident) textures, texture
 * paging, on-demand and delayed loading of texture assets and application controlled level of detail.
 * 
 * Requires {@link GLES31 GLES 3.1}.
 */
public class EXTSparseTexture {

    /**
     * Accepted by the {@code pname} parameter to TexParameter{if}{v}, GetTexParameter{if}v, TexParameterI{u}ivOES, GetTexParameterI{u}ivOES
     * TexParameterI{u}ivEXT, and GetTexParameterI{u}ivEXT.
     */
    public static final int
        GL_TEXTURE_SPARSE_EXT          = 0x91A6,
        GL_VIRTUAL_PAGE_SIZE_INDEX_EXT = 0x91A7;

    /** Accepted by the {@code pname} parameter of GetTexParameter{if}v, GetTexParameterIi{u}vOES, and GetTexParameterIi{u}vEXT. */
    public static final int GL_NUM_SPARSE_LEVELS_EXT = 0x91AA;

    /** Accepted by the {@code pname} parameter to GetInternalformativ. */
    public static final int
        GL_NUM_VIRTUAL_PAGE_SIZES_EXT = 0x91A8,
        GL_VIRTUAL_PAGE_SIZE_X_EXT    = 0x9195,
        GL_VIRTUAL_PAGE_SIZE_Y_EXT    = 0x9196,
        GL_VIRTUAL_PAGE_SIZE_Z_EXT    = 0x9197;

    /** Accepted by the {@code target} parameter to GetInternalformativ. */
    public static final int
        GL_TEXTURE_2D                 = 0xDE1,
        GL_TEXTURE_2D_ARRAY           = 0x8C1A,
        GL_TEXTURE_CUBE_MAP           = 0x8513,
        GL_TEXTURE_CUBE_MAP_ARRAY_OES = 0x9009,
        GL_TEXTURE_3D                 = 0x806F;

    /** Accepted by the {@code pname} parameter to GetIntegerv, GetFloatv, GetInteger64v, and GetBooleanv. */
    public static final int
        GL_MAX_SPARSE_TEXTURE_SIZE_EXT                = 0x9198,
        GL_MAX_SPARSE_3D_TEXTURE_SIZE_EXT             = 0x9199,
        GL_MAX_SPARSE_ARRAY_TEXTURE_LAYERS_EXT        = 0x919A,
        GL_SPARSE_TEXTURE_FULL_ARRAY_CUBE_MIPMAPS_EXT = 0x91A9;

    static { GLES.initialize(); }

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

    static boolean isAvailable(GLESCapabilities caps) {
        return checkFunctions(
            caps.glTexPageCommitmentARB
        );
    }

    // --- [ glTexPageCommitmentARB ] ---

    public static native void glTexPageCommitmentARB(@NativeType("GLenum") int target, @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("GLboolean") boolean commit);

}