Modulevulkan-utils-0.5.11.0Haskell2010

Vulkan.Utils.VulkanContext

Application-static Vulkan handles plus the recycle channel ends used by the recycling Frame machinery.

Constructed once at boot, never modified. Sub-systems (swapchain, frame loop, window loop) accept a VulkanContext so they don't need their own copies of device/queues plumbing.

2 types
1 value

Packagevulkan-utils-0.5.11.0
Exports3
LanguageHaskell2010
LicenceBSD-3-Clause
SourceVulkanContext.hs

datadata VulkanContext rr

A bunch of long-lived handles that the application carries around. The recycle channel ends carry per-frame RecycledResources between the frame loop and the wait-and-recycle thread.

Constructors

VulkanContext
- vcInstance :: Instance
- vcPhysicalDevice :: PhysicalDevice
- vcDevice :: Device
- vcQueues :: Queues (QueueFamilyIndex, Queue)
- vcRecycleBin :: RecycledResources rr -> IO ()
  Drop a frame's reusable bits back into the pool. Called from the per-frame wait thread once the GPU is done with the frame.
- vcRecycleNib :: IO (Either (IO (RecycledResources rr)) (RecycledResources rr))
  Pull a frame's reusable bits out. Right if available immediately; Left is a blocking read.

datadata RecycledResources a

The bits of state recycled between frames: a binary image-available semaphore (signalled by image acquisition, waited on by the frame's submit) and the command pool the frame's commands are recorded into.

The render-finished present-wait semaphore is not/ here — it is per swapchain image (see sRenderFinished), because a present-wait semaphore is only safe to reuse once its image is re-acquired, not when the frame's render completes.

Constructors

RecycledResources
- rrImageAvailable :: Semaphore
- rrCommandPools :: Queues CommandPool
  One command pool per queue role, reset when the frame retires. Roles sharing a queue family share the pool handle, so a frame holds one pool per distinct family — pools are expensive to create and cheap to reset, which is the whole point of recycling them.
- rrData :: a
  Double-buffered data of the application to ping-pong around updating and rendering.

valuemkVulkanContext

Assemble a VulkanContext from already-constructed handles. Builds the recycle channel internally; the channel starts empty and is populated by initialFrame.