GrRenderTargetProxy Class Reference

#include <GrRenderTargetProxy.h>

Inheritance diagram for GrRenderTargetProxy:

Public Member Functions
GrRenderTargetProxy *	asRenderTargetProxy () override
const GrRenderTargetProxy *	asRenderTargetProxy () const override
bool	instantiate (GrResourceProvider *) override
bool	canUseStencil (const GrCaps &caps) const
void	setNeedsStencil ()
int	needsStencil () const
int	numSamples () const
int	maxWindowRectangles (const GrCaps &caps) const
bool	glRTFBOIDIs0 () const
bool	wrapsVkSecondaryCB () const
bool	supportsVkInputAttachment () const
void	markMSAADirty (SkIRect dirtyRect)
void	markMSAAResolved ()
bool	isMSAADirty () const
const SkIRect &	msaaDirtyRect () const
bool	refsWrappedObjects () const
sk_sp< GrArenas >	arenas ()
void	clearArenas ()
Public Member Functions inherited from GrSurfaceProxy
virtual	~GrSurfaceProxy ()
bool	isLazy () const
bool	isFullyLazy () const
SkISize	dimensions () const
int	width () const
int	height () const
SkISize	backingStoreDimensions () const
SkRect	getBoundsRect () const
bool	isFunctionallyExact () const
SkRect	backingStoreBoundsRect () const
SkIRect	backingStoreBoundsIRect () const
const GrBackendFormat &	backendFormat () const
bool	isFormatCompressed (const GrCaps *) const
UniqueID	uniqueID () const
UniqueID	underlyingUniqueID () const
void	deinstantiate ()
bool	canSkipResourceAllocator () const
virtual GrTextureProxy *	asTextureProxy ()
virtual const GrTextureProxy *	asTextureProxy () const
virtual const skgpu::UniqueKey &	getUniqueKey () const
bool	isInstantiated () const
void	isUsedAsTaskTarget ()
int	getTaskTargetCount () const
GrSurface *	peekSurface () const
GrTexture *	peekTexture () const
GrRenderTarget *	peekRenderTarget () const
skgpu::Budgeted	isBudgeted () const
bool	readOnly () const
bool	framebufferOnly () const
bool	requiresManualMSAAResolve () const
size_t	gpuMemorySize () const
std::string_view	getLabel () const
GrSurfaceProxyPriv	priv ()
const GrSurfaceProxyPriv	priv () const
bool	isDDLTarget () const
GrProtected	isProtected () const
bool	isPromiseProxy ()
Public Member Functions inherited from SkNVRefCnt< GrSurfaceProxy >
	SkNVRefCnt ()
	~SkNVRefCnt ()
bool	unique () const
void	ref () const
void	unref () const
void	deref () const
bool	refCntGreaterThan (int32_t threadIsolatedTestCnt) const

Protected Types
enum class	WrapsVkSecondaryCB : bool { kNo = false , kYes = true }

Protected Member Functions
	GrRenderTargetProxy (const GrCaps &, const GrBackendFormat &, SkISize, int sampleCount, SkBackingFit, skgpu::Budgeted, skgpu::Protected, GrInternalSurfaceFlags, UseAllocator, std::string_view label)
	GrRenderTargetProxy (LazyInstantiateCallback &&, const GrBackendFormat &, SkISize, int sampleCount, SkBackingFit, skgpu::Budgeted, skgpu::Protected, GrInternalSurfaceFlags, UseAllocator, WrapsVkSecondaryCB, std::string_view label)
	GrRenderTargetProxy (sk_sp< GrSurface >, UseAllocator, WrapsVkSecondaryCB=WrapsVkSecondaryCB::kNo)
sk_sp< GrSurface >	createSurface (GrResourceProvider *) const override
Protected Member Functions inherited from GrSurfaceProxy
	GrSurfaceProxy (const GrBackendFormat &, SkISize, SkBackingFit, skgpu::Budgeted, GrProtected, GrInternalSurfaceFlags, UseAllocator, std::string_view label)
	GrSurfaceProxy (LazyInstantiateCallback &&, const GrBackendFormat &, SkISize, SkBackingFit, skgpu::Budgeted, GrProtected, GrInternalSurfaceFlags, UseAllocator, std::string_view label)
	GrSurfaceProxy (sk_sp< GrSurface >, SkBackingFit, UseAllocator)
bool	ignoredByResourceAllocator () const
void	setIgnoredByResourceAllocator ()
void	computeScratchKey (const GrCaps &, skgpu::ScratchKey *) const
void	assign (sk_sp< GrSurface > surface)
sk_sp< GrSurface >	createSurfaceImpl (GrResourceProvider *, int sampleCnt, GrRenderable, skgpu::Mipmapped) const
void	setLazyDimensions (SkISize dimensions)
bool	instantiateImpl (GrResourceProvider *resourceProvider, int sampleCnt, GrRenderable, skgpu::Mipmapped, const skgpu::UniqueKey *)

