[{"data":1,"prerenderedAt":802},["ShallowReactive",2],{"VLGHqKxKD6":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":801,"_id":4},"vkCmdBindShadingRateImageNV","Bind a shading rate image on a command buffer","VK_NV_shading_rate_image",[8,9],"primary","secondary","both",[12],"graphics",[14],"state","protos",[],{"type":18,"children":19,"toc":799},"root",[20,28,256,321,560,747,793],{"type":21,"tag":22,"props":23,"children":24},"element","p",{},[25],{"type":26,"value":27},"text","When shading rate image usage is enabled in the bound pipeline, the pipeline\nuses a shading rate image specified by the command:",{"type":21,"tag":29,"props":30,"children":31},"code-group",{},[32,126],{"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 vkCmdBindShadingRateImageNV(\n    VkCommandBuffer commandBuffer,\n    VkImageView imageView,\n    VkImageLayout imageLayout);\n","C","c","",[41],{"type":21,"tag":42,"props":43,"children":44},"code",{"__ignoreMap":39},[45,69,89,107],{"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}," vkCmdBindShadingRateImageNV",{"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},"    VkImageView ",{"type":21,"tag":46,"props":99,"children":100},{"style":80},[101],{"type":26,"value":102},"imageView",{"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":125},");\n",{"type":21,"tag":33,"props":127,"children":132},{"className":128,"code":129,"filename":130,"language":131,"meta":39,"style":39},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_bind_shading_rate_image_nv(\n    command_buffer: vk::CommandBuffer,\n    image_view: vk::ImageView,\n    image_layout: vk::ImageLayout,\n);\n","Rust","rs",[133],{"type":21,"tag":42,"props":134,"children":135},{"__ignoreMap":39},[136,158,190,219,248],{"type":21,"tag":46,"props":137,"children":138},{"class":48,"line":49},[139,144,149,154],{"type":21,"tag":46,"props":140,"children":141},{"style":53},[142],{"type":26,"value":143},"pub",{"type":21,"tag":46,"props":145,"children":146},{"style":53},[147],{"type":26,"value":148}," fn",{"type":21,"tag":46,"props":150,"children":151},{"style":59},[152],{"type":26,"value":153}," cmd_bind_shading_rate_image_nv",{"type":21,"tag":46,"props":155,"children":156},{"style":65},[157],{"type":26,"value":68},{"type":21,"tag":46,"props":159,"children":160},{"class":48,"line":71},[161,166,171,176,181,186],{"type":21,"tag":46,"props":162,"children":163},{"style":65},[164],{"type":26,"value":165},"    command_buffer",{"type":21,"tag":46,"props":167,"children":168},{"style":53},[169],{"type":26,"value":170},":",{"type":21,"tag":46,"props":172,"children":173},{"style":80},[174],{"type":26,"value":175}," vk",{"type":21,"tag":46,"props":177,"children":178},{"style":53},[179],{"type":26,"value":180},"::",{"type":21,"tag":46,"props":182,"children":183},{"style":80},[184],{"type":26,"value":185},"CommandBuffer",{"type":21,"tag":46,"props":187,"children":188},{"style":65},[189],{"type":26,"value":88},{"type":21,"tag":46,"props":191,"children":192},{"class":48,"line":91},[193,198,202,206,210,215],{"type":21,"tag":46,"props":194,"children":195},{"style":65},[196],{"type":26,"value":197},"    image_view",{"type":21,"tag":46,"props":199,"children":200},{"style":53},[201],{"type":26,"value":170},{"type":21,"tag":46,"props":203,"children":204},{"style":80},[205],{"type":26,"value":175},{"type":21,"tag":46,"props":207,"children":208},{"style":53},[209],{"type":26,"value":180},{"type":21,"tag":46,"props":211,"children":212},{"style":80},[213],{"type":26,"value":214},"ImageView",{"type":21,"tag":46,"props":216,"children":217},{"style":65},[218],{"type":26,"value":88},{"type":21,"tag":46,"props":220,"children":221},{"class":48,"line":109},[222,227,231,235,239,244],{"type":21,"tag":46,"props":223,"children":224},{"style":65},[225],{"type":26,"value":226},"    image_layout",{"type":21,"tag":46,"props":228,"children":229},{"style":53},[230],{"type":26,"value":170},{"type":21,"tag":46,"props":232,"children":233},{"style":80},[234],{"type":26,"value":175},{"type":21,"tag":46,"props":236,"children":237},{"style":53},[238],{"type":26,"value":180},{"type":21,"tag":46,"props":240,"children":241},{"style":80},[242],{"type":26,"value":243},"ImageLayout",{"type":21,"tag":46,"props":245,"children":246},{"style":65},[247],{"type":26,"value":88},{"type":21,"tag":46,"props":249,"children":251},{"class":48,"line":250},5,[252],{"type":21,"tag":46,"props":253,"children":254},{"style":65},[255],{"type":26,"value":125},{"type":21,"tag":257,"props":258,"children":259},"ul",{},[260,271,304],{"type":21,"tag":261,"props":262,"children":263},"li",{},[264,269],{"type":21,"tag":42,"props":265,"children":267},{"className":266},[],[268],{"type":26,"value":83},{"type":26,"value":270}," is the command buffer into which the command will be\nrecorded.",{"type":21,"tag":261,"props":272,"children":273},{},[274,279,281,286,288,293,295,302],{"type":21,"tag":42,"props":275,"children":277},{"className":276},[],[278],{"type":26,"value":102},{"type":26,"value":280}," is an image view handle specifying the shading rate\nimage.\n",{"type":21,"tag":42,"props":282,"children":284},{"className":283},[],[285],{"type":26,"value":102},{"type":26,"value":287}," ",{"type":21,"tag":289,"props":290,"children":292},"normative",{"type":291},"may",[],{"type":26,"value":294}," be ",{"type":21,"tag":296,"props":297,"children":299},"a",{"href":298},"/man/VK_NULL_HANDLE",[300],{"type":26,"value":301},"VK_NULL_HANDLE",{"type":26,"value":303},", which is equivalent to\nspecifying a view of an image filled with zero values.",{"type":21,"tag":261,"props":305,"children":306},{},[307,312,314,319],{"type":21,"tag":42,"props":308,"children":310},{"className":309},[],[311],{"type":26,"value":120},{"type":26,"value":313}," is the layout that the image subresources accessible\nfrom ",{"type":21,"tag":42,"props":315,"children":317},{"className":316},[],[318],{"type":26,"value":102},{"type":26,"value":320}," will be in when the shading rate image is accessed.",{"type":21,"tag":322,"props":323,"children":325},"validity-group",{"name":324},"Valid Usage",[326,354,403,433,471,517],{"type":21,"tag":327,"props":328,"children":330},"validity-field",{"name":329},"VUID-vkCmdBindShadingRateImageNV-None-02058",[331],{"type":21,"tag":22,"props":332,"children":333},{},[334,336,346,348,352],{"type":26,"value":335},"The ",{"type":21,"tag":296,"props":337,"children":339},{"href":338},"/man/VkPhysicalDeviceShadingRateImageFeaturesNV#features-shadingRateImage",[340],{"type":21,"tag":42,"props":341,"children":343},{"className":342},[],[344],{"type":26,"value":345},"shadingRateImage",{"type":26,"value":347}," feature ",{"type":21,"tag":289,"props":349,"children":351},{"type":350},"must",[],{"type":26,"value":353},"\nbe enabled",{"type":21,"tag":327,"props":355,"children":357},{"name":356},"VUID-vkCmdBindShadingRateImageNV-imageView-02059",[358],{"type":21,"tag":22,"props":359,"children":360},{},[361,363,368,370,374,376,379,381,387,389,395,397],{"type":26,"value":362},"If ",{"type":21,"tag":42,"props":364,"children":366},{"className":365},[],[367],{"type":26,"value":102},{"type":26,"value":369}," is not ",{"type":21,"tag":296,"props":371,"children":372},{"href":298},[373],{"type":26,"value":301},{"type":26,"value":375},", it ",{"type":21,"tag":289,"props":377,"children":378},{"type":350},[],{"type":26,"value":380}," be a valid\n",{"type":21,"tag":296,"props":382,"children":384},{"href":383},"/man/VkImageView",[385],{"type":26,"value":386},"VkImageView",{"type":26,"value":388}," handle of type ",{"type":21,"tag":42,"props":390,"children":392},{"className":391},[],[393],{"type":26,"value":394},"VK_IMAGE_VIEW_TYPE_2D",{"type":26,"value":396}," or\n",{"type":21,"tag":42,"props":398,"children":400},{"className":399},[],[401],{"type":26,"value":402},"VK_IMAGE_VIEW_TYPE_2D_ARRAY",{"type":21,"tag":327,"props":404,"children":406},{"name":405},"VUID-vkCmdBindShadingRateImageNV-imageView-02060",[407],{"type":21,"tag":22,"props":408,"children":409},{},[410,411,416,417,421,422,425,427],{"type":26,"value":362},{"type":21,"tag":42,"props":412,"children":414},{"className":413},[],[415],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":418,"children":419},{"href":298},[420],{"type":26,"value":301},{"type":26,"value":375},{"type":21,"tag":289,"props":423,"children":424},{"type":350},[],{"type":26,"value":426}," have a format\nof ",{"type":21,"tag":42,"props":428,"children":430},{"className":429},[],[431],{"type":26,"value":432},"VK_FORMAT_R8_UINT",{"type":21,"tag":327,"props":434,"children":436},{"name":435},"VUID-vkCmdBindShadingRateImageNV-imageView-02061",[437],{"type":21,"tag":22,"props":438,"children":439},{},[440,441,446,447,451,452,455,457,463,465],{"type":26,"value":362},{"type":21,"tag":42,"props":442,"children":444},{"className":443},[],[445],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":448,"children":449},{"href":298},[450],{"type":26,"value":301},{"type":26,"value":375},{"type":21,"tag":289,"props":453,"children":454},{"type":350},[],{"type":26,"value":456}," have been\ncreated with a ",{"type":21,"tag":42,"props":458,"children":460},{"className":459},[],[461],{"type":26,"value":462},"usage",{"type":26,"value":464}," value including\n",{"type":21,"tag":42,"props":466,"children":468},{"className":467},[],[469],{"type":26,"value":470},"VK_IMAGE_USAGE_SHADING_RATE_IMAGE_BIT_NV",{"type":21,"tag":327,"props":472,"children":474},{"name":473},"VUID-vkCmdBindShadingRateImageNV-imageView-02062",[475],{"type":21,"tag":22,"props":476,"children":477},{},[478,479,484,485,489,491,496,497,500,502,508,510,515],{"type":26,"value":362},{"type":21,"tag":42,"props":480,"children":482},{"className":481},[],[483],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":486,"children":487},{"href":298},[488],{"type":26,"value":301},{"type":26,"value":490},", ",{"type":21,"tag":42,"props":492,"children":494},{"className":493},[],[495],{"type":26,"value":120},{"type":26,"value":287},{"type":21,"tag":289,"props":498,"children":499},{"type":350},[],{"type":26,"value":501},"\nmatch the actual ",{"type":21,"tag":296,"props":503,"children":505},{"href":504},"/man/VkImageLayout",[506],{"type":26,"value":507},"VkImageLayout",{"type":26,"value":509}," of each subresource accessible from\n",{"type":21,"tag":42,"props":511,"children":513},{"className":512},[],[514],{"type":26,"value":102},{"type":26,"value":516}," at the time the subresource is accessed",{"type":21,"tag":327,"props":518,"children":520},{"name":519},"VUID-vkCmdBindShadingRateImageNV-imageLayout-02063",[521],{"type":21,"tag":22,"props":522,"children":523},{},[524,525,530,531,535,536,541,542,545,547,553,554],{"type":26,"value":362},{"type":21,"tag":42,"props":526,"children":528},{"className":527},[],[529],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":532,"children":533},{"href":298},[534],{"type":26,"value":301},{"type":26,"value":490},{"type":21,"tag":42,"props":537,"children":539},{"className":538},[],[540],{"type":26,"value":120},{"type":26,"value":287},{"type":21,"tag":289,"props":543,"children":544},{"type":350},[],{"type":26,"value":546},"\nbe ",{"type":21,"tag":42,"props":548,"children":550},{"className":549},[],[551],{"type":26,"value":552},"VK_IMAGE_LAYOUT_SHADING_RATE_OPTIMAL_NV",{"type":26,"value":396},{"type":21,"tag":42,"props":555,"children":557},{"className":556},[],[558],{"type":26,"value":559},"VK_IMAGE_LAYOUT_GENERAL",{"type":21,"tag":322,"props":561,"children":563},{"name":562},"Valid Usage (Implicit)",[564,590,624,647,671,699,713],{"type":21,"tag":327,"props":565,"children":567},{"name":566},"VUID-vkCmdBindShadingRateImageNV-commandBuffer-parameter",[568],{"type":21,"tag":22,"props":569,"children":570},{},[571,576,577,580,582,588],{"type":21,"tag":42,"props":572,"children":574},{"className":573},[],[575],{"type":26,"value":83},{"type":26,"value":287},{"type":21,"tag":289,"props":578,"children":579},{"type":350},[],{"type":26,"value":581}," be a valid ",{"type":21,"tag":296,"props":583,"children":585},{"href":584},"/man/VkCommandBuffer",[586],{"type":26,"value":587},"VkCommandBuffer",{"type":26,"value":589}," handle",{"type":21,"tag":327,"props":591,"children":593},{"name":592},"VUID-vkCmdBindShadingRateImageNV-imageView-parameter",[594],{"type":21,"tag":22,"props":595,"children":596},{},[597,598,603,604,608,609,614,615,618,619,623],{"type":26,"value":362},{"type":21,"tag":42,"props":599,"children":601},{"className":600},[],[602],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":605,"children":606},{"href":298},[607],{"type":26,"value":301},{"type":26,"value":490},{"type":21,"tag":42,"props":610,"children":612},{"className":611},[],[613],{"type":26,"value":102},{"type":26,"value":287},{"type":21,"tag":289,"props":616,"children":617},{"type":350},[],{"type":26,"value":581},{"type":21,"tag":296,"props":620,"children":621},{"href":383},[622],{"type":26,"value":386},{"type":26,"value":589},{"type":21,"tag":327,"props":625,"children":627},{"name":626},"VUID-vkCmdBindShadingRateImageNV-imageLayout-parameter",[628],{"type":21,"tag":22,"props":629,"children":630},{},[631,636,637,640,641,645],{"type":21,"tag":42,"props":632,"children":634},{"className":633},[],[635],{"type":26,"value":120},{"type":26,"value":287},{"type":21,"tag":289,"props":638,"children":639},{"type":350},[],{"type":26,"value":581},{"type":21,"tag":296,"props":642,"children":643},{"href":504},[644],{"type":26,"value":507},{"type":26,"value":646}," value",{"type":21,"tag":327,"props":648,"children":650},{"name":649},"VUID-vkCmdBindShadingRateImageNV-commandBuffer-recording",[651],{"type":21,"tag":22,"props":652,"children":653},{},[654,659,660,663,665],{"type":21,"tag":42,"props":655,"children":657},{"className":656},[],[658],{"type":26,"value":83},{"type":26,"value":287},{"type":21,"tag":289,"props":661,"children":662},{"type":350},[],{"type":26,"value":664}," be in the ",{"type":21,"tag":296,"props":666,"children":668},{"href":667},"/chapters/commandbuffers#commandbuffers-lifecycle",[669],{"type":26,"value":670},"recording state",{"type":21,"tag":327,"props":672,"children":674},{"name":673},"VUID-vkCmdBindShadingRateImageNV-commandBuffer-cmdpool",[675],{"type":21,"tag":22,"props":676,"children":677},{},[678,679,685,687,692,694,697],{"type":26,"value":335},{"type":21,"tag":42,"props":680,"children":682},{"className":681},[],[683],{"type":26,"value":684},"VkCommandPool",{"type":26,"value":686}," that ",{"type":21,"tag":42,"props":688,"children":690},{"className":689},[],[691],{"type":26,"value":83},{"type":26,"value":693}," was allocated from ",{"type":21,"tag":289,"props":695,"children":696},{"type":350},[],{"type":26,"value":698}," support graphics operations",{"type":21,"tag":327,"props":700,"children":702},{"name":701},"VUID-vkCmdBindShadingRateImageNV-videocoding",[703],{"type":21,"tag":22,"props":704,"children":705},{},[706,708,711],{"type":26,"value":707},"This command ",{"type":21,"tag":289,"props":709,"children":710},{"type":350},[],{"type":26,"value":712}," only be called outside of a video coding scope",{"type":21,"tag":327,"props":714,"children":716},{"name":715},"VUID-vkCmdBindShadingRateImageNV-commonparent",[717],{"type":21,"tag":22,"props":718,"children":719},{},[720,722,727,729,734,736,739,741],{"type":26,"value":721},"Both of ",{"type":21,"tag":42,"props":723,"children":725},{"className":724},[],[726],{"type":26,"value":83},{"type":26,"value":728},", and ",{"type":21,"tag":42,"props":730,"children":732},{"className":731},[],[733],{"type":26,"value":102},{"type":26,"value":735}," that are valid handles of non-ignored parameters ",{"type":21,"tag":289,"props":737,"children":738},{"type":350},[],{"type":26,"value":740}," have been created, allocated, or retrieved from the same ",{"type":21,"tag":296,"props":742,"children":744},{"href":743},"/man/VkDevice",[745],{"type":26,"value":746},"VkDevice",{"type":21,"tag":748,"props":749,"children":751},"validity-box",{"name":750},"Host Synchronization",[752],{"type":21,"tag":257,"props":753,"children":754},{},[755,771],{"type":21,"tag":261,"props":756,"children":757},{},[758,760,765,766,769],{"type":26,"value":759},"Host access to ",{"type":21,"tag":42,"props":761,"children":763},{"className":762},[],[764],{"type":26,"value":83},{"type":26,"value":287},{"type":21,"tag":289,"props":767,"children":768},{"type":350},[],{"type":26,"value":770}," be externally synchronized",{"type":21,"tag":261,"props":772,"children":773},{},[774,776,781,782,787,788,791],{"type":26,"value":775},"Host access to the ",{"type":21,"tag":42,"props":777,"children":779},{"className":778},[],[780],{"type":26,"value":684},{"type":26,"value":686},{"type":21,"tag":42,"props":783,"children":785},{"className":784},[],[786],{"type":26,"value":83},{"type":26,"value":693},{"type":21,"tag":289,"props":789,"children":790},{"type":350},[],{"type":26,"value":792}," be externally synchronized\n::",{"type":21,"tag":794,"props":795,"children":796},"style",{},[797],{"type":26,"value":798},"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":800},[],"markdown",1729612491960]