vulkan-2.1.0.0: Bindings to the Vulkan graphics API.

Safe HaskellNone
LanguageHaskell2010

Graphics.Vulkan.Extensions.VK_KHR_display

Synopsis

Documentation

newtype VkDisplayPlaneAlphaFlagBitsKHR Source #

VkDisplayPlaneAlphaFlagBitsKHR - Alpha blending type

See Also

VkDisplayPlaneAlphaFlagsKHR, VkDisplaySurfaceCreateInfoKHR

Instances
Eq VkDisplayPlaneAlphaFlagBitsKHR Source # 
Instance details
Ord VkDisplayPlaneAlphaFlagBitsKHR Source # 
Instance details
Read VkDisplayPlaneAlphaFlagBitsKHR Source # 
Instance details
Show VkDisplayPlaneAlphaFlagBitsKHR Source # 
Instance details
Storable VkDisplayPlaneAlphaFlagBitsKHR Source # 
Instance details
Bits VkDisplayPlaneAlphaFlagBitsKHR Source # 
Instance details

Methods

(.&.) :: VkDisplayPlaneAlphaFlagBitsKHR -> VkDisplayPlaneAlphaFlagBitsKHR -> VkDisplayPlaneAlphaFlagBitsKHR #

(.|.) :: VkDisplayPlaneAlphaFlagBitsKHR -> VkDisplayPlaneAlphaFlagBitsKHR -> VkDisplayPlaneAlphaFlagBitsKHR #

xor :: VkDisplayPlaneAlphaFlagBitsKHR -> VkDisplayPlaneAlphaFlagBitsKHR -> VkDisplayPlaneAlphaFlagBitsKHR #

complement :: VkDisplayPlaneAlphaFlagBitsKHR -> VkDisplayPlaneAlphaFlagBitsKHR #

shift :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

rotate :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

zeroBits :: VkDisplayPlaneAlphaFlagBitsKHR #

bit :: Int -> VkDisplayPlaneAlphaFlagBitsKHR #

setBit :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

clearBit :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

complementBit :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

testBit :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> Bool #

bitSizeMaybe :: VkDisplayPlaneAlphaFlagBitsKHR -> Maybe Int #

bitSize :: VkDisplayPlaneAlphaFlagBitsKHR -> Int #

isSigned :: VkDisplayPlaneAlphaFlagBitsKHR -> Bool #

shiftL :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

unsafeShiftL :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

shiftR :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

unsafeShiftR :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

rotateL :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

rotateR :: VkDisplayPlaneAlphaFlagBitsKHR -> Int -> VkDisplayPlaneAlphaFlagBitsKHR #

popCount :: VkDisplayPlaneAlphaFlagBitsKHR -> Int #

FiniteBits VkDisplayPlaneAlphaFlagBitsKHR Source # 
Instance details

pattern VK_DISPLAY_PLANE_ALPHA_OPAQUE_BIT_KHR :: VkDisplayPlaneAlphaFlagBitsKHR Source #

VK_DISPLAY_PLANE_ALPHA_OPAQUE_BIT_KHR specifies that the source image will be treated as opaque.

pattern VK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHR :: VkDisplayPlaneAlphaFlagBitsKHR Source #

VK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHR specifies that a global alpha value must be specified that will be applied to all pixels in the source image.

pattern VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_BIT_KHR :: VkDisplayPlaneAlphaFlagBitsKHR Source #

VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_BIT_KHR specifies that the alpha value will be determined by the alpha channel of the source image’s pixels. If the source format contains no alpha values, no blending will be applied. The source alpha values are not premultiplied into the source image’s other color channels.

pattern VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_PREMULTIPLIED_BIT_KHR :: VkDisplayPlaneAlphaFlagBitsKHR Source #

VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_PREMULTIPLIED_BIT_KHR is equivalent to VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_BIT_KHR, except the source alpha values are assumed to be premultiplied into the source image’s other color channels.

newtype VkDisplayModeCreateFlagsKHR Source #

Instances
Eq VkDisplayModeCreateFlagsKHR Source # 
Instance details
Ord VkDisplayModeCreateFlagsKHR Source # 
Instance details
Read VkDisplayModeCreateFlagsKHR Source # 
Instance details
Show VkDisplayModeCreateFlagsKHR Source # 
Instance details
Storable VkDisplayModeCreateFlagsKHR Source # 
Instance details
Bits VkDisplayModeCreateFlagsKHR Source # 
Instance details

Methods

