Crafter.Graphics/interfaces/Crafter.Graphics-ComputeShader.cppm

/*
Crafter®.Graphics
Copyright (C) 2026 Catcrafts®
catcrafts.net

This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License version 3.0 as published by the Free Software Foundation;

This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301 USA
*/
module;
#ifndef CRAFTER_GRAPHICS_WINDOW_DOM
#include "vulkan/vulkan.h"
#endif // !CRAFTER_GRAPHICS_WINDOW_DOM
export module Crafter.Graphics:ComputeShader;
#ifndef CRAFTER_GRAPHICS_WINDOW_DOM
import std;
import :Device;

export namespace Crafter {
    // Tier 1: thin compute-pipeline wrapper. Owns one VkPipeline created with
    // VK_PIPELINE_CREATE_2_DESCRIPTOR_HEAP_BIT_EXT (no pipeline layout — the
    // bindless heap supplies all bindings, push constants travel via
    // vkCmdPushDataEXT). Use this to dispatch the four standard UI shaders
    // and any user-authored compute shader that follows the ui-shared.glsl
    // contract.
    class ComputeShader {
    public:
        VkPipeline pipeline = VK_NULL_HANDLE;

        ComputeShader() = default;
        ComputeShader(const ComputeShader&) = delete;
        ComputeShader& operator=(const ComputeShader&) = delete;
        ComputeShader(ComputeShader&& other) noexcept;
        ComputeShader& operator=(ComputeShader&& other) noexcept;
        ~ComputeShader();

        // Loads a SPIR-V compute shader from disk and creates a pipeline that
        // uses the bindless descriptor-heap binding model.
        void Load(const std::filesystem::path& spvPath);

        // Bind, push constants (if any), dispatch. Caller computes group counts
        // and is responsible for any inter-dispatch barriers (UIRenderer::Dispatch
        // wraps this with the standard write-after-write barrier).
        void Dispatch(VkCommandBuffer cmd,
                      const void* push, std::uint32_t pushBytes,
                      std::uint32_t gx,
                      std::uint32_t gy = 1,
                      std::uint32_t gz = 1) const;
    };
}
#endif // !CRAFTER_GRAPHICS_WINDOW_DOM