Package org.lwjgl.opengl

Class ARBVertexAttrib64Bit

java.lang.Object

org.lwjgl.opengl.ARBVertexAttrib64Bit

public class ARBVertexAttrib64Bit
extends java.lang.Object

Native bindings to the ARB_vertex_attrib_64bit extension.

This extension provides OpenGL shading language support for vertex shader inputs with 64-bit floating-point components and OpenGL API support for specifying the value of those inputs using vertex array or immediate mode entry points. This builds on the support for general-purpose support for 64-bit floating-point values in the ARB_gpu_shader_fp64 extension.

This extension provides a new class of vertex attribute functions, beginning with "VertexAttribL" ("L" for "long"), that can be used to specify attributes with 64-bit floating-point components. This extension provides no automatic type conversion between attribute and shader variables; single-precision attributes are not automatically converted to double-precision or vice versa. For shader variables with 64-bit component types, the "VertexAttribL" functions must be used to specify attribute values. For other shader variables, the "VertexAttribL" functions must not be used. If a vertex attribute is specified using the wrong attribute function, the values of the corresponding shader input are undefined. This approach requiring matching types is identical to that used for the "VertexAttribI" functions provided by OpenGL 3.0 and the EXT_gpu_shader4 extension.

Additionally, some vertex shader inputs using the wider 64-bit components may count double against the implementation-dependent limit on the number of vertex shader attribute vectors. A 64-bit scalar or a two-component vector consumes only a single generic vertex attribute; three- and four-component "long" may count as two. This approach is similar to the one used in the current GL where matrix attributes consume multiple attributes.

Note that 64-bit generic vertex attributes were nominally supported beginning with the introduction of vertex shaders in OpenGL 2.0. However, the OpenGL Shading Language at the time had no support for 64-bit data types, so any such values were automatically converted to 32-bit.

Support for 64-bit floating-point vertex attributes in this extension can be combined with other extensions. In particular, this extension provides an entry point that can be used with EXT_direct_state_access to directly set state for any vertex array object. Also, the related NV_vertex_attrib_integer_64bit extension provides an entry point to specify bindless vertex attribute arrays with 64-bit components, integer or floating-point.

Requires OpenGL 3.0, GLSL 1.30 and ARB_gpu_shader_fp64. Promoted to core in OpenGL 4.1.

Field Summary

Fields

Modifier and Type	Field and Description
static int	GL_DOUBLE_MAT2 GL_DOUBLE_MAT2x3 GL_DOUBLE_MAT2x4 GL_DOUBLE_MAT3 GL_DOUBLE_MAT3x2 GL_DOUBLE_MAT3x4 GL_DOUBLE_MAT4 GL_DOUBLE_MAT4x2 GL_DOUBLE_MAT4x3 GL_DOUBLE_VEC2 GL_DOUBLE_VEC3 GL_DOUBLE_VEC4 Returned in the type parameter of GetActiveAttrib.

Method Summary

