GrDeferredProxyUploader Class Reference

#include <GrDeferredProxyUploader.h>

Inheritance diagram for GrDeferredProxyUploader:

Public Member Functions
	GrDeferredProxyUploader ()
virtual	~GrDeferredProxyUploader ()
void	scheduleUpload (GrOpFlushState *flushState, GrTextureProxy *proxy)
void	signalAndFreeData ()
SkAutoPixmapStorage *	getPixels ()
Public Member Functions inherited from SkNoncopyable
	SkNoncopyable ()=default
	SkNoncopyable (SkNoncopyable &&)=default
SkNoncopyable &	operator= (SkNoncopyable &&)=default

Protected Member Functions
void	wait ()

Private Member Functions
virtual void	freeData ()

Detailed Description

GrDeferredProxyUploader assists with threaded generation of textures. Currently used by both software clip masks, and the software path renderer. The calling code typically needs to store some additional data (T) for use on the worker thread. GrTDeferredProxyUploader allows storing such data. The common flow is:

1) A GrTDeferredProxyUploader is created, with some payload (eg an SkPath to draw). The uploader is owned by the proxy that it's going to populate. 2) A task is created with a pointer to the uploader. A worker thread executes that task, using the payload data to allocate and fill in the fPixels pixmap. 3) The worker thread calls signalAndFreeData(), which notifies the main thread that the pixmap is ready, and then deletes the payload data (which is no longer needed). 4) In parallel to 2-3, on the main thread... Some op is created that refers to the proxy. When that op is added to an op list, the op list retains a pointer to the "deferred" proxies. 5) At flush time, the op list ensures that the deferred proxies are instantiated, then calls scheduleUpload on those proxies, which calls scheduleUpload on the uploader (below). 6) scheduleUpload defers the upload even further, by adding an ASAPUpload to the flush. 7) When the ASAP upload happens, we wait to make sure that the pixels are marked ready (from step #3 on the worker thread). Then we perform the actual upload to the texture. Finally, we call resetDeferredUploader, which deletes the uploader object, causing fPixels to be freed.

Definition at line 40 of file GrDeferredProxyUploader.h.

Constructor & Destructor Documentation

GrDeferredProxyUploader()

GrDeferredProxyUploader::GrDeferredProxyUploader ( )

inline

Definition at line 42 of file GrDeferredProxyUploader.h.

: fScheduledUpload(false), fWaited(false) {}

~GrDeferredProxyUploader()

virtual GrDeferredProxyUploader::~GrDeferredProxyUploader ( )

inlinevirtual

Definition at line 44 of file GrDeferredProxyUploader.h.

                                       {
        // In normal usage (i.e., through GrTDeferredProxyUploader) this will be redundant
        this->wait();
    }

Member Function Documentation

freeData()

virtual void GrDeferredProxyUploader::freeData ( )

inlineprivatevirtual

Reimplemented in GrTDeferredProxyUploader< T >.

Definition at line 90 of file GrDeferredProxyUploader.h.

{}

getPixels()

SkAutoPixmapStorage * GrDeferredProxyUploader::getPixels ( )

inline

Definition at line 79 of file GrDeferredProxyUploader.h.

{ return &fPixels; }

scheduleUpload()

void GrDeferredProxyUploader::scheduleUpload ( GrOpFlushState *  flushState, GrTextureProxy *  proxy  )

inline

Definition at line 49 of file GrDeferredProxyUploader.h.

                                                                           {
        if (fScheduledUpload) {
            // Multiple references to the owning proxy may have caused us to already execute
            return;
        }
 
        auto uploadMask = [this, proxy](GrDeferredTextureUploadWritePixelsFn& writePixelsFn) {
            this->wait();
            GrColorType pixelColorType = SkColorTypeToGrColorType(this->fPixels.info().colorType());
            // If the worker thread was unable to allocate pixels, this check will fail, and we'll
            // end up drawing with an uninitialized mask texture, but at least we won't crash.
            if (this->fPixels.addr()) {
                writePixelsFn(proxy,
                              SkIRect::MakeSize(fPixels.dimensions()),
                              pixelColorType,
                              this->fPixels.addr(),
                              this->fPixels.rowBytes());
            }
            // Upload has finished, so tell the proxy to release this GrDeferredProxyUploader
            proxy->texPriv().resetDeferredUploader();
        };
        flushState->addASAPUpload(std::move(uploadMask));
        fScheduledUpload = true;
    }

signalAndFreeData()

void GrDeferredProxyUploader::signalAndFreeData ( )

inline

Definition at line 74 of file GrDeferredProxyUploader.h.

                             {
        this->freeData();
        fPixelsReady.signal();
    }

wait()

void GrDeferredProxyUploader::wait ( )

inlineprotected

Definition at line 82 of file GrDeferredProxyUploader.h.

                {
        if (!fWaited) {
            fPixelsReady.wait();
            fWaited = true;
        }
    }

---

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

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