Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

WEBGL_lose_context: loseContext() Methode

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit April 2018 browserübergreifend verfügbar.

Die loseContext()-Methode der WEBGL_lose_context-Erweiterung ist Teil der WebGL-API und ermöglicht es Ihnen, das Verlieren des Kontexts eines WebGLRenderingContext zu simulieren.

Sie initiiert die im WebGL-Standard beschriebenen Schritte zum Umgang mit einem verlorenen Kontext. Der Kontext bleibt verloren, bis WEBGL_lose_context.restoreContext() aufgerufen wird. Es zerstört auch den zugrunde liegenden Grafik-Kontext und alle Grafik-Ressourcen. Dies ist der empfohlene Mechanismus, mit dem Anwendungen die Nutzung der WebGL-API programmatisch stoppen können.

Syntax

js
loseContext()

Parameter

Keine.

Rückgabewert

Keiner (undefined).

Beispiele

Mit dieser Methode können Sie das webglcontextlost-Ereignis simulieren:

js
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");

canvas.addEventListener("webglcontextlost", (e) => {
  console.log(e);
});

gl.getExtension("WEBGL_lose_context").loseContext();

// WebGLContextEvent event with type "webglcontextlost" is logged.

Spezifikationen

Spezifikation
WebGL WEBGL_lose_context Khronos Ratified Extension Specification

Browser-Kompatibilität

Siehe auch