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\|. More...

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

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. More...

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