WebGLRenderingContext: Methode uniformMatrix[234]fv()
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.uniformMatrix[234]fv() der WebGL API legen Matrixwerte für Uniform-Variablen fest.
Die drei Versionen dieser Methode (uniformMatrix2fv(), uniformMatrix3fv() und uniformMatrix4fv()) erwarten als Eingabewerte quadratische Matrizen mit 2, 3 beziehungsweise 4 Komponenten pro Dimension. Diese müssen 4, 9 beziehungsweise 16 Gleitkommawerte enthalten.
Syntax
uniformMatrix2fv(location, transpose, value)
uniformMatrix3fv(location, transpose, value)
uniformMatrix4fv(location, transpose, value)
Parameter
location-
Ein
WebGLUniformLocation-Objekt, das die Position der zu ändernden Uniform-Variable enthält, odernull, um die Aktualisierung der Uniform-Variable ohne Fehlermeldung zu ignorieren. Die Position wird mitgetUniformLocation()ermittelt. transpose-
Ein
GLboolean, der angibt, ob die Matrix transponiert werden soll. Mussfalsesein. value-
Ein
Float32Arrayoder eine Folge vonGLfloat-Werten. Es wird angenommen, dass die Werte in spaltenweiser Reihenfolge vorliegen.
Rückgabewert
Keiner (undefined).
Beispiele
gl.uniformMatrix2fv(loc, false, [2, 1, 2, 2]);
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification> # 5.14.10> |
Browser-Kompatibilität
Siehe auch
WebGLRenderingContext.uniform()WebGL2RenderingContext.uniformMatrix()– WebGL-2-Versionen dieser Methoden.