Documentation

Fields

• sSwapchain :: SwapchainKHR
   
• sSurface :: SurfaceKHR
   
• sFormat :: SurfaceFormatKHR
   
• sExtent :: Extent2D
   
• sPresentMode :: PresentModeKHR
   
• sImages :: Vector Image
   
• sImageViews :: Vector ImageView
   
• sRenderFinished :: Vector Semaphore

  Per-image present-wait binary semaphore, indexed by the acquired image index (length == length sImages). A frame's submit signals sRenderFinished ! imageIndex and the present waits on it; reusing it is safe only once that image is re-acquired, which is why it lives here (per image) rather than in the per-frame RecycledResources. Freed by sRelease.

• sRelease :: RefCounted

  Held until no in-flight frame still uses this swapchain.

• sConfig :: SwapchainConfig

  Retained so recreateSwapchain can re-apply the same knobs.

Fields

• scRequiredUsageFlags :: [ImageUsageFlagBits]

  Image usages every swapchain image must support. Default: [IMAGE_USAGE_COLOR_ATTACHMENT_BIT]. Compute-shader callers add IMAGE_USAGE_STORAGE_BIT.

• scRequiredFormatFeatures :: [FormatFeatureFlagBits]

  Format-feature flags the chosen surface format's optimal tiling must satisfy. Default: []. Set FORMAT_FEATURE_STORAGE_IMAGE_BIT if using IMAGE_USAGE_STORAGE_BIT — SRGB formats typically omit it.

• scDesiredPresentModes :: [PresentModeKHR]

  Present-mode preference, best first. Default: [FIFO_RELAXED, FIFO]. The driver-guaranteed FIFO is the safe fallback. Add IMMEDIATE or MAILBOX if your scheduler can tolerate them.

• scSurfaceFormatPreferences :: [SurfaceFormatKHR -> Bool]

  Surface-format preference predicates, best first. For each predicate in order, the first format that matches both the predicate AND the feature requirements wins. If no preference matches, falls back to the first feature-satisfying format, then to the head. Default: [].