[{"data":1,"prerenderedAt":415},["ShallowReactive",2],{"BYtSFrLwb1":3},{"title":4,"description":5,"parent":6,"type":7,"xrefs":8,"body":9,"_type":414,"_id":4},"vkReleaseSwapchainImagesEXT","Release previously acquired but unused images","VK_EXT_swapchain_maintenance1","protos",[],{"type":10,"children":11,"toc":412},"root",[12,37,275,322,334,339,348,406],{"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 vkReleaseSwapchainImagesEXT(\n VkDevice device,\n const VkReleaseSwapchainImagesInfoEXT* 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}," VkReleaseSwapchainImagesInfoEXT",{"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_ext(\n device: crate :: vk :: vk::Device,\n p_release_info: *const vk::ReleaseSwapchainImagesInfoEXT,\n) -> vk::Result;\n","Rust","rs",[133],{"type":13,"tag":51,"props":134,"children":135},{"__ignoreMap":48},[136,158,209,243],{"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_ext",{"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,191,196,200,205],{"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":102},[174],{"type":18,"value":175}," crate",{"type":13,"tag":55,"props":177,"children":178},{"style":102},[179],{"type":18,"value":180}," ::",{"type":13,"tag":55,"props":182,"children":183},{"style":62},[184],{"type":18,"value":185}," vk ",{"type":13,"tag":55,"props":187,"children":188},{"style":102},[189],{"type":18,"value":190},"::",{"type":13,"tag":55,"props":192,"children":193},{"style":87},[194],{"type":18,"value":195}," vk",{"type":13,"tag":55,"props":197,"children":198},{"style":102},[199],{"type":18,"value":190},{"type":13,"tag":55,"props":201,"children":202},{"style":87},[203],{"type":18,"value":204},"Device",{"type":13,"tag":55,"props":206,"children":207},{"style":62},[208],{"type":18,"value":95},{"type":13,"tag":55,"props":210,"children":211},{"class":57,"line":98},[212,217,221,226,230,234,239],{"type":13,"tag":55,"props":213,"children":214},{"style":62},[215],{"type":18,"value":216}," p_release_info",{"type":13,"tag":55,"props":218,"children":219},{"style":102},[220],{"type":18,"value":170},{"type":13,"tag":55,"props":222,"children":223},{"style":102},[224],{"type":18,"value":225}," *const",{"type":13,"tag":55,"props":227,"children":228},{"style":87},[229],{"type":18,"value":195},{"type":13,"tag":55,"props":231,"children":232},{"style":102},[233],{"type":18,"value":190},{"type":13,"tag":55,"props":235,"children":236},{"style":87},[237],{"type":18,"value":238},"ReleaseSwapchainImagesInfoEXT",{"type":13,"tag":55,"props":240,"children":241},{"style":62},[242],{"type":18,"value":95},{"type":13,"tag":55,"props":244,"children":246},{"class":57,"line":245},4,[247,252,257,261,265,270],{"type":13,"tag":55,"props":248,"children":249},{"style":62},[250],{"type":18,"value":251},") ",{"type":13,"tag":55,"props":253,"children":254},{"style":102},[255],{"type":18,"value":256},"->",{"type":13,"tag":55,"props":258,"children":259},{"style":87},[260],{"type":18,"value":195},{"type":13,"tag":55,"props":262,"children":263},{"style":102},[264],{"type":18,"value":190},{"type":13,"tag":55,"props":266,"children":267},{"style":87},[268],{"type":18,"value":269},"Result",{"type":13,"tag":55,"props":271,"children":272},{"style":62},[273],{"type":18,"value":274},";\n",{"type":13,"tag":276,"props":277,"children":278},"ul",{},[279,305],{"type":13,"tag":280,"props":281,"children":282},"li",{},[283,288,290,296,297,303],{"type":13,"tag":51,"props":284,"children":286},{"className":285},[],[287],{"type":18,"value":90},{"type":18,"value":289}," is the device associated with\n",{"type":13,"tag":21,"props":291,"children":293},{"href":292},"/man/VkReleaseSwapchainImagesInfoEXT",[294],{"type":18,"value":295},"VkReleaseSwapchainImagesInfoEXT",{"type":18,"value":190},{"type":13,"tag":51,"props":298,"children":300},{"className":299},[],[301],{"type":18,"value":302},"swapchain",{"type":18,"value":304},".",{"type":13,"tag":280,"props":306,"children":307},{},[308,314,316,320],{"type":13,"tag":51,"props":309,"children":311},{"className":310},[],[312],{"type":18,"value":313},"pReleaseInfo",{"type":18,"value":315}," is a pointer to a\n",{"type":13,"tag":21,"props":317,"children":318},{"href":292},[319],{"type":18,"value":295},{"type":18,"value":321}," structure containing parameters of\nthe release.",{"type":13,"tag":14,"props":323,"children":324},{},[325,327,332],{"type":18,"value":326},"Only images that are not in use by the device ",{"type":13,"tag":328,"props":329,"children":331},"normative",{"type":330},"can",[],{"type":18,"value":333}," be released.",{"type":13,"tag":14,"props":335,"children":336},{},[337],{"type":18,"value":338},"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":340,"props":341,"children":342},"note",{},[343],{"type":13,"tag":14,"props":344,"children":345},{},[346],{"type":18,"value":347},"This functionality is useful during swapchain recreation, where acquired\nimages from the old swapchain can be released instead of presented.",{"type":13,"tag":349,"props":350,"children":352},"validity-group",{"name":351},"Valid Usage (Implicit)",[353,382],{"type":13,"tag":354,"props":355,"children":357},"validity-field",{"name":356},"VUID-vkReleaseSwapchainImagesEXT-device-parameter",[358],{"type":13,"tag":14,"props":359,"children":360},{},[361,366,368,372,374,380],{"type":13,"tag":51,"props":362,"children":364},{"className":363},[],[365],{"type":18,"value":90},{"type":18,"value":367}," ",{"type":13,"tag":328,"props":369,"children":371},{"type":370},"must",[],{"type":18,"value":373}," be a valid ",{"type":13,"tag":21,"props":375,"children":377},{"href":376},"/man/VkDevice",[378],{"type":18,"value":379},"VkDevice",{"type":18,"value":381}," handle",{"type":13,"tag":354,"props":383,"children":385},{"name":384},"VUID-vkReleaseSwapchainImagesEXT-pReleaseInfo-parameter",[386],{"type":13,"tag":14,"props":387,"children":388},{},[389,394,395,398,400,404],{"type":13,"tag":51,"props":390,"children":392},{"className":391},[],[393],{"type":18,"value":313},{"type":18,"value":367},{"type":13,"tag":328,"props":396,"children":397},{"type":370},[],{"type":18,"value":399}," be a valid pointer to a valid ",{"type":13,"tag":21,"props":401,"children":402},{"href":292},[403],{"type":18,"value":295},{"type":18,"value":405}," structure",{"type":13,"tag":407,"props":408,"children":409},"style",{},[410],{"type":18,"value":411},"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":413},[],"markdown",1725732623129]