1 
2 /*
3  * Copyright 2006 The Android Open Source Project
4  *
5  * Use of this source code is governed by a BSD-style license that can be
6  * found in the LICENSE file.
7  */
8 
9 
10 #ifndef SkDraw_DEFINED
11 #define SkDraw_DEFINED
12 
13 #include "include/core/SkCanvas.h"
14 #include "include/core/SkPaint.h"
15 #include "include/core/SkPixmap.h"
16 #include "include/core/SkStrokeRec.h"
17 #include "include/core/SkVertices.h"
18 #include "src/core/SkGlyphRunPainter.h"
19 #include "src/core/SkMask.h"
20 
21 class SkBitmap;
22 class SkClipStack;
23 class SkBaseDevice;
24 class SkBlitter;
25 class SkMatrix;
26 class SkPath;
27 class SkRegion;
28 class SkRasterClip;
29 struct SkRect;
30 class SkRRect;
31 
32 class SkDraw : public SkGlyphRunListPainter::BitmapDevicePainter {
33 public:
34     SkDraw();
35 
36     void    drawPaint(const SkPaint&) const;
37     void    drawPoints(SkCanvas::PointMode, size_t count, const SkPoint[],
38                        const SkPaint&, SkBaseDevice*) const;
39     void    drawRect(const SkRect& prePaintRect, const SkPaint&, const SkMatrix* paintMatrix,
40                      const SkRect* postPaintRect) const;
drawRect(const SkRect & rect,const SkPaint & paint)41     void    drawRect(const SkRect& rect, const SkPaint& paint) const {
42         this->drawRect(rect, paint, nullptr, nullptr);
43     }
44     void    drawRRect(const SkRRect&, const SkPaint&) const;
45     /**
46      *  To save on mallocs, we allow a flag that tells us that srcPath is
47      *  mutable, so that we don't have to make copies of it as we transform it.
48      *
49      *  If prePathMatrix is not null, it should logically be applied before any
50      *  stroking or other effects. If there are no effects on the paint that
51      *  affect the geometry/rasterization, then the pre matrix can just be
52      *  pre-concated with the current matrix.
53      */
54     void    drawPath(const SkPath& path, const SkPaint& paint,
55                      const SkMatrix* prePathMatrix = nullptr, bool pathIsMutable = false) const {
56         this->drawPath(path, paint, prePathMatrix, pathIsMutable, false);
57     }
58 
59     /* If dstOrNull is null, computes a dst by mapping the bitmap's bounds through the matrix. */
60     void    drawBitmap(const SkBitmap&, const SkMatrix&, const SkRect* dstOrNull,
61                        const SkPaint&) const;
62     void    drawSprite(const SkBitmap&, int x, int y, const SkPaint&) const;
63     void    drawGlyphRunList(const SkGlyphRunList& glyphRunList,
64                              SkGlyphRunListPainter* glyphPainter) const;
65     void    drawVertices(SkVertices::VertexMode mode, int vertexCount,
66                          const SkPoint vertices[], const SkPoint textures[],
67                          const SkColor colors[], const SkVertices::BoneIndices boneIndices[],
68                          const SkVertices::BoneWeights boneWeights[], SkBlendMode bmode,
69                          const uint16_t indices[], int ptCount,
70                          const SkPaint& paint, const SkVertices::Bone bones[], int boneCount) const;
71     void  drawAtlas(const SkImage*, const SkRSXform[], const SkRect[], const SkColor[], int count,
72                     SkBlendMode, const SkPaint&);
73 
74     /**
75      *  Overwrite the target with the path's coverage (i.e. its mask).
76      *  Will overwrite the entire device, so it need not be zero'd first.
77      *
78      *  Only device A8 is supported right now.
79      */
80     void drawPathCoverage(const SkPath& src, const SkPaint& paint,
81                           SkBlitter* customBlitter = nullptr) const {
82         bool isHairline = paint.getStyle() == SkPaint::kStroke_Style &&
83                           paint.getStrokeWidth() > 0;
84         this->drawPath(src, paint, nullptr, false, !isHairline, customBlitter);
85     }
86 
87     void paintPaths(SkDrawableGlyphBuffer* drawables,
88                     SkScalar scale,
89                     const SkPaint& paint) const override;
90 
91     void paintMasks(SkDrawableGlyphBuffer* drawables, const SkPaint& paint) const override;
92 
93     static bool ComputeMaskBounds(const SkRect& devPathBounds, const SkIRect* clipBounds,
94                                   const SkMaskFilter* filter, const SkMatrix* filterMatrix,
95                                   SkIRect* bounds);
96 
97     /** Helper function that creates a mask from a path and an optional maskfilter.
98         Note however, that the resulting mask will not have been actually filtered,
99         that must be done afterwards (by calling filterMask). The maskfilter is provided
100         solely to assist in computing the mask's bounds (if the mode requests that).
101     */
102     static bool DrawToMask(const SkPath& devPath, const SkIRect* clipBounds,
103                            const SkMaskFilter*, const SkMatrix* filterMatrix,
104                            SkMask* mask, SkMask::CreateMode mode,
105                            SkStrokeRec::InitStyle style);
106 
107     void drawDevMask(const SkMask& mask, const SkPaint&) const;
108 
109     enum RectType {
110         kHair_RectType,
111         kFill_RectType,
112         kStroke_RectType,
113         kPath_RectType
114     };
115 
116     /**
117      *  Based on the paint's style, strokeWidth, and the matrix, classify how
118      *  to draw the rect. If no special-case is available, returns
119      *  kPath_RectType.
120      *
121      *  Iff RectType == kStroke_RectType, then strokeSize is set to the device
122      *  width and height of the stroke.
123      */
124     static RectType ComputeRectType(const SkPaint&, const SkMatrix&,
125                                     SkPoint* strokeSize);
126 
127     static SkScalar ComputeResScaleForStroking(const SkMatrix& matrix);
128 private:
129     void drawBitmapAsMask(const SkBitmap&, const SkPaint&) const;
130 
131     void drawPath(const SkPath&,
132                   const SkPaint&,
133                   const SkMatrix* preMatrix,
134                   bool pathIsMutable,
135                   bool drawCoverage,
136                   SkBlitter* customBlitter = nullptr) const;
137 
138     void drawLine(const SkPoint[2], const SkPaint&) const;
139 
140     void drawDevPath(const SkPath& devPath,
141                      const SkPaint& paint,
142                      bool drawCoverage,
143                      SkBlitter* customBlitter,
144                      bool doFill) const;
145     /**
146      *  Return the current clip bounds, in local coordinates, with slop to account
147      *  for antialiasing or hairlines (i.e. device-bounds outset by 1, and then
148      *  run through the inverse of the matrix).
149      *
150      *  If the matrix cannot be inverted, or the current clip is empty, return
151      *  false and ignore bounds parameter.
152      */
153     bool SK_WARN_UNUSED_RESULT computeConservativeLocalClipBounds(SkRect* bounds) const;
154 
155 public:
156     SkPixmap        fDst;
157     const SkMatrix* fMatrix{nullptr};        // required
158     const SkRasterClip* fRC{nullptr};        // required
159 
160     // optional, will be same dimensions as fDst if present
161     const SkPixmap* fCoverage{nullptr};
162 
163 #ifdef SK_DEBUG
164     void validate() const;
165 #else
validate()166     void validate() const {}
167 #endif
168 };
169 
170 #endif
171