CommandBufferUsageFlagBits.hs

{-# language CPP #-}
-- No documentation found for Chapter "CommandBufferUsageFlagBits"
module Vulkan.Core10.Enums.CommandBufferUsageFlagBits  ( CommandBufferUsageFlags
                                                       , CommandBufferUsageFlagBits( COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT
                                                                                   , COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT
                                                                                   , COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT
                                                                                   , ..
                                                                                   )
                                                       ) where

import Data.Bits (Bits)
import Data.Bits (FiniteBits)
import Vulkan.Internal.Utils (enumReadPrec)
import Vulkan.Internal.Utils (enumShowsPrec)
import GHC.Show (showString)
import Numeric (showHex)
import Vulkan.Zero (Zero)
import Foreign.Storable (Storable)
import GHC.Read (Read(readPrec))
import GHC.Show (Show(showsPrec))
import Vulkan.Core10.FundamentalTypes (Flags)
type CommandBufferUsageFlags = CommandBufferUsageFlagBits

-- | VkCommandBufferUsageFlagBits - Bitmask specifying usage behavior for
-- command buffer
--
-- = Description
--
-- -   '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.
--
-- -   '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.
--
-- -   'COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT' specifies that a command
--     buffer /can/ be resubmitted to any queue of the same queue family
--     while it is in the /pending state/, and recorded into multiple
--     primary command buffers.
--
-- = See Also
--
-- <https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#VK_VERSION_1_0 VK_VERSION_1_0>,
-- 'CommandBufferUsageFlags'
newtype CommandBufferUsageFlagBits = CommandBufferUsageFlagBits Flags
  deriving newtype (Eq, Ord, Storable, Zero, Bits, FiniteBits)

-- No documentation found for Nested "VkCommandBufferUsageFlagBits" "VK_COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT"
pattern COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT = CommandBufferUsageFlagBits 0x00000001

-- No documentation found for Nested "VkCommandBufferUsageFlagBits" "VK_COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT"
pattern COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT = CommandBufferUsageFlagBits 0x00000002

-- No documentation found for Nested "VkCommandBufferUsageFlagBits" "VK_COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT"
pattern COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT = CommandBufferUsageFlagBits 0x00000004

conNameCommandBufferUsageFlagBits :: String
conNameCommandBufferUsageFlagBits = "CommandBufferUsageFlagBits"

enumPrefixCommandBufferUsageFlagBits :: String
enumPrefixCommandBufferUsageFlagBits = "COMMAND_BUFFER_USAGE_"

showTableCommandBufferUsageFlagBits :: [(CommandBufferUsageFlagBits, String)]
showTableCommandBufferUsageFlagBits =
  [
    ( COMMAND_BUFFER_USAGE_ONE_TIME_SUBMIT_BIT
    , "ONE_TIME_SUBMIT_BIT"
    )
  ,
    ( COMMAND_BUFFER_USAGE_RENDER_PASS_CONTINUE_BIT
    , "RENDER_PASS_CONTINUE_BIT"
    )
  ,
    ( COMMAND_BUFFER_USAGE_SIMULTANEOUS_USE_BIT
    , "SIMULTANEOUS_USE_BIT"
    )
  ]

instance Show CommandBufferUsageFlagBits where
  showsPrec =
    enumShowsPrec
      enumPrefixCommandBufferUsageFlagBits
      showTableCommandBufferUsageFlagBits
      conNameCommandBufferUsageFlagBits
      (\(CommandBufferUsageFlagBits x) -> x)
      (\x -> showString "0x" . showHex x)

instance Read CommandBufferUsageFlagBits where
  readPrec =
    enumReadPrec
      enumPrefixCommandBufferUsageFlagBits
      showTableCommandBufferUsageFlagBits
      conNameCommandBufferUsageFlagBits
      CommandBufferUsageFlagBits