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