Expose GrRecordingContext accessor on SkCanvas and SkSurface

We'll need this if we're ever to get rid of GrContext.

It is pulled out of:

https://skia-review.googlesource.com/c/skia/+/296704 (Downgrade GpuGMs to only receiving a GrRecordingContext)

Bug: skia:10441
Change-Id: I964b5caf3e947afbfc7d441a8e17ad298961d8f3
Reviewed-on: https://skia-review.googlesource.com/c/skia/+/299295
Commit-Queue: Robert Phillips <robertphillips@google.com>
Reviewed-by: Brian Salomon <bsalomon@google.com>

Author: rphilli

include/core/SkCanvas.h

@@ -33,6 +33,7 @@
 #include <vector>
 
 class GrContext;
+class GrRecordingContext;
 class GrRenderTargetContext;
 class SkBaseDevice;
 class SkBitmap;
@@ -289,6 +290,11 @@ class SK_API SkCanvas {
     */
     virtual GrContext* getGrContext();
 
+    /**
+     * Experimental. SkCanvases can actually only guarantee a GrRecordingContext.
+     */
+    virtual GrRecordingContext* recordingContext();
+
     /** Sometimes a canvas is owned by a surface. If it is, getSurface() will return a bare
      *  pointer to that surface, else this will return nullptr.
      */

include/core/SkSurface.h

@@ -531,6 +531,11 @@ class SK_API SkSurface : public SkRefCnt {
     */
     GrContext* getContext();
 
+    /**
+     * Experimental. SkSurfaces can actually only guarantee a GrRecordingContext.
+     */
+    GrRecordingContext* recordingContext();
+
     enum BackendHandleAccess {
         kFlushRead_BackendHandleAccess,    //!< back-end object is readable
         kFlushWrite_BackendHandleAccess,   //!< back-end object is writable

src/core/SkCanvas.cpp

@@ -1865,6 +1865,11 @@ GrContext* SkCanvas::getGrContext() {
     return device ? device->context() : nullptr;
 }
 
+GrRecordingContext* SkCanvas::recordingContext() {
+    SkBaseDevice* device = this->getTopDevice();
+    return device ? device->recordingContext() : nullptr;
+}
+
 void SkCanvas::drawDRRect(const SkRRect& outer, const SkRRect& inner,
                           const SkPaint& paint) {
     TRACE_EVENT0("skia", TRACE_FUNC);

src/core/SkDevice.h

@@ -317,6 +317,7 @@ class SkBaseDevice : public SkRefCnt, public SkMatrixProvider {
     ///////////////////////////////////////////////////////////////////////////
 
     virtual GrContext* context() const { return nullptr; }
+    virtual GrRecordingContext* recordingContext() const { return nullptr; }
 
     virtual sk_sp<SkSurface> makeSurface(const SkImageInfo&, const SkSurfaceProps&);
     virtual bool onPeekPixels(SkPixmap*) { return false; }

src/gpu/SkGpuDevice.h

@@ -62,6 +62,7 @@ class SkGpuDevice : public SkClipStackDevice {
     ~SkGpuDevice() override {}
 
     GrContext* context() const override { return fContext.get(); }
+    GrRecordingContext* recordingContext() const override { return fContext.get(); }
 
     // set all pixels to 0
     void clearAll();

src/image/SkSurface.cpp

@@ -76,6 +76,10 @@ GrContext* SkSurface_Base::onGetContext() {
     return nullptr;
 }
 
+GrRecordingContext* SkSurface_Base::onGetRecordingContext() {
+    return nullptr;
+}
+
 GrBackendTexture SkSurface_Base::onGetBackendTexture(BackendHandleAccess) {
     return GrBackendTexture(); // invalid
 }
@@ -332,6 +336,10 @@ GrContext* SkSurface::getContext() {
     return asSB(this)->onGetContext();
 }
 
+GrRecordingContext* SkSurface::recordingContext() {
+    return asSB(this)->onGetRecordingContext();
+}
+
 GrBackendTexture SkSurface::getBackendTexture(BackendHandleAccess access) {
     return asSB(this)->onGetBackendTexture(access);
 }

src/image/SkSurface_Base.h

@@ -21,6 +21,7 @@ class SkSurface_Base : public SkSurface {
     virtual ~SkSurface_Base();
 
     virtual GrContext* onGetContext();
+    virtual GrRecordingContext* onGetRecordingContext();
 
     virtual GrBackendTexture onGetBackendTexture(BackendHandleAccess);
     virtual GrBackendRenderTarget onGetBackendRenderTarget(BackendHandleAccess);

src/image/SkSurface_Gpu.cpp

@@ -43,6 +43,10 @@ GrContext* SkSurface_Gpu::onGetContext() {
     return fDevice->context();
 }
 
+GrRecordingContext* SkSurface_Gpu::onGetRecordingContext() {
+    return fDevice->recordingContext();
+}
+
 static GrRenderTarget* prepare_rt_for_external_access(SkSurface_Gpu* surface,
                                                       SkSurface::BackendHandleAccess access) {
     switch (access) {

src/image/SkSurface_Gpu.h

@@ -26,6 +26,7 @@ class SkSurface_Gpu : public SkSurface_Base {
                                                     std::unique_ptr<GrRenderTargetContext>);
 
     GrContext* onGetContext() override;
+    GrRecordingContext* onGetRecordingContext() override;
 
     GrBackendTexture onGetBackendTexture(BackendHandleAccess) override;
     GrBackendRenderTarget onGetBackendRenderTarget(BackendHandleAccess) override;