vulkan-3.26.1: Bindings to the Vulkan graphics API.
Safe HaskellSafe-Inferred
LanguageHaskell2010

Vulkan.Core10.PipelineCache

Synopsis

Documentation

createPipelineCache Source #

Arguments

:: forall io. MonadIO io 
=> Device

device is the logical device that creates the pipeline cache object.

-> PipelineCacheCreateInfo

pCreateInfo is a pointer to a PipelineCacheCreateInfo structure containing initial parameters for the pipeline cache object.

-> ("allocator" ::: Maybe AllocationCallbacks)

pAllocator controls host memory allocation as described in the Memory Allocation chapter.

-> io PipelineCache 

vkCreatePipelineCache - Creates a new pipeline cache

Description

Note

Applications can track and manage the total host memory size of a pipeline cache object using the pAllocator. Applications can limit the amount of data retrieved from a pipeline cache object in getPipelineCacheData. Implementations should not internally limit the total number of entries added to a pipeline cache object or the total host memory consumed.

Once created, a pipeline cache can be passed to the createGraphicsPipelines createRayTracingPipelinesKHR, createRayTracingPipelinesNV, and createComputePipelines commands. If the pipeline cache passed into these commands is not NULL_HANDLE, the implementation will query it for possible reuse opportunities and update it with new content. The use of the pipeline cache object in these commands is internally synchronized, and the same pipeline cache object can be used in multiple threads simultaneously.

If flags of pCreateInfo includes PIPELINE_CACHE_CREATE_EXTERNALLY_SYNCHRONIZED_BIT, all commands that modify the returned pipeline cache object must be externally synchronized.

Note

Implementations should make every effort to limit any critical sections to the actual accesses to the cache, which is expected to be significantly shorter than the duration of the vkCreate*Pipelines commands.

Valid Usage (Implicit)

  • device must be a valid Device handle

Return Codes

Success
Failure

See Also

VK_VERSION_1_0, AllocationCallbacks, Device, PipelineCache, PipelineCacheCreateInfo

withPipelineCache :: forall io r. MonadIO io => Device -> PipelineCacheCreateInfo -> Maybe AllocationCallbacks -> (io PipelineCache -> (PipelineCache -> io ()) -> r) -> r Source #

A convenience wrapper to make a compatible pair of calls to createPipelineCache and destroyPipelineCache

To ensure that destroyPipelineCache is always called: pass bracket (or the allocate function from your favourite resource management library) as the last argument. To just extract the pair pass (,) as the last argument.

destroyPipelineCache Source #

Arguments

:: forall io. MonadIO io 
=> Device

device is the logical device that destroys the pipeline cache object.

-> PipelineCache

pipelineCache is the handle of the pipeline cache to destroy.

-> ("allocator" ::: Maybe AllocationCallbacks)

pAllocator controls host memory allocation as described in the Memory Allocation chapter.

-> io () 

vkDestroyPipelineCache - Destroy a pipeline cache object

Valid Usage

  • If AllocationCallbacks were provided when pipelineCache was created, a compatible set of callbacks must be provided here
  • If no AllocationCallbacks were provided when pipelineCache was created, pAllocator must be NULL

Valid Usage (Implicit)

  • device must be a valid Device handle
  • If pipelineCache is not NULL_HANDLE, pipelineCache must be a valid PipelineCache handle
  • If pAllocator is not NULL, pAllocator must be a valid pointer to a valid AllocationCallbacks structure
  • If pipelineCache is a valid handle, it must have been created, allocated, or retrieved from device

Host Synchronization

  • Host access to pipelineCache must be externally synchronized

See Also

VK_VERSION_1_0, AllocationCallbacks, Device, PipelineCache

getPipelineCacheData Source #

Arguments

:: forall io. MonadIO io 
=> Device

device is the logical device that owns the pipeline cache.

-> PipelineCache

pipelineCache is the pipeline cache to retrieve data from.

-> io (Result, "data" ::: ByteString) 

vkGetPipelineCacheData - Get the data store from a pipeline cache

Description

If pData is NULL, then the maximum size of the data that can be retrieved from the pipeline cache, in bytes, is returned in pDataSize. Otherwise, pDataSize must point to a variable set by the user to the size of the buffer, in bytes, pointed to by pData, and on return the variable is overwritten with the amount of data actually written to pData. If pDataSize is less than the maximum size that can be retrieved by the pipeline cache, at most pDataSize bytes will be written to pData, and INCOMPLETE will be returned instead of SUCCESS, to indicate that not all of the pipeline cache was returned.

