HTMLCanvasElement : évènement webglcontextrestored
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
L'évènement webglcontextrestored de l'API WebGL est déclenché si l'agent utilisateur restaure le tampon de dessin d'un objet WebGLRenderingContext.
Une fois le contexte restauré, les ressources WebGL telles que les textures et les tampons créés avant la perte du contexte ne sont plus valides. Vous devez réinitialiser l'état de votre application WebGL et recréer les ressources.
Cet évènement ne se propage pas.
Syntaxe
Utilisez le nom de l'évènement dans des méthodes comme addEventListener(), ou définissez une propriété gestionnaire d'évènement.
addEventListener("webglcontextrestored", (event) => { })
onwebglcontextrestored = (event) => { }
Type d'évènement
Un WebGLContextEvent. Hérite de Event.
Propriétés de l'évènement
Cette interface hérite des propriétés de son interface parente, Event.
WebGLContextEvent.statusMessage-
Une propriété en lecture seule contenant des informations supplémentaires sur l'évènement.
Exemple
Avec l'aide de l'extension WEBGL_lose_context, vous pouvez simuler l'évènement webglcontextrestored :
const canvas = document.getElementById("canvas");
const gl = canvas.getContext("webgl");
canvas.addEventListener("webglcontextrestored", (e) => {
console.log(e);
});
gl.getExtension("WEBGL_lose_context").restoreContext();
// L'évènement "webglcontextrestored" est affiché dans la console.
Spécifications
| Specification |
|---|
| WebGL Specification # 5.15.3 |
Compatibilité des navigateurs
Voir aussi
- L'interface
WebGLContextEvent - La méthode
WebGLRenderingContext.isContextLost() - L'extension
WEBGL_lose_contextet ses méthodesWEBGL_lose_context.loseContext(),WEBGL_lose_context.restoreContext()