[{"data":1,"prerenderedAt":523},["ShallowReactive",2],{"KqTu1rrLC8":3},{"title":4,"description":5,"parent":6,"cmd_buf_level":7,"render_pass_scope":9,"supported_queue_types":10,"tasks":12,"type":16,"xrefs":17,"body":18,"_type":522,"_id":4},"vkCmdNextSubpass","Transition to the next subpass of a render pass","VK_VERSION_1_0",[8],"primary","inside",[11],"graphics",[13,14,15],"action","state","synchronization","protos",[],{"type":19,"children":20,"toc":520},"root",[21,29,210,244,263,275,310,468,514],{"type":22,"tag":23,"props":24,"children":25},"element","p",{},[26],{"type":27,"value":28},"text","To transition to the next subpass in the render pass instance after\nrecording the commands for a subpass, call:",{"type":22,"tag":30,"props":31,"children":32},"code-group",{},[33,109],{"type":22,"tag":34,"props":35,"children":41},"pre",{"className":36,"code":37,"filename":38,"language":39,"meta":40,"style":40},"language-c shiki shiki-themes github-light-default github-dark-default","void vkCmdNextSubpass(\n    VkCommandBuffer commandBuffer,\n    VkSubpassContents contents);\n","C","c","",[42],{"type":22,"tag":43,"props":44,"children":45},"code",{"__ignoreMap":40},[46,70,90],{"type":22,"tag":47,"props":48,"children":51},"span",{"class":49,"line":50},"line",1,[52,58,64],{"type":22,"tag":47,"props":53,"children":55},{"style":54},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[56],{"type":27,"value":57},"void",{"type":22,"tag":47,"props":59,"children":61},{"style":60},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[62],{"type":27,"value":63}," vkCmdNextSubpass",{"type":22,"tag":47,"props":65,"children":67},{"style":66},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[68],{"type":27,"value":69},"(\n",{"type":22,"tag":47,"props":71,"children":73},{"class":49,"line":72},2,[74,79,85],{"type":22,"tag":47,"props":75,"children":76},{"style":66},[77],{"type":27,"value":78},"    VkCommandBuffer ",{"type":22,"tag":47,"props":80,"children":82},{"style":81},"--shiki-default:#953800;--shiki-dark:#FFA657",[83],{"type":27,"value":84},"commandBuffer",{"type":22,"tag":47,"props":86,"children":87},{"style":66},[88],{"type":27,"value":89},",\n",{"type":22,"tag":47,"props":91,"children":93},{"class":49,"line":92},3,[94,99,104],{"type":22,"tag":47,"props":95,"children":96},{"style":66},[97],{"type":27,"value":98},"    VkSubpassContents ",{"type":22,"tag":47,"props":100,"children":101},{"style":81},[102],{"type":27,"value":103},"contents",{"type":22,"tag":47,"props":105,"children":106},{"style":66},[107],{"type":27,"value":108},");\n",{"type":22,"tag":34,"props":110,"children":115},{"className":111,"code":112,"filename":113,"language":114,"meta":40,"style":40},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_next_subpass(\n    command_buffer: vk::CommandBuffer,\n    contents: vk::SubpassContents,\n);\n","Rust","rs",[116],{"type":22,"tag":43,"props":117,"children":118},{"__ignoreMap":40},[119,141,173,202],{"type":22,"tag":47,"props":120,"children":121},{"class":49,"line":50},[122,127,132,137],{"type":22,"tag":47,"props":123,"children":124},{"style":54},[125],{"type":27,"value":126},"pub",{"type":22,"tag":47,"props":128,"children":129},{"style":54},[130],{"type":27,"value":131}," fn",{"type":22,"tag":47,"props":133,"children":134},{"style":60},[135],{"type":27,"value":136}," cmd_next_subpass",{"type":22,"tag":47,"props":138,"children":139},{"style":66},[140],{"type":27,"value":69},{"type":22,"tag":47,"props":142,"children":143},{"class":49,"line":72},[144,149,154,159,164,169],{"type":22,"tag":47,"props":145,"children":146},{"style":66},[147],{"type":27,"value":148},"    command_buffer",{"type":22,"tag":47,"props":150,"children":151},{"style":54},[152],{"type":27,"value":153},":",{"type":22,"tag":47,"props":155,"children":156},{"style":81},[157],{"type":27,"value":158}," vk",{"type":22,"tag":47,"props":160,"children":161},{"style":54},[162],{"type":27,"value":163},"::",{"type":22,"tag":47,"props":165,"children":166},{"style":81},[167],{"type":27,"value":168},"CommandBuffer",{"type":22,"tag":47,"props":170,"children":171},{"style":66},[172],{"type":27,"value":89},{"type":22,"tag":47,"props":174,"children":175},{"class":49,"line":92},[176,181,185,189,193,198],{"type":22,"tag":47,"props":177,"children":178},{"style":66},[179],{"type":27,"value":180},"    contents",{"type":22,"tag":47,"props":182,"children":183},{"style":54},[184],{"type":27,"value":153},{"type":22,"tag":47,"props":186,"children":187},{"style":81},[188],{"type":27,"value":158},{"type":22,"tag":47,"props":190,"children":191},{"style":54},[192],{"type":27,"value":163},{"type":22,"tag":47,"props":194,"children":195},{"style":81},[196],{"type":27,"value":197},"SubpassContents",{"type":22,"tag":47,"props":199,"children":200},{"style":66},[201],{"type":27,"value":89},{"type":22,"tag":47,"props":203,"children":205},{"class":49,"line":204},4,[206],{"type":22,"tag":47,"props":207,"children":208},{"style":66},[209],{"type":27,"value":108},{"type":22,"tag":211,"props":212,"children":213},"ul",{},[214,225],{"type":22,"tag":215,"props":216,"children":217},"li",{},[218,223],{"type":22,"tag":43,"props":219,"children":221},{"className":220},[],[222],{"type":27,"value":84},{"type":27,"value":224}," is the command buffer in which to record the\ncommand.",{"type":22,"tag":215,"props":226,"children":227},{},[228,233,235,242],{"type":22,"tag":43,"props":229,"children":231},{"className":230},[],[232],{"type":27,"value":103},{"type":27,"value":234}," specifies how the commands in the next subpass will be\nprovided, in the same fashion as the corresponding parameter of\n",{"type":22,"tag":236,"props":237,"children":239},"a",{"href":238},"/man/vkCmdBeginRenderPass",[240],{"type":27,"value":241},"vkCmdBeginRenderPass",{"type":27,"value":243},".",{"type":22,"tag":23,"props":245,"children":246},{},[247,249,254,256,261],{"type":27,"value":248},"The subpass index for a render pass begins at zero when\n",{"type":22,"tag":43,"props":250,"children":252},{"className":251},[],[253],{"type":27,"value":241},{"type":27,"value":255}," is recorded, and increments each time\n",{"type":22,"tag":43,"props":257,"children":259},{"className":258},[],[260],{"type":27,"value":4},{"type":27,"value":262}," is recorded.",{"type":22,"tag":23,"props":264,"children":265},{},[266,268,273],{"type":27,"value":267},"After transitioning to the next subpass, the application ",{"type":22,"tag":269,"props":270,"children":272},"normative",{"type":271},"can",[],{"type":27,"value":274}," record the\ncommands for that subpass.",{"type":22,"tag":276,"props":277,"children":279},"validity-group",{"name":278},"Valid Usage",[280,296],{"type":22,"tag":281,"props":282,"children":284},"validity-field",{"name":283},"VUID-vkCmdNextSubpass-None-00909",[285],{"type":22,"tag":23,"props":286,"children":287},{},[288,290,294],{"type":27,"value":289},"The current subpass index ",{"type":22,"tag":269,"props":291,"children":293},{"type":292},"must",[],{"type":27,"value":295}," be less than the number of subpasses in\nthe render pass minus one",{"type":22,"tag":281,"props":297,"children":299},{"name":298},"VUID-vkCmdNextSubpass-None-02349",[300],{"type":22,"tag":23,"props":301,"children":302},{},[303,305,308],{"type":27,"value":304},"This command ",{"type":22,"tag":269,"props":306,"children":307},{"type":292},[],{"type":27,"value":309}," not be recorded when transform feedback is active",{"type":22,"tag":276,"props":311,"children":313},{"name":312},"Valid Usage (Implicit)",[314,341,366,390,419,432,445],{"type":22,"tag":281,"props":315,"children":317},{"name":316},"VUID-vkCmdNextSubpass-commandBuffer-parameter",[318],{"type":22,"tag":23,"props":319,"children":320},{},[321,326,328,331,333,339],{"type":22,"tag":43,"props":322,"children":324},{"className":323},[],[325],{"type":27,"value":84},{"type":27,"value":327}," ",{"type":22,"tag":269,"props":329,"children":330},{"type":292},[],{"type":27,"value":332}," be a valid ",{"type":22,"tag":236,"props":334,"children":336},{"href":335},"/man/VkCommandBuffer",[337],{"type":27,"value":338},"VkCommandBuffer",{"type":27,"value":340}," handle",{"type":22,"tag":281,"props":342,"children":344},{"name":343},"VUID-vkCmdNextSubpass-contents-parameter",[345],{"type":22,"tag":23,"props":346,"children":347},{},[348,353,354,357,358,364],{"type":22,"tag":43,"props":349,"children":351},{"className":350},[],[352],{"type":27,"value":103},{"type":27,"value":327},{"type":22,"tag":269,"props":355,"children":356},{"type":292},[],{"type":27,"value":332},{"type":22,"tag":236,"props":359,"children":361},{"href":360},"/man/VkSubpassContents",[362],{"type":27,"value":363},"VkSubpassContents",{"type":27,"value":365}," value",{"type":22,"tag":281,"props":367,"children":369},{"name":368},"VUID-vkCmdNextSubpass-commandBuffer-recording",[370],{"type":22,"tag":23,"props":371,"children":372},{},[373,378,379,382,384],{"type":22,"tag":43,"props":374,"children":376},{"className":375},[],[377],{"type":27,"value":84},{"type":27,"value":327},{"type":22,"tag":269,"props":380,"children":381},{"type":292},[],{"type":27,"value":383}," be in the ",{"type":22,"tag":236,"props":385,"children":387},{"href":386},"/chapters/commandbuffers#commandbuffers-lifecycle",[388],{"type":27,"value":389},"recording state",{"type":22,"tag":281,"props":391,"children":393},{"name":392},"VUID-vkCmdNextSubpass-commandBuffer-cmdpool",[394],{"type":22,"tag":23,"props":395,"children":396},{},[397,399,405,407,412,414,417],{"type":27,"value":398},"The ",{"type":22,"tag":43,"props":400,"children":402},{"className":401},[],[403],{"type":27,"value":404},"VkCommandPool",{"type":27,"value":406}," that ",{"type":22,"tag":43,"props":408,"children":410},{"className":409},[],[411],{"type":27,"value":84},{"type":27,"value":413}," was allocated from ",{"type":22,"tag":269,"props":415,"children":416},{"type":292},[],{"type":27,"value":418}," support graphics operations",{"type":22,"tag":281,"props":420,"children":422},{"name":421},"VUID-vkCmdNextSubpass-renderpass",[423],{"type":22,"tag":23,"props":424,"children":425},{},[426,427,430],{"type":27,"value":304},{"type":22,"tag":269,"props":428,"children":429},{"type":292},[],{"type":27,"value":431}," only be called inside of a render pass instance",{"type":22,"tag":281,"props":433,"children":435},{"name":434},"VUID-vkCmdNextSubpass-videocoding",[436],{"type":22,"tag":23,"props":437,"children":438},{},[439,440,443],{"type":27,"value":304},{"type":22,"tag":269,"props":441,"children":442},{"type":292},[],{"type":27,"value":444}," only be called outside of a video coding scope",{"type":22,"tag":281,"props":446,"children":448},{"name":447},"VUID-vkCmdNextSubpass-bufferlevel",[449],{"type":22,"tag":23,"props":450,"children":451},{},[452,457,458,461,463],{"type":22,"tag":43,"props":453,"children":455},{"className":454},[],[456],{"type":27,"value":84},{"type":27,"value":327},{"type":22,"tag":269,"props":459,"children":460},{"type":292},[],{"type":27,"value":462}," be a primary ",{"type":22,"tag":43,"props":464,"children":466},{"className":465},[],[467],{"type":27,"value":338},{"type":22,"tag":469,"props":470,"children":472},"validity-box",{"name":471},"Host Synchronization",[473],{"type":22,"tag":211,"props":474,"children":475},{},[476,492],{"type":22,"tag":215,"props":477,"children":478},{},[479,481,486,487,490],{"type":27,"value":480},"Host access to ",{"type":22,"tag":43,"props":482,"children":484},{"className":483},[],[485],{"type":27,"value":84},{"type":27,"value":327},{"type":22,"tag":269,"props":488,"children":489},{"type":292},[],{"type":27,"value":491}," be externally synchronized",{"type":22,"tag":215,"props":493,"children":494},{},[495,497,502,503,508,509,512],{"type":27,"value":496},"Host access to the ",{"type":22,"tag":43,"props":498,"children":500},{"className":499},[],[501],{"type":27,"value":404},{"type":27,"value":406},{"type":22,"tag":43,"props":504,"children":506},{"className":505},[],[507],{"type":27,"value":84},{"type":27,"value":413},{"type":22,"tag":269,"props":510,"children":511},{"type":292},[],{"type":27,"value":513}," be externally synchronized\n::",{"type":22,"tag":515,"props":516,"children":517},"style",{},[518],{"type":27,"value":519},"html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":40,"searchDepth":72,"depth":72,"links":521},[],"markdown",1725732606630]