WebGL2RenderingContext: Methode getActiveUniformBlockParameter()

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.getActiveUniformBlockParameter() Methode der 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 zur Angabe des Index des aktiven Uniform-Blocks innerhalb des Programms.

pname

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

gl.UNIFORM_BLOCK_BINDING

Gibt ein GLuint zurück, das den Uniform-Pufferbindungspunkt angibt.

gl.UNIFORM_BLOCK_DATA_SIZE

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

gl.UNIFORM_BLOCK_ACTIVE_UNIFORMS

Gibt ein GLuint zurück, das 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, der angibt, ob der Uniform-Block vom Vertex-Shader referenziert wird.

gl.UNIFORM_BLOCK_REFERENCED_BY_FRAGMENT_SHADER

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

Rückgabewert

Hängt davon ab, welche Information mit dem Parameter pname 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

BCD tables only load in the browser

Siehe auch