org.lwjgl.opengles.EXTBufferStorage 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 java.nio.*;

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

/**
 * Native bindings to the EXT_buffer_storage extension.
 * 
 * OpenGL ES has long supported buffer objects as a means of storing data that may be used to source vertex attributes, pixel data for textures, uniforms
 * and other elements. In un-extended ES, buffer data stores are mutable - that is, they may be de-allocated or resized while they are in use. The
 * GL_EXT_texture_storage extension added immutable storage for texture objects (and was subsequently incorporated into OpenGL ES 3.0). This extension
 * further applies the concept of immutable storage to buffer objects. If an implementation is aware of a buffer's immutability, it may be able to make
 * certain assumptions or apply particular optimizations in order to increase performance or reliability.
 * 
 * Furthermore, this extension allows applications to pass additional information about a requested allocation to the implementation which it may use to
 * select memory heaps, caching behavior or allocation strategies.
 * 
 * Finally, this extension introduces the concept of persistent client mappings of buffer objects, which allow clients to retain pointers to a buffer's
 * data store returned as the result of a mapping, and to issue drawing commands while those mappings are in place.
 * 
 * Requires {@link GLES31 GLES 3.1}.
 */
public class EXTBufferStorage {

    /** Accepted in the {@code flags} parameter of BufferStorageEXT and NamedBufferStorageEXT. */
    public static final int
        GL_MAP_PERSISTENT_BIT_EXT  = 0x40,
        GL_MAP_COHERENT_BIT_EXT    = 0x80,
        GL_DYNAMIC_STORAGE_BIT_EXT = 0x100,
        GL_CLIENT_STORAGE_BIT_EXT  = 0x200;

    /** MAP_PERSISTENT_BIT_EXT 0x0040 (as above) MAP_COHERENT_BIT_EXT 0x0080 (as above) Accepted by the {@code pname} parameter of GetBufferParameter{i|i64}v. */
    public static final int
        GL_BUFFER_IMMUTABLE_STORAGE_EXT = 0x821F,
        GL_BUFFER_STORAGE_FLAGS_EXT     = 0x8220;

    /** Accepted by the {@code barriers} parameter of MemoryBarrier. */
    public static final int GL_CLIENT_MAPPED_BUFFER_BARRIER_BIT_EXT = 0x4000;

    static { GLES.initialize(); }

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

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

    // --- [ glBufferStorageEXT ] ---

    public static native void nglBufferStorageEXT(int target, long size, long data, int flags);

    public static void glBufferStorageEXT(int target, long size, int flags) {
        nglBufferStorageEXT(target, size, NULL, flags);
    }

    public static void glBufferStorageEXT(int target, ByteBuffer data, int flags) {
        nglBufferStorageEXT(target, data.remaining(), memAddress(data), flags);
    }

    public static void glBufferStorageEXT(int target, ShortBuffer data, int flags) {
        nglBufferStorageEXT(target, data.remaining() << 1, memAddress(data), flags);
    }

    public static void glBufferStorageEXT(int target, IntBuffer data, int flags) {
        nglBufferStorageEXT(target, data.remaining() << 2, memAddress(data), flags);
    }

    public static void glBufferStorageEXT(int target, FloatBuffer data, int flags) {
        nglBufferStorageEXT(target, data.remaining() << 2, memAddress(data), flags);
    }

    /** Array version of: {@link #glBufferStorageEXT BufferStorageEXT} */
    public static void glBufferStorageEXT(int target, short[] data, int flags) {
        long __functionAddress = GLES.getICD().glBufferStorageEXT;
        if (CHECKS) {
            check(__functionAddress);
        }
        callPPV(__functionAddress, target, (long)(data.length << 1), data, flags);
    }

    /** Array version of: {@link #glBufferStorageEXT BufferStorageEXT} */
    public static void glBufferStorageEXT(int target, int[] data, int flags) {
        long __functionAddress = GLES.getICD().glBufferStorageEXT;
        if (CHECKS) {
            check(__functionAddress);
        }
        callPPV(__functionAddress, target, (long)(data.length << 2), data, flags);
    }

    /** Array version of: {@link #glBufferStorageEXT BufferStorageEXT} */
    public static void glBufferStorageEXT(int target, float[] data, int flags) {
        long __functionAddress = GLES.getICD().glBufferStorageEXT;
        if (CHECKS) {
            check(__functionAddress);
        }
        callPPV(__functionAddress, target, (long)(data.length << 2), data, flags);
    }

}