{-# language CPP #-}
-- No documentation found for Chapter "SystemAllocationScope"
module Vulkan.Core10.Enums.SystemAllocationScope  (SystemAllocationScope( SYSTEM_ALLOCATION_SCOPE_COMMAND
                                                                        , SYSTEM_ALLOCATION_SCOPE_OBJECT
                                                                        , SYSTEM_ALLOCATION_SCOPE_CACHE
                                                                        , SYSTEM_ALLOCATION_SCOPE_DEVICE
                                                                        , SYSTEM_ALLOCATION_SCOPE_INSTANCE
                                                                        , ..
                                                                        )) where

import Vulkan.Internal.Utils (enumReadPrec)
import Vulkan.Internal.Utils (enumShowsPrec)
import GHC.Show (showsPrec)
import Vulkan.Zero (Zero)
import Foreign.Storable (Storable)
import Data.Int (Int32)
import GHC.Read (Read(readPrec))
import GHC.Show (Show(showsPrec))

-- | VkSystemAllocationScope - Allocation scope
--
-- = Description
--
-- -   'SYSTEM_ALLOCATION_SCOPE_COMMAND' specifies that the allocation is
--     scoped to the duration of the Vulkan command.
--
-- -   'SYSTEM_ALLOCATION_SCOPE_OBJECT' specifies that the allocation is
--     scoped to the lifetime of the Vulkan object that is being created or
--     used.
--
-- -   'SYSTEM_ALLOCATION_SCOPE_CACHE' specifies that the allocation is
--     scoped to the lifetime of a 'Vulkan.Core10.Handles.PipelineCache' or
--     'Vulkan.Extensions.Handles.ValidationCacheEXT' object.
--
-- -   'SYSTEM_ALLOCATION_SCOPE_DEVICE' specifies that the allocation is
--     scoped to the lifetime of the Vulkan device.
--
-- -   'SYSTEM_ALLOCATION_SCOPE_INSTANCE' specifies that the allocation is
--     scoped to the lifetime of the Vulkan instance.
--
-- Most Vulkan commands operate on a single object, or there is a sole
-- object that is being created or manipulated. When an allocation uses an
-- allocation scope of 'SYSTEM_ALLOCATION_SCOPE_OBJECT' or
-- 'SYSTEM_ALLOCATION_SCOPE_CACHE', the allocation is scoped to the object
-- being created or manipulated.
--
-- When an implementation requires host memory, it will make callbacks to
-- the application using the most specific allocator and allocation scope
-- available:
--
-- -   If an allocation is scoped to the duration of a command, the
--     allocator will use the 'SYSTEM_ALLOCATION_SCOPE_COMMAND' allocation
--     scope. The most specific allocator available is used: if the object
--     being created or manipulated has an allocator, that object’s
--     allocator will be used, else if the parent
--     'Vulkan.Core10.Handles.Device' has an allocator it will be used,
--     else if the parent 'Vulkan.Core10.Handles.Instance' has an allocator
--     it will be used. Else,
--
-- -   If an allocation is associated with a
--     'Vulkan.Extensions.Handles.ValidationCacheEXT' or
--     'Vulkan.Core10.Handles.PipelineCache' object, the allocator will use
--     the 'SYSTEM_ALLOCATION_SCOPE_CACHE' allocation scope. The most
--     specific allocator available is used (cache, else device, else
--     instance). Else,
--
-- -   If an allocation is scoped to the lifetime of an object, that object
--     is being created or manipulated by the command, and that object’s
--     type is not 'Vulkan.Core10.Handles.Device' or
--     'Vulkan.Core10.Handles.Instance', the allocator will use an
--     allocation scope of 'SYSTEM_ALLOCATION_SCOPE_OBJECT'. The most
--     specific allocator available is used (object, else device, else
--     instance). Else,
--
-- -   If an allocation is scoped to the lifetime of a device, the
--     allocator will use an allocation scope of
--     'SYSTEM_ALLOCATION_SCOPE_DEVICE'. The most specific allocator
--     available is used (device, else instance). Else,
--
-- -   If the allocation is scoped to the lifetime of an instance and the
--     instance has an allocator, its allocator will be used with an
--     allocation scope of 'SYSTEM_ALLOCATION_SCOPE_INSTANCE'.
--
-- -   Otherwise an implementation will allocate memory through an
--     alternative mechanism that is unspecified.
--
-- = See Also
--
-- <https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#VK_VERSION_1_0 VK_VERSION_1_0>,
-- 'Vulkan.Core10.AllocationCallbacks.AllocationCallbacks'
newtype SystemAllocationScope = SystemAllocationScope Int32
  deriving newtype (SystemAllocationScope -> SystemAllocationScope -> Bool
forall a. (a -> a -> Bool) -> (a -> a -> Bool) -> Eq a
/= :: SystemAllocationScope -> SystemAllocationScope -> Bool
$c/= :: SystemAllocationScope -> SystemAllocationScope -> Bool
== :: SystemAllocationScope -> SystemAllocationScope -> Bool
$c== :: SystemAllocationScope -> SystemAllocationScope -> Bool
Eq, Eq SystemAllocationScope
SystemAllocationScope -> SystemAllocationScope -> Bool
SystemAllocationScope -> SystemAllocationScope -> Ordering
SystemAllocationScope
-> SystemAllocationScope -> SystemAllocationScope
forall a.
Eq a
-> (a -> a -> Ordering)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> Bool)
-> (a -> a -> a)
-> (a -> a -> a)
-> Ord a
min :: SystemAllocationScope
-> SystemAllocationScope -> SystemAllocationScope
$cmin :: SystemAllocationScope
-> SystemAllocationScope -> SystemAllocationScope
max :: SystemAllocationScope
-> SystemAllocationScope -> SystemAllocationScope
$cmax :: SystemAllocationScope
-> SystemAllocationScope -> SystemAllocationScope
>= :: SystemAllocationScope -> SystemAllocationScope -> Bool
$c>= :: SystemAllocationScope -> SystemAllocationScope -> Bool
> :: SystemAllocationScope -> SystemAllocationScope -> Bool
$c> :: SystemAllocationScope -> SystemAllocationScope -> Bool
<= :: SystemAllocationScope -> SystemAllocationScope -> Bool
$c<= :: SystemAllocationScope -> SystemAllocationScope -> Bool
< :: SystemAllocationScope -> SystemAllocationScope -> Bool
$c< :: SystemAllocationScope -> SystemAllocationScope -> Bool
compare :: SystemAllocationScope -> SystemAllocationScope -> Ordering
$ccompare :: SystemAllocationScope -> SystemAllocationScope -> Ordering
Ord, Ptr SystemAllocationScope -> IO SystemAllocationScope
Ptr SystemAllocationScope -> Int -> IO SystemAllocationScope
Ptr SystemAllocationScope -> Int -> SystemAllocationScope -> IO ()
Ptr SystemAllocationScope -> SystemAllocationScope -> IO ()
SystemAllocationScope -> Int
forall b. Ptr b -> Int -> IO SystemAllocationScope
forall b. Ptr b -> Int -> SystemAllocationScope -> IO ()
forall a.
(a -> Int)
-> (a -> Int)
-> (Ptr a -> Int -> IO a)
-> (Ptr a -> Int -> a -> IO ())
-> (forall b. Ptr b -> Int -> IO a)
-> (forall b. Ptr b -> Int -> a -> IO ())
-> (Ptr a -> IO a)
-> (Ptr a -> a -> IO ())
-> Storable a
poke :: Ptr SystemAllocationScope -> SystemAllocationScope -> IO ()
$cpoke :: Ptr SystemAllocationScope -> SystemAllocationScope -> IO ()
peek :: Ptr SystemAllocationScope -> IO SystemAllocationScope
$cpeek :: Ptr SystemAllocationScope -> IO SystemAllocationScope
pokeByteOff :: forall b. Ptr b -> Int -> SystemAllocationScope -> IO ()
$cpokeByteOff :: forall b. Ptr b -> Int -> SystemAllocationScope -> IO ()
peekByteOff :: forall b. Ptr b -> Int -> IO SystemAllocationScope
$cpeekByteOff :: forall b. Ptr b -> Int -> IO SystemAllocationScope
pokeElemOff :: Ptr SystemAllocationScope -> Int -> SystemAllocationScope -> IO ()
$cpokeElemOff :: Ptr SystemAllocationScope -> Int -> SystemAllocationScope -> IO ()
peekElemOff :: Ptr SystemAllocationScope -> Int -> IO SystemAllocationScope
$cpeekElemOff :: Ptr SystemAllocationScope -> Int -> IO SystemAllocationScope
alignment :: SystemAllocationScope -> Int
$calignment :: SystemAllocationScope -> Int
sizeOf :: SystemAllocationScope -> Int
$csizeOf :: SystemAllocationScope -> Int
Storable, SystemAllocationScope
forall a. a -> Zero a
zero :: SystemAllocationScope
$czero :: SystemAllocationScope
Zero)

