graphics_stage_lifecycle_internal.h

#pragma once
 
#include "pixelbullet/graphics/render_stage.h"
#include "pixelbullet/graphics/render_target.h"
 
#include <glm/glm.hpp>
#include <volk.h>
 
#include <optional>
#include <string>
#include <string_view>
#include <vector>
 
namespace pixelbullet::graphics_stage_internal
{
struct RenderTargetLifecyclePlan
{
    glm::uvec2 desired_extent{ 0u, 0u };
    uint32_t desired_image_count = 0u;
    bool clear_images = false;
    bool rebuild_images = false;
};
 
glm::uvec2 ResolveRenderTargetExtent(const RenderTargetSpecification& specification, const glm::uvec2& base_extent) noexcept;
RenderTargetLifecyclePlan BuildRenderTargetLifecyclePlan(const RenderTargetSpecification& specification, const glm::uvec2& current_extent,
                                                         uint32_t current_image_count, uint32_t requested_image_count,
                                                         const glm::uvec2& base_extent) noexcept;
uint32_t NormalizeRenderTargetActiveImageIndex(uint32_t requested_active_image_index, uint32_t image_count) noexcept;
 
bool IsDeclaredRenderTargetName(std::string_view name, const std::vector<RenderTargetSpecification>& declared_targets) noexcept;
std::vector<std::string> CollectUndeclaredRenderTargetNames(const std::vector<std::string>& existing_names,
                                                            const std::vector<RenderTargetSpecification>& declared_targets);
 
std::optional<std::string_view> FindFirstRenderTargetAttachmentName(const RenderStage& render_stage) noexcept;
glm::uvec2 ResolveRenderStageViewportExtent(const Viewport& viewport, bool has_render_target_attachment,
                                            const std::optional<glm::uvec2>& render_target_extent,
                                            const glm::uvec2& window_extent) noexcept;
bool IsRenderStageOutOfDate(const glm::uvec2& last_extent, const glm::ivec2& last_offset, const glm::uvec2& next_extent,
                            const glm::ivec2& next_offset) noexcept;
const VkFramebuffer& SelectActiveFramebuffer(const std::vector<VkFramebuffer>& framebuffers, uint32_t active_swapchain_image);
} // namespace pixelbullet::graphics_stage_internal