WEBGL_lose_context: Methode restoreContext()
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 restoreContext() der Erweiterung WEBGL_lose_context ist Teil der WebGL-API und ermöglicht es Ihnen, die Wiederherstellung des Kontexts eines WebGLRenderingContext zu simulieren.
Sie löst die in der WebGL-Spezifikation beschriebenen Schritte zur Handhabung eines wiederhergestellten Kontexts aus. Der Kontext kann erst verwendet werden, nachdem das Ereignis webglcontextrestored ausgelöst wurde.
Syntax
restoreContext()
Parameter
Keine.
Rückgabewert
Keiner (undefined).
Ausnahmen
Browser melden WebGL-Fehler möglicherweise nicht standardmäßig. Um WebGL-Fehler zu prüfen, rufen Sie getError() auf. Der folgende Fehler kann auftreten:
INVALID_OPERATION-
Tritt auf, wenn der Kontext nicht verloren gegangen war.
Beispiele
Mit dieser Methode können Sie das Ereignis webglcontextrestored simulieren:
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
canvas.addEventListener("webglcontextrestored", (e) => {
console.log(e);
});
gl.getExtension("WEBGL_lose_context").restoreContext();
Spezifikationen
| Spezifikation |
|---|
| WebGL WEBGL_lose_context Khronos Ratified Extension Specification |