vulkan-3.21: src/Vulkan/Extensions/VK_NV_dedicated_allocation.hs
{-# language CPP #-}
-- | = Name
--
-- VK_NV_dedicated_allocation - device extension
--
-- == VK_NV_dedicated_allocation
--
-- [__Name String__]
-- @VK_NV_dedicated_allocation@
--
-- [__Extension Type__]
-- Device extension
--
-- [__Registered Extension Number__]
-- 27
--
-- [__Revision__]
-- 1
--
-- [__Extension and Version Dependencies__]
--
-- - Requires support for Vulkan 1.0
--
-- [__Deprecation state__]
--
-- - /Deprecated/ by @VK_KHR_dedicated_allocation@ extension
--
-- - Which in turn was /promoted/ to
-- <https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#versions-1.1-promotions Vulkan 1.1>
--
-- [__Contact__]
--
-- - Jeff Bolz
-- <https://github.com/KhronosGroup/Vulkan-Docs/issues/new?body=[VK_NV_dedicated_allocation] @jeffbolznv%0A<<Here describe the issue or question you have about the VK_NV_dedicated_allocation extension>> >
--
-- == Other Extension Metadata
--
-- [__Last Modified Date__]
-- 2016-05-31
--
-- [__IP Status__]
-- No known IP claims.
--
-- [__Contributors__]
--
-- - Jeff Bolz, NVIDIA
--
-- == Description
--
-- This extension allows device memory to be allocated for a particular
-- buffer or image resource, which on some devices can significantly
-- improve the performance of that resource. Normal device memory
-- allocations must support memory aliasing and sparse binding, which could
-- interfere with optimizations like framebuffer compression or efficient
-- page table usage. This is important for render targets and very large
-- resources, but need not (and probably should not) be used for smaller
-- resources that can benefit from suballocation.
--
-- This extension adds a few small structures to resource creation and
-- memory allocation: a new structure that flags whether am image\/buffer
-- will have a dedicated allocation, and a structure indicating the image
-- or buffer that an allocation will be bound to.
--
-- == New Structures
--
-- - Extending 'Vulkan.Core10.Buffer.BufferCreateInfo':
--
-- - 'DedicatedAllocationBufferCreateInfoNV'
--
-- - Extending 'Vulkan.Core10.Image.ImageCreateInfo':
--
-- - 'DedicatedAllocationImageCreateInfoNV'
--
-- - Extending 'Vulkan.Core10.Memory.MemoryAllocateInfo':
--
-- - 'DedicatedAllocationMemoryAllocateInfoNV'
--
-- == New Enum Constants
--
-- - 'NV_DEDICATED_ALLOCATION_EXTENSION_NAME'
--
-- - 'NV_DEDICATED_ALLOCATION_SPEC_VERSION'
--
-- - Extending 'Vulkan.Core10.Enums.StructureType.StructureType':
--
-- - 'Vulkan.Core10.Enums.StructureType.STRUCTURE_TYPE_DEDICATED_ALLOCATION_BUFFER_CREATE_INFO_NV'
--
-- - 'Vulkan.Core10.Enums.StructureType.STRUCTURE_TYPE_DEDICATED_ALLOCATION_IMAGE_CREATE_INFO_NV'
--
-- - 'Vulkan.Core10.Enums.StructureType.STRUCTURE_TYPE_DEDICATED_ALLOCATION_MEMORY_ALLOCATE_INFO_NV'
--
-- == Examples
--
-- > // Create an image with
-- > // VkDedicatedAllocationImageCreateInfoNV::dedicatedAllocation
-- > // set to VK_TRUE
-- >
-- > VkDedicatedAllocationImageCreateInfoNV dedicatedImageInfo =
-- > {
-- > VK_STRUCTURE_TYPE_DEDICATED_ALLOCATION_IMAGE_CREATE_INFO_NV, // sType
-- > NULL, // pNext
-- > VK_TRUE, // dedicatedAllocation
-- > };
-- >
-- > VkImageCreateInfo imageCreateInfo =
-- > {
-- > VK_STRUCTURE_TYPE_IMAGE_CREATE_INFO, // sType
-- > &dedicatedImageInfo // pNext
-- > // Other members set as usual
-- > };
-- >
-- > VkImage image;
-- > VkResult result = vkCreateImage(
-- > device,
-- > &imageCreateInfo,
-- > NULL, // pAllocator
-- > &image);
-- >
-- > VkMemoryRequirements memoryRequirements;
-- > vkGetImageMemoryRequirements(
-- > device,
-- > image,
-- > &memoryRequirements);
-- >
-- > // Allocate memory with VkDedicatedAllocationMemoryAllocateInfoNV::image
-- > // pointing to the image we are allocating the memory for
-- >
-- > VkDedicatedAllocationMemoryAllocateInfoNV dedicatedInfo =
-- > {
-- > VK_STRUCTURE_TYPE_DEDICATED_ALLOCATION_MEMORY_ALLOCATE_INFO_NV, // sType
-- > NULL, // pNext
-- > image, // image
-- > VK_NULL_HANDLE, // buffer
-- > };
-- >
-- > VkMemoryAllocateInfo memoryAllocateInfo =
-- > {
-- > VK_STRUCTURE_TYPE_MEMORY_ALLOCATE_INFO, // sType
-- > &dedicatedInfo, // pNext
-- > memoryRequirements.size, // allocationSize
-- > FindMemoryTypeIndex(memoryRequirements.memoryTypeBits), // memoryTypeIndex
-- > };
-- >
-- > VkDeviceMemory memory;
-- > vkAllocateMemory(
-- > device,
-- > &memoryAllocateInfo,
-- > NULL, // pAllocator
-- > &memory);
-- >
-- > // Bind the image to the memory
-- >
-- > vkBindImageMemory(
-- > device,
-- > image,
-- > memory,
-- > 0);
--
-- == Version History
--
-- - Revision 1, 2016-05-31 (Jeff Bolz)
--
-- - Internal revisions
--
-- == See Also
--
-- 'DedicatedAllocationBufferCreateInfoNV',
-- 'DedicatedAllocationImageCreateInfoNV',
-- 'DedicatedAllocationMemoryAllocateInfoNV'
--
-- == Document Notes
--
-- For more information, see the
-- <https://registry.khronos.org/vulkan/specs/1.3-extensions/html/vkspec.html#VK_NV_dedicated_allocation Vulkan Specification>
--
-- This page is a generated document. Fixes and changes should be made to
-- the generator scripts, not directly.
module Vulkan.Extensions.VK_NV_dedicated_allocation ( DedicatedAllocationImageCreateInfoNV(..)
, DedicatedAllocationBufferCreateInfoNV(..)
, DedicatedAllocationMemoryAllocateInfoNV(..)
, NV_DEDICATED_ALLOCATION_SPEC_VERSION
, pattern NV_DEDICATED_ALLOCATION_SPEC_VERSION
, NV_DEDICATED_ALLOCATION_EXTENSION_NAME
, pattern NV_DEDICATED_ALLOCATION_EXTENSION_NAME
) where
import Foreign.Marshal.Alloc (allocaBytes)
import Foreign.Ptr (nullPtr)
import Foreign.Ptr (plusPtr)
import Vulkan.CStruct (FromCStruct)
import Vulkan.CStruct (FromCStruct(..))
import Vulkan.CStruct (ToCStruct)
import Vulkan.CStruct (ToCStruct(..))
import Vulkan.Zero (Zero(..))
import Data.String (IsString)
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 Foreign.Ptr (Ptr)
import Data.Kind (Type)
import Vulkan.Core10.FundamentalTypes (bool32ToBool)
import Vulkan.Core10.FundamentalTypes (boolToBool32)
import Vulkan.Core10.FundamentalTypes (Bool32)
import Vulkan.Core10.Handles (Buffer)
import Vulkan.Core10.Handles (Image)
import Vulkan.Core10.Enums.StructureType (StructureType)
import Vulkan.Core10.Enums.StructureType (StructureType(STRUCTURE_TYPE_DEDICATED_ALLOCATION_BUFFER_CREATE_INFO_NV))
import Vulkan.Core10.Enums.StructureType (StructureType(STRUCTURE_TYPE_DEDICATED_ALLOCATION_IMAGE_CREATE_INFO_NV))
import Vulkan.Core10.Enums.StructureType (StructureType(STRUCTURE_TYPE_DEDICATED_ALLOCATION_MEMORY_ALLOCATE_INFO_NV))
-- | VkDedicatedAllocationImageCreateInfoNV - Specify that an image is bound
-- to a dedicated memory resource
--
-- = Description
--
-- Note
--
-- Using a dedicated allocation for color and depth\/stencil attachments or
-- other large images /may/ improve performance on some devices.
--
-- == Valid Usage
--
-- - #VUID-VkDedicatedAllocationImageCreateInfoNV-dedicatedAllocation-00994#
-- If @dedicatedAllocation@ is 'Vulkan.Core10.FundamentalTypes.TRUE',
-- 'Vulkan.Core10.Image.ImageCreateInfo'::@flags@ /must/ not include
-- 'Vulkan.Core10.Enums.ImageCreateFlagBits.IMAGE_CREATE_SPARSE_BINDING_BIT',
-- 'Vulkan.Core10.Enums.ImageCreateFlagBits.IMAGE_CREATE_SPARSE_RESIDENCY_BIT',
-- or
-- 'Vulkan.Core10.Enums.ImageCreateFlagBits.IMAGE_CREATE_SPARSE_ALIASED_BIT'
--
-- == Valid Usage (Implicit)
--
-- - #VUID-VkDedicatedAllocationImageCreateInfoNV-sType-sType# @sType@
-- /must/ be
-- 'Vulkan.Core10.Enums.StructureType.STRUCTURE_TYPE_DEDICATED_ALLOCATION_IMAGE_CREATE_INFO_NV'
--
-- = See Also
--
-- <https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#VK_NV_dedicated_allocation VK_NV_dedicated_allocation>,
-- 'Vulkan.Core10.FundamentalTypes.Bool32',
-- 'Vulkan.Core10.Enums.StructureType.StructureType'
data DedicatedAllocationImageCreateInfoNV = DedicatedAllocationImageCreateInfoNV
{ -- | @dedicatedAllocation@ specifies whether the image will have a dedicated
-- allocation bound to it.
dedicatedAllocation :: Bool }
deriving (Typeable, Eq)
#if defined(GENERIC_INSTANCES)
deriving instance Generic (DedicatedAllocationImageCreateInfoNV)
#endif
deriving instance Show DedicatedAllocationImageCreateInfoNV
instance ToCStruct DedicatedAllocationImageCreateInfoNV where
withCStruct x f = allocaBytes 24 $ \p -> pokeCStruct p x (f p)
pokeCStruct p DedicatedAllocationImageCreateInfoNV{..} f = do
poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_DEDICATED_ALLOCATION_IMAGE_CREATE_INFO_NV)
poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr)
poke ((p `plusPtr` 16 :: Ptr Bool32)) (boolToBool32 (dedicatedAllocation))
f
cStructSize = 24
cStructAlignment = 8
pokeZeroCStruct p f = do
poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_DEDICATED_ALLOCATION_IMAGE_CREATE_INFO_NV)
poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr)
poke ((p `plusPtr` 16 :: Ptr Bool32)) (boolToBool32 (zero))
f
instance FromCStruct DedicatedAllocationImageCreateInfoNV where
peekCStruct p = do
dedicatedAllocation <- peek @Bool32 ((p `plusPtr` 16 :: Ptr Bool32))
pure $ DedicatedAllocationImageCreateInfoNV
(bool32ToBool dedicatedAllocation)
instance Storable DedicatedAllocationImageCreateInfoNV where
sizeOf ~_ = 24
alignment ~_ = 8
peek = peekCStruct
poke ptr poked = pokeCStruct ptr poked (pure ())
instance Zero DedicatedAllocationImageCreateInfoNV where
zero = DedicatedAllocationImageCreateInfoNV
zero
-- | VkDedicatedAllocationBufferCreateInfoNV - Specify that a buffer is bound
-- to a dedicated memory resource
--
-- == Valid Usage (Implicit)
--
-- = See Also
--
-- <https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#VK_NV_dedicated_allocation VK_NV_dedicated_allocation>,
-- 'Vulkan.Core10.FundamentalTypes.Bool32',
-- 'Vulkan.Core10.Enums.StructureType.StructureType'
data DedicatedAllocationBufferCreateInfoNV = DedicatedAllocationBufferCreateInfoNV
{ -- | @dedicatedAllocation@ specifies whether the buffer will have a dedicated
-- allocation bound to it.
dedicatedAllocation :: Bool }
deriving (Typeable, Eq)
#if defined(GENERIC_INSTANCES)
deriving instance Generic (DedicatedAllocationBufferCreateInfoNV)
#endif
deriving instance Show DedicatedAllocationBufferCreateInfoNV
instance ToCStruct DedicatedAllocationBufferCreateInfoNV where
withCStruct x f = allocaBytes 24 $ \p -> pokeCStruct p x (f p)
pokeCStruct p DedicatedAllocationBufferCreateInfoNV{..} f = do
poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_DEDICATED_ALLOCATION_BUFFER_CREATE_INFO_NV)
poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr)
poke ((p `plusPtr` 16 :: Ptr Bool32)) (boolToBool32 (dedicatedAllocation))
f
cStructSize = 24
cStructAlignment = 8
pokeZeroCStruct p f = do
poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_DEDICATED_ALLOCATION_BUFFER_CREATE_INFO_NV)
poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr)
poke ((p `plusPtr` 16 :: Ptr Bool32)) (boolToBool32 (zero))
f
instance FromCStruct DedicatedAllocationBufferCreateInfoNV where
peekCStruct p = do
dedicatedAllocation <- peek @Bool32 ((p `plusPtr` 16 :: Ptr Bool32))
pure $ DedicatedAllocationBufferCreateInfoNV
(bool32ToBool dedicatedAllocation)
instance Storable DedicatedAllocationBufferCreateInfoNV where
sizeOf ~_ = 24
alignment ~_ = 8
peek = peekCStruct
poke ptr poked = pokeCStruct ptr poked (pure ())
instance Zero DedicatedAllocationBufferCreateInfoNV where
zero = DedicatedAllocationBufferCreateInfoNV
zero
-- | VkDedicatedAllocationMemoryAllocateInfoNV - Specify a dedicated memory
-- allocation resource
--
-- == Valid Usage
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-00649# At
-- least one of @image@ and @buffer@ /must/ be
-- 'Vulkan.Core10.APIConstants.NULL_HANDLE'
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-00650# If
-- @image@ is not 'Vulkan.Core10.APIConstants.NULL_HANDLE', the image
-- /must/ have been created with
-- 'DedicatedAllocationImageCreateInfoNV'::@dedicatedAllocation@ equal
-- to 'Vulkan.Core10.FundamentalTypes.TRUE'
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-buffer-00651# If
-- @buffer@ is not 'Vulkan.Core10.APIConstants.NULL_HANDLE', the buffer
-- /must/ have been created with
-- 'DedicatedAllocationBufferCreateInfoNV'::@dedicatedAllocation@ equal
-- to 'Vulkan.Core10.FundamentalTypes.TRUE'
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-00652# If
-- @image@ is not 'Vulkan.Core10.APIConstants.NULL_HANDLE',
-- 'Vulkan.Core10.Memory.MemoryAllocateInfo'::@allocationSize@ /must/
-- equal the
-- 'Vulkan.Core10.MemoryManagement.MemoryRequirements'::@size@ of the
-- image
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-buffer-00653# If
-- @buffer@ is not 'Vulkan.Core10.APIConstants.NULL_HANDLE',
-- 'Vulkan.Core10.Memory.MemoryAllocateInfo'::@allocationSize@ /must/
-- equal the
-- 'Vulkan.Core10.MemoryManagement.MemoryRequirements'::@size@ of the
-- buffer
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-00654# If
-- @image@ is not 'Vulkan.Core10.APIConstants.NULL_HANDLE' and
-- 'Vulkan.Core10.Memory.MemoryAllocateInfo' defines a memory import
-- operation, the memory being imported /must/ also be a dedicated
-- image allocation and @image@ /must/ be identical to the image
-- associated with the imported memory
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-buffer-00655# If
-- @buffer@ is not 'Vulkan.Core10.APIConstants.NULL_HANDLE' and
-- 'Vulkan.Core10.Memory.MemoryAllocateInfo' defines a memory import
-- operation, the memory being imported /must/ also be a dedicated
-- buffer allocation and @buffer@ /must/ be identical to the buffer
-- associated with the imported memory
--
-- == Valid Usage (Implicit)
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-sType-sType# @sType@
-- /must/ be
-- 'Vulkan.Core10.Enums.StructureType.STRUCTURE_TYPE_DEDICATED_ALLOCATION_MEMORY_ALLOCATE_INFO_NV'
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-image-parameter# If
-- @image@ is not 'Vulkan.Core10.APIConstants.NULL_HANDLE', @image@
-- /must/ be a valid 'Vulkan.Core10.Handles.Image' handle
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-buffer-parameter# If
-- @buffer@ is not 'Vulkan.Core10.APIConstants.NULL_HANDLE', @buffer@
-- /must/ be a valid 'Vulkan.Core10.Handles.Buffer' handle
--
-- - #VUID-VkDedicatedAllocationMemoryAllocateInfoNV-commonparent# Both
-- of @buffer@, and @image@ that are valid handles of non-ignored
-- parameters /must/ have been created, allocated, or retrieved from
-- the same 'Vulkan.Core10.Handles.Device'
--
-- = See Also
--
-- <https://www.khronos.org/registry/vulkan/specs/1.2-extensions/html/vkspec.html#VK_NV_dedicated_allocation VK_NV_dedicated_allocation>,
-- 'Vulkan.Core10.Handles.Buffer', 'Vulkan.Core10.Handles.Image',
-- 'Vulkan.Core10.Enums.StructureType.StructureType'
data DedicatedAllocationMemoryAllocateInfoNV = DedicatedAllocationMemoryAllocateInfoNV
{ -- | @image@ is 'Vulkan.Core10.APIConstants.NULL_HANDLE' or a handle of an
-- image which this memory will be bound to.
image :: Image
, -- | @buffer@ is 'Vulkan.Core10.APIConstants.NULL_HANDLE' or a handle of a
-- buffer which this memory will be bound to.
buffer :: Buffer
}
deriving (Typeable, Eq)
#if defined(GENERIC_INSTANCES)
deriving instance Generic (DedicatedAllocationMemoryAllocateInfoNV)
#endif
deriving instance Show DedicatedAllocationMemoryAllocateInfoNV
instance ToCStruct DedicatedAllocationMemoryAllocateInfoNV where
withCStruct x f = allocaBytes 32 $ \p -> pokeCStruct p x (f p)
pokeCStruct p DedicatedAllocationMemoryAllocateInfoNV{..} f = do
poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_DEDICATED_ALLOCATION_MEMORY_ALLOCATE_INFO_NV)
poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr)
poke ((p `plusPtr` 16 :: Ptr Image)) (image)
poke ((p `plusPtr` 24 :: Ptr Buffer)) (buffer)
f
cStructSize = 32
cStructAlignment = 8
pokeZeroCStruct p f = do
poke ((p `plusPtr` 0 :: Ptr StructureType)) (STRUCTURE_TYPE_DEDICATED_ALLOCATION_MEMORY_ALLOCATE_INFO_NV)
poke ((p `plusPtr` 8 :: Ptr (Ptr ()))) (nullPtr)
f
instance FromCStruct DedicatedAllocationMemoryAllocateInfoNV where
peekCStruct p = do
image <- peek @Image ((p `plusPtr` 16 :: Ptr Image))
buffer <- peek @Buffer ((p `plusPtr` 24 :: Ptr Buffer))
pure $ DedicatedAllocationMemoryAllocateInfoNV
image buffer
instance Storable DedicatedAllocationMemoryAllocateInfoNV where
sizeOf ~_ = 32
alignment ~_ = 8
peek = peekCStruct
poke ptr poked = pokeCStruct ptr poked (pure ())
instance Zero DedicatedAllocationMemoryAllocateInfoNV where
zero = DedicatedAllocationMemoryAllocateInfoNV
zero
zero
type NV_DEDICATED_ALLOCATION_SPEC_VERSION = 1
-- No documentation found for TopLevel "VK_NV_DEDICATED_ALLOCATION_SPEC_VERSION"
pattern NV_DEDICATED_ALLOCATION_SPEC_VERSION :: forall a . Integral a => a
pattern NV_DEDICATED_ALLOCATION_SPEC_VERSION = 1
type NV_DEDICATED_ALLOCATION_EXTENSION_NAME = "VK_NV_dedicated_allocation"
-- No documentation found for TopLevel "VK_NV_DEDICATED_ALLOCATION_EXTENSION_NAME"
pattern NV_DEDICATED_ALLOCATION_EXTENSION_NAME :: forall a . (Eq a, IsString a) => a
pattern NV_DEDICATED_ALLOCATION_EXTENSION_NAME = "VK_NV_dedicated_allocation"