GrRenderTask Class Reference

#include <GrRenderTask.h>

Inheritance diagram for GrRenderTask:

Public Member Functions
	GrRenderTask ()
	SkDEBUGCODE (~GrRenderTask() override;) void makeClosed(GrRecordingContext *)
void	prePrepare (GrRecordingContext *context)
void	prepare (GrOpFlushState *flushState)
bool	execute (GrOpFlushState *flushState)
virtual bool	requiresExplicitCleanup () const
virtual void	endFlush (GrDrawingManager *)
virtual void	disown (GrDrawingManager *)
bool	isClosed () const
void	makeSkippable ()
bool	isSkippable () const
bool	blocksReordering () const
void	addDependency (GrDrawingManager *, GrSurfaceProxy *dependedOn, skgpu::Mipmapped, GrTextureResolveManager, const GrCaps &caps)
void	addDependenciesFromOtherTask (GrRenderTask *otherTask)
SkSpan< GrRenderTask * >	dependencies ()
SkSpan< GrRenderTask * >	dependents ()
void	replaceDependency (const GrRenderTask *toReplace, GrRenderTask *replaceWith)
void	replaceDependent (const GrRenderTask *toReplace, GrRenderTask *replaceWith)
bool	dependsOn (const GrRenderTask *dependedOn) const
uint32_t	uniqueID () const
int	numTargets () const
GrSurfaceProxy *	target (int i) const
virtual skgpu::ganesh::OpsTask *	asOpsTask ()
bool	isUsed (GrSurfaceProxy *proxy) const
virtual void	gatherProxyIntervals (GrResourceAllocator *) const =0
bool	isInstantiated () const
	SK_DECLARE_INTERNAL_LLIST_INTERFACE (GrRenderTask)
Public Member Functions inherited from SkRefCntBase
	SkRefCntBase ()
virtual	~SkRefCntBase ()
bool	unique () const
void	ref () const
void	unref () const

Protected Types
enum class	ExpectedOutcome : bool { kTargetUnchanged , kTargetDirty }
enum	Flags {   kClosed_Flag = 0x01 , kDisowned_Flag = 0x02 , kSkippable_Flag = 0x04 , kAtlas_Flag = 0x08 ,   kBlocksReordering_Flag = 0x10 , kWasOutput_Flag = 0x20 , kTempMark_Flag = 0x40 }

