WebGLRenderingContext: vertexAttrib[1234]f[v]() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGLRenderingContext.vertexAttrib[1234]f[v]() Methoden der WebGL API spezifizieren konstante Werte für generische Vertex-Attribute.

Syntax

vertexAttrib1f(index, v0)
vertexAttrib2f(index, v0, v1)
vertexAttrib3f(index, v0, v1, v2)
vertexAttrib4f(index, v0, v1, v2, v3)

vertexAttrib1fv(index, value)
vertexAttrib2fv(index, value)
vertexAttrib3fv(index, value)
vertexAttrib4fv(index, value)

Parameter

index: Ein GLuint, das die Position des zu ändernden Vertex-Attributs angibt.
v0, v1, v2, v3: Ein Gleitkomma-Number für den Vertex-Attributwert.
value: Ein Float32Array für Gleitkomma-Vektor-Vertex-Attributwerte.

Während Vertex-Attribute normalerweise verwendet werden, um Werte zu spezifizieren, die für jedes Vertex unterschiedlich sind (unter Verwendung von vertexAttribPointer), kann es nützlich sein, einen konstanten Wert zu spezifizieren. Beispielsweise, wenn Sie einen Shader haben, der ein color Vertex-Attribut hat, aber alles in einer einzigen Farbe zeichnen möchten, können Sie vertexAttrib verwenden, um dies zu erreichen, ohne einen Puffer zu erstellen, der nur mit einem Wert gefüllt ist, oder einen separaten Shader zu erstellen, der ein Uniform für die Farbe verwendet.

Dieser Wert wird verwendet, wenn ein gebundener Array-Puffer nicht mit enableVertexAttribArray aktiviert wurde.

Attribute können Matrizen sein, in diesem Fall müssen die Spalten der Matrix in aufeinanderfolgenden Vertex-Attribut-Slots geladen werden.

Die mit vertexAttrib gesetzten Werte sind kontextübergreifend; das heißt, sie sind nicht Teil des Shader-Zustands (wie generische Vertex-Attribut-Indizes zu Shader-Variablenbindungen) und nicht Teil des Vertex-Array-Objektzustands (wie aktivierte Vertex-Attribut-Arrays). Die einzige Möglichkeit, die Werte zu ändern, besteht darin, diese Funktion erneut aufzurufen.

Beispiele

const a_foobar = gl.getAttribLocation(shaderProgram, "foobar");
// Either set each component individually:
gl.vertexAttrib3f(a_foobar, 10.0, 5.0, 2.0);
// Or provide a Float32Array:
const floatArray = new Float32Array([10.0, 5.0, 2.0]);
gl.vertexAttrib3fv(a_foobar, floatArray);

// We want to load the following 3x3 matrix into attribute named "matrix3x3"
// 0 1 2
// 3 4 5
// 6 7 8
const matrix3x3Location = gl.getAttribLocation(shaderProgram, "matrix3x3");
gl.vertexAttrib3f(matrix3x3Location, 0, 3, 6);
gl.vertexAttrib3f(matrix3x3Location + 1, 1, 4, 7);
gl.vertexAttrib3f(matrix3x3Location + 2, 2, 5, 8);

Spezifikationen

Specification
WebGL Specification # 5.14.10

Browser-Kompatibilität

Siehe auch

WebGLRenderingContext.getVertexAttrib()