WebGLRenderingContext.clear()

La méthode WebGLRenderingContext.clear() de l'API WebGL efface les tampons avec des valeurs prédéfinies.

Ces valeurs prédéfinies peuvent être affectées par clearColor(), clearDepth() ou clearStencil().

Les masques d'écriture, de détourage, de tramage et de tampon peuvent affecter la méthode clear().

Syntaxe

void gl.clear(masque);

Paramètres

masque
Un masque OU par bits GLbitfield qui indique les tampons à effacer. Les valeurs possibles sont :
  • gl.COLOR_BUFFER_BIT
  • gl.DEPTH_BUFFER_BIT
  • gl.STENCIL_BUFFER_BIT

Valeur retournée

Aucune.

Exceptions

Si masque n'est pas l'une des valeurs possibles listées, une erreur gl.INVALID_ENUM est déclenchée.

Exemples

La méthode clear() accepte des valeurs multiples.

gl.clear(gl.DEPTH_BUFFER_BIT);
gl.clear(gl.DEPTH_BUFFER_BIT | gl.COLOR_BUFFER_BIT);

Pour obtenir les valeurs d'effacement courantes, interrogez les constantes COLOR_CLEAR_VALUE, DEPTH_CLEAR_VALUE et STENCIL_CLEAR_VALUE grâce à la méthode getParameter().

gl.getParameter(gl.COLOR_CLEAR_VALUE);
gl.getParameter(gl.DEPTH_CLEAR_VALUE);
gl.getParameter(gl.STENCIL_CLEAR_VALUE);

Spécifications

Spécification Statut Commentaire
WebGL 1.0
La définition de 'clear' dans cette spécification.		 Recommendation Définition initiale.
OpenGL ES 2.0
La définition de 'glClear' dans cette spécification.		 Standard Page man de l'API OpenGL.

Compatibilité des navigateurs

Update compatibility data on GitHub
OrdinateurMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariWebview AndroidChrome pour AndroidFirefox pour AndroidOpera pour AndroidSafari sur iOSSamsung Internet
clearChrome Support complet 9Edge Support complet 12Firefox Support complet 4IE Support complet 11Opera Support complet 12Safari Support complet 5.1WebView Android Support complet OuiChrome Android Support complet 25Firefox Android Support complet OuiOpera Android Support complet 12Safari iOS Support complet 8Samsung Internet Android Support complet Oui

Légende

Support complet  
Support complet

Voir aussi

