RhiComputeBarrier.hpp

#pragma once
#include <score_plugin_gfx_export.h>
class QRhi;
class QRhiBuffer;
class QRhiCommandBuffer;
class QRhiShaderResourceBindings;
 
namespace score::gfx
{
SCORE_PLUGIN_GFX_EXPORT
bool dispatchComputeLayeredImages(
    QRhi& rhi, QRhiCommandBuffer& cb, QRhiShaderResourceBindings& srb,
    int x, int y, int z);
 
SCORE_PLUGIN_GFX_EXPORT
void insertComputeBarrier(QRhi& rhi, QRhiCommandBuffer& cb);
 
// Controls whether the copy helpers emit their own pre/post pipeline
// barriers. Default: Auto (each call emits a {compute,transfer}→transfer +
// transfer→compute pair). Use `None` when you are batching N calls
// inside explicit beginBufferCopyBarrier / endBufferCopyBarrier brackets
// to avoid N−1 redundant pipeline stalls. `None` with no surrounding
// bracket emits NO synchronisation at all — correct only when the caller
// knows nothing else in the frame touches the range.
enum class BufferCopyBarrier
{
  Auto,
  None
};
 
SCORE_PLUGIN_GFX_EXPORT
void beginBufferCopyBarrier(QRhi& rhi, QRhiCommandBuffer& cb);
 
SCORE_PLUGIN_GFX_EXPORT
void endBufferCopyBarrier(QRhi& rhi, QRhiCommandBuffer& cb);
 
SCORE_PLUGIN_GFX_EXPORT
void copyBuffer(
    QRhi& rhi, QRhiCommandBuffer& cb,
    QRhiBuffer* src, QRhiBuffer* dst, int size,
    int srcOffset = 0, int dstOffset = 0,
    BufferCopyBarrier barrier = BufferCopyBarrier::Auto);
 
// Metal-specific implementation (defined in RhiBufferCopyMetal.mm)
void copyBufferMetal(
    QRhi& rhi, QRhiCommandBuffer& cb,
    QRhiBuffer* src, QRhiBuffer* dst, int size,
    int srcOffset = 0, int dstOffset = 0);
 
struct BufferCopyRegion
{
  int src_offset{};
  int dst_offset{};
  int size{};
};
SCORE_PLUGIN_GFX_EXPORT
void copyBufferRegions(
    QRhi& rhi, QRhiCommandBuffer& cb,
    QRhiBuffer* src, QRhiBuffer* dst,
    const BufferCopyRegion* regions, int count,
    BufferCopyBarrier barrier = BufferCopyBarrier::Auto);
 
// Metal-specific implementation
void copyBufferRegionsMetal(
    QRhi& rhi, QRhiCommandBuffer& cb,
    QRhiBuffer* src, QRhiBuffer* dst,
    const BufferCopyRegion* regions, int count);
}