Safe Haskell | None |
---|---|
Language | Haskell2010 |
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 #
:: 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
-
instance
must be a validInstance
handle -
createInfo
must be a pointer to a validVulkanInstanceCreateInfoKHR
structure -
vulkanInstance
must be a pointer to aVkInstance
value -
vulkanResult
must be a pointer to aVkResult
value
Return Codes
See Also
Instance
, VulkanInstanceCreateInfoKHR
,
createVulkanDeviceKHR
createVulkanDeviceKHR Source #
:: 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
-
instance
must be a validInstance
handle -
createInfo
must be a pointer to a validVulkanDeviceCreateInfoKHR
structure -
vulkanDevice
must be a pointer to aVkDevice
value -
vulkanResult
must be a pointer to aVkResult
value
Return Codes
See Also
Instance
, VulkanDeviceCreateInfoKHR
,
createVulkanInstanceKHR
getVulkanGraphicsDevice2KHR Source #
:: 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
-
instance
must be a validInstance
handle -
getInfo
must be a pointer to a validVulkanGraphicsDeviceGetInfoKHR
structure -
vulkanPhysicalDevice
must be a pointer to aVkPhysicalDevice
value
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
instance
is anInstance
handle previously created withcreateInstance
.
systemId
is 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.graphicsRequirements
is theGraphicsRequirementsVulkan2KHR
output structure.
Valid Usage (Implicit)
- The
@@ extension must be enabled prior to calling
getVulkanGraphicsRequirements2KHR
-
instance
must be a validInstance
handle -
graphicsRequirements
must be a pointer to anGraphicsRequirementsVulkanKHR
structure
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
-
type
must beTYPE_VULKAN_INSTANCE_CREATE_INFO_KHR
-
next
must beNULL
or a valid pointer to the next structure in a structure chain -
createFlags
must be0
-
pfnGetInstanceProcAddr
must be a validPFN_vkGetInstanceProcAddr
value -
vulkanCreateInfo
must be a pointer to a validVkInstanceCreateInfo
value -
vulkanAllocator
must be a pointer to a validVkAllocationCallbacks
value
See Also
StructureType
,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId,
VulkanInstanceCreateFlagsKHR
, createVulkanInstanceKHR
VulkanInstanceCreateInfoKHR | |
|
Instances
data VulkanDeviceCreateInfoKHR Source #
XrVulkanDeviceCreateInfoKHR - Vulkan Device Create Info
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
VulkanDeviceCreateInfoKHR
-
type
must beTYPE_VULKAN_DEVICE_CREATE_INFO_KHR
-
next
must beNULL
or a valid pointer to the next structure in a structure chain -
createFlags
must be0
-
pfnGetInstanceProcAddr
must be a validPFN_vkGetInstanceProcAddr
value -
vulkanPhysicalDevice
must be a validVkPhysicalDevice
value -
vulkanCreateInfo
must be a pointer to a validVkDeviceCreateInfo
value -
vulkanAllocator
must be a pointer to a validVkAllocationCallbacks
value
See Also
StructureType
,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId,
VulkanDeviceCreateFlagsKHR
, createVulkanDeviceKHR
VulkanDeviceCreateInfoKHR | |
|
Instances
data VulkanGraphicsDeviceGetInfoKHR Source #
XrVulkanGraphicsDeviceGetInfoKHR - Vulkan Graphics Device Get Info
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
VulkanGraphicsDeviceGetInfoKHR
-
type
must beTYPE_VULKAN_GRAPHICS_DEVICE_GET_INFO_KHR
-
next
must beNULL
or a valid pointer to the next structure in a structure chain -
vulkanInstance
must be a validVkInstance
value
See Also
StructureType
,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId,
getVulkanGraphicsDevice2KHR
VulkanGraphicsDeviceGetInfoKHR | |
|
Instances
newtype VulkanInstanceCreateFlagsKHR Source #
XrVulkanInstanceCreateFlagsKHR - Vulkan Instance Create Info Flags
See Also
Instances
newtype VulkanDeviceCreateFlagsKHR Source #
Instances
type GraphicsBindingVulkan2KHR = GraphicsBindingVulkanKHR Source #
XrGraphicsBindingVulkan2KHR - The graphics binding structure to be passed at session creation to use Vulkan
Valid Usage
instance
must have enabled a Vulkan API version in the range specified bygetVulkanGraphicsRequirements2KHR
instance
must have been created usingcreateVulkanInstanceKHR
physicalDevice
VkPhysicalDevice
must match the device specified bygetVulkanGraphicsDevice2KHR
device
must have been created usingcreateVulkanDeviceKHR
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
GraphicsBindingVulkan2KHR
- Note:
GraphicsBindingVulkan2KHR
is an alias forGraphicsBindingVulkanKHR
, so implicit valid usage forGraphicsBindingVulkanKHR
has been replicated below. type
must beTYPE_GRAPHICS_BINDING_VULKAN_KHR
next
must beNULL
or a valid pointer to the next structure in a structure chaininstance
must be a validVkInstance
valuephysicalDevice
must be a validVkPhysicalDevice
valuedevice
must be a validVkDevice
value
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
enumerateSwapchainImages
on anSwapchain
in that session must return an array ofSwapchainImageVulkan2KHR
structures. - Whenever an OpenXR function accepts an
SwapchainImageBaseHeader
pointer 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:
SwapchainImageVulkan2KHR
is an alias forSwapchainImageVulkanKHR
, so implicit valid usage forSwapchainImageVulkanKHR
has been replicated below. type
must beTYPE_SWAPCHAIN_IMAGE_VULKAN_KHR
next
must beNULL
or a valid pointer to the next structure in a structure chainimage
must be a validVkImage
value
See Also
type GraphicsRequirementsVulkan2KHR = GraphicsRequirementsVulkanKHR Source #
XrGraphicsRequirementsVulkan2KHR - Vulkan API version requirements
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
GraphicsRequirementsVulkan2KHR
- Note:
GraphicsRequirementsVulkan2KHR
is an alias forGraphicsRequirementsVulkanKHR
, so implicit valid usage forGraphicsRequirementsVulkanKHR
has been replicated below. type
must beTYPE_GRAPHICS_REQUIREMENTS_VULKAN_KHR
next
must beNULL
or 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
instance
must have enabled a Vulkan API version in the range specified byGraphicsBindingVulkanKHR
instance
must have enabled all the instance extensions specified bygetVulkanInstanceExtensionsKHR
physicalDevice
VkPhysicalDevice
must match the device specified bygetVulkanGraphicsDeviceKHR
device
must have enabled all the device extensions specified bygetVulkanDeviceExtensionsKHR
Valid Usage (Implicit)
- The @@
extension must be enabled prior to using
GraphicsBindingVulkanKHR
-
type
must beTYPE_GRAPHICS_BINDING_VULKAN_KHR
-
next
must beNULL
or a valid pointer to the next structure in a structure chain -
instance
must be a validVkInstance
value -
physicalDevice
must be a validVkPhysicalDevice
value -
device
must be a validVkDevice
value
See Also
GraphicsBindingVulkanKHR | |
|
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
enumerateSwapchainImages
on anSwapchain
in that session must return an array ofSwapchainImageVulkanKHR
structures. - Whenever an OpenXR function accepts an
SwapchainImageBaseHeader
pointer 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
-
type
must beTYPE_SWAPCHAIN_IMAGE_VULKAN_KHR
-
next
must beNULL
or a valid pointer to the next structure in a structure chain -
image
must be a validVkImage
value
See Also
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
-
type
must beTYPE_GRAPHICS_REQUIREMENTS_VULKAN_KHR
-
next
must beNULL
or 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
GraphicsRequirementsVulkanKHR | |
|
Instances
getVulkanGraphicsRequirementsKHR Source #
:: 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
-
instance
must be a validInstance
handle -
graphicsRequirements
must be a pointer to anGraphicsRequirementsVulkanKHR
structure
Return Codes
See Also
GraphicsRequirementsVulkanKHR
, Instance
,
https://www.khronos.org/registry/OpenXR/specs/1.0/html/xrspec.html#XrSystemId