GrManagedResource Class Reference

#include <GrManagedResource.h>

Inheritance diagram for GrManagedResource:

Public Member Functions
	GrManagedResource ()
virtual	~GrManagedResource ()
bool	unique () const
void	ref () const
void	unref () const

Private Member Functions
virtual void	freeGPUData () const =0

Detailed Description

GrManagedResource is the base class for GPU resources that may be shared by multiple objects, in particular objects that are tracked by a command buffer. When an existing owner wants to share a reference, it calls ref(). When an owner wants to release its reference, it calls unref(). When the shared object's reference count goes to zero as the result of an unref() call, its (virtual) destructor is called. It is an error for the destructor to be called explicitly (or via the object going out of scope on the stack or calling delete) if getRefCnt() > 1.

This is nearly identical to SkRefCntBase. The exceptions are that unref() takes a GrGpu, and any derived classes must implement freeGPUData().

Definition at line 39 of file GrManagedResource.h.

Constructor & Destructor Documentation

GrManagedResource()

GrManagedResource::GrManagedResource ( )

inline

Default construct, initializing the reference count to 1.

Definition at line 80 of file GrManagedResource.h.

                        : fRefCnt(1) {
#ifdef SK_TRACE_MANAGED_RESOURCES
        fKey = fKeyCounter.fetch_add(+1, std::memory_order_relaxed);
        GetTrace()->add(this);
#endif
    }

~GrManagedResource()

virtual GrManagedResource::~GrManagedResource ( )

inlinevirtual

Destruct, asserting that the reference count is 1.

Definition at line 89 of file GrManagedResource.h.

                                 {
#ifdef SK_DEBUG
        auto count = this->getRefCnt();
        SkASSERTF(count == 1, "fRefCnt was %d", count);
        fRefCnt.store(0);    // illegal value, to catch us if we reuse after delete
#endif
    }

Member Function Documentation

freeGPUData()

virtual void GrManagedResource::freeGPUData ( ) const

privatepure virtual

Must be implemented by any subclasses. Deletes any GPU data associated with this resource

Implemented in GrD3DCommandSignature, GrD3DPipeline, GrD3DRootSignature, GrMtlDepthStencil, GrMtlRenderPipeline, GrMtlSampler, GrMtlEvent, GrVkCommandPool, GrVkDescriptorPool, GrVkDescriptorSet, GrVkFramebuffer, GrVkImageView, GrVkPipeline, GrVkRenderPass, GrVkSampler, GrVkSamplerYcbcrConversion, and GrVkSemaphore::Resource.

ref()

void GrManagedResource::ref ( ) const

inline

Increment the reference count. Must be balanced by a call to unref() or unrefAndFreeResources().

Definition at line 115 of file GrManagedResource.h.

                     {
        // No barrier required.
        SkDEBUGCODE(int newRefCount = )fRefCnt.fetch_add(+1, std::memory_order_relaxed);
        SkASSERT(newRefCount >= 1);
    }

unique()

bool GrManagedResource::unique ( ) const

inline

May return true if the caller is the only owner. Ensures that all previous owner's actions are complete.

Definition at line 105 of file GrManagedResource.h.

                        {
        // The acquire barrier is only really needed if we return true.  It
        // prevents code conditioned on the result of unique() from running
        // until previous owners are all totally done calling unref().
        return 1 == fRefCnt.load(std::memory_order_acquire);
    }

unref()

void GrManagedResource::unref ( ) const

inline

Decrement the reference count. If the reference count is 1 before the decrement, then delete the object. Note that if this is the case, then the object needs to have been allocated via new, and not on the stack. Any GPU data associated with this resource will be freed before it's deleted.

Definition at line 126 of file GrManagedResource.h.

                       {
        // A release here acts in place of all releases we "should" have been doing in ref().
        int newRefCount = fRefCnt.fetch_add(-1, std::memory_order_acq_rel);
        SkASSERT(newRefCount >= 0);
        if (newRefCount == 1) {
            // Like unique(), the acquire is only needed on success, to make sure
            // code in internal_dispose() doesn't happen before the decrement.
            this->internal_dispose();
        }
    }

---

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

• third_party/skia/src/gpu/ganesh/GrManagedResource.h