WEBGL_lose_context: Methode loseContext()
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.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die Methode loseContext() der Erweiterung WEBGL_lose_context ist Teil der WebGL-API und ermöglicht es Ihnen, den Verlust des Kontexts eines WebGLRenderingContext zu simulieren.
Sie löst die in der WebGL-Spezifikation beschriebenen Schritte zur Behandlung eines Kontextverlusts aus. Der Kontext bleibt verloren, bis WEBGL_lose_context.restoreContext() aufgerufen wird. Die Methode zerstört außerdem den zugrunde liegenden Grafikkontext und alle Grafikressourcen. Dies ist der empfohlene Mechanismus, mit dem Anwendungen ihre Nutzung der WebGL-API programmgesteuert beenden können.
Syntax
loseContext()
Parameter
Keine.
Rückgabewert
Keiner (undefined).
Beispiele
Mit dieser Methode können Sie das Ereignis webglcontextlost simulieren:
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 |