Sujets associés
  1. WebGL API
  2. WebGLRenderingContext
  3. Propriétés
    1. canvas
    2. drawingBufferHeight [Traduire]
    3. drawingBufferWidth [Traduire]
  4. Méthodes
    1. activeTexture()
    2. attachShader()
    3. bindAttribLocation() [Traduire]
    4. bindBuffer()
    5. bindFramebuffer() [Traduire]
    6. bindRenderbuffer() [Traduire]
    7. bindTexture()
    8. blendColor() [Traduire]
    9. blendEquation() [Traduire]
    10. blendEquationSeparate() [Traduire]
    11. blendFunc() [Traduire]
    12. blendFuncSeparate() [Traduire]
    13. bufferData()
    14. bufferSubData() [Traduire]
    15. checkFramebufferStatus() [Traduire]
    16. clear()
    17. clearColor() [Traduire]
    18. clearDepth() [Traduire]
    19. clearStencil() [Traduire]
    20. colorMask() [Traduire]
    21. commit() [Traduire]
    22. compileShader()
    23. compressedTexImage[23]D() [Traduire]
    24. compressedTexSubImage2D() [Traduire]
    25. copyTexImage2D() [Traduire]
    26. copyTexSubImage2D() [Traduire]
    27. createBuffer()
    28. createFramebuffer() [Traduire]
    29. createProgram()
    30. createRenderbuffer() [Traduire]
    31. createShader()
    32. createTexture()
    33. cullFace() [Traduire]
    34. deleteBuffer()
    35. deleteFramebuffer() [Traduire]
    36. deleteProgram() [Traduire]
    37. deleteRenderbuffer() [Traduire]
    38. deleteShader()
    39. deleteTexture() [Traduire]
    40. depthFunc() [Traduire]
    41. depthMask() [Traduire]
    42. depthRange() [Traduire]
    43. detachShader() [Traduire]
    44. disable() [Traduire]
    45. disableVertexAttribArray() [Traduire]
    46. drawArrays()
    47. drawElements() [Traduire]
    48. enable()
    49. enableVertexAttribArray()
    50. finish() [Traduire]
    51. flush() [Traduire]
    52. framebufferRenderbuffer() [Traduire]
    53. framebufferTexture2D() [Traduire]
    54. frontFace() [Traduire]
    55. generateMipmap()
    56. getActiveAttrib() [Traduire]
    57. getActiveUniform() [Traduire]
    58. getAttachedShaders() [Traduire]
    59. getAttribLocation()
    60. getBufferParameter() [Traduire]
    61. getContextAttributes() [Traduire]
    62. getError()
    63. getExtension() [Traduire]
    64. getFramebufferAttachmentParameter() [Traduire]
    65. getParameter() [Traduire]
    66. getProgramInfoLog() [Traduire]
    67. getProgramParameter() [Traduire]
    68. getRenderbufferParameter() [Traduire]
    69. getShaderInfoLog() [Traduire]
    70. getShaderParameter()
    71. getShaderPrecisionFormat() [Traduire]
    72. getShaderSource() [Traduire]
    73. getSupportedExtensions() [Traduire]
    74. getTexParameter()
    75. getUniform() [Traduire]
    76. getUniformLocation()
    77. getVertexAttrib() [Traduire]
    78. getVertexAttribOffset() [Traduire]
    79. hint() [Traduire]
    80. isBuffer()
    81. isContextLost() [Traduire]
    82. isEnabled() [Traduire]
    83. isFramebuffer() [Traduire]
    84. isProgram() [Traduire]
    85. isRenderbuffer() [Traduire]
    86. isShader() [Traduire]
    87. isTexture() [Traduire]
    88. lineWidth() [Traduire]
    89. linkProgram() [Traduire]
    90. pixelStorei() [Traduire]
    91. polygonOffset() [Traduire]
    92. readPixels() [Traduire]
    93. renderbufferStorage() [Traduire]
    94. sampleCoverage() [Traduire]
    95. scissor() [Traduire]
    96. shaderSource()
    97. stencilFunc() [Traduire]
    98. stencilFuncSeparate() [Traduire]
    99. stencilMask() [Traduire]
    100. stencilMaskSeparate() [Traduire]
    101. stencilOp() [Traduire]
    102. stencilOpSeparate() [Traduire]
    103. texImage2D()
    104. texParameter[fi]()
    105. texSubImage2D() [Traduire]
    106. uniform[1234][fi][v]()
    107. uniformMatrix[234]fv()
    108. useProgram()
    109. validateProgram() [Traduire]
    110. vertexAttrib[1234]f[v]() [Traduire]
    111. vertexAttribPointer()
    112. viewport()
  5. Pages liées à WebGL
    1. ANGLE_instanced_arrays
    2. EXT_blend_minmax
    3. EXT_color_buffer_half_float
    4. EXT_disjoint_timer_query
    5. EXT_frag_depth
    6. EXT_sRGB
    7. EXT_shader_texture_lod
    8. EXT_texture_filter_anisotropic
    9. OES_element_index_uint
    10. OES_standard_derivatives
    11. OES_texture_float
    12. OES_texture_float_linear
    13. OES_texture_half_float
    14. OES_texture_half_float_linear
    15. OES_vertex_array_object
    16. WEBGL_color_buffer_float
    17. WEBGL_compressed_texture_atc
    18. WEBGL_compressed_texture_etc1
    19. WEBGL_compressed_texture_pvrtc
    20. WEBGL_compressed_texture_s3tc
    21. WEBGL_compressed_texture_s3tc_srgb
    22. WEBGL_debug_renderer_info
    23. WEBGL_debug_shaders
    24. WEBGL_depth_texture
    25. WEBGL_draw_buffers
    26. WEBGL_lose_context
    27. WebGL2RenderingContext
    28. WebGLActiveInfo
    29. WebGLBuffer
    30. WebGLContextEvent
    31. WebGLFramebuffer
    32. WebGLObject
    33. WebGLProgram
    34. WebGLQuery
    35. WebGLRenderbuffer
    36. WebGLSampler
    37. WebGLShader
    38. WebGLShaderPrecisionFormat
    39. WebGLSync
    40. WebGLTexture
    41. WebGLTransformFeedback
    42. WebGLUniformLocation
    43. WebGLVertexArrayObject