HTMLCanvasElement: webglcontextrestored-Ereignis
Baseline
Weitgehend verfügbar
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.
Das webglcontextrestored-Ereignis der WebGL API wird ausgelöst, wenn der User Agent den Zeichenpuffer für ein WebGLRenderingContext-Objekt wiederherstellt.
Nach der Wiederherstellung des Kontexts 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 die Ressourcen erneut erstellen.
Dieses Ereignis wird nicht nach oben weitergereicht.
Syntax
Verwenden Sie den Ereignisnamen in addEventListener():
addEventListener("webglcontextrestored", (event) => { })
Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:
onwebglcontextrestored = (event) => { }
Ereignistyp
Ein WebGLContextEvent. Erbt von Event.
Beispiel
Mithilfe der Erweiterung WEBGL_lose_context 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();
// "webglcontextrestored" event is logged.
Spezifikationen
| Spezifikation |
|---|
| WebGL Specification # 5.15.3 |