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-Fähigkeiten für diesen Kontext.

Syntax

js
disable(capability)

Parameter

capability

Ein GLenum, der angibt, welche WebGL-Fähigkeit deaktiviert werden soll. Mögliche Werte:

Konstante Beschreibung
gl.BLEND Deaktiviert das Mischen der berechneten Fragmentfarbenwerte. Siehe WebGLRenderingContext.blendFunc().
gl.CULL_FACE Deaktiviert das Polygon-Culling. Siehe WebGLRenderingContext.cullFace().
gl.DEPTH_TEST Deaktiviert Tiefenvergleiche und Updates des Tiefenpuffers. Siehe WebGLRenderingContext.depthFunc().
gl.DITHER Deaktiviert die Rauschunterdrückung der Farbkomponenten, bevor sie in den Farb-Puffer geschrieben werden.
gl.POLYGON_OFFSET_FILL Deaktiviert das Hinzufügen eines Offsets zu den Tiefenwerten von Polygonfragmenten. Siehe WebGLRenderingContext.polygonOffset().
gl.SAMPLE_ALPHA_TO_COVERAGE Deaktiviert die Berechnung eines temporären Abdeckungswerts, der durch den Alphawert bestimmt wird.
gl.SAMPLE_COVERAGE Deaktiviert das AND-Verknüpfen der Fragmentabdeckung mit dem temporären Abdeckungswert. 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 den Stencil-Test und Updates des Stencil-Puffers. Siehe WebGLRenderingContext.stencilFunc().

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

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

Rückgabewert

Keiner (undefined).

Beispiele

js
gl.disable(gl.DITHER);

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

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

Spezifikationen

Specification
WebGL Specification
# 5.14.3

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch