WebGLRenderingContext: Methode clearColor()

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.clearColor()-Methode der WebGL API gibt die Farbwerte an, die zum Löschen von Farb-Puffern verwendet werden.

Dies legt fest, welche Farbwerte verwendet werden, wenn die clear()-Methode aufgerufen wird. Die Werte werden zwischen 0 und 1 begrenzt.

Syntax

js
clearColor(red, green, blue, alpha)

Parameter

red

Ein GLclampf, der den roten Farbwert angibt, der verwendet wird, wenn die Farb-Puffer gelöscht werden. Standardwert: 0.

green

Ein GLclampf, der den grünen Farbwert angibt, der verwendet wird, wenn die Farb-Puffer gelöscht werden. Standardwert: 0.

blue

Ein GLclampf, der den blauen Farbwert angibt, der verwendet wird, wenn die Farb-Puffer gelöscht werden. Standardwert: 0.

alpha

Ein GLclampf, der den Alpha-(Transparenz-)Wert angibt, der verwendet wird, wenn die Farb-Puffer gelöscht werden. Standardwert: 0.

Rückgabewert

Keine (undefined).

Beispiele

js
gl.clearColor(1, 0.5, 0.5, 1);

Um die aktuelle Clear-Farbe zu erhalten, fragen Sie die COLOR_CLEAR_VALUE-Konstante ab, die einen Float32Array zurückgibt.

js
gl.getParameter(gl.COLOR_CLEAR_VALUE);
// Float32Array[1, 0.5, 0.5, 1]

Spezifikationen

Specification
WebGL Specification
# 5.14.3

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch