Vulkan SC Pipeline Cache Utility
Overview
The Vulkan SC Pipeline Cache Utilty provides header-only utility implementations for reading (pcreader.hpp) and writing (pcwriter.hpp) Vulkan SC-specific pipeline cache files.
These are intended to be included in other projects as needed in order to ensure correct reading and writing of the pipeline cache header.
Expected use cases:
-
pcreader.hpp
- IHV driver to facilitate parsing the pipeline cache header
- Applications (including CTS) to retrieve pipeline entry information (identifier, poolEntrySize)
- validation layers and tools to extract Json and shader code
-
pcwriter.hpp
- offline pipeline cache compiler to facilitate writing the header information to the pipeline cache
Usage
Include the appropriate header implementation in your project.
These are written as C++ 11 headers, which assume the relevant headers are already included.
See pipeline.cpp for examples of minimal usage and some basic self-tests.
PC Reader
The PC Reader utility performs no dynamic memory allocations.
It makes use of the assert and memcmp standard library functions.
If a user of the library wishes to disable asserts or provide an alternative memcmp
implementation this can be done by setting the VKSC_ASSERT and VKSC_MEMCMP
macros before including pcreader.hpp.
PC Writer
The PC Writer utility performs dynamic memory allocations using the standard new
and delete array operators.
It also makes use of the assert and memcpy standard library functions.
If a user of the library wishes to disable asserts or provide an alternative memcpy
implementation this can be done by setting the VKSC_ASSERT and VKSC_MEMCPY
macros before including pcwriter.hpp.