WebGL2RenderingContext: vertexAttribIPointer()-Methode
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.
Hinweis: Dieses Feature ist verfügbar in Web Workers.
Die WebGL2RenderingContext.vertexAttribIPointer()
-Methode
der WebGL 2 API legt die ganzzahligen Datenformate
und die Positionen der Vertex-Attribute in einem Vertex-Attribut-Array fest.
Syntax
vertexAttribIPointer(index, size, type, stride, offset)
Parameter
index
-
Ein
GLuint
, der den Index des zu ändernden Vertex-Attributs angibt. size
-
Ein
GLint
, der die Anzahl der Komponenten pro Vertex-Attribut angibt. Muss 1, 2, 3 oder 4 sein. type
-
Ein
GLenum
, der den Datentyp jeder Komponente im Array angibt. Muss einer der folgenden sein:gl.BYTE
,gl.UNSIGNED_BYTE
,gl.SHORT
,gl.UNSIGNED_SHORT
,gl.INT
odergl.UNSIGNED_INT
. stride
-
Ein
GLsizei
, der den Versatz in Bytes zwischen dem Beginn aufeinanderfolgender Vertex-Attribute angibt. offset
-
Ein
GLintptr
, der einen Versatz in Bytes der ersten Komponente im Vertex-Attribut-Array angibt. Muss ein Vielfaches vontype
sein.
Rückgabewert
Keiner (undefined
).
Beschreibung
Sehr ähnlich zu WebGLRenderingContext.vertexAttribPointer()
. Der Hauptunterschied besteht darin, dass Werte, die von vertexAttribPointer
angegeben werden, im Shader immer als Gleitkommawerte interpretiert werden (selbst wenn sie ursprünglich als Ganzzahlen im Puffer angegeben wurden), während diese Methode das Angeben von Werten ermöglicht, die im Shader als Ganzzahlen interpretiert werden.
Beispiele
Lineares Blend-Skinning
//Describe the layout of the buffer:
//1. position
gl.vertexAttribPointer(0, 3, gl.FLOAT, false, 20, 0);
gl.enableVertexAttribArray(0);
//2. bone weights, normalized to [0, 1]
gl.vertexAttribPointer(1, 4, gl.UNSIGNED_BYTE, true, 20, 12);
gl.enableVertexAttribArray(1);
//3. bone indices, interpreted as integer
gl.vertexAttribIPointer(2, 4, gl.UNSIGNED_BYTE, 20, 16);
gl.enableVertexAttribArray(2);
//Connect to attributes from the vertex shader
gl.bindAttribLocation(shaderProgram, 0, "position");
gl.bindAttribLocation(shaderProgram, 1, "boneWeights");
gl.bindAttribLocation(shaderProgram, 2, "boneIndices");
<script id="shader-vs" type="x-shader/x-vertex">
#version 300 es
uniform mat4 mvMatrix;
uniform mat4 bones[120];
in vec3 position;
in vec4 boneWeights;
in uvec4 boneIndices;//read as 4-component unsigned integer
void main() {
vec4 skinnedPosition =
bones[boneIndices.s] * vec4(position, 1.0) * boneWeights.s +
bones[boneIndices.t] * vec4(position, 1.0) * boneWeights.t +
bones[boneIndices.p] * vec4(position, 1.0) * boneWeights.p +
bones[boneIndices.q] * vec4(position, 1.0) * boneWeights.q;
gl_Position = mvMatrix * skinnedPosition;
}
</script>
Spezifikationen
Specification |
---|
WebGL 2.0 Specification # 3.7.8 |
Browser-Kompatibilität
BCD tables only load in the browser