[{"data":1,"prerenderedAt":600},["ShallowReactive",2],{"$f8_SMR3_lhXa8oLgpjZ8hb0mwKbOUK9yOoVyC1a7yb6Q":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":599,"_id":4},"vkReleaseSwapchainImagesKHR","Release previously acquired but unused images","VK_KHR_swapchain_maintenance1","protos",[],{"type":10,"children":11,"toc":597},"root",[12,37,256,432,479,491,496,505,536,591],{"type":13,"tag":14,"props":15,"children":16},"element","p",{},[17,20,27,29,35],{"type":18,"value":19},"text","To release images previously acquired through\n",{"type":13,"tag":21,"props":22,"children":24},"a",{"href":23},"/man/vkAcquireNextImage2KHR",[25],{"type":18,"value":26},"vkAcquireNextImage2KHR",{"type":18,"value":28}," or\n",{"type":13,"tag":21,"props":30,"children":32},{"href":31},"/man/vkAcquireNextImageKHR",[33],{"type":18,"value":34},"vkAcquireNextImageKHR",{"type":18,"value":36},", call:",{"type":13,"tag":38,"props":39,"children":40},"code-group",{},[41,126],{"type":13,"tag":42,"props":43,"children":49},"pre",{"className":44,"code":45,"filename":46,"language":47,"meta":48,"style":48},"language-c shiki shiki-themes github-light-default github-dark-default","VkResult vkReleaseSwapchainImagesKHR(\n    VkDevice device,\n    const VkReleaseSwapchainImagesInfoKHR* pReleaseInfo);\n","C","c","",[50],{"type":13,"tag":51,"props":52,"children":53},"code",{"__ignoreMap":48},[54,76,96],{"type":13,"tag":55,"props":56,"children":59},"span",{"class":57,"line":58},"line",1,[60,66,71],{"type":13,"tag":55,"props":61,"children":63},{"style":62},"--shiki-default:#1F2328;--shiki-dark:#E6EDF3",[64],{"type":18,"value":65},"VkResult ",{"type":13,"tag":55,"props":67,"children":69},{"style":68},"--shiki-default:#8250DF;--shiki-dark:#D2A8FF",[70],{"type":18,"value":4},{"type":13,"tag":55,"props":72,"children":73},{"style":62},[74],{"type":18,"value":75},"(\n",{"type":13,"tag":55,"props":77,"children":79},{"class":57,"line":78},2,[80,85,91],{"type":13,"tag":55,"props":81,"children":82},{"style":62},[83],{"type":18,"value":84},"    VkDevice ",{"type":13,"tag":55,"props":86,"children":88},{"style":87},"--shiki-default:#953800;--shiki-dark:#FFA657",[89],{"type":18,"value":90},"device",{"type":13,"tag":55,"props":92,"children":93},{"style":62},[94],{"type":18,"value":95},",\n",{"type":13,"tag":55,"props":97,"children":99},{"class":57,"line":98},3,[100,106,111,116,121],{"type":13,"tag":55,"props":101,"children":103},{"style":102},"--shiki-default:#CF222E;--shiki-dark:#FF7B72",[104],{"type":18,"value":105},"    const",{"type":13,"tag":55,"props":107,"children":108},{"style":62},[109],{"type":18,"value":110}," VkReleaseSwapchainImagesInfoKHR",{"type":13,"tag":55,"props":112,"children":113},{"style":102},[114],{"type":18,"value":115},"*",{"type":13,"tag":55,"props":117,"children":118},{"style":87},[119],{"type":18,"value":120}," pReleaseInfo",{"type":13,"tag":55,"props":122,"children":123},{"style":62},[124],{"type":18,"value":125},");\n",{"type":13,"tag":42,"props":127,"children":132},{"className":128,"code":129,"filename":130,"language":131,"meta":48,"style":48},"language-rs shiki shiki-themes github-light-default github-dark-default","pub fn release_swapchain_images_khr(\n    device: vk::Device,\n    p_release_info: *const vk::ReleaseSwapchainImagesInfoKHR,\n) -> vk::Result;\n","Rust","rs",[133],{"type":13,"tag":51,"props":134,"children":135},{"__ignoreMap":48},[136,158,190,224],{"type":13,"tag":55,"props":137,"children":138},{"class":57,"line":58},[139,144,149,154],{"type":13,"tag":55,"props":140,"children":141},{"style":102},[142],{"type":18,"value":143},"pub",{"type":13,"tag":55,"props":145,"children":146},{"style":102},[147],{"type":18,"value":148}," fn",{"type":13,"tag":55,"props":150,"children":151},{"style":68},[152],{"type":18,"value":153}," release_swapchain_images_khr",{"type":13,"tag":55,"props":155,"children":156},{"style":62},[157],{"type":18,"value":75},{"type":13,"tag":55,"props":159,"children":160},{"class":57,"line":78},[161,166,171,176,181,186],{"type":13,"tag":55,"props":162,"children":163},{"style":62},[164],{"type":18,"value":165},"    device",{"type":13,"tag":55,"props":167,"children":168},{"style":102},[169],{"type":18,"value":170},":",{"type":13,"tag":55,"props":172,"children":173},{"style":87},[174],{"type":18,"value":175}," vk",{"type":13,"tag":55,"props":177,"children":178},{"style":102},[179],{"type":18,"value":180},"::",{"type":13,"tag":55,"props":182,"children":183},{"style":87},[184],{"type":18,"value":185},"Device",{"type":13,"tag":55,"props":187,"children":188},{"style":62},[189],{"type":18,"value":95},{"type":13,"tag":55,"props":191,"children":192},{"class":57,"line":98},[193,198,202,207,211,215,220],{"type":13,"tag":55,"props":194,"children":195},{"style":62},[196],{"type":18,"value":197},"    p_release_info",{"type":13,"tag":55,"props":199,"children":200},{"style":102},[201],{"type":18,"value":170},{"type":13,"tag":55,"props":203,"children":204},{"style":102},[205],{"type":18,"value":206}," *const",{"type":13,"tag":55,"props":208,"children":209},{"style":87},[210],{"type":18,"value":175},{"type":13,"tag":55,"props":212,"children":213},{"style":102},[214],{"type":18,"value":180},{"type":13,"tag":55,"props":216,"children":217},{"style":87},[218],{"type":18,"value":219},"ReleaseSwapchainImagesInfoKHR",{"type":13,"tag":55,"props":221,"children":222},{"style":62},[223],{"type":18,"value":95},{"type":13,"tag":55,"props":225,"children":227},{"class":57,"line":226},4,[228,233,238,242,246,251],{"type":13,"tag":55,"props":229,"children":230},{"style":62},[231],{"type":18,"value":232},") ",{"type":13,"tag":55,"props":234,"children":235},{"style":102},[236],{"type":18,"value":237},"->",{"type":13,"tag":55,"props":239,"children":240},{"style":87},[241],{"type":18,"value":175},{"type":13,"tag":55,"props":243,"children":244},{"style":102},[245],{"type":18,"value":180},{"type":13,"tag":55,"props":247,"children":248},{"style":87},[249],{"type":18,"value":250},"Result",{"type":13,"tag":55,"props":252,"children":253},{"style":62},[254],{"type":18,"value":255},";\n",{"type":13,"tag":38,"props":257,"children":258},{},[259,320],{"type":13,"tag":42,"props":260,"children":262},{"className":44,"code":261,"filename":46,"language":47,"meta":48,"style":48},"VkResult vkReleaseSwapchainImagesEXT(\n    VkDevice device,\n    const VkReleaseSwapchainImagesInfoKHR* pReleaseInfo);\n",[263],{"type":13,"tag":51,"props":264,"children":265},{"__ignoreMap":48},[266,282,297],{"type":13,"tag":55,"props":267,"children":268},{"class":57,"line":58},[269,273,278],{"type":13,"tag":55,"props":270,"children":271},{"style":62},[272],{"type":18,"value":65},{"type":13,"tag":55,"props":274,"children":275},{"style":68},[276],{"type":18,"value":277},"vkReleaseSwapchainImagesEXT",{"type":13,"tag":55,"props":279,"children":280},{"style":62},[281],{"type":18,"value":75},{"type":13,"tag":55,"props":283,"children":284},{"class":57,"line":78},[285,289,293],{"type":13,"tag":55,"props":286,"children":287},{"style":62},[288],{"type":18,"value":84},{"type":13,"tag":55,"props":290,"children":291},{"style":87},[292],{"type":18,"value":90},{"type":13,"tag":55,"props":294,"children":295},{"style":62},[296],{"type":18,"value":95},{"type":13,"tag":55,"props":298,"children":299},{"class":57,"line":98},[300,304,308,312,316],{"type":13,"tag":55,"props":301,"children":302},{"style":102},[303],{"type":18,"value":105},{"type":13,"tag":55,"props":305,"children":306},{"style":62},[307],{"type":18,"value":110},{"type":13,"tag":55,"props":309,"children":310},{"style":102},[311],{"type":18,"value":115},{"type":13,"tag":55,"props":313,"children":314},{"style":87},[315],{"type":18,"value":120},{"type":13,"tag":55,"props":317,"children":318},{"style":62},[319],{"type":18,"value":125},{"type":13,"tag":42,"props":321,"children":323},{"className":128,"code":322,"filename":130,"language":131,"meta":48,"style":48},"pub fn release_swapchain_images_ext(\n    device: vk::Device,\n    p_release_info: *const vk::ReleaseSwapchainImagesInfoKHR,\n) -> vk::Result;\n",[324],{"type":13,"tag":51,"props":325,"children":326},{"__ignoreMap":48},[327,347,374,405],{"type":13,"tag":55,"props":328,"children":329},{"class":57,"line":58},[330,334,338,343],{"type":13,"tag":55,"props":331,"children":332},{"style":102},[333],{"type":18,"value":143},{"type":13,"tag":55,"props":335,"children":336},{"style":102},[337],{"type":18,"value":148},{"type":13,"tag":55,"props":339,"children":340},{"style":68},[341],{"type":18,"value":342}," release_swapchain_images_ext",{"type":13,"tag":55,"props":344,"children":345},{"style":62},[346],{"type":18,"value":75},{"type":13,"tag":55,"props":348,"children":349},{"class":57,"line":78},[350,354,358,362,366,370],{"type":13,"tag":55,"props":351,"children":352},{"style":62},[353],{"type":18,"value":165},{"type":13,"tag":55,"props":355,"children":356},{"style":102},[357],{"type":18,"value":170},{"type":13,"tag":55,"props":359,"children":360},{"style":87},[361],{"type":18,"value":175},{"type":13,"tag":55,"props":363,"children":364},{"style":102},[365],{"type":18,"value":180},{"type":13,"tag":55,"props":367,"children":368},{"style":87},[369],{"type":18,"value":185},{"type":13,"tag":55,"props":371,"children":372},{"style":62},[373],{"type":18,"value":95},{"type":13,"tag":55,"props":375,"children":376},{"class":57,"line":98},[377,381,385,389,393,397,401],{"type":13,"tag":55,"props":378,"children":379},{"style":62},[380],{"type":18,"value":197},{"type":13,"tag":55,"props":382,"children":383},{"style":102},[384],{"type":18,"value":170},{"type":13,"tag":55,"props":386,"children":387},{"style":102},[388],{"type":18,"value":206},{"type":13,"tag":55,"props":390,"children":391},{"style":87},[392],{"type":18,"value":175},{"type":13,"tag":55,"props":394,"children":395},{"style":102},[396],{"type":18,"value":180},{"type":13,"tag":55,"props":398,"children":399},{"style":87},[400],{"type":18,"value":219},{"type":13,"tag":55,"props":402,"children":403},{"style":62},[404],{"type":18,"value":95},{"type":13,"tag":55,"props":406,"children":407},{"class":57,"line":226},[408,412,416,420,424,428],{"type":13,"tag":55,"props":409,"children":410},{"style":62},[411],{"type":18,"value":232},{"type":13,"tag":55,"props":413,"children":414},{"style":102},[415],{"type":18,"value":237},{"type":13,"tag":55,"props":417,"children":418},{"style":87},[419],{"type":18,"value":175},{"type":13,"tag":55,"props":421,"children":422},{"style":102},[423],{"type":18,"value":180},{"type":13,"tag":55,"props":425,"children":426},{"style":87},[427],{"type":18,"value":250},{"type":13,"tag":55,"props":429,"children":430},{"style":62},[431],{"type":18,"value":255},{"type":13,"tag":433,"props":434,"children":435},"ul",{},[436,462],{"type":13,"tag":437,"props":438,"children":439},"li",{},[440,445,447,453,454,460],{"type":13,"tag":51,"props":441,"children":443},{"className":442},[],[444],{"type":18,"value":90},{"type":18,"value":446}," is the device associated with\n",{"type":13,"tag":21,"props":448,"children":450},{"href":449},"/man/VkReleaseSwapchainImagesInfoKHR",[451],{"type":18,"value":452},"VkReleaseSwapchainImagesInfoKHR",{"type":18,"value":180},{"type":13,"tag":51,"props":455,"children":457},{"className":456},[],[458],{"type":18,"value":459},"swapchain",{"type":18,"value":461},".",{"type":13,"tag":437,"props":463,"children":464},{},[465,471,473,477],{"type":13,"tag":51,"props":466,"children":468},{"className":467},[],[469],{"type":18,"value":470},"pReleaseInfo",{"type":18,"value":472}," is a pointer to a\n",{"type":13,"tag":21,"props":474,"children":475},{"href":449},[476],{"type":18,"value":452},{"type":18,"value":478}," structure containing parameters of\nthe release.",{"type":13,"tag":14,"props":480,"children":481},{},[482,484,489],{"type":18,"value":483},"Only images that are not in use by the device ",{"type":13,"tag":485,"props":486,"children":488},"normative",{"type":487},"can",[],{"type":18,"value":490}," be released.",{"type":13,"tag":14,"props":492,"children":493},{},[494],{"type":18,"value":495},"Releasing images is a read-only operation that will not affect the content\nof the released images.\nUpon reacquiring the image, the image contents and its layout will be the\nsame as they were prior to releasing it.\nHowever, if a mechanism other than Vulkan is used to modify the platform\nwindow associated with the swapchain, the content of all presentable images\nin the swapchain becomes undefined.",{"type":13,"tag":497,"props":498,"children":499},"note",{},[500],{"type":13,"tag":14,"props":501,"children":502},{},[503],{"type":18,"value":504},"This functionality is useful during swapchain recreation, where acquired\nimages from the old swapchain can be released instead of presented.",{"type":13,"tag":506,"props":507,"children":509},"validity-group",{"name":508},"Valid Usage",[510],{"type":13,"tag":511,"props":512,"children":514},"validity-field",{"name":513},"VUID-vkReleaseSwapchainImagesKHR-swapchainMaintenance1-10159",[515],{"type":13,"tag":14,"props":516,"children":517},{},[518,520,530,534],{"type":18,"value":519},"Feature ",{"type":13,"tag":21,"props":521,"children":523},{"href":522},"/man/VkPhysicalDeviceSwapchainMaintenance1FeaturesKHR#features-swapchainMaintenance1",[524],{"type":13,"tag":51,"props":525,"children":527},{"className":526},[],[528],{"type":18,"value":529},"swapchainMaintenance1",{"type":13,"tag":485,"props":531,"children":533},{"type":532},"must",[],{"type":18,"value":535}," be enabled",{"type":13,"tag":506,"props":537,"children":539},{"name":538},"Valid Usage (Implicit)",[540,567],{"type":13,"tag":511,"props":541,"children":543},{"name":542},"VUID-vkReleaseSwapchainImagesKHR-device-parameter",[544],{"type":13,"tag":14,"props":545,"children":546},{},[547,552,554,557,559,565],{"type":13,"tag":51,"props":548,"children":550},{"className":549},[],[551],{"type":18,"value":90},{"type":18,"value":553}," ",{"type":13,"tag":485,"props":555,"children":556},{"type":532},[],{"type":18,"value":558}," be a valid ",{"type":13,"tag":21,"props":560,"children":562},{"href":561},"/man/VkDevice",[563],{"type":18,"value":564},"VkDevice",{"type":18,"value":566}," handle",{"type":13,"tag":511,"props":568,"children":570},{"name":569},"VUID-vkReleaseSwapchainImagesKHR-pReleaseInfo-parameter",[571],{"type":13,"tag":14,"props":572,"children":573},{},[574,579,580,583,585,589],{"type":13,"tag":51,"props":575,"children":577},{"className":576},[],[578],{"type":18,"value":470},{"type":18,"value":553},{"type":13,"tag":485,"props":581,"children":582},{"type":532},[],{"type":18,"value":584}," be a valid pointer to a valid ",{"type":13,"tag":21,"props":586,"children":587},{"href":449},[588],{"type":18,"value":452},{"type":18,"value":590}," structure",{"type":13,"tag":592,"props":593,"children":594},"style",{},[595],{"type":18,"value":596},"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":48,"searchDepth":78,"depth":78,"links":598},[],"markdown",1773054812039]