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

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
getVertexAttrib

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support

Siehe auch