WebGLRenderingContext: isEnabled() 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: Dieses Feature ist verfügbar in Web Workers.

Die WebGLRenderingContext.isEnabled() Methode der WebGL-API prüft, ob eine bestimmte WebGL-Funktionalität in diesem Kontext aktiviert ist oder nicht.

Standardmäßig sind alle Funktionalitäten, mit Ausnahme von gl.DITHER, deaktiviert.

Syntax

js
isEnabled(cap)

Parameter

cap

Ein GLenum, der angibt, welche WebGL-Funktionalität getestet werden soll. Mögliche Werte:

Konstante Beschreibung
gl.BLEND Mischen der berechneten Fragmentfarbwerte. Siehe WebGLRenderingContext.blendFunc().
gl.CULL_FACE Ausblenden von Polygonen. Siehe WebGLRenderingContext.cullFace().
gl.DEPTH_TEST Tiefenvergleiche und Aktualisierungen des Tiefenpuffers. Siehe WebGLRenderingContext.depthFunc().
gl.DITHER Dithering von Farbkomponenten, bevor sie in den Farb-Puffer geschrieben werden.
gl.POLYGON_OFFSET_FILL Hinzufügen eines Offsets zu den Tiefenwerten der Fragmenten eines Polygons. Siehe WebGLRenderingContext.polygonOffset().
gl.SAMPLE_ALPHA_TO_COVERAGE Berechnung eines temporären Abdeckungswerts, der durch den Alphawert bestimmt wird.
gl.SAMPLE_COVERAGE AND-Verknüpfung der Abdeckung des Fragments mit dem temporären Abdeckungswert. Siehe WebGLRenderingContext.sampleCoverage().
gl.SCISSOR_TEST Der Scherentest verwirft Fragmente, die außerhalb des Scherrechtecks liegen. Siehe WebGLRenderingContext.scissor().
gl.STENCIL_TEST Schablonentests und Aktualisierungen des Schablonenpuffers. Siehe WebGLRenderingContext.stencilFunc().

Bei der Verwendung eines WebGL 2 Kontext stehen zusätzlich die folgenden Werte zur Verfügung:

Konstante Beschreibung
gl.RASTERIZER_DISCARD Primitive werden unmittelbar vor der Rasterisierungsphase, aber nach der optionalen Transformations-Feedback-Phase, verworfen. gl.clear() Befehle werden ignoriert.

Rückgabewert

Ein GLboolean, der angibt, ob die Funktionalität cap aktiviert (true) oder nicht (false) ist.

Beispiele

js
gl.isEnabled(gl.STENCIL_TEST);
// false

Um eine spezifische Funktionalität zu aktivieren oder zu deaktivieren, verwenden Sie die Methoden WebGLRenderingContext.enable() und WebGLRenderingContext.disable():

js
gl.enable(gl.STENCIL_TEST);
gl.disable(gl.STENCIL_TEST);

Spezifikationen

Specification
WebGL Specification
# 5.14.3
WebGL 2.0 Specification
# 3.7.2

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch