WebGLRenderingContext: Methode uniform[1234][fi][v]()
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 Methoden WebGLRenderingContext.uniform[1234][fi][v]() der WebGL API legen die Werte von uniform-Variablen fest. Alle aktiven uniform-Variablen, die in einem Programmobjekt definiert sind, werden auf 0 initialisiert, wenn das Programmobjekt erfolgreich verknüpft wird. Die zugewiesenen Werte bleiben bis zur nächsten erfolgreichen Verknüpfung des Programmobjekts erhalten. Dann werden die Variablen erneut auf 0 initialisiert.
Hinweis:
Viele der hier beschriebenen Funktionen haben erweiterte WebGL-2-Schnittstellen. Diese finden Sie unter WebGL2RenderingContext.uniform[1234][uif][v]().
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
WebGLUniformLocation-Objekt, das die Position des zu ändernden uniform-Attributs enthält, odernull, um die Aktualisierung der uniform-Variablen ohne Fehlermeldung zu ignorieren. value,v0,v1,v2,v3-
Ein neuer Wert für die uniform-Variable. Mögliche Typen:
- Ein
Number-Wert mit Gleitkommazahl für Gleitkommawerte (Methoden mit „f“). - Eine Folge von Gleitkommazahlen (beispielsweise ein
Float32Arrayoder einArraymit Zahlen) für Gleitkomma-Vektormethoden (Methoden mit „fv“). - Ein ganzzahliger
Number-Wert für Ganzzahlwerte (Methoden mit „i“). - Ein
Int32Arrayfür Ganzzahl-Vektormethoden (Methoden mit „iv“).
- Ein
Rückgabewert
Keiner (undefined).
Beispiele
gl.uniform1f(u_alpha, 0.8);
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification> # 5.14.10> |