Private Member Functions
size_t	onUninstantiatedGpuMemorySize () const override
	SkDEBUGCODE (void onValidateSurface(const GrSurface *) override;) LazySurfaceDesc callbackDesc() const override

Friends
class	GrProxyProvider
class	GrVkSecondaryCBDrawContext

Additional Inherited Members
Public Types inherited from GrSurfaceProxy
enum class	ResolveFlags { kNone = 0 , kMSAA = 1 << 0 , kMipMaps = 1 << 1 }
enum class	LazyInstantiationKeyMode { kUnsynced , kSynced }
enum class	UseAllocator { kNo = false , kYes = true }
enum class	RectsMustMatch : bool { kNo = false , kYes = true }
using	LazyInstantiateCallback = std::function< LazyCallbackResult(GrResourceProvider *, const LazySurfaceDesc &)>
Static Public Member Functions inherited from GrSurfaceProxy
static sk_sp< GrSurfaceProxy >	Copy (GrRecordingContext *, sk_sp< GrSurfaceProxy > src, GrSurfaceOrigin, skgpu::Mipmapped, SkIRect srcRect, SkBackingFit, skgpu::Budgeted, std::string_view label, RectsMustMatch=RectsMustMatch::kNo, sk_sp< GrRenderTask > *outTask=nullptr)
static sk_sp< GrSurfaceProxy >	Copy (GrRecordingContext *, sk_sp< GrSurfaceProxy > src, GrSurfaceOrigin, skgpu::Mipmapped, SkBackingFit, skgpu::Budgeted, std::string_view label, sk_sp< GrRenderTask > *outTask=nullptr)
Protected Attributes inherited from GrSurfaceProxy
sk_sp< GrSurface >	fTarget
GrInternalSurfaceFlags	fSurfaceFlags

Detailed Description

Definition at line 64 of file GrRenderTargetProxy.h.

Member Enumeration Documentation

WrapsVkSecondaryCB

enum class GrRenderTargetProxy::WrapsVkSecondaryCB : bool

strongprotected

Enumerator
kNo
kYes

Definition at line 149 of file GrRenderTargetProxy.h.

: bool { kNo = false, kYes = true };

Constructor & Destructor Documentation

GrRenderTargetProxy() [1/3]

GrRenderTargetProxy::GrRenderTargetProxy ( const GrCaps &  caps, const GrBackendFormat &  format, SkISize  dimensions, int  sampleCount, SkBackingFit  fit, skgpu::Budgeted  budgeted, skgpu::Protected  isProtected, GrInternalSurfaceFlags  surfaceFlags, UseAllocator  useAllocator, std::string_view  label  )

protected

Definition at line 32 of file GrRenderTargetProxy.cpp.

        : INHERITED(
                  format, dimensions, fit, budgeted, isProtected, surfaceFlags, useAllocator, label)
        , fSampleCnt(sampleCount)
        , fWrapsVkSecondaryCB(WrapsVkSecondaryCB::kNo) {}

GrRenderTargetProxy() [2/3]

GrRenderTargetProxy::GrRenderTargetProxy ( LazyInstantiateCallback &&  callback, const GrBackendFormat &  format, SkISize  dimensions, int  sampleCount, SkBackingFit  fit, skgpu::Budgeted  budgeted, skgpu::Protected  isProtected, GrInternalSurfaceFlags  surfaceFlags, UseAllocator  useAllocator, WrapsVkSecondaryCB  wrapsVkSecondaryCB, std::string_view  label  )

protected

Definition at line 48 of file GrRenderTargetProxy.cpp.

        : INHERITED(std::move(callback),
                    format,
                    dimensions,
                    fit,
                    budgeted,
                    isProtected,
                    surfaceFlags,
                    useAllocator,
                    label)
        , fSampleCnt(sampleCount)
        , fWrapsVkSecondaryCB(wrapsVkSecondaryCB) {}

GrRenderTargetProxy() [3/3]

GrRenderTargetProxy::GrRenderTargetProxy ( sk_sp< GrSurface >  surf, UseAllocator  useAllocator, WrapsVkSecondaryCB  wrapsVkSecondaryCB = WrapsVkSecondaryCB::kNo  )

protected

