org.lwjgl.opengl.EXTCompiledVertexArray Maven / Gradle / Ivy

Show more of this group Show more artifacts with this name
Show all versions of lwjgl-opengl Show documentation

The most widely adopted 2D and 3D graphics API in the industry, bringing thousands of applications to a wide variety of computer platforms.

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.opengl;

import org.lwjgl.system.*;

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

/**
 * Native bindings to the EXT_compiled_vertex_array extension.
 * 
 * This extension defines an interface which allows static vertex array data to be cached or pre-compiled for more efficient rendering. This is useful for
 * implementations which can cache the transformed results of array data for reuse by several DrawArrays, ArrayElement, or DrawElements commands. It is
 * also useful for implementations which can transfer array data to fast memory for more efficient processing.
 * 
 * For example, rendering an M by N mesh of quadrilaterals can be accomplished by setting up vertex arrays containing all of the vertexes in the mesh and
 * issuing M DrawElements commands each of which operate on 2 * N vertexes. Each DrawElements command after the first will share N vertexes with the
 * preceding DrawElements command. If the vertex array data is locked while the DrawElements commands are executed, then OpenGL may be able to transform
 * each of these shared vertexes just once.
 */
public class EXTCompiledVertexArray {

    /** Accepted by the {@code pname} parameter of GetBooleanv, GetIntegerv, GetFloatv, and GetDoublev. */
    public static final int
        GL_ARRAY_ELEMENT_LOCK_FIRST_EXT = 0x81A8,
        GL_ARRAY_ELEMENT_LOCK_COUNT_EXT = 0x81A9;

    static { GL.initialize(); }

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

    static boolean isAvailable(GLCapabilities caps) {
        return checkFunctions(
            caps.glLockArraysEXT, caps.glUnlockArraysEXT
        );
    }

    // --- [ glLockArraysEXT ] ---

    public static native void glLockArraysEXT(@NativeType("GLint") int first, @NativeType("GLsizei") int count);

    // --- [ glUnlockArraysEXT ] ---

    public static native void glUnlockArraysEXT();

}