// MobileGL - MobileGL/MG_Backend/DirectVulkan/Renderer/SwapchainObject.h // Copyright (c) 2025-2026 MobileGL-Dev // Licensed under the GNU Lesser General Public License v3.0: // https://www.gnu.org/licenses/gpl-3.0.txt // https://www.gnu.org/licenses/lgpl-3.0.txt // SPDX-License-Identifier: LGPL-3.0-only // End of Source File Header #pragma once #include #include #include "../VkIncludes.h" namespace MobileGL::MG_Backend::DirectVulkan { class SwapchainObject { public: struct SwapchainCapabilities { VkSurfaceCapabilitiesKHR capabilities; Vector surfaceFormats; Vector presentModes; Bool IsComplete() const { return !surfaceFormats.empty() && !presentModes.empty(); } }; static SwapchainCapabilities GetSwapchainCapabilities(VkPhysicalDevice physicalDevice, VkSurfaceKHR surface); static VkSurfaceFormatKHR ChooseSwapchainSurfaceFormat(const Vector& availableFormats); // swapInterval is the app's eglSwapInterval, empty until it asks (s_desiredPresentModes // ranks the modes then). 0 wants IMMEDIATE, else MAILBOX, else FIFO; >= 1 wants FIFO, // which cannot skip vblanks, so 2 and up pace like 1; a negative interval (adaptive // vsync) wants FIFO_RELAXED, else FIFO. static VkPresentModeKHR ChooseSwapchainPresentMode(const Vector& availablePresentModes, Optional swapInterval = Nullopt); static const char* GetPresentModeName(VkPresentModeKHR presentMode); void Create(VkDevice device, VkPhysicalDevice physicalDevice, VkSurfaceKHR surface, Uint32 graphicsQueueFamily, Uint32 presentQueueFamily, Uint32 minImageCountHint, Uint32 extraImageCount, VkExtent2D desiredExtent, Optional swapInterval); void Shutdown(VkDevice device); // Tells the frontend (or, under a transport, the client) the default framebuffer's size // and formats. Create does this; a renderer switching between surfaces repeats it. void PublishDefaultFramebufferInfo() const; VkSwapchainKHR GetHandle() const { return m_swapchain; } VkPresentModeKHR GetPresentMode() const { return m_presentMode; } // The surface's present modes as queried when this swapchain was created. const Vector& GetSupportedPresentModes() const { return m_supportedPresentModes; } const VkSurfaceFormatKHR& GetSurfaceFormat() const { return m_surfaceFormat; } VkExtent2D GetExtent() const { return m_extent; } // Surface-space extent (before the pre-rotation quarter-turn swap) this swapchain was // created from - the value to compare a freshly queried currentExtent against. VkExtent2D GetSurfaceExtent() const { return m_surfaceExtent; } VkSurfaceTransformFlagBitsKHR GetPreTransform() const { return m_preTransform; } const Vector& GetImages() const { return m_images; } const Vector& GetImageViews() const { return m_imageViews; } VkFormat GetDepthStencilFormat() const { return m_depthStencilFormat; } const Vector& GetDepthStencilImageViews() const { return m_depthStencilImageViews; } VkImage GetDepthStencilImage(Uint32 index) const; VkImageView GetDepthStencilImageView(Uint32 index) const; VkImageLayout GetDepthStencilImageLayout(Uint32 index) const; void SetDepthStencilImageLayout(Uint32 index, VkImageLayout layout); VkImage GetImage(Uint32 index) const; VkImageLayout GetImageLayout(Uint32 index) const; void SetImageLayout(Uint32 index, VkImageLayout layout); SizeT GetImageCount() const { return m_images.size(); } // EGL content-validity tracking for the default framebuffer. A color // buffer's content is undefined once its image has been presented // (EGL_BUFFER_DESTROYED swap behaviour, the implementation default), // and every ancillary (depth/stencil) buffer's content is undefined // after ANY swap regardless of swap behaviour (EGL 1.5 ยง3.10.1). The // render-pass manager turns an undefined attachment's tile load into // LOAD_OP_DONT_CARE. Flags start false (a fresh swapchain image holds // garbage) and a render pass storing into an attachment sets it back // to defined. Bool IsImageContentDefined(Uint32 index) const; void SetImageContentDefined(Uint32 index, Bool defined); Bool IsDepthStencilContentDefined(Uint32 index) const; void SetDepthStencilContentDefined(Uint32 index, Bool defined); void SetAllDepthStencilContentUndefined(); // EGL_EXT_buffer_age over this chain's images. Ages start unknown with the chain (Create). // Until a client asks for an age (NoteBufferAgeAsked) a presented image's content is // treated as undefined, as before; once one has, a presented image keeps it - its age is // counted and its content stays defined, so the next frame loads it. void NoteBufferAgeAsked() { m_bufferAgeAsked = true; } Bool BufferAgeAsked() const { return m_bufferAgeAsked; } Int32 BufferAgeOf(Uint32 index) const { return m_ages.AgeOf(index); } // Image `index` was presented. void OnImagePresented(Uint32 index) { m_ages.OnPresented(index, m_bufferAgeAsked); } // A swapped frame reached no image: every age is unknown. void OnFrameDropped() { m_ages.OnFrameDropped(); } private: void CreateImageViews(VkDevice device); void CreateDepthStencilResources(VkDevice device, VkPhysicalDevice physicalDevice); void DestroyDepthStencilResources(VkDevice device); static constexpr VkPresentModeKHR s_desiredPresentModes[] { VK_PRESENT_MODE_MAILBOX_KHR, VK_PRESENT_MODE_IMMEDIATE_KHR, VK_PRESENT_MODE_FIFO_RELAXED_KHR, VK_PRESENT_MODE_FIFO_KHR }; VkSwapchainKHR m_swapchain = VK_NULL_HANDLE; VkPresentModeKHR m_presentMode = VK_PRESENT_MODE_FIFO_KHR; Vector m_supportedPresentModes; VkSurfaceFormatKHR m_surfaceFormat{}; VkExtent2D m_extent{}; VkExtent2D m_surfaceExtent{}; VkSurfaceTransformFlagBitsKHR m_preTransform = VK_SURFACE_TRANSFORM_IDENTITY_BIT_KHR; Vector m_images; Vector m_imageViews; Vector m_imageLayouts; VkFormat m_depthStencilFormat = VK_FORMAT_UNDEFINED; Vector m_depthStencilImages; Vector m_depthStencilImageMemories; Vector m_depthStencilImageViews; Vector m_depthStencilImageLayouts; Vector m_imageContentDefined; Vector m_depthStencilContentDefined; MG_Util::Damage::SwapchainAgeTracker m_ages; // Kept across a rebuild: it is the application's habit, not the chain's. Bool m_bufferAgeAsked = false; }; } // namespace MobileGL::MG_Backend::DirectVulkan