C Specification
The VkDisplayPropertiesKHR structure is defined as:
typedef struct VkDisplayPropertiesKHR {
VkDisplayKHR display;
const char* displayName;
VkExtent2D physicalDimensions;
VkExtent2D physicalResolution;
VkSurfaceTransformFlagsKHR supportedTransforms;
VkBool32 planeReorderPossible;
VkBool32 persistentContent;
} VkDisplayPropertiesKHR;
Members
-
displayis a handle that is used to refer to the display described here. This handle will be valid for the lifetime of the Vulkan instance. -
displayNameis a pointer to a null-terminated UTF-8 string containing the name of the display. Generally, this will be the name provided by the display’s EDID. It can beNULLif no suitable name is available. If notNULL, the memory it points to must remain accessible as long asdisplayis valid. -
physicalDimensionsdescribes the physical width and height of the visible portion of the display, in millimeters. -
physicalResolutiondescribes the physical, native, or preferred resolution of the display.
Description
|
Note
For devices which have no natural value to return here, implementations should return the maximum resolution supported. |
-
supportedTransformsis a bitmask of VkSurfaceTransformFlagBitsKHR describing which transforms are supported by this display. -
planeReorderPossibletells whether the planes on this display can have their z order changed. If this isVK_TRUE, the application can re-arrange the planes on this display in any order relative to each other. -
persistentContenttells whether the display supports self-refresh/internal buffering. If this is true, the application can submit persistent present operations on swapchains created against this display.
|
Note
Persistent presents may have higher latency, and may use less power when the screen content is updated infrequently, or when only a portion of the screen needs to be updated in most frames. |
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.