Modifier and Type	Method and Description
static void	glGetVertexAttribLdv(int index, int pname, double[] params) Array version of: GetVertexAttribLdv
static void	glGetVertexAttribLdv(int index, int pname, java.nio.DoubleBuffer params) Double version of GetVertexAttribiv.
static void	glVertexArrayVertexAttribLOffsetEXT(int vaobj, int buffer, int index, int size, int type, int stride, long offset) DSA version of VertexAttribLPointer.
static void	glVertexAttribL1d(int index, double x) Specifies the value of a generic vertex attribute.
static void	glVertexAttribL1dv(int index, double[] v) Array version of: VertexAttribL1dv
static void	glVertexAttribL1dv(int index, java.nio.DoubleBuffer v) Pointer version of VertexAttribL1d.
static void	glVertexAttribL2d(int index, double x, double y) Specifies the value of a generic vertex attribute.
static void	glVertexAttribL2dv(int index, double[] v) Array version of: VertexAttribL2dv
static void	glVertexAttribL2dv(int index, java.nio.DoubleBuffer v) Pointer version of VertexAttribL2d.
static void	glVertexAttribL3d(int index, double x, double y, double z) Specifies the value of a generic vertex attribute.
static void	glVertexAttribL3dv(int index, double[] v) Array version of: VertexAttribL3dv
static void	glVertexAttribL3dv(int index, java.nio.DoubleBuffer v) Pointer version of VertexAttribL3d.
static void	glVertexAttribL4d(int index, double x, double y, double z, double w) Specifies the value of a generic vertex attribute.
static void	glVertexAttribL4dv(int index, double[] v) Array version of: VertexAttribL4dv
static void	glVertexAttribL4dv(int index, java.nio.DoubleBuffer v) Pointer version of VertexAttribL4d.
static void	glVertexAttribLPointer(int index, int size, int stride, java.nio.DoubleBuffer pointer) Specifies the location and organization of a 64-bit vertex attribute array.
static void	glVertexAttribLPointer(int index, int size, int type, int stride, java.nio.ByteBuffer pointer) Specifies the location and organization of a 64-bit vertex attribute array.
static void	glVertexAttribLPointer(int index, int size, int type, int stride, long pointer) Specifies the location and organization of a 64-bit vertex attribute array.

Methods inherited from class java.lang.Object

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

Field Detail

GL_DOUBLE_VEC2, GL_DOUBLE_VEC3, GL_DOUBLE_VEC4, GL_DOUBLE_MAT2, GL_DOUBLE_MAT3, GL_DOUBLE_MAT4, GL_DOUBLE_MAT2x3, GL_DOUBLE_MAT2x4, GL_DOUBLE_MAT3x2, GL_DOUBLE_MAT3x4, GL_DOUBLE_MAT4x2, GL_DOUBLE_MAT4x3

Returned in the type parameter of GetActiveAttrib.

Method Detail

glVertexAttribL1d

public static void glVertexAttribL1d(int index,
                                     double x)

Specifies the value of a generic vertex attribute. The y and z components are implicitly set to 0.0 and w to 1.0.

Parameters:

index - the index of the generic vertex attribute to be modified

x - the vertex attribute x component

glVertexAttribL2d

public static void glVertexAttribL2d(int index,
                                     double x,
                                     double y)

Specifies the value of a generic vertex attribute. The y component is implicitly set to 0.0 and w to 1.0.

Parameters:

index - the index of the generic vertex attribute to be modified

x - the vertex attribute x component

y - the vertex attribute y component

glVertexAttribL3d

public static void glVertexAttribL3d(int index,
                                     double x,
                                     double y,
                                     double z)

Specifies the value of a generic vertex attribute. The w is implicitly set to 1.0.

Parameters:

index - the index of the generic vertex attribute to be modified

x - the vertex attribute x component

y - the vertex attribute y component

z - the vertex attribute z component

glVertexAttribL4d

public static void glVertexAttribL4d(int index,
                                     double x,
                                     double y,
                                     double z,
                                     double w)

Specifies the value of a generic vertex attribute.

Parameters:

index - the index of the generic vertex attribute to be modified

x - the vertex attribute x component

y - the vertex attribute y component

z - the vertex attribute z component

w - the vertex attribute w component

glVertexAttribL1dv

public static void glVertexAttribL1dv(int index,
                                      java.nio.DoubleBuffer v)

Pointer version of VertexAttribL1d.

Parameters:

index - the index of the generic vertex attribute to be modified

v - the vertex attribute buffer

glVertexAttribL2dv

public static void glVertexAttribL2dv(int index,
                                      java.nio.DoubleBuffer v)

Pointer version of VertexAttribL2d.

Parameters:

index - the index of the generic vertex attribute to be modified

v - the vertex attribute buffer

glVertexAttribL3dv

public static void glVertexAttribL3dv(int index,
                                      java.nio.DoubleBuffer v)

Pointer version of VertexAttribL3d.

Parameters:

