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 Benutzeragent 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 wird nicht weitergegeben.

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