Definition at line 72 of file GrRenderTargetProxy.cpp.

        : INHERITED(std::move(surf), SkBackingFit::kExact, useAllocator)
        , fSampleCnt(fTarget->asRenderTarget()->numSamples())
        , fWrapsVkSecondaryCB(wrapsVkSecondaryCB) {
    // The kRequiresManualMSAAResolve flag better not be set if we are not multisampled or if
    // MSAA resolve should happen automatically.
    //
    // From the other side, we don't know enough about the wrapped surface to assert when
    // kRequiresManualMSAAResolve *should* be set. e.g., The caller might be wrapping a backend
    // texture as a render target at this point but we wouldn't know it.
    SkASSERT(!(this->numSamples() <= 1 ||
               fTarget->getContext()->priv().caps()->msaaResolvesAutomatically()) ||
             !this->requiresManualMSAAResolve());
}

Member Function Documentation

arenas()

sk_sp< GrArenas > GrRenderTargetProxy::arenas ( )

inline

Definition at line 120 of file GrRenderTargetProxy.h.

                             {
        if (fArenas == nullptr) {
            fArenas = sk_make_sp<GrArenas>();
        }
        return fArenas;
    }

asRenderTargetProxy() [1/2]

const GrRenderTargetProxy * GrRenderTargetProxy::asRenderTargetProxy ( ) const

inlineoverridevirtual

Reimplemented from GrSurfaceProxy.

Definition at line 67 of file GrRenderTargetProxy.h.

{ return this; }

asRenderTargetProxy() [2/2]

GrRenderTargetProxy * GrRenderTargetProxy::asRenderTargetProxy ( )

inlineoverridevirtual

Returns

the render target proxy associated with the surface proxy, may be NULL.

Reimplemented from GrSurfaceProxy.

Definition at line 66 of file GrRenderTargetProxy.h.

{ return this; }

canUseStencil()

bool GrRenderTargetProxy::canUseStencil

(

const GrCaps &

caps

)

const

Definition at line 107 of file GrRenderTargetProxy.cpp.

                                                                {
    if (caps.avoidStencilBuffers() || this->wrapsVkSecondaryCB()) {
        return false;
    }
    if (!this->isInstantiated()) {
        if (this->isLazy() && this->backendFormat().backend() == GrBackendApi::kOpenGL) {
            // It's possible for wrapped GL render targets to not have stencil. We don't currently
            // have an exact way of knowing whether the target will be able to use stencil, so we do
            // the best we can: if a lazy GL proxy doesn't have a texture, then it might be a
            // wrapped target without stencil, so we conservatively block stencil.
            // FIXME: skbug.com/11943: GrSurfaceCharacterization needs a "canUseStencil" flag.
            return SkToBool(this->asTextureProxy());
        } else {
            // Otherwise the target will definitely not be wrapped. Ganesh is free to attach
            // stencils on internal render targets.
            return true;
        }
    }
    // Just ask the actual target if we can use stencil.
    GrRenderTarget* rt = this->peekRenderTarget();
    // The dmsaa attachment (if any) always supports stencil. The real question is whether the
    // non-dmsaa attachment supports stencil.
    bool useMSAASurface = rt->numSamples() > 1;
    return rt->getStencilAttachment(useMSAASurface) ||
           rt->canAttemptStencilAttachment(useMSAASurface);
}

clearArenas()

void GrRenderTargetProxy::clearArenas ( )

inline

Definition at line 127 of file GrRenderTargetProxy.h.

                       {
        if (fArenas != nullptr) {
            fArenas->flush();
        }
        fArenas = nullptr;
    }

createSurface()

sk_sp< GrSurface > GrRenderTargetProxy::createSurface ( GrResourceProvider *  resourceProvider ) const

overrideprotectedvirtual

Implements GrSurfaceProxy.

Reimplemented in GrTextureRenderTargetProxy.

Definition at line 134 of file GrRenderTargetProxy.cpp.

                                                                                              {
    sk_sp<GrSurface> surface = this->createSurfaceImpl(resourceProvider, fSampleCnt,
                                                       GrRenderable::kYes, skgpu::Mipmapped::kNo);
    if (!surface) {
        return nullptr;
    }
    SkASSERT(surface->asRenderTarget());
    SkASSERT(!surface->asTexture());
    return surface;
}

glRTFBOIDIs0()

bool GrRenderTargetProxy::glRTFBOIDIs0 ( ) const

inline

Definition at line 91 of file GrRenderTargetProxy.h.

{ return fSurfaceFlags & GrInternalSurfaceFlags::kGLRTFBOIDIs0; }

instantiate()

bool GrRenderTargetProxy::instantiate ( GrResourceProvider *  resourceProvider )

overridevirtual

Implements GrSurfaceProxy.

Reimplemented in GrTextureRenderTargetProxy.

Definition at line 93 of file GrRenderTargetProxy.cpp.

                                                                          {
    if (this->isLazy()) {
        return false;
    }
    if (!this->instantiateImpl(resourceProvider, fSampleCnt, GrRenderable::kYes,
                               skgpu::Mipmapped::kNo, nullptr)) {
        return false;
    }
 
    SkASSERT(this->peekRenderTarget());
    SkASSERT(!this->peekTexture());
    return true;
}