(.&.) :: VkDisplayModeCreateFlagsKHR -> VkDisplayModeCreateFlagsKHR -> VkDisplayModeCreateFlagsKHR #

(.|.) :: VkDisplayModeCreateFlagsKHR -> VkDisplayModeCreateFlagsKHR -> VkDisplayModeCreateFlagsKHR #

xor :: VkDisplayModeCreateFlagsKHR -> VkDisplayModeCreateFlagsKHR -> VkDisplayModeCreateFlagsKHR #

complement :: VkDisplayModeCreateFlagsKHR -> VkDisplayModeCreateFlagsKHR #

shift :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

rotate :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

zeroBits :: VkDisplayModeCreateFlagsKHR #

bit :: Int -> VkDisplayModeCreateFlagsKHR #

setBit :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

clearBit :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

complementBit :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

testBit :: VkDisplayModeCreateFlagsKHR -> Int -> Bool #

bitSizeMaybe :: VkDisplayModeCreateFlagsKHR -> Maybe Int #

bitSize :: VkDisplayModeCreateFlagsKHR -> Int #

isSigned :: VkDisplayModeCreateFlagsKHR -> Bool #

shiftL :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

unsafeShiftL :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

shiftR :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

unsafeShiftR :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

rotateL :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

rotateR :: VkDisplayModeCreateFlagsKHR -> Int -> VkDisplayModeCreateFlagsKHR #

popCount :: VkDisplayModeCreateFlagsKHR -> Int #

FiniteBits VkDisplayModeCreateFlagsKHR Source # 
Instance details

newtype VkDisplaySurfaceCreateFlagsKHR Source #

Instances
Eq VkDisplaySurfaceCreateFlagsKHR Source # 
Instance details
Ord VkDisplaySurfaceCreateFlagsKHR Source # 
Instance details
Read VkDisplaySurfaceCreateFlagsKHR Source # 
Instance details
Show VkDisplaySurfaceCreateFlagsKHR Source # 
Instance details
Storable VkDisplaySurfaceCreateFlagsKHR Source # 
Instance details
Bits VkDisplaySurfaceCreateFlagsKHR Source # 
Instance details

Methods

(.&.) :: VkDisplaySurfaceCreateFlagsKHR -> VkDisplaySurfaceCreateFlagsKHR -> VkDisplaySurfaceCreateFlagsKHR #

(.|.) :: VkDisplaySurfaceCreateFlagsKHR -> VkDisplaySurfaceCreateFlagsKHR -> VkDisplaySurfaceCreateFlagsKHR #

xor :: VkDisplaySurfaceCreateFlagsKHR -> VkDisplaySurfaceCreateFlagsKHR -> VkDisplaySurfaceCreateFlagsKHR #

complement :: VkDisplaySurfaceCreateFlagsKHR -> VkDisplaySurfaceCreateFlagsKHR #

shift :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

rotate :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

zeroBits :: VkDisplaySurfaceCreateFlagsKHR #

bit :: Int -> VkDisplaySurfaceCreateFlagsKHR #

setBit :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

clearBit :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

complementBit :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

testBit :: VkDisplaySurfaceCreateFlagsKHR -> Int -> Bool #

bitSizeMaybe :: VkDisplaySurfaceCreateFlagsKHR -> Maybe Int #

bitSize :: VkDisplaySurfaceCreateFlagsKHR -> Int #

isSigned :: VkDisplaySurfaceCreateFlagsKHR -> Bool #

shiftL :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

unsafeShiftL :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

shiftR :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

unsafeShiftR :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

rotateL :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

rotateR :: VkDisplaySurfaceCreateFlagsKHR -> Int -> VkDisplaySurfaceCreateFlagsKHR #

popCount :: VkDisplaySurfaceCreateFlagsKHR -> Int #

FiniteBits VkDisplaySurfaceCreateFlagsKHR Source # 
Instance details

type VkDisplayModeKHR = Ptr VkDisplayModeKHR_T Source #

vkGetPhysicalDeviceDisplayPropertiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("pPropertyCount" ::: Ptr Word32) -> ("pProperties" ::: Ptr VkDisplayPropertiesKHR) -> IO VkResult Source #

vkGetPhysicalDeviceDisplayPropertiesKHR - Query information about the available displays

Parameters

  • physicalDevice is a physical device.
  • pPropertyCount is a pointer to an integer related to the number of display devices available or queried, as described below.
  • pProperties is either NULL or a pointer to an array of VkDisplayPropertiesKHR structures.

Description

