Cauldron
A simple framework for rapid prototyping on Vulkan or DirectX12.
Cauldron was developed by AMD and is used internally to develop prototypes, demos and SDK samples.
Cauldron is compiled as a static library. To see it in action check projects below.
Projects that feature Cauldron
- FidelityFX-SPD Single Pass Downsampler (SPD)
- FidelityFX-SSSR Stochastic Screen Space Reflections (SSSR)
- FidelityFX-LPM Luma Preserving Mapper (LPM)
- FidelityFX-CACAO Combined Adaptive Compute Ambient Occlusion (CACAO)
- FidelityFX-VariableShading Variable Rate Shading (VRS)
- FidelityFX-ParallelSort GPU-based optimised sorting
- FidelityFX-CAS Contrast Adaptive Sharpenening (CAS)
- FidelityFX-FSR Super Resolution (FSR)
- FidelityFX-FSR2 Super Resolution 2.0 (FSR2)
- TressFX, a library that simulates and renders realistic hair and fur
- glTFSample, a simple demo app to show off Cauldron's features
Cauldron Features
- glTF 2.0 File loader
- Animation for cameras, objects, skeletons and lights
- Skinning
- Baking skinning into buffers (DX12 only)
- PBR Materials
- Metallic-Roughness
- Specular-Glossiness (
KHR_materials_pbrSpecularGlossiness)
- Lighting
- KHR_lights_punctual extension
- Point
- Directional
- Spot Lights w/ Shadows (up to 4)
- Image-based Lighting (IBL) CubeMaps
- KHR_lights_punctual extension
- Shadow techniques
- shadow maps (PCF)
- shadow masks (DX12 only)
- Configurable GBuffer, supported techniques:
- Full forward
- Motion vectors
- Normals
- Depth
- Specular-roughness
- Diffuse-alpha
- Postprocessing
- TAA
- Bloom
- HDR/Tonemapping
- Texture Loaders for DDS (including the BCn formats), JPEG and PNG formats
- MIP Map generation for powers-of-two textures
- In-app user interface using Dear ImGui
- Rendering Resource Management
- Command Buffer Ring
- Timestamp Queries
- Memory Heap Manager (Linear Allocator)
- Static buffers for VB/IB/CB with suballocation support
- Dynamic buffers for VB/IB/CB using a ring buffer
- Debug Rendering
- Wireframe Bounding Boxes
- Light Frustums
- Window management & swapchain creation
- Fullscreen/Windowed Modes
- Support for DXC/SM6.x
- Shader Binary & PSO caching
- FreeSync
™️ 2 HDR support - Multithreading loading & creation of resources
- Textures & MIP map generation
- Shader compilation
- Pipeline creation
- VK extensions can be enabled from the app side
- Benchmarking
Directory Structure
build: Build scripts & generated solution files/folderslibs: LibrariesAGS: AMD helper library for querying GPU infoVulkanMemoryAllocator: Helper library for memory management with Vulkan applicationsd3d12x: The D3D12 helper librarydxc: DirectX Shader Compilerimgui: Graphical User Interface libraryjson: Library for adding JSON support w/ C++ syntaxstb:stb_image.handstb_image_write.hfrom stb
media: Builtin textures and other datasrc: Source code files
Note: more info on the rendering backends can be found in the Readme of their respective folders.
Build
Prerequisites
How-to-Build
- Run the
GenerateSolutions.batfile in thebuilddirectory. build/VKandbuild/DX12folders will contain theCauldron_*.slnfiles- Simply build the solution file for the desired API
build/DX12/src/DX12/directory will contain the compiled static libraryFramework_DX12.libfor DX12 (similar for VK) under the selected configuration (Debug/Release) folder.
Framework Architecture
Every feature in Cauldron has been implemented in a single file using C++11.
The main features could be grouped in 4 categories:
- Resource managers & loaders
- Texture loaders - can load
DDS,PNG,JPGand any other file supported by the WIC subsystem. It can also create image views. - StaticBufferPool - holds vertices and indices for static geometry. It creates a huge buffer and then suballocates chunks from it in a linear fashion. Chunks cannot be freed.
- DynamicBufferRing - holds constant buffers and also vertices and indices. Same as before but allocation happens in a ring fashion.
- ResourceViewHeaps - holds the Descriptor Sets.
- UploadHeap - system memory buffer that holds the texture data to be uploaded to video memory via DMA
- CommandListRing - allocates a number of command buffers from a ring buffer and returns a ready-to-use command buffer.
- Device - all the device related code.
- Texture loaders - can load
- Renderers
- GLTF* - loads and renders the model using a certain technique
- PostProcPS/PS - draws a 2D quad using a custom shader, used by the post processing passes.
- ImGUI - code for driving the ImGUI
- Widgets
- Wireframe - draws a wireframe cube (used for rendering bounding boxes and light/camera frustums)
- Axis - draws the coordinate axis of a matrix
- Vulkan specific helpers & setup code
- InstanceVK - creates an instance and enables the validation layer
- Extension helpers
- ExtDebugMarkers - sets up the debug markers
- ExtFp16 - enables FP16 extension
- ExtFreeSync2 - enables FreeSync extension
- ExtValidation - enables the validation layer
- Commons & OS-specific code
- Swapchain - handles resizing, fullscreen/windowed modes, etc.
- FrameworkWindows - creates a window, processes windows message pump
Cauldron was originally written using DX12 and later on ported to Vulkan using the same structure. This would make Cauldron ideal for learning Vulkan if you're coming from DirectX12, or vice versa.
Known Issues
Please bear in mind that in order to keep Cauldron simple we are only covering the most frequently used features (for now).
Please feel free to open an issue for bug reports.
Contribution
Cauldron should be very easy to extend, should you want to contribute to Cauldron, you can open a pull request.