skgpu::graphite::VulkanDescriptorPool Class Reference

#include <VulkanDescriptorPool.h>

Inheritance diagram for skgpu::graphite::VulkanDescriptorPool:

Public Member Functions
VkDescriptorPool	descPool ()
const VkDescriptorSetLayout *	descSetLayout ()
Public Member Functions inherited from SkRefCntBase
	SkRefCntBase ()
virtual	~SkRefCntBase ()
bool	unique () const
void	ref () const
void	unref () const

Static Public Member Functions
static sk_sp< VulkanDescriptorPool >	Make (const VulkanSharedContext *, SkSpan< DescriptorData >, VkDescriptorSetLayout)

Static Public Attributes
static constexpr int	kMaxNumSets = 512

Private Member Functions
	~VulkanDescriptorPool () override

Detailed Description

Definition at line 21 of file VulkanDescriptorPool.h.

Member Function Documentation

descPool()

VkDescriptorPool skgpu::graphite::VulkanDescriptorPool::descPool ( )

inline

Definition at line 34 of file VulkanDescriptorPool.h.

{ return fDescPool; }

descSetLayout()

const VkDescriptorSetLayout * skgpu::graphite::VulkanDescriptorPool::descSetLayout ( )

inline

Definition at line 36 of file VulkanDescriptorPool.h.

                                                 {
        SkASSERT(fDescSetLayout != VK_NULL_HANDLE);
        return &fDescSetLayout;
    }

Make()

sk_sp< VulkanDescriptorPool > skgpu::graphite::VulkanDescriptorPool::Make ( const VulkanSharedContext *  context, SkSpan< DescriptorData >  requestedDescCounts, VkDescriptorSetLayout  layout  )

static

Given a span of descriptor types and counts, a descriptor pool will be created which houses enough of the descriptor types and quantities requested to allocate the maximum number of sets possible (kMaxNumSets). Counts must be > 0.

Definition at line 15 of file VulkanDescriptorPool.cpp.

                                                                                     {
 
    if (requestedDescCounts.empty()) {
        return nullptr;
    }
 
    // For each requested descriptor type and count, create a VkDescriptorPoolSize struct which
    // specifies the descriptor type and quantity for pool creation. Multiple pool size structures
    // may contain the same descriptor type - the pool will be created with enough storage for the
    // total number of descriptors of each type. Source:
    // https://registry.khronos.org/vulkan/specs/1.3-extensions/html/vkspec.html#VkDescriptorPoolSize
    // Note: The kMaxNumDescriptors limit could be evaded since we do not currently track and check
    // the cumulative quantities of each type of descriptor, but this is an internal call and it is
    // highly unexpected for us to exceed this limit in practice.
    skia_private::STArray<kDescriptorTypeCount, VkDescriptorPoolSize> poolSizes;
    for (size_t i = 0; i < requestedDescCounts.size(); i++) {
        SkASSERT(requestedDescCounts[i].count > 0);
        if (requestedDescCounts[i].count > kMaxNumDescriptors) {
            SkDebugf("The number of descriptors requested, %u, exceeds the maximum allowed (%d).\n",
                     requestedDescCounts[i].count,
                     kMaxNumDescriptors);
            return nullptr;
        }
        VkDescriptorPoolSize& poolSize = poolSizes.push_back();
        memset(&poolSize, 0, sizeof(VkDescriptorPoolSize));
        // Map each DescriptorSetType to the appropriate backend VkDescriptorType
        poolSize.type = DsTypeEnumToVkDs(requestedDescCounts[i].type);
        // Create a pool large enough to accommodate the maximum possible number of descriptor sets
        poolSize.descriptorCount = requestedDescCounts[i].count * kMaxNumSets;
    }
 
    VkDescriptorPoolCreateInfo createInfo;
    memset(&createInfo, 0, sizeof(VkDescriptorPoolCreateInfo));
    createInfo.sType = VK_STRUCTURE_TYPE_DESCRIPTOR_POOL_CREATE_INFO;
    createInfo.pNext = nullptr;
    createInfo.flags = 0;
    createInfo.maxSets = kMaxNumSets;
    createInfo.poolSizeCount = requestedDescCounts.size();
    createInfo.pPoolSizes = &poolSizes.front();
 
    VkDescriptorPool pool;
    VkResult result;
    VULKAN_CALL_RESULT(context,
                       result,
                       CreateDescriptorPool(context->device(),
                                            &createInfo,
                                            /*const VkAllocationCallbacks*=*/nullptr,
                                            &pool));
    if (result != VK_SUCCESS) {
        VULKAN_CALL(context->interface(),
                    DestroyDescriptorSetLayout(context->device(), layout, nullptr));
        return nullptr;
    }
    return sk_sp<VulkanDescriptorPool>(new VulkanDescriptorPool(context, pool, layout));
}

~VulkanDescriptorPool()

skgpu::graphite::VulkanDescriptorPool::~VulkanDescriptorPool ( )

overrideprivate

Definition at line 80 of file VulkanDescriptorPool.cpp.

                                            {
    // Destroying the VkDescriptorPool will automatically free and delete any VkDescriptorSets
    // allocated from the pool.
    VULKAN_CALL(fSharedContext->interface(),
                DestroyDescriptorPool(fSharedContext->device(), fDescPool, nullptr));
    if (fDescSetLayout != VK_NULL_HANDLE) {
        VULKAN_CALL(fSharedContext->interface(),
                    DestroyDescriptorSetLayout(fSharedContext->device(), fDescSetLayout, nullptr));
        fDescSetLayout = VK_NULL_HANDLE;
    }
}

Member Data Documentation

kMaxNumSets

constexpr int skgpu::graphite::VulkanDescriptorPool::kMaxNumSets = 512

staticconstexpr

Definition at line 24 of file VulkanDescriptorPool.h.

---

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

• third_party/skia/src/gpu/graphite/vk/VulkanDescriptorPool.h
• third_party/skia/src/gpu/graphite/vk/VulkanDescriptorPool.cpp