Creates and manages the lifecycle of |vk::DescriptorPoolVK| objects. More...

#include <descriptor_pool_vk.h>

Inheritance diagram for impeller::DescriptorPoolRecyclerVK:

Public Member Functions
	~DescriptorPoolRecyclerVK ()=default

	DescriptorPoolRecyclerVK (std::weak_ptr< ContextVK > context)
	Creates a recycler for the given \|ContextVK\|.

vk::UniqueDescriptorPool	Get ()
	Gets a descriptor pool.

std::shared_ptr< DescriptorPoolVK >	GetDescriptorPool ()

void	Reclaim (DescriptorCacheMap descriptor_sets, std::vector< vk::UniqueDescriptorPool > pools)

Static Public Attributes
static constexpr size_t	kMaxRecycledPools = 32u
	The maximum number of descriptor pools this recycler will hold onto.

Detailed Description

Creates and manages the lifecycle of |vk::DescriptorPoolVK| objects.

Definition at line 70 of file descriptor_pool_vk.h.

Constructor & Destructor Documentation

◆ ~DescriptorPoolRecyclerVK()

impeller::DescriptorPoolRecyclerVK::~DescriptorPoolRecyclerVK ( )

default

◆ DescriptorPoolRecyclerVK()

impeller::DescriptorPoolRecyclerVK::DescriptorPoolRecyclerVK ( std::weak_ptr< ContextVK > context )

inlineexplicit

Creates a recycler for the given |ContextVK|.

Parameters

[in] context The context to create the recycler for.

Definition at line 81 of file descriptor_pool_vk.h.

82 : context_(std::move(context)) {}

Member Function Documentation

◆ Get()

vk::UniqueDescriptorPool impeller::DescriptorPoolRecyclerVK::Get ( )

Gets a descriptor pool.

        This may create a new descriptor pool if no existing pools had
        the necessary capacity.

Definition at line 138 of file descriptor_pool_vk.cc.

                                                     {
  // Recycle a pool with a matching minumum capcity if it is available.
  return Create();
}

◆ GetDescriptorPool()

std::shared_ptr< DescriptorPoolVK > impeller::DescriptorPoolRecyclerVK::GetDescriptorPool ( )

Definition at line 174 of file descriptor_pool_vk.cc.

                                            {
  {
    Lock recycled_lock(recycled_mutex_);
    if (!recycled_.empty()) {
      auto result = recycled_.back();
      recycled_.pop_back();
      return result;
    }
  }
  return std::make_shared<DescriptorPoolVK>(context_);
}

◆ Reclaim()

void impeller::DescriptorPoolRecyclerVK::Reclaim	(	DescriptorCacheMap	descriptor_sets,
		std::vector< vk::UniqueDescriptorPool >	pools
	)

Definition at line 111 of file descriptor_pool_vk.cc.

                                             {
  // Reset the pool on a background thread.
  auto strong_context = context_.lock();
  if (!strong_context) {
    return;
  }
 
  for (auto& [_, cache] : descriptor_sets) {
    cache.unused.insert(cache.unused.end(), cache.used.begin(),
                        cache.used.end());
    cache.used.clear();
  }
 
  // Move the pool to the recycled list. If more than 32 pool are
  // cached then delete the newest entry.
  Lock recycled_lock(recycled_mutex_);
  while (recycled_.size() >= kMaxRecycledPools) {
    auto& back_entry = recycled_.back();
    back_entry->Destroy();
    recycled_.pop_back();
  }
  recycled_.push_back(std::make_shared<DescriptorPoolVK>(
      context_, std::move(descriptor_sets), std::move(pools)));
}

References kMaxRecycledPools.

Member Data Documentation

◆ kMaxRecycledPools

constexpr size_t impeller::DescriptorPoolRecyclerVK::kMaxRecycledPools = 32u

staticconstexpr

The maximum number of descriptor pools this recycler will hold onto.

Definition at line 76 of file descriptor_pool_vk.h.

Referenced by Reclaim().

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

impeller/renderer/backend/vulkan/descriptor_pool_vk.h
impeller/renderer/backend/vulkan/descriptor_pool_vk.cc

Public Member Functions

Static Public Attributes