gui_rhi.h

Go to the documentation of this file.

#pragma once
 
// Thin render-hardware-interface for the GUI primitive renderer - deliberately
// minimal: pipeline creation from a PrimitiveSpec, transient batch upload to
// fence-protected storage, and draw. Textures, samplers, descriptor
// sets, render passes and the swapchain are NOT part of this interface; they
// stay behind GraphicsContext / the backend's window context. A second backend
// implements these two classes (plus GraphicsContext) and compiles the shader
// pairs named by kPrimitiveSpecs to its own format.
 
#include <gui_core/graphics/gui_render_primitives.h>
 
#include <span>
 
namespace tachyon::RHI
{
 
    struct GpuPipeline
    {
        uint64_t pipeline = 0;          
        uint64_t layout   = 0;          
        bool IsValid() const { return pipeline != 0; }
    };
 
    struct UploadRequest
    {
        const void* data      = nullptr;
        size_t      bytes     = 0;
        size_t      alignment = 16;
    };

    using ResidentBufferId = uint64_t;

    enum class ResidentState : uint8_t
    {
        Gone,    
        Pending, 
        Ready,   
    };

    class RenderDevice
    {
    public:
        virtual ~RenderDevice() = default;

        virtual GpuPipeline CreatePrimitivePipeline(const PrimitiveSpec& spec) = 0;
 
    };

    class RenderCommandList
    {
    public:
        virtual ~RenderCommandList() = default;

        virtual void DrawPrimitives(const GpuPipeline& pipeline,
                                    const GPUDrawPushConstants& pushConstants,
                                    uint32_t primitiveCount, uint32_t firstPrimitive, PrimitiveShape shape) = 0;

        virtual void UploadTransientBuffers(std::span<const UploadRequest> requests,
                                            std::span<DeviceAddress> addresses) = 0;

        virtual ResidentBufferId UploadResidentBuffers(std::span<const UploadRequest> requests,
                                                       std::span<DeviceAddress> addresses) = 0;
        virtual ResidentState ResidentBufferState(ResidentBufferId id) const = 0;
        virtual void ReleaseResidentBuffer(ResidentBufferId id) = 0;
    };

}