C Specification
When the VK_KHR_incremental_present extension is enabled, additional
fields can be specified that allow an application to specify that only
certain rectangular regions of the presentable images of a swapchain are
changed.
This is an optimization hint that a presentation engine may use to only
update the region of a surface that is actually changing.
The application still must ensure that all pixels of a presented image
contain the desired values, in case the presentation engine ignores this
hint.
An application can provide this hint by including the
VkPresentRegionsKHR structure in the pNext chain of the
VkPresentInfoKHR structure.
The VkPresentRegionsKHR structure is defined as:
typedef struct VkPresentRegionsKHR {
VkStructureType sType;
const void* pNext;
uint32_t swapchainCount;
const VkPresentRegionKHR* pRegions;
} VkPresentRegionsKHR;
Members
-
sTypeis the type of this structure. -
pNextisNULLor a pointer to an extension-specific structure. -
swapchainCountis the number of swapchains being presented to by this command. -
pRegionsisNULLor a pointer to an array ofVkPresentRegionKHRelements withswapchainCountentries. If notNULL, each element ofpRegionscontains the region that has changed since the last present to the swapchain in the corresponding entry in theVkPresentInfoKHR::pSwapchainsarray.
Description
See Also
Document Notes
For more information, see the Vulkan Specification
This page is extracted from the Vulkan Specification. Fixes and changes should be made to the Specification, not directly.
Copyright
Copyright (c) 2014-2019 Khronos Group. This work is licensed under a Creative Commons Attribution 4.0 International License.