WebGLRenderingContext: disable()-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.disable()-Methode der WebGL API deaktiviert spezifische WebGL-Funktionen für diesen Kontext.

Syntax

js
disable(capability)

Parameter

capability

Ein GLenum, das angibt, welche WebGL-Funktion deaktiviert werden soll. Mögliche Werte:

Konstante Beschreibung
gl.BLEND Deaktiviert das Mischen der berechneten Fragmentfarbwerte. Siehe WebGLRenderingContext.blendFunc().
gl.CULL_FACE Deaktiviert das Entfernen (Culling) von Polygonen. Siehe WebGLRenderingContext.cullFace().
gl.DEPTH_TEST Deaktiviert Tiefenvergleiche und Aktualisierungen des Tiefenpuffers. Siehe WebGLRenderingContext.depthFunc().
gl.DITHER Deaktiviert Dithering der Farbkomponenten, bevor sie in den Farbpuffer geschrieben werden.
gl.POLYGON_OFFSET_FILL Deaktiviert das Hinzufügen einer Verschiebung zu den Tiefenwerten der Fragmente eines Polygons. Siehe WebGLRenderingContext.polygonOffset().
gl.SAMPLE_ALPHA_TO_COVERAGE Deaktiviert die Berechnung eines temporären Deckungswertes basierend auf dem Alphawert.
gl.SAMPLE_COVERAGE Deaktiviert das AND-Verknüpfen der Fragmentabdeckung mit dem temporären Deckungswert. Siehe WebGLRenderingContext.sampleCoverage().
gl.SCISSOR_TEST Deaktiviert den Scherentest, der Fragmente verwirft, die außerhalb des Scherrechtecks liegen. Siehe WebGLRenderingContext.scissor().
gl.STENCIL_TEST Deaktiviert Schablonentests und Aktualisierungen des Schablonenpuffers. Siehe WebGLRenderingContext.stencilFunc().

Bei Verwendung eines WebGL 2-Kontextes sind zusätzlich folgende Werte verfügbar:

Konstante Beschreibung
gl.RASTERIZER_DISCARD Deaktiviert, dass Primitiven unmittelbar vor der Rasterisierungsphase, jedoch nach der optionalen Transform-Feedback-Phase verworfen werden. gl.clear()-Befehle werden ignoriert.

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.disable(gl.DITHER);

Um zu überprüfen, ob eine Funktion deaktiviert ist, verwenden Sie die WebGLRenderingContext.isEnabled()-Methode:

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

Spezifikationen

Specification
WebGL Specification
# 5.14.3

Browser-Kompatibilität

Siehe auch