Any data written to pData is valid and can be provided as the pInitialData member of the PipelineCacheCreateInfo structure passed to createPipelineCache.

Two calls to getPipelineCacheData with the same parameters must retrieve the same data unless a command that modifies the contents of the cache is called between them.

The initial bytes written to pData must be a header as described in the Pipeline Cache Header section.

If pDataSize is less than what is necessary to store this header, nothing will be written to pData and zero will be written to pDataSize.

Valid Usage (Implicit)

  • device must be a valid Device handle
  • pipelineCache must be a valid PipelineCache handle
  • pDataSize must be a valid pointer to a size_t value
  • If the value referenced by pDataSize is not 0, and pData is not NULL, pData must be a valid pointer to an array of pDataSize bytes
  • pipelineCache must have been created, allocated, or retrieved from device

Return Codes

Success
Failure

See Also

VK_VERSION_1_0, Device, PipelineCache

mergePipelineCaches Source #

Arguments

:: forall io. MonadIO io 
=> Device

device is the logical device that owns the pipeline cache objects.

-> ("dstCache" ::: PipelineCache)

dstCache is the handle of the pipeline cache to merge results into.

-> ("srcCaches" ::: Vector PipelineCache)

pSrcCaches is a pointer to an array of pipeline cache handles, which will be merged into dstCache. The previous contents of dstCache are included after the merge.

-> io () 

vkMergePipelineCaches - Combine the data stores of pipeline caches

Description

Note

The details of the merge operation are implementation-dependent, but implementations should merge the contents of the specified pipelines and prune duplicate entries.

Valid Usage

  • dstCache must not appear in the list of source caches

Valid Usage (Implicit)

  • device must be a valid Device handle
  • dstCache must be a valid PipelineCache handle
  • pSrcCaches must be a valid pointer to an array of srcCacheCount valid PipelineCache handles
  • srcCacheCount must be greater than 0
  • dstCache must have been created, allocated, or retrieved from device
  • Each element of pSrcCaches must have been created, allocated, or retrieved from device

Host Synchronization

  • Host access to dstCache must be externally synchronized

Return Codes

Success
Failure

See Also

VK_VERSION_1_0, Device, PipelineCache

data PipelineCacheCreateInfo Source #

VkPipelineCacheCreateInfo - Structure specifying parameters of a newly created pipeline cache

Valid Usage

  • If initialDataSize is not 0, it must be equal to the size of pInitialData, as returned by getPipelineCacheData when pInitialData was originally retrieved

Valid Usage (Implicit)

  • pNext must be NULL
  • flags must be a valid combination of PipelineCacheCreateFlagBits values
  • If initialDataSize is not 0, pInitialData must be a valid pointer to an array of initialDataSize bytes

See Also

VK_VERSION_1_0, PipelineCacheCreateFlags, StructureType, createPipelineCache

Constructors

PipelineCacheCreateInfo 

Fields

  • flags :: PipelineCacheCreateFlags

    flags is a bitmask of PipelineCacheCreateFlagBits specifying the behavior of the pipeline cache.

  • initialDataSize :: Word64

    initialDataSize is the number of bytes in pInitialData. If initialDataSize is zero, the pipeline cache will initially be empty.

  • initialData :: Ptr ()

    pInitialData is a pointer to previously retrieved pipeline cache data. If the pipeline cache data is incompatible (as defined below) with the device, the pipeline cache will be initially empty. If initialDataSize is zero, pInitialData is ignored.

Instances

Instances details
Storable PipelineCacheCreateInfo Source # 
Instance details

Defined in Vulkan.Core10.PipelineCache

Show PipelineCacheCreateInfo Source # 
Instance details

Defined in Vulkan.Core10.PipelineCache

FromCStruct PipelineCacheCreateInfo Source # 
Instance details

Defined in Vulkan.Core10.PipelineCache

ToCStruct PipelineCacheCreateInfo Source # 
Instance details

Defined in Vulkan.Core10.PipelineCache

Zero PipelineCacheCreateInfo Source # 
Instance details

Defined in Vulkan.Core10.PipelineCache

