WebGLRenderingContext: getVertexAttrib() 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.getVertexAttrib()-Methode der WebGL API liefert Informationen über ein Vertex-Attribut an einer gegebenen Position zurück.

Syntax

js
getVertexAttrib(index, pname)

Parameter

index

Ein GLuint, der den Index des Vertex-Attributs angibt.

pname

Ein GLenum, der die abzufragende Information spezifiziert. Mögliche Werte:

gl.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING

Gibt den aktuell gebundenen WebGLBuffer zurück.

gl.VERTEX_ATTRIB_ARRAY_ENABLED

Gibt einen GLboolean zurück, der true ist, wenn das Vertex-Attribut an diesem index aktiviert ist. Andernfalls false.

gl.VERTEX_ATTRIB_ARRAY_SIZE

Gibt einen GLint zurück, der die Größe eines Elements des Vertex-Arrays angibt.

gl.VERTEX_ATTRIB_ARRAY_STRIDE

Gibt einen GLint zurück, der die Anzahl der Bytes zwischen aufeinanderfolgenden Elementen im Array angibt. 0 bedeutet, dass die Elemente fortlaufend sind.

gl.VERTEX_ATTRIB_ARRAY_TYPE

Gibt ein GLenum zurück, der den Array-Typ repräsentiert. Einer von

  • gl.BYTE
  • gl.UNSIGNED_BYTE
  • gl.SHORT
  • gl.UNSIGNED_SHORT
  • gl.FLOAT
gl.VERTEX_ATTRIB_ARRAY_NORMALIZED

Gibt einen GLboolean zurück, der true ist, wenn Festkomma-Datentypen für das Vertex-Attribut-Array am angegebenen index normalisiert sind.

gl.CURRENT_VERTEX_ATTRIB

Gibt ein Float32Array (mit 4 Elementen) zurück, das den aktuellen Wert des Vertex-Attributs am gegebenen index darstellt.

Bei Verwendung eines WebGL 2-Kontexts, sind zusätzlich folgende Werte verfügbar:

gl.VERTEX_ATTRIB_ARRAY_INTEGER

Gibt einen GLboolean zurück, der angibt, ob ein Ganzzahldatentyp im Vertex-Attribut-Array am angegebenen index vorhanden ist.

gl.VERTEX_ATTRIB_ARRAY_DIVISOR

Gibt einen GLint zurück, der den Frequenzteiler beschreibt, der für das instanzierte Rendering verwendet wird.

Bei Verwendung der ANGLE_instanced_arrays Erweiterung:

ext.VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE

Gibt einen GLint zurück, der den Frequenzteiler beschreibt, der für das instanzierte Rendering verwendet wird.

Rückgabewert

Gibt die angeforderten Vertex-Attribut-Informationen zurück (wie mit pname angegeben).

Beispiele

js
gl.getVertexAttrib(0, gl.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING);

Spezifikationen

Specification
WebGL Specification
# 5.14.10
WebGL 2.0 Specification
# 3.7.8

Browser-Kompatibilität

Siehe auch