If pProperties is NULL, then the number of display devices available for physicalDevice is returned in pPropertyCount. Otherwise, pPropertyCount must point to a variable set by the user to the number of elements in the pProperties array, and on return the variable is overwritten with the number of structures actually written to pProperties. If the value of pPropertyCount is less than the number of display devices for physicalDevice, at most pPropertyCount structures will be written. If pPropertyCount is smaller than the number of display devices available for physicalDevice, VK_INCOMPLETE will be returned instead of VK_SUCCESS to indicate that not all the available values were returned.

Valid Usage (Implicit)

  • physicalDevice must be a valid VkPhysicalDevice handle
  • pPropertyCount must be a valid pointer to a uint32_t value
  • If the value referenced by pPropertyCount is not 0, and pProperties is not NULL, pProperties must be a valid pointer to an array of pPropertyCount VkDisplayPropertiesKHR structures

Return Codes

[Success] - VK_SUCCESS

  • VK_INCOMPLETE

[Failure] - VK_ERROR_OUT_OF_HOST_MEMORY

  • VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkDisplayPropertiesKHR, VkPhysicalDevice

vkGetPhysicalDeviceDisplayPlanePropertiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("pPropertyCount" ::: Ptr Word32) -> ("pProperties" ::: Ptr VkDisplayPlanePropertiesKHR) -> IO VkResult Source #

vkGetPhysicalDeviceDisplayPlanePropertiesKHR - Query the plane properties

Parameters

  • physicalDevice is a physical device.
  • pPropertyCount is a pointer to an integer related to the number of display planes available or queried, as described below.
  • pProperties is either NULL or a pointer to an array of VkDisplayPlanePropertiesKHR structures.

Description

If pProperties is NULL, then the number of display planes available for physicalDevice is returned in pPropertyCount. Otherwise, pPropertyCount must point to a variable set by the user to the number of elements in the pProperties array, and on return the variable is overwritten with the number of structures actually written to pProperties. If the value of pPropertyCount is less than the number of display planes for physicalDevice, at most pPropertyCount structures will be written.

Valid Usage (Implicit)

  • physicalDevice must be a valid VkPhysicalDevice handle
  • pPropertyCount must be a valid pointer to a uint32_t value
  • If the value referenced by pPropertyCount is not 0, and pProperties is not NULL, pProperties must be a valid pointer to an array of pPropertyCount VkDisplayPlanePropertiesKHR structures

Return Codes

[Success] - VK_SUCCESS

  • VK_INCOMPLETE

[Failure] - VK_ERROR_OUT_OF_HOST_MEMORY

  • VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkDisplayPlanePropertiesKHR, VkPhysicalDevice

vkGetDisplayPlaneSupportedDisplaysKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("planeIndex" ::: Word32) -> ("pDisplayCount" ::: Ptr Word32) -> ("pDisplays" ::: Ptr VkDisplayKHR) -> IO VkResult Source #

vkGetDisplayPlaneSupportedDisplaysKHR - Query the list of displays a plane supports

Parameters

  • physicalDevice is a physical device.
  • planeIndex is the plane which the application wishes to use, and must be in the range [0, physical device plane count - 1].
  • pDisplayCount is a pointer to an integer related to the number of displays available or queried, as described below.
  • pDisplays is either NULL or a pointer to an array of VkDisplayKHR handles.

Description

If pDisplays is NULL, then the number of displays usable with the specified planeIndex for physicalDevice is returned in pDisplayCount. Otherwise, pDisplayCount must point to a variable set by the user to the number of elements in the pDisplays array, and on return the variable is overwritten with the number of handles actually written to pDisplays. If the value of pDisplayCount is less than the number of display planes for physicalDevice, at most pDisplayCount handles will be written. If pDisplayCount is smaller than the number of displays usable with the specified planeIndex for physicalDevice, VK_INCOMPLETE will be returned instead of VK_SUCCESS to indicate that not all the available values were returned.

Valid Usage

  • planeIndex must be less than the number of display planes supported by the device as determined by calling vkGetPhysicalDeviceDisplayPlanePropertiesKHR

Valid Usage (Implicit)

  • physicalDevice must be a valid VkPhysicalDevice handle
  • pDisplayCount must be a valid pointer to a uint32_t value
  • If the value referenced by pDisplayCount is not 0, and pDisplays is not NULL, pDisplays must be a valid pointer to an array of pDisplayCount VkDisplayKHR handles

Return Codes

[Success] - VK_SUCCESS

  • VK_INCOMPLETE

