| Safe Haskell | None |
|---|---|
| Language | Haskell2010 |
OpenXR.Extensions.XR_KHR_vulkan_enable2
Description
Name
XR_KHR_vulkan_enable2 - instance extension
Specification
See XR_KHR_vulkan_enable2 in the main specification for complete information.
Registered Extension Number
91
Revision
1
Extension and Version Dependencies
- Requires OpenXR 1.0
See Also
GraphicsBindingVulkan2KHR, GraphicsRequirementsVulkan2KHR,
SwapchainImageVulkan2KHR, VulkanDeviceCreateInfoKHR,
VulkanGraphicsDeviceGetInfoKHR, VulkanInstanceCreateInfoKHR,
createVulkanDeviceKHR, createVulkanInstanceKHR,
getVulkanGraphicsDevice2KHR, getVulkanGraphicsRequirements2KHR
Document Notes
For more information, see the OpenXR Specification
This page is a generated document. Fixes and changes should be made to the generator scripts, not directly.
Synopsis
- createVulkanInstanceKHR :: forall io. MonadIO io => Instance -> VulkanInstanceCreateInfoKHR -> io ("vulkanInstance" ::: Ptr Instance_T, "vulkanResult" ::: Result)
- createVulkanDeviceKHR :: forall io. MonadIO io => Instance -> VulkanDeviceCreateInfoKHR -> io ("vulkanDevice" ::: Ptr Device_T, "vulkanResult" ::: Result)
- getVulkanGraphicsDevice2KHR :: forall io. MonadIO io => Instance -> VulkanGraphicsDeviceGetInfoKHR -> io ("vulkanPhysicalDevice" ::: Ptr PhysicalDevice_T)
- pattern TYPE_GRAPHICS_BINDING_VULKAN2_KHR :: StructureType
- pattern TYPE_SWAPCHAIN_IMAGE_VULKAN2_KHR :: StructureType
- pattern TYPE_GRAPHICS_REQUIREMENTS_VULKAN2_KHR :: StructureType
- getVulkanGraphicsRequirements2KHR :: MonadIO io => Instance -> SystemId -> io GraphicsRequirementsVulkanKHR
- data VulkanInstanceCreateInfoKHR = VulkanInstanceCreateInfoKHR {}
- data VulkanDeviceCreateInfoKHR = VulkanDeviceCreateInfoKHR {}
- data VulkanGraphicsDeviceGetInfoKHR = VulkanGraphicsDeviceGetInfoKHR {}
- newtype VulkanInstanceCreateFlagsKHR = VulkanInstanceCreateFlagsKHR Flags64
- newtype VulkanDeviceCreateFlagsKHR = VulkanDeviceCreateFlagsKHR Flags64
- type GraphicsBindingVulkan2KHR = GraphicsBindingVulkanKHR
- type SwapchainImageVulkan2KHR = SwapchainImageVulkanKHR
- type GraphicsRequirementsVulkan2KHR = GraphicsRequirementsVulkanKHR
- type KHR_vulkan_enable2_SPEC_VERSION = 1
- pattern KHR_vulkan_enable2_SPEC_VERSION :: forall a. Integral a => a
- type KHR_VULKAN_ENABLE2_EXTENSION_NAME = "XR_KHR_vulkan_enable2"
- pattern KHR_VULKAN_ENABLE2_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a
- data GraphicsBindingVulkanKHR = GraphicsBindingVulkanKHR {}
- data SwapchainImageVulkanKHR = SwapchainImageVulkanKHR {}
- data GraphicsRequirementsVulkanKHR = GraphicsRequirementsVulkanKHR {}
- getVulkanGraphicsRequirementsKHR :: forall io. MonadIO io => Instance -> SystemId -> io GraphicsRequirementsVulkanKHR
Documentation
createVulkanInstanceKHR Source #
Arguments
| :: forall io. MonadIO io | |
| => Instance |
|
| -> VulkanInstanceCreateInfoKHR |
|
| -> io ("vulkanInstance" ::: Ptr Instance_T, "vulkanResult" ::: Result) |
xrCreateVulkanInstanceKHR - Create an OpenXR compatible VkInstance
Valid Usage (Implicit)
- The @@
extension must be enabled prior to calling
createVulkanInstanceKHR
-
instancemust be a validInstancehandle -
createInfomust be a pointer to a validVulkanInstanceCreateInfoKHRstructure -
vulkanInstancemust be a pointer to aVkInstancevalue -
vulkanResultmust be a pointer to aVkResultvalue
Return Codes
See Also
Instance, VulkanInstanceCreateInfoKHR,
createVulkanDeviceKHR
createVulkanDeviceKHR Source #
Arguments
| :: forall io. MonadIO io | |
| => Instance |
|
| -> VulkanDeviceCreateInfoKHR |
|
| -> io ("vulkanDevice" ::: Ptr Device_T, "vulkanResult" ::: Result) |
xrCreateVulkanDeviceKHR - Create an OpenXR compatible VkDevice
Valid Usage (Implicit)
- The @@ extension
must be enabled prior to calling
createVulkanDeviceKHR
-
instancemust be a validInstancehandle -
createInfomust be a pointer to a validVulkanDeviceCreateInfoKHRstructure -
vulkanDevicemust be a pointer to aVkDevicevalue -
vulkanResultmust be a pointer to aVkResultvalue
Return Codes
See Also
Instance, VulkanDeviceCreateInfoKHR,
createVulkanInstanceKHR
getVulkanGraphicsDevice2KHR Source #
Arguments
| :: forall io. MonadIO io | |
| => Instance |
|
| -> VulkanGraphicsDeviceGetInfoKHR |
|
| -> io ("vulkanPhysicalDevice" ::: Ptr PhysicalDevice_T) |
xrGetVulkanGraphicsDevice2KHR - Retrieve the Vulkan physical device associated with an OpenXR instance and system
Valid Usage (Implicit)
- The @@
extension must be enabled prior to calling
getVulkanGraphicsDevice2KHR
-
instancemust be a validInstancehandle -
getInfomust be a pointer to a validVulkanGraphicsDeviceGetInfoKHRstructure -
vulkanPhysicalDevicemust be a pointer to aVkPhysicalDevicevalue
Return Codes
See Also
pattern TYPE_GRAPHICS_BINDING_VULKAN2_KHR :: StructureType Source #
pattern TYPE_SWAPCHAIN_IMAGE_VULKAN2_KHR :: StructureType Source #
getVulkanGraphicsRequirements2KHR :: MonadIO io => Instance -> SystemId -> io GraphicsRequirementsVulkanKHR Source #
xrGetVulkanGraphicsRequirements2KHR - Retrieve the Vulkan version requirements for an instance and system
Parameters
The
getVulkanGraphicsRequirementsKHR
function identifies to the application the runtime’s minimum Vulkan
version requirement and the highest known tested Vulkan version.
getVulkanGraphicsRequirementsKHR
must be called prior to calling createSession.
The runtime must return
ERROR_GRAPHICS_REQUIREMENTS_CALL_MISSING on
calls to createSession if
getVulkanGraphicsRequirements2KHR has not been called for the same
instance and systemId.
Parameter Descriptions
instanceis anInstancehandle previously created withcreateInstance.
systemIdis an https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId handle for the system which will be used to create a session.graphicsRequirementsis theGraphicsRequirementsVulkan2KHRoutput structure.
Valid Usage (Implicit)
- The
@@ extension must be enabled prior to calling
getVulkanGraphicsRequirements2KHR
-
instancemust be a validInstancehandle -
graphicsRequirementsmust be a pointer to anGraphicsRequirementsVulkanKHRstructure
Return Codes
See Also
GraphicsRequirementsVulkan2KHR,
GraphicsRequirementsVulkanKHR,
Instance,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId
data VulkanInstanceCreateInfoKHR Source #
XrVulkanInstanceCreateInfoKHR - Vulkan Instance Create Info
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
VulkanInstanceCreateInfoKHR
-
typemust beTYPE_VULKAN_INSTANCE_CREATE_INFO_KHR -
nextmust beNULLor a valid pointer to the next structure in a structure chain -
createFlagsmust be0 -
pfnGetInstanceProcAddrmust be a validPFN_vkGetInstanceProcAddrvalue -
vulkanCreateInfomust be a pointer to a validVkInstanceCreateInfovalue -
vulkanAllocatormust be a pointer to a validVkAllocationCallbacksvalue
See Also
StructureType,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId,
VulkanInstanceCreateFlagsKHR, createVulkanInstanceKHR
Constructors
| VulkanInstanceCreateInfoKHR | |
Fields
| |
Instances
data VulkanDeviceCreateInfoKHR Source #
XrVulkanDeviceCreateInfoKHR - Vulkan Device Create Info
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
VulkanDeviceCreateInfoKHR
-
typemust beTYPE_VULKAN_DEVICE_CREATE_INFO_KHR -
nextmust beNULLor a valid pointer to the next structure in a structure chain -
createFlagsmust be0 -
pfnGetInstanceProcAddrmust be a validPFN_vkGetInstanceProcAddrvalue -
vulkanPhysicalDevicemust be a validVkPhysicalDevicevalue -
vulkanCreateInfomust be a pointer to a validVkDeviceCreateInfovalue -
vulkanAllocatormust be a pointer to a validVkAllocationCallbacksvalue
See Also
StructureType,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId,
VulkanDeviceCreateFlagsKHR, createVulkanDeviceKHR
Constructors
| VulkanDeviceCreateInfoKHR | |
Fields
| |
Instances
data VulkanGraphicsDeviceGetInfoKHR Source #
XrVulkanGraphicsDeviceGetInfoKHR - Vulkan Graphics Device Get Info
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
VulkanGraphicsDeviceGetInfoKHR
-
typemust beTYPE_VULKAN_GRAPHICS_DEVICE_GET_INFO_KHR -
nextmust beNULLor a valid pointer to the next structure in a structure chain -
vulkanInstancemust be a validVkInstancevalue
See Also
StructureType,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId,
getVulkanGraphicsDevice2KHR
Constructors
| VulkanGraphicsDeviceGetInfoKHR | |
Fields
| |
Instances
newtype VulkanInstanceCreateFlagsKHR Source #
XrVulkanInstanceCreateFlagsKHR - Vulkan Instance Create Info Flags
See Also
Constructors
| VulkanInstanceCreateFlagsKHR Flags64 |
Instances
newtype VulkanDeviceCreateFlagsKHR Source #
Constructors
| VulkanDeviceCreateFlagsKHR Flags64 |
Instances
type GraphicsBindingVulkan2KHR = GraphicsBindingVulkanKHR Source #
XrGraphicsBindingVulkan2KHR - The graphics binding structure to be passed at session creation to use Vulkan
Valid Usage
instancemust have enabled a Vulkan API version in the range specified bygetVulkanGraphicsRequirements2KHR
instancemust have been created usingcreateVulkanInstanceKHRphysicalDeviceVkPhysicalDevicemust match the device specified bygetVulkanGraphicsDevice2KHRdevicemust have been created usingcreateVulkanDeviceKHR
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
GraphicsBindingVulkan2KHR
- Note:
GraphicsBindingVulkan2KHRis an alias forGraphicsBindingVulkanKHR, so implicit valid usage forGraphicsBindingVulkanKHRhas been replicated below. typemust beTYPE_GRAPHICS_BINDING_VULKAN_KHRnextmust beNULLor a valid pointer to the next structure in a structure chaininstancemust be a validVkInstancevaluephysicalDevicemust be a validVkPhysicalDevicevaluedevicemust be a validVkDevicevalue
See Also
type SwapchainImageVulkan2KHR = SwapchainImageVulkanKHR Source #
XrSwapchainImageVulkan2KHR - Vulkan-specific swapchain image structure
Member Descriptions
Description
If a given session was created with GraphicsBindingVulkan2KHR, the
following conditions must apply.
- Calls to
enumerateSwapchainImageson anSwapchainin that session must return an array ofSwapchainImageVulkan2KHRstructures. - Whenever an OpenXR function accepts an
SwapchainImageBaseHeaderpointer as a parameter in that session, the runtime must also accept a pointer to anSwapchainImageVulkan2KHR.
The OpenXR runtime must interpret the top-left corner of the swapchain image as the coordinate origin unless specified otherwise by extension functionality.
The OpenXR runtime must interpret the swapchain images in a clip space of positive Y pointing down, near Z plane at 0, and far Z plane at 1.
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
SwapchainImageVulkan2KHR
- Note:
SwapchainImageVulkan2KHRis an alias forSwapchainImageVulkanKHR, so implicit valid usage forSwapchainImageVulkanKHRhas been replicated below. typemust beTYPE_SWAPCHAIN_IMAGE_VULKAN_KHRnextmust beNULLor a valid pointer to the next structure in a structure chainimagemust be a validVkImagevalue
See Also
type GraphicsRequirementsVulkan2KHR = GraphicsRequirementsVulkanKHR Source #
XrGraphicsRequirementsVulkan2KHR - Vulkan API version requirements
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
GraphicsRequirementsVulkan2KHR
- Note:
GraphicsRequirementsVulkan2KHRis an alias forGraphicsRequirementsVulkanKHR, so implicit valid usage forGraphicsRequirementsVulkanKHRhas been replicated below. typemust beTYPE_GRAPHICS_REQUIREMENTS_VULKAN_KHRnextmust beNULLor a valid pointer to the next structure in a structure chain
See Also
type KHR_vulkan_enable2_SPEC_VERSION = 1 Source #
pattern KHR_vulkan_enable2_SPEC_VERSION :: forall a. Integral a => a Source #
type KHR_VULKAN_ENABLE2_EXTENSION_NAME = "XR_KHR_vulkan_enable2" Source #
pattern KHR_VULKAN_ENABLE2_EXTENSION_NAME :: forall a. (Eq a, IsString a) => a Source #
data GraphicsBindingVulkanKHR Source #
XrGraphicsBindingVulkanKHR - The graphics binding structure to be passed at session creation to use Vulkan
Member Descriptions
Description
When creating a Vulkan-backed Session, the
application will provide a pointer to an GraphicsBindingVulkanKHR in
the next chain of the SessionCreateInfo.
Valid Usage
instancemust have enabled a Vulkan API version in the range specified byGraphicsBindingVulkanKHR
instancemust have enabled all the instance extensions specified bygetVulkanInstanceExtensionsKHRphysicalDeviceVkPhysicalDevicemust match the device specified bygetVulkanGraphicsDeviceKHRdevicemust have enabled all the device extensions specified bygetVulkanDeviceExtensionsKHR
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
GraphicsBindingVulkanKHR
-
typemust beTYPE_GRAPHICS_BINDING_VULKAN_KHR -
nextmust beNULLor a valid pointer to the next structure in a structure chain -
instancemust be a validVkInstancevalue -
physicalDevicemust be a validVkPhysicalDevicevalue -
devicemust be a validVkDevicevalue
See Also
Constructors
| GraphicsBindingVulkanKHR | |
Fields
| |
Instances
data SwapchainImageVulkanKHR Source #
XrSwapchainImageVulkanKHR - Vulkan-specific swapchain image structure
Member Descriptions
Description
If a given session was created with GraphicsBindingVulkanKHR, the
following conditions must apply.
- Calls to
enumerateSwapchainImageson anSwapchainin that session must return an array ofSwapchainImageVulkanKHRstructures. - Whenever an OpenXR function accepts an
SwapchainImageBaseHeaderpointer as a parameter in that session, the runtime must also accept a pointer to anSwapchainImageVulkanKHR.
The OpenXR runtime must interpret the top-left corner of the swapchain image as the coordinate origin unless specified otherwise by extension functionality.
The OpenXR runtime must interpret the swapchain images in a clip space of positive Y pointing down, near Z plane at 0, and far Z plane at 1.
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
SwapchainImageVulkanKHR
-
typemust beTYPE_SWAPCHAIN_IMAGE_VULKAN_KHR -
nextmust beNULLor a valid pointer to the next structure in a structure chain -
imagemust be a validVkImagevalue
See Also
Constructors
| SwapchainImageVulkanKHR | |
Instances
data GraphicsRequirementsVulkanKHR Source #
XrGraphicsRequirementsVulkanKHR - Vulkan API version requirements
Member Descriptions
Description
GraphicsRequirementsVulkanKHR is populated by
getVulkanGraphicsRequirementsKHR with the runtime’s Vulkan API version
requirements.
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
GraphicsRequirementsVulkanKHR
-
typemust beTYPE_GRAPHICS_REQUIREMENTS_VULKAN_KHR -
nextmust beNULLor a valid pointer to the next structure in a structure chain
See Also
StructureType,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrVersion,
getVulkanGraphicsRequirements2KHR,
getVulkanGraphicsRequirementsKHR
Constructors
| GraphicsRequirementsVulkanKHR | |
Fields
| |
Instances
getVulkanGraphicsRequirementsKHR Source #
Arguments
| :: forall io. MonadIO io | |
| => Instance |
|
| -> SystemId |
|
| -> io GraphicsRequirementsVulkanKHR |
xrGetVulkanGraphicsRequirementsKHR - Retrieve the Vulkan version requirements for an instance and system
Parameter Descriptions
Description
The getVulkanGraphicsRequirementsKHR function identifies to the
application the minimum Vulkan version requirement and the highest known
tested Vulkan version. The runtime must return
ERROR_GRAPHICS_REQUIREMENTS_CALL_MISSING
(ERROR_VALIDATION_FAILURE may be returned
due to legacy behavior) on calls to createSession
if getVulkanGraphicsRequirementsKHR has not been called for the same
instance and systemId.
Valid Usage (Implicit)
- The
@@ extension must be enabled prior to calling
getVulkanGraphicsRequirementsKHR
-
instancemust be a validInstancehandle -
graphicsRequirementsmust be a pointer to anGraphicsRequirementsVulkanKHRstructure
Return Codes
See Also
GraphicsRequirementsVulkanKHR, Instance,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId