VulkanSequence.h

浏览该文件的文档.

#pragma once
 
#include "gpgpu/Sequence.h"
#include "vkbuilder.hpp"
 
#include <cstdint>
#include <vector>
 
namespace eve::graphics::vulkan {
class Graphics;
}
 
namespace eve::gpgpu {
 
class ComputeShader;
class GpuBuffer;
 
struct VulkanSequence {
    graphics::vulkan::Graphics *vkg = nullptr;
    vk::Queue queue{};
    vk::CommandPool pool{};
 
    // Host-visible staging buffers for recordUpload(); reused across cycles
    // after the previous submission has completed.
    // A buffer is only reused when its capacity fits, so recorded copies never
    // reference a buffer that is destroyed mid-record.
    std::vector<vkb::GenericBuffer> stagingPool;
    size_t stagingUsed = 0;
 
    vk::Fence fence = nullptr;
    bool fenceReady = false;
 
    vk::CommandBuffer commandBuffer{};
    vk::CommandBuffer            submittedCommandBuffer{};
    bool recording = false;
    SequenceStatus               status    = SequenceStatus::Idle;
    std::vector<ComputeShader *> usedShaders;  // dispatched during this cycle
 
    bool ready() const;
 
    void ensureReady();
    void ensureCommandBuffer();
    void destroy();
};
 
VulkanSequence *vulkanSequenceCreate();
void vulkanSequenceBegin(VulkanSequence *seq);
void vulkanSequenceRecordUpload(VulkanSequence *seq, GpuBuffer *dst,
                                const void *src, uint64_t nbytes,
                                uint64_t dstOffset);
void vulkanSequenceRecordDownload(VulkanSequence *seq, GpuBuffer *src,
                                  GpuBuffer *staging, uint64_t nbytes,
                                  uint64_t srcOffset);
void vulkanSequenceRecordDispatch(VulkanSequence *seq, ComputeShader *shader,
                                  int groupsX, int groupsY, int groupsZ);
void vulkanSequenceSubmit(VulkanSequence *seq);
SequenceStatus  vulkanSequenceSubmitAsync(VulkanSequence *seq);
SequenceStatus  vulkanSequencePoll(VulkanSequence *seq);
SequenceStatus  vulkanSequenceWait(VulkanSequence *seq);
SequenceStatus  vulkanSequenceStatus(const VulkanSequence *seq);
void vulkanSequenceDestroy(VulkanSequence *seq);
 
}  // namespace eve::gpgpu