[Failure] - VK_ERROR_OUT_OF_HOST_MEMORY

  • VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkDisplayKHR, VkPhysicalDevice

vkGetDisplayModePropertiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("display" ::: VkDisplayKHR) -> ("pPropertyCount" ::: Ptr Word32) -> ("pProperties" ::: Ptr VkDisplayModePropertiesKHR) -> IO VkResult Source #

vkGetDisplayModePropertiesKHR - Query the set of mode properties supported by the display

Parameters

  • physicalDevice is the physical device associated with display.
  • display is the display to query.
  • pPropertyCount is a pointer to an integer related to the number of display modes available or queried, as described below.
  • pProperties is either NULL or a pointer to an array of VkDisplayModePropertiesKHR structures.

Description

If pProperties is NULL, then the number of display modes available on the specified display for physicalDevice is returned in pPropertyCount. Otherwise, pPropertyCount must point to a variable set by the user to the number of elements in the pProperties array, and on return the variable is overwritten with the number of structures actually written to pProperties. If the value of pPropertyCount is less than the number of display modes for physicalDevice, at most pPropertyCount structures will be written. If pPropertyCount is smaller than the number of display modes available on the specified display for physicalDevice, VK_INCOMPLETE will be returned instead of VK_SUCCESS to indicate that not all the available values were returned.

Valid Usage (Implicit)

  • physicalDevice must be a valid VkPhysicalDevice handle
  • display must be a valid VkDisplayKHR handle
  • pPropertyCount must be a valid pointer to a uint32_t value
  • If the value referenced by pPropertyCount is not 0, and pProperties is not NULL, pProperties must be a valid pointer to an array of pPropertyCount VkDisplayModePropertiesKHR structures

Return Codes

[Success] - VK_SUCCESS

  • VK_INCOMPLETE

[Failure] - VK_ERROR_OUT_OF_HOST_MEMORY

  • VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkDisplayKHR, VkDisplayModePropertiesKHR, VkPhysicalDevice

vkCreateDisplayModeKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("display" ::: VkDisplayKHR) -> ("pCreateInfo" ::: Ptr VkDisplayModeCreateInfoKHR) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> ("pMode" ::: Ptr VkDisplayModeKHR) -> IO VkResult Source #

vkCreateDisplayModeKHR - Create a display mode

Parameters

  • physicalDevice is the physical device associated with display.
  • display is the display to create an additional mode for.
  • pCreateInfo is a VkDisplayModeCreateInfoKHR structure describing the new mode to create.
  • pAllocator is the allocator used for host memory allocated for the display mode object when there is no more specific allocator available (see Memory Allocation).
  • pMode returns the handle of the mode created.

Valid Usage (Implicit)

  • physicalDevice must be a valid VkPhysicalDevice handle
  • display must be a valid VkDisplayKHR handle
  • pCreateInfo must be a valid pointer to a valid VkDisplayModeCreateInfoKHR structure
  • If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure
  • pMode must be a valid pointer to a VkDisplayModeKHR handle

Host Synchronization

  • Host access to display must be externally synchronized

Return Codes

[Success] - VK_SUCCESS

[Failure] - VK_ERROR_OUT_OF_HOST_MEMORY

  • VK_ERROR_OUT_OF_DEVICE_MEMORY
  • VK_ERROR_INITIALIZATION_FAILED

See Also

VkAllocationCallbacks, VkDisplayKHR, VkDisplayModeCreateInfoKHR, VkDisplayModeKHR, VkPhysicalDevice

vkGetDisplayPlaneCapabilitiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("mode" ::: VkDisplayModeKHR) -> ("planeIndex" ::: Word32) -> ("pCapabilities" ::: Ptr VkDisplayPlaneCapabilitiesKHR) -> IO VkResult Source #

vkGetDisplayPlaneCapabilitiesKHR - Query capabilities of a mode and plane combination

Parameters

  • physicalDevice is the physical device associated with display
  • mode is the display mode the application intends to program when using the specified plane. Note this parameter also implicitly specifies a display.
  • planeIndex is the plane which the application intends to use with the display, and is less than the number of display planes supported by the device.
  • pCapabilities is a pointer to a VkDisplayPlaneCapabilitiesKHR structure in which the capabilities are returned.

Valid Usage (Implicit)

  • physicalDevice must be a valid VkPhysicalDevice handle
  • mode must be a valid VkDisplayModeKHR handle
  • pCapabilities must be a valid pointer to a VkDisplayPlaneCapabilitiesKHR structure

Host Synchronization

  • Host access to mode must be externally synchronized

Return Codes

[Success] - VK_SUCCESS

[Failure] - VK_ERROR_OUT_OF_HOST_MEMORY

  • VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkDisplayModeKHR, VkDisplayPlaneCapabilitiesKHR, VkPhysicalDevice

vkCreateDisplayPlaneSurfaceKHR :: ("instance" ::: VkInstance) -> ("pCreateInfo" ::: Ptr VkDisplaySurfaceCreateInfoKHR) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> ("pSurface" ::: Ptr VkSurfaceKHR) -> IO VkResult Source #

vkCreateDisplayPlaneSurfaceKHR - Create a VkSurfaceKHR structure representing a display plane and mode

Parameters

  • instance is the instance corresponding to the physical device the targeted display is on.
  • pCreateInfo is a pointer to an instance of the VkDisplaySurfaceCreateInfoKHR structure specifying which mode, plane, and other parameters to use, as described below.
  • pAllocator is the allocator used for host memory allocated for the surface object when there is no more specific allocator available (see Memory Allocation).
  • pSurface points to a VkSurfaceKHR handle in which the created surface is returned.

Valid Usage (Implicit)

  • instance must be a valid VkInstance handle
  • pCreateInfo must be a valid pointer to a valid VkDisplaySurfaceCreateInfoKHR structure
  • If pAllocator is not NULL, pAllocator must be a valid pointer to a valid VkAllocationCallbacks structure
  • pSurface must be a valid pointer to a VkSurfaceKHR handle

Return Codes

[Success] - VK_SUCCESS

[Failure] - VK_ERROR_OUT_OF_HOST_MEMORY

  • VK_ERROR_OUT_OF_DEVICE_MEMORY

See Also

VkAllocationCallbacks, VkDisplaySurfaceCreateInfoKHR, VkInstance, VkSurfaceKHR

data VkDisplayPropertiesKHR Source #

VkDisplayPropertiesKHR - Structure describing an available display device

Description

Note

For devices which have no natural value to return here, implementations should return the maximum resolution supported.

  • supportedTransforms tells which transforms are supported by this display. This will contain one or more of the bits from VkSurfaceTransformFlagsKHR.
  • planeReorderPossible tells whether the planes on this display can have their z order changed. If this is VK_TRUE, the application can re-arrange the planes on this display in any order relative to each other.
  • persistentContent tells 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

VkBool32, VkDisplayKHR, VkExtent2D, VkSurfaceTransformFlagsKHR, vkGetPhysicalDeviceDisplayPropertiesKHR

Constructors

VkDisplayPropertiesKHR 

Fields

data VkDisplayPlanePropertiesKHR Source #

VkDisplayPlanePropertiesKHR - Structure describing display plane properties

See Also

VkDisplayKHR, vkGetPhysicalDeviceDisplayPlanePropertiesKHR

Constructors

VkDisplayPlanePropertiesKHR 

Fields

  • vkCurrentDisplay :: VkDisplayKHR

    currentDisplay is the handle of the display the plane is currently associated with. If the plane is not currently attached to any displays, this will be VK_NULL_HANDLE.

  • vkCurrentStackIndex :: Word32

    currentStackIndex is the current z-order of the plane. This will be between 0 and the value returned by vkGetPhysicalDeviceDisplayPlanePropertiesKHR in pPropertyCount.

data VkDisplayModeParametersKHR Source #

VkDisplayModeParametersKHR - Structure describing display parameters associated with a display mode

Description

Note

For example, a 60Hz display mode would report a refreshRate of 60,000.

See Also

VkDisplayModeCreateInfoKHR, VkDisplayModePropertiesKHR, VkExtent2D

Constructors

VkDisplayModeParametersKHR 

Fields

data VkDisplayModePropertiesKHR Source #

VkDisplayModePropertiesKHR - Structure describing display mode properties

See Also

VkDisplayModeKHR, VkDisplayModeParametersKHR, vkGetDisplayModePropertiesKHR

Constructors

VkDisplayModePropertiesKHR 

Fields

data VkDisplayModeCreateInfoKHR Source #

VkDisplayModeCreateInfoKHR - Structure specifying parameters of a newly created display mode object

Valid Usage

  • The width and height members of the visibleRegion member of parameters must be greater than 0
  • The refreshRate member of parameters must be greater than 0

Valid Usage (Implicit)

  • sType must be VK_STRUCTURE_TYPE_DISPLAY_MODE_CREATE_INFO_KHR
  • pNext must be NULL
  • flags must be 0

See Also

VkDisplayModeCreateFlagsKHR, VkDisplayModeParametersKHR, VkStructureType, vkCreateDisplayModeKHR

Constructors

VkDisplayModeCreateInfoKHR 

Fields

data VkDisplayPlaneCapabilitiesKHR Source #

VkDisplayPlaneCapabilitiesKHR - Structure describing capabilities of a mode and plane combination

Description

The minimum and maximum position and extent fields describe the implementation limits, if any, as they apply to the specified display mode and plane. Vendors may support displaying a subset of a swapchain’s presentable images on the specified display plane. This is expressed by returning minSrcPosition, maxSrcPosition, minSrcExtent, and maxSrcExtent values that indicate a range of possible positions and sizes may be used to specify the region within the presentable images that source pixels will be read from when creating a swapchain on the specified display mode and plane.

Vendors may also support mapping the presentable images’ content to a subset or superset of the visible region in the specified display mode. This is expressed by returning minDstPosition, maxDstPosition, minDstExtent and maxDstExtent values that indicate a range of possible positions and sizes may be used to describe the region within the display mode that the source pixels will be mapped to.

Other vendors may support only a 1-1 mapping between pixels in the presentable images and the display mode. This may be indicated by returning (0,0) for minSrcPosition, maxSrcPosition, minDstPosition, and maxDstPosition, and (display mode width, display mode height) for minSrcExtent, maxSrcExtent, minDstExtent, and maxDstExtent.

These values indicate the limits of the implementation’s individual fields. Not all combinations of values within the offset and extent ranges returned in VkDisplayPlaneCapabilitiesKHR are guaranteed to be supported. Vendors may still fail presentation requests that specify unsupported combinations.

See Also

VkDisplayPlaneAlphaFlagsKHR, VkExtent2D, VkOffset2D, vkGetDisplayPlaneCapabilitiesKHR

Constructors

VkDisplayPlaneCapabilitiesKHR 

Fields

data VkDisplaySurfaceCreateInfoKHR Source #

VkDisplaySurfaceCreateInfoKHR - Structure specifying parameters of a newly created display plane surface object

Description

Note

Creating a display surface must not modify the state of the displays, planes, or other resources it names. For example, it must not apply the specified mode to be set on the associated display. Application of display configuration occurs as a side effect of presenting to a display surface.

Valid Usage

  • planeIndex must be less than the number of display planes supported by the device as determined by calling vkGetPhysicalDeviceDisplayPlanePropertiesKHR
  • If the planeReorderPossible member of the VkDisplayPropertiesKHR structure returned by vkGetPhysicalDeviceDisplayPropertiesKHR for the display corresponding to displayMode is VK_TRUE then planeStackIndex must be less than the number of display planes supported by the device as determined by calling vkGetPhysicalDeviceDisplayPlanePropertiesKHR; otherwise planeStackIndex must equal the currentStackIndex member of VkDisplayPlanePropertiesKHR returned by vkGetPhysicalDeviceDisplayPlanePropertiesKHR for the display plane corresponding to displayMode
  • If alphaMode is VK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHR then globalAlpha must be between 0 and 1, inclusive
  • alphaMode must be 0 or one of the bits present in the supportedAlpha member of VkDisplayPlaneCapabilitiesKHR returned by vkGetDisplayPlaneCapabilitiesKHR for the display plane corresponding to displayMode
  • The width and height members of imageExtent must be less than the maxImageDimensions2D member of VkPhysicalDeviceLimits

Valid Usage (Implicit)

  • sType must be VK_STRUCTURE_TYPE_DISPLAY_SURFACE_CREATE_INFO_KHR

See Also

VkDisplayModeKHR, VkDisplayPlaneAlphaFlagBitsKHR, VkDisplaySurfaceCreateFlagsKHR, VkExtent2D, VkStructureType, VkSurfaceTransformFlagBitsKHR, vkCreateDisplayPlaneSurfaceKHR

Constructors

VkDisplaySurfaceCreateInfoKHR 

Fields

type VkDisplayPlaneAlphaFlagsKHR = VkDisplayPlaneAlphaFlagBitsKHR Source #

VkDisplayPlaneAlphaFlagsKHR - Bitmask of VkDisplayPlaneAlphaFlagBitsKHR

Description

VkDisplayPlaneAlphaFlagsKHR is a bitmask type for setting a mask of zero or more VkDisplayPlaneAlphaFlagBitsKHR.

See Also

VkDisplayPlaneAlphaFlagBitsKHR, VkDisplayPlaneCapabilitiesKHR