WebGLRenderingContext: Methode getUniform()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Hinweis: Dieses Feature ist verfügbar in Web Workers.

Die WebGLRenderingContext.getUniform() Methode der WebGL API gibt den Wert einer Uniform-Variable an einer gegebenen Position zurück.

Syntax

js
getUniform(program, location)

Parameter

program

Ein WebGLProgram, das das Uniform-Attribut enthält.

location

Ein WebGLUniformLocation Objekt, das die Position des zu holenden Uniform-Attributs enthält.

Rückgabewert

Der zurückgegebene Typ hängt vom Uniform-Typ ab:

Uniform-Typ Zurückgegebener Typ
Nur WebGL 1
boolean [`GLBoolean`](/de/docs/Web/API/WebGL_API/Types)
int [`GLint`](/de/docs/Web/API/WebGL_API/Types)
float [`GLfloat`](/de/docs/Web/API/WebGL_API/Types)
vec2 Float32Array (mit 2 Elementen)
ivec2 Int32Array (mit 2 Elementen)
bvec2 Array von [`GLBoolean`](/de/docs/Web/API/WebGL_API/Types) (mit 2 Elementen)
vec3 Float32Array (mit 3 Elementen)
ivec3 Int32Array (mit 3 Elementen)
bvec3 Array von [`GLBoolean`](/de/docs/Web/API/WebGL_API/Types) (mit 3 Elementen)
vec4 Float32Array (mit 4 Elementen)
ivec4 Int32Array (mit 4 Elementen)
bvec4 Array von [`GLBoolean`](/de/docs/Web/API/WebGL_API/Types) (mit 4 Elementen)
mat2 Float32Array (mit 4 Elementen)
mat3 Float32Array (mit 9 Elementen)
mat4 Float32Array (mit 16 Elementen)
sampler2D [`GLint`](/de/docs/Web/API/WebGL_API/Types)
samplerCube [`GLint`](/de/docs/Web/API/WebGL_API/Types)
Zusätzlich verfügbar in WebGL 2
uint [`GLuint`](/de/docs/Web/API/WebGL_API/Types)
uvec2 Uint32Array (mit 2 Elementen)
uvec3 Uint32Array (mit 3 Elementen)
uvec4 Uint32Array (mit 4 Elementen)
mat2x3 Float32Array (mit 6 Elementen)
mat2x4 Float32Array (mit 8 Elementen)
mat3x2 Float32Array (mit 6 Elementen)
mat3x4 Float32Array (mit 12 Elementen)
mat4x2 Float32Array (mit 8 Elementen)
mat4x3 Float32Array (mit 12 Elementen)
Jeder Sampler-Typ [`GLint`](/de/docs/Web/API/WebGL_API/Types)

Beispiele

js
const loc = gl.getUniformLocation(program, "u_foobar");
gl.getUniform(program, loc);

Spezifikationen

Specification
WebGL Specification
# 5.14.10
WebGL 2.0 Specification
# 3.7.8

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch