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 adding a VkPresentRegionsKHR
structure to the pNext chain of the VkPresentInfoKHR structure.
The VkPresentRegionsKHR structure is defined as:
// Provided by VK_KHR_incremental_present
typedef struct VkPresentRegionsKHR {
VkStructureType sType;
const void* pNext;
uint32_t swapchainCount;
const VkPresentRegionKHR* pRegions;
} VkPresentRegionsKHR;
Members
-
sTypeis a VkStructureType value identifying this structure. -
pNextisNULLor a pointer to a structure extending this 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.
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.