WebGL2RenderingContext: getActiveUniformBlockParameter()-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: Diese Funktion ist in Web Workers verfügbar.

Die Methode WebGL2RenderingContext.getActiveUniformBlockParameter() des WebGL 2 API ruft Informationen über einen aktiven Uniform-Block innerhalb eines WebGLProgram ab.

Syntax

js
getActiveUniformBlockParameter(program, uniformBlockIndex, pname)

Parameter

program

Ein WebGLProgram, das den aktiven Uniform-Block enthält.

uniformBlockIndex

Ein GLuint, der den Index des aktiven Uniform-Blocks innerhalb des Programms angibt.

pname

Ein GLenum, der angibt, welche Information abgefragt werden soll. Mögliche Werte:

gl.UNIFORM_BLOCK_BINDING

Gibt einen GLuint zurück, der den Uniform-Puffer-Bindungspunkt angibt.

gl.UNIFORM_BLOCK_DATA_SIZE

Gibt einen GLuint zurück, der die minimale Gesamtgröße des Pufferobjekts angibt.

gl.UNIFORM_BLOCK_ACTIVE_UNIFORMS

Gibt einen GLuint zurück, der die Anzahl der aktiven Uniforms im Uniform-Block angibt.

gl.UNIFORM_BLOCK_ACTIVE_UNIFORM_INDICES

Gibt ein Uint32Array zurück, das die Liste der aktiven Uniforms im Uniform-Block angibt.

gl.UNIFORM_BLOCK_REFERENCED_BY_VERTEX_SHADER

Gibt ein GLboolean zurück, das angibt, ob der Uniform-Block vom Vertex-Shader referenziert wird.

gl.UNIFORM_BLOCK_REFERENCED_BY_FRAGMENT_SHADER

Gibt ein GLboolean zurück, das angibt, ob der Uniform-Block vom Fragment-Shader referenziert wird.

Rückgabewert

Hängt davon ab, welche Information mit dem pname-Parameter angefordert wird. Wenn ein Fehler auftritt, wird null zurückgegeben.

Beispiele

js
const blockSize = gl.getActiveUniformBlockParameter(
  program,
  blockIndex,
  gl.UNIFORM_BLOCK_DATA_SIZE,
);

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.16

Browser-Kompatibilität

Siehe auch