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 gibt Informationen über ein Vertex-Attribut an einer angegebenen 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 angibt. Mögliche Werte:

gl.VERTEX_ATTRIB_ARRAY_BUFFER_BINDING

Gibt den derzeit gebundenen WebGLBuffer zurück.

gl.VERTEX_ATTRIB_ARRAY_ENABLED

Gibt einen GLboolean zurück, der true ist, wenn das Vertex-Attribut bei 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 aufeinanderfolgend sind.

gl.VERTEX_ATTRIB_ARRAY_TYPE

Gibt einen 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 angegebenen index darstellt.

Wenn ein WebGL 2 Kontext verwendet wird, sind zusätzlich die folgenden Werte verfügbar:

gl.VERTEX_ATTRIB_ARRAY_INTEGER

Gibt einen GLboolean zurück, der angibt, ob ein ganzzahliger Datentyp im Vertex-Attribut-Array am angegebenen index vorliegt.

gl.VERTEX_ATTRIB_ARRAY_DIVISOR

Gibt einen GLint zurück, der den Frequenz-Divisor beschreibt, der für instanzbasiertes Rendering verwendet wird.

Bei Verwendung der ANGLE_instanced_arrays Erweiterung:

ext.VERTEX_ATTRIB_ARRAY_DIVISOR_ANGLE

Gibt einen GLint zurück, der den Frequenz-Divisor beschreibt, der für instanzbasiertes Rendering verwendet wird.

Rückgabewert

Gibt die angeforderten Informationen zum Vertex-Attribut 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

BCD tables only load in the browser

Siehe auch