Structures
VkPresentRegionKHR
Structure containing rectangular region changed by vkQueuePresentKHR for a given VkImage
For a given image and swapchain, the region to present is specified by the
VkPresentRegionKHR
structure, which is defined as:
typedef struct VkPresentRegionKHR {
uint32_t rectangleCount;
const VkRectLayerKHR* pRectangles;
} VkPresentRegionKHR;
rectangleCount
is the number of rectangles inpRectangles
, or zero if the entire image has changed and should be presented.pRectangles
is eitherNULL
or a pointer to an array ofVkRectLayerKHR
structures. TheVkRectLayerKHR
structure is the framebuffer coordinates, plus layer, of a portion of a presentable image that has changed and must be presented. If non-NULL
, each entry inpRectangles
is a rectangle of the given image that has changed since the last image was presented to the given swapchain. The rectangles must be specified relative to VkSurfaceCapabilitiesKHR::currentTransform
, regardless of the swapchain’spreTransform
. The presentation engine will apply thepreTransform
transformation to the rectangles, along with any further transformation it applies to the image content.
Valid Usage (Implicit)
VUID-VkPresentRegionKHR-pRectangles-parameter
If rectangleCount
is not 0
, and pRectangles
is not NULL
, pRectangles
must be a valid pointer to an array of rectangleCount
valid VkRectLayerKHR structures