[{"data":1,"prerenderedAt":841},["ShallowReactive",2],{"DgRfK4gU0g":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":840,"_id":4},"vkCmdBindInvocationMaskHUAWEI","Bind an invocation mask image on a command buffer","VK_HUAWEI_invocation_mask",[8,9],"primary","secondary","outside",[12],"compute",[14],"state","protos",[],{"type":18,"children":19,"toc":838},"root",[20,28,256,321,584,786,832],{"type":21,"tag":22,"props":23,"children":24},"element","p",{},[25],{"type":26,"value":27},"text","When invocation mask image usage is enabled in the bound ray tracing\npipeline, the pipeline uses an invocation mask image specified by the\ncommand:",{"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 vkCmdBindInvocationMaskHUAWEI(\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}," vkCmdBindInvocationMaskHUAWEI",{"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_invocation_mask_huawei(\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_invocation_mask_huawei",{"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 invocation mask\nimage ",{"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\nto specifying a view of an image filled with ones value.",{"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 invocation mask image is\naccessed",{"type":21,"tag":322,"props":323,"children":325},"validity-group",{"name":324},"Valid Usage",[326,354,395,425,457,494,530,560],{"type":21,"tag":327,"props":328,"children":330},"validity-field",{"name":329},"VUID-vkCmdBindInvocationMaskHUAWEI-None-04976",[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/VkPhysicalDeviceInvocationMaskFeaturesHUAWEI#features-invocationMask",[340],{"type":21,"tag":42,"props":341,"children":343},{"className":342},[],[344],{"type":26,"value":345},"invocationMask",{"type":26,"value":347}," feature ",{"type":21,"tag":289,"props":349,"children":351},{"type":350},"must",[],{"type":26,"value":353}," be\nenabled",{"type":21,"tag":327,"props":355,"children":357},{"name":356},"VUID-vkCmdBindInvocationMaskHUAWEI-imageView-04977",[358],{"type":21,"tag":22,"props":359,"children":360},{},[361,363,368,370,374,376,379,381,387,389],{"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":21,"tag":327,"props":396,"children":398},{"name":397},"VUID-vkCmdBindInvocationMaskHUAWEI-imageView-04978",[399],{"type":21,"tag":22,"props":400,"children":401},{},[402,403,408,409,413,414,417,419],{"type":26,"value":362},{"type":21,"tag":42,"props":404,"children":406},{"className":405},[],[407],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":410,"children":411},{"href":298},[412],{"type":26,"value":301},{"type":26,"value":375},{"type":21,"tag":289,"props":415,"children":416},{"type":350},[],{"type":26,"value":418}," have a format\nof ",{"type":21,"tag":42,"props":420,"children":422},{"className":421},[],[423],{"type":26,"value":424},"VK_FORMAT_R8_UINT",{"type":21,"tag":327,"props":426,"children":428},{"name":427},"VUID-vkCmdBindInvocationMaskHUAWEI-imageView-04979",[429],{"type":21,"tag":22,"props":430,"children":431},{},[432,433,438,439,443,444,447,449,455],{"type":26,"value":362},{"type":21,"tag":42,"props":434,"children":436},{"className":435},[],[437],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":440,"children":441},{"href":298},[442],{"type":26,"value":301},{"type":26,"value":375},{"type":21,"tag":289,"props":445,"children":446},{"type":350},[],{"type":26,"value":448}," have been\ncreated with ",{"type":21,"tag":42,"props":450,"children":452},{"className":451},[],[453],{"type":26,"value":454},"VK_IMAGE_USAGE_INVOCATION_MASK_BIT_HUAWEI",{"type":26,"value":456}," set",{"type":21,"tag":327,"props":458,"children":460},{"name":459},"VUID-vkCmdBindInvocationMaskHUAWEI-imageView-04980",[461],{"type":21,"tag":22,"props":462,"children":463},{},[464,465,470,471,475,477,482,483,486,488],{"type":26,"value":362},{"type":21,"tag":42,"props":466,"children":468},{"className":467},[],[469],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":472,"children":473},{"href":298},[474],{"type":26,"value":301},{"type":26,"value":476},", ",{"type":21,"tag":42,"props":478,"children":480},{"className":479},[],[481],{"type":26,"value":120},{"type":26,"value":287},{"type":21,"tag":289,"props":484,"children":485},{"type":350},[],{"type":26,"value":487},"\nbe ",{"type":21,"tag":42,"props":489,"children":491},{"className":490},[],[492],{"type":26,"value":493},"VK_IMAGE_LAYOUT_GENERAL",{"type":21,"tag":327,"props":495,"children":497},{"name":496},"VUID-vkCmdBindInvocationMaskHUAWEI-width-04981",[498],{"type":21,"tag":22,"props":499,"children":500},{},[501,503,506,508,514,516,522,524],{"type":26,"value":502},"Thread mask image resolution ",{"type":21,"tag":289,"props":504,"children":505},{"type":350},[],{"type":26,"value":507}," match the ",{"type":21,"tag":42,"props":509,"children":511},{"className":510},[],[512],{"type":26,"value":513},"width",{"type":26,"value":515}," and\n",{"type":21,"tag":42,"props":517,"children":519},{"className":518},[],[520],{"type":26,"value":521},"height",{"type":26,"value":523}," in ",{"type":21,"tag":296,"props":525,"children":527},{"href":526},"/man/vkCmdTraceRaysKHR",[528],{"type":26,"value":529},"vkCmdTraceRaysKHR",{"type":21,"tag":327,"props":531,"children":533},{"name":532},"VUID-vkCmdBindInvocationMaskHUAWEI-None-04982",[534],{"type":21,"tag":22,"props":535,"children":536},{},[537,539,542,544,550,552,558],{"type":26,"value":538},"Each element in the invocation mask image ",{"type":21,"tag":289,"props":540,"children":541},{"type":350},[],{"type":26,"value":543}," have the value ",{"type":21,"tag":42,"props":545,"children":547},{"className":546},[],[548],{"type":26,"value":549},"0",{"type":26,"value":551}," or\n",{"type":21,"tag":42,"props":553,"children":555},{"className":554},[],[556],{"type":26,"value":557},"1",{"type":26,"value":559},".\nThe value 1 means the invocation is active",{"type":21,"tag":327,"props":561,"children":563},{"name":562},"VUID-vkCmdBindInvocationMaskHUAWEI-depth-04983",[564],{"type":21,"tag":22,"props":565,"children":566},{},[567,573,574,578,579,582],{"type":21,"tag":42,"props":568,"children":570},{"className":569},[],[571],{"type":26,"value":572},"depth",{"type":26,"value":523},{"type":21,"tag":296,"props":575,"children":576},{"href":526},[577],{"type":26,"value":529},{"type":26,"value":287},{"type":21,"tag":289,"props":580,"children":581},{"type":350},[],{"type":26,"value":583}," be 1",{"type":21,"tag":322,"props":585,"children":587},{"name":586},"Valid Usage (Implicit)",[588,614,648,673,697,725,739,752],{"type":21,"tag":327,"props":589,"children":591},{"name":590},"VUID-vkCmdBindInvocationMaskHUAWEI-commandBuffer-parameter",[592],{"type":21,"tag":22,"props":593,"children":594},{},[595,600,601,604,606,612],{"type":21,"tag":42,"props":596,"children":598},{"className":597},[],[599],{"type":26,"value":83},{"type":26,"value":287},{"type":21,"tag":289,"props":602,"children":603},{"type":350},[],{"type":26,"value":605}," be a valid ",{"type":21,"tag":296,"props":607,"children":609},{"href":608},"/man/VkCommandBuffer",[610],{"type":26,"value":611},"VkCommandBuffer",{"type":26,"value":613}," handle",{"type":21,"tag":327,"props":615,"children":617},{"name":616},"VUID-vkCmdBindInvocationMaskHUAWEI-imageView-parameter",[618],{"type":21,"tag":22,"props":619,"children":620},{},[621,622,627,628,632,633,638,639,642,643,647],{"type":26,"value":362},{"type":21,"tag":42,"props":623,"children":625},{"className":624},[],[626],{"type":26,"value":102},{"type":26,"value":369},{"type":21,"tag":296,"props":629,"children":630},{"href":298},[631],{"type":26,"value":301},{"type":26,"value":476},{"type":21,"tag":42,"props":634,"children":636},{"className":635},[],[637],{"type":26,"value":102},{"type":26,"value":287},{"type":21,"tag":289,"props":640,"children":641},{"type":350},[],{"type":26,"value":605},{"type":21,"tag":296,"props":644,"children":645},{"href":383},[646],{"type":26,"value":386},{"type":26,"value":613},{"type":21,"tag":327,"props":649,"children":651},{"name":650},"VUID-vkCmdBindInvocationMaskHUAWEI-imageLayout-parameter",[652],{"type":21,"tag":22,"props":653,"children":654},{},[655,660,661,664,665,671],{"type":21,"tag":42,"props":656,"children":658},{"className":657},[],[659],{"type":26,"value":120},{"type":26,"value":287},{"type":21,"tag":289,"props":662,"children":663},{"type":350},[],{"type":26,"value":605},{"type":21,"tag":296,"props":666,"children":668},{"href":667},"/man/VkImageLayout",[669],{"type":26,"value":670},"VkImageLayout",{"type":26,"value":672}," value",{"type":21,"tag":327,"props":674,"children":676},{"name":675},"VUID-vkCmdBindInvocationMaskHUAWEI-commandBuffer-recording",[677],{"type":21,"tag":22,"props":678,"children":679},{},[680,685,686,689,691],{"type":21,"tag":42,"props":681,"children":683},{"className":682},[],[684],{"type":26,"value":83},{"type":26,"value":287},{"type":21,"tag":289,"props":687,"children":688},{"type":350},[],{"type":26,"value":690}," be in the ",{"type":21,"tag":296,"props":692,"children":694},{"href":693},"/chapters/commandbuffers#commandbuffers-lifecycle",[695],{"type":26,"value":696},"recording state",{"type":21,"tag":327,"props":698,"children":700},{"name":699},"VUID-vkCmdBindInvocationMaskHUAWEI-commandBuffer-cmdpool",[701],{"type":21,"tag":22,"props":702,"children":703},{},[704,705,711,713,718,720,723],{"type":26,"value":335},{"type":21,"tag":42,"props":706,"children":708},{"className":707},[],[709],{"type":26,"value":710},"VkCommandPool",{"type":26,"value":712}," that ",{"type":21,"tag":42,"props":714,"children":716},{"className":715},[],[717],{"type":26,"value":83},{"type":26,"value":719}," was allocated from ",{"type":21,"tag":289,"props":721,"children":722},{"type":350},[],{"type":26,"value":724}," support compute operations",{"type":21,"tag":327,"props":726,"children":728},{"name":727},"VUID-vkCmdBindInvocationMaskHUAWEI-renderpass",[729],{"type":21,"tag":22,"props":730,"children":731},{},[732,734,737],{"type":26,"value":733},"This command ",{"type":21,"tag":289,"props":735,"children":736},{"type":350},[],{"type":26,"value":738}," only be called outside of a render pass instance",{"type":21,"tag":327,"props":740,"children":742},{"name":741},"VUID-vkCmdBindInvocationMaskHUAWEI-videocoding",[743],{"type":21,"tag":22,"props":744,"children":745},{},[746,747,750],{"type":26,"value":733},{"type":21,"tag":289,"props":748,"children":749},{"type":350},[],{"type":26,"value":751}," only be called outside of a video coding scope",{"type":21,"tag":327,"props":753,"children":755},{"name":754},"VUID-vkCmdBindInvocationMaskHUAWEI-commonparent",[756],{"type":21,"tag":22,"props":757,"children":758},{},[759,761,766,768,773,775,778,780],{"type":26,"value":760},"Both of ",{"type":21,"tag":42,"props":762,"children":764},{"className":763},[],[765],{"type":26,"value":83},{"type":26,"value":767},", and ",{"type":21,"tag":42,"props":769,"children":771},{"className":770},[],[772],{"type":26,"value":102},{"type":26,"value":774}," that are valid handles of non-ignored parameters ",{"type":21,"tag":289,"props":776,"children":777},{"type":350},[],{"type":26,"value":779}," have been created, allocated, or retrieved from the same ",{"type":21,"tag":296,"props":781,"children":783},{"href":782},"/man/VkDevice",[784],{"type":26,"value":785},"VkDevice",{"type":21,"tag":787,"props":788,"children":790},"validity-box",{"name":789},"Host Synchronization",[791],{"type":21,"tag":257,"props":792,"children":793},{},[794,810],{"type":21,"tag":261,"props":795,"children":796},{},[797,799,804,805,808],{"type":26,"value":798},"Host access to ",{"type":21,"tag":42,"props":800,"children":802},{"className":801},[],[803],{"type":26,"value":83},{"type":26,"value":287},{"type":21,"tag":289,"props":806,"children":807},{"type":350},[],{"type":26,"value":809}," be externally synchronized",{"type":21,"tag":261,"props":811,"children":812},{},[813,815,820,821,826,827,830],{"type":26,"value":814},"Host access to the ",{"type":21,"tag":42,"props":816,"children":818},{"className":817},[],[819],{"type":26,"value":710},{"type":26,"value":712},{"type":21,"tag":42,"props":822,"children":824},{"className":823},[],[825],{"type":26,"value":83},{"type":26,"value":719},{"type":21,"tag":289,"props":828,"children":829},{"type":350},[],{"type":26,"value":831}," be externally synchronized\n::",{"type":21,"tag":833,"props":834,"children":835},"style",{},[836],{"type":26,"value":837},"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":839},[],"markdown",1729612491893]