texture_vk.cc

Go to the documentation of this file.

// Copyright 2013 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
 
#include "impeller/renderer/backend/vulkan/texture_vk.h"
 
#include "impeller/core/texture_descriptor.h"
#include "impeller/renderer/backend/vulkan/command_buffer_vk.h"
#include "impeller/renderer/backend/vulkan/formats_vk.h"
#include "impeller/renderer/backend/vulkan/sampler_vk.h"
 
namespace impeller {
 
TextureVK::TextureVK(std::weak_ptr<Context> context,
                     std::shared_ptr<TextureSourceVK> source)
    : Texture(source->GetTextureDescriptor()),
      context_(std::move(context)),
      source_(std::move(source)) {
#ifdef IMPELLER_DEBUG
  has_validation_layers_ = HasValidationLayers();
#endif  // IMPELLER_DEBUG
}
 
TextureVK::~TextureVK() = default;
 
void TextureVK::SetLabel(std::string_view label) {
#ifdef IMPELLER_DEBUG
  if (!has_validation_layers_) {
    return;
  }
  auto context = context_.lock();
  if (!context) {
    // The context may have died.
    return;
  }
  ContextVK::Cast(*context).SetDebugName(GetImage(), label);
  ContextVK::Cast(*context).SetDebugName(GetImageView(), label);
#endif  // IMPELLER_DEBUG
}
 
void TextureVK::SetLabel(std::string_view label, std::string_view trailing) {
#ifdef IMPELLER_DEBUG
  auto context = context_.lock();
  if (!context) {
    // The context may have died.
    return;
  }
 
  ContextVK::Cast(*context).SetDebugName(GetImage(), label, trailing);
  ContextVK::Cast(*context).SetDebugName(GetImageView(), label, trailing);
#endif  // IMPELLER_DEBUG
}
 
bool TextureVK::OnSetContents(const uint8_t* contents,
                              size_t length,
                              size_t slice) {
  if (!IsValid() || !contents) {
    return false;
  }
 
  const auto& desc = GetTextureDescriptor();
 
  // Out of bounds access.
  if (length != desc.GetByteSizeOfBaseMipLevel()) {
    VALIDATION_LOG << "Illegal to set contents for invalid size.";
    return false;
  }
 
  auto context = context_.lock();
  if (!context) {
    VALIDATION_LOG << "Context died before setting contents on texture.";
    return false;
  }
 
  auto staging_buffer =
      context->GetResourceAllocator()->CreateBufferWithCopy(contents, length);
 
  if (!staging_buffer) {
    VALIDATION_LOG << "Could not create staging buffer.";
    return false;
  }
 
  auto cmd_buffer = context->CreateCommandBuffer();
 
  if (!cmd_buffer) {
    return false;
  }
 
  auto& cmd_buffer_vk = CommandBufferVK::Cast(*cmd_buffer);
 
  if (!cmd_buffer_vk.Track(staging_buffer) || !cmd_buffer_vk.Track(source_)) {
    return false;
  }
 
  const auto& vk_cmd_buffer = cmd_buffer_vk.GetCommandBuffer();
 
  BarrierVK barrier;
  barrier.cmd_buffer = vk_cmd_buffer;
  barrier.new_layout = vk::ImageLayout::eTransferDstOptimal;
  barrier.src_access = {};
  barrier.src_stage = vk::PipelineStageFlagBits::eTopOfPipe;
  barrier.dst_access = vk::AccessFlagBits::eTransferWrite;
  barrier.dst_stage = vk::PipelineStageFlagBits::eTransfer;
 
  if (!SetLayout(barrier)) {
    return false;
  }
 
  vk::BufferImageCopy copy;
  copy.bufferOffset = 0u;
  copy.bufferRowLength = 0u;    // 0u means tightly packed per spec.
  copy.bufferImageHeight = 0u;  // 0u means tightly packed per spec.
  copy.imageOffset.x = 0u;
  copy.imageOffset.y = 0u;
  copy.imageOffset.z = 0u;
  copy.imageExtent.width = desc.size.width;
  copy.imageExtent.height = desc.size.height;
  copy.imageExtent.depth = 1u;
  copy.imageSubresource.aspectMask =
      ToImageAspectFlags(GetTextureDescriptor().format);
  copy.imageSubresource.mipLevel = 0u;
  copy.imageSubresource.baseArrayLayer = slice;
  copy.imageSubresource.layerCount = 1u;
 
  vk_cmd_buffer.copyBufferToImage(
      DeviceBufferVK::Cast(*staging_buffer).GetBuffer(),  // src buffer
      GetImage(),                                         // dst image
      barrier.new_layout,                                 // dst image layout
      1u,                                                 // region count
      &copy                                               // regions
  );
 
  // Transition to shader-read.
  {
    BarrierVK barrier;
    barrier.cmd_buffer = vk_cmd_buffer;
    barrier.src_access = vk::AccessFlagBits::eColorAttachmentWrite |
                         vk::AccessFlagBits::eTransferWrite;
    barrier.src_stage = vk::PipelineStageFlagBits::eColorAttachmentOutput |
                        vk::PipelineStageFlagBits::eTransfer;
    barrier.dst_access = vk::AccessFlagBits::eShaderRead;
    barrier.dst_stage = vk::PipelineStageFlagBits::eFragmentShader;
 
    barrier.new_layout = vk::ImageLayout::eShaderReadOnlyOptimal;
 
    if (!SetLayout(barrier)) {
      return false;
    }
  }
 
  return context->GetCommandQueue()->Submit({cmd_buffer}).ok();
}
 
bool TextureVK::OnSetContents(std::shared_ptr<const fml::Mapping> mapping,
                              size_t slice) {
  // Vulkan has no threading restrictions. So we can pass this data along to the
  // client rendering API immediately.
  return OnSetContents(mapping->GetMapping(), mapping->GetSize(), slice);
}
 
bool TextureVK::IsValid() const {
  return !!source_;
}
 
ISize TextureVK::GetSize() const {
  return GetTextureDescriptor().size;
}
 
vk::Image TextureVK::GetImage() const {
  return source_->GetImage();
}
 
vk::ImageView TextureVK::GetImageView() const {
  return source_->GetImageView();
}
 
std::shared_ptr<const TextureSourceVK> TextureVK::GetTextureSource() const {
  return source_;
}
 
bool TextureVK::SetLayout(const BarrierVK& barrier) const {
  return source_ ? source_->SetLayout(barrier).ok() : false;
}
 
vk::ImageLayout TextureVK::SetLayoutWithoutEncoding(
    vk::ImageLayout layout) const {
  return source_ ? source_->SetLayoutWithoutEncoding(layout)
                 : vk::ImageLayout::eUndefined;
}
 
vk::ImageLayout TextureVK::GetLayout() const {
  return source_ ? source_->GetLayout() : vk::ImageLayout::eUndefined;
}
 
vk::ImageView TextureVK::GetRenderTargetView() const {
  return source_->GetRenderTargetView();
}
 
void TextureVK::SetCachedFramebuffer(
    const SharedHandleVK<vk::Framebuffer>& framebuffer) {
  source_->SetCachedFramebuffer(framebuffer);
}
 
void TextureVK::SetCachedRenderPass(
    const SharedHandleVK<vk::RenderPass>& render_pass) {
  source_->SetCachedRenderPass(render_pass);
}
 
SharedHandleVK<vk::Framebuffer> TextureVK::GetCachedFramebuffer() const {
  return source_->GetCachedFramebuffer();
}
 
SharedHandleVK<vk::RenderPass> TextureVK::GetCachedRenderPass() const {
  return source_->GetCachedRenderPass();
}
 
void TextureVK::SetMipMapGenerated() {
  mipmap_generated_ = true;
}
 
bool TextureVK::IsSwapchainImage() const {
  return source_->IsSwapchainImage();
}
 
std::shared_ptr<SamplerVK> TextureVK::GetImmutableSamplerVariant(
    const SamplerVK& sampler) const {
  if (!source_) {
    return nullptr;
  }
  std::shared_ptr<YUVConversionVK> conversion = source_->GetYUVConversion();
  if (!conversion) {
    // Most textures don't need a sampler conversion and will go down this path.
    // Only needed for YUV sampling from external textures.
    return nullptr;
  }
  return sampler.CreateVariantForConversion(std::move(conversion));
}
 
}  // namespace impeller