HTMLCanvasElement: webglcontextrestored-Ereignis
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.
Das webglcontextrestored
-Ereignis der WebGL API wird ausgelöst, wenn der User-Agent den Zeichenpuffer für ein WebGLRenderingContext
-Objekt wiederherstellt.
Sobald der Kontext wiederhergestellt ist, sind WebGL-Ressourcen wie Texturen und Puffer, die vor dem Verlust des Kontexts erstellt wurden, nicht mehr gültig. Sie müssen den Zustand Ihrer WebGL-Anwendung neu initialisieren und Ressourcen neu erstellen.
Dieses Ereignis blubbert nicht.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener()
oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("webglcontextrestored", (event) => {});
onwebglcontextrestored = (event) => {};
Ereignistyp
Ein WebGLContextEvent
. Erbt von Event
.
Ereigniseigenschaften
Diese Schnittstelle erbt Eigenschaften von ihrer Elternschnittstelle, Event
.
WebGLContextEvent.statusMessage
-
Eine schreibgeschützte Eigenschaft, die zusätzliche Informationen über das Ereignis enthält.
Beispiel
Mit Hilfe der WEBGL_lose_context
Erweiterung können Sie das webglcontextrestored
-Ereignis simulieren:
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
canvas.addEventListener(
"webglcontextrestored",
(e) => {
console.log(e);
},
false,
);
gl.getExtension("WEBGL_lose_context").restoreContext();
// "webglcontextrestored" event is logged.
Spezifikationen
Specification |
---|
WebGL Specification # 5.15.3 |
Browser-Kompatibilität
BCD tables only load in the browser