com.badlogic.gdx.graphics

Class VertexAttribute

java.lang.Object

com.badlogic.gdx.graphics.VertexAttribute

public final class VertexAttribute
extends Object

A single vertex attribute defined by its VertexAttributes.Usage, its number of components and its shader alias. The Usage is needed for the fixed function pipeline of OpenGL ES 1.x. Generic attributes are not supported in the fixed function pipeline. The number of components defines how many components the attribute has. The alias defines to which shader attribute this attribute should bind. The alias is used by a Mesh when drawing with a ShaderProgram. The alias can be changed at any time.

Author:

mzechner

Field Summary

Fields

Modifier and Type	Field and Description
String	alias the alias for the attribute used in a ShaderProgram
boolean	normalized whether the values are normalized to either -1f and +1f (signed) or 0f and +1f (unsigned)
int	numComponents the number of components this attribute has
int	offset the offset of this attribute in bytes, don't change this!
int	type the OpenGL type of each component, e.g.
int	unit optional unit/index specifier, used for texture coordinates and bone weights
int	usage the attribute VertexAttributes.Usage

Constructor Summary

Constructors

Constructor and Description
VertexAttribute(int usage, int numComponents, String alias) Constructs a new VertexAttribute.
VertexAttribute(int usage, int numComponents, String alias, int index) Constructs a new VertexAttribute.

Method Summary

Methods

Modifier and Type	Method and Description
static VertexAttribute	Binormal()
static VertexAttribute	BoneWeight(int unit)
static VertexAttribute	Color() Deprecated. use ColorPacked()
static VertexAttribute	ColorPacked()
static VertexAttribute	ColorUnpacked()
boolean	equals(Object obj) Tests to determine if the passed object was created with the same parameters
boolean	equals(VertexAttribute other)
int	getKey()
int	hashCode()
static VertexAttribute	Normal()
static VertexAttribute	Position()
static VertexAttribute	Tangent()
static VertexAttribute	TexCoords(int unit)

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Field Detail

usage

public final int usage

the attribute VertexAttributes.Usage

numComponents

public final int numComponents

the number of components this attribute has

normalized

public final boolean normalized

whether the values are normalized to either -1f and +1f (signed) or 0f and +1f (unsigned)

type

public final int type

the OpenGL type of each component, e.g. GL20.GL_FLOAT or GL20.GL_UNSIGNED_BYTE

offset

public int offset

the offset of this attribute in bytes, don't change this!

alias

public String alias

the alias for the attribute used in a ShaderProgram

unit

public int unit

optional unit/index specifier, used for texture coordinates and bone weights

Constructor Detail

VertexAttribute

public VertexAttribute(int usage,
               int numComponents,
               String alias)

Constructs a new VertexAttribute.

Parameters:

usage - the usage, used for the fixed function pipeline. Generic attributes are not supported in the fixed function pipeline.

numComponents - the number of components of this attribute, must be between 1 and 4.

alias - the alias used in a shader for this attribute. Can be changed after construction.

VertexAttribute

public VertexAttribute(int usage,
               int numComponents,
               String alias,
               int index)

Constructs a new VertexAttribute.

Parameters:

usage - the usage, used for the fixed function pipeline. Generic attributes are not supported in the fixed function pipeline.

numComponents - the number of components of this attribute, must be between 1 and 4.

alias - the alias used in a shader for this attribute. Can be changed after construction.

index - unit/index of the attribute, used for boneweights and texture coordinates.

Method Detail

Position

public static VertexAttribute Position()

TexCoords

public static VertexAttribute TexCoords(int unit)

Normal

public static VertexAttribute Normal()

Color

@Deprecated
public static VertexAttribute Color()

Deprecated. use ColorPacked()

ColorPacked

public static VertexAttribute ColorPacked()

ColorUnpacked

public static VertexAttribute ColorUnpacked()

Tangent

public static VertexAttribute Tangent()

Binormal

public static VertexAttribute Binormal()

BoneWeight

public static VertexAttribute BoneWeight(int unit)

equals

public boolean equals(Object obj)

Tests to determine if the passed object was created with the same parameters

Overrides:

equals in class Object

equals

public boolean equals(VertexAttribute other)

getKey

public int getKey()

Returns:

A unique number specifying the usage index (3 MSB) and unit (1 LSB).

hashCode

public int hashCode()

Overrides:

hashCode in class Object