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