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