[{"data":1,"prerenderedAt":1419},["ShallowReactive",2],{"jD8lD3Bamp":3},{"title":4,"description":5,"parent":6,"cmd_buf_level":7,"render_pass_scope":10,"supported_queue_types":11,"tasks":14,"type":16,"xrefs":17,"body":18,"_type":1418,"_id":4},"vkCmdClearColorImage","Clear regions of a color image","VK_VERSION_1_0",[8,9],"primary","secondary","outside",[12,13],"graphics","compute",[15],"action","protos",[],{"type":19,"children":20,"toc":1416},"root",[21,29,417,553,571,1119,1364,1410],{"type":22,"tag":23,"props":24,"children":25},"element","p",{},[26],{"type":27,"value":28},"text","To clear one or more subranges of a color image, call:",{"type":22,"tag":30,"props":31,"children":32},"code-group",{},[33,199],{"type":22,"tag":34,"props":35,"children":41},"pre",{"className":36,"code":37,"filename":38,"language":39,"meta":40,"style":40},"language-c shiki shiki-themes github-light-default github-dark-default","void vkCmdClearColorImage(\n VkCommandBuffer commandBuffer,\n VkImage image,\n VkImageLayout imageLayout,\n const VkClearColorValue* pColor,\n uint32_t rangeCount,\n const VkImageSubresourceRange* pRanges);\n","C","c","",[42],{"type":22,"tag":43,"props":44,"children":45},"code",{"__ignoreMap":40},[46,70,90,108,126,154,172],{"type":22,"tag":47,"props":48,"children":51},"span",{"class":49,"line":50},"line",1,[52,58,64],{"type":22,"tag":47,"props":53,"children":55},{"style":54},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[56],{"type":27,"value":57},"void",{"type":22,"tag":47,"props":59,"children":61},{"style":60},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[62],{"type":27,"value":63}," vkCmdClearColorImage",{"type":22,"tag":47,"props":65,"children":67},{"style":66},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[68],{"type":27,"value":69},"(\n",{"type":22,"tag":47,"props":71,"children":73},{"class":49,"line":72},2,[74,79,85],{"type":22,"tag":47,"props":75,"children":76},{"style":66},[77],{"type":27,"value":78}," VkCommandBuffer ",{"type":22,"tag":47,"props":80,"children":82},{"style":81},"--shiki-default:#953800;--shiki-dark:#FFA657",[83],{"type":27,"value":84},"commandBuffer",{"type":22,"tag":47,"props":86,"children":87},{"style":66},[88],{"type":27,"value":89},",\n",{"type":22,"tag":47,"props":91,"children":93},{"class":49,"line":92},3,[94,99,104],{"type":22,"tag":47,"props":95,"children":96},{"style":66},[97],{"type":27,"value":98}," VkImage ",{"type":22,"tag":47,"props":100,"children":101},{"style":81},[102],{"type":27,"value":103},"image",{"type":22,"tag":47,"props":105,"children":106},{"style":66},[107],{"type":27,"value":89},{"type":22,"tag":47,"props":109,"children":111},{"class":49,"line":110},4,[112,117,122],{"type":22,"tag":47,"props":113,"children":114},{"style":66},[115],{"type":27,"value":116}," VkImageLayout ",{"type":22,"tag":47,"props":118,"children":119},{"style":81},[120],{"type":27,"value":121},"imageLayout",{"type":22,"tag":47,"props":123,"children":124},{"style":66},[125],{"type":27,"value":89},{"type":22,"tag":47,"props":127,"children":129},{"class":49,"line":128},5,[130,135,140,145,150],{"type":22,"tag":47,"props":131,"children":132},{"style":54},[133],{"type":27,"value":134}," const",{"type":22,"tag":47,"props":136,"children":137},{"style":66},[138],{"type":27,"value":139}," VkClearColorValue",{"type":22,"tag":47,"props":141,"children":142},{"style":54},[143],{"type":27,"value":144},"*",{"type":22,"tag":47,"props":146,"children":147},{"style":81},[148],{"type":27,"value":149}," pColor",{"type":22,"tag":47,"props":151,"children":152},{"style":66},[153],{"type":27,"value":89},{"type":22,"tag":47,"props":155,"children":157},{"class":49,"line":156},6,[158,163,168],{"type":22,"tag":47,"props":159,"children":160},{"style":54},[161],{"type":27,"value":162}," uint32_t",{"type":22,"tag":47,"props":164,"children":165},{"style":81},[166],{"type":27,"value":167}," rangeCount",{"type":22,"tag":47,"props":169,"children":170},{"style":66},[171],{"type":27,"value":89},{"type":22,"tag":47,"props":173,"children":175},{"class":49,"line":174},7,[176,180,185,189,194],{"type":22,"tag":47,"props":177,"children":178},{"style":54},[179],{"type":27,"value":134},{"type":22,"tag":47,"props":181,"children":182},{"style":66},[183],{"type":27,"value":184}," VkImageSubresourceRange",{"type":22,"tag":47,"props":186,"children":187},{"style":54},[188],{"type":27,"value":144},{"type":22,"tag":47,"props":190,"children":191},{"style":81},[192],{"type":27,"value":193}," pRanges",{"type":22,"tag":47,"props":195,"children":196},{"style":66},[197],{"type":27,"value":198},");\n",{"type":22,"tag":34,"props":200,"children":205},{"className":201,"code":202,"filename":203,"language":204,"meta":40,"style":40},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_clear_color_image(\n command_buffer: vk::CommandBuffer,\n image: vk::Image,\n image_layout: vk::ImageLayout,\n p_color: *const vk::ClearColorValue,\n range_count: u32,\n p_ranges: *const vk::ImageSubresourceRange,\n);\n","Rust","rs",[206],{"type":22,"tag":43,"props":207,"children":208},{"__ignoreMap":40},[209,231,263,292,321,355,376,409],{"type":22,"tag":47,"props":210,"children":211},{"class":49,"line":50},[212,217,222,227],{"type":22,"tag":47,"props":213,"children":214},{"style":54},[215],{"type":27,"value":216},"pub",{"type":22,"tag":47,"props":218,"children":219},{"style":54},[220],{"type":27,"value":221}," fn",{"type":22,"tag":47,"props":223,"children":224},{"style":60},[225],{"type":27,"value":226}," cmd_clear_color_image",{"type":22,"tag":47,"props":228,"children":229},{"style":66},[230],{"type":27,"value":69},{"type":22,"tag":47,"props":232,"children":233},{"class":49,"line":72},[234,239,244,249,254,259],{"type":22,"tag":47,"props":235,"children":236},{"style":66},[237],{"type":27,"value":238}," command_buffer",{"type":22,"tag":47,"props":240,"children":241},{"style":54},[242],{"type":27,"value":243},":",{"type":22,"tag":47,"props":245,"children":246},{"style":81},[247],{"type":27,"value":248}," vk",{"type":22,"tag":47,"props":250,"children":251},{"style":54},[252],{"type":27,"value":253},"::",{"type":22,"tag":47,"props":255,"children":256},{"style":81},[257],{"type":27,"value":258},"CommandBuffer",{"type":22,"tag":47,"props":260,"children":261},{"style":66},[262],{"type":27,"value":89},{"type":22,"tag":47,"props":264,"children":265},{"class":49,"line":92},[266,271,275,279,283,288],{"type":22,"tag":47,"props":267,"children":268},{"style":66},[269],{"type":27,"value":270}," image",{"type":22,"tag":47,"props":272,"children":273},{"style":54},[274],{"type":27,"value":243},{"type":22,"tag":47,"props":276,"children":277},{"style":81},[278],{"type":27,"value":248},{"type":22,"tag":47,"props":280,"children":281},{"style":54},[282],{"type":27,"value":253},{"type":22,"tag":47,"props":284,"children":285},{"style":81},[286],{"type":27,"value":287},"Image",{"type":22,"tag":47,"props":289,"children":290},{"style":66},[291],{"type":27,"value":89},{"type":22,"tag":47,"props":293,"children":294},{"class":49,"line":110},[295,300,304,308,312,317],{"type":22,"tag":47,"props":296,"children":297},{"style":66},[298],{"type":27,"value":299}," image_layout",{"type":22,"tag":47,"props":301,"children":302},{"style":54},[303],{"type":27,"value":243},{"type":22,"tag":47,"props":305,"children":306},{"style":81},[307],{"type":27,"value":248},{"type":22,"tag":47,"props":309,"children":310},{"style":54},[311],{"type":27,"value":253},{"type":22,"tag":47,"props":313,"children":314},{"style":81},[315],{"type":27,"value":316},"ImageLayout",{"type":22,"tag":47,"props":318,"children":319},{"style":66},[320],{"type":27,"value":89},{"type":22,"tag":47,"props":322,"children":323},{"class":49,"line":128},[324,329,333,338,342,346,351],{"type":22,"tag":47,"props":325,"children":326},{"style":66},[327],{"type":27,"value":328}," p_color",{"type":22,"tag":47,"props":330,"children":331},{"style":54},[332],{"type":27,"value":243},{"type":22,"tag":47,"props":334,"children":335},{"style":54},[336],{"type":27,"value":337}," *const",{"type":22,"tag":47,"props":339,"children":340},{"style":81},[341],{"type":27,"value":248},{"type":22,"tag":47,"props":343,"children":344},{"style":54},[345],{"type":27,"value":253},{"type":22,"tag":47,"props":347,"children":348},{"style":81},[349],{"type":27,"value":350},"ClearColorValue",{"type":22,"tag":47,"props":352,"children":353},{"style":66},[354],{"type":27,"value":89},{"type":22,"tag":47,"props":356,"children":357},{"class":49,"line":156},[358,363,367,372],{"type":22,"tag":47,"props":359,"children":360},{"style":66},[361],{"type":27,"value":362}," range_count",{"type":22,"tag":47,"props":364,"children":365},{"style":54},[366],{"type":27,"value":243},{"type":22,"tag":47,"props":368,"children":369},{"style":81},[370],{"type":27,"value":371}," u32",{"type":22,"tag":47,"props":373,"children":374},{"style":66},[375],{"type":27,"value":89},{"type":22,"tag":47,"props":377,"children":378},{"class":49,"line":174},[379,384,388,392,396,400,405],{"type":22,"tag":47,"props":380,"children":381},{"style":66},[382],{"type":27,"value":383}," p_ranges",{"type":22,"tag":47,"props":385,"children":386},{"style":54},[387],{"type":27,"value":243},{"type":22,"tag":47,"props":389,"children":390},{"style":54},[391],{"type":27,"value":337},{"type":22,"tag":47,"props":393,"children":394},{"style":81},[395],{"type":27,"value":248},{"type":22,"tag":47,"props":397,"children":398},{"style":54},[399],{"type":27,"value":253},{"type":22,"tag":47,"props":401,"children":402},{"style":81},[403],{"type":27,"value":404},"ImageSubresourceRange",{"type":22,"tag":47,"props":406,"children":407},{"style":66},[408],{"type":27,"value":89},{"type":22,"tag":47,"props":410,"children":412},{"class":49,"line":411},8,[413],{"type":22,"tag":47,"props":414,"children":415},{"style":66},[416],{"type":27,"value":198},{"type":22,"tag":418,"props":419,"children":420},"ul",{},[421,432,442,482,510,528],{"type":22,"tag":422,"props":423,"children":424},"li",{},[425,430],{"type":22,"tag":43,"props":426,"children":428},{"className":427},[],[429],{"type":27,"value":84},{"type":27,"value":431}," is the command buffer into which the command will be\nrecorded.",{"type":22,"tag":422,"props":433,"children":434},{},[435,440],{"type":22,"tag":43,"props":436,"children":438},{"className":437},[],[439],{"type":27,"value":103},{"type":27,"value":441}," is the image to be cleared.",{"type":22,"tag":422,"props":443,"children":444},{},[445,450,452,457,459,465,466,472,474,480],{"type":22,"tag":43,"props":446,"children":448},{"className":447},[],[449],{"type":27,"value":121},{"type":27,"value":451}," specifies the current layout of the image subresource\nranges to be cleared, and ",{"type":22,"tag":453,"props":454,"children":456},"normative",{"type":455},"must",[],{"type":27,"value":458}," be\n",{"type":22,"tag":43,"props":460,"children":462},{"className":461},[],[463],{"type":27,"value":464},"VK_IMAGE_LAYOUT_SHARED_PRESENT_KHR",{"type":27,"value":89},{"type":22,"tag":43,"props":467,"children":469},{"className":468},[],[470],{"type":27,"value":471},"VK_IMAGE_LAYOUT_GENERAL",{"type":27,"value":473}," or\n",{"type":22,"tag":43,"props":475,"children":477},{"className":476},[],[478],{"type":27,"value":479},"VK_IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL",{"type":27,"value":481},".",{"type":22,"tag":422,"props":483,"children":484},{},[485,491,493,500,502,508],{"type":22,"tag":43,"props":486,"children":488},{"className":487},[],[489],{"type":27,"value":490},"pColor",{"type":27,"value":492}," is a pointer to a ",{"type":22,"tag":494,"props":495,"children":497},"a",{"href":496},"/man/VkClearColorValue",[498],{"type":27,"value":499},"VkClearColorValue",{"type":27,"value":501}," structure\ncontaining the values that the image subresource ranges will be cleared\nto (see ",{"type":22,"tag":494,"props":503,"children":505},{"href":504},"/chapters/clears#clears-values",[506],{"type":27,"value":507},"Clear Values",{"type":27,"value":509}," below).",{"type":22,"tag":422,"props":511,"children":512},{},[513,519,521,527],{"type":22,"tag":43,"props":514,"children":516},{"className":515},[],[517],{"type":27,"value":518},"rangeCount",{"type":27,"value":520}," is the number of image subresource range structures in\n",{"type":22,"tag":43,"props":522,"children":524},{"className":523},[],[525],{"type":27,"value":526},"pRanges",{"type":27,"value":481},{"type":22,"tag":422,"props":529,"children":530},{},[531,536,538,544,546,552],{"type":22,"tag":43,"props":532,"children":534},{"className":533},[],[535],{"type":27,"value":526},{"type":27,"value":537}," is a pointer to an array of ",{"type":22,"tag":494,"props":539,"children":541},{"href":540},"/man/VkImageSubresourceRange",[542],{"type":27,"value":543},"VkImageSubresourceRange",{"type":27,"value":545},"\nstructures describing a range of mipmap levels, array layers, and\naspects to be cleared, as described in ",{"type":22,"tag":494,"props":547,"children":549},{"href":548},"/chapters/resources#resources-image-views",[550],{"type":27,"value":551},"Image\nViews",{"type":27,"value":481},{"type":22,"tag":23,"props":554,"children":555},{},[556,558,563,565,570],{"type":27,"value":557},"Each specified range in ",{"type":22,"tag":43,"props":559,"children":561},{"className":560},[],[562],{"type":27,"value":526},{"type":27,"value":564}," is cleared to the value specified by\n",{"type":22,"tag":43,"props":566,"children":568},{"className":567},[],[569],{"type":27,"value":490},{"type":27,"value":481},{"type":22,"tag":572,"props":573,"children":575},"validity-group",{"name":574},"Valid Usage",[576,610,637,675,704,742,776,815,868,943,991,1057,1075,1099],{"type":22,"tag":577,"props":578,"children":580},"validity-field",{"name":579},"VUID-vkCmdClearColorImage-image-01993",[581],{"type":22,"tag":23,"props":582,"children":583},{},[584,586,592,594,599,602,604],{"type":27,"value":585},"The ",{"type":22,"tag":494,"props":587,"children":589},{"href":588},"/chapters/resources#resources-image-format-features",[590],{"type":27,"value":591},"format features",{"type":27,"value":593}," of ",{"type":22,"tag":43,"props":595,"children":597},{"className":596},[],[598],{"type":27,"value":103},{"type":22,"tag":453,"props":600,"children":601},{"type":455},[],{"type":27,"value":603}," contain ",{"type":22,"tag":43,"props":605,"children":607},{"className":606},[],[608],{"type":27,"value":609},"VK_FORMAT_FEATURE_TRANSFER_DST_BIT",{"type":22,"tag":577,"props":611,"children":613},{"name":612},"VUID-vkCmdClearColorImage-image-00002",[614],{"type":22,"tag":23,"props":615,"children":616},{},[617,622,624,627,629,635],{"type":22,"tag":43,"props":618,"children":620},{"className":619},[],[621],{"type":27,"value":103},{"type":27,"value":623}," ",{"type":22,"tag":453,"props":625,"children":626},{"type":455},[],{"type":27,"value":628}," have been created with\n",{"type":22,"tag":43,"props":630,"children":632},{"className":631},[],[633],{"type":27,"value":634},"VK_IMAGE_USAGE_TRANSFER_DST_BIT",{"type":27,"value":636}," usage flag",{"type":22,"tag":577,"props":638,"children":640},{"name":639},"VUID-vkCmdClearColorImage-image-01545",[641],{"type":22,"tag":23,"props":642,"children":643},{},[644,649,650,653,655],{"type":22,"tag":43,"props":645,"children":647},{"className":646},[],[648],{"type":27,"value":103},{"type":27,"value":623},{"type":22,"tag":453,"props":651,"children":652},{"type":455},[],{"type":27,"value":654}," not use any of the\n",{"type":22,"tag":494,"props":656,"children":658},{"href":657},"/chapters/formats#formats-requiring-sampler-ycbcr-conversion",[659,661,667,668,673],{"type":27,"value":660},"formats that require a\nsampler Y′C",{"type":22,"tag":662,"props":663,"children":664},"sub",{},[665],{"type":27,"value":666},"B",{"type":27,"value":38},{"type":22,"tag":662,"props":669,"children":670},{},[671],{"type":27,"value":672},"R",{"type":27,"value":674}," conversion",{"type":22,"tag":577,"props":676,"children":678},{"name":677},"VUID-vkCmdClearColorImage-image-00003",[679],{"type":22,"tag":23,"props":680,"children":681},{},[682,684,689,691,694,696,702],{"type":27,"value":683},"If ",{"type":22,"tag":43,"props":685,"children":687},{"className":686},[],[688],{"type":27,"value":103},{"type":27,"value":690}," is non-sparse then it ",{"type":22,"tag":453,"props":692,"children":693},{"type":455},[],{"type":27,"value":695}," be bound completely and\ncontiguously to a single ",{"type":22,"tag":43,"props":697,"children":699},{"className":698},[],[700],{"type":27,"value":701},"VkDeviceMemory",{"type":27,"value":703}," object",{"type":22,"tag":577,"props":705,"children":707},{"name":706},"VUID-vkCmdClearColorImage-imageLayout-00004",[708],{"type":22,"tag":23,"props":709,"children":710},{},[711,716,717,720,722,727,729,734,736],{"type":22,"tag":43,"props":712,"children":714},{"className":713},[],[715],{"type":27,"value":121},{"type":27,"value":623},{"type":22,"tag":453,"props":718,"children":719},{"type":455},[],{"type":27,"value":721}," specify the layout of the image subresource\nranges of ",{"type":22,"tag":43,"props":723,"children":725},{"className":724},[],[726],{"type":27,"value":103},{"type":27,"value":728}," specified in ",{"type":22,"tag":43,"props":730,"children":732},{"className":731},[],[733],{"type":27,"value":526},{"type":27,"value":735}," at the time this\ncommand is executed on a ",{"type":22,"tag":43,"props":737,"children":739},{"className":738},[],[740],{"type":27,"value":741},"VkDevice",{"type":22,"tag":577,"props":743,"children":745},{"name":744},"VUID-vkCmdClearColorImage-imageLayout-01394",[746],{"type":22,"tag":23,"props":747,"children":748},{},[749,754,755,758,759,764,765,770,771],{"type":22,"tag":43,"props":750,"children":752},{"className":751},[],[753],{"type":27,"value":121},{"type":27,"value":623},{"type":22,"tag":453,"props":756,"children":757},{"type":455},[],{"type":27,"value":458},{"type":22,"tag":43,"props":760,"children":762},{"className":761},[],[763],{"type":27,"value":464},{"type":27,"value":89},{"type":22,"tag":43,"props":766,"children":768},{"className":767},[],[769],{"type":27,"value":479},{"type":27,"value":473},{"type":22,"tag":43,"props":772,"children":774},{"className":773},[],[775],{"type":27,"value":471},{"type":22,"tag":577,"props":777,"children":779},{"name":778},"VUID-vkCmdClearColorImage-aspectMask-02498",[780],{"type":22,"tag":23,"props":781,"children":782},{},[783,784,788,789,795,797,802,804,807,809],{"type":27,"value":585},{"type":22,"tag":494,"props":785,"children":786},{"href":540},[787],{"type":27,"value":543},{"type":27,"value":253},{"type":22,"tag":43,"props":790,"children":792},{"className":791},[],[793],{"type":27,"value":794},"aspectMask",{"type":27,"value":796}," members of the\nelements of the ",{"type":22,"tag":43,"props":798,"children":800},{"className":799},[],[801],{"type":27,"value":526},{"type":27,"value":803}," array ",{"type":22,"tag":453,"props":805,"children":806},{"type":455},[],{"type":27,"value":808}," each only include\n",{"type":22,"tag":43,"props":810,"children":812},{"className":811},[],[813],{"type":27,"value":814},"VK_IMAGE_ASPECT_COLOR_BIT",{"type":22,"tag":577,"props":816,"children":818},{"name":817},"VUID-vkCmdClearColorImage-baseMipLevel-01470",[819],{"type":22,"tag":23,"props":820,"children":821},{},[822,823,827,828,834,835,840,841,844,846,852,853,859,861,866],{"type":27,"value":585},{"type":22,"tag":494,"props":824,"children":825},{"href":540},[826],{"type":27,"value":543},{"type":27,"value":253},{"type":22,"tag":43,"props":829,"children":831},{"className":830},[],[832],{"type":27,"value":833},"baseMipLevel",{"type":27,"value":796},{"type":22,"tag":43,"props":836,"children":838},{"className":837},[],[839],{"type":27,"value":526},{"type":27,"value":803},{"type":22,"tag":453,"props":842,"children":843},{"type":455},[],{"type":27,"value":845}," each be less than the\n",{"type":22,"tag":43,"props":847,"children":849},{"className":848},[],[850],{"type":27,"value":851},"mipLevels",{"type":27,"value":728},{"type":22,"tag":494,"props":854,"children":856},{"href":855},"/man/VkImageCreateInfo",[857],{"type":27,"value":858},"VkImageCreateInfo",{"type":27,"value":860}," when ",{"type":22,"tag":43,"props":862,"children":864},{"className":863},[],[865],{"type":27,"value":103},{"type":27,"value":867},"\nwas created",{"type":22,"tag":577,"props":869,"children":871},{"name":870},"VUID-vkCmdClearColorImage-pRanges-01692",[872],{"type":22,"tag":23,"props":873,"children":874},{},[875,877,881,883,888,890,896,898,904,906,911,913,918,919,922,924,929,930,934,936,941],{"type":27,"value":876},"For each ",{"type":22,"tag":494,"props":878,"children":879},{"href":540},[880],{"type":27,"value":543},{"type":27,"value":882}," element of ",{"type":22,"tag":43,"props":884,"children":886},{"className":885},[],[887],{"type":27,"value":526},{"type":27,"value":889},", if the\n",{"type":22,"tag":43,"props":891,"children":893},{"className":892},[],[894],{"type":27,"value":895},"levelCount",{"type":27,"value":897}," member is not ",{"type":22,"tag":43,"props":899,"children":901},{"className":900},[],[902],{"type":27,"value":903},"VK_REMAINING_MIP_LEVELS",{"type":27,"value":905},", then\n",{"type":22,"tag":43,"props":907,"children":909},{"className":908},[],[910],{"type":27,"value":833},{"type":27,"value":912}," + ",{"type":22,"tag":43,"props":914,"children":916},{"className":915},[],[917],{"type":27,"value":895},{"type":27,"value":623},{"type":22,"tag":453,"props":920,"children":921},{"type":455},[],{"type":27,"value":923}," be less than or\nequal to the ",{"type":22,"tag":43,"props":925,"children":927},{"className":926},[],[928],{"type":27,"value":851},{"type":27,"value":728},{"type":22,"tag":494,"props":931,"children":932},{"href":855},[933],{"type":27,"value":858},{"type":27,"value":935}," when\n",{"type":22,"tag":43,"props":937,"children":939},{"className":938},[],[940],{"type":27,"value":103},{"type":27,"value":942}," was created",{"type":22,"tag":577,"props":944,"children":946},{"name":945},"VUID-vkCmdClearColorImage-baseArrayLayer-01472",[947],{"type":22,"tag":23,"props":948,"children":949},{},[950,951,955,956,962,963,968,969,972,973,979,980,984,985,990],{"type":27,"value":585},{"type":22,"tag":494,"props":952,"children":953},{"href":540},[954],{"type":27,"value":543},{"type":27,"value":253},{"type":22,"tag":43,"props":957,"children":959},{"className":958},[],[960],{"type":27,"value":961},"baseArrayLayer",{"type":27,"value":796},{"type":22,"tag":43,"props":964,"children":966},{"className":965},[],[967],{"type":27,"value":526},{"type":27,"value":803},{"type":22,"tag":453,"props":970,"children":971},{"type":455},[],{"type":27,"value":845},{"type":22,"tag":43,"props":974,"children":976},{"className":975},[],[977],{"type":27,"value":978},"arrayLayers",{"type":27,"value":728},{"type":22,"tag":494,"props":981,"children":982},{"href":855},[983],{"type":27,"value":858},{"type":27,"value":860},{"type":22,"tag":43,"props":986,"children":988},{"className":987},[],[989],{"type":27,"value":103},{"type":27,"value":867},{"type":22,"tag":577,"props":992,"children":994},{"name":993},"VUID-vkCmdClearColorImage-pRanges-01693",[995],{"type":22,"tag":23,"props":996,"children":997},{},[998,999,1003,1004,1009,1010,1016,1017,1023,1024,1029,1030,1035,1036,1039,1040,1045,1046,1050,1051,1056],{"type":27,"value":876},{"type":22,"tag":494,"props":1000,"children":1001},{"href":540},[1002],{"type":27,"value":543},{"type":27,"value":882},{"type":22,"tag":43,"props":1005,"children":1007},{"className":1006},[],[1008],{"type":27,"value":526},{"type":27,"value":889},{"type":22,"tag":43,"props":1011,"children":1013},{"className":1012},[],[1014],{"type":27,"value":1015},"layerCount",{"type":27,"value":897},{"type":22,"tag":43,"props":1018,"children":1020},{"className":1019},[],[1021],{"type":27,"value":1022},"VK_REMAINING_ARRAY_LAYERS",{"type":27,"value":905},{"type":22,"tag":43,"props":1025,"children":1027},{"className":1026},[],[1028],{"type":27,"value":961},{"type":27,"value":912},{"type":22,"tag":43,"props":1031,"children":1033},{"className":1032},[],[1034],{"type":27,"value":1015},{"type":27,"value":623},{"type":22,"tag":453,"props":1037,"children":1038},{"type":455},[],{"type":27,"value":923},{"type":22,"tag":43,"props":1041,"children":1043},{"className":1042},[],[1044],{"type":27,"value":978},{"type":27,"value":728},{"type":22,"tag":494,"props":1047,"children":1048},{"href":855},[1049],{"type":27,"value":858},{"type":27,"value":935},{"type":22,"tag":43,"props":1052,"children":1054},{"className":1053},[],[1055],{"type":27,"value":103},{"type":27,"value":942},{"type":22,"tag":577,"props":1058,"children":1060},{"name":1059},"VUID-vkCmdClearColorImage-image-00007",[1061],{"type":22,"tag":23,"props":1062,"children":1063},{},[1064,1069,1070,1073],{"type":22,"tag":43,"props":1065,"children":1067},{"className":1066},[],[1068],{"type":27,"value":103},{"type":27,"value":623},{"type":22,"tag":453,"props":1071,"children":1072},{"type":455},[],{"type":27,"value":1074}," not have a compressed or depth/stencil format",{"type":22,"tag":577,"props":1076,"children":1078},{"name":1077},"VUID-vkCmdClearColorImage-pColor-04961",[1079],{"type":22,"tag":23,"props":1080,"children":1081},{},[1082,1087,1088,1091,1093,1097],{"type":22,"tag":43,"props":1083,"children":1085},{"className":1084},[],[1086],{"type":27,"value":490},{"type":27,"value":623},{"type":22,"tag":453,"props":1089,"children":1090},{"type":455},[],{"type":27,"value":1092}," be a valid pointer to a ",{"type":22,"tag":494,"props":1094,"children":1095},{"href":496},[1096],{"type":27,"value":499},{"type":27,"value":1098}," union",{"type":22,"tag":577,"props":1100,"children":1102},{"name":1101},"VUID-vkCmdClearColorImage-image-09678",[1103],{"type":22,"tag":23,"props":1104,"children":1105},{},[1106,1107,1112,1114,1117],{"type":27,"value":683},{"type":22,"tag":43,"props":1108,"children":1110},{"className":1109},[],[1111],{"type":27,"value":103},{"type":27,"value":1113},"’s format has components other than R and G, it ",{"type":22,"tag":453,"props":1115,"children":1116},{"type":455},[],{"type":27,"value":1118}," not\nhave a 64-bit component width",{"type":22,"tag":572,"props":1120,"children":1122},{"name":1121},"Valid Usage (Implicit)",[1123,1149,1173,1198,1229,1253,1281,1295,1308,1332],{"type":22,"tag":577,"props":1124,"children":1126},{"name":1125},"VUID-vkCmdClearColorImage-commandBuffer-parameter",[1127],{"type":22,"tag":23,"props":1128,"children":1129},{},[1130,1135,1136,1139,1141,1147],{"type":22,"tag":43,"props":1131,"children":1133},{"className":1132},[],[1134],{"type":27,"value":84},{"type":27,"value":623},{"type":22,"tag":453,"props":1137,"children":1138},{"type":455},[],{"type":27,"value":1140}," be a valid ",{"type":22,"tag":494,"props":1142,"children":1144},{"href":1143},"/man/VkCommandBuffer",[1145],{"type":27,"value":1146},"VkCommandBuffer",{"type":27,"value":1148}," handle",{"type":22,"tag":577,"props":1150,"children":1152},{"name":1151},"VUID-vkCmdClearColorImage-image-parameter",[1153],{"type":22,"tag":23,"props":1154,"children":1155},{},[1156,1161,1162,1165,1166,1172],{"type":22,"tag":43,"props":1157,"children":1159},{"className":1158},[],[1160],{"type":27,"value":103},{"type":27,"value":623},{"type":22,"tag":453,"props":1163,"children":1164},{"type":455},[],{"type":27,"value":1140},{"type":22,"tag":494,"props":1167,"children":1169},{"href":1168},"/man/VkImage",[1170],{"type":27,"value":1171},"VkImage",{"type":27,"value":1148},{"type":22,"tag":577,"props":1174,"children":1176},{"name":1175},"VUID-vkCmdClearColorImage-imageLayout-parameter",[1177],{"type":22,"tag":23,"props":1178,"children":1179},{},[1180,1185,1186,1189,1190,1196],{"type":22,"tag":43,"props":1181,"children":1183},{"className":1182},[],[1184],{"type":27,"value":121},{"type":27,"value":623},{"type":22,"tag":453,"props":1187,"children":1188},{"type":455},[],{"type":27,"value":1140},{"type":22,"tag":494,"props":1191,"children":1193},{"href":1192},"/man/VkImageLayout",[1194],{"type":27,"value":1195},"VkImageLayout",{"type":27,"value":1197}," value",{"type":22,"tag":577,"props":1199,"children":1201},{"name":1200},"VUID-vkCmdClearColorImage-pRanges-parameter",[1202],{"type":22,"tag":23,"props":1203,"children":1204},{},[1205,1210,1211,1214,1216,1221,1223,1227],{"type":22,"tag":43,"props":1206,"children":1208},{"className":1207},[],[1209],{"type":27,"value":526},{"type":27,"value":623},{"type":22,"tag":453,"props":1212,"children":1213},{"type":455},[],{"type":27,"value":1215}," be a valid pointer to an array of ",{"type":22,"tag":43,"props":1217,"children":1219},{"className":1218},[],[1220],{"type":27,"value":518},{"type":27,"value":1222}," valid ",{"type":22,"tag":494,"props":1224,"children":1225},{"href":540},[1226],{"type":27,"value":543},{"type":27,"value":1228}," structures",{"type":22,"tag":577,"props":1230,"children":1232},{"name":1231},"VUID-vkCmdClearColorImage-commandBuffer-recording",[1233],{"type":22,"tag":23,"props":1234,"children":1235},{},[1236,1241,1242,1245,1247],{"type":22,"tag":43,"props":1237,"children":1239},{"className":1238},[],[1240],{"type":27,"value":84},{"type":27,"value":623},{"type":22,"tag":453,"props":1243,"children":1244},{"type":455},[],{"type":27,"value":1246}," be in the ",{"type":22,"tag":494,"props":1248,"children":1250},{"href":1249},"/chapters/commandbuffers#commandbuffers-lifecycle",[1251],{"type":27,"value":1252},"recording state",{"type":22,"tag":577,"props":1254,"children":1256},{"name":1255},"VUID-vkCmdClearColorImage-commandBuffer-cmdpool",[1257],{"type":22,"tag":23,"props":1258,"children":1259},{},[1260,1261,1267,1269,1274,1276,1279],{"type":27,"value":585},{"type":22,"tag":43,"props":1262,"children":1264},{"className":1263},[],[1265],{"type":27,"value":1266},"VkCommandPool",{"type":27,"value":1268}," that ",{"type":22,"tag":43,"props":1270,"children":1272},{"className":1271},[],[1273],{"type":27,"value":84},{"type":27,"value":1275}," was allocated from ",{"type":22,"tag":453,"props":1277,"children":1278},{"type":455},[],{"type":27,"value":1280}," support graphics, or compute operations",{"type":22,"tag":577,"props":1282,"children":1284},{"name":1283},"VUID-vkCmdClearColorImage-renderpass",[1285],{"type":22,"tag":23,"props":1286,"children":1287},{},[1288,1290,1293],{"type":27,"value":1289},"This command ",{"type":22,"tag":453,"props":1291,"children":1292},{"type":455},[],{"type":27,"value":1294}," only be called outside of a render pass instance",{"type":22,"tag":577,"props":1296,"children":1298},{"name":1297},"VUID-vkCmdClearColorImage-videocoding",[1299],{"type":22,"tag":23,"props":1300,"children":1301},{},[1302,1303,1306],{"type":27,"value":1289},{"type":22,"tag":453,"props":1304,"children":1305},{"type":455},[],{"type":27,"value":1307}," only be called outside of a video coding scope",{"type":22,"tag":577,"props":1309,"children":1311},{"name":1310},"VUID-vkCmdClearColorImage-rangeCount-arraylength",[1312],{"type":22,"tag":23,"props":1313,"children":1314},{},[1315,1320,1321,1324,1326],{"type":22,"tag":43,"props":1316,"children":1318},{"className":1317},[],[1319],{"type":27,"value":518},{"type":27,"value":623},{"type":22,"tag":453,"props":1322,"children":1323},{"type":455},[],{"type":27,"value":1325}," be greater than ",{"type":22,"tag":43,"props":1327,"children":1329},{"className":1328},[],[1330],{"type":27,"value":1331},"0",{"type":22,"tag":577,"props":1333,"children":1335},{"name":1334},"VUID-vkCmdClearColorImage-commonparent",[1336],{"type":22,"tag":23,"props":1337,"children":1338},{},[1339,1341,1346,1348,1353,1354,1357,1359],{"type":27,"value":1340},"Both of ",{"type":22,"tag":43,"props":1342,"children":1344},{"className":1343},[],[1345],{"type":27,"value":84},{"type":27,"value":1347},", and ",{"type":22,"tag":43,"props":1349,"children":1351},{"className":1350},[],[1352],{"type":27,"value":103},{"type":27,"value":623},{"type":22,"tag":453,"props":1355,"children":1356},{"type":455},[],{"type":27,"value":1358}," have been created, allocated, or retrieved from the same ",{"type":22,"tag":494,"props":1360,"children":1362},{"href":1361},"/man/VkDevice",[1363],{"type":27,"value":741},{"type":22,"tag":1365,"props":1366,"children":1368},"validity-box",{"name":1367},"Host Synchronization",[1369],{"type":22,"tag":418,"props":1370,"children":1371},{},[1372,1388],{"type":22,"tag":422,"props":1373,"children":1374},{},[1375,1377,1382,1383,1386],{"type":27,"value":1376},"Host access to ",{"type":22,"tag":43,"props":1378,"children":1380},{"className":1379},[],[1381],{"type":27,"value":84},{"type":27,"value":623},{"type":22,"tag":453,"props":1384,"children":1385},{"type":455},[],{"type":27,"value":1387}," be externally synchronized",{"type":22,"tag":422,"props":1389,"children":1390},{},[1391,1393,1398,1399,1404,1405,1408],{"type":27,"value":1392},"Host access to the ",{"type":22,"tag":43,"props":1394,"children":1396},{"className":1395},[],[1397],{"type":27,"value":1266},{"type":27,"value":1268},{"type":22,"tag":43,"props":1400,"children":1402},{"className":1401},[],[1403],{"type":27,"value":84},{"type":27,"value":1275},{"type":22,"tag":453,"props":1406,"children":1407},{"type":455},[],{"type":27,"value":1409}," be externally synchronized\n::",{"type":22,"tag":1411,"props":1412,"children":1413},"style",{},[1414],{"type":27,"value":1415},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":40,"searchDepth":72,"depth":72,"links":1417},[],"markdown",1725732598396]