WebGL2RenderingContext: Methode uniform[1234][uif][v]()
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2021 browserübergreifend verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methoden WebGL2RenderingContext.uniform[1234][uif][v]() der WebGL-API legen Werte von Uniform-Variablen fest.
Die Namen dieser Methoden setzen sich wie folgt zusammen:
- Die Anzahl der Komponenten der Uniform-Variablen (1, 2, 3 oder 4).
- Der Typ der Uniform-Variablen (
ifür Integer,ffür Float,uifür vorzeichenlose Integer). - Das Vorhandensein des Suffixes
vfür Vektortypen.
Sie lassen sich mit dem regulären Ausdruck uniform[1234](u?i|f)v? erfassen.
Die meisten dieser Signaturen werden von der WebGL-1-API geerbt. WebGL 2 ergänzt die Varianten für vorzeichenlose Integer sowie die zusätzlichen Parameter srcOffset und srcLength für die Vektormethoden.
Syntax
uniform1ui(location, v0)
uniform2ui(location, v0, v1)
uniform3ui(location, v0, v1, v2)
uniform4ui(location, v0, v1, v2, v3)
uniform1fv(location, data)
uniform1fv(location, data, srcOffset)
uniform1fv(location, data, srcOffset, srcLength)
uniform2fv(location, data)
uniform2fv(location, data, srcOffset)
uniform2fv(location, data, srcOffset, srcLength)
uniform3fv(location, data)
uniform3fv(location, data, srcOffset)
uniform3fv(location, data, srcOffset, srcLength)
uniform4fv(location, data)
uniform4fv(location, data, srcOffset)
uniform4fv(location, data, srcOffset, srcLength)
uniform1iv(location, data)
uniform1iv(location, data, srcOffset)
uniform1iv(location, data, srcOffset, srcLength)
uniform2iv(location, data)
uniform2iv(location, data, srcOffset)
uniform2iv(location, data, srcOffset, srcLength)
uniform3iv(location, data)
uniform3iv(location, data, srcOffset)
uniform3iv(location, data, srcOffset, srcLength)
uniform4iv(location, data)
uniform4iv(location, data, srcOffset)
uniform4iv(location, data, srcOffset, srcLength)
uniform1uiv(location, data)
uniform1uiv(location, data, srcOffset)
uniform1uiv(location, data, srcOffset, srcLength)
uniform2uiv(location, data)
uniform2uiv(location, data, srcOffset)
uniform2uiv(location, data, srcOffset, srcLength)
uniform3uiv(location, data)
uniform3uiv(location, data, srcOffset)
uniform3uiv(location, data, srcOffset, srcLength)
uniform4uiv(location, data)
uniform4uiv(location, data, srcOffset)
uniform4uiv(location, data, srcOffset, srcLength)
Parameter
location-
Ein
WebGLUniformLocation-Objekt, das die Position der zu ändernden Uniform-Variablen enthält, odernull, um die Aktualisierung der Uniform-Variablen ohne Fehlermeldung zu ignorieren. data,v0,v1,v2,v3-
Ein neuer Wert für die Uniform-Variable. Mögliche Typen:
- Ein
Numberfür vorzeichenlose Ganzzahlwerte (Methoden mitui), Ganzzahlwerte (Methoden miti) oder Gleitkommawerte (Methoden mitf). - Ein
Uint32Array(oder einArraymit vorzeichenlosen Ganzzahlen) für Vektormethoden mit vorzeichenlosen Ganzzahlen (Methoden mituiv). - Ein
Int32Array(oder einArraymit Ganzzahlen) für Vektormethoden mit Ganzzahlen (Methoden mitiv). - Ein
Float32Array(oder einArraymit Zahlen) für Vektormethoden mit Gleitkommazahlen (Methoden mitfv).
- Ein
srcOffsetOptional-
Eine nicht negative Ganzzahl, die den Index des ersten zu verwendenden Elements im Array
dataangibt. Der Standardwert ist0. srcLengthOptional-
Eine nicht negative Ganzzahl, die die Anzahl der zu verwendenden Elemente im Array
dataangibt. Der Standardwert ist0, was alsdata.length - srcOffsetbehandelt wird.srcOffset + srcLengthmuss kleiner oder gleichdata.lengthsein.
Rückgabewert
Keiner (undefined).
Spezifikationen
| Spezifikation |
|---|
| WebGL 2.0 Specification> # 4.7.8> |