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: Diese Funktion ist in Web Workers verfügbar.
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
WebGLUniformLocationObjekt, 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