WebGLRenderingContext: uniform[1234][fi][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 July 2015.

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

js
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 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 Float32Array oder ein Array von Zahlen) für Fließkomma-Vektormethoden (Methoden mit "fv").
  • Eine Ganzzahl (Number) für Ganzzahlwerte (Methoden mit "i").
  • Ein Int32Array für Ganzzahl-Vektormethoden (Methoden mit "iv").

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.uniform1f(u_alpha, 0.8);

Spezifikationen

Specification
WebGL Specification
# 5.14.10

Browser-Kompatibilität

Siehe auch