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

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

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

WebGL2RenderingContext.getActiveUniforms()