vulkan-2.1.0.0: src/Graphics/Vulkan/Core10/CommandBuffer.hs
{-# language Strict #-}
{-# language CPP #-}
{-# language GeneralizedNewtypeDeriving #-}
{-# language PatternSynonyms #-}
{-# language DataKinds #-}
{-# language TypeOperators #-}
{-# language DuplicateRecordFields #-}
module Graphics.Vulkan.Core10.CommandBuffer
( VkCommandBufferLevel(..)
, pattern VK_COMMAND_BUFFER_LEVEL_PRIMARY
, pattern VK_COMMAND_BUFFER_LEVEL_SECONDARY
, VkQueryControlFlagBits(..)
, pattern VK_QUERY_CONTROL_PRECISE_BIT
, VkCommandBufferResetFlagBits(..)
, pattern VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT
, VkCommandBufferUsageFlagBits(..)
, pattern VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT
, pattern VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT
, pattern VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT
, vkAllocateCommandBuffers
, vkFreeCommandBuffers
, vkBeginCommandBuffer
, vkEndCommandBuffer
, vkResetCommandBuffer
, VkCommandBufferAllocateInfo(..)
, VkCommandBufferInheritanceInfo(..)
, VkCommandBufferBeginInfo(..)
, VkQueryControlFlags
, VkCommandBufferResetFlags
, VkCommandBufferUsageFlags
) where
import Data.Bits
( Bits
, FiniteBits
)
import Data.Int
( Int32
)
import Data.Word
( Word32
)
import Foreign.Ptr
( Ptr
, plusPtr
)
import Foreign.Storable
( Storable
, Storable(..)
)
import GHC.Read
( choose
, expectP
)
import Graphics.Vulkan.NamedType
( (:::)
)
import Text.ParserCombinators.ReadPrec
( (+++)
, prec
, step
)
import Text.Read
( Read(..)
, parens
)
import Text.Read.Lex
( Lexeme(Ident)
)
import Graphics.Vulkan.Core10.CommandPool
( VkCommandPool
)
import Graphics.Vulkan.Core10.Core
( VkBool32(..)
, VkResult(..)
, VkStructureType(..)
, VkFlags
)
import Graphics.Vulkan.Core10.DeviceInitialization
( VkDevice
)
import Graphics.Vulkan.Core10.Pass
( VkFramebuffer
)
import Graphics.Vulkan.Core10.Pipeline
( VkRenderPass
)
import Graphics.Vulkan.Core10.Query
( VkQueryPipelineStatisticFlags
)
import Graphics.Vulkan.Core10.Queue
( VkCommandBuffer
)
-- ** VkCommandBufferLevel
-- | VkCommandBufferLevel - Enumerant specifying a command buffer level
--
-- = See Also
--
-- 'VkCommandBufferAllocateInfo'
newtype VkCommandBufferLevel = VkCommandBufferLevel Int32
deriving (Eq, Ord, Storable)
instance Show VkCommandBufferLevel where
showsPrec _ VK_COMMAND_BUFFER_LEVEL_PRIMARY = showString "VK_COMMAND_BUFFER_LEVEL_PRIMARY"
showsPrec _ VK_COMMAND_BUFFER_LEVEL_SECONDARY = showString "VK_COMMAND_BUFFER_LEVEL_SECONDARY"
showsPrec p (VkCommandBufferLevel x) = showParen (p >= 11) (showString "VkCommandBufferLevel " . showsPrec 11 x)
instance Read VkCommandBufferLevel where
readPrec = parens ( choose [ ("VK_COMMAND_BUFFER_LEVEL_PRIMARY", pure VK_COMMAND_BUFFER_LEVEL_PRIMARY)
, ("VK_COMMAND_BUFFER_LEVEL_SECONDARY", pure VK_COMMAND_BUFFER_LEVEL_SECONDARY)
] +++
prec 10 (do
expectP (Ident "VkCommandBufferLevel")
v <- step readPrec
pure (VkCommandBufferLevel v)
)
)
-- | @VK_COMMAND_BUFFER_LEVEL_PRIMARY@ specifies a primary command buffer.
pattern VK_COMMAND_BUFFER_LEVEL_PRIMARY :: VkCommandBufferLevel
pattern VK_COMMAND_BUFFER_LEVEL_PRIMARY = VkCommandBufferLevel 0
-- | @VK_COMMAND_BUFFER_LEVEL_SECONDARY@ specifies a secondary command
-- buffer.
pattern VK_COMMAND_BUFFER_LEVEL_SECONDARY :: VkCommandBufferLevel
pattern VK_COMMAND_BUFFER_LEVEL_SECONDARY = VkCommandBufferLevel 1
-- ** VkQueryControlFlagBits
-- | VkQueryControlFlagBits - Bitmask specifying constraints on a query
--
-- = See Also
--
-- 'VkQueryControlFlags'
newtype VkQueryControlFlagBits = VkQueryControlFlagBits VkFlags
deriving (Eq, Ord, Storable, Bits, FiniteBits)
instance Show VkQueryControlFlagBits where
showsPrec _ VK_QUERY_CONTROL_PRECISE_BIT = showString "VK_QUERY_CONTROL_PRECISE_BIT"
showsPrec p (VkQueryControlFlagBits x) = showParen (p >= 11) (showString "VkQueryControlFlagBits " . showsPrec 11 x)
instance Read VkQueryControlFlagBits where
readPrec = parens ( choose [ ("VK_QUERY_CONTROL_PRECISE_BIT", pure VK_QUERY_CONTROL_PRECISE_BIT)
] +++
prec 10 (do
expectP (Ident "VkQueryControlFlagBits")
v <- step readPrec
pure (VkQueryControlFlagBits v)
)
)
-- | @VK_QUERY_CONTROL_PRECISE_BIT@ specifies the precision of [occlusion
-- queries](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#queries-occlusion).
pattern VK_QUERY_CONTROL_PRECISE_BIT :: VkQueryControlFlagBits
pattern VK_QUERY_CONTROL_PRECISE_BIT = VkQueryControlFlagBits 0x00000001
-- ** VkCommandBufferResetFlagBits
-- | VkCommandBufferResetFlagBits - Bitmask controlling behavior of a command
-- buffer reset
--
-- = See Also
--
-- 'VkCommandBufferResetFlags'
newtype VkCommandBufferResetFlagBits = VkCommandBufferResetFlagBits VkFlags
deriving (Eq, Ord, Storable, Bits, FiniteBits)
instance Show VkCommandBufferResetFlagBits where
showsPrec _ VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT = showString "VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT"
showsPrec p (VkCommandBufferResetFlagBits x) = showParen (p >= 11) (showString "VkCommandBufferResetFlagBits " . showsPrec 11 x)
instance Read VkCommandBufferResetFlagBits where
readPrec = parens ( choose [ ("VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT", pure VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT)
] +++
prec 10 (do
expectP (Ident "VkCommandBufferResetFlagBits")
v <- step readPrec
pure (VkCommandBufferResetFlagBits v)
)
)
-- | @VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT@ specifies that most or
-- all memory resources currently owned by the command buffer /should/ be
-- returned to the parent command pool. If this flag is not set, then the
-- command buffer /may/ hold onto memory resources and reuse them when
-- recording commands. @commandBuffer@ is moved to the [initial
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
pattern VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT :: VkCommandBufferResetFlagBits
pattern VK_COMMAND_BUFFER_RESET_RELEASE_RESOURCES_BIT = VkCommandBufferResetFlagBits 0x00000001
-- ** VkCommandBufferUsageFlagBits
-- | VkCommandBufferUsageFlagBits - Bitmask specifying usage behavior for
-- command buffer
--
-- = See Also
--
-- 'VkCommandBufferUsageFlags'
newtype VkCommandBufferUsageFlagBits = VkCommandBufferUsageFlagBits VkFlags
deriving (Eq, Ord, Storable, Bits, FiniteBits)
instance Show VkCommandBufferUsageFlagBits where
showsPrec _ VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT = showString "VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT"
showsPrec _ VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT = showString "VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT"
showsPrec _ VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT = showString "VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT"
showsPrec p (VkCommandBufferUsageFlagBits x) = showParen (p >= 11) (showString "VkCommandBufferUsageFlagBits " . showsPrec 11 x)
instance Read VkCommandBufferUsageFlagBits where
readPrec = parens ( choose [ ("VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT", pure VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT)
, ("VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT", pure VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT)
, ("VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT", pure VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT)
] +++
prec 10 (do
expectP (Ident "VkCommandBufferUsageFlagBits")
v <- step readPrec
pure (VkCommandBufferUsageFlagBits v)
)
)
-- | @VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT@ specifies that each
-- recording of the command buffer will only be submitted once, and the
-- command buffer will be reset and recorded again between each submission.
pattern VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT :: VkCommandBufferUsageFlagBits
pattern VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT = VkCommandBufferUsageFlagBits 0x00000001
-- | @VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT@ specifies that a
-- secondary command buffer is considered to be entirely inside a render
-- pass. If this is a primary command buffer, then this bit is ignored.
pattern VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT :: VkCommandBufferUsageFlagBits
pattern VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT = VkCommandBufferUsageFlagBits 0x00000002
-- | @VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT@ specifies that a command
-- buffer /can/ be resubmitted to a queue while it is in the /pending
-- state/, and recorded into multiple primary command buffers.
pattern VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT :: VkCommandBufferUsageFlagBits
pattern VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT = VkCommandBufferUsageFlagBits 0x00000004
-- | vkAllocateCommandBuffers - Allocate command buffers from an existing
-- command pool
--
-- = Parameters
--
-- - @device@ is the logical device that owns the command pool.
--
-- - @pAllocateInfo@ is a pointer to an instance of the
-- @VkCommandBufferAllocateInfo@ structure describing parameters of the
-- allocation.
--
-- - @pCommandBuffers@ is a pointer to an array of @VkCommandBuffer@
-- handles in which the resulting command buffer objects are returned.
-- The array /must/ be at least the length specified by the
-- @commandBufferCount@ member of @pAllocateInfo@. Each allocated
-- command buffer begins in the initial state.
--
-- = Description
--
-- @vkAllocateCommandBuffers@ /can/ be used to create multiple command
-- buffers. If the creation of any of those command buffers fails, the
-- implementation /must/ destroy all successfully created command buffer
-- objects from this command, set all entries of the @pCommandBuffers@
-- array to @NULL@ and return the error.
--
-- When command buffers are first allocated, they are in the [initial
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
--
-- == Valid Usage (Implicit)
--
-- - @device@ /must/ be a valid @VkDevice@ handle
--
-- - @pAllocateInfo@ /must/ be a valid pointer to a valid
-- @VkCommandBufferAllocateInfo@ structure
--
-- - @pCommandBuffers@ /must/ be a valid pointer to an array of
-- @pAllocateInfo@::commandBufferCount @VkCommandBuffer@ handles
--
-- == Host Synchronization
--
-- - Host access to @pAllocateInfo@::commandPool /must/ be externally
-- synchronized
--
-- == Return Codes
--
-- [[Success](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#fundamentals-successcodes)]
-- - @VK_SUCCESS@
--
-- [[Failure](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#fundamentals-errorcodes)]
-- - @VK_ERROR_OUT_OF_HOST_MEMORY@
--
-- - @VK_ERROR_OUT_OF_DEVICE_MEMORY@
--
-- = See Also
--
-- 'Graphics.Vulkan.Core10.Queue.VkCommandBuffer',
-- 'VkCommandBufferAllocateInfo',
-- 'Graphics.Vulkan.Core10.DeviceInitialization.VkDevice'
foreign import ccall
#if !defined(SAFE_FOREIGN_CALLS)
unsafe
#endif
"vkAllocateCommandBuffers" vkAllocateCommandBuffers :: ("device" ::: VkDevice) -> ("pAllocateInfo" ::: Ptr VkCommandBufferAllocateInfo) -> ("pCommandBuffers" ::: Ptr VkCommandBuffer) -> IO VkResult
-- | vkFreeCommandBuffers - Free command buffers
--
-- = Parameters
--
-- - @device@ is the logical device that owns the command pool.
--
-- - @commandPool@ is the command pool from which the command buffers
-- were allocated.
--
-- - @commandBufferCount@ is the length of the @pCommandBuffers@ array.
--
-- - @pCommandBuffers@ is an array of handles of command buffers to free.
--
-- = Description
--
-- Any primary command buffer that is in the [recording or executable
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle)
-- and has any element of @pCommandBuffers@ recorded into it, becomes
-- [invalid](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
--
-- == Valid Usage
--
-- - All elements of @pCommandBuffers@ /must/ not be in the [pending
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle)
--
-- - @pCommandBuffers@ /must/ be a valid pointer to an array of
-- @commandBufferCount@ @VkCommandBuffer@ handles, each element of
-- which /must/ either be a valid handle or @NULL@
--
-- == Valid Usage (Implicit)
--
-- - @device@ /must/ be a valid @VkDevice@ handle
--
-- - @commandPool@ /must/ be a valid @VkCommandPool@ handle
--
-- - @commandBufferCount@ /must/ be greater than @0@
--
-- - @commandPool@ /must/ have been created, allocated, or retrieved from
-- @device@
--
-- - Each element of @pCommandBuffers@ that is a valid handle /must/ have
-- been created, allocated, or retrieved from @commandPool@
--
-- == Host Synchronization
--
-- - Host access to @commandPool@ /must/ be externally synchronized
--
-- - Host access to each member of @pCommandBuffers@ /must/ be externally
-- synchronized
--
-- = See Also
--
-- 'Graphics.Vulkan.Core10.Queue.VkCommandBuffer',
-- 'Graphics.Vulkan.Core10.CommandPool.VkCommandPool',
-- 'Graphics.Vulkan.Core10.DeviceInitialization.VkDevice'
foreign import ccall
#if !defined(SAFE_FOREIGN_CALLS)
unsafe
#endif
"vkFreeCommandBuffers" vkFreeCommandBuffers :: ("device" ::: VkDevice) -> ("commandPool" ::: VkCommandPool) -> ("commandBufferCount" ::: Word32) -> ("pCommandBuffers" ::: Ptr VkCommandBuffer) -> IO ()
-- | vkBeginCommandBuffer - Start recording a command buffer
--
-- = Parameters
--
-- - @commandBuffer@ is the handle of the command buffer which is to be
-- put in the recording state.
--
-- - @pBeginInfo@ is an instance of the @VkCommandBufferBeginInfo@
-- structure, which defines additional information about how the
-- command buffer begins recording.
--
-- == Valid Usage
--
-- - @commandBuffer@ /must/ not be in the [recording or pending
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
--
-- - If @commandBuffer@ was allocated from a
-- 'Graphics.Vulkan.Core10.CommandPool.VkCommandPool' which did not
-- have the @VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT@ flag set,
-- @commandBuffer@ /must/ be in the [initial
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
--
-- - If @commandBuffer@ is a secondary command buffer, the
-- @pInheritanceInfo@ member of @pBeginInfo@ /must/ be a valid
-- @VkCommandBufferInheritanceInfo@ structure
--
-- - If @commandBuffer@ is a secondary command buffer and either the
-- @occlusionQueryEnable@ member of the @pInheritanceInfo@ member of
-- @pBeginInfo@ is @VK_FALSE@, or the precise occlusion queries feature
-- is not enabled, the @queryFlags@ member of the @pInheritanceInfo@
-- member @pBeginInfo@ /must/ not contain
-- @VK_QUERY_CONTROL_PRECISE_BIT@
--
-- == Valid Usage (Implicit)
--
-- - @commandBuffer@ /must/ be a valid @VkCommandBuffer@ handle
--
-- - @pBeginInfo@ /must/ be a valid pointer to a valid
-- @VkCommandBufferBeginInfo@ structure
--
-- == Host Synchronization
--
-- - Host access to @commandBuffer@ /must/ be externally synchronized
--
-- - Host access to the @VkCommandPool@ that @commandBuffer@ was
-- allocated from /must/ be externally synchronized
--
-- == Return Codes
--
-- [[Success](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#fundamentals-successcodes)]
-- - @VK_SUCCESS@
--
-- [[Failure](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#fundamentals-errorcodes)]
-- - @VK_ERROR_OUT_OF_HOST_MEMORY@
--
-- - @VK_ERROR_OUT_OF_DEVICE_MEMORY@
--
-- = See Also
--
-- 'Graphics.Vulkan.Core10.Queue.VkCommandBuffer',
-- 'VkCommandBufferBeginInfo'
foreign import ccall
#if !defined(SAFE_FOREIGN_CALLS)
unsafe
#endif
"vkBeginCommandBuffer" vkBeginCommandBuffer :: ("commandBuffer" ::: VkCommandBuffer) -> ("pBeginInfo" ::: Ptr VkCommandBufferBeginInfo) -> IO VkResult
-- | vkEndCommandBuffer - Finish recording a command buffer
--
-- = Parameters
--
-- - @commandBuffer@ is the command buffer to complete recording.
--
-- = Description
--
-- If there was an error during recording, the application will be notified
-- by an unsuccessful return code returned by @vkEndCommandBuffer@. If the
-- application wishes to further use the command buffer, the command buffer
-- /must/ be reset. The command buffer /must/ have been in the [recording
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle),
-- and is moved to the [executable
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
--
-- == Valid Usage
--
-- - @commandBuffer@ /must/ be in the [recording
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
--
-- - If @commandBuffer@ is a primary command buffer, there /must/ not be
-- an active render pass instance
--
-- - All queries made
-- [active](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#queries-operation-active)
-- during the recording of @commandBuffer@ /must/ have been made
-- inactive
--
-- - If @commandBuffer@ is a secondary command buffer, there /must/ not
-- be an outstanding
-- 'Graphics.Vulkan.Extensions.VK_EXT_debug_utils.vkCmdBeginDebugUtilsLabelEXT'
-- command recorded to @commandBuffer@ that has not previously been
-- ended by a call to
-- 'Graphics.Vulkan.Extensions.VK_EXT_debug_utils.vkCmdEndDebugUtilsLabelEXT'.
--
-- - If @commandBuffer@ is a secondary command buffer, there /must/ not
-- be an outstanding
-- 'Graphics.Vulkan.Extensions.VK_EXT_debug_marker.vkCmdDebugMarkerBeginEXT'
-- command recorded to @commandBuffer@ that has not previously been
-- ended by a call to
-- 'Graphics.Vulkan.Extensions.VK_EXT_debug_marker.vkCmdDebugMarkerEndEXT'.
--
-- == Valid Usage (Implicit)
--
-- - @commandBuffer@ /must/ be a valid @VkCommandBuffer@ handle
--
-- == Host Synchronization
--
-- - Host access to @commandBuffer@ /must/ be externally synchronized
--
-- - Host access to the @VkCommandPool@ that @commandBuffer@ was
-- allocated from /must/ be externally synchronized
--
-- == Return Codes
--
-- [[Success](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#fundamentals-successcodes)]
-- - @VK_SUCCESS@
--
-- [[Failure](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#fundamentals-errorcodes)]
-- - @VK_ERROR_OUT_OF_HOST_MEMORY@
--
-- - @VK_ERROR_OUT_OF_DEVICE_MEMORY@
--
-- = See Also
--
-- 'Graphics.Vulkan.Core10.Queue.VkCommandBuffer'
foreign import ccall
#if !defined(SAFE_FOREIGN_CALLS)
unsafe
#endif
"vkEndCommandBuffer" vkEndCommandBuffer :: ("commandBuffer" ::: VkCommandBuffer) -> IO VkResult
-- | vkResetCommandBuffer - Reset a command buffer to the initial state
--
-- = Parameters
--
-- - @commandBuffer@ is the command buffer to reset. The command buffer
-- /can/ be in any state other than
-- [pending](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle),
-- and is moved into the [initial
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
--
-- - @flags@ is a bitmask of 'VkCommandBufferResetFlagBits' controlling
-- the reset operation.
--
-- = Description
--
-- Any primary command buffer that is in the [recording or executable
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle)
-- and has @commandBuffer@ recorded into it, becomes
-- [invalid](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle).
--
-- == Valid Usage
--
-- - @commandBuffer@ /must/ not be in the [pending
-- state](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#commandbuffers-lifecycle)
--
-- - @commandBuffer@ /must/ have been allocated from a pool that was
-- created with the @VK_COMMAND_POOL_CREATE_RESET_COMMAND_BUFFER_BIT@
--
-- == Valid Usage (Implicit)
--
-- - @commandBuffer@ /must/ be a valid @VkCommandBuffer@ handle
--
-- - @flags@ /must/ be a valid combination of
-- 'VkCommandBufferResetFlagBits' values
--
-- == Host Synchronization
--
-- - Host access to @commandBuffer@ /must/ be externally synchronized
--
-- == Return Codes
--
-- [[Success](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#fundamentals-successcodes)]
-- - @VK_SUCCESS@
--
-- [[Failure](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#fundamentals-errorcodes)]
-- - @VK_ERROR_OUT_OF_HOST_MEMORY@
--
-- - @VK_ERROR_OUT_OF_DEVICE_MEMORY@
--
-- = See Also
--
-- 'Graphics.Vulkan.Core10.Queue.VkCommandBuffer',
-- 'VkCommandBufferResetFlags'
foreign import ccall
#if !defined(SAFE_FOREIGN_CALLS)
unsafe
#endif
"vkResetCommandBuffer" vkResetCommandBuffer :: ("commandBuffer" ::: VkCommandBuffer) -> ("flags" ::: VkCommandBufferResetFlags) -> IO VkResult
-- | VkCommandBufferAllocateInfo - Structure specifying the allocation
-- parameters for command buffer object
--
-- == Valid Usage
--
-- - @commandBufferCount@ /must/ be greater than @0@
--
-- == Valid Usage (Implicit)
--
-- - @sType@ /must/ be @VK_STRUCTURE_TYPE_COMMAND_BUFFER_ALLOCATE_INFO@
--
-- - @pNext@ /must/ be @NULL@
--
-- - @commandPool@ /must/ be a valid @VkCommandPool@ handle
--
-- - @level@ /must/ be a valid 'VkCommandBufferLevel' value
--
-- = See Also
--
-- 'VkCommandBufferLevel',
-- 'Graphics.Vulkan.Core10.CommandPool.VkCommandPool',
-- 'Graphics.Vulkan.Core10.Core.VkStructureType',
-- 'vkAllocateCommandBuffers'
data VkCommandBufferAllocateInfo = VkCommandBufferAllocateInfo
{ -- | @sType@ is the type of this structure.
vkSType :: VkStructureType
, -- | @pNext@ is @NULL@ or a pointer to an extension-specific structure.
vkPNext :: Ptr ()
, -- | @commandPool@ is the command pool from which the command buffers are
-- allocated.
vkCommandPool :: VkCommandPool
, -- | @level@ is an 'VkCommandBufferLevel' value specifying the command buffer
-- level.
vkLevel :: VkCommandBufferLevel
, -- | @commandBufferCount@ is the number of command buffers to allocate from
-- the pool.
vkCommandBufferCount :: Word32
}
deriving (Eq, Show)
instance Storable VkCommandBufferAllocateInfo where
sizeOf ~_ = 32
alignment ~_ = 8
peek ptr = VkCommandBufferAllocateInfo <$> peek (ptr `plusPtr` 0)
<*> peek (ptr `plusPtr` 8)
<*> peek (ptr `plusPtr` 16)
<*> peek (ptr `plusPtr` 24)
<*> peek (ptr `plusPtr` 28)
poke ptr poked = poke (ptr `plusPtr` 0) (vkSType (poked :: VkCommandBufferAllocateInfo))
*> poke (ptr `plusPtr` 8) (vkPNext (poked :: VkCommandBufferAllocateInfo))
*> poke (ptr `plusPtr` 16) (vkCommandPool (poked :: VkCommandBufferAllocateInfo))
*> poke (ptr `plusPtr` 24) (vkLevel (poked :: VkCommandBufferAllocateInfo))
*> poke (ptr `plusPtr` 28) (vkCommandBufferCount (poked :: VkCommandBufferAllocateInfo))
-- | VkCommandBufferInheritanceInfo - Structure specifying command buffer
-- inheritance info
--
-- = Members
--
-- - @sType@ is the type of this structure.
--
-- - @pNext@ is @NULL@ or a pointer to an extension-specific structure.
--
-- - @renderPass@ is a @VkRenderPass@ object defining which render passes
-- the @VkCommandBuffer@ will be
-- [compatible](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#renderpass-compatibility)
-- with and /can/ be executed within. If the @VkCommandBuffer@ will not
-- be executed within a render pass instance, @renderPass@ is ignored.
--
-- - @subpass@ is the index of the subpass within the render pass
-- instance that the @VkCommandBuffer@ will be executed within. If the
-- @VkCommandBuffer@ will not be executed within a render pass
-- instance, @subpass@ is ignored.
--
-- - @framebuffer@ optionally refers to the @VkFramebuffer@ object that
-- the @VkCommandBuffer@ will be rendering to if it is executed within
-- a render pass instance. It /can/ be
-- 'Graphics.Vulkan.Core10.Constants.VK_NULL_HANDLE' if the framebuffer
-- is not known, or if the @VkCommandBuffer@ will not be executed
-- within a render pass instance.
--
-- __Note__
--
-- Specifying the exact framebuffer that the secondary command buffer
-- will be executed with /may/ result in better performance at command
-- buffer execution time.
--
-- - @occlusionQueryEnable@ specifies whether the command buffer /can/ be
-- executed while an occlusion query is active in the primary command
-- buffer. If this is @VK_TRUE@, then this command buffer /can/ be
-- executed whether the primary command buffer has an occlusion query
-- active or not. If this is @VK_FALSE@, then the primary command
-- buffer /must/ not have an occlusion query active.
--
-- - @queryFlags@ specifies the query flags that /can/ be used by an
-- active occlusion query in the primary command buffer when this
-- secondary command buffer is executed. If this value includes the
-- @VK_QUERY_CONTROL_PRECISE_BIT@ bit, then the active query /can/
-- return boolean results or actual sample counts. If this bit is not
-- set, then the active query /must/ not use the
-- @VK_QUERY_CONTROL_PRECISE_BIT@ bit.
--
-- - @pipelineStatistics@ is a bitmask of
-- 'Graphics.Vulkan.Core10.Query.VkQueryPipelineStatisticFlagBits'
-- specifying the set of pipeline statistics that /can/ be counted by
-- an active query in the primary command buffer when this secondary
-- command buffer is executed. If this value includes a given bit, then
-- this command buffer /can/ be executed whether the primary command
-- buffer has a pipeline statistics query active that includes this bit
-- or not. If this value excludes a given bit, then the active pipeline
-- statistics query /must/ not be from a query pool that counts that
-- statistic.
--
-- == Valid Usage
--
-- - If the [inherited
-- queries](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#features-features-inheritedQueries)
-- feature is not enabled, @occlusionQueryEnable@ /must/ be @VK_FALSE@
--
-- - If the [inherited
-- queries](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#features-features-inheritedQueries)
-- feature is enabled, @queryFlags@ /must/ be a valid combination of
-- 'VkQueryControlFlagBits' values
--
-- - If the [pipeline statistics
-- queries](https://www.khronos.org/registry/vulkan/specs/1.0-extensions/html/vkspec.html#features-features-pipelineStatisticsQuery)
-- feature is not enabled, @pipelineStatistics@ /must/ be @0@
--
-- == Valid Usage (Implicit)
--
-- - @sType@ /must/ be
-- @VK_STRUCTURE_TYPE_COMMAND_BUFFER_INHERITANCE_INFO@
--
-- - @pNext@ /must/ be @NULL@
--
-- - Both of @framebuffer@, and @renderPass@ that are valid handles
-- /must/ have been created, allocated, or retrieved from the same
-- @VkDevice@
--
-- = See Also
--
-- @VkBool32@, 'VkCommandBufferBeginInfo',
-- 'Graphics.Vulkan.Core10.Pass.VkFramebuffer', 'VkQueryControlFlags',
-- 'Graphics.Vulkan.Core10.Query.VkQueryPipelineStatisticFlags',
-- 'Graphics.Vulkan.Core10.Pipeline.VkRenderPass',
-- 'Graphics.Vulkan.Core10.Core.VkStructureType'
data VkCommandBufferInheritanceInfo = VkCommandBufferInheritanceInfo
{ -- No documentation found for Nested "VkCommandBufferInheritanceInfo" "sType"
vkSType :: VkStructureType
, -- No documentation found for Nested "VkCommandBufferInheritanceInfo" "pNext"
vkPNext :: Ptr ()
, -- No documentation found for Nested "VkCommandBufferInheritanceInfo" "renderPass"
vkRenderPass :: VkRenderPass
, -- No documentation found for Nested "VkCommandBufferInheritanceInfo" "subpass"
vkSubpass :: Word32
, -- No documentation found for Nested "VkCommandBufferInheritanceInfo" "framebuffer"
vkFramebuffer :: VkFramebuffer
, -- No documentation found for Nested "VkCommandBufferInheritanceInfo" "occlusionQueryEnable"
vkOcclusionQueryEnable :: VkBool32
, -- No documentation found for Nested "VkCommandBufferInheritanceInfo" "queryFlags"
vkQueryFlags :: VkQueryControlFlags
, -- No documentation found for Nested "VkCommandBufferInheritanceInfo" "pipelineStatistics"
vkPipelineStatistics :: VkQueryPipelineStatisticFlags
}
deriving (Eq, Show)
instance Storable VkCommandBufferInheritanceInfo where
sizeOf ~_ = 56
alignment ~_ = 8
peek ptr = VkCommandBufferInheritanceInfo <$> peek (ptr `plusPtr` 0)
<*> peek (ptr `plusPtr` 8)
<*> peek (ptr `plusPtr` 16)
<*> peek (ptr `plusPtr` 24)
<*> peek (ptr `plusPtr` 32)
<*> peek (ptr `plusPtr` 40)
<*> peek (ptr `plusPtr` 44)
<*> peek (ptr `plusPtr` 48)
poke ptr poked = poke (ptr `plusPtr` 0) (vkSType (poked :: VkCommandBufferInheritanceInfo))
*> poke (ptr `plusPtr` 8) (vkPNext (poked :: VkCommandBufferInheritanceInfo))
*> poke (ptr `plusPtr` 16) (vkRenderPass (poked :: VkCommandBufferInheritanceInfo))
*> poke (ptr `plusPtr` 24) (vkSubpass (poked :: VkCommandBufferInheritanceInfo))
*> poke (ptr `plusPtr` 32) (vkFramebuffer (poked :: VkCommandBufferInheritanceInfo))
*> poke (ptr `plusPtr` 40) (vkOcclusionQueryEnable (poked :: VkCommandBufferInheritanceInfo))
*> poke (ptr `plusPtr` 44) (vkQueryFlags (poked :: VkCommandBufferInheritanceInfo))
*> poke (ptr `plusPtr` 48) (vkPipelineStatistics (poked :: VkCommandBufferInheritanceInfo))
-- | VkCommandBufferBeginInfo - Structure specifying a command buffer begin
-- operation
--
-- == Valid Usage
--
-- - If @flags@ contains
-- @VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT@, the @renderPass@
-- member of @pInheritanceInfo@ /must/ be a valid @VkRenderPass@
--
-- - If @flags@ contains
-- @VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT@, the @subpass@
-- member of @pInheritanceInfo@ /must/ be a valid subpass index within
-- the @renderPass@ member of @pInheritanceInfo@
--
-- - If @flags@ contains
-- @VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT@, the
-- @framebuffer@ member of @pInheritanceInfo@ /must/ be either
-- 'Graphics.Vulkan.Core10.Constants.VK_NULL_HANDLE', or a valid
-- @VkFramebuffer@ that is compatible with the @renderPass@ member of
-- @pInheritanceInfo@
--
-- == Valid Usage (Implicit)
--
-- - @sType@ /must/ be @VK_STRUCTURE_TYPE_COMMAND_BUFFER_BEGIN_INFO@
--
-- - @pNext@ /must/ be @NULL@ or a pointer to a valid instance of
-- 'Graphics.Vulkan.Core11.Promoted_from_VK_KHR_device_group.VkDeviceGroupCommandBufferBeginInfo'
--
-- - @flags@ /must/ be a valid combination of
-- 'VkCommandBufferUsageFlagBits' values
--
-- = See Also
--
-- 'VkCommandBufferInheritanceInfo', 'VkCommandBufferUsageFlags',
-- 'Graphics.Vulkan.Core10.Core.VkStructureType', 'vkBeginCommandBuffer'
data VkCommandBufferBeginInfo = VkCommandBufferBeginInfo
{ -- | @sType@ is the type of this structure.
vkSType :: VkStructureType
, -- | @pNext@ is @NULL@ or a pointer to an extension-specific structure.
vkPNext :: Ptr ()
, -- | @flags@ is a bitmask of 'VkCommandBufferUsageFlagBits' specifying usage
-- behavior for the command buffer.
vkFlags :: VkCommandBufferUsageFlags
, -- | @pInheritanceInfo@ is a pointer to a @VkCommandBufferInheritanceInfo@
-- structure, which is used if @commandBuffer@ is a secondary command
-- buffer. If this is a primary command buffer, then this value is ignored.
vkPInheritanceInfo :: Ptr VkCommandBufferInheritanceInfo
}
deriving (Eq, Show)
instance Storable VkCommandBufferBeginInfo where
sizeOf ~_ = 32
alignment ~_ = 8
peek ptr = VkCommandBufferBeginInfo <$> peek (ptr `plusPtr` 0)
<*> peek (ptr `plusPtr` 8)
<*> peek (ptr `plusPtr` 16)
<*> peek (ptr `plusPtr` 24)
poke ptr poked = poke (ptr `plusPtr` 0) (vkSType (poked :: VkCommandBufferBeginInfo))
*> poke (ptr `plusPtr` 8) (vkPNext (poked :: VkCommandBufferBeginInfo))
*> poke (ptr `plusPtr` 16) (vkFlags (poked :: VkCommandBufferBeginInfo))
*> poke (ptr `plusPtr` 24) (vkPInheritanceInfo (poked :: VkCommandBufferBeginInfo))
-- | VkQueryControlFlags - Bitmask of VkQueryControlFlagBits
--
-- = Description
--
-- @VkQueryControlFlags@ is a bitmask type for setting a mask of zero or
-- more 'VkQueryControlFlagBits'.
--
-- = See Also
--
-- 'VkCommandBufferInheritanceInfo', 'VkQueryControlFlagBits',
-- 'Graphics.Vulkan.Core10.CommandBufferBuilding.vkCmdBeginQuery'
type VkQueryControlFlags = VkQueryControlFlagBits
-- | VkCommandBufferResetFlags - Bitmask of VkCommandBufferResetFlagBits
--
-- = Description
--
-- @VkCommandBufferResetFlags@ is a bitmask type for setting a mask of zero
-- or more 'VkCommandBufferResetFlagBits'.
--
-- = See Also
--
-- 'VkCommandBufferResetFlagBits', 'vkResetCommandBuffer'
type VkCommandBufferResetFlags = VkCommandBufferResetFlagBits
-- | VkCommandBufferUsageFlags - Bitmask of VkCommandBufferUsageFlagBits
--
-- = Description
--
-- @VkCommandBufferUsageFlags@ is a bitmask type for setting a mask of zero
-- or more 'VkCommandBufferUsageFlagBits'.
--
-- = See Also
--
-- 'VkCommandBufferBeginInfo', 'VkCommandBufferUsageFlagBits'
type VkCommandBufferUsageFlags = VkCommandBufferUsageFlagBits