WebGL2RenderingContext: getActiveUniforms()-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.getActiveUniforms() der WebGL 2 API ruft Informationen über aktive Uniforms innerhalb eines WebGLProgram ab.

Syntax

getActiveUniforms(program, uniformIndices, pname)

Parameter

program

Ein WebGLProgram, das die aktiven Uniforms enthält.

uniformIndices

Ein Array von GLuint, das die Indizes der abzufragenden aktiven Uniforms angibt.

pname

Ein GLenum, das angibt, welche Informationen abgerufen werden sollen. Mögliche Werte:

gl.UNIFORM_TYPE: Gibt ein Array von GLenum zurück, das die Typen der Uniforms angibt.
gl.UNIFORM_SIZE: Gibt ein Array von GLuint zurück, das die Größen der Uniforms angibt.
gl.UNIFORM_BLOCK_INDEX: Gibt ein Array von GLint zurück, das die Blockindizes der Uniforms angibt.
gl.UNIFORM_OFFSET: Gibt ein Array von GLint zurück, das die Uniform-Buffer-Offsets angibt.
gl.UNIFORM_ARRAY_STRIDE: Gibt ein Array von GLint zurück, das die Abstände zwischen den Elementen angibt.
gl.UNIFORM_MATRIX_STRIDE: Gibt ein Array von GLint zurück, das die Abstände zwischen den Spalten einer spaltenmajoren oder zeilenmajoren Matrix angibt.
gl.UNIFORM_IS_ROW_MAJOR: Gibt ein Array von GLboolean zurück, das angibt, ob jedes der Uniforms eine zeilenmajore Matrix ist oder nicht.

Rückgabewert

Hängt davon ab, welche Information mit dem Parameter pname angefordert wird.

Beispiele

const uniformIndices = gl.getUniformIndices(program, [
  "UBORed",
  "UBOGreen",
  "UBOBlue",
]);
const uniformOffsets = gl.getActiveUniforms(
  program,
  uniformIndices,
  gl.UNIFORM_OFFSET,
);

Spezifikationen

Specification
WebGL 2.0 Specification # 3.7.16

Browser-Kompatibilität

Siehe auch

WebGL2RenderingContext.getActiveUniformBlockParameter()