robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2012 Google Inc. |
| 3 | * |
| 4 | * Use of this source code is governed by a BSD-style license that can be |
| 5 | * found in the LICENSE file. |
| 6 | */ |
| 7 | |
| 8 | #ifndef GrSWMaskHelper_DEFINED |
| 9 | #define GrSWMaskHelper_DEFINED |
| 10 | |
| 11 | #include "GrColor.h" |
commit-bot@chromium.org | a0b4028 | 2013-09-18 13:00:55 +0000 | [diff] [blame] | 12 | #include "GrDrawState.h" |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 13 | #include "SkBitmap.h" |
| 14 | #include "SkDraw.h" |
commit-bot@chromium.org | a0b4028 | 2013-09-18 13:00:55 +0000 | [diff] [blame] | 15 | #include "SkMatrix.h" |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 16 | #include "SkRasterClip.h" |
| 17 | #include "SkRegion.h" |
krajcevski | 25a67bc | 2014-07-29 11:44:26 -0700 | [diff] [blame] | 18 | #include "SkTextureCompressor.h" |
commit-bot@chromium.org | a0b4028 | 2013-09-18 13:00:55 +0000 | [diff] [blame] | 19 | #include "SkTypes.h" |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 20 | |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 21 | class GrContext; |
| 22 | class GrTexture; |
| 23 | class SkPath; |
sugoi@google.com | 5f74cf8 | 2012-12-17 21:16:45 +0000 | [diff] [blame] | 24 | class SkStrokeRec; |
robertphillips@google.com | 5dfb672 | 2012-07-09 16:32:28 +0000 | [diff] [blame] | 25 | class GrDrawTarget; |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 26 | |
| 27 | /** |
| 28 | * The GrSWMaskHelper helps generate clip masks using the software rendering |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 29 | * path. It is intended to be used as: |
| 30 | * |
| 31 | * GrSWMaskHelper helper(context); |
| 32 | * helper.init(...); |
| 33 | * |
| 34 | * draw one or more paths/rects specifying the required boolean ops |
| 35 | * |
| 36 | * toTexture(); // to get it from the internal bitmap to the GPU |
| 37 | * |
| 38 | * The result of this process will be the final mask (on the GPU) in the |
| 39 | * upper left hand corner of the texture. |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 40 | */ |
commit-bot@chromium.org | e3beb6b | 2014-04-07 19:34:38 +0000 | [diff] [blame] | 41 | class GrSWMaskHelper : SkNoncopyable { |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 42 | public: |
rmistry@google.com | d6176b0 | 2012-08-23 18:14:13 +0000 | [diff] [blame] | 43 | GrSWMaskHelper(GrContext* context) |
krajcevski | b8ccc2f | 2014-08-07 08:15:14 -0700 | [diff] [blame] | 44 | : fContext(context) |
| 45 | , fCompressionMode(kNone_CompressionMode) { |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 46 | } |
| 47 | |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 48 | // set up the internal state in preparation for draws. Since many masks |
rmistry@google.com | d6176b0 | 2012-08-23 18:14:13 +0000 | [diff] [blame] | 49 | // may be accumulated in the helper during creation, "resultBounds" |
| 50 | // allows the caller to specify the region of interest - to limit the |
krajcevski | 71614ac | 2014-08-13 10:36:18 -0700 | [diff] [blame] | 51 | // amount of work. allowCompression should be set to false if you plan on using |
| 52 | // your own texture to draw into, and not a scratch texture via getTexture(). |
| 53 | bool init(const SkIRect& resultBounds, const SkMatrix* matrix, bool allowCompression = true); |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 54 | |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 55 | // Draw a single rect into the accumulation bitmap using the specified op |
commit-bot@chromium.org | fd03d4a | 2013-07-17 21:39:42 +0000 | [diff] [blame] | 56 | void draw(const SkRect& rect, SkRegion::Op op, |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 57 | bool antiAlias, uint8_t alpha); |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 58 | |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 59 | // Draw a single path into the accumuation bitmap using the specified op |
sugoi@google.com | 5f74cf8 | 2012-12-17 21:16:45 +0000 | [diff] [blame] | 60 | void draw(const SkPath& path, const SkStrokeRec& stroke, SkRegion::Op op, |
sugoi@google.com | 12b4e27 | 2012-12-06 20:13:11 +0000 | [diff] [blame] | 61 | bool antiAlias, uint8_t alpha); |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 62 | |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 63 | // Move the mask generation results from the internal bitmap to the gpu. |
robertphillips@google.com | d92cf2e | 2013-07-19 18:13:02 +0000 | [diff] [blame] | 64 | void toTexture(GrTexture* texture); |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 65 | |
jvanverth | fa38a30 | 2014-10-06 05:59:05 -0700 | [diff] [blame] | 66 | // Convert mask generation results to a signed distance field |
| 67 | void toSDF(unsigned char* sdf); |
| 68 | |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 69 | // Reset the internal bitmap |
| 70 | void clear(uint8_t alpha) { |
| 71 | fBM.eraseColor(SkColorSetARGB(alpha, alpha, alpha, alpha)); |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 72 | } |
| 73 | |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 74 | // Canonical usage utility that draws a single path and uploads it |
jvanverth | fa38a30 | 2014-10-06 05:59:05 -0700 | [diff] [blame] | 75 | // to the GPU. The result is returned. |
robertphillips@google.com | 5dfb672 | 2012-07-09 16:32:28 +0000 | [diff] [blame] | 76 | static GrTexture* DrawPathMaskToTexture(GrContext* context, |
| 77 | const SkPath& path, |
sugoi@google.com | 5f74cf8 | 2012-12-17 21:16:45 +0000 | [diff] [blame] | 78 | const SkStrokeRec& stroke, |
commit-bot@chromium.org | fd03d4a | 2013-07-17 21:39:42 +0000 | [diff] [blame] | 79 | const SkIRect& resultBounds, |
robertphillips@google.com | 5dfb672 | 2012-07-09 16:32:28 +0000 | [diff] [blame] | 80 | bool antiAlias, |
bsalomon@google.com | b9086a0 | 2012-11-01 18:02:54 +0000 | [diff] [blame] | 81 | SkMatrix* matrix); |
robertphillips@google.com | 5dfb672 | 2012-07-09 16:32:28 +0000 | [diff] [blame] | 82 | |
| 83 | // This utility routine is used to add a path's mask to some other draw. |
rmistry@google.com | d6176b0 | 2012-08-23 18:14:13 +0000 | [diff] [blame] | 84 | // The ClipMaskManager uses it to accumulate clip masks while the |
robertphillips@google.com | 5dfb672 | 2012-07-09 16:32:28 +0000 | [diff] [blame] | 85 | // GrSoftwarePathRenderer uses it to fulfill a drawPath call. |
rmistry@google.com | d6176b0 | 2012-08-23 18:14:13 +0000 | [diff] [blame] | 86 | // It draws with "texture" as a path mask into "target" using "rect" as |
robertphillips@google.com | 5dfb672 | 2012-07-09 16:32:28 +0000 | [diff] [blame] | 87 | // geometry and the current drawState. The current drawState is altered to |
| 88 | // accommodate the mask. |
rmistry@google.com | d6176b0 | 2012-08-23 18:14:13 +0000 | [diff] [blame] | 89 | // Note that this method assumes that the GrPaint::kTotalStages slot in |
robertphillips@google.com | 5dfb672 | 2012-07-09 16:32:28 +0000 | [diff] [blame] | 90 | // the draw state can be used to hold the mask texture stage. |
rmistry@google.com | d6176b0 | 2012-08-23 18:14:13 +0000 | [diff] [blame] | 91 | // This method is really only intended to be used with the |
robertphillips@google.com | 5dfb672 | 2012-07-09 16:32:28 +0000 | [diff] [blame] | 92 | // output of DrawPathMaskToTexture. |
| 93 | static void DrawToTargetWithPathMask(GrTexture* texture, |
| 94 | GrDrawTarget* target, |
commit-bot@chromium.org | fd03d4a | 2013-07-17 21:39:42 +0000 | [diff] [blame] | 95 | const SkIRect& rect); |
robertphillips@google.com | 366f1c6 | 2012-06-29 21:38:47 +0000 | [diff] [blame] | 96 | |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 97 | private: |
bsalomon | e305973 | 2014-10-14 11:47:22 -0700 | [diff] [blame^] | 98 | // Helper function to get a scratch texture suitable for capturing the |
| 99 | // result (i.e., right size & format) |
| 100 | GrTexture* createTexture(); |
| 101 | |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 102 | GrContext* fContext; |
bsalomon@google.com | b9086a0 | 2012-11-01 18:02:54 +0000 | [diff] [blame] | 103 | SkMatrix fMatrix; |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 104 | SkBitmap fBM; |
| 105 | SkDraw fDraw; |
| 106 | SkRasterClip fRasterClip; |
| 107 | |
krajcevski | b8ccc2f | 2014-08-07 08:15:14 -0700 | [diff] [blame] | 108 | // This enum says whether or not we should compress the mask: |
| 109 | // kNone_CompressionMode: compression is not supported on this device. |
| 110 | // kCompress_CompressionMode: compress the bitmap before it gets sent to the gpu |
| 111 | // kBlitter_CompressionMode: write to the bitmap using a special compressed blitter. |
| 112 | enum CompressionMode { |
| 113 | kNone_CompressionMode, |
| 114 | kCompress_CompressionMode, |
| 115 | kBlitter_CompressionMode, |
| 116 | } fCompressionMode; |
| 117 | |
| 118 | // This is the buffer into which we store our compressed data. This buffer is |
| 119 | // only allocated (non-null) if fCompressionMode is kBlitter_CompressionMode |
| 120 | SkAutoMalloc fCompressedBuffer; |
krajcevski | b3abe90 | 2014-07-30 13:08:11 -0700 | [diff] [blame] | 121 | |
| 122 | // This is the desired format within which to compress the |
krajcevski | b8ccc2f | 2014-08-07 08:15:14 -0700 | [diff] [blame] | 123 | // texture. This value is only valid if fCompressionMode is not kNone_CompressionMode. |
krajcevski | 25a67bc | 2014-07-29 11:44:26 -0700 | [diff] [blame] | 124 | SkTextureCompressor::Format fCompressedFormat; |
krajcevski | 25a67bc | 2014-07-29 11:44:26 -0700 | [diff] [blame] | 125 | |
krajcevski | fb4f5cb | 2014-06-12 09:20:38 -0700 | [diff] [blame] | 126 | // Actually sends the texture data to the GPU. This is called from |
| 127 | // toTexture with the data filled in depending on the texture config. |
| 128 | void sendTextureData(GrTexture *texture, const GrTextureDesc& desc, |
| 129 | const void *data, int rowbytes); |
| 130 | |
krajcevski | b577c55 | 2014-07-16 13:26:43 -0700 | [diff] [blame] | 131 | // Compresses the bitmap stored in fBM and sends the compressed data |
| 132 | // to the GPU to be stored in 'texture' using sendTextureData. |
| 133 | void compressTextureData(GrTexture *texture, const GrTextureDesc& desc); |
| 134 | |
commit-bot@chromium.org | a0b4028 | 2013-09-18 13:00:55 +0000 | [diff] [blame] | 135 | typedef SkNoncopyable INHERITED; |
robertphillips@google.com | 58b2021 | 2012-06-27 20:44:52 +0000 | [diff] [blame] | 136 | }; |
| 137 | |
robertphillips@google.com | fe65943 | 2012-06-28 01:01:53 +0000 | [diff] [blame] | 138 | #endif // GrSWMaskHelper_DEFINED |