newtype PipelineCache Source #

Constructors

PipelineCache Word64 

Instances

Instances details
Storable PipelineCache Source # 
Instance details

Defined in Vulkan.Core10.Handles

Show PipelineCache Source # 
Instance details

Defined in Vulkan.Core10.Handles

Eq PipelineCache Source # 
Instance details

Defined in Vulkan.Core10.Handles

Ord PipelineCache Source # 
Instance details

Defined in Vulkan.Core10.Handles

HasObjectType PipelineCache Source # 
Instance details

Defined in Vulkan.Core10.Handles

IsHandle PipelineCache Source # 
Instance details

Defined in Vulkan.Core10.Handles

Zero PipelineCache Source # 
Instance details

Defined in Vulkan.Core10.Handles

newtype PipelineCacheCreateFlagBits Source #

VkPipelineCacheCreateFlagBits - Bitmask specifying the behavior of the pipeline cache

See Also

VK_EXT_pipeline_creation_cache_control, PipelineCacheCreateFlags

Bundled Patterns

pattern PIPELINE_CACHE_CREATE_USE_APPLICATION_STORAGE_BIT :: PipelineCacheCreateFlagBits 
pattern PIPELINE_CACHE_CREATE_READ_ONLY_BIT :: PipelineCacheCreateFlagBits 
pattern PIPELINE_CACHE_CREATE_EXTERNALLY_SYNCHRONIZED_BIT :: PipelineCacheCreateFlagBits

PIPELINE_CACHE_CREATE_EXTERNALLY_SYNCHRONIZED_BIT specifies that all commands that modify the created PipelineCache will be externally synchronized. When set, the implementation may skip any unnecessary processing needed to support simultaneous modification from multiple threads where allowed.

Instances

Instances details
Storable PipelineCacheCreateFlagBits Source # 
Instance details

Defined in Vulkan.Core10.Enums.PipelineCacheCreateFlagBits

Bits PipelineCacheCreateFlagBits Source # 
Instance details

Defined in Vulkan.Core10.Enums.PipelineCacheCreateFlagBits

Methods

(.&.) :: PipelineCacheCreateFlagBits -> PipelineCacheCreateFlagBits -> PipelineCacheCreateFlagBits #

(.|.) :: PipelineCacheCreateFlagBits -> PipelineCacheCreateFlagBits -> PipelineCacheCreateFlagBits #

xor :: PipelineCacheCreateFlagBits -> PipelineCacheCreateFlagBits -> PipelineCacheCreateFlagBits #

complement :: PipelineCacheCreateFlagBits -> PipelineCacheCreateFlagBits #

shift :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

rotate :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

zeroBits :: PipelineCacheCreateFlagBits #

bit :: Int -> PipelineCacheCreateFlagBits #

setBit :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

clearBit :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

complementBit :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

testBit :: PipelineCacheCreateFlagBits -> Int -> Bool #

bitSizeMaybe :: PipelineCacheCreateFlagBits -> Maybe Int #

bitSize :: PipelineCacheCreateFlagBits -> Int #

isSigned :: PipelineCacheCreateFlagBits -> Bool #

shiftL :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

unsafeShiftL :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

shiftR :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

unsafeShiftR :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

rotateL :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

rotateR :: PipelineCacheCreateFlagBits -> Int -> PipelineCacheCreateFlagBits #

popCount :: PipelineCacheCreateFlagBits -> Int #

FiniteBits PipelineCacheCreateFlagBits Source # 
Instance details

Defined in Vulkan.Core10.Enums.PipelineCacheCreateFlagBits

Read PipelineCacheCreateFlagBits Source # 
Instance details

Defined in Vulkan.Core10.Enums.PipelineCacheCreateFlagBits

Show PipelineCacheCreateFlagBits Source # 
Instance details

Defined in Vulkan.Core10.Enums.PipelineCacheCreateFlagBits

Eq PipelineCacheCreateFlagBits Source # 
Instance details

Defined in Vulkan.Core10.Enums.PipelineCacheCreateFlagBits

Ord PipelineCacheCreateFlagBits Source # 
Instance details

Defined in Vulkan.Core10.Enums.PipelineCacheCreateFlagBits

Zero PipelineCacheCreateFlagBits Source # 
Instance details

Defined in Vulkan.Core10.Enums.PipelineCacheCreateFlagBits