// Copyright 2015-2024 The Khronos Group Inc.
//
// SPDX-License-Identifier: CC-BY-4.0

= Title

[open,refpage='vkCmdClearColorImage',desc='Clear regions of a color image',type='protos']
--
To clear one or more subranges of a color image, call:

include::{generated}/api/protos/vkCmdClearColorImage.adoc[]

.Valid Usage
****
  * If pname:image is non-sparse then the following must: hold:

      {empty}:: [eq]#p~i~ = {v~i~, v~i+1~}#

  * [[VUID-vkCmdClearColorImage-imageLayout-00004]]
    pname:imageLayout must: specify the layout of the image subresource ranges of pname:image specified in pname:pRanges at the time this
    command is executed on a sname:VkDevice
****