index - the index of the generic vertex attribute to be modified

v - the vertex attribute buffer

glVertexAttribL4dv

public static void glVertexAttribL4dv(int index,
                                      java.nio.DoubleBuffer v)

Pointer version of VertexAttribL4d.

Parameters:

index - the index of the generic vertex attribute to be modified

v - the vertex attribute buffer

glVertexAttribLPointer

public static void glVertexAttribLPointer(int index,
                                          int size,
                                          int type,
                                          int stride,
                                          java.nio.ByteBuffer pointer)

public static void glVertexAttribLPointer(int index,
                                          int size,
                                          int type,
                                          int stride,
                                          long pointer)

Specifies the location and organization of a 64-bit vertex attribute array.

Parameters:

index - the index of the generic vertex attribute to be modified

size - the number of values per vertex that are stored in the array. The initial value is 4. One of:

1

2

3

4

BGRA

type - the data type of each component in the array. Must be:

DOUBLE

stride - the byte offset between consecutive generic vertex attributes. If stride is 0, the generic vertex attributes are understood to be tightly packed in the array. The initial value is 0.

pointer - the vertex attribute data or the offset of the first component of the first generic vertex attribute in the array in the data store of the buffer currently bound to the ARRAY_BUFFER target. The initial value is 0.

glVertexAttribLPointer

public static void glVertexAttribLPointer(int index,
                                          int size,
                                          int stride,
                                          java.nio.DoubleBuffer pointer)

Specifies the location and organization of a 64-bit vertex attribute array.

Parameters:

index - the index of the generic vertex attribute to be modified

size - the number of values per vertex that are stored in the array. The initial value is 4. One of:

1

2

3

4

BGRA

stride - the byte offset between consecutive generic vertex attributes. If stride is 0, the generic vertex attributes are understood to be tightly packed in the array. The initial value is 0.

pointer - the vertex attribute data or the offset of the first component of the first generic vertex attribute in the array in the data store of the buffer currently bound to the ARRAY_BUFFER target. The initial value is 0.

glGetVertexAttribLdv

public static void glGetVertexAttribLdv(int index,
                                        int pname,
                                        java.nio.DoubleBuffer params)

Double version of GetVertexAttribiv.

Parameters:

index - the generic vertex attribute parameter to be queried

pname - the symbolic name of the vertex attribute parameter to be queried

params - the requested data

glVertexArrayVertexAttribLOffsetEXT

public static void glVertexArrayVertexAttribLOffsetEXT(int vaobj,
                                                       int buffer,
                                                       int index,
                                                       int size,
                                                       int type,
                                                       int stride,
                                                       long offset)

DSA version of VertexAttribLPointer.

Parameters:

vaobj - the vertex array object

buffer - the buffer object

index - the index of the generic vertex attribute to be modified

size - the number of values per vertex that are stored in the array. The initial value is 4. One of:

1

2

3

4

BGRA

type - the data type of each component in the array. Must be:

DOUBLE

stride - the byte offset between consecutive generic vertex attributes. If stride is 0, the generic vertex attributes are understood to be tightly packed in the array. The initial value is 0.

offset - the offset of the first component of the first generic vertex attribute in the array in the data store of the buffer. The initial value is 0.

glVertexAttribL1dv

public static void glVertexAttribL1dv(int index,
                                      double[] v)

Array version of: VertexAttribL1dv

glVertexAttribL2dv

public static void glVertexAttribL2dv(int index,
                                      double[] v)

Array version of: VertexAttribL2dv

glVertexAttribL3dv

public static void glVertexAttribL3dv(int index,
                                      double[] v)

Array version of: VertexAttribL3dv

glVertexAttribL4dv

public static void glVertexAttribL4dv(int index,
                                      double[] v)

Array version of: VertexAttribL4dv

glGetVertexAttribLdv

public static void glGetVertexAttribLdv(int index,
                                        int pname,
                                        double[] params)

Array version of: GetVertexAttribLdv