org.lwjgl.opengl

Class AMDInterleavedElements

java.lang.Object

org.lwjgl.opengl.AMDInterleavedElements

public class AMDInterleavedElements
extends java.lang.Object

Native bindings to the AMD_interleaved_elements extension.

The glDrawElements function and its variants (instanced and indirect, for example) allow OpenGL to draw indexed arrays of vertices. Since its inception, OpenGL has supported unsigned bytes, unsigned shorts and unsigned integers as index types. However, all enabled vertex arrays may be represented by at most one shared index.

A common scenario in graphics rendering is that several faces share a vertex where, for each face some properties of a vertex (position and texture coordinates, for example) should be common but others must be unique (colors, normals, and so on). Consider a mesh of a cube with per-face normals, for example. There are 8 vertices and 6 normals, and 12 triangles (where each face of the cube is represented as two triangles). To render this cube, we must compute the 24 unique permutations of position and normal and build a new element list to index into it. In fact, any advantage of indexed draw is lost here as the number of required permutations is equal to the final vertex count required to draw the object.

This extension allows OpenGL to process multi-component packed element data. The maximum size of a vertex's index data is not increased, but the facility to store 2 16-bit or 2 or 4 8-bit indices per vertex is introduced. Each vertex attribute is given a swizzle property to allow its index to be sourced from one of up to 4 channels of index data. This effectively allows an application to supply multiple interleaved streams of index data to OpenGL. Each vertex attribute is given a 'channel selector' to select one of the up to 4 channels of vertex index information presented to OpenGL. This enables the use-case described above and many more. The swizzle parameter is also applied to vertex indices passed to shaders, and updates to the definition of base vertex parameters and primitive restart are applied.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_VERTEX_ELEMENT_SWIZZLE_AMD Accepted by the pname parameter of VertexAttribParameteriAMD and GetVertexAttrib{iv|dv|fv|Iiv|Iuiv|Ldv}.
static int	GL_VERTEX_ID_SWIZZLE_AMD Selected by the pname parameter of ProgramParameteri and GetProgramiv.

Method Summary

Modifier and Type	Method and Description
static void	glVertexAttribParameteriAMD(int index, int pname, int param)

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

GL_VERTEX_ELEMENT_SWIZZLE_AMD

public static final int GL_VERTEX_ELEMENT_SWIZZLE_AMD

Accepted by the pname parameter of VertexAttribParameteriAMD and GetVertexAttrib{iv|dv|fv|Iiv|Iuiv|Ldv}.

See Also:

Constant Field Values

GL_VERTEX_ID_SWIZZLE_AMD

public static final int GL_VERTEX_ID_SWIZZLE_AMD

Selected by the pname parameter of ProgramParameteri and GetProgramiv.

See Also:

Constant Field Values

Method Detail

glVertexAttribParameteriAMD

public static void glVertexAttribParameteriAMD(int index,
                                               int pname,
                                               int param)