WebGL2RenderingContext: uniform[1234][uif][v]() Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2021.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die WebGL2RenderingContext.uniform[1234][uif][v]() Methoden der WebGL API legen Werte von Uniform-Variablen fest.

Die Namen dieser Methoden setzen sich zusammen aus:

  • Der Anzahl der Komponenten in der Uniform-Variable (1, 2, 3 oder 4).
  • Dem Typ der Uniform-Variable (i für Integer, f für Float, ui für Unsigned Integer).
  • Der Anwesenheit eines Vektorsuffixes (v) für Vektortypen.

Sie können durch den regulären Ausdruck uniform[1234](u?i|f)v? gematcht werden.

Die meisten dieser Signaturen sind vom WebGL 1 API geerbt. WebGL 2 fügt die Versionen für Unsigned Integer sowie die zusätzlichen srcOffset- und srcLength-Parameter zu den Vektormethoden hinzu.

Syntax

js
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 den Ort des zu modifizierenden Uniform-Attributs enthält.

data, v0, v1, v2, v3

Ein neuer Wert, der für die Uniform-Variable verwendet werden soll. Mögliche Typen:

  • Eine Number für Unsigned Integer-Werte (Methoden mit ui), für Integer-Werte (Methoden mit i) oder für Float-Werte (Methoden mit f).
  • Eine Uint32Array (oder ein Array von Unsigned Integer-Zahlen) für Methoden mit Unsigned Integer-Vektoren (Methoden mit uiv).
  • Eine Int32Array (oder ein Array von Integer-Zahlen) für Methoden mit Integer-Vektoren (Methoden mit iv).
  • Eine Float32Array (oder ein Array von Zahlen) für Methoden mit Gleitkomma-Vektoren (Methoden mit fv).
srcOffset Optional

Eine nicht-negative ganze Zahl, die den Index des ersten zu verwendenden Elements im data-Array angibt. Standard ist 0.

srcLength Optional

Eine nicht-negative ganze Zahl, die die Anzahl der zu verwendenden Elemente im data-Array angibt. Standard ist 0, was als data.length - srcOffset behandelt wird. srcOffset + srcLength muss kleiner oder gleich data.length sein.

Rückgabewert

Keiner (undefined).

Spezifikationen

Specification
WebGL 2.0 Specification
# 3.7.8

Browser-Kompatibilität

Siehe auch