blob: 22fa82c2758015af109cd9821a6d6f5cce77a65f [file] [log] [blame]
joshualitt374b2f72015-07-21 08:05:03 -07001/*
2 * Copyright 2015 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
Herb Derby86240592018-05-24 16:12:31 -04008#ifndef GrTextBlob_DEFINED
9#define GrTextBlob_DEFINED
joshualitt374b2f72015-07-21 08:05:03 -070010
joshualitt259fbf12015-07-21 11:39:34 -070011#include "GrColor.h"
Brian Salomon2ee084e2016-12-16 18:59:19 -050012#include "GrDrawOpAtlas.h"
Robert Phillipsc4039ea2018-03-01 11:36:45 -050013#include "GrGlyphCache.h"
Herb Derbyc1b482c2018-08-09 15:02:27 -040014#include "GrTextTarget.h"
Herb Derbydc214c22018-11-08 13:31:39 -050015#include "text/GrTextContext.h"
joshualitt374b2f72015-07-21 08:05:03 -070016#include "SkDescriptor.h"
Mike Reed80747ef2018-01-23 15:29:32 -050017#include "SkMaskFilterBase.h"
mtklein4e976072016-08-08 09:06:27 -070018#include "SkOpts.h"
bsalomon8b6fa5e2016-05-19 16:23:47 -070019#include "SkPathEffect.h"
Brian Salomon5c6ac642017-12-19 11:09:32 -050020#include "SkPoint3.h"
Mike Reed274218e2018-01-08 15:05:02 -050021#include "SkRectPriv.h"
Herb Derbyc1b482c2018-08-09 15:02:27 -040022#include "SkStrikeCache.h"
joshualitt259fbf12015-07-21 11:39:34 -070023#include "SkSurfaceProps.h"
joshualitt374b2f72015-07-21 08:05:03 -070024#include "SkTInternalLList.h"
25
Robert Phillipsc4039ea2018-03-01 11:36:45 -050026class GrAtlasManager;
joshualitt2e2202e2015-12-10 11:22:08 -080027struct GrDistanceFieldAdjustTable;
Robert Phillipsc4039ea2018-03-01 11:36:45 -050028struct GrGlyph;
Robert Phillipsc4039ea2018-03-01 11:36:45 -050029
joshualitt2e2202e2015-12-10 11:22:08 -080030class SkTextBlob;
31class SkTextBlobRunIterator;
32
Herb Derby26cbe512018-05-24 14:39:01 -040033// With this flag enabled, the GrTextContext will, as a sanity check, regenerate every blob
joshualitt259fbf12015-07-21 11:39:34 -070034// that comes in to verify the integrity of its cache
joshualitt2f2ee832016-02-10 08:52:24 -080035#define CACHE_SANITY_CHECK 0
joshualitt259fbf12015-07-21 11:39:34 -070036
joshualitt374b2f72015-07-21 08:05:03 -070037/*
Herb Derby86240592018-05-24 16:12:31 -040038 * A GrTextBlob contains a fully processed SkTextBlob, suitable for nearly immediate drawing
joshualitt374b2f72015-07-21 08:05:03 -070039 * on the GPU. These are initially created with valid positions and colors, but invalid
Herb Derby86240592018-05-24 16:12:31 -040040 * texture coordinates. The GrTextBlob itself has a few Blob-wide properties, and also
joshualitt374b2f72015-07-21 08:05:03 -070041 * consists of a number of runs. Runs inside a blob are flushed individually so they can be
42 * reordered.
43 *
Herb Derby86240592018-05-24 16:12:31 -040044 * The only thing(aside from a memcopy) required to flush a GrTextBlob is to ensure that
joshualitt374b2f72015-07-21 08:05:03 -070045 * the GrAtlas will not evict anything the Blob needs.
46 *
47 * Note: This struct should really be named GrCachedAtasTextBlob, but that is too verbose.
joshualitt259fbf12015-07-21 11:39:34 -070048 *
49 * *WARNING* If you add new fields to this struct, then you may need to to update AssertEqual
joshualitt374b2f72015-07-21 08:05:03 -070050 */
Mike Klein408ef212018-10-30 15:23:00 +000051class GrTextBlob : public SkNVRefCnt<GrTextBlob> {
Herb Derbydc214c22018-11-08 13:31:39 -050052 struct Run;
joshualitt2e2202e2015-12-10 11:22:08 -080053public:
Herb Derby86240592018-05-24 16:12:31 -040054 SK_DECLARE_INTERNAL_LLIST_INTERFACE(GrTextBlob);
joshualitt374b2f72015-07-21 08:05:03 -070055
Brian Salomon18923f92017-11-06 16:26:02 -050056 class VertexRegenerator;
57
Herb Derbydc214c22018-11-08 13:31:39 -050058 void generateFromGlyphRunList(GrGlyphCache* glyphCache,
59 const GrShaderCaps& shaderCaps,
60 const GrTextContext::Options& options,
61 const SkPaint& paint,
Herb Derbydc214c22018-11-08 13:31:39 -050062 SkScalerContextFlags scalerContextFlags,
63 const SkMatrix& viewMatrix,
64 const SkSurfaceProps& props,
65 const SkGlyphRunList& glyphRunList,
66 SkGlyphRunListPainter* glyphPainter);
67
Herb Derby5424a5e2018-11-14 12:04:38 -050068 static sk_sp<GrTextBlob> Make(int glyphCount, int runCount, GrColor color);
joshualitt323c2eb2016-01-20 06:48:47 -080069
Brian Salomon5c6ac642017-12-19 11:09:32 -050070 /**
71 * We currently force regeneration of a blob if old or new matrix differ in having perspective.
72 * If we ever change that then the key must contain the perspectiveness when there are distance
73 * fields as perspective distance field use 3 component vertex positions and non-perspective
74 * uses 2.
75 */
joshualitt323c2eb2016-01-20 06:48:47 -080076 struct Key {
77 Key() {
78 sk_bzero(this, sizeof(Key));
79 }
80 uint32_t fUniqueID;
81 // Color may affect the gamma of the mask we generate, but in a fairly limited way.
82 // Each color is assigned to on of a fixed number of buckets based on its
83 // luminance. For each luminance bucket there is a "canonical color" that
84 // represents the bucket. This functionality is currently only supported for A8
85 SkColor fCanonicalColor;
86 SkPaint::Style fStyle;
87 SkPixelGeometry fPixelGeometry;
88 bool fHasBlur;
brianosman8d7ffce2016-04-21 08:29:06 -070089 uint32_t fScalerContextFlags;
joshualitt323c2eb2016-01-20 06:48:47 -080090
91 bool operator==(const Key& other) const {
92 return 0 == memcmp(this, &other, sizeof(Key));
93 }
94 };
95
Herb Derby86240592018-05-24 16:12:31 -040096 void setupKey(const GrTextBlob::Key& key,
Mike Reed80747ef2018-01-23 15:29:32 -050097 const SkMaskFilterBase::BlurRec& blurRec,
joshualitt92303772016-02-10 11:55:52 -080098 const SkPaint& paint) {
99 fKey = key;
100 if (key.fHasBlur) {
101 fBlurRec = blurRec;
102 }
103 if (key.fStyle != SkPaint::kFill_Style) {
104 fStrokeInfo.fFrameWidth = paint.getStrokeWidth();
105 fStrokeInfo.fMiterLimit = paint.getStrokeMiter();
106 fStrokeInfo.fJoin = paint.getStrokeJoin();
107 }
108 }
109
Herb Derby86240592018-05-24 16:12:31 -0400110 static const Key& GetKey(const GrTextBlob& blob) {
joshualitt323c2eb2016-01-20 06:48:47 -0800111 return blob.fKey;
112 }
113
114 static uint32_t Hash(const Key& key) {
mtklein4e976072016-08-08 09:06:27 -0700115 return SkOpts::hash(&key, sizeof(Key));
joshualitt323c2eb2016-01-20 06:48:47 -0800116 }
117
118 void operator delete(void* p) {
Herb Derbyb12175f2018-05-23 16:38:09 -0400119 ::operator delete(p);
joshualitt323c2eb2016-01-20 06:48:47 -0800120 }
Herb Derbyb12175f2018-05-23 16:38:09 -0400121
joshualitt323c2eb2016-01-20 06:48:47 -0800122 void* operator new(size_t) {
Ben Wagnerb4aab9a2017-08-16 10:53:04 -0400123 SK_ABORT("All blobs are created by placement new.");
joshualitt323c2eb2016-01-20 06:48:47 -0800124 return sk_malloc_throw(0);
125 }
126
127 void* operator new(size_t, void* p) { return p; }
joshualitt323c2eb2016-01-20 06:48:47 -0800128
129 bool hasDistanceField() const { return SkToBool(fTextType & kHasDistanceField_TextType); }
130 bool hasBitmap() const { return SkToBool(fTextType & kHasBitmap_TextType); }
131 void setHasDistanceField() { fTextType |= kHasDistanceField_TextType; }
132 void setHasBitmap() { fTextType |= kHasBitmap_TextType; }
133
Herb Derby2bb343c2018-11-08 15:03:48 -0500134 int runCountLimit() const { return fRunCountLimit; }
joshualittddd22d82016-02-16 06:47:52 -0800135
Herb Derby2bb343c2018-11-08 15:03:48 -0500136 Run* pushBackRun() {
137 SkASSERT(fRunCount < fRunCountLimit);
Herb Derby6dff60e2018-11-12 15:45:49 -0500138
139 // If there is more run, then connect up the subruns.
Herb Derby2bb343c2018-11-08 15:03:48 -0500140 if (fRunCount > 0) {
Herb Derby69ff8952018-11-12 11:39:12 -0500141 SubRun& newRun = fRuns[fRunCount].fSubRunInfo.back();
142 SubRun& lastRun = fRuns[fRunCount - 1].fSubRunInfo.back();
joshualitt323c2eb2016-01-20 06:48:47 -0800143 newRun.setAsSuccessor(lastRun);
144 }
joshualitt323c2eb2016-01-20 06:48:47 -0800145
Herb Derby2bb343c2018-11-08 15:03:48 -0500146 fRunCount++;
147 return &fRuns[fRunCount - 1];
Jim Van Verth89737de2018-02-06 21:30:20 +0000148 }
149
joshualitt323c2eb2016-01-20 06:48:47 -0800150 void setMinAndMaxScale(SkScalar scaledMax, SkScalar scaledMin) {
151 // we init fMaxMinScale and fMinMaxScale in the constructor
152 fMaxMinScale = SkMaxScalar(scaledMax, fMaxMinScale);
153 fMinMaxScale = SkMinScalar(scaledMin, fMinMaxScale);
154 }
155
Jim Van Verthb515ae72018-05-23 16:44:55 -0400156 static size_t GetVertexStride(GrMaskFormat maskFormat, bool hasWCoord) {
joshualitt323c2eb2016-01-20 06:48:47 -0800157 switch (maskFormat) {
158 case kA8_GrMaskFormat:
Jim Van Verthb515ae72018-05-23 16:44:55 -0400159 return hasWCoord ? kGrayTextDFPerspectiveVASize : kGrayTextVASize;
joshualitt323c2eb2016-01-20 06:48:47 -0800160 case kARGB_GrMaskFormat:
Jim Van Verthb515ae72018-05-23 16:44:55 -0400161 return hasWCoord ? kColorTextPerspectiveVASize : kColorTextVASize;
joshualitt323c2eb2016-01-20 06:48:47 -0800162 default:
Jim Van Verthb515ae72018-05-23 16:44:55 -0400163 SkASSERT(!hasWCoord);
joshualitt323c2eb2016-01-20 06:48:47 -0800164 return kLCDTextVASize;
165 }
166 }
167
Herb Derby0edb2142018-10-16 17:04:11 -0400168 bool mustRegenerate(const SkPaint&, bool, const SkMaskFilterBase::BlurRec& blurRec,
joshualitt323c2eb2016-01-20 06:48:47 -0800169 const SkMatrix& viewMatrix, SkScalar x, SkScalar y);
170
Herb Derbyc1b482c2018-08-09 15:02:27 -0400171 void flush(GrTextTarget*, const SkSurfaceProps& props,
Jim Van Verth54d9c882018-02-08 16:14:48 -0500172 const GrDistanceFieldAdjustTable* distanceAdjustTable,
Brian Osmancf860852018-10-31 14:04:39 -0400173 const SkPaint& paint, const SkPMColor4f& filteredColor, const GrClip& clip,
Robert Phillipse4643cc2018-08-14 13:01:29 -0400174 const SkMatrix& viewMatrix, SkScalar x, SkScalar y);
joshualitt323c2eb2016-01-20 06:48:47 -0800175
joshualitt8e0ef292016-02-19 14:13:03 -0800176 void computeSubRunBounds(SkRect* outBounds, int runIndex, int subRunIndex,
Jim Van Verth70276912018-06-01 13:46:46 -0400177 const SkMatrix& viewMatrix, SkScalar x, SkScalar y,
178 bool needsGlyphTransform) {
joshualittbc811112016-02-11 12:42:02 -0800179 // We don't yet position distance field text on the cpu, so we have to map the vertex bounds
180 // into device space.
181 // We handle vertex bounds differently for distance field text and bitmap text because
182 // the vertex bounds of bitmap text are in device space. If we are flushing multiple runs
183 // from one blob then we are going to pay the price here of mapping the rect for each run.
184 const Run& run = fRuns[runIndex];
Herb Derby69ff8952018-11-12 11:39:12 -0500185 const SubRun& subRun = run.fSubRunInfo[subRunIndex];
joshualittbc811112016-02-11 12:42:02 -0800186 *outBounds = subRun.vertexBounds();
Jim Van Verth70276912018-06-01 13:46:46 -0400187 if (needsGlyphTransform) {
joshualittbc811112016-02-11 12:42:02 -0800188 // Distance field text is positioned with the (X,Y) as part of the glyph position,
189 // and currently the view matrix is applied on the GPU
joshualitt8e0ef292016-02-19 14:13:03 -0800190 outBounds->offset(x - fInitialX, y - fInitialY);
191 viewMatrix.mapRect(outBounds);
joshualittbc811112016-02-11 12:42:02 -0800192 } else {
193 // Bitmap text is fully positioned on the CPU, and offset by an (X,Y) translate in
194 // device space.
195 SkMatrix boundsMatrix = fInitialViewMatrixInverse;
196
197 boundsMatrix.postTranslate(-fInitialX, -fInitialY);
198
joshualitt8e0ef292016-02-19 14:13:03 -0800199 boundsMatrix.postTranslate(x, y);
joshualittbc811112016-02-11 12:42:02 -0800200
joshualitt8e0ef292016-02-19 14:13:03 -0800201 boundsMatrix.postConcat(viewMatrix);
joshualittbc811112016-02-11 12:42:02 -0800202 boundsMatrix.mapRect(outBounds);
203
204 // Due to floating point numerical inaccuracies, we have to round out here
205 outBounds->roundOut(outBounds);
206 }
207 }
208
joshualitt323c2eb2016-01-20 06:48:47 -0800209 // position + local coord
210 static const size_t kColorTextVASize = sizeof(SkPoint) + sizeof(SkIPoint16);
Jim Van Verthb515ae72018-05-23 16:44:55 -0400211 static const size_t kColorTextPerspectiveVASize = sizeof(SkPoint3) + sizeof(SkIPoint16);
joshualitt323c2eb2016-01-20 06:48:47 -0800212 static const size_t kGrayTextVASize = sizeof(SkPoint) + sizeof(GrColor) + sizeof(SkIPoint16);
Brian Salomon5c6ac642017-12-19 11:09:32 -0500213 static const size_t kGrayTextDFPerspectiveVASize =
214 sizeof(SkPoint3) + sizeof(GrColor) + sizeof(SkIPoint16);
joshualitt323c2eb2016-01-20 06:48:47 -0800215 static const size_t kLCDTextVASize = kGrayTextVASize;
Brian Salomon5c6ac642017-12-19 11:09:32 -0500216 static const size_t kMaxVASize = kGrayTextDFPerspectiveVASize;
joshualitt323c2eb2016-01-20 06:48:47 -0800217 static const int kVerticesPerGlyph = 4;
218
Herb Derby86240592018-05-24 16:12:31 -0400219 static void AssertEqual(const GrTextBlob&, const GrTextBlob&);
joshualitt323c2eb2016-01-20 06:48:47 -0800220
221 // The color here is the GrPaint color, and it is used to determine whether we
222 // have to regenerate LCD text blobs.
223 // We use this color vs the SkPaint color because it has the colorfilter applied.
Jim Van Verth58c3cce2017-10-19 15:50:24 -0400224 void initReusableBlob(SkColor luminanceColor, const SkMatrix& viewMatrix,
225 SkScalar x, SkScalar y) {
Jim Van Verthbc2cdd12017-06-08 11:14:35 -0400226 fLuminanceColor = luminanceColor;
joshualitt7481e752016-01-22 06:08:48 -0800227 this->setupViewMatrix(viewMatrix, x, y);
joshualitt323c2eb2016-01-20 06:48:47 -0800228 }
229
joshualitt7481e752016-01-22 06:08:48 -0800230 void initThrowawayBlob(const SkMatrix& viewMatrix, SkScalar x, SkScalar y) {
231 this->setupViewMatrix(viewMatrix, x, y);
joshualitt323c2eb2016-01-20 06:48:47 -0800232 }
233
joshualitt92303772016-02-10 11:55:52 -0800234 const Key& key() const { return fKey; }
235
Herb Derbyb12175f2018-05-23 16:38:09 -0400236 size_t size() const { return fSize; }
237
Herb Derby86240592018-05-24 16:12:31 -0400238 ~GrTextBlob() {
Herb Derby2bb343c2018-11-08 15:03:48 -0500239 for (int i = 0; i < fRunCountLimit; i++) {
joshualitt92303772016-02-10 11:55:52 -0800240 fRuns[i].~Run();
241 }
242 }
243
joshualittbc811112016-02-11 12:42:02 -0800244 ////////////////////////////////////////////////////////////////////////////////////////////////
245 // Internal test methods
Jim Van Verth56c37142017-10-31 14:44:25 -0400246 std::unique_ptr<GrDrawOp> test_makeOp(int glyphCount, uint16_t run, uint16_t subRun,
Brian Salomon44acb5b2017-07-18 19:59:24 -0400247 const SkMatrix& viewMatrix, SkScalar x, SkScalar y,
Brian Osmancf860852018-10-31 14:04:39 -0400248 const SkPaint& paint, const SkPMColor4f& filteredColor,
Herb Derbybc6f9c92018-08-08 13:58:45 -0400249 const SkSurfaceProps&, const GrDistanceFieldAdjustTable*,
Herb Derbyc1b482c2018-08-09 15:02:27 -0400250 GrTextTarget*);
joshualittbc811112016-02-11 12:42:02 -0800251
joshualitt323c2eb2016-01-20 06:48:47 -0800252private:
Herb Derby86240592018-05-24 16:12:31 -0400253 GrTextBlob()
joshualitt92303772016-02-10 11:55:52 -0800254 : fMaxMinScale(-SK_ScalarMax)
255 , fMinMaxScale(SK_ScalarMax)
256 , fTextType(0) {}
257
joshualitt8e0ef292016-02-19 14:13:03 -0800258 // This function will only be called when we are generating a blob from scratch. We record the
joshualitt7481e752016-01-22 06:08:48 -0800259 // initial view matrix and initial offsets(x,y), because we record vertex bounds relative to
260 // these numbers. When blobs are reused with new matrices, we need to return to model space so
261 // we can update the vertex bounds appropriately.
262 void setupViewMatrix(const SkMatrix& viewMatrix, SkScalar x, SkScalar y) {
joshualitt8e0ef292016-02-19 14:13:03 -0800263 fInitialViewMatrix = viewMatrix;
joshualitt7481e752016-01-22 06:08:48 -0800264 if (!viewMatrix.invert(&fInitialViewMatrixInverse)) {
265 fInitialViewMatrixInverse = SkMatrix::I();
joshualitt7481e752016-01-22 06:08:48 -0800266 }
joshualitt8e0ef292016-02-19 14:13:03 -0800267 fInitialX = x;
268 fInitialY = y;
269
270 // make sure all initial subruns have the correct VM and X/Y applied
Herb Derby2bb343c2018-11-08 15:03:48 -0500271 for (int i = 0; i < fRunCountLimit; i++) {
joshualitt8e0ef292016-02-19 14:13:03 -0800272 fRuns[i].fSubRunInfo[0].init(fInitialViewMatrix, x, y);
273 }
joshualitt7481e752016-01-22 06:08:48 -0800274 }
275
Herb Derby69ff8952018-11-12 11:39:12 -0500276 class SubRun {
277 public:
Herb Derby5424a5e2018-11-14 12:04:38 -0500278 SubRun(Run* run, const SkAutoDescriptor& desc, GrColor color)
279 : fColor{color}
280 , fRun{run}
Herb Derby317adf72018-11-16 17:29:29 -0500281 , fDesc{desc} {}
Herb Derby69ff8952018-11-12 11:39:12 -0500282
Herb Derby5424a5e2018-11-14 12:04:38 -0500283 // When used with emplace_back, this constructs a SubRun from the last SubRun in an array.
284 //SubRun(SkSTArray<1, SubRun>* subRunList)
285 // : fColor{subRunList->fromBack(1).fColor} { }
286
Herb Derby6dff60e2018-11-12 15:45:49 -0500287 void appendGlyph(GrTextBlob* blob, GrGlyph* glyph, SkRect dstRect);
Herb Derby96a17092018-11-12 12:45:21 -0500288
Herb Derby69ff8952018-11-12 11:39:12 -0500289 // TODO when this object is more internal, drop the privacy
290 void resetBulkUseToken() { fBulkUseToken.reset(); }
291 GrDrawOpAtlas::BulkUseTokenUpdater* bulkUseToken() { return &fBulkUseToken; }
292 void setStrike(sk_sp<GrTextStrike> strike) { fStrike = std::move(strike); }
293 GrTextStrike* strike() const { return fStrike.get(); }
294 sk_sp<GrTextStrike> refStrike() const { return fStrike; }
295
296 void setAtlasGeneration(uint64_t atlasGeneration) { fAtlasGeneration = atlasGeneration;}
297 uint64_t atlasGeneration() const { return fAtlasGeneration; }
298
299 size_t byteCount() const { return fVertexEndIndex - fVertexStartIndex; }
300 size_t vertexStartIndex() const { return fVertexStartIndex; }
301 size_t vertexEndIndex() const { return fVertexEndIndex; }
Herb Derby69ff8952018-11-12 11:39:12 -0500302
303 uint32_t glyphCount() const { return fGlyphEndIndex - fGlyphStartIndex; }
304 uint32_t glyphStartIndex() const { return fGlyphStartIndex; }
305 uint32_t glyphEndIndex() const { return fGlyphEndIndex; }
Herb Derby69ff8952018-11-12 11:39:12 -0500306 void setColor(GrColor color) { fColor = color; }
307 GrColor color() const { return fColor; }
308 void setMaskFormat(GrMaskFormat format) { fMaskFormat = format; }
309 GrMaskFormat maskFormat() const { return fMaskFormat; }
310
311 void setAsSuccessor(const SubRun& prev) {
312 fGlyphStartIndex = prev.glyphEndIndex();
Herb Derby6dff60e2018-11-12 15:45:49 -0500313 fGlyphEndIndex = fGlyphStartIndex;
Herb Derby69ff8952018-11-12 11:39:12 -0500314
315 fVertexStartIndex = prev.vertexEndIndex();
Herb Derby6dff60e2018-11-12 15:45:49 -0500316 fVertexEndIndex = fVertexStartIndex;
Herb Derby69ff8952018-11-12 11:39:12 -0500317
318 // copy over viewmatrix settings
319 this->init(prev.fCurrentViewMatrix, prev.fX, prev.fY);
320 }
321
322 const SkRect& vertexBounds() const { return fVertexBounds; }
323 void joinGlyphBounds(const SkRect& glyphBounds) {
324 fVertexBounds.joinNonEmptyArg(glyphBounds);
325 }
326
327 void init(const SkMatrix& viewMatrix, SkScalar x, SkScalar y) {
328 fCurrentViewMatrix = viewMatrix;
329 fX = x;
330 fY = y;
331 }
332
333 // This function assumes the translation will be applied before it is called again
334 void computeTranslation(const SkMatrix& viewMatrix, SkScalar x, SkScalar y,
335 SkScalar* transX, SkScalar* transY);
336
337 // df properties
herbc5df7cb2018-11-15 17:08:26 -0500338 void setDrawAsDistanceFields() { fFlags.drawAsSdf = true; }
339 bool drawAsDistanceFields() const { return fFlags.drawAsSdf; }
340 void setUseLCDText(bool useLCDText) { fFlags.useLCDText = useLCDText; }
341 bool hasUseLCDText() const { return fFlags.useLCDText; }
342 void setAntiAliased(bool antiAliased) { fFlags.antiAliased = antiAliased; }
343 bool isAntiAliased() const { return fFlags.antiAliased; }
344 void setHasWCoord(bool hasW) { fFlags.hasWCoord = hasW; }
345 bool hasWCoord() const { return fFlags.hasWCoord; }
346 void setNeedsTransform(bool needsTransform) { fFlags.needsTransform = needsTransform; }
347 bool needsTransform() const { return fFlags.needsTransform; }
Herb Derby5f7b0142018-12-14 16:47:45 -0500348 void setFallback() { fFlags.argbFallback = true; }
349 bool isFallback() { return fFlags.argbFallback; }
Herb Derby317adf72018-11-16 17:29:29 -0500350
351 const SkDescriptor* desc() const { return fDesc.getDesc(); }
Herb Derby69ff8952018-11-12 11:39:12 -0500352
353 private:
Herb Derby69ff8952018-11-12 11:39:12 -0500354 GrDrawOpAtlas::BulkUseTokenUpdater fBulkUseToken;
355 sk_sp<GrTextStrike> fStrike;
356 SkMatrix fCurrentViewMatrix;
Herb Derby6dff60e2018-11-12 15:45:49 -0500357 SkRect fVertexBounds = SkRectPriv::MakeLargestInverted();
358 uint64_t fAtlasGeneration{GrDrawOpAtlas::kInvalidAtlasGeneration};
359 size_t fVertexStartIndex{0};
360 size_t fVertexEndIndex{0};
361 uint32_t fGlyphStartIndex{0};
362 uint32_t fGlyphEndIndex{0};
Herb Derby69ff8952018-11-12 11:39:12 -0500363 SkScalar fX;
364 SkScalar fY;
Herb Derby6dff60e2018-11-12 15:45:49 -0500365 GrColor fColor{GrColor_ILLEGAL};
366 GrMaskFormat fMaskFormat{kA8_GrMaskFormat};
herbc5df7cb2018-11-15 17:08:26 -0500367 struct {
368 bool drawAsSdf:1;
369 bool useLCDText:1;
370 bool antiAliased:1;
371 bool hasWCoord:1;
372 bool needsTransform:1;
Herb Derby317adf72018-11-16 17:29:29 -0500373 bool argbFallback:1;
374 } fFlags{false, false, false, false, false, false};
Herb Derbyf7d5d742018-11-16 13:24:32 -0500375 Run* const fRun;
Herb Derby317adf72018-11-16 17:29:29 -0500376 const SkAutoDescriptor& fDesc;
Herb Derby69ff8952018-11-12 11:39:12 -0500377 }; // SubRunInfo
378
379
joshualitt374b2f72015-07-21 08:05:03 -0700380 /*
381 * Each Run inside of the blob can have its texture coordinates regenerated if required.
382 * To determine if regeneration is necessary, fAtlasGeneration is used. If there have been
383 * any evictions inside of the atlas, then we will simply regenerate Runs. We could track
384 * this at a more fine grained level, but its not clear if this is worth it, as evictions
385 * should be fairly rare.
386 *
387 * One additional point, each run can contain glyphs with any of the three mask formats.
388 * We call these SubRuns. Because a subrun must be a contiguous range, we have to create
389 * a new subrun each time the mask format changes in a run. In theory, a run can have as
390 * many SubRuns as it has glyphs, ie if a run alternates between color emoji and A8. In
391 * practice, the vast majority of runs have only a single subrun.
392 *
Herb Derby26cbe512018-05-24 14:39:01 -0400393 * Finally, for runs where the entire thing is too large for the GrTextContext to
Jim Van Verthf4c13162018-01-11 16:40:24 -0500394 * handle, we have a bit to mark the run as flushable via rendering as paths or as scaled
395 * glyphs. It would be a bit expensive to figure out ahead of time whether or not a run
joshualitt374b2f72015-07-21 08:05:03 -0700396 * can flush in this manner, so we always allocate vertices for the run, regardless of
397 * whether or not it is too large. The benefit of this strategy is that we can always reuse
398 * a blob allocation regardless of viewmatrix changes. We could store positions for these
Jim Van Verthf4c13162018-01-11 16:40:24 -0500399 * glyphs, however, it's not clear if this is a win because we'd still have to either go to the
joshualitt374b2f72015-07-21 08:05:03 -0700400 * glyph cache to get the path at flush time, or hold onto the path in the cache, which
401 * would greatly increase the memory of these cached items.
402 */
403 struct Run {
Herb Derby5424a5e2018-11-14 12:04:38 -0500404 explicit Run(GrTextBlob* blob, GrColor color)
405 : fBlob{blob}, fColor{color} {
joshualitt374b2f72015-07-21 08:05:03 -0700406 // To ensure we always have one subrun, we push back a fresh run here
Herb Derby5424a5e2018-11-14 12:04:38 -0500407 fSubRunInfo.emplace_back(this, fDescriptor, color);
joshualitt374b2f72015-07-21 08:05:03 -0700408 }
joshualitt374b2f72015-07-21 08:05:03 -0700409
Herb Derby2bb343c2018-11-08 15:03:48 -0500410 // sets the last subrun of runIndex to use w values
411 void setSubRunHasW(bool hasWCoord) {
Herb Derby69ff8952018-11-12 11:39:12 -0500412 SubRun& subRun = this->fSubRunInfo.back();
Herb Derby2bb343c2018-11-08 15:03:48 -0500413 subRun.setHasWCoord(hasWCoord);
414 }
415
416 // inits the override descriptor on the current run. All following subruns must use this
417 // descriptor
Herb Derby317adf72018-11-16 17:29:29 -0500418 SubRun* initARGBFallback() {
419 fARGBFallbackDescriptor.reset(new SkAutoDescriptor{});
Herb Derby2bb343c2018-11-08 15:03:48 -0500420 // Push back a new subrun to fill and set the override descriptor
Herb Derby5424a5e2018-11-14 12:04:38 -0500421 SubRun* subRun = this->pushBackSubRun(*fARGBFallbackDescriptor, fColor);
Herb Derby317adf72018-11-16 17:29:29 -0500422 subRun->setMaskFormat(kARGB_GrMaskFormat);
423 subRun->setFallback();
424 return subRun;
Herb Derby2bb343c2018-11-08 15:03:48 -0500425 }
426
427 // Appends a glyph to the blob as a path only.
428 void appendPathGlyph(
429 const SkPath& path, SkPoint position, SkScalar scale, bool preTransformed);
430
431 // Appends a glyph to the blob. If the glyph is too large, the glyph will be appended
432 // as a path.
433 void appendGlyph(GrTextBlob* blob,
434 const sk_sp<GrTextStrike>& strike,
435 const SkGlyph& skGlyph, GrGlyph::MaskStyle maskStyle,
Herb Derby5424a5e2018-11-14 12:04:38 -0500436 SkPoint origin, SkScalar textRatio, bool needsTransform);
Herb Derby2bb343c2018-11-08 15:03:48 -0500437
438 SkExclusiveStrikePtr setupCache(const SkPaint& skPaint,
Herb Derbyb79ba572018-12-17 11:01:02 -0500439 const SkFont& skFont,
Herb Derby2bb343c2018-11-08 15:03:48 -0500440 const SkSurfaceProps& props,
441 SkScalerContextFlags scalerContextFlags,
442 const SkMatrix& viewMatrix);
443
Mike Reed48b958b2018-12-03 13:09:02 -0500444 void setRunFontAntiAlias(bool aa) {
445 fAntiAlias = aa;
Herb Derby2bb343c2018-11-08 15:03:48 -0500446 }
447
448 // sets the last subrun of runIndex to use distance field text
449 void setSubRunHasDistanceFields(bool hasLCD, bool isAntiAlias, bool hasWCoord) {
Herb Derby69ff8952018-11-12 11:39:12 -0500450 SubRun& subRun = fSubRunInfo.back();
Herb Derby2bb343c2018-11-08 15:03:48 -0500451 subRun.setUseLCDText(hasLCD);
452 subRun.setAntiAliased(isAntiAlias);
453 subRun.setDrawAsDistanceFields();
454 subRun.setHasWCoord(hasWCoord);
455 }
456
Herb Derby5424a5e2018-11-14 12:04:38 -0500457 SubRun* pushBackSubRun(const SkAutoDescriptor& desc, GrColor color) {
joshualitt374b2f72015-07-21 08:05:03 -0700458 // Forward glyph / vertex information to seed the new sub run
Herb Derby5424a5e2018-11-14 12:04:38 -0500459 SubRun& newSubRun = fSubRunInfo.emplace_back(this, desc, color);
460
Herb Derby69ff8952018-11-12 11:39:12 -0500461 const SubRun& prevSubRun = fSubRunInfo.fromBack(1);
joshualitte43e3bd2015-07-29 11:10:38 -0700462
Herb Derby5424a5e2018-11-14 12:04:38 -0500463 // Forward glyph / vertex information to seed the new sub run
joshualitt18b072d2015-12-07 12:26:12 -0800464 newSubRun.setAsSuccessor(prevSubRun);
Herb Derby317adf72018-11-16 17:29:29 -0500465 return &newSubRun;
joshualitt374b2f72015-07-21 08:05:03 -0700466 }
Jim Van Verth54d9c882018-02-08 16:14:48 -0500467
468 // Any glyphs that can't be rendered with the base or override descriptor
469 // are rendered as paths
470 struct PathGlyph {
471 PathGlyph(const SkPath& path, SkScalar x, SkScalar y, SkScalar scale, bool preXformed)
472 : fPath(path)
473 , fX(x)
474 , fY(y)
475 , fScale(scale)
476 , fPreTransformed(preXformed) {}
477 SkPath fPath;
478 SkScalar fX;
479 SkScalar fY;
480 SkScalar fScale;
481 bool fPreTransformed;
482 };
483
Herb Derbyf7d5d742018-11-16 13:24:32 -0500484
485 sk_sp<SkTypeface> fTypeface;
486 SkSTArray<1, SubRun> fSubRunInfo;
487 SkAutoDescriptor fDescriptor;
488
489 // Effects from the paint that are used to build a SkScalerContext.
490 sk_sp<SkPathEffect> fPathEffect;
491 sk_sp<SkMaskFilter> fMaskFilter;
492
493 // Distance field text cannot draw coloremoji, and so has to fall back. However,
494 // though the distance field text and the coloremoji may share the same run, they
Herb Derby317adf72018-11-16 17:29:29 -0500495 // will have different descriptors. If fARGBFallbackDescriptor is non-nullptr, then it
Herb Derbyf7d5d742018-11-16 13:24:32 -0500496 // will be used in place of the run's descriptor to regen texture coords
Herb Derby317adf72018-11-16 17:29:29 -0500497 std::unique_ptr<SkAutoDescriptor> fARGBFallbackDescriptor;
Herb Derbyf7d5d742018-11-16 13:24:32 -0500498
Jim Van Verth54d9c882018-02-08 16:14:48 -0500499 SkTArray<PathGlyph> fPathGlyphs;
500
Mike Reed48b958b2018-12-03 13:09:02 -0500501 bool fAntiAlias{false}; // needed mainly for rendering paths
Herb Derbyf7d5d742018-11-16 13:24:32 -0500502 bool fInitialized{false};
503
504 GrTextBlob* const fBlob;
Herb Derby5424a5e2018-11-14 12:04:38 -0500505 GrColor fColor;
Jim Van Verth58c3cce2017-10-19 15:50:24 -0400506 }; // Run
joshualitt374b2f72015-07-21 08:05:03 -0700507
Brian Salomonf18b1d82017-10-27 11:30:49 -0400508 inline std::unique_ptr<GrAtlasTextOp> makeOp(
Herb Derby69ff8952018-11-12 11:39:12 -0500509 const SubRun& info, int glyphCount, uint16_t run, uint16_t subRun,
Brian Salomonf18b1d82017-10-27 11:30:49 -0400510 const SkMatrix& viewMatrix, SkScalar x, SkScalar y, const SkIRect& clipRect,
Brian Osmancf860852018-10-31 14:04:39 -0400511 const SkPaint& paint, const SkPMColor4f& filteredColor, const SkSurfaceProps&,
Herb Derbyc1b482c2018-08-09 15:02:27 -0400512 const GrDistanceFieldAdjustTable*, GrTextTarget*);
joshualitt323c2eb2016-01-20 06:48:47 -0800513
joshualitt374b2f72015-07-21 08:05:03 -0700514 struct StrokeInfo {
515 SkScalar fFrameWidth;
516 SkScalar fMiterLimit;
517 SkPaint::Join fJoin;
518 };
519
520 enum TextType {
521 kHasDistanceField_TextType = 0x1,
522 kHasBitmap_TextType = 0x2,
523 };
524
525 // all glyph / vertex offsets are into these pools.
Brian Salomon18923f92017-11-06 16:26:02 -0500526 char* fVertices;
joshualitt374b2f72015-07-21 08:05:03 -0700527 GrGlyph** fGlyphs;
528 Run* fRuns;
Mike Reed80747ef2018-01-23 15:29:32 -0500529 SkMaskFilterBase::BlurRec fBlurRec;
joshualitt374b2f72015-07-21 08:05:03 -0700530 StrokeInfo fStrokeInfo;
joshualitt374b2f72015-07-21 08:05:03 -0700531 Key fKey;
joshualitt8e0ef292016-02-19 14:13:03 -0800532 SkMatrix fInitialViewMatrix;
joshualitt7481e752016-01-22 06:08:48 -0800533 SkMatrix fInitialViewMatrixInverse;
joshualitt2f2ee832016-02-10 08:52:24 -0800534 size_t fSize;
Jim Van Verthbc2cdd12017-06-08 11:14:35 -0400535 SkColor fLuminanceColor;
joshualitt7481e752016-01-22 06:08:48 -0800536 SkScalar fInitialX;
537 SkScalar fInitialY;
joshualitt374b2f72015-07-21 08:05:03 -0700538
539 // We can reuse distance field text, but only if the new viewmatrix would not result in
540 // a mip change. Because there can be multiple runs in a blob, we track the overall
541 // maximum minimum scale, and minimum maximum scale, we can support before we need to regen
542 SkScalar fMaxMinScale;
543 SkScalar fMinMaxScale;
Herb Derby2bb343c2018-11-08 15:03:48 -0500544 int fRunCount{0};
545 int fRunCountLimit;
joshualitt374b2f72015-07-21 08:05:03 -0700546 uint8_t fTextType;
joshualitt374b2f72015-07-21 08:05:03 -0700547};
548
Brian Salomon18923f92017-11-06 16:26:02 -0500549/**
550 * Used to produce vertices for a subrun of a blob. The vertices are cached in the blob itself.
551 * This is invoked each time a sub run is drawn. It regenerates the vertex data as required either
552 * because of changes to the atlas or because of different draw parameters (e.g. color change). In
553 * rare cases the draw may have to interrupted and flushed in the middle of the sub run in order to
554 * free up atlas space. Thus, this generator is stateful and should be invoked in a loop until the
555 * entire sub run has been completed.
556 */
Herb Derby86240592018-05-24 16:12:31 -0400557class GrTextBlob::VertexRegenerator {
Brian Salomon18923f92017-11-06 16:26:02 -0500558public:
559 /**
560 * Consecutive VertexRegenerators often use the same SkGlyphCache. If the same instance of
561 * SkAutoGlyphCache is reused then it can save the cost of multiple detach/attach operations of
562 * SkGlyphCache.
563 */
Herb Derby86240592018-05-24 16:12:31 -0400564 VertexRegenerator(GrResourceProvider*, GrTextBlob*, int runIdx, int subRunIdx,
Robert Phillips4bc70112018-03-01 10:24:02 -0500565 const SkMatrix& viewMatrix, SkScalar x, SkScalar y, GrColor color,
Robert Phillipsc4039ea2018-03-01 11:36:45 -0500566 GrDeferredUploadTarget*, GrGlyphCache*, GrAtlasManager*,
Herb Derby7956b592018-03-22 16:10:30 -0400567 SkExclusiveStrikePtr*);
Brian Salomon18923f92017-11-06 16:26:02 -0500568
569 struct Result {
570 /**
571 * Was regenerate() able to draw all the glyphs from the sub run? If not flush all glyph
572 * draws and call regenerate() again.
573 */
574 bool fFinished = true;
575
576 /**
577 * How many glyphs were regenerated. Will be equal to the sub run's glyph count if
578 * fType is kFinished.
579 */
580 int fGlyphsRegenerated = 0;
581
582 /**
583 * Pointer where the caller finds the first regenerated vertex.
584 */
585 const char* fFirstVertex;
586 };
587
Robert Phillipsd2e9f762018-03-07 11:54:37 -0500588 bool regenerate(Result*);
Brian Salomon18923f92017-11-06 16:26:02 -0500589
590private:
591 template <bool regenPos, bool regenCol, bool regenTexCoords, bool regenGlyphs>
Robert Phillipsd2e9f762018-03-07 11:54:37 -0500592 bool doRegen(Result*);
Brian Salomon18923f92017-11-06 16:26:02 -0500593
Robert Phillips4bc70112018-03-01 10:24:02 -0500594 GrResourceProvider* fResourceProvider;
Brian Salomon18923f92017-11-06 16:26:02 -0500595 const SkMatrix& fViewMatrix;
Herb Derby86240592018-05-24 16:12:31 -0400596 GrTextBlob* fBlob;
Brian Salomon18923f92017-11-06 16:26:02 -0500597 GrDeferredUploadTarget* fUploadTarget;
Robert Phillipsc4039ea2018-03-01 11:36:45 -0500598 GrGlyphCache* fGlyphCache;
599 GrAtlasManager* fFullAtlasManager;
Herb Derby8c4cbf42018-03-09 15:28:04 -0500600 SkExclusiveStrikePtr* fLazyCache;
Brian Salomon18923f92017-11-06 16:26:02 -0500601 Run* fRun;
Herb Derby69ff8952018-11-12 11:39:12 -0500602 SubRun* fSubRun;
Brian Salomon18923f92017-11-06 16:26:02 -0500603 GrColor fColor;
604 SkScalar fTransX;
605 SkScalar fTransY;
606
607 uint32_t fRegenFlags = 0;
608 int fCurrGlyph = 0;
609 bool fBrokenRun = false;
610};
611
Herb Derby86240592018-05-24 16:12:31 -0400612#endif // GrTextBlob_DEFINED