Protected Member Functions
	SkDEBUGCODE (bool deferredProxiesAreInstantiated() const ;) void addTarget(GrDrawingManager *
void	addTarget (GrDrawingManager *dm, const GrSurfaceProxyView &view)
virtual ExpectedOutcome	onMakeClosed (GrRecordingContext *, SkIRect *targetUpdateBounds)=0
void	setFlag (uint32_t flag)
void	resetFlag (uint32_t flag)
bool	isSetFlag (uint32_t flag) const
void	setIndex (uint32_t index)
uint32_t	getIndex () const

Protected Attributes
	sk_sp< GrSurfaceProxy >
skia_private::STArray< 1, sk_sp< GrSurfaceProxy > >	fTargets
skia_private::TArray< GrTextureProxy *, true >	fDeferredProxies

Private Member Functions
virtual bool	onIsUsed (GrSurfaceProxy *) const =0
virtual void	onMakeSkippable ()
virtual void	onPrePrepare (GrRecordingContext *)
virtual void	onPrepare (GrOpFlushState *)
virtual bool	onExecute (GrOpFlushState *flushState)=0

Friends
class	GrDrawingManager
class	GrMockRenderTask

Detailed Description

Definition at line 31 of file GrRenderTask.h.

Member Enumeration Documentation

ExpectedOutcome

enum class GrRenderTask::ExpectedOutcome : bool

strongprotected

Enumerator
kTargetUnchanged
kTargetDirty

Definition at line 170 of file GrRenderTask.h.

                               : bool {
        kTargetUnchanged,
        kTargetDirty,
    };

Flags

enum GrRenderTask::Flags

protected

Enumerator
kClosed_Flag	This task can't accept any more dependencies.
kDisowned_Flag	This task is disowned by its GrDrawingManager.
kSkippable_Flag	This task is skippable.
kAtlas_Flag	This task is atlas.
kBlocksReordering_Flag	No task can be reordered with respect to this task.
kWasOutput_Flag	Flag for topological sorting.
kTempMark_Flag	Flag for topological sorting.

Definition at line 189 of file GrRenderTask.h.

               {
        kClosed_Flag           = 0x01,   //!< This task can't accept any more dependencies.
        kDisowned_Flag         = 0x02,   //!< This task is disowned by its GrDrawingManager.
        kSkippable_Flag        = 0x04,   //!< This task is skippable.
        kAtlas_Flag            = 0x08,   //!< This task is atlas.
        kBlocksReordering_Flag = 0x10,   //!< No task can be reordered with respect to this task.
 
        kWasOutput_Flag        = 0x20,   //!< Flag for topological sorting
        kTempMark_Flag         = 0x40,   //!< Flag for topological sorting
    };

Constructor & Destructor Documentation

GrRenderTask()

GrRenderTask::GrRenderTask

(

)

Definition at line 25 of file GrRenderTask.cpp.

        : fUniqueID(CreateUniqueID())
        , fFlags(0) {
}

Member Function Documentation

addDependenciesFromOtherTask()

void GrRenderTask::addDependenciesFromOtherTask

(

GrRenderTask *

otherTask

)

Definition at line 116 of file GrRenderTask.cpp.

                                                                       {
    SkASSERT(otherTask);
    for (GrRenderTask* task : otherTask->fDependencies) {
        // The task should not be adding a dependency to itself.
        SkASSERT(task != this);
        if (!this->dependsOn(task)) {
            this->addDependency(task);
        }
    }
}

addDependency()

void GrRenderTask::addDependency	(	GrDrawingManager *	drawingMgr,
		GrSurfaceProxy *	dependedOn,
		skgpu::Mipmapped	mipmapped,
		GrTextureResolveManager	textureResolveManager,
		const GrCaps &	caps
	)

Definition at line 128 of file GrRenderTask.cpp.

                                                     {
    // If it is still receiving dependencies, this GrRenderTask shouldn't be closed
    SkASSERT(!this->isClosed());
 
    GrRenderTask* dependedOnTask = drawingMgr->getLastRenderTask(dependedOn);
 
    if (dependedOnTask == this) {
        // self-read - presumably for dst reads. We don't need to do anything in this case. The
        // XferProcessor will detect what is happening and insert a texture barrier.
        SkASSERT(skgpu::Mipmapped::kNo == mipmapped);
        // We should never attempt a self-read on a surface that has a separate MSAA renderbuffer.
        SkASSERT(!dependedOn->requiresManualMSAAResolve());
        SkASSERT(!dependedOn->asTextureProxy() ||
                 !dependedOn->asTextureProxy()->texPriv().isDeferred());
        return;
    }
 
    bool alreadyDependent = false;
    if (dependedOnTask) {
        if (this->dependsOn(dependedOnTask) || fTextureResolveTask == dependedOnTask) {
            alreadyDependent = true;
            dependedOnTask = nullptr;  // don't add duplicate dependencies
        } else if (!dependedOnTask->isSetFlag(kAtlas_Flag)) {
            // We are closing 'dependedOnTask' here bc the current contents of it are what 'this'
            // renderTask depends on. We need a break in 'dependedOnTask' so that the usage of
            // that state has a chance to execute.
            dependedOnTask->makeClosed(drawingMgr->getContext());
        }
    }
 
    auto resolveFlags = GrSurfaceProxy::ResolveFlags::kNone;
 
    if (dependedOn->requiresManualMSAAResolve()) {
        auto* renderTargetProxy = dependedOn->asRenderTargetProxy();
        SkASSERT(renderTargetProxy);
        if (renderTargetProxy->isMSAADirty()) {
            resolveFlags |= GrSurfaceProxy::ResolveFlags::kMSAA;
        }
    }
 
    GrTextureProxy* textureProxy = dependedOn->asTextureProxy();
    if (skgpu::Mipmapped::kYes == mipmapped) {
        SkASSERT(textureProxy);
        if (skgpu::Mipmapped::kYes != textureProxy->mipmapped()) {
            // There are some cases where we might be given a non-mipmapped texture with a mipmap
            // filter. See skbug.com/7094.
            mipmapped = skgpu::Mipmapped::kNo;
        } else if (textureProxy->mipmapsAreDirty()) {
            resolveFlags |= GrSurfaceProxy::ResolveFlags::kMipMaps;
        }
    }
 
    // Does this proxy have msaa to resolve and/or mipmaps to regenerate?
    if (GrSurfaceProxy::ResolveFlags::kNone != resolveFlags) {
        if (!fTextureResolveTask) {
            fTextureResolveTask = textureResolveManager.newTextureResolveRenderTask(caps);
        }
        fTextureResolveTask->addProxy(drawingMgr, sk_ref_sp(dependedOn), resolveFlags, caps);
 
        // addProxy() should have closed the texture proxy's previous task.
        SkASSERT(!dependedOnTask || dependedOnTask->isClosed());
        SkASSERT(drawingMgr->getLastRenderTask(dependedOn) == fTextureResolveTask);
 
#ifdef SK_DEBUG
        // addProxy() should have called addDependency (in this instance, recursively) on
        // fTextureResolveTask.
        if (dependedOnTask) {
            SkASSERT(fTextureResolveTask->dependsOn(dependedOnTask));
        }
        if (textureProxy && textureProxy->texPriv().isDeferred()) {
            SkASSERT(fTextureResolveTask->fDeferredProxies.back() == textureProxy);
        }
 
        // The GrTextureResolveRenderTask factory should have also marked the proxy clean, set the
        // last renderTask on the textureProxy to textureResolveTask, and closed textureResolveTask.
        if (resolveFlags & GrSurfaceProxy::ResolveFlags::kMSAA) {
            if (GrRenderTargetProxy* renderTargetProxy = dependedOn->asRenderTargetProxy()) {
                SkASSERT(!renderTargetProxy->isMSAADirty());
            }
        }
        if (textureProxy && (resolveFlags & GrSurfaceProxy::ResolveFlags::kMipMaps)) {
            SkASSERT(!textureProxy->mipmapsAreDirty());
        }
        SkASSERT(drawingMgr->getLastRenderTask(dependedOn) == fTextureResolveTask);
#endif
        return;
    }
 
    if (textureProxy && textureProxy->texPriv().isDeferred()) {
        if (alreadyDependent) {
            SkASSERT(std::find(fDeferredProxies.begin(), fDeferredProxies.end(), textureProxy) !=
                     fDeferredProxies.end());
        } else {
            fDeferredProxies.push_back(textureProxy);
        }
    }
 
    if (dependedOnTask) {
        this->addDependency(dependedOnTask);
    }
}

addTarget()

void GrRenderTask::addTarget ( GrDrawingManager *  dm, const GrSurfaceProxyView &  view  )

inlineprotected

Definition at line 166 of file GrRenderTask.h.

                                                                         {
        this->addTarget(dm, view.refProxy());
    }

asOpsTask()

virtual skgpu::ganesh::OpsTask * GrRenderTask::asOpsTask ( )

inlinevirtual

Reimplemented in skgpu::ganesh::OpsTask.

Definition at line 109 of file GrRenderTask.h.

{ return nullptr; }

blocksReordering()

bool GrRenderTask::blocksReordering ( ) const

inline

If true no other task should be reordered relative to this task.

Definition at line 73 of file GrRenderTask.h.

{ return this->isSetFlag(kBlocksReordering_Flag); }

dependencies()

SkSpan< GrRenderTask * > GrRenderTask::dependencies ( )

inline

Definition at line 90 of file GrRenderTask.h.

{ return SkSpan(fDependencies); }

dependents()

SkSpan< GrRenderTask * > GrRenderTask::dependents ( )

inline

Definition at line 91 of file GrRenderTask.h.

{ return SkSpan(fDependents); }

dependsOn()

bool GrRenderTask::dependsOn

(

const GrRenderTask *

dependedOn

)

const

Definition at line 254 of file GrRenderTask.cpp.

                                                                 {
    for (int i = 0; i < fDependencies.size(); ++i) {
        if (fDependencies[i] == dependedOn) {
            return true;
        }
    }
 
    return false;
}

disown()

void GrRenderTask::disown ( GrDrawingManager *  drawingMgr )

virtual

Reimplemented in GrDDLTask.

Definition at line 30 of file GrRenderTask.cpp.

                                                      {
    SkASSERT(!fDrawingMgr || drawingMgr == fDrawingMgr);
    SkASSERT(this->isClosed());
    if (this->isSetFlag(kDisowned_Flag)) {
        return;
    }
    SkDEBUGCODE(fDrawingMgr = nullptr);
    this->setFlag(kDisowned_Flag);
 
    for (const sk_sp<GrSurfaceProxy>& target : fTargets) {
        if (this == drawingMgr->getLastRenderTask(target.get())) {
            drawingMgr->setLastRenderTask(target.get(), nullptr);
        }
    }
}

endFlush()

virtual void GrRenderTask::endFlush ( GrDrawingManager *  )

inlinevirtual

Reimplemented in GrDDLTask, and skgpu::ganesh::OpsTask.

Definition at line 49 of file GrRenderTask.h.

{}

execute()

bool GrRenderTask::execute ( GrOpFlushState *  flushState )

inline

Definition at line 42 of file GrRenderTask.h.

{ return this->onExecute(flushState); }

gatherProxyIntervals()

virtual void GrRenderTask::gatherProxyIntervals ( GrResourceAllocator *  ) const

pure virtual

Implemented in GrMockRenderTask.

getIndex()

uint32_t GrRenderTask::getIndex ( ) const

inlineprotected

Definition at line 218 of file GrRenderTask.h.

                              {
        SkASSERT(this->isSetFlag(kWasOutput_Flag));
        return fFlags >> 7;
    }

isClosed()

bool GrRenderTask::isClosed ( ) const

inline

Definition at line 56 of file GrRenderTask.h.

{ return this->isSetFlag(kClosed_Flag); }

isInstantiated()

bool GrRenderTask::isInstantiated

(

)

const

Definition at line 289 of file GrRenderTask.cpp.

                                        {
    for (const sk_sp<GrSurfaceProxy>& target : fTargets) {
        GrSurfaceProxy* proxy = target.get();
        if (!proxy->isInstantiated()) {
            return false;
        }
 
        GrSurface* surface = proxy->peekSurface();
        if (surface->wasDestroyed()) {
            return false;
        }
    }
 
    return true;
}

isSetFlag()

bool GrRenderTask::isSetFlag ( uint32_t  flag ) const

inlineprotected

Definition at line 208 of file GrRenderTask.h.

                                        {
        return SkToBool(fFlags & flag);
    }

isSkippable()

bool GrRenderTask::isSkippable ( ) const

inline

Definition at line 70 of file GrRenderTask.h.

{ return this->isSetFlag(kSkippable_Flag); }

isUsed()

bool GrRenderTask::isUsed ( GrSurfaceProxy *  proxy ) const

inline

Definition at line 135 of file GrRenderTask.h.

                                             {
        for (const sk_sp<GrSurfaceProxy>& target : fTargets) {
            if (target.get() == proxy) {
                return true;
            }
        }
 
        return this->onIsUsed(proxy);
    }

makeSkippable()

void GrRenderTask::makeSkippable

(

)

Make this task skippable. This must be used purely for optimization purposes at this point as not all tasks will actually skip their work. It would be better if we could detect tasks that can be skipped automatically. We'd need to support minimal flushes (i.e., only flush that which is required for SkSurfaces/SkImages) and the ability to detect "orphaned tasks" and clean them out from the DAG so they don't indefinitely accumulate. Finally, we'd probably have to track whether a proxy's backing store was imported or ever exported to the client in case the client is doing direct reads outside of Skia and thus may require tasks targeting the proxy to execute even if our DAG contains no reads.

Definition at line 46 of file GrRenderTask.cpp.

                                 {
    SkASSERT(this->isClosed());
    if (!this->isSkippable()) {
        this->setFlag(kSkippable_Flag);
        this->onMakeSkippable();
    }
}

numTargets()

int GrRenderTask::numTargets ( ) const

inline

Definition at line 103 of file GrRenderTask.h.

{ return fTargets.size(); }

onExecute()

virtual bool GrRenderTask::onExecute ( GrOpFlushState *  flushState )

privatepure virtual

Implemented in GrMockRenderTask, and skgpu::ganesh::OpsTask.

onIsUsed()

virtual bool GrRenderTask::onIsUsed ( GrSurfaceProxy *  ) const

privatepure virtual

Implemented in GrMockRenderTask.

onMakeClosed()

virtual ExpectedOutcome GrRenderTask::onMakeClosed ( GrRecordingContext *  , SkIRect *  targetUpdateBounds  )

protectedpure virtual

Implemented in GrMockRenderTask, and skgpu::ganesh::OpsTask.

onMakeSkippable()

virtual void GrRenderTask::onMakeSkippable ( )

inlineprivatevirtual

Definition at line 267 of file GrRenderTask.h.

{}

onPrepare()

virtual void GrRenderTask::onPrepare ( GrOpFlushState *  )

inlineprivatevirtual

Reimplemented in skgpu::ganesh::OpsTask.

Definition at line 269 of file GrRenderTask.h.

{} // OpsTask and GrDDLTask override this

onPrePrepare()

virtual void GrRenderTask::onPrePrepare ( GrRecordingContext *  )

inlineprivatevirtual

Reimplemented in skgpu::ganesh::OpsTask.

Definition at line 268 of file GrRenderTask.h.

{} // Only OpsTask currently overrides this

prepare()

void GrRenderTask::prepare

(

GrOpFlushState *

flushState

)

Definition at line 97 of file GrRenderTask.cpp.

                                                     {
    for (int i = 0; i < fDeferredProxies.size(); ++i) {
        fDeferredProxies[i]->texPriv().scheduleUpload(flushState);
    }
 
    this->onPrepare(flushState);
}

prePrepare()

void GrRenderTask::prePrepare ( GrRecordingContext *  context )

inline

Definition at line 38 of file GrRenderTask.h.

{ this->onPrePrepare(context); }

replaceDependency()

void GrRenderTask::replaceDependency	(	const GrRenderTask *	toReplace,
		GrRenderTask *	replaceWith
	)

Definition at line 234 of file GrRenderTask.cpp.

                                                                                             {
    for (auto& target : fDependencies) {
        if (target == toReplace) {
            target = replaceWith;
            replaceWith->fDependents.push_back(this);
            break;
        }
    }
}

replaceDependent()

void GrRenderTask::replaceDependent	(	const GrRenderTask *	toReplace,
		GrRenderTask *	replaceWith
	)

Definition at line 244 of file GrRenderTask.cpp.

                                                                                            {
    for (auto& target : fDependents) {
        if (target == toReplace) {
            target = replaceWith;
            replaceWith->fDependencies.push_back(this);
            break;
        }
    }
}

requiresExplicitCleanup()

virtual bool GrRenderTask::requiresExplicitCleanup ( ) const

inlinevirtual

Reimplemented in GrDDLTask.

Definition at line 44 of file GrRenderTask.h.

{ return false; }

resetFlag()

void GrRenderTask::resetFlag ( uint32_t  flag )

inlineprotected

Definition at line 204 of file GrRenderTask.h.

                                  {
        fFlags &= ~flag;
    }

setFlag()

void GrRenderTask::setFlag ( uint32_t  flag )

inlineprotected

Definition at line 200 of file GrRenderTask.h.

                                {
        fFlags |= flag;
    }

setIndex()

void GrRenderTask::setIndex ( uint32_t  index )

inlineprotected

Definition at line 212 of file GrRenderTask.h.

                                  {
        SkASSERT(!this->isSetFlag(kWasOutput_Flag));
        SkASSERT(index < (1 << 25));
        fFlags |= index << 7;
    }

SK_DECLARE_INTERNAL_LLIST_INTERFACE()

GrRenderTask::SK_DECLARE_INTERNAL_LLIST_INTERFACE

(

GrRenderTask

)

SkDEBUGCODE() [1/2]

GrRenderTask::SkDEBUGCODE ( bool deferredProxiesAreInstantiated() const ;  )

protected

SkDEBUGCODE() [2/2]

GrRenderTask::SkDEBUGCODE

(

~GrRenderTask() override;

)

target()

GrSurfaceProxy * GrRenderTask::target ( int  i ) const

inline

Definition at line 104 of file GrRenderTask.h.

{ return fTargets[i].get(); }

uniqueID()

uint32_t GrRenderTask::uniqueID ( ) const

inline

Definition at line 102 of file GrRenderTask.h.

{ return fUniqueID; }

Friends And Related Function Documentation

GrDrawingManager

friend class GrDrawingManager

friend

Definition at line 225 of file GrRenderTask.h.

GrMockRenderTask

friend class GrMockRenderTask

friend

Definition at line 226 of file GrRenderTask.h.

Member Data Documentation

fDeferredProxies

skia_private::TArray<GrTextureProxy*, true> GrRenderTask::fDeferredProxies

protected

Definition at line 187 of file GrRenderTask.h.

fTargets

skia_private::STArray<1, sk_sp<GrSurfaceProxy> > GrRenderTask::fTargets

protected

Definition at line 182 of file GrRenderTask.h.

sk_sp< GrSurfaceProxy >

GrRenderTask::sk_sp< GrSurfaceProxy >

protected

Definition at line 159 of file GrRenderTask.h.

---

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

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