{-# language CPP #-} module Vulkan.Core10.OtherTypes ( MemoryBarrier(..) , BufferMemoryBarrier(..) , ImageMemoryBarrier(..) , DrawIndirectCommand(..) , DrawIndexedIndirectCommand(..) , DispatchIndirectCommand(..) , BaseOutStructure(..) , BaseInStructure(..) , ObjectType(..) , VendorId(..) ) where import Data.Typeable (eqT) import Foreign.Marshal.Alloc (allocaBytesAligned) import GHC.Ptr (castPtr) import Foreign.Ptr (nullPtr) import Foreign.Ptr (plusPtr) import Control.Monad.Trans.Class (lift) import Control.Monad.Trans.Cont (evalContT) import Data.Type.Equality ((:~:)(Refl)) import Data.Typeable (Typeable) import Foreign.Storable (Storable) import Foreign.Storable (Storable(peek)) import Foreign.Storable (Storable(poke)) import qualified Foreign.Storable (Storable(..)) import GHC.Generics (Generic) import Data.Int (Int32) import Foreign.Ptr (Ptr) import Data.Word (Word32) import Data.Kind (Type) import Control.Monad.Trans.Cont (ContT(..)) import Vulkan.Core10.Enums.AccessFlagBits (AccessFlags) import Vulkan.Core10.Handles (Buffer) import Vulkan.CStruct.Extends (Chain) import Vulkan.Core10.FundamentalTypes (DeviceSize) import Vulkan.CStruct.Extends (Extends) import Vulkan.CStruct.Extends (Extendss) import Vulkan.CStruct.Extends (Extensible(..)) import Vulkan.CStruct (FromCStruct) import Vulkan.CStruct (FromCStruct(..)) import Vulkan.Core10.Handles (Image) import Vulkan.Core10.Enums.ImageLayout (ImageLayout) import Vulkan.Core10.ImageView (ImageSubresourceRange) import Vulkan.CStruct.Extends (PeekChain) import Vulkan.CStruct.Extends (PeekChain(..)) import Vulkan.CStruct.Extends (PokeChain) import Vulkan.CStruct.Extends (PokeChain(..)) import {-# SOURCE #-} Vulkan.Extensions.VK_EXT_sample_locations (SampleLocationsInfoEXT) import Vulkan.Core10.Enums.StructureType (StructureType) import Vulkan.CStruct (ToCStruct) import Vulkan.CStruct (ToCStruct(..)) import Vulkan.Zero (Zero(..)) import Vulkan.Core10.Enums.StructureType (StructureType(STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER)) import Vulkan.Core10.Enums.StructureType (StructureType(STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER)) import Vulkan.Core10.Enums.StructureType (StructureType(STRUCTURE_TYPE_MEMORY_BARRIER)) import Vulkan.CStruct.Extends (BaseInStructure(..)) import Vulkan.CStruct.Extends (BaseOutStructure(..)) import Vulkan.Core10.Enums.ObjectType (ObjectType(..)) import Vulkan.Core10.Enums.VendorId (VendorId(..)) -- | VkMemoryBarrier - Structure specifying a global memory barrier -- -- = Description -- -- The first -- -- is limited to access types in the -- -- specified by @srcAccessMask@. -- -- The second -- -- is limited to access types in the -- -- specified by @dstAccessMask@. -- -- == Valid Usage (Implicit) -- -- = See Also -- -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlags', -- 'Vulkan.Core10.Enums.StructureType.StructureType', -- 'Vulkan.Core10.CommandBufferBuilding.cmdPipelineBarrier', -- 'Vulkan.Core10.CommandBufferBuilding.cmdWaitEvents' data MemoryBarrier = MemoryBarrier { -- | @srcAccessMask@ is a bitmask of -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlagBits' specifying a -- . -- -- @srcAccessMask@ /must/ be a valid combination of -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlagBits' values srcAccessMask :: AccessFlags , -- | @dstAccessMask@ is a bitmask of -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlagBits' specifying a -- . -- -- @dstAccessMask@ /must/ be a valid combination of -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlagBits' values dstAccessMask :: AccessFlags } deriving (Typeable, Eq) #if defined(GENERIC_INSTANCES) deriving instance Generic (MemoryBarrier) #endif deriving instance Show MemoryBarrier instance ToCStruct MemoryBarrier where withCStruct x f = allocaBytesAligned 24 8 $ \p -> pokeCStruct p x (f p) pokeCStruct p MemoryBarrier{..} f = do poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_MEMORY_BARRIER) poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr) poke ((p `plusPtr` 16 :: Ptr AccessFlags)) (srcAccessMask) poke ((p `plusPtr` 20 :: Ptr AccessFlags)) (dstAccessMask) f cStructSize = 24 cStructAlignment = 8 pokeZeroCStruct p f = do poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_MEMORY_BARRIER) poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr) f instance FromCStruct MemoryBarrier where peekCStruct p = do srcAccessMask <- peek @AccessFlags ((p `plusPtr` 16 :: Ptr AccessFlags)) dstAccessMask <- peek @AccessFlags ((p `plusPtr` 20 :: Ptr AccessFlags)) pure $ MemoryBarrier srcAccessMask dstAccessMask instance Storable MemoryBarrier where sizeOf ~_ = 24 alignment ~_ = 8 peek = peekCStruct poke ptr poked = pokeCStruct ptr poked (pure ()) instance Zero MemoryBarrier where zero = MemoryBarrier zero zero -- | VkBufferMemoryBarrier - Structure specifying a buffer memory barrier -- -- = Description -- -- The first -- -- is limited to access to memory through the specified buffer range, via -- access types in the -- -- specified by @srcAccessMask@. If @srcAccessMask@ includes -- 'Vulkan.Core10.Enums.AccessFlagBits.ACCESS_HOST_WRITE_BIT', memory -- writes performed by that access type are also made visible, as that -- access type is not performed through a resource. -- -- The second -- -- is limited to access to memory through the specified buffer range, via -- access types in the -- -- specified by @dstAccessMask@. If @dstAccessMask@ includes -- 'Vulkan.Core10.Enums.AccessFlagBits.ACCESS_HOST_WRITE_BIT' or -- 'Vulkan.Core10.Enums.AccessFlagBits.ACCESS_HOST_READ_BIT', available -- memory writes are also made visible to accesses of those types, as those -- access types are not performed through a resource. -- -- If @srcQueueFamilyIndex@ is not equal to @dstQueueFamilyIndex@, and -- @srcQueueFamilyIndex@ is equal to the current queue family, then the -- memory barrier defines a -- -- for the specified buffer range, and the second access scope includes no -- access, as if @dstAccessMask@ was @0@. -- -- If @dstQueueFamilyIndex@ is not equal to @srcQueueFamilyIndex@, and -- @dstQueueFamilyIndex@ is equal to the current queue family, then the -- memory barrier defines a -- -- for the specified buffer range, and the first access scope includes no -- access, as if @srcAccessMask@ was @0@. -- -- == Valid Usage -- -- - @offset@ /must/ be less than the size of @buffer@ -- -- - If @size@ is not equal to 'Vulkan.Core10.APIConstants.WHOLE_SIZE', -- @size@ /must/ be greater than @0@ -- -- - If @size@ is not equal to 'Vulkan.Core10.APIConstants.WHOLE_SIZE', -- @size@ /must/ be less than or equal to than the size of @buffer@ -- minus @offset@ -- -- - If @buffer@ is non-sparse then it /must/ be bound completely and -- contiguously to a single 'Vulkan.Core10.Handles.DeviceMemory' object -- -- - If @srcQueueFamilyIndex@ is not equal to @dstQueueFamilyIndex@, at -- least one /must/ not be a special queue family reserved for external -- memory ownership transfers, as described in -- -- -- - If @buffer@ was created with a sharing mode of -- 'Vulkan.Core10.Enums.SharingMode.SHARING_MODE_CONCURRENT', -- @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ are not equal, and -- one of @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ is a special -- queue family values reserved for external memory transfers, the -- other /must/ be 'Vulkan.Core10.APIConstants.QUEUE_FAMILY_IGNORED' -- -- - If @buffer@ was created with a sharing mode of -- 'Vulkan.Core10.Enums.SharingMode.SHARING_MODE_EXCLUSIVE', and -- @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ are not equal, -- @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ /must/ both be valid -- queue families, or one of the special queue family values reserved -- for external memory transfers, as described in -- -- -- - If @buffer@ was created with a sharing mode of -- 'Vulkan.Core10.Enums.SharingMode.SHARING_MODE_CONCURRENT', at least -- one of @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ /must/ be -- 'Vulkan.Core10.APIConstants.QUEUE_FAMILY_IGNORED' -- -- == Valid Usage (Implicit) -- -- - @sType@ /must/ be -- 'Vulkan.Core10.Enums.StructureType.STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER' -- -- - @pNext@ /must/ be @NULL@ -- -- - @buffer@ /must/ be a valid 'Vulkan.Core10.Handles.Buffer' handle -- -- = See Also -- -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlags', -- 'Vulkan.Core10.Handles.Buffer', -- 'Vulkan.Core10.FundamentalTypes.DeviceSize', -- 'Vulkan.Core10.Enums.StructureType.StructureType', -- 'Vulkan.Core10.CommandBufferBuilding.cmdPipelineBarrier', -- 'Vulkan.Core10.CommandBufferBuilding.cmdWaitEvents' data BufferMemoryBarrier = BufferMemoryBarrier { -- | @srcAccessMask@ is a bitmask of -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlagBits' specifying a -- . srcAccessMask :: AccessFlags , -- | @dstAccessMask@ is a bitmask of -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlagBits' specifying a -- . dstAccessMask :: AccessFlags , -- | @srcQueueFamilyIndex@ is the source queue family for a -- . srcQueueFamilyIndex :: Word32 , -- | @dstQueueFamilyIndex@ is the destination queue family for a -- . dstQueueFamilyIndex :: Word32 , -- | @buffer@ is a handle to the buffer whose backing memory is affected by -- the barrier. buffer :: Buffer , -- | @offset@ is an offset in bytes into the backing memory for @buffer@; -- this is relative to the base offset as bound to the buffer (see -- 'Vulkan.Core10.MemoryManagement.bindBufferMemory'). offset :: DeviceSize , -- | @size@ is a size in bytes of the affected area of backing memory for -- @buffer@, or 'Vulkan.Core10.APIConstants.WHOLE_SIZE' to use the range -- from @offset@ to the end of the buffer. size :: DeviceSize } deriving (Typeable, Eq) #if defined(GENERIC_INSTANCES) deriving instance Generic (BufferMemoryBarrier) #endif deriving instance Show BufferMemoryBarrier instance ToCStruct BufferMemoryBarrier where withCStruct x f = allocaBytesAligned 56 8 $ \p -> pokeCStruct p x (f p) pokeCStruct p BufferMemoryBarrier{..} f = do poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER) poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr) poke ((p `plusPtr` 16 :: Ptr AccessFlags)) (srcAccessMask) poke ((p `plusPtr` 20 :: Ptr AccessFlags)) (dstAccessMask) poke ((p `plusPtr` 24 :: Ptr Word32)) (srcQueueFamilyIndex) poke ((p `plusPtr` 28 :: Ptr Word32)) (dstQueueFamilyIndex) poke ((p `plusPtr` 32 :: Ptr Buffer)) (buffer) poke ((p `plusPtr` 40 :: Ptr DeviceSize)) (offset) poke ((p `plusPtr` 48 :: Ptr DeviceSize)) (size) f cStructSize = 56 cStructAlignment = 8 pokeZeroCStruct p f = do poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_BUFFER_MEMORY_BARRIER) poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr) poke ((p `plusPtr` 16 :: Ptr AccessFlags)) (zero) poke ((p `plusPtr` 20 :: Ptr AccessFlags)) (zero) poke ((p `plusPtr` 24 :: Ptr Word32)) (zero) poke ((p `plusPtr` 28 :: Ptr Word32)) (zero) poke ((p `plusPtr` 32 :: Ptr Buffer)) (zero) poke ((p `plusPtr` 40 :: Ptr DeviceSize)) (zero) poke ((p `plusPtr` 48 :: Ptr DeviceSize)) (zero) f instance FromCStruct BufferMemoryBarrier where peekCStruct p = do srcAccessMask <- peek @AccessFlags ((p `plusPtr` 16 :: Ptr AccessFlags)) dstAccessMask <- peek @AccessFlags ((p `plusPtr` 20 :: Ptr AccessFlags)) srcQueueFamilyIndex <- peek @Word32 ((p `plusPtr` 24 :: Ptr Word32)) dstQueueFamilyIndex <- peek @Word32 ((p `plusPtr` 28 :: Ptr Word32)) buffer <- peek @Buffer ((p `plusPtr` 32 :: Ptr Buffer)) offset <- peek @DeviceSize ((p `plusPtr` 40 :: Ptr DeviceSize)) size <- peek @DeviceSize ((p `plusPtr` 48 :: Ptr DeviceSize)) pure $ BufferMemoryBarrier srcAccessMask dstAccessMask srcQueueFamilyIndex dstQueueFamilyIndex buffer offset size instance Storable BufferMemoryBarrier where sizeOf ~_ = 56 alignment ~_ = 8 peek = peekCStruct poke ptr poked = pokeCStruct ptr poked (pure ()) instance Zero BufferMemoryBarrier where zero = BufferMemoryBarrier zero zero zero zero zero zero zero -- | VkImageMemoryBarrier - Structure specifying the parameters of an image -- memory barrier -- -- = Description -- -- The first -- -- is limited to access to memory through the specified image subresource -- range, via access types in the -- -- specified by @srcAccessMask@. If @srcAccessMask@ includes -- 'Vulkan.Core10.Enums.AccessFlagBits.ACCESS_HOST_WRITE_BIT', memory -- writes performed by that access type are also made visible, as that -- access type is not performed through a resource. -- -- The second -- -- is limited to access to memory through the specified image subresource -- range, via access types in the -- -- specified by @dstAccessMask@. If @dstAccessMask@ includes -- 'Vulkan.Core10.Enums.AccessFlagBits.ACCESS_HOST_WRITE_BIT' or -- 'Vulkan.Core10.Enums.AccessFlagBits.ACCESS_HOST_READ_BIT', available -- memory writes are also made visible to accesses of those types, as those -- access types are not performed through a resource. -- -- If @srcQueueFamilyIndex@ is not equal to @dstQueueFamilyIndex@, and -- @srcQueueFamilyIndex@ is equal to the current queue family, then the -- memory barrier defines a -- -- for the specified image subresource range, and the second access scope -- includes no access, as if @dstAccessMask@ was @0@. -- -- If @dstQueueFamilyIndex@ is not equal to @srcQueueFamilyIndex@, and -- @dstQueueFamilyIndex@ is equal to the current queue family, then the -- memory barrier defines a -- -- for the specified image subresource range, and the first access scope -- includes no access, as if @srcAccessMask@ was @0@. -- -- @oldLayout@ and @newLayout@ define an -- -- for the specified image subresource range. -- -- If @image@ has a multi-planar format and the image is /disjoint/, then -- including -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_COLOR_BIT' in the -- @aspectMask@ member of @subresourceRange@ is equivalent to including -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_PLANE_0_BIT', -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_PLANE_1_BIT', and -- (for three-plane formats only) -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_PLANE_2_BIT'. -- -- == Valid Usage -- -- - @subresourceRange.baseMipLevel@ /must/ be less than the @mipLevels@ -- specified in 'Vulkan.Core10.Image.ImageCreateInfo' when @image@ was -- created -- -- - If @subresourceRange.levelCount@ is not -- 'Vulkan.Core10.APIConstants.REMAINING_MIP_LEVELS', -- @subresourceRange.baseMipLevel@ + @subresourceRange.levelCount@ -- /must/ be less than or equal to the @mipLevels@ specified in -- 'Vulkan.Core10.Image.ImageCreateInfo' when @image@ was created -- -- - @subresourceRange.baseArrayLayer@ /must/ be less than the -- @arrayLayers@ specified in 'Vulkan.Core10.Image.ImageCreateInfo' -- when @image@ was created -- -- - If @subresourceRange.layerCount@ is not -- 'Vulkan.Core10.APIConstants.REMAINING_ARRAY_LAYERS', -- @subresourceRange.baseArrayLayer@ + @subresourceRange.layerCount@ -- /must/ be less than or equal to the @arrayLayers@ specified in -- 'Vulkan.Core10.Image.ImageCreateInfo' when @image@ was created -- -- - If @image@ is non-sparse then it /must/ be bound completely and -- contiguously to a single 'Vulkan.Core10.Handles.DeviceMemory' object -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_COLOR_ATTACHMENT_OPTIMAL' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_COLOR_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_DEPTH_STENCIL_ATTACHMENT_OPTIMAL' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_DEPTH_STENCIL_READ_ONLY_OPTIMAL' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_SHADER_READ_ONLY_OPTIMAL' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_SAMPLED_BIT' or -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_INPUT_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_TRANSFER_SRC_OPTIMAL' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_TRANSFER_SRC_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_TRANSFER_DST_OPTIMAL' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_TRANSFER_DST_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- @oldLayout@ /must/ be -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_UNDEFINED' or the -- current layout of the image subresources affected by the barrier -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- @newLayout@ /must/ not be -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_UNDEFINED' or -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_PREINITIALIZED' -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_DEPTH_READ_ONLY_STENCIL_ATTACHMENT_OPTIMAL' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Core10.Enums.ImageLayout.IMAGE_LAYOUT_DEPTH_ATTACHMENT_STENCIL_READ_ONLY_OPTIMAL' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Extensions.VK_KHR_separate_depth_stencil_layouts.IMAGE_LAYOUT_DEPTH_READ_ONLY_OPTIMAL_KHR' -- then @image@ /must/ have been created with at least one of -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT', -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_SAMPLED_BIT', or -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_INPUT_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Extensions.VK_KHR_separate_depth_stencil_layouts.IMAGE_LAYOUT_DEPTH_ATTACHMENT_OPTIMAL_KHR' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Extensions.VK_KHR_separate_depth_stencil_layouts.IMAGE_LAYOUT_STENCIL_READ_ONLY_OPTIMAL_KHR' -- then @image@ /must/ have been created with at least one of -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT', -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_SAMPLED_BIT', or -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_INPUT_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Extensions.VK_KHR_separate_depth_stencil_layouts.IMAGE_LAYOUT_STENCIL_ATTACHMENT_OPTIMAL_KHR' -- then @image@ /must/ have been created with -- 'Vulkan.Core10.Enums.ImageUsageFlagBits.IMAGE_USAGE_DEPTH_STENCIL_ATTACHMENT_BIT' -- set -- -- - If @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ define a -- -- or @oldLayout@ and @newLayout@ define a -- , -- and @oldLayout@ or @newLayout@ is -- 'Vulkan.Extensions.VK_KHR_fragment_shading_rate.IMAGE_LAYOUT_FRAGMENT_SHADING_RATE_ATTACHMENT_OPTIMAL_KHR' -- then @image@ /must/ have been created with -- 'Vulkan.Extensions.VK_KHR_fragment_shading_rate.IMAGE_USAGE_FRAGMENT_SHADING_RATE_ATTACHMENT_BIT_KHR' -- set -- -- - If @image@ has a single-plane color format or is not /disjoint/, -- then the @aspectMask@ member of @subresourceRange@ /must/ be -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_COLOR_BIT' -- -- - If @image@ has a multi-planar format and the image is /disjoint/, -- then the @aspectMask@ member of @subresourceRange@ /must/ include -- either at least one of -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_PLANE_0_BIT', -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_PLANE_1_BIT', -- and -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_PLANE_2_BIT'; -- or /must/ include -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_COLOR_BIT' -- -- - If @image@ has a multi-planar format with only two planes, then the -- @aspectMask@ member of @subresourceRange@ /must/ not include -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_PLANE_2_BIT' -- -- - If @image@ has a depth\/stencil format with both depth and stencil -- and the -- -- feature is enabled, then the @aspectMask@ member of -- @subresourceRange@ /must/ include either or both -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_DEPTH_BIT' and -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_STENCIL_BIT' -- -- - If @image@ has a depth\/stencil format with both depth and stencil -- and the -- -- feature is not enabled, then the @aspectMask@ member of -- @subresourceRange@ /must/ include both -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_DEPTH_BIT' and -- 'Vulkan.Core10.Enums.ImageAspectFlagBits.IMAGE_ASPECT_STENCIL_BIT' -- -- - If @srcQueueFamilyIndex@ is not equal to @dstQueueFamilyIndex@, at -- least one /must/ not be a special queue family reserved for external -- memory ownership transfers, as described in -- -- -- - If @image@ was created with a sharing mode of -- 'Vulkan.Core10.Enums.SharingMode.SHARING_MODE_CONCURRENT', -- @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ are not equal, and -- one of @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ is a special -- queue family values reserved for external memory transfers, the -- other /must/ be 'Vulkan.Core10.APIConstants.QUEUE_FAMILY_IGNORED' -- -- - If @image@ was created with a sharing mode of -- 'Vulkan.Core10.Enums.SharingMode.SHARING_MODE_EXCLUSIVE', and -- @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ are not equal, -- @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ /must/ both be valid -- queue families, or one of the special queue family values reserved -- for external memory transfers, as described in -- -- -- - If @image@ was created with a sharing mode of -- 'Vulkan.Core10.Enums.SharingMode.SHARING_MODE_CONCURRENT', at least -- one of @srcQueueFamilyIndex@ and @dstQueueFamilyIndex@ /must/ be -- 'Vulkan.Core10.APIConstants.QUEUE_FAMILY_IGNORED' -- -- == Valid Usage (Implicit) -- -- - @sType@ /must/ be -- 'Vulkan.Core10.Enums.StructureType.STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER' -- -- - @pNext@ /must/ be @NULL@ or a pointer to a valid instance of -- 'Vulkan.Extensions.VK_EXT_sample_locations.SampleLocationsInfoEXT' -- -- - The @sType@ value of each struct in the @pNext@ chain /must/ be -- unique -- -- - @oldLayout@ /must/ be a valid -- 'Vulkan.Core10.Enums.ImageLayout.ImageLayout' value -- -- - @newLayout@ /must/ be a valid -- 'Vulkan.Core10.Enums.ImageLayout.ImageLayout' value -- -- - @image@ /must/ be a valid 'Vulkan.Core10.Handles.Image' handle -- -- - @subresourceRange@ /must/ be a valid -- 'Vulkan.Core10.ImageView.ImageSubresourceRange' structure -- -- = See Also -- -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlags', -- 'Vulkan.Core10.Handles.Image', -- 'Vulkan.Core10.Enums.ImageLayout.ImageLayout', -- 'Vulkan.Core10.ImageView.ImageSubresourceRange', -- 'Vulkan.Core10.Enums.StructureType.StructureType', -- 'Vulkan.Core10.CommandBufferBuilding.cmdPipelineBarrier', -- 'Vulkan.Core10.CommandBufferBuilding.cmdWaitEvents' data ImageMemoryBarrier (es :: [Type]) = ImageMemoryBarrier { -- | @pNext@ is @NULL@ or a pointer to a structure extending this structure. next :: Chain es , -- | @srcAccessMask@ is a bitmask of -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlagBits' specifying a -- . srcAccessMask :: AccessFlags , -- | @dstAccessMask@ is a bitmask of -- 'Vulkan.Core10.Enums.AccessFlagBits.AccessFlagBits' specifying a -- . dstAccessMask :: AccessFlags , -- | @oldLayout@ is the old layout in an -- . oldLayout :: ImageLayout , -- | @newLayout@ is the new layout in an -- . newLayout :: ImageLayout , -- | @srcQueueFamilyIndex@ is the source queue family for a -- . srcQueueFamilyIndex :: Word32 , -- | @dstQueueFamilyIndex@ is the destination queue family for a -- . dstQueueFamilyIndex :: Word32 , -- | @image@ is a handle to the image affected by this barrier. image :: Image , -- | @subresourceRange@ describes the -- -- within @image@ that is affected by this barrier. subresourceRange :: ImageSubresourceRange } deriving (Typeable) #if defined(GENERIC_INSTANCES) deriving instance Generic (ImageMemoryBarrier (es :: [Type])) #endif deriving instance Show (Chain es) => Show (ImageMemoryBarrier es) instance Extensible ImageMemoryBarrier where extensibleType = STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER setNext x next = x{next = next} getNext ImageMemoryBarrier{..} = next extends :: forall e b proxy. Typeable e => proxy e -> (Extends ImageMemoryBarrier e => b) -> Maybe b extends _ f | Just Refl <- eqT @e @SampleLocationsInfoEXT = Just f | otherwise = Nothing instance (Extendss ImageMemoryBarrier es, PokeChain es) => ToCStruct (ImageMemoryBarrier es) where withCStruct x f = allocaBytesAligned 72 8 $ \p -> pokeCStruct p x (f p) pokeCStruct p ImageMemoryBarrier{..} f = evalContT $ do lift $ poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER) pNext'' <- fmap castPtr . ContT $ withChain (next) lift $ poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) pNext'' lift $ poke ((p `plusPtr` 16 :: Ptr AccessFlags)) (srcAccessMask) lift $ poke ((p `plusPtr` 20 :: Ptr AccessFlags)) (dstAccessMask) lift $ poke ((p `plusPtr` 24 :: Ptr ImageLayout)) (oldLayout) lift $ poke ((p `plusPtr` 28 :: Ptr ImageLayout)) (newLayout) lift $ poke ((p `plusPtr` 32 :: Ptr Word32)) (srcQueueFamilyIndex) lift $ poke ((p `plusPtr` 36 :: Ptr Word32)) (dstQueueFamilyIndex) lift $ poke ((p `plusPtr` 40 :: Ptr Image)) (image) ContT $ pokeCStruct ((p `plusPtr` 48 :: Ptr ImageSubresourceRange)) (subresourceRange) . ($ ()) lift $ f cStructSize = 72 cStructAlignment = 8 pokeZeroCStruct p f = evalContT $ do lift $ poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_IMAGE_MEMORY_BARRIER) pNext' <- fmap castPtr . ContT $ withZeroChain @es lift $ poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) pNext' lift $ poke ((p `plusPtr` 16 :: Ptr AccessFlags)) (zero) lift $ poke ((p `plusPtr` 20 :: Ptr AccessFlags)) (zero) lift $ poke ((p `plusPtr` 24 :: Ptr ImageLayout)) (zero) lift $ poke ((p `plusPtr` 28 :: Ptr ImageLayout)) (zero) lift $ poke ((p `plusPtr` 32 :: Ptr Word32)) (zero) lift $ poke ((p `plusPtr` 36 :: Ptr Word32)) (zero) lift $ poke ((p `plusPtr` 40 :: Ptr Image)) (zero) ContT $ pokeCStruct ((p `plusPtr` 48 :: Ptr ImageSubresourceRange)) (zero) . ($ ()) lift $ f instance (Extendss ImageMemoryBarrier es, PeekChain es) => FromCStruct (ImageMemoryBarrier es) where peekCStruct p = do pNext <- peek @(Ptr ()) ((p `plusPtr` 8 :: Ptr (Ptr ()))) next <- peekChain (castPtr pNext) srcAccessMask <- peek @AccessFlags ((p `plusPtr` 16 :: Ptr AccessFlags)) dstAccessMask <- peek @AccessFlags ((p `plusPtr` 20 :: Ptr AccessFlags)) oldLayout <- peek @ImageLayout ((p `plusPtr` 24 :: Ptr ImageLayout)) newLayout <- peek @ImageLayout ((p `plusPtr` 28 :: Ptr ImageLayout)) srcQueueFamilyIndex <- peek @Word32 ((p `plusPtr` 32 :: Ptr Word32)) dstQueueFamilyIndex <- peek @Word32 ((p `plusPtr` 36 :: Ptr Word32)) image <- peek @Image ((p `plusPtr` 40 :: Ptr Image)) subresourceRange <- peekCStruct @ImageSubresourceRange ((p `plusPtr` 48 :: Ptr ImageSubresourceRange)) pure $ ImageMemoryBarrier next srcAccessMask dstAccessMask oldLayout newLayout srcQueueFamilyIndex dstQueueFamilyIndex image subresourceRange instance es ~ '[] => Zero (ImageMemoryBarrier es) where zero = ImageMemoryBarrier () zero zero zero zero zero zero zero zero -- | VkDrawIndirectCommand - Structure specifying a draw indirect command -- -- = Description -- -- The members of 'DrawIndirectCommand' have the same meaning as the -- similarly named parameters of -- 'Vulkan.Core10.CommandBufferBuilding.cmdDraw'. -- -- == Valid Usage -- -- - For a given vertex buffer binding, any attribute data fetched /must/ -- be entirely contained within the corresponding vertex buffer -- binding, as described in -- -- -- - If the -- -- feature is not enabled, @firstInstance@ /must/ be @0@ -- -- = See Also -- -- 'Vulkan.Core10.CommandBufferBuilding.cmdDrawIndirect' data DrawIndirectCommand = DrawIndirectCommand { -- | @vertexCount@ is the number of vertices to draw. vertexCount :: Word32 , -- | @instanceCount@ is the number of instances to draw. instanceCount :: Word32 , -- | @firstVertex@ is the index of the first vertex to draw. firstVertex :: Word32 , -- | @firstInstance@ is the instance ID of the first instance to draw. firstInstance :: Word32 } deriving (Typeable, Eq) #if defined(GENERIC_INSTANCES) deriving instance Generic (DrawIndirectCommand) #endif deriving instance Show DrawIndirectCommand instance ToCStruct DrawIndirectCommand where withCStruct x f = allocaBytesAligned 16 4 $ \p -> pokeCStruct p x (f p) pokeCStruct p DrawIndirectCommand{..} f = do poke ((p `plusPtr` 0 :: Ptr Word32)) (vertexCount) poke ((p `plusPtr` 4 :: Ptr Word32)) (instanceCount) poke ((p `plusPtr` 8 :: Ptr Word32)) (firstVertex) poke ((p `plusPtr` 12 :: Ptr Word32)) (firstInstance) f cStructSize = 16 cStructAlignment = 4 pokeZeroCStruct p f = do poke ((p `plusPtr` 0 :: Ptr Word32)) (zero) poke ((p `plusPtr` 4 :: Ptr Word32)) (zero) poke ((p `plusPtr` 8 :: Ptr Word32)) (zero) poke ((p `plusPtr` 12 :: Ptr Word32)) (zero) f instance FromCStruct DrawIndirectCommand where peekCStruct p = do vertexCount <- peek @Word32 ((p `plusPtr` 0 :: Ptr Word32)) instanceCount <- peek @Word32 ((p `plusPtr` 4 :: Ptr Word32)) firstVertex <- peek @Word32 ((p `plusPtr` 8 :: Ptr Word32)) firstInstance <- peek @Word32 ((p `plusPtr` 12 :: Ptr Word32)) pure $ DrawIndirectCommand vertexCount instanceCount firstVertex firstInstance instance Storable DrawIndirectCommand where sizeOf ~_ = 16 alignment ~_ = 4 peek = peekCStruct poke ptr poked = pokeCStruct ptr poked (pure ()) instance Zero DrawIndirectCommand where zero = DrawIndirectCommand zero zero zero zero -- | VkDrawIndexedIndirectCommand - Structure specifying a draw indexed -- indirect command -- -- = Description -- -- The members of 'DrawIndexedIndirectCommand' have the same meaning as the -- similarly named parameters of -- 'Vulkan.Core10.CommandBufferBuilding.cmdDrawIndexed'. -- -- == Valid Usage -- -- - For a given vertex buffer binding, any attribute data fetched /must/ -- be entirely contained within the corresponding vertex buffer -- binding, as described in -- -- -- - (@indexSize@ × (@firstIndex@ + @indexCount@) + @offset@) /must/ be -- less than or equal to the size of the bound index buffer, with -- @indexSize@ being based on the type specified by @indexType@, where -- the index buffer, @indexType@, and @offset@ are specified via -- 'Vulkan.Core10.CommandBufferBuilding.cmdBindIndexBuffer' -- -- - If the -- -- feature is not enabled, @firstInstance@ /must/ be @0@ -- -- = See Also -- -- 'Vulkan.Core10.CommandBufferBuilding.cmdDrawIndexedIndirect' data DrawIndexedIndirectCommand = DrawIndexedIndirectCommand { -- | @indexCount@ is the number of vertices to draw. indexCount :: Word32 , -- | @instanceCount@ is the number of instances to draw. instanceCount :: Word32 , -- | @firstIndex@ is the base index within the index buffer. firstIndex :: Word32 , -- | @vertexOffset@ is the value added to the vertex index before indexing -- into the vertex buffer. vertexOffset :: Int32 , -- | @firstInstance@ is the instance ID of the first instance to draw. firstInstance :: Word32 } deriving (Typeable, Eq) #if defined(GENERIC_INSTANCES) deriving instance Generic (DrawIndexedIndirectCommand) #endif deriving instance Show DrawIndexedIndirectCommand instance ToCStruct DrawIndexedIndirectCommand where withCStruct x f = allocaBytesAligned 20 4 $ \p -> pokeCStruct p x (f p) pokeCStruct p DrawIndexedIndirectCommand{..} f = do poke ((p `plusPtr` 0 :: Ptr Word32)) (indexCount) poke ((p `plusPtr` 4 :: Ptr Word32)) (instanceCount) poke ((p `plusPtr` 8 :: Ptr Word32)) (firstIndex) poke ((p `plusPtr` 12 :: Ptr Int32)) (vertexOffset) poke ((p `plusPtr` 16 :: Ptr Word32)) (firstInstance) f cStructSize = 20 cStructAlignment = 4 pokeZeroCStruct p f = do poke ((p `plusPtr` 0 :: Ptr Word32)) (zero) poke ((p `plusPtr` 4 :: Ptr Word32)) (zero) poke ((p `plusPtr` 8 :: Ptr Word32)) (zero) poke ((p `plusPtr` 12 :: Ptr Int32)) (zero) poke ((p `plusPtr` 16 :: Ptr Word32)) (zero) f instance FromCStruct DrawIndexedIndirectCommand where peekCStruct p = do indexCount <- peek @Word32 ((p `plusPtr` 0 :: Ptr Word32)) instanceCount <- peek @Word32 ((p `plusPtr` 4 :: Ptr Word32)) firstIndex <- peek @Word32 ((p `plusPtr` 8 :: Ptr Word32)) vertexOffset <- peek @Int32 ((p `plusPtr` 12 :: Ptr Int32)) firstInstance <- peek @Word32 ((p `plusPtr` 16 :: Ptr Word32)) pure $ DrawIndexedIndirectCommand indexCount instanceCount firstIndex vertexOffset firstInstance instance Storable DrawIndexedIndirectCommand where sizeOf ~_ = 20 alignment ~_ = 4 peek = peekCStruct poke ptr poked = pokeCStruct ptr poked (pure ()) instance Zero DrawIndexedIndirectCommand where zero = DrawIndexedIndirectCommand zero zero zero zero zero -- | VkDispatchIndirectCommand - Structure specifying a dispatch indirect -- command -- -- = Description -- -- The members of 'DispatchIndirectCommand' have the same meaning as the -- corresponding parameters of -- 'Vulkan.Core10.CommandBufferBuilding.cmdDispatch'. -- -- == Valid Usage -- -- = See Also -- -- 'Vulkan.Core10.CommandBufferBuilding.cmdDispatchIndirect' data DispatchIndirectCommand = DispatchIndirectCommand { -- | @x@ is the number of local workgroups to dispatch in the X dimension. -- -- @x@ /must/ be less than or equal to -- 'Vulkan.Core10.DeviceInitialization.PhysicalDeviceLimits'::@maxComputeWorkGroupCount@[0] x :: Word32 , -- | @y@ is the number of local workgroups to dispatch in the Y dimension. -- -- @y@ /must/ be less than or equal to -- 'Vulkan.Core10.DeviceInitialization.PhysicalDeviceLimits'::@maxComputeWorkGroupCount@[1] y :: Word32 , -- | @z@ is the number of local workgroups to dispatch in the Z dimension. -- -- @z@ /must/ be less than or equal to -- 'Vulkan.Core10.DeviceInitialization.PhysicalDeviceLimits'::@maxComputeWorkGroupCount@[2] z :: Word32 } deriving (Typeable, Eq) #if defined(GENERIC_INSTANCES) deriving instance Generic (DispatchIndirectCommand) #endif deriving instance Show DispatchIndirectCommand instance ToCStruct DispatchIndirectCommand where withCStruct x f = allocaBytesAligned 12 4 $ \p -> pokeCStruct p x (f p) pokeCStruct p DispatchIndirectCommand{..} f = do poke ((p `plusPtr` 0 :: Ptr Word32)) (x) poke ((p `plusPtr` 4 :: Ptr Word32)) (y) poke ((p `plusPtr` 8 :: Ptr Word32)) (z) f cStructSize = 12 cStructAlignment = 4 pokeZeroCStruct p f = do poke ((p `plusPtr` 0 :: Ptr Word32)) (zero) poke ((p `plusPtr` 4 :: Ptr Word32)) (zero) poke ((p `plusPtr` 8 :: Ptr Word32)) (zero) f instance FromCStruct DispatchIndirectCommand where peekCStruct p = do x <- peek @Word32 ((p `plusPtr` 0 :: Ptr Word32)) y <- peek @Word32 ((p `plusPtr` 4 :: Ptr Word32)) z <- peek @Word32 ((p `plusPtr` 8 :: Ptr Word32)) pure $ DispatchIndirectCommand x y z instance Storable DispatchIndirectCommand where sizeOf ~_ = 12 alignment ~_ = 4 peek = peekCStruct poke ptr poked = pokeCStruct ptr poked (pure ()) instance Zero DispatchIndirectCommand where zero = DispatchIndirectCommand zero zero zero