-- No documentation found for Nested "VkSystemAllocationScope" "VK_SYSTEM_ALLOCATION_SCOPE_COMMAND"
pattern $bSYSTEM_ALLOCATION_SCOPE_COMMAND :: SystemAllocationScope
$mSYSTEM_ALLOCATION_SCOPE_COMMAND :: forall {r}.
SystemAllocationScope -> ((# #) -> r) -> ((# #) -> r) -> r
SYSTEM_ALLOCATION_SCOPE_COMMAND = SystemAllocationScope 0

-- No documentation found for Nested "VkSystemAllocationScope" "VK_SYSTEM_ALLOCATION_SCOPE_OBJECT"
pattern $bSYSTEM_ALLOCATION_SCOPE_OBJECT :: SystemAllocationScope
$mSYSTEM_ALLOCATION_SCOPE_OBJECT :: forall {r}.
SystemAllocationScope -> ((# #) -> r) -> ((# #) -> r) -> r
SYSTEM_ALLOCATION_SCOPE_OBJECT = SystemAllocationScope 1

-- No documentation found for Nested "VkSystemAllocationScope" "VK_SYSTEM_ALLOCATION_SCOPE_CACHE"
pattern $bSYSTEM_ALLOCATION_SCOPE_CACHE :: SystemAllocationScope
$mSYSTEM_ALLOCATION_SCOPE_CACHE :: forall {r}.
SystemAllocationScope -> ((# #) -> r) -> ((# #) -> r) -> r
SYSTEM_ALLOCATION_SCOPE_CACHE = SystemAllocationScope 2

-- No documentation found for Nested "VkSystemAllocationScope" "VK_SYSTEM_ALLOCATION_SCOPE_DEVICE"
pattern $bSYSTEM_ALLOCATION_SCOPE_DEVICE :: SystemAllocationScope
$mSYSTEM_ALLOCATION_SCOPE_DEVICE :: forall {r}.
SystemAllocationScope -> ((# #) -> r) -> ((# #) -> r) -> r
SYSTEM_ALLOCATION_SCOPE_DEVICE = SystemAllocationScope 3

-- No documentation found for Nested "VkSystemAllocationScope" "VK_SYSTEM_ALLOCATION_SCOPE_INSTANCE"
pattern $bSYSTEM_ALLOCATION_SCOPE_INSTANCE :: SystemAllocationScope
$mSYSTEM_ALLOCATION_SCOPE_INSTANCE :: forall {r}.
SystemAllocationScope -> ((# #) -> r) -> ((# #) -> r) -> r
SYSTEM_ALLOCATION_SCOPE_INSTANCE = SystemAllocationScope 4

{-# COMPLETE
  SYSTEM_ALLOCATION_SCOPE_COMMAND
  , SYSTEM_ALLOCATION_SCOPE_OBJECT
  , SYSTEM_ALLOCATION_SCOPE_CACHE
  , SYSTEM_ALLOCATION_SCOPE_DEVICE
  , SYSTEM_ALLOCATION_SCOPE_INSTANCE ::
    SystemAllocationScope
  #-}

conNameSystemAllocationScope :: String
conNameSystemAllocationScope :: String
conNameSystemAllocationScope = String
"SystemAllocationScope"

enumPrefixSystemAllocationScope :: String
enumPrefixSystemAllocationScope :: String
enumPrefixSystemAllocationScope = String
"SYSTEM_ALLOCATION_SCOPE_"

showTableSystemAllocationScope :: [(SystemAllocationScope, String)]
showTableSystemAllocationScope :: [(SystemAllocationScope, String)]
showTableSystemAllocationScope =
  [ (SystemAllocationScope
SYSTEM_ALLOCATION_SCOPE_COMMAND, String
"COMMAND")
  , (SystemAllocationScope
SYSTEM_ALLOCATION_SCOPE_OBJECT, String
"OBJECT")
  , (SystemAllocationScope
SYSTEM_ALLOCATION_SCOPE_CACHE, String
"CACHE")
  , (SystemAllocationScope
SYSTEM_ALLOCATION_SCOPE_DEVICE, String
"DEVICE")
  ,
    ( SystemAllocationScope
SYSTEM_ALLOCATION_SCOPE_INSTANCE
    , String
"INSTANCE"
    )
  ]

instance Show SystemAllocationScope where
  showsPrec :: Int -> SystemAllocationScope -> ShowS
showsPrec =
    forall a i.
Eq a =>
String
-> [(a, String)]
-> String
-> (a -> i)
-> (i -> ShowS)
-> Int
-> a
-> ShowS
enumShowsPrec
      String
enumPrefixSystemAllocationScope
      [(SystemAllocationScope, String)]
showTableSystemAllocationScope
      String
conNameSystemAllocationScope
      (\(SystemAllocationScope Int32
x) -> Int32
x)
      (forall a. Show a => Int -> a -> ShowS
showsPrec Int
11)

instance Read SystemAllocationScope where
  readPrec :: ReadPrec SystemAllocationScope
readPrec =
    forall i a.
Read i =>
String -> [(a, String)] -> String -> (i -> a) -> ReadPrec a
enumReadPrec
      String
enumPrefixSystemAllocationScope
      [(SystemAllocationScope, String)]
showTableSystemAllocationScope
      String
conNameSystemAllocationScope
      Int32 -> SystemAllocationScope
SystemAllocationScope