impeller::KHRSwapchainImplVK Class Reference

An instance of a swapchain that does NOT adapt to going out of date with the underlying surface. Errors will be indicated when the next drawable is acquired from this implementation of the swapchain. If the error is due the swapchain going out of date, the caller must recreate another instance by optionally stealing this implementations guts. More...

#include <khr_swapchain_impl_vk.h>

Inheritance diagram for impeller::KHRSwapchainImplVK:

Classes
struct	AcquireResult

Public Member Functions
	~KHRSwapchainImplVK ()
bool	IsValid () const
AcquireResult	AcquireNextDrawable ()
vk::Format	GetSurfaceFormat () const
std::shared_ptr< Context >	GetContext () const
std::pair< vk::UniqueSurfaceKHR, vk::UniqueSwapchainKHR >	DestroySwapchain ()
const ISize &	GetSize () const

Static Public Member Functions
static std::shared_ptr< KHRSwapchainImplVK >	Create (const std::shared_ptr< Context > &context, vk::UniqueSurfaceKHR surface, const ISize &size, bool enable_msaa=true, vk::SwapchainKHR old_swapchain=VK_NULL_HANDLE)

Detailed Description

An instance of a swapchain that does NOT adapt to going out of date with the underlying surface. Errors will be indicated when the next drawable is acquired from this implementation of the swapchain. If the error is due the swapchain going out of date, the caller must recreate another instance by optionally stealing this implementations guts.

Definition at line 31 of file khr_swapchain_impl_vk.h.

Constructor & Destructor Documentation

~KHRSwapchainImplVK()

impeller::KHRSwapchainImplVK::~KHRSwapchainImplVK

(

)

Definition at line 277 of file khr_swapchain_impl_vk.cc.

                                        {
  DestroySwapchain();
}

Member Function Documentation

AcquireNextDrawable()

KHRSwapchainImplVK::AcquireResult impeller::KHRSwapchainImplVK::AcquireNextDrawable

(

)

Wait on the host for the synchronizer fence.

Get the next image index.

Record all subsequent cmd buffers as part of the current frame.

Definition at line 314 of file khr_swapchain_impl_vk.cc.

                                                                        {
  auto context_strong = context_.lock();
  if (!context_strong) {
    return KHRSwapchainImplVK::AcquireResult{};
  }
 
  const auto& context = ContextVK::Cast(*context_strong);
 
  current_frame_ = (current_frame_ + 1u) % synchronizers_.size();
 
  const auto& sync = synchronizers_[current_frame_];
 
  //----------------------------------------------------------------------------
  /// Wait on the host for the synchronizer fence.
  ///
  if (!sync->WaitForFence(context.GetDevice())) {
    VALIDATION_LOG << "Could not wait for fence.";
    return KHRSwapchainImplVK::AcquireResult{};
  }
 
  //----------------------------------------------------------------------------
  /// Get the next image index.
  ///
  auto [acq_result, index] = context.GetDevice().acquireNextImageKHR(
      *swapchain_,          // swapchain
      1'000'000'000,        // timeout (ns) 1000ms
      *sync->render_ready,  // signal semaphore
      nullptr               // fence
  );
 
  switch (acq_result) {
    case vk::Result::eSuccess:
      // Keep going.
      break;
    case vk::Result::eSuboptimalKHR:
    case vk::Result::eErrorOutOfDateKHR:
      // A recoverable error. Just say we are out of date.
      return AcquireResult{true /* out of date */};
      break;
    default:
      // An unrecoverable error.
      VALIDATION_LOG << "Could not acquire next swapchain image: "
                     << vk::to_string(acq_result);
      return AcquireResult{false /* out of date */};
  }
 
  if (index >= images_.size()) {
    VALIDATION_LOG << "Swapchain returned an invalid image index.";
    return KHRSwapchainImplVK::AcquireResult{};
  }
 
  /// Record all subsequent cmd buffers as part of the current frame.
  context.GetGPUTracer()->MarkFrameStart();
 
  auto image = images_[index % images_.size()];
  uint32_t image_index = index;
  return AcquireResult{SurfaceVK::WrapSwapchainImage(
      transients_,  // transients
      image,        // swapchain image
      [weak_swapchain = weak_from_this(), image, image_index]() -> bool {
        auto swapchain = weak_swapchain.lock();
        if (!swapchain) {
          return false;
        }
        return swapchain->Present(image, image_index);
      }  // swap callback
      )};
}

Create()

std::shared_ptr< KHRSwapchainImplVK > impeller::KHRSwapchainImplVK::Create ( const std::shared_ptr< Context > &  context, vk::UniqueSurfaceKHR  surface, const ISize &  size, bool  enable_msaa = true, vk::SwapchainKHR  old_swapchain = VK_NULL_HANDLE  )

static

Definition at line 118 of file khr_swapchain_impl_vk.cc.

                                  {
  return std::shared_ptr<KHRSwapchainImplVK>(new KHRSwapchainImplVK(
      context, std::move(surface), size, enable_msaa, old_swapchain));
}

DestroySwapchain()

std::pair< vk::UniqueSurfaceKHR, vk::UniqueSwapchainKHR > impeller::KHRSwapchainImplVK::DestroySwapchain

(

)

Definition at line 297 of file khr_swapchain_impl_vk.cc.

                                     {
  WaitIdle();
  is_valid_ = false;
  synchronizers_.clear();
  images_.clear();
  context_.reset();
  return {std::move(surface_), std::move(swapchain_)};
}

GetContext()

std::shared_ptr< Context > impeller::KHRSwapchainImplVK::GetContext

(

)

const

Definition at line 310 of file khr_swapchain_impl_vk.cc.

                                                            {
  return context_.lock();
}

GetSize()

const ISize & impeller::KHRSwapchainImplVK::GetSize

(

)

const

Definition at line 281 of file khr_swapchain_impl_vk.cc.

                                               {
  return size_;
}

GetSurfaceFormat()

vk::Format impeller::KHRSwapchainImplVK::GetSurfaceFormat

(

)

const

Definition at line 306 of file khr_swapchain_impl_vk.cc.

                                                    {
  return surface_format_;
}

IsValid()

bool impeller::KHRSwapchainImplVK::IsValid

(

)

const

Definition at line 285 of file khr_swapchain_impl_vk.cc.

                                       {
  return is_valid_;
}

---

The documentation for this class was generated from the following files:

• impeller/renderer/backend/vulkan/swapchain/khr/khr_swapchain_impl_vk.h
• impeller/renderer/backend/vulkan/swapchain/khr/khr_swapchain_impl_vk.cc