WEBGL_lose_context: restoreContext() 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 restoreContext() Methode der WEBGL_lose_context Erweiterung ist Teil der WebGL API und ermöglicht es Ihnen, das Wiederherstellen des Kontextes eines WebGLRenderingContext zu simulieren.

Sie löst die im WebGL-Spezifikation beschriebenen Schritte zum Umgang mit wiederhergestellten Kontexten aus. Der Kontext ist erst nach dem Auslösen des webglcontextrestored Ereignisses verwendbar.

Browser melden WebGL-Fehler möglicherweise nicht standardmäßig. WebGLs Fehlerberichterstattung funktioniert durch Aufrufen von getError() und Überprüfen auf Fehler. Die folgenden Ausnahmen können geworfen werden:

INVALID_OPERATION: Wird ausgelöst, wenn der Kontext nicht verloren ging.

Beispiele

Mit dieser Methode können Sie das webglcontextrestored Ereignis simulieren:

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

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

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