isMSAADirty()

bool GrRenderTargetProxy::isMSAADirty ( ) const

inline

Definition at line 108 of file GrRenderTargetProxy.h.

                             {
        SkASSERT(fMSAADirtyRect.isEmpty() || this->requiresManualMSAAResolve());
        return this->requiresManualMSAAResolve() && !fMSAADirtyRect.isEmpty();
    }

markMSAADirty()

void GrRenderTargetProxy::markMSAADirty ( SkIRect  dirtyRect )

inline

Definition at line 99 of file GrRenderTargetProxy.h.

                                          {
        SkASSERT(SkIRect::MakeSize(this->backingStoreDimensions()).contains(dirtyRect));
        SkASSERT(this->requiresManualMSAAResolve());
        fMSAADirtyRect.join(dirtyRect);
    }

markMSAAResolved()

void GrRenderTargetProxy::markMSAAResolved ( )

inline

Definition at line 104 of file GrRenderTargetProxy.h.

                            {
        SkASSERT(this->requiresManualMSAAResolve());
        fMSAADirtyRect.setEmpty();
    }

maxWindowRectangles()

int GrRenderTargetProxy::maxWindowRectangles

(

const GrCaps &

caps

)

const

Definition at line 89 of file GrRenderTargetProxy.cpp.

                                                                     {
    return this->glRTFBOIDIs0() ? 0 : caps.maxWindowRectangles();
}

msaaDirtyRect()

const SkIRect & GrRenderTargetProxy::msaaDirtyRect ( ) const

inline

Definition at line 112 of file GrRenderTargetProxy.h.

                                         {
        SkASSERT(this->requiresManualMSAAResolve());
        return fMSAADirtyRect;
    }

needsStencil()

int GrRenderTargetProxy::needsStencil ( ) const

inline

Definition at line 82 of file GrRenderTargetProxy.h.

{ return fNeedsStencil; }

numSamples()

int GrRenderTargetProxy::numSamples ( ) const

inline

Returns the number of samples/pixel in the color buffer (One if non-MSAA).

Definition at line 87 of file GrRenderTargetProxy.h.

{ return fSampleCnt; }

onUninstantiatedGpuMemorySize()

size_t GrRenderTargetProxy::onUninstantiatedGpuMemorySize ( ) const

overrideprivate

Definition at line 145 of file GrRenderTargetProxy.cpp.

                                                                {
    int colorSamplesPerPixel = this->numSamples();
    if (colorSamplesPerPixel > 1) {
        // Add one for the resolve buffer.
        ++colorSamplesPerPixel;
    }
 
    // TODO: do we have enough information to improve this worst case estimate?
    return GrSurface::ComputeSize(this->backendFormat(), this->dimensions(),
                                  colorSamplesPerPixel, skgpu::Mipmapped::kNo,
                                  !this->priv().isExact());
}

refsWrappedObjects()

bool GrRenderTargetProxy::refsWrappedObjects

(

)

const

Definition at line 158 of file GrRenderTargetProxy.cpp.

                                                   {
    if (!this->isInstantiated()) {
        return false;
    }
 
    GrSurface* surface = this->peekSurface();
    return surface->resourcePriv().refsWrappedObjects();
}

setNeedsStencil()

void GrRenderTargetProxy::setNeedsStencil ( )

inline

Definition at line 80 of file GrRenderTargetProxy.h.

{ fNeedsStencil = true; }

SkDEBUGCODE()

GrRenderTargetProxy::SkDEBUGCODE ( void onValidateSurface(const GrSurface *) override;  ) const

overrideprivate

supportsVkInputAttachment()

bool GrRenderTargetProxy::supportsVkInputAttachment ( ) const

inline

Definition at line 95 of file GrRenderTargetProxy.h.

                                           {
        return fSurfaceFlags & GrInternalSurfaceFlags::kVkRTSupportsInputAttachment;
    }

wrapsVkSecondaryCB()

bool GrRenderTargetProxy::wrapsVkSecondaryCB ( ) const

inline

Definition at line 93 of file GrRenderTargetProxy.h.

{ return fWrapsVkSecondaryCB == WrapsVkSecondaryCB::kYes; }

Friends And Related Symbol Documentation

GrProxyProvider

friend class GrProxyProvider

friend

Definition at line 135 of file GrRenderTargetProxy.h.

GrVkSecondaryCBDrawContext

friend class GrVkSecondaryCBDrawContext

friend

Definition at line 136 of file GrRenderTargetProxy.h.

---

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

• third_party/skia/src/gpu/ganesh/GrRenderTargetProxy.h
• third_party/skia/src/gpu/ganesh/GrRenderTargetProxy.cpp