Add optional sw generated path coverage mask caching

src/gpu/GrSWMaskHelper.h

 /*
  * Copyright 2012 Google Inc.
  *
  * Use of this source code is governed by a BSD-style license that can be
  * found in the LICENSE file.
  */
 
 #ifndef GrSWMaskHelper_DEFINED
 #define GrSWMaskHelper_DEFINED
 
+#include "GrColor.h"
+#include "GrTextureProvider.h"
 #include "SkAutoPixmapStorage.h"
-#include "GrColor.h"
 #include "SkBitmap.h"
 #include "SkDraw.h"
 #include "SkMatrix.h"
 #include "SkRasterClip.h"
 #include "SkRegion.h"
 #include "SkTypes.h"
 
 class GrClip;
 class GrPaint;
 class GrShape;
@@ skipping 36 matching lines @@
     void toTexture(GrTexture* texture);
 
     // Convert mask generation results to a signed distance field
     void toSDF(unsigned char* sdf);
 
     // Reset the internal bitmap
     void clear(uint8_t alpha) {
         fPixels.erase(SkColorSetARGB(alpha, 0xFF, 0xFF, 0xFF));
     }
 
+
+    enum class TextureType {
+        kExactFit,
+        kApproximateFit
+    };
+
     // Canonical usage utility that draws a single path and uploads it
     // to the GPU. The result is returned.
     static GrTexture* DrawShapeMaskToTexture(GrTextureProvider*,
                                              const GrShape&,
                                              const SkIRect& resultBounds,
                                              bool antiAlias,
+                                             TextureType,
                                              const SkMatrix* matrix);
 
-    // This utility routine is used to add a shape's mask to some other draw.
-    // The GrClipStackClip uses it to accumulate clip masks while the
-    // GrSoftwarePathRenderer uses it to fulfill a drawPath call.
-    // It draws with "texture" as a path mask into "target" using "rect" as
-    // geometry and the current drawState. The current drawState is altered to
-    // accommodate the mask.
-    // Note that this method assumes that the GrPaint::kTotalStages slot in
-    // the draw state can be used to hold the mask texture stage.
-    // This method is really only intended to be used with the
-    // output of DrawPathMaskToTexture.
+    // This utility draws a path mask generated by DrawShapeMaskToTexture using a provided paint.
+    // The rectangle is drawn in device space. The 'viewMatrix' will be used to ensure the correct
+    // local coords are provided to any fragment processors in the paint.
     static void DrawToTargetWithShapeMask(GrTexture* texture,
                                           GrDrawContext*,
                                           const GrPaint& paint,
                                           const GrUserStencilSettings& userStencilSettings,
                                           const GrClip&,
                                           const SkMatrix& viewMatrix,
-                                          const SkIRect& rect);
+                                          const SkIPoint& textureOriginInDeviceSpace,
+                                          const SkIRect& deviceSpaceRectToDraw);
 
 private:
     // Helper function to get a scratch texture suitable for capturing the
     // result (i.e., right size & format)
-    GrTexture* createTexture();
+    GrTexture* createTexture(TextureType);
 
     GrTextureProvider*  fTexProvider;
     SkMatrix            fMatrix;
     SkAutoPixmapStorage fPixels;
     SkDraw              fDraw;
     SkRasterClip        fRasterClip;
 
     typedef SkNoncopyable INHERITED;
 };
 
 #endif // GrSWMaskHelper_DEFINED