Code/Engine/RendererVulkan/Utils/Implementation/ConversionUtilsVulkan.inl.h - dev - redgpu/ezEngine

Code/Engine/RendererVulkan/Utils/Implementation/ConversionUtilsVulkan.inl.h
373 строки13 KB
Sanakan8472
Render Graph (#1948)
03 июн 2026, 10:19
03 июн 2026, 10:1960bb12c
#include <RendererFoundation/Resources/ResourceFormats.h>
#include <RendererVulkan/Utils/ConversionUtilsVulkan.h>

EZ_ALWAYS_INLINE vk::AttachmentLoadOp ezConversionUtilsVulkan::GetAttachmentLoadOp(ezEnum<ezGALRenderTargetLoadOp> op)
{
  switch (op)
  {
    case ezGALRenderTargetLoadOp::Load:
      return vk::AttachmentLoadOp::eLoad;
    case ezGALRenderTargetLoadOp::Clear:
      return vk::AttachmentLoadOp::eClear;
    case ezGALRenderTargetLoadOp::DontCare:
      return vk::AttachmentLoadOp::eDontCare;
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::AttachmentLoadOp::eLoad;
  }
}

EZ_ALWAYS_INLINE vk::AttachmentStoreOp ezConversionUtilsVulkan::GetAttachmentStoreOp(ezEnum<ezGALRenderTargetStoreOp> op)
{
  switch (op)
  {
    case ezGALRenderTargetStoreOp::Store:
      return vk::AttachmentStoreOp::eStore;
    case ezGALRenderTargetStoreOp::Discard:
      return vk::AttachmentStoreOp::eDontCare;
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::AttachmentStoreOp::eStore;
  }
}

EZ_ALWAYS_INLINE vk::VertexInputRate ezConversionUtilsVulkan::GetVertexBindingRate(ezEnum<ezGALVertexBindingRate> rate)
{
  switch (rate)
  {
    case ezGALVertexBindingRate::Vertex:
      return vk::VertexInputRate::eVertex;
    case ezGALVertexBindingRate::Instance:
      return vk::VertexInputRate::eInstance;
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::VertexInputRate::eVertex;
  }
}

EZ_ALWAYS_INLINE vk::SampleCountFlagBits ezConversionUtilsVulkan::GetSamples(ezEnum<ezGALMSAASampleCount> samples)
{
  switch (samples)
  {
    case ezGALMSAASampleCount::None:
      return vk::SampleCountFlagBits::e1;
    case ezGALMSAASampleCount::TwoSamples:
      return vk::SampleCountFlagBits::e2;
    case ezGALMSAASampleCount::FourSamples:
      return vk::SampleCountFlagBits::e4;
    case ezGALMSAASampleCount::EightSamples:
      return vk::SampleCountFlagBits::e8;
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::SampleCountFlagBits::e1;
  }
}

EZ_ALWAYS_INLINE vk::PresentModeKHR ezConversionUtilsVulkan::GetPresentMode(ezEnum<ezGALPresentMode> presentMode, const ezDynamicArray<vk::PresentModeKHR>& supportedModes)
{
  switch (presentMode)
  {
    case ezGALPresentMode::Immediate:
    {
      if (supportedModes.Contains(vk::PresentModeKHR::eImmediate))
        return vk::PresentModeKHR::eImmediate;
      else if (supportedModes.Contains(vk::PresentModeKHR::eMailbox))
        return vk::PresentModeKHR::eMailbox;
      else
        return vk::PresentModeKHR::eFifo;
    }
    case ezGALPresentMode::VSync:
      return vk::PresentModeKHR::eFifo; // FIFO must be supported according to the standard.
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::PresentModeKHR::eFifo;
  }
}

EZ_FORCE_INLINE vk::ImageSubresourceRange ezConversionUtilsVulkan::GetSubresourceRange(const ezGALTextureCreationDescription& texDesc, const ezGALRenderTargetViewCreationDescription& viewDesc)
{
  vk::ImageSubresourceRange range;
  ezGALResourceFormat::Enum viewFormat = viewDesc.m_OverrideViewFormat == ezGALResourceFormat::Invalid ? texDesc.m_Format : viewDesc.m_OverrideViewFormat;
  range.aspectMask = ezGALResourceFormat::IsDepthFormat(viewFormat) ? vk::ImageAspectFlagBits::eDepth : vk::ImageAspectFlagBits::eColor;
  range.setBaseMipLevel(viewDesc.m_uiMipLevel).setLevelCount(1).setBaseArrayLayer(viewDesc.m_uiFirstSlice).setLayerCount(viewDesc.m_uiSliceCount);
  return range;
}

EZ_ALWAYS_INLINE vk::ImageSubresourceRange ezConversionUtilsVulkan::GetSubresourceRange(
  const vk::ImageSubresourceLayers& layers)
{
  vk::ImageSubresourceRange range;
  range.aspectMask = layers.aspectMask;
  range.baseMipLevel = layers.mipLevel;
  range.levelCount = 1;
  range.baseArrayLayer = layers.baseArrayLayer;
  range.layerCount = layers.layerCount;
  return range;
}

EZ_ALWAYS_INLINE vk::ImageSubresourceRange ezConversionUtilsVulkan::GetSubresourceRange(ezGALResourceFormat::Enum format, ezGALTextureRange textureRange)
{
  vk::ImageSubresourceRange range;
  range.aspectMask = ezGALResourceFormat::IsDepthFormat(format) ? vk::ImageAspectFlagBits::eDepth : vk::ImageAspectFlagBits::eColor;
  if (format == ezGALResourceFormat::D24S8)
  {
    range.aspectMask |= vk::ImageAspectFlagBits::eStencil;
  }
  range.baseMipLevel = textureRange.m_uiBaseMipLevel;
  range.levelCount = textureRange.m_uiMipLevels;
  range.baseArrayLayer = textureRange.m_uiBaseArraySlice;
  range.layerCount = textureRange.m_uiArraySlices;
  return range;
}

EZ_ALWAYS_INLINE vk::ImageViewType ezConversionUtilsVulkan::GetImageViewType(ezEnum<ezGALTextureType> texType)
{
  switch (texType)
  {
    case ezGALTextureType::Texture2D:
    case ezGALTextureType::Texture2DShared:
    case ezGALTextureType::Texture2DProxy:
      return vk::ImageViewType::e2D;

    case ezGALTextureType::Texture2DArray:
      return vk::ImageViewType::e2DArray;

    case ezGALTextureType::TextureCube:
      return vk::ImageViewType::eCube;

    case ezGALTextureType::TextureCubeArray:
      return vk::ImageViewType::eCubeArray;

    case ezGALTextureType::Texture3D:
      return vk::ImageViewType::e3D;

    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::ImageViewType::e1D;
  }
}

EZ_ALWAYS_INLINE vk::ImageViewType ezConversionUtilsVulkan::GetImageViewType(ezEnum<ezGALShaderTextureType> texType)
{
  switch (texType)
  {
    case ezGALShaderTextureType::Texture2D:
    case ezGALShaderTextureType::Texture2DMS:
      return vk::ImageViewType::e2D;
    case ezGALShaderTextureType::Texture2DArray:
    case ezGALShaderTextureType::Texture2DMSArray:
      return vk::ImageViewType::e2DArray;
    case ezGALShaderTextureType::Texture3D:
      return vk::ImageViewType::e3D;
    case ezGALShaderTextureType::TextureCube:
      return vk::ImageViewType::eCube;
    case ezGALShaderTextureType::TextureCubeArray:
      return vk::ImageViewType::eCubeArray;
    case ezGALShaderTextureType::Texture1D:
    case ezGALShaderTextureType::Texture1DArray:
    case ezGALShaderTextureType::Unknown:
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::ImageViewType::e1D;
  }
}

EZ_ALWAYS_INLINE vk::ImageViewType ezConversionUtilsVulkan::GetImageArrayViewType(ezEnum<ezGALTextureType> texType)
{
  switch (texType)
  {
    case ezGALTextureType::Texture2D:
    case ezGALTextureType::Texture2DArray:
    case ezGALTextureType::Texture2DProxy:
      return vk::ImageViewType::e2DArray;

    case ezGALTextureType::TextureCube:
    case ezGALTextureType::TextureCubeArray:
      return vk::ImageViewType::eCubeArray;

    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::ImageViewType::e1D;
  }
}

EZ_ALWAYS_INLINE bool ezConversionUtilsVulkan::IsDepthFormat(vk::Format format)
{
  switch (format)
  {
    case vk::Format::eD16Unorm:
    case vk::Format::eD32Sfloat:
    case vk::Format::eD16UnormS8Uint:
    case vk::Format::eD24UnormS8Uint:
    case vk::Format::eD32SfloatS8Uint:
      return true;
    default:
      return false;
  }
}

EZ_ALWAYS_INLINE bool ezConversionUtilsVulkan::IsStencilFormat(vk::Format format)
{
  switch (format)
  {
    case vk::Format::eS8Uint:
    case vk::Format::eD16UnormS8Uint:
    case vk::Format::eD24UnormS8Uint:
    case vk::Format::eD32SfloatS8Uint:
      return true;
    default:
      return false;
  }
}

EZ_ALWAYS_INLINE vk::ImageLayout ezConversionUtilsVulkan::GetTextureReadLayout(vk::Format format)
{
  return IsDepthFormat(format) ? vk::ImageLayout::eDepthStencilReadOnlyOptimal : vk::ImageLayout::eShaderReadOnlyOptimal;
}

EZ_ALWAYS_INLINE vk::PrimitiveTopology ezConversionUtilsVulkan::GetPrimitiveTopology(ezEnum<ezGALPrimitiveTopology> topology)
{
  switch (topology)
  {
    case ezGALPrimitiveTopology::Points:
      return vk::PrimitiveTopology::ePointList;
    case ezGALPrimitiveTopology::Lines:
      return vk::PrimitiveTopology::eLineList;
    case ezGALPrimitiveTopology::Triangles:
      return vk::PrimitiveTopology::eTriangleList;
    case ezGALPrimitiveTopology::TriangleStrip:
      return vk::PrimitiveTopology::eTriangleStrip;
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      return vk::PrimitiveTopology::ePointList;
  }
}

EZ_ALWAYS_INLINE vk::ShaderStageFlagBits ezConversionUtilsVulkan::GetShaderStage(ezGALShaderStage::Enum stage)
{
  switch (stage)
  {
    case ezGALShaderStage::VertexShader:
      return vk::ShaderStageFlagBits::eVertex;
    case ezGALShaderStage::HullShader:
      return vk::ShaderStageFlagBits::eTessellationControl;
    case ezGALShaderStage::DomainShader:
      return vk::ShaderStageFlagBits::eTessellationEvaluation;
    case ezGALShaderStage::GeometryShader:
      return vk::ShaderStageFlagBits::eGeometry;
    case ezGALShaderStage::PixelShader:
      return vk::ShaderStageFlagBits::eFragment;
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      [[fallthrough]];
    case ezGALShaderStage::ComputeShader:
      return vk::ShaderStageFlagBits::eCompute;
  }
}

EZ_ALWAYS_INLINE vk::PipelineStageFlags ezConversionUtilsVulkan::GetPipelineStage(ezGALShaderStage::Enum stage)
{
  switch (stage)
  {
    case ezGALShaderStage::VertexShader:
      return vk::PipelineStageFlagBits::eVertexShader;
    case ezGALShaderStage::HullShader:
      return vk::PipelineStageFlagBits::eTessellationControlShader;
    case ezGALShaderStage::DomainShader:
      return vk::PipelineStageFlagBits::eTessellationEvaluationShader;
    case ezGALShaderStage::GeometryShader:
      return vk::PipelineStageFlagBits::eGeometryShader;
    case ezGALShaderStage::PixelShader:
      return vk::PipelineStageFlagBits::eFragmentShader;
    default:
      EZ_ASSERT_NOT_IMPLEMENTED;
      [[fallthrough]];
    case ezGALShaderStage::ComputeShader:
      return vk::PipelineStageFlagBits::eComputeShader;
  }
}

EZ_ALWAYS_INLINE vk::PipelineStageFlags ezConversionUtilsVulkan::GetPipelineStage(vk::ShaderStageFlags flags)
{
  vk::PipelineStageFlags res;
  if (flags & vk::ShaderStageFlagBits::eVertex)
    res |= vk::PipelineStageFlagBits::eVertexShader;
  if (flags & vk::ShaderStageFlagBits::eTessellationControl)
    res |= vk::PipelineStageFlagBits::eTessellationControlShader;
  if (flags & vk::ShaderStageFlagBits::eTessellationEvaluation)
    res |= vk::PipelineStageFlagBits::eTessellationEvaluationShader;
  if (flags & vk::ShaderStageFlagBits::eGeometry)
    res |= vk::PipelineStageFlagBits::eGeometryShader;
  if (flags & vk::ShaderStageFlagBits::eFragment)
    res |= vk::PipelineStageFlagBits::eFragmentShader;
  if (flags & vk::ShaderStageFlagBits::eCompute)
    res |= vk::PipelineStageFlagBits::eComputeShader;

  return res;
}

EZ_ALWAYS_INLINE vk::DescriptorType ezConversionUtilsVulkan::GetDescriptorType(ezGALShaderResourceType::Enum type)
{
  switch (type)
  {
    case ezGALShaderResourceType::Unknown:
      EZ_REPORT_FAILURE("Unknown descriptor type");
      break;
    case ezGALShaderResourceType::PushConstants:
      EZ_REPORT_FAILURE("Push constants should never appear as shader resources");
      break;
    case ezGALShaderResourceType::Sampler:
      return vk::DescriptorType::eSampler;
    case ezGALShaderResourceType::ConstantBuffer:
      return vk::DescriptorType::eUniformBufferDynamic;
    case ezGALShaderResourceType::Texture:
      return vk::DescriptorType::eSampledImage;
    case ezGALShaderResourceType::TextureAndSampler:
      return vk::DescriptorType::eCombinedImageSampler;
    case ezGALShaderResourceType::TexelBuffer:
      return vk::DescriptorType::eUniformTexelBuffer;
    case ezGALShaderResourceType::StructuredBuffer:
      return vk::DescriptorType::eStorageBuffer;
    case ezGALShaderResourceType::ByteAddressBuffer:
      return vk::DescriptorType::eStorageBuffer;
    case ezGALShaderResourceType::TextureRW:
      return vk::DescriptorType::eStorageImage;
    case ezGALShaderResourceType::TexelBufferRW:
      return vk::DescriptorType::eStorageTexelBuffer;
    case ezGALShaderResourceType::StructuredBufferRW:
      return vk::DescriptorType::eStorageBuffer;
    case ezGALShaderResourceType::ByteAddressBufferRW:
      return vk::DescriptorType::eStorageBuffer;
    case ezGALShaderResourceType::COUNT:
      EZ_REPORT_FAILURE("COUNT is not a valid resource type");
      break;
  }
  EZ_REPORT_FAILURE("Unknown resource type: {}", (int)type);
  return vk::DescriptorType::eMutableVALVE;
}

EZ_ALWAYS_INLINE vk::ShaderStageFlagBits ezConversionUtilsVulkan::GetShaderStages(ezBitflags<ezGALShaderStageFlags> stages)
{
  return (vk::ShaderStageFlagBits)stages.GetValue();
}

EZ_ALWAYS_INLINE vk::PipelineStageFlags ezConversionUtilsVulkan::GetPipelineStages(ezBitflags<ezGALShaderStageFlags> stages)
{
  vk::PipelineStageFlags res;
  for (int i = 0; i < ezGALShaderStage::ENUM_COUNT; ++i)
  {
    ezGALShaderStageFlags::Enum flag = ezGALShaderStageFlags::MakeFromShaderStage((ezGALShaderStage::Enum)i);
    if (stages.IsSet(flag))
    {
      res |= GetPipelineStage((ezGALShaderStage::Enum)i);
    }
  }
  return res;
}

static_assert((ezUInt32)vk::ShaderStageFlagBits::eVertex == (ezUInt32)ezGALShaderStageFlags::VertexShader);
static_assert((ezUInt32)vk::ShaderStageFlagBits::eTessellationControl == (ezUInt32)ezGALShaderStageFlags::HullShader);
static_assert((ezUInt32)vk::ShaderStageFlagBits::eTessellationEvaluation == (ezUInt32)ezGALShaderStageFlags::DomainShader);
static_assert((ezUInt32)vk::ShaderStageFlagBits::eGeometry == (ezUInt32)ezGALShaderStageFlags::GeometryShader);
static_assert((ezUInt32)vk::ShaderStageFlagBits::eFragment == (ezUInt32)ezGALShaderStageFlags::PixelShader);
static_assert((ezUInt32)vk::ShaderStageFlagBits::eCompute == (ezUInt32)ezGALShaderStageFlags::ComputeShader);