| Safe Haskell | None |
|---|---|
| Language | Haskell2010 |
Graphics.Vulkan.Extensions.VK_KHR_display
- newtype VkDisplayPlaneAlphaFlagBitsKHR = VkDisplayPlaneAlphaFlagBitsKHR VkFlags
- pattern VK_DISPLAY_PLANE_ALPHA_OPAQUE_BIT_KHR :: VkDisplayPlaneAlphaFlagBitsKHR
- pattern VK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHR :: VkDisplayPlaneAlphaFlagBitsKHR
- pattern VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_BIT_KHR :: VkDisplayPlaneAlphaFlagBitsKHR
- pattern VK_DISPLAY_PLANE_ALPHA_PER_PIXEL_PREMULTIPLIED_BIT_KHR :: VkDisplayPlaneAlphaFlagBitsKHR
- newtype VkDisplayModeCreateFlagsKHR = VkDisplayModeCreateFlagsKHR VkFlags
- newtype VkDisplaySurfaceCreateFlagsKHR = VkDisplaySurfaceCreateFlagsKHR VkFlags
- pattern VK_STRUCTURE_TYPE_DISPLAY_MODE_CREATE_INFO_KHR :: VkStructureType
- pattern VK_STRUCTURE_TYPE_DISPLAY_SURFACE_CREATE_INFO_KHR :: VkStructureType
- pattern VK_OBJECT_TYPE_DISPLAY_KHR :: VkObjectType
- pattern VK_OBJECT_TYPE_DISPLAY_MODE_KHR :: VkObjectType
- pattern VK_KHR_DISPLAY_SPEC_VERSION :: Integral a => a
- pattern VK_KHR_DISPLAY_EXTENSION_NAME :: (Eq a, IsString a) => a
- type VkDisplayKHR = Ptr VkDisplayKHR_T
- type VkDisplayModeKHR = Ptr VkDisplayModeKHR_T
- vkGetPhysicalDeviceDisplayPropertiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("pPropertyCount" ::: Ptr Word32) -> ("pProperties" ::: Ptr VkDisplayPropertiesKHR) -> IO VkResult
- vkGetPhysicalDeviceDisplayPlanePropertiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("pPropertyCount" ::: Ptr Word32) -> ("pProperties" ::: Ptr VkDisplayPlanePropertiesKHR) -> IO VkResult
- vkGetDisplayPlaneSupportedDisplaysKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("planeIndex" ::: Word32) -> ("pDisplayCount" ::: Ptr Word32) -> ("pDisplays" ::: Ptr VkDisplayKHR) -> IO VkResult
- vkGetDisplayModePropertiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("display" ::: VkDisplayKHR) -> ("pPropertyCount" ::: Ptr Word32) -> ("pProperties" ::: Ptr VkDisplayModePropertiesKHR) -> IO VkResult
- vkCreateDisplayModeKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("display" ::: VkDisplayKHR) -> ("pCreateInfo" ::: Ptr VkDisplayModeCreateInfoKHR) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> ("pMode" ::: Ptr VkDisplayModeKHR) -> IO VkResult
- vkGetDisplayPlaneCapabilitiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("mode" ::: VkDisplayModeKHR) -> ("planeIndex" ::: Word32) -> ("pCapabilities" ::: Ptr VkDisplayPlaneCapabilitiesKHR) -> IO VkResult
- vkCreateDisplayPlaneSurfaceKHR :: ("instance" ::: VkInstance) -> ("pCreateInfo" ::: Ptr VkDisplaySurfaceCreateInfoKHR) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> ("pSurface" ::: Ptr VkSurfaceKHR) -> IO VkResult
- data VkDisplayPropertiesKHR = VkDisplayPropertiesKHR {}
- data VkDisplayPlanePropertiesKHR = VkDisplayPlanePropertiesKHR {}
- data VkDisplayModeParametersKHR = VkDisplayModeParametersKHR {}
- data VkDisplayModePropertiesKHR = VkDisplayModePropertiesKHR {}
- data VkDisplayModeCreateInfoKHR = VkDisplayModeCreateInfoKHR {}
- data VkDisplayPlaneCapabilitiesKHR = VkDisplayPlaneCapabilitiesKHR {}
- data VkDisplaySurfaceCreateInfoKHR = VkDisplaySurfaceCreateInfoKHR {
- vkSType :: VkStructureType
- vkPNext :: Ptr ()
- vkFlags :: VkDisplaySurfaceCreateFlagsKHR
- vkDisplayMode :: VkDisplayModeKHR
- vkPlaneIndex :: Word32
- vkPlaneStackIndex :: Word32
- vkTransform :: VkSurfaceTransformFlagBitsKHR
- vkGlobalAlpha :: CFloat
- vkAlphaMode :: VkDisplayPlaneAlphaFlagBitsKHR
- vkImageExtent :: VkExtent2D
- type VkDisplayPlaneAlphaFlagsKHR = VkDisplayPlaneAlphaFlagBitsKHR
Documentation
newtype VkDisplayPlaneAlphaFlagBitsKHR Source #
VkDisplayPlaneAlphaFlagBitsKHR - Alpha blending type
See Also
Constructors
| VkDisplayPlaneAlphaFlagBitsKHR VkFlags |
Instances
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 #
Constructors
| VkDisplayModeCreateFlagsKHR VkFlags |
Instances
newtype VkDisplaySurfaceCreateFlagsKHR Source #
Constructors
| VkDisplaySurfaceCreateFlagsKHR VkFlags |
Instances
pattern VK_OBJECT_TYPE_DISPLAY_KHR :: VkObjectType Source #
pattern VK_OBJECT_TYPE_DISPLAY_MODE_KHR :: VkObjectType Source #
pattern VK_KHR_DISPLAY_SPEC_VERSION :: Integral a => a Source #
pattern VK_KHR_DISPLAY_EXTENSION_NAME :: (Eq a, IsString a) => a Source #
type VkDisplayKHR = Ptr VkDisplayKHR_T Source #
VkDisplayKHR - Opaque handle to a display object
Description
See Also
VkDisplayPlanePropertiesKHR, VkDisplayPropertiesKHR,
vkAcquireXlibDisplayEXT,
vkCreateDisplayModeKHR,
vkDisplayPowerControlEXT,
vkGetDisplayModePropertiesKHR,
vkGetDisplayPlaneSupportedDisplaysKHR,
vkGetRandROutputDisplayEXT,
vkRegisterDisplayEventEXT,
vkReleaseDisplayEXT
type VkDisplayModeKHR = Ptr VkDisplayModeKHR_T Source #
VkDisplayModeKHR - Opaque handle to a display mode object
Description
See Also
VkDisplayModePropertiesKHR, VkDisplaySurfaceCreateInfoKHR,
vkCreateDisplayModeKHR, vkGetDisplayPlaneCapabilitiesKHR
vkGetPhysicalDeviceDisplayPropertiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("pPropertyCount" ::: Ptr Word32) -> ("pProperties" ::: Ptr VkDisplayPropertiesKHR) -> IO VkResult Source #
vkGetPhysicalDeviceDisplayPropertiesKHR - Query information about the available displays
Parameters
physicalDeviceis a physical device.
pPropertyCountis a pointer to an integer related to the number of display devices available or queried, as described below.pPropertiesis eitherNULLor a pointer to an array ofVkDisplayPropertiesKHRstructures.
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)
physicalDevicemust be a validVkPhysicalDevicehandle
pPropertyCountmust be a valid pointer to auint32_tvalue- If the value referenced by
pPropertyCountis not0, andpPropertiesis notNULL,pPropertiesmust be a valid pointer to an array ofpPropertyCountVkDisplayPropertiesKHRstructures
Return Codes
- Success
- -
VK_SUCCESSVK_INCOMPLETE
- Failure
- -
VK_ERROR_OUT_OF_HOST_MEMORYVK_ERROR_OUT_OF_DEVICE_MEMORY
See Also
vkGetPhysicalDeviceDisplayPlanePropertiesKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("pPropertyCount" ::: Ptr Word32) -> ("pProperties" ::: Ptr VkDisplayPlanePropertiesKHR) -> IO VkResult Source #
vkGetPhysicalDeviceDisplayPlanePropertiesKHR - Query the plane properties
Parameters
physicalDeviceis a physical device.
pPropertyCountis a pointer to an integer related to the number of display planes available or queried, as described below.pPropertiesis eitherNULLor a pointer to an array ofVkDisplayPlanePropertiesKHRstructures.
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)
physicalDevicemust be a validVkPhysicalDevicehandle
pPropertyCountmust be a valid pointer to auint32_tvalue- If the value referenced by
pPropertyCountis not0, andpPropertiesis notNULL,pPropertiesmust be a valid pointer to an array ofpPropertyCountVkDisplayPlanePropertiesKHRstructures
Return Codes
- Success
- -
VK_SUCCESSVK_INCOMPLETE
- Failure
- -
VK_ERROR_OUT_OF_HOST_MEMORYVK_ERROR_OUT_OF_DEVICE_MEMORY
See Also
vkGetDisplayPlaneSupportedDisplaysKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("planeIndex" ::: Word32) -> ("pDisplayCount" ::: Ptr Word32) -> ("pDisplays" ::: Ptr VkDisplayKHR) -> IO VkResult Source #
vkGetDisplayPlaneSupportedDisplaysKHR - Query the list of displays a plane supports
Parameters
physicalDeviceis a physical device.
planeIndexis the plane which the application wishes to use, and must be in the range [0, physical device plane count - 1].pDisplayCountis a pointer to an integer related to the number of displays available or queried, as described below.pDisplaysis eitherNULLor a pointer to an array ofVkDisplayKHRhandles.
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
planeIndexmust be less than the number of display planes supported by the device as determined by callingvkGetPhysicalDeviceDisplayPlanePropertiesKHR
Valid Usage (Implicit)
physicalDevicemust be a validVkPhysicalDevicehandle
pDisplayCountmust be a valid pointer to auint32_tvalue- If the value referenced by
pDisplayCountis not0, andpDisplaysis notNULL,pDisplaysmust be a valid pointer to an array ofpDisplayCountVkDisplayKHRhandles
Return Codes
- Success
- -
VK_SUCCESSVK_INCOMPLETE
- Failure
- -
VK_ERROR_OUT_OF_HOST_MEMORYVK_ERROR_OUT_OF_DEVICE_MEMORY
See Also
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
physicalDeviceis the physical device associated withdisplay.
displayis the display to query.pPropertyCountis a pointer to an integer related to the number of display modes available or queried, as described below.pPropertiesis eitherNULLor a pointer to an array ofVkDisplayModePropertiesKHRstructures.
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)
physicalDevicemust be a validVkPhysicalDevicehandle
displaymust be a validVkDisplayKHRhandlepPropertyCountmust be a valid pointer to auint32_tvalue- If the value referenced by
pPropertyCountis not0, andpPropertiesis notNULL,pPropertiesmust be a valid pointer to an array ofpPropertyCountVkDisplayModePropertiesKHRstructures
Return Codes
- Success
- -
VK_SUCCESSVK_INCOMPLETE
- Failure
- -
VK_ERROR_OUT_OF_HOST_MEMORYVK_ERROR_OUT_OF_DEVICE_MEMORY
See Also
vkCreateDisplayModeKHR :: ("physicalDevice" ::: VkPhysicalDevice) -> ("display" ::: VkDisplayKHR) -> ("pCreateInfo" ::: Ptr VkDisplayModeCreateInfoKHR) -> ("pAllocator" ::: Ptr VkAllocationCallbacks) -> ("pMode" ::: Ptr VkDisplayModeKHR) -> IO VkResult Source #
vkCreateDisplayModeKHR - Create a display mode
Parameters
physicalDeviceis the physical device associated withdisplay.
displayis the display to create an additional mode for.pCreateInfois aVkDisplayModeCreateInfoKHRstructure describing the new mode to create.pAllocatoris the allocator used for host memory allocated for the display mode object when there is no more specific allocator available (see Memory Allocation).pModereturns the handle of the mode created.
Description
Valid Usage (Implicit)
physicalDevicemust be a validVkPhysicalDevicehandle
displaymust be a validVkDisplayKHRhandlepCreateInfomust be a valid pointer to a validVkDisplayModeCreateInfoKHRstructure- If
pAllocatoris notNULL,pAllocatormust be a valid pointer to a validVkAllocationCallbacksstructure pModemust be a valid pointer to aVkDisplayModeKHRhandle
Host Synchronization
- Host access to
displaymust be externally synchronized
Return Codes
- Success
- -
VK_SUCCESS
- Failure
- -
VK_ERROR_OUT_OF_HOST_MEMORYVK_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
physicalDeviceis the physical device associated withdisplay
modeis the display mode the application intends to program when using the specified plane. Note this parameter also implicitly specifies a display.planeIndexis the plane which the application intends to use with the display, and is less than the number of display planes supported by the device.pCapabilitiesis a pointer to aVkDisplayPlaneCapabilitiesKHRstructure in which the capabilities are returned.
Description
Valid Usage (Implicit)
physicalDevicemust be a validVkPhysicalDevicehandle
modemust be a validVkDisplayModeKHRhandlepCapabilitiesmust be a valid pointer to aVkDisplayPlaneCapabilitiesKHRstructure
Host Synchronization
- Host access to
modemust be externally synchronized
Return Codes
- Success
- -
VK_SUCCESS
- Failure
- -
VK_ERROR_OUT_OF_HOST_MEMORYVK_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
instanceis the instance corresponding to the physical device the targeted display is on.
pCreateInfois a pointer to an instance of theVkDisplaySurfaceCreateInfoKHRstructure specifying which mode, plane, and other parameters to use, as described below.pAllocatoris the allocator used for host memory allocated for the surface object when there is no more specific allocator available (see Memory Allocation).pSurfacepoints to aVkSurfaceKHRhandle in which the created surface is returned.
Description
Valid Usage (Implicit)
instancemust be a validVkInstancehandle
pCreateInfomust be a valid pointer to a validVkDisplaySurfaceCreateInfoKHRstructure- If
pAllocatoris notNULL,pAllocatormust be a valid pointer to a validVkAllocationCallbacksstructure pSurfacemust be a valid pointer to aVkSurfaceKHRhandle
Return Codes
- Success
- -
VK_SUCCESS
- Failure
- -
VK_ERROR_OUT_OF_HOST_MEMORYVK_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.
supportedTransformstells which transforms are supported by this display. This will contain one or more of the bits fromVkSurfaceTransformFlagsKHR.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
VkBool32, VkDisplayKHR,
VkExtent2D,
VkSurfaceTransformFlagsKHR,
vkGetPhysicalDeviceDisplayPropertiesKHR
Constructors
| VkDisplayPropertiesKHR | |
Fields
| |
data VkDisplayPlanePropertiesKHR Source #
VkDisplayPlanePropertiesKHR - Structure describing display plane properties
Description
See Also
Constructors
| VkDisplayPlanePropertiesKHR | |
Fields
| |
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
Description
See Also
VkDisplayModeKHR, VkDisplayModeParametersKHR,
vkGetDisplayModePropertiesKHR
Constructors
| VkDisplayModePropertiesKHR | |
Fields
| |
data VkDisplayModeCreateInfoKHR Source #
VkDisplayModeCreateInfoKHR - Structure specifying parameters of a newly created display mode object
Description
Valid Usage
- The
widthandheightmembers of thevisibleRegionmember ofparametersmust be greater than0
- The
refreshRatemember ofparametersmust be greater than0
Valid Usage (Implicit)
sTypemust beVK_STRUCTURE_TYPE_DISPLAY_MODE_CREATE_INFO_KHR
pNextmust beNULLflagsmust be0
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
planeIndexmust be less than the number of display planes supported by the device as determined by callingvkGetPhysicalDeviceDisplayPlanePropertiesKHR
- If the
planeReorderPossiblemember of theVkDisplayPropertiesKHRstructure returned byvkGetPhysicalDeviceDisplayPropertiesKHRfor the display corresponding todisplayModeisVK_TRUEthenplaneStackIndexmust be less than the number of display planes supported by the device as determined by callingvkGetPhysicalDeviceDisplayPlanePropertiesKHR; otherwiseplaneStackIndexmust equal thecurrentStackIndexmember ofVkDisplayPlanePropertiesKHRreturned byvkGetPhysicalDeviceDisplayPlanePropertiesKHRfor the display plane corresponding todisplayMode - If
alphaModeisVK_DISPLAY_PLANE_ALPHA_GLOBAL_BIT_KHRthenglobalAlphamust be between0and1, inclusive alphaModemust be0or one of the bits present in thesupportedAlphamember ofVkDisplayPlaneCapabilitiesKHRreturned byvkGetDisplayPlaneCapabilitiesKHRfor the display plane corresponding todisplayMode- The
widthandheightmembers ofimageExtentmust be less than themaxImageDimensions2Dmember ofVkPhysicalDeviceLimits
Valid Usage (Implicit)
sTypemust beVK_STRUCTURE_TYPE_DISPLAY_SURFACE_CREATE_INFO_KHR
pNextmust beNULLflagsmust be0displayModemust be a validVkDisplayModeKHRhandletransformmust be a validVkSurfaceTransformFlagBitsKHRvaluealphaModemust be a validVkDisplayPlaneAlphaFlagBitsKHRvalue
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