WebGLRenderingContext: uniform[1234][fi][v]() Methode
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die WebGLRenderingContext.uniform[1234][fi][v]() Methoden
der WebGL API legen Werte für Uniform-Variablen fest. Alle aktiven Uniform-Variablen, die in einem Programmobjekt definiert sind, werden auf 0 initialisiert,
wenn das Programmobjekt erfolgreich verlinkt wird. Sie behalten die durch einen Aufruf dieser Methode zugewiesenen Werte, bis die nächste erfolgreiche Link-Operation auf dem Programmobjekt erfolgt, bei der sie erneut auf 0 initialisiert werden.
Hinweis:
Viele der hier beschriebenen Funktionen haben erweiterte Schnittstellen in WebGL 2, die unter
WebGL2RenderingContext.uniform[1234][uif][v]() zu finden sind.
Syntax
uniform1f(location, v0)
uniform1fv(location, value)
uniform1i(location, v0)
uniform1iv(location, value)
uniform2f(location, v0, v1)
uniform2fv(location, value)
uniform2i(location, v0, v1)
uniform2iv(location, value)
uniform3f(location, v0, v1, v2)
uniform3fv(location, value)
uniform3i(location, v0, v1, v2)
uniform3iv(location, value)
uniform4f(location, v0, v1, v2, v3)
uniform4fv(location, value)
uniform4i(location, v0, v1, v2, v3)
uniform4iv(location, value)
Parameter
location-
Ein
WebGLUniformLocationObjekt, das den Ort des zu ändernden Uniform-Attributs enthält. value,v0,v1,v2,v3-
Ein neuer Wert, der für die Uniform-Variable verwendet werden soll. Mögliche Typen:
- Eine Fließkommazahl (
Number) für Fließkommawerte (Methoden mit "f"). - Eine Folge von Fließkommazahlen (z. B. ein
Float32Arrayoder einArrayvon Zahlen) für Fließkomma-Vektormethoden (Methoden mit "fv"). - Eine Ganzzahl (
Number) für Ganzzahlwerte (Methoden mit "i"). - Ein
Int32Arrayfür Ganzzahl-Vektormethoden (Methoden mit "iv").
- Eine Fließkommazahl (
Rückgabewert
Keiner (undefined).
Beispiele
gl.uniform1f(u_alpha, 0.8);
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification # 5.14.10 |