[{"data":1,"prerenderedAt":592},["ShallowReactive",2],{"Rc2odjIaV4":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":591,"_id":4},"vkCmdSetRenderingAttachmentLocations","Set color attachment location mappings for a command buffer","VK_VERSION_1_4","protos",[],{"type":10,"children":11,"toc":589},"root",[12,20,216,251,283,317,403,537,583],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17],{"type":18,"value":19},"text","To set the fragment output location mappings during rendering, call:",{"type":13,"tag":21,"props":22,"children":23},"code-group",{},[24,110],{"type":13,"tag":25,"props":26,"children":32},"pre",{"className":27,"code":28,"filename":29,"language":30,"meta":31,"style":31},"language-c shiki shiki-themes github-light-default github-dark-default","void vkCmdSetRenderingAttachmentLocationsKHR(\n    VkCommandBuffer commandBuffer,\n    const VkRenderingAttachmentLocationInfo* pLocationInfo);\n","C","c","",[33],{"type":13,"tag":34,"props":35,"children":36},"code",{"__ignoreMap":31},[37,61,81],{"type":13,"tag":38,"props":39,"children":42},"span",{"class":40,"line":41},"line",1,[43,49,55],{"type":13,"tag":38,"props":44,"children":46},{"style":45},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[47],{"type":18,"value":48},"void",{"type":13,"tag":38,"props":50,"children":52},{"style":51},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[53],{"type":18,"value":54}," vkCmdSetRenderingAttachmentLocationsKHR",{"type":13,"tag":38,"props":56,"children":58},{"style":57},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[59],{"type":18,"value":60},"(\n",{"type":13,"tag":38,"props":62,"children":64},{"class":40,"line":63},2,[65,70,76],{"type":13,"tag":38,"props":66,"children":67},{"style":57},[68],{"type":18,"value":69},"    VkCommandBuffer ",{"type":13,"tag":38,"props":71,"children":73},{"style":72},"--shiki-default:#953800;--shiki-dark:#FFA657",[74],{"type":18,"value":75},"commandBuffer",{"type":13,"tag":38,"props":77,"children":78},{"style":57},[79],{"type":18,"value":80},",\n",{"type":13,"tag":38,"props":82,"children":84},{"class":40,"line":83},3,[85,90,95,100,105],{"type":13,"tag":38,"props":86,"children":87},{"style":45},[88],{"type":18,"value":89},"    const",{"type":13,"tag":38,"props":91,"children":92},{"style":57},[93],{"type":18,"value":94}," VkRenderingAttachmentLocationInfo",{"type":13,"tag":38,"props":96,"children":97},{"style":45},[98],{"type":18,"value":99},"*",{"type":13,"tag":38,"props":101,"children":102},{"style":72},[103],{"type":18,"value":104}," pLocationInfo",{"type":13,"tag":38,"props":106,"children":107},{"style":57},[108],{"type":18,"value":109},");\n",{"type":13,"tag":25,"props":111,"children":116},{"className":112,"code":113,"filename":114,"language":115,"meta":31,"style":31},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn cmd_set_rendering_attachment_locations_khr(\n    command_buffer: vk::CommandBuffer,\n    p_location_info: *const vk::RenderingAttachmentLocationInfo,\n);\n","Rust","rs",[117],{"type":13,"tag":34,"props":118,"children":119},{"__ignoreMap":31},[120,142,174,208],{"type":13,"tag":38,"props":121,"children":122},{"class":40,"line":41},[123,128,133,138],{"type":13,"tag":38,"props":124,"children":125},{"style":45},[126],{"type":18,"value":127},"pub",{"type":13,"tag":38,"props":129,"children":130},{"style":45},[131],{"type":18,"value":132}," fn",{"type":13,"tag":38,"props":134,"children":135},{"style":51},[136],{"type":18,"value":137}," cmd_set_rendering_attachment_locations_khr",{"type":13,"tag":38,"props":139,"children":140},{"style":57},[141],{"type":18,"value":60},{"type":13,"tag":38,"props":143,"children":144},{"class":40,"line":63},[145,150,155,160,165,170],{"type":13,"tag":38,"props":146,"children":147},{"style":57},[148],{"type":18,"value":149},"    command_buffer",{"type":13,"tag":38,"props":151,"children":152},{"style":45},[153],{"type":18,"value":154},":",{"type":13,"tag":38,"props":156,"children":157},{"style":72},[158],{"type":18,"value":159}," vk",{"type":13,"tag":38,"props":161,"children":162},{"style":45},[163],{"type":18,"value":164},"::",{"type":13,"tag":38,"props":166,"children":167},{"style":72},[168],{"type":18,"value":169},"CommandBuffer",{"type":13,"tag":38,"props":171,"children":172},{"style":57},[173],{"type":18,"value":80},{"type":13,"tag":38,"props":175,"children":176},{"class":40,"line":83},[177,182,186,191,195,199,204],{"type":13,"tag":38,"props":178,"children":179},{"style":57},[180],{"type":18,"value":181},"    p_location_info",{"type":13,"tag":38,"props":183,"children":184},{"style":45},[185],{"type":18,"value":154},{"type":13,"tag":38,"props":187,"children":188},{"style":45},[189],{"type":18,"value":190}," *const",{"type":13,"tag":38,"props":192,"children":193},{"style":72},[194],{"type":18,"value":159},{"type":13,"tag":38,"props":196,"children":197},{"style":45},[198],{"type":18,"value":164},{"type":13,"tag":38,"props":200,"children":201},{"style":72},[202],{"type":18,"value":203},"RenderingAttachmentLocationInfo",{"type":13,"tag":38,"props":205,"children":206},{"style":57},[207],{"type":18,"value":80},{"type":13,"tag":38,"props":209,"children":211},{"class":40,"line":210},4,[212],{"type":13,"tag":38,"props":213,"children":214},{"style":57},[215],{"type":18,"value":109},{"type":13,"tag":217,"props":218,"children":219},"ul",{},[220,231],{"type":13,"tag":221,"props":222,"children":223},"li",{},[224,229],{"type":13,"tag":34,"props":225,"children":227},{"className":226},[],[228],{"type":18,"value":75},{"type":18,"value":230}," is the command buffer into which the command will be\nrecorded.",{"type":13,"tag":221,"props":232,"children":233},{},[234,240,242,249],{"type":13,"tag":34,"props":235,"children":237},{"className":236},[],[238],{"type":18,"value":239},"pLocationInfo",{"type":18,"value":241}," is a ",{"type":13,"tag":243,"props":244,"children":246},"a",{"href":245},"/man/VkRenderingAttachmentLocationInfo",[247],{"type":18,"value":248},"VkRenderingAttachmentLocationInfo",{"type":18,"value":250},"\nstructure indicating the new mappings.",{"type":13,"tag":14,"props":252,"children":253},{},[254,256,261,263,267,269,273,275,281],{"type":18,"value":255},"This command sets the attachment location mappings for subsequent drawing\ncommands, and ",{"type":13,"tag":257,"props":258,"children":260},"normative",{"type":259},"must",[],{"type":18,"value":262}," match the mappings provided to the bound pipeline,\nif one is bound,\nwhich ",{"type":13,"tag":257,"props":264,"children":266},{"type":265},"can",[],{"type":18,"value":268}," be set by chaining ",{"type":13,"tag":243,"props":270,"children":271},{"href":245},[272],{"type":18,"value":248},{"type":18,"value":274}," to\n",{"type":13,"tag":243,"props":276,"children":278},{"href":277},"/man/VkGraphicsPipelineCreateInfo",[279],{"type":18,"value":280},"VkGraphicsPipelineCreateInfo",{"type":18,"value":282},".",{"type":13,"tag":14,"props":284,"children":285},{},[286,288,294,296,302,303,309,311,315],{"type":18,"value":287},"Until this command is called, mappings in the command buffer state are\ntreated as each color attachment specified in ",{"type":13,"tag":243,"props":289,"children":291},{"href":290},"/man/vkCmdBeginRendering",[292],{"type":18,"value":293},"vkCmdBeginRendering",{"type":18,"value":295},"\nhaving a location equal to its index in\n",{"type":13,"tag":243,"props":297,"children":299},{"href":298},"/man/VkRenderingInfo",[300],{"type":18,"value":301},"VkRenderingInfo",{"type":18,"value":164},{"type":13,"tag":34,"props":304,"children":306},{"className":305},[],[307],{"type":18,"value":308},"pColorAttachments",{"type":18,"value":310},".\nThis state is reset whenever ",{"type":13,"tag":243,"props":312,"children":313},{"href":290},[314],{"type":18,"value":293},{"type":18,"value":316}," is called.",{"type":13,"tag":318,"props":319,"children":321},"validity-group",{"name":320},"Valid Usage",[322,345,378],{"type":13,"tag":323,"props":324,"children":326},"validity-field",{"name":325},"VUID-vkCmdSetRenderingAttachmentLocations-dynamicRenderingLocalRead-09509",[327],{"type":13,"tag":14,"props":328,"children":329},{},[330,340,343],{"type":13,"tag":243,"props":331,"children":333},{"href":332},"/man/VkPhysicalDeviceDynamicRenderingLocalReadFeatures#features-dynamicRenderingLocalRead",[334],{"type":13,"tag":34,"props":335,"children":337},{"className":336},[],[338],{"type":18,"value":339},"dynamicRenderingLocalRead",{"type":13,"tag":257,"props":341,"children":342},{"type":259},[],{"type":18,"value":344}," be enabled",{"type":13,"tag":323,"props":346,"children":348},{"name":347},"VUID-vkCmdSetRenderingAttachmentLocations-pLocationInfo-09510",[349],{"type":13,"tag":14,"props":350,"children":351},{},[352,358,360,363,365,369,370,376],{"type":13,"tag":34,"props":353,"children":355},{"className":354},[],[356],{"type":18,"value":357},"pLocationInfo→colorAttachmentCount",{"type":18,"value":359}," ",{"type":13,"tag":257,"props":361,"children":362},{"type":259},[],{"type":18,"value":364}," be equal to the value of\n",{"type":13,"tag":243,"props":366,"children":367},{"href":298},[368],{"type":18,"value":301},{"type":18,"value":164},{"type":13,"tag":34,"props":371,"children":373},{"className":372},[],[374],{"type":18,"value":375},"colorAttachmentCount",{"type":18,"value":377}," used to begin the\ncurrent render pass instance",{"type":13,"tag":323,"props":379,"children":381},{"name":380},"VUID-vkCmdSetRenderingAttachmentLocations-commandBuffer-09511",[382],{"type":13,"tag":14,"props":383,"children":384},{},[385,387,390,392,396,398],{"type":18,"value":386},"The current render pass instance ",{"type":13,"tag":257,"props":388,"children":389},{"type":259},[],{"type":18,"value":391}," have been started or resumed by\n",{"type":13,"tag":243,"props":393,"children":394},{"href":290},[395],{"type":18,"value":293},{"type":18,"value":397}," in this ",{"type":13,"tag":34,"props":399,"children":401},{"className":400},[],[402],{"type":18,"value":75},{"type":13,"tag":318,"props":404,"children":406},{"name":405},"Valid Usage (Implicit)",[407,433,457,481,510,524],{"type":13,"tag":323,"props":408,"children":410},{"name":409},"VUID-vkCmdSetRenderingAttachmentLocations-commandBuffer-parameter",[411],{"type":13,"tag":14,"props":412,"children":413},{},[414,419,420,423,425,431],{"type":13,"tag":34,"props":415,"children":417},{"className":416},[],[418],{"type":18,"value":75},{"type":18,"value":359},{"type":13,"tag":257,"props":421,"children":422},{"type":259},[],{"type":18,"value":424}," be a valid ",{"type":13,"tag":243,"props":426,"children":428},{"href":427},"/man/VkCommandBuffer",[429],{"type":18,"value":430},"VkCommandBuffer",{"type":18,"value":432}," handle",{"type":13,"tag":323,"props":434,"children":436},{"name":435},"VUID-vkCmdSetRenderingAttachmentLocations-pLocationInfo-parameter",[437],{"type":13,"tag":14,"props":438,"children":439},{},[440,445,446,449,451,455],{"type":13,"tag":34,"props":441,"children":443},{"className":442},[],[444],{"type":18,"value":239},{"type":18,"value":359},{"type":13,"tag":257,"props":447,"children":448},{"type":259},[],{"type":18,"value":450}," be a valid pointer to a valid ",{"type":13,"tag":243,"props":452,"children":453},{"href":245},[454],{"type":18,"value":248},{"type":18,"value":456}," structure",{"type":13,"tag":323,"props":458,"children":460},{"name":459},"VUID-vkCmdSetRenderingAttachmentLocations-commandBuffer-recording",[461],{"type":13,"tag":14,"props":462,"children":463},{},[464,469,470,473,475],{"type":13,"tag":34,"props":465,"children":467},{"className":466},[],[468],{"type":18,"value":75},{"type":18,"value":359},{"type":13,"tag":257,"props":471,"children":472},{"type":259},[],{"type":18,"value":474}," be in the ",{"type":13,"tag":243,"props":476,"children":478},{"href":477},"/chapters/commandbuffers#commandbuffers-lifecycle",[479],{"type":18,"value":480},"recording state",{"type":13,"tag":323,"props":482,"children":484},{"name":483},"VUID-vkCmdSetRenderingAttachmentLocations-commandBuffer-cmdpool",[485],{"type":13,"tag":14,"props":486,"children":487},{},[488,490,496,498,503,505,508],{"type":18,"value":489},"The ",{"type":13,"tag":34,"props":491,"children":493},{"className":492},[],[494],{"type":18,"value":495},"VkCommandPool",{"type":18,"value":497}," that ",{"type":13,"tag":34,"props":499,"children":501},{"className":500},[],[502],{"type":18,"value":75},{"type":18,"value":504}," was allocated from ",{"type":13,"tag":257,"props":506,"children":507},{"type":259},[],{"type":18,"value":509}," support graphics operations",{"type":13,"tag":323,"props":511,"children":513},{"name":512},"VUID-vkCmdSetRenderingAttachmentLocations-renderpass",[514],{"type":13,"tag":14,"props":515,"children":516},{},[517,519,522],{"type":18,"value":518},"This command ",{"type":13,"tag":257,"props":520,"children":521},{"type":259},[],{"type":18,"value":523}," only be called inside of a render pass instance",{"type":13,"tag":323,"props":525,"children":527},{"name":526},"VUID-vkCmdSetRenderingAttachmentLocations-videocoding",[528],{"type":13,"tag":14,"props":529,"children":530},{},[531,532,535],{"type":18,"value":518},{"type":13,"tag":257,"props":533,"children":534},{"type":259},[],{"type":18,"value":536}," only be called outside of a video coding scope",{"type":13,"tag":538,"props":539,"children":541},"validity-box",{"name":540},"Host Synchronization",[542],{"type":13,"tag":217,"props":543,"children":544},{},[545,561],{"type":13,"tag":221,"props":546,"children":547},{},[548,550,555,556,559],{"type":18,"value":549},"Host access to ",{"type":13,"tag":34,"props":551,"children":553},{"className":552},[],[554],{"type":18,"value":75},{"type":18,"value":359},{"type":13,"tag":257,"props":557,"children":558},{"type":259},[],{"type":18,"value":560}," be externally synchronized",{"type":13,"tag":221,"props":562,"children":563},{},[564,566,571,572,577,578,581],{"type":18,"value":565},"Host access to the ",{"type":13,"tag":34,"props":567,"children":569},{"className":568},[],[570],{"type":18,"value":495},{"type":18,"value":497},{"type":13,"tag":34,"props":573,"children":575},{"className":574},[],[576],{"type":18,"value":75},{"type":18,"value":504},{"type":13,"tag":257,"props":579,"children":580},{"type":259},[],{"type":18,"value":582}," be externally synchronized\n::",{"type":13,"tag":584,"props":585,"children":586},"style",{},[587],{"type":18,"value":588},"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":31,"searchDepth":63,"depth":63,"links":590},[],"markdown",1744876592280]