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: Dieses Feature ist verfügbar in Web Workers.

Die WebGL2RenderingContext.getActiveUniforms() Methode des WebGL 2 API ruft Informationen über aktive Uniformen innerhalb eines WebGLProgram ab.

Syntax

getActiveUniforms(program, uniformIndices, pname)

Parameter

program

Ein WebGLProgram, das die aktiven Uniformen enthält.

uniformIndices

Ein Array von GLuint, das die Indizes der zu abfragenden aktiven Uniformen angibt.

pname

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

gl.UNIFORM_TYPE: Gibt ein Array von GLenum zurück, das die Typen der Uniformen angibt.
gl.UNIFORM_SIZE: Gibt ein Array von GLuint zurück, das die Größen der Uniformen angibt.
gl.UNIFORM_BLOCK_INDEX: Gibt ein Array von GLint zurück, das die Blockindizes der Uniformen 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 jede der Uniformen eine zeilenmajore Matrix ist oder nicht.

Rückgabewert

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

BCD tables only load in the browser

Siehe auch

WebGL2RenderingContext.getActiveUniformBlockParameter()