namespace AcDream.App;

/// <summary>
/// Campaign V slice V5: which rendering backend the graphical host starts.
///
/// OpenGL is the default and, through slice V9, the only backend that renders
/// the game. <see cref="Vulkan"/> is dark bring-up — it creates an instance, a
/// device, a swapchain and runs the capability gate, and nothing more, until the
/// Vulkan RHI backend lands at V6.
///
/// This enum is public only because <see cref="RuntimeOptions"/> is public and
/// exposes it as a property. The backend-neutral
/// <c>AcDream.App.Rendering.Gpu.GpuBackendKind</c> stays internal and describes a
/// live device rather than a startup request; the two are deliberately separate
/// because a Vulkan-requested process can still fail its capability gate and
/// never own a Vulkan device at all.
/// </summary>
public enum RenderBackendKind
{
    /// <summary>OpenGL 4.3 core + bindless + MDI. The default, and the only live backend.</summary>
    Gl,

    /// <summary>Vulkan 1.3 core. Dark until Campaign V slice V10 flips the default.</summary>
    Vulkan,
}