reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 1 | /* |
| 2 | * Copyright 2011 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 SkImageFilter_DEFINED |
| 9 | #define SkImageFilter_DEFINED |
| 10 | |
| 11 | #include "SkFlattenable.h" |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 12 | #include "SkMatrix.h" |
senorblanco@chromium.org | 194d775 | 2013-07-24 22:19:24 +0000 | [diff] [blame] | 13 | #include "SkRect.h" |
reed | b959ec7 | 2014-07-17 07:03:09 -0700 | [diff] [blame] | 14 | #include "SkTemplates.h" |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 15 | |
reed@google.com | 15356a6 | 2011-11-03 19:29:08 +0000 | [diff] [blame] | 16 | class SkBitmap; |
senorblanco@chromium.org | 8d21f6c | 2012-10-12 19:14:06 +0000 | [diff] [blame] | 17 | class SkColorFilter; |
robertphillips@google.com | 1f2f338 | 2013-08-29 11:54:56 +0000 | [diff] [blame] | 18 | class SkBaseDevice; |
djsollen@google.com | c73dd5c | 2012-08-07 15:54:32 +0000 | [diff] [blame] | 19 | struct SkIPoint; |
bsalomon | 97b9ab7 | 2014-07-08 06:52:35 -0700 | [diff] [blame] | 20 | class GrEffect; |
tomhudson@google.com | d0c1a06 | 2012-07-12 17:23:52 +0000 | [diff] [blame] | 21 | class GrTexture; |
reed@google.com | 15356a6 | 2011-11-03 19:29:08 +0000 | [diff] [blame] | 22 | |
| 23 | /** |
reed@google.com | 15356a6 | 2011-11-03 19:29:08 +0000 | [diff] [blame] | 24 | * Base class for image filters. If one is installed in the paint, then |
| 25 | * all drawing occurs as usual, but it is as if the drawing happened into an |
| 26 | * offscreen (before the xfermode is applied). This offscreen bitmap will |
| 27 | * then be handed to the imagefilter, who in turn creates a new bitmap which |
| 28 | * is what will finally be drawn to the device (using the original xfermode). |
reed@google.com | 15356a6 | 2011-11-03 19:29:08 +0000 | [diff] [blame] | 29 | */ |
senorblanco@chromium.org | 54e01b2 | 2011-11-16 18:20:47 +0000 | [diff] [blame] | 30 | class SK_API SkImageFilter : public SkFlattenable { |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 31 | public: |
robertphillips@google.com | 0456e0b | 2012-06-27 14:03:26 +0000 | [diff] [blame] | 32 | SK_DECLARE_INST_COUNT(SkImageFilter) |
| 33 | |
senorblanco@chromium.org | 3f1f2a3 | 2013-10-16 18:07:48 +0000 | [diff] [blame] | 34 | class CropRect { |
| 35 | public: |
senorblanco@chromium.org | b295fb6 | 2013-10-10 13:51:19 +0000 | [diff] [blame] | 36 | enum CropEdge { |
| 37 | kHasLeft_CropEdge = 0x01, |
| 38 | kHasTop_CropEdge = 0x02, |
| 39 | kHasRight_CropEdge = 0x04, |
| 40 | kHasBottom_CropEdge = 0x08, |
| 41 | kHasAll_CropEdge = 0x0F, |
| 42 | }; |
| 43 | CropRect() {} |
| 44 | explicit CropRect(const SkRect& rect, uint32_t flags = kHasAll_CropEdge) : fRect(rect), fFlags(flags) {} |
senorblanco@chromium.org | 3f1f2a3 | 2013-10-16 18:07:48 +0000 | [diff] [blame] | 45 | uint32_t flags() const { return fFlags; } |
| 46 | const SkRect& rect() const { return fRect; } |
| 47 | private: |
| 48 | SkRect fRect; |
| 49 | uint32_t fFlags; |
senorblanco@chromium.org | b295fb6 | 2013-10-10 13:51:19 +0000 | [diff] [blame] | 50 | }; |
senorblanco@chromium.org | b295fb6 | 2013-10-10 13:51:19 +0000 | [diff] [blame] | 51 | |
senorblanco | 55b6d8b | 2014-07-30 11:26:46 -0700 | [diff] [blame] | 52 | // This cache maps from (filter's unique ID + CTM + clipBounds + src bitmap generation ID) to |
| 53 | // (result, offset). |
senorblanco | be129b2 | 2014-08-08 07:14:35 -0700 | [diff] [blame] | 54 | class Cache : public SkRefCnt { |
senorblanco | 55b6d8b | 2014-07-30 11:26:46 -0700 | [diff] [blame] | 55 | public: |
| 56 | struct Key; |
senorblanco | be129b2 | 2014-08-08 07:14:35 -0700 | [diff] [blame] | 57 | virtual ~Cache() {} |
| 58 | static Cache* Create(size_t maxBytes); |
| 59 | static Cache* Get(); |
senorblanco | 55b6d8b | 2014-07-30 11:26:46 -0700 | [diff] [blame] | 60 | virtual bool get(const Key& key, SkBitmap* result, SkIPoint* offset) const = 0; |
| 61 | virtual void set(const Key& key, const SkBitmap& result, const SkIPoint& offset) = 0; |
| 62 | }; |
| 63 | |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 64 | class Context { |
| 65 | public: |
senorblanco | be129b2 | 2014-08-08 07:14:35 -0700 | [diff] [blame] | 66 | Context(const SkMatrix& ctm, const SkIRect& clipBounds, Cache* cache) : |
commit-bot@chromium.org | f7efa50 | 2014-04-11 18:57:00 +0000 | [diff] [blame] | 67 | fCTM(ctm), fClipBounds(clipBounds), fCache(cache) { |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 68 | } |
| 69 | const SkMatrix& ctm() const { return fCTM; } |
| 70 | const SkIRect& clipBounds() const { return fClipBounds; } |
senorblanco | be129b2 | 2014-08-08 07:14:35 -0700 | [diff] [blame] | 71 | Cache* cache() const { return fCache; } |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 72 | private: |
| 73 | SkMatrix fCTM; |
| 74 | SkIRect fClipBounds; |
senorblanco | be129b2 | 2014-08-08 07:14:35 -0700 | [diff] [blame] | 75 | Cache* fCache; |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 76 | }; |
| 77 | |
reed@google.com | 76dd277 | 2012-01-05 21:15:07 +0000 | [diff] [blame] | 78 | class Proxy { |
| 79 | public: |
reed@google.com | 8926b16 | 2012-03-23 15:36:36 +0000 | [diff] [blame] | 80 | virtual ~Proxy() {}; |
| 81 | |
robertphillips@google.com | 1f2f338 | 2013-08-29 11:54:56 +0000 | [diff] [blame] | 82 | virtual SkBaseDevice* createDevice(int width, int height) = 0; |
reed@google.com | 8926b16 | 2012-03-23 15:36:36 +0000 | [diff] [blame] | 83 | // returns true if the proxy can handle this filter natively |
commit-bot@chromium.org | ae761f7 | 2014-02-05 22:32:02 +0000 | [diff] [blame] | 84 | virtual bool canHandleImageFilter(const SkImageFilter*) = 0; |
reed@google.com | 76dd277 | 2012-01-05 21:15:07 +0000 | [diff] [blame] | 85 | // returns true if the proxy handled the filter itself. if this returns |
| 86 | // false then the filter's code will be called. |
commit-bot@chromium.org | ae761f7 | 2014-02-05 22:32:02 +0000 | [diff] [blame] | 87 | virtual bool filterImage(const SkImageFilter*, const SkBitmap& src, |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 88 | const Context&, |
reed@google.com | 76dd277 | 2012-01-05 21:15:07 +0000 | [diff] [blame] | 89 | SkBitmap* result, SkIPoint* offset) = 0; |
| 90 | }; |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 91 | |
| 92 | /** |
| 93 | * Request a new (result) image to be created from the src image. |
| 94 | * If the src has no pixels (isNull()) then the request just wants to |
| 95 | * receive the config and width/height of the result. |
| 96 | * |
| 97 | * The matrix is the current matrix on the canvas. |
| 98 | * |
| 99 | * Offset is the amount to translate the resulting image relative to the |
senorblanco@chromium.org | 6776b82 | 2014-01-03 21:48:22 +0000 | [diff] [blame] | 100 | * src when it is drawn. This is an out-param. |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 101 | * |
| 102 | * If the result image cannot be created, return false, in which case both |
| 103 | * the result and offset parameters will be ignored by the caller. |
| 104 | */ |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 105 | bool filterImage(Proxy*, const SkBitmap& src, const Context&, |
commit-bot@chromium.org | ae761f7 | 2014-02-05 22:32:02 +0000 | [diff] [blame] | 106 | SkBitmap* result, SkIPoint* offset) const; |
reed@google.com | 15356a6 | 2011-11-03 19:29:08 +0000 | [diff] [blame] | 107 | |
| 108 | /** |
reed@google.com | 32d25b6 | 2011-12-20 16:19:00 +0000 | [diff] [blame] | 109 | * Given the src bounds of an image, this returns the bounds of the result |
| 110 | * image after the filter has been applied. |
| 111 | */ |
senorblanco@chromium.org | c4b12f1 | 2014-02-05 17:51:22 +0000 | [diff] [blame] | 112 | bool filterBounds(const SkIRect& src, const SkMatrix& ctm, SkIRect* dst) const; |
reed@google.com | 32d25b6 | 2011-12-20 16:19:00 +0000 | [diff] [blame] | 113 | |
| 114 | /** |
senorblanco@chromium.org | 302cffb | 2012-08-01 20:16:34 +0000 | [diff] [blame] | 115 | * Returns true if the filter can be processed on the GPU. This is most |
| 116 | * often used for multi-pass effects, where intermediate results must be |
bsalomon@google.com | 8ea78d8 | 2012-10-24 20:11:30 +0000 | [diff] [blame] | 117 | * rendered to textures. For single-pass effects, use asNewEffect(). |
senorblanco@chromium.org | 7938bae | 2013-10-18 20:08:14 +0000 | [diff] [blame] | 118 | * The default implementation returns asNewEffect(NULL, NULL, SkMatrix::I(), |
| 119 | * SkIRect()). |
reed@google.com | 15356a6 | 2011-11-03 19:29:08 +0000 | [diff] [blame] | 120 | */ |
senorblanco@chromium.org | 302cffb | 2012-08-01 20:16:34 +0000 | [diff] [blame] | 121 | virtual bool canFilterImageGPU() const; |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 122 | |
senorblanco@chromium.org | 05054f1 | 2012-03-02 21:05:45 +0000 | [diff] [blame] | 123 | /** |
skia.committer@gmail.com | 3284017 | 2013-04-09 07:01:27 +0000 | [diff] [blame] | 124 | * Process this image filter on the GPU. This is most often used for |
senorblanco@chromium.org | d043cce | 2013-04-08 19:43:22 +0000 | [diff] [blame] | 125 | * multi-pass effects, where intermediate results must be rendered to |
| 126 | * textures. For single-pass effects, use asNewEffect(). src is the |
| 127 | * source image for processing, as a texture-backed bitmap. result is |
| 128 | * the destination bitmap, which should contain a texture-backed pixelref |
skia.committer@gmail.com | de2e4e8 | 2013-07-11 07:01:01 +0000 | [diff] [blame] | 129 | * on success. offset is the amount to translate the resulting image |
commit-bot@chromium.org | 7b32070 | 2013-07-10 21:22:18 +0000 | [diff] [blame] | 130 | * relative to the src when it is drawn. The default implementation does |
| 131 | * single-pass processing using asNewEffect(). |
senorblanco@chromium.org | 05054f1 | 2012-03-02 21:05:45 +0000 | [diff] [blame] | 132 | */ |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 133 | virtual bool filterImageGPU(Proxy*, const SkBitmap& src, const Context&, |
commit-bot@chromium.org | ae761f7 | 2014-02-05 22:32:02 +0000 | [diff] [blame] | 134 | SkBitmap* result, SkIPoint* offset) const; |
senorblanco@chromium.org | 05054f1 | 2012-03-02 21:05:45 +0000 | [diff] [blame] | 135 | |
senorblanco@chromium.org | 8d21f6c | 2012-10-12 19:14:06 +0000 | [diff] [blame] | 136 | /** |
sugoi@google.com | a1c511b | 2013-02-21 15:02:28 +0000 | [diff] [blame] | 137 | * Returns whether this image filter is a color filter and puts the color filter into the |
sugoi@google.com | 4b6d432 | 2013-02-21 20:26:50 +0000 | [diff] [blame] | 138 | * "filterPtr" parameter if it can. Does nothing otherwise. |
| 139 | * If this returns false, then the filterPtr is unchanged. |
| 140 | * If this returns true, then if filterPtr is not null, it must be set to a ref'd colorfitler |
| 141 | * (i.e. it may not be set to NULL). |
senorblanco@chromium.org | 8d21f6c | 2012-10-12 19:14:06 +0000 | [diff] [blame] | 142 | */ |
sugoi@google.com | 4b6d432 | 2013-02-21 20:26:50 +0000 | [diff] [blame] | 143 | virtual bool asColorFilter(SkColorFilter** filterPtr) const; |
senorblanco@chromium.org | 9f25de7 | 2012-10-10 20:36:13 +0000 | [diff] [blame] | 144 | |
senorblanco@chromium.org | 8d21f6c | 2012-10-12 19:14:06 +0000 | [diff] [blame] | 145 | /** |
| 146 | * Returns the number of inputs this filter will accept (some inputs can |
| 147 | * be NULL). |
| 148 | */ |
| 149 | int countInputs() const { return fInputCount; } |
| 150 | |
| 151 | /** |
| 152 | * Returns the input filter at a given index, or NULL if no input is |
| 153 | * connected. The indices used are filter-specific. |
| 154 | */ |
| 155 | SkImageFilter* getInput(int i) const { |
| 156 | SkASSERT(i < fInputCount); |
| 157 | return fInputs[i]; |
| 158 | } |
| 159 | |
senorblanco@chromium.org | 194d775 | 2013-07-24 22:19:24 +0000 | [diff] [blame] | 160 | /** |
senorblanco@chromium.org | 3f1f2a3 | 2013-10-16 18:07:48 +0000 | [diff] [blame] | 161 | * Returns whether any edges of the crop rect have been set. The crop |
| 162 | * rect is set at construction time, and determines which pixels from the |
| 163 | * input image will be processed. The size of the crop rect should be |
| 164 | * used as the size of the destination image. The origin of this rect |
| 165 | * should be used to offset access to the input images, and should also |
| 166 | * be added to the "offset" parameter in onFilterImage and |
| 167 | * filterImageGPU(). (The latter ensures that the resulting buffer is |
| 168 | * drawn in the correct location.) |
senorblanco@chromium.org | 194d775 | 2013-07-24 22:19:24 +0000 | [diff] [blame] | 169 | */ |
senorblanco@chromium.org | 3f1f2a3 | 2013-10-16 18:07:48 +0000 | [diff] [blame] | 170 | bool cropRectIsSet() const { return fCropRect.flags() != 0x0; } |
senorblanco@chromium.org | 194d775 | 2013-07-24 22:19:24 +0000 | [diff] [blame] | 171 | |
senorblanco@chromium.org | 336d1d7 | 2014-01-27 21:03:17 +0000 | [diff] [blame] | 172 | // Default impl returns union of all input bounds. |
| 173 | virtual void computeFastBounds(const SkRect&, SkRect*) const; |
| 174 | |
kkinnunen | 4509517 | 2014-07-29 06:12:49 -0700 | [diff] [blame] | 175 | #if SK_SUPPORT_GPU |
senorblanco@chromium.org | 6aa6fec | 2014-03-03 22:13:56 +0000 | [diff] [blame] | 176 | /** |
| 177 | * Wrap the given texture in a texture-backed SkBitmap. |
| 178 | */ |
| 179 | static void WrapTexture(GrTexture* texture, int width, int height, SkBitmap* result); |
| 180 | |
| 181 | /** |
| 182 | * Recursively evaluate this filter on the GPU. If the filter has no GPU |
| 183 | * implementation, it will be processed in software and uploaded to the GPU. |
| 184 | */ |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 185 | bool getInputResultGPU(SkImageFilter::Proxy* proxy, const SkBitmap& src, const Context&, |
senorblanco@chromium.org | 6aa6fec | 2014-03-03 22:13:56 +0000 | [diff] [blame] | 186 | SkBitmap* result, SkIPoint* offset) const; |
| 187 | #endif |
| 188 | |
senorblanco@chromium.org | 1a479e7 | 2014-04-14 15:51:48 +0000 | [diff] [blame] | 189 | /** |
| 190 | * Set an external cache to be used for all image filter processing. This |
| 191 | * will replace the default intra-frame cache. |
| 192 | */ |
| 193 | static void SetExternalCache(Cache* cache); |
| 194 | |
| 195 | /** |
| 196 | * Returns the currently-set external cache, or NULL if none is set. |
| 197 | */ |
| 198 | static Cache* GetExternalCache(); |
| 199 | |
commit-bot@chromium.org | c0b7e10 | 2013-10-23 17:06:21 +0000 | [diff] [blame] | 200 | SK_DEFINE_FLATTENABLE_TYPE(SkImageFilter) |
| 201 | |
senorblanco@chromium.org | 8d21f6c | 2012-10-12 19:14:06 +0000 | [diff] [blame] | 202 | protected: |
reed | b959ec7 | 2014-07-17 07:03:09 -0700 | [diff] [blame] | 203 | class Common { |
| 204 | public: |
| 205 | Common() {} |
| 206 | ~Common(); |
| 207 | |
reed | 9fa60da | 2014-08-21 07:59:51 -0700 | [diff] [blame] | 208 | /** |
| 209 | * Attempt to unflatten the cropRect and the expected number of input filters. |
| 210 | * If any number of input filters is valid, pass -1. |
| 211 | * If this fails (i.e. corrupt buffer or contents) then return false and common will |
| 212 | * be left uninitialized. |
| 213 | * If this returns true, then inputCount() is the number of found input filters, each |
| 214 | * of which may be NULL or a valid imagefilter. |
| 215 | */ |
| 216 | bool unflatten(SkReadBuffer&, int expectedInputs); |
reed | b959ec7 | 2014-07-17 07:03:09 -0700 | [diff] [blame] | 217 | |
reed | 9fa60da | 2014-08-21 07:59:51 -0700 | [diff] [blame] | 218 | const CropRect& cropRect() const { return fCropRect; } |
reed | b959ec7 | 2014-07-17 07:03:09 -0700 | [diff] [blame] | 219 | int inputCount() const { return fInputs.count(); } |
| 220 | SkImageFilter** inputs() const { return fInputs.get(); } |
senorblanco | 55b6d8b | 2014-07-30 11:26:46 -0700 | [diff] [blame] | 221 | uint32_t uniqueID() const { return fUniqueID; } |
reed | b959ec7 | 2014-07-17 07:03:09 -0700 | [diff] [blame] | 222 | |
reed | 9fa60da | 2014-08-21 07:59:51 -0700 | [diff] [blame] | 223 | SkImageFilter* getInput(int index) const { return fInputs[index]; } |
| 224 | |
reed | b959ec7 | 2014-07-17 07:03:09 -0700 | [diff] [blame] | 225 | // If the caller wants a copy of the inputs, call this and it will transfer ownership |
| 226 | // of the unflattened input filters to the caller. This is just a short-cut for copying |
| 227 | // the inputs, calling ref() on each, and then waiting for Common's destructor to call |
| 228 | // unref() on each. |
| 229 | void detachInputs(SkImageFilter** inputs); |
| 230 | |
| 231 | private: |
| 232 | CropRect fCropRect; |
| 233 | // most filters accept at most 2 input-filters |
| 234 | SkAutoSTArray<2, SkImageFilter*> fInputs; |
senorblanco | 55b6d8b | 2014-07-30 11:26:46 -0700 | [diff] [blame] | 235 | uint32_t fUniqueID; |
reed | b959ec7 | 2014-07-17 07:03:09 -0700 | [diff] [blame] | 236 | |
| 237 | void allocInputs(int count); |
| 238 | }; |
| 239 | |
senorblanco | 5e5f948 | 2014-08-26 12:27:12 -0700 | [diff] [blame^] | 240 | SkImageFilter(int inputCount, SkImageFilter** inputs, const CropRect* cropRect = NULL, uint32_t uniqueID = 0); |
senorblanco@chromium.org | 8d21f6c | 2012-10-12 19:14:06 +0000 | [diff] [blame] | 241 | |
senorblanco@chromium.org | 9f25de7 | 2012-10-10 20:36:13 +0000 | [diff] [blame] | 242 | virtual ~SkImageFilter(); |
| 243 | |
commit-bot@chromium.org | c84728d | 2013-12-04 20:07:47 +0000 | [diff] [blame] | 244 | /** |
commit-bot@chromium.org | 8b0e8ac | 2014-01-30 18:58:24 +0000 | [diff] [blame] | 245 | * Constructs a new SkImageFilter read from an SkReadBuffer object. |
commit-bot@chromium.org | c84728d | 2013-12-04 20:07:47 +0000 | [diff] [blame] | 246 | * |
| 247 | * @param inputCount The exact number of inputs expected for this SkImageFilter object. |
| 248 | * -1 can be used if the filter accepts any number of inputs. |
commit-bot@chromium.org | 8b0e8ac | 2014-01-30 18:58:24 +0000 | [diff] [blame] | 249 | * @param rb SkReadBuffer object from which the SkImageFilter is read. |
commit-bot@chromium.org | c84728d | 2013-12-04 20:07:47 +0000 | [diff] [blame] | 250 | */ |
commit-bot@chromium.org | 8b0e8ac | 2014-01-30 18:58:24 +0000 | [diff] [blame] | 251 | explicit SkImageFilter(int inputCount, SkReadBuffer& rb); |
senorblanco@chromium.org | 9f25de7 | 2012-10-10 20:36:13 +0000 | [diff] [blame] | 252 | |
reed | 9fa60da | 2014-08-21 07:59:51 -0700 | [diff] [blame] | 253 | virtual void flatten(SkWriteBuffer&) const SK_OVERRIDE; |
reed@google.com | 32d25b6 | 2011-12-20 16:19:00 +0000 | [diff] [blame] | 254 | |
senorblanco@chromium.org | 6776b82 | 2014-01-03 21:48:22 +0000 | [diff] [blame] | 255 | /** |
| 256 | * This is the virtual which should be overridden by the derived class |
| 257 | * to perform image filtering. |
| 258 | * |
| 259 | * src is the original primitive bitmap. If the filter has a connected |
| 260 | * input, it should recurse on that input and use that in place of src. |
| 261 | * |
| 262 | * The matrix is the current matrix on the canvas. |
| 263 | * |
| 264 | * Offset is the amount to translate the resulting image relative to the |
| 265 | * src when it is drawn. This is an out-param. |
| 266 | * |
| 267 | * If the result image cannot be created, this should false, in which |
| 268 | * case both the result and offset parameters will be ignored by the |
| 269 | * caller. |
| 270 | */ |
senorblanco@chromium.org | 4cb543d | 2014-03-14 15:44:01 +0000 | [diff] [blame] | 271 | virtual bool onFilterImage(Proxy*, const SkBitmap& src, const Context&, |
commit-bot@chromium.org | ae761f7 | 2014-02-05 22:32:02 +0000 | [diff] [blame] | 272 | SkBitmap* result, SkIPoint* offset) const; |
senorblanco@chromium.org | c4b12f1 | 2014-02-05 17:51:22 +0000 | [diff] [blame] | 273 | // Given the bounds of the destination rect to be filled in device |
| 274 | // coordinates (first parameter), and the CTM, compute (conservatively) |
| 275 | // which rect of the source image would be required (third parameter). |
| 276 | // Used for clipping and temp-buffer allocations, so the result need not |
| 277 | // be exact, but should never be smaller than the real answer. The default |
| 278 | // implementation recursively unions all input bounds, or returns false if |
| 279 | // no inputs. |
| 280 | virtual bool onFilterBounds(const SkIRect&, const SkMatrix&, SkIRect*) const; |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 281 | |
senorblanco@chromium.org | 1182529 | 2014-03-14 17:44:41 +0000 | [diff] [blame] | 282 | /** Computes source bounds as the src bitmap bounds offset by srcOffset. |
| 283 | * Apply the transformed crop rect to the bounds if any of the |
| 284 | * corresponding edge flags are set. Intersects the result against the |
| 285 | * context's clipBounds, and returns the result in "bounds". If there is |
| 286 | * no intersection, returns false and leaves "bounds" unchanged. |
| 287 | */ |
| 288 | bool applyCropRect(const Context&, const SkBitmap& src, const SkIPoint& srcOffset, |
| 289 | SkIRect* bounds) const; |
| 290 | |
| 291 | /** Same as the above call, except that if the resulting crop rect is not |
| 292 | * entirely contained by the source bitmap's bounds, it creates a new |
| 293 | * bitmap in "result" and pads the edges with transparent black. In that |
| 294 | * case, the srcOffset is modified to be the same as the bounds, since no |
| 295 | * further adjustment is needed by the caller. This version should only |
| 296 | * be used by filters which are not capable of processing a smaller |
| 297 | * source bitmap into a larger destination. |
| 298 | */ |
| 299 | bool applyCropRect(const Context&, Proxy* proxy, const SkBitmap& src, SkIPoint* srcOffset, |
| 300 | SkIRect* bounds, SkBitmap* result) const; |
senorblanco@chromium.org | 194d775 | 2013-07-24 22:19:24 +0000 | [diff] [blame] | 301 | |
senorblanco@chromium.org | 1aa6872 | 2013-10-17 19:35:09 +0000 | [diff] [blame] | 302 | /** |
| 303 | * Returns true if the filter can be expressed a single-pass |
| 304 | * GrEffect, used to process this filter on the GPU, or false if |
| 305 | * not. |
| 306 | * |
| 307 | * If effect is non-NULL, a new GrEffect instance is stored |
| 308 | * in it. The caller assumes ownership of the stage, and it is up to the |
| 309 | * caller to unref it. |
| 310 | * |
| 311 | * The effect can assume its vertexCoords space maps 1-to-1 with texels |
| 312 | * in the texture. "matrix" is a transformation to apply to filter |
| 313 | * parameters before they are used in the effect. Note that this function |
| 314 | * will be called with (NULL, NULL, SkMatrix::I()) to query for support, |
| 315 | * so returning "true" indicates support for all possible matrices. |
| 316 | */ |
bsalomon | 97b9ab7 | 2014-07-08 06:52:35 -0700 | [diff] [blame] | 317 | virtual bool asNewEffect(GrEffect** effect, |
senorblanco@chromium.org | 7938bae | 2013-10-18 20:08:14 +0000 | [diff] [blame] | 318 | GrTexture*, |
| 319 | const SkMatrix& matrix, |
| 320 | const SkIRect& bounds) const; |
senorblanco@chromium.org | 1aa6872 | 2013-10-17 19:35:09 +0000 | [diff] [blame] | 321 | |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 322 | private: |
senorblanco | 55b6d8b | 2014-07-30 11:26:46 -0700 | [diff] [blame] | 323 | bool usesSrcInput() const { return fUsesSrcInput; } |
| 324 | |
senorblanco@chromium.org | 54e01b2 | 2011-11-16 18:20:47 +0000 | [diff] [blame] | 325 | typedef SkFlattenable INHERITED; |
senorblanco@chromium.org | 8d21f6c | 2012-10-12 19:14:06 +0000 | [diff] [blame] | 326 | int fInputCount; |
senorblanco@chromium.org | 9f25de7 | 2012-10-10 20:36:13 +0000 | [diff] [blame] | 327 | SkImageFilter** fInputs; |
senorblanco | 55b6d8b | 2014-07-30 11:26:46 -0700 | [diff] [blame] | 328 | bool fUsesSrcInput; |
senorblanco@chromium.org | b295fb6 | 2013-10-10 13:51:19 +0000 | [diff] [blame] | 329 | CropRect fCropRect; |
senorblanco | 55b6d8b | 2014-07-30 11:26:46 -0700 | [diff] [blame] | 330 | uint32_t fUniqueID; // Globally unique |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 331 | }; |
| 332 | |
reed | 9fa60da | 2014-08-21 07:59:51 -0700 | [diff] [blame] | 333 | /** |
| 334 | * Helper to unflatten the common data, and return NULL if we fail. |
| 335 | */ |
| 336 | #define SK_IMAGEFILTER_UNFLATTEN_COMMON(localVar, expectedCount) \ |
| 337 | Common localVar; \ |
| 338 | do { \ |
| 339 | if (!localVar.unflatten(buffer, expectedCount)) { \ |
| 340 | return NULL; \ |
| 341 | } \ |
| 342 | } while (0) |
| 343 | |
reed@google.com | 894aa9a | 2011-09-23 14:49:49 +0000 | [diff] [blame] | 344 | #endif |