C Specification
The VkSurfacePresentScalingCapabilitiesEXT structure is defined as:
// Provided by VK_EXT_surface_maintenance1
typedef struct VkSurfacePresentScalingCapabilitiesEXT {
VkStructureType sType;
void* pNext;
VkPresentScalingFlagsEXT supportedPresentScaling;
VkPresentGravityFlagsEXT supportedPresentGravityX;
VkPresentGravityFlagsEXT supportedPresentGravityY;
VkExtent2D minScaledImageExtent;
VkExtent2D maxScaledImageExtent;
} VkSurfacePresentScalingCapabilitiesEXT;
Members
-
sTypeis a VkStructureType value identifying this structure. -
pNextisNULLor a pointer to a structure extending this structure. -
supportedPresentScalingis a bitmask of VkPresentScalingFlagBitsEXT representing the scaling methods supported by the surface, or0if application-defined scaling is not supported. -
supportedPresentGravityXis a bitmask of VkPresentGravityFlagBitsEXT representing the X-axis pixel gravity supported by the surface, or0if Vulkan-defined pixel gravity is not supported for the X axis. -
supportedPresentGravityYis a bitmask of VkPresentGravityFlagBitsEXT representing the Y-axis pixel gravity supported by the surface, or0if Vulkan-defined pixel gravity is not supported for the Y axis. -
minScaledImageExtentcontains the smallest valid swapchain extent for the surface on the specified device when one of the scaling methods specified insupportedPresentScalingis used, or the special value (0xFFFFFFFF, 0xFFFFFFFF) indicating that the surface size will be determined by the extent of a swapchain targeting the surface. Thewidthandheightof the extent will each be smaller than or equal to the correspondingwidthandheightof VkSurfaceCapabilitiesKHR::minImageExtent. -
maxScaledImageExtentcontains the largest valid swapchain extent for the surface on the specified device when one of the scaling methods specified insupportedPresentScalingis used, or the special value described above forminScaledImageExtent. Thewidthandheightof the extent will each be greater than or equal to the correspondingwidthandheightof VkSurfaceCapabilitiesKHR::maxImageExtent.
Description
Before creating a swapchain whose scaling mode can be specified through the
use of VkSwapchainPresentScalingCreateInfoEXT, obtain the set of
supported scaling modes by including a VkSurfacePresentModeEXT
structure in the pNext chain of VkPhysicalDeviceSurfaceInfo2KHR
when calling vkGetPhysicalDeviceSurfaceCapabilities2KHR.
The implementation must return the same values in
VkSurfacePresentScalingCapabilitiesEXT for any of the compatible
present modes as obtained through
VkSurfacePresentModeCompatibilityEXT.
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.