[go: nahoru, domu]
Google Git
Sign in
chromium / chromium / src / f325d9877fad2d3a6351dc5df35393534310c3e1 / . / cc / paint / paint_canvas.h
blob: 04e6bf713b7031b4e4c330929528fac64ce7e59d [file] [log] [blame]
enne34f6084c2017-02-02 22:39:08[diff] [blame]1// Copyright 2017 The Chromium Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style license that can be
3// found in the LICENSE file.
4
5#ifndef CC_PAINT_PAINT_CANVAS_H_
6#define CC_PAINT_PAINT_CANVAS_H_
7
enned2501572017-03-09 19:59:17[diff] [blame]8#include "base/compiler_specific.h"
Keishi Hattori0e45c022021-11-27 09:25:52[diff] [blame]9#include "base/memory/raw_ptr.h"
enneea15ddb2017-03-22 01:49:08[diff] [blame]10#include "base/memory/ref_counted.h"
enne7b64edf32017-02-16 20:10:02[diff] [blame]11#include "build/build_config.h"
Tao Bai1e1deb412019-07-21 16:14:00[diff] [blame]12#include "cc/paint/node_id.h"
enne34f6084c2017-02-02 22:39:08[diff] [blame]13#include "cc/paint/paint_export.h"
vmpstr94cfa882017-04-14 01:19:35[diff] [blame]14#include "cc/paint/paint_image.h"
Avery Musbachdc01059f2022-01-12 22:10:59[diff] [blame]15#include "cc/paint/skottie_color_map.h"
Eric Sum4cf51cc2021-11-09 02:21:38[diff] [blame]16#include "cc/paint/skottie_frame_data.h"
Eric Sumc7435712022-02-22 18:33:44[diff] [blame]17#include "cc/paint/skottie_text_property_value.h"
enne34f6084c2017-02-02 22:39:08[diff] [blame]18#include "third_party/skia/include/core/SkCanvas.h"
Peter Kasting73ee7ef2021-07-20 19:47:56[diff] [blame]19
20class SkTextBlob;
enne34f6084c2017-02-02 22:39:08[diff] [blame]21
Florin Malita15935772019-02-06 21:52:24[diff] [blame]22namespace printing {
23class MetafileSkia;
24} // namespace printing
25
ckitagawa53eeaef2019-11-08 15:17:34[diff] [blame]26namespace paint_preview {
27class PaintPreviewTracker;
28} // namespace paint_preview
29
enne34f6084c2017-02-02 22:39:08[diff] [blame]30namespace cc {
Malay Keshavcf4ceef12018-10-19 17:56:51[diff] [blame]31class SkottieWrapper;
enned2501572017-03-09 19:59:17[diff] [blame]32class PaintFlags;
enne59df29de2017-05-02 03:23:37[diff] [blame]33class PaintOpBuffer;
34
Justin Novosad2756a7d52021-06-09 15:50:38[diff] [blame]35enum class UsePaintCache { kDisabled = 0, kEnabled };
36
enne59df29de2017-05-02 03:23:37[diff] [blame]37using PaintRecord = PaintOpBuffer;
enne34f6084c2017-02-02 22:39:08[diff] [blame]38
Adrienne Walker26aac6e52018-10-23 19:23:37[diff] [blame]39// PaintCanvas is the cc/paint wrapper of SkCanvas. It has a more restricted
40// interface than SkCanvas (trimmed back to only what Chrome uses). Its reason
41// for existence is so that it can do custom serialization logic into a
42// PaintOpBuffer which (unlike SkPicture) is mutable, handles image replacement,
43// and can be serialized in custom ways (such as using the transfer cache).
44//
45// PaintCanvas is usually implemented by either:
46// (1) SkiaPaintCanvas, which is backed by an SkCanvas, usually for rasterizing.
47// (2) RecordPaintCanvas, which records paint commands into a PaintOpBuffer.
48//
49// SkiaPaintCanvas allows callers to go from PaintCanvas to SkCanvas (or
50// PaintRecord to SkPicture), but this is a one way trip. There is no way to go
51// from SkCanvas to PaintCanvas or from SkPicture back into PaintRecord.
enned2501572017-03-09 19:59:17[diff] [blame]52class CC_PAINT_EXPORT PaintCanvas {
enne34f6084c2017-02-02 22:39:08[diff] [blame]53 public:
Vladimir Levinf06d1cd72019-03-13 18:24:10[diff] [blame]54 PaintCanvas() = default;
55 PaintCanvas(const PaintCanvas&) = delete;
56 virtual ~PaintCanvas() = default;
57
58 PaintCanvas& operator=(const PaintCanvas&) = delete;
khushalsagarb74f9122017-03-22 04:37:47[diff] [blame]59
enne59df29de2017-05-02 03:23:37[diff] [blame]60 // TODO(enne): this only appears to mostly be used to determine if this is
61 // recording or not, so could be simplified or removed.
enne98c9f8052017-03-15 19:38:22[diff] [blame]62 virtual SkImageInfo imageInfo() const = 0;
enned2501572017-03-09 19:59:17[diff] [blame]63
Tom Andersonbec09512019-09-16 20:32:16[diff] [blame]64 virtual void* accessTopLayerPixels(SkImageInfo* info,
65 size_t* rowBytes,
66 SkIPoint* origin = nullptr) = 0;
67
enned2501572017-03-09 19:59:17[diff] [blame]68 // TODO(enne): It would be nice to get rid of flush() entirely, as it
69 // doesn't really make sense for recording. However, this gets used by
zhuoyu.qian4689dde22017-10-16 04:11:48[diff] [blame]70 // PaintCanvasVideoRenderer which takes a PaintCanvas to paint both
enned2501572017-03-09 19:59:17[diff] [blame]71 // software and hardware video. This is super entangled with ImageBuffer
72 // and canvas/video painting in Blink where the same paths are used for
73 // both recording and gpu work.
enne98c9f8052017-03-15 19:38:22[diff] [blame]74 virtual void flush() = 0;
enned2501572017-03-09 19:59:17[diff] [blame]75
enne98c9f8052017-03-15 19:38:22[diff] [blame]76 virtual int save() = 0;
77 virtual int saveLayer(const SkRect* bounds, const PaintFlags* flags) = 0;
Peter Kastingfe4ba932019-01-07 20:21:05[diff] [blame]78 virtual int saveLayerAlpha(const SkRect* bounds, uint8_t alpha) = 0;
enne98c9f8052017-03-15 19:38:22[diff] [blame]79
80 virtual void restore() = 0;
81 virtual int getSaveCount() const = 0;
82 virtual void restoreToCount(int save_count) = 0;
83 virtual void translate(SkScalar dx, SkScalar dy) = 0;
84 virtual void scale(SkScalar sx, SkScalar sy) = 0;
Vladimir Levin32c16e132021-11-19 20:26:48[diff] [blame]85 void scale(SkScalar s) { scale(s, s); }
enne98c9f8052017-03-15 19:38:22[diff] [blame]86 virtual void rotate(SkScalar degrees) = 0;
Aaron Krajeski5e542c82020-12-05 01:50:21[diff] [blame]87 // TODO(aaronhk): crbug.com/1153330 deprecate these in favor of the SkM44
Aaron Krajeski8a128e232020-12-15 21:47:06[diff] [blame]88 // versions.
enne98c9f8052017-03-15 19:38:22[diff] [blame]89 virtual void concat(const SkMatrix& matrix) = 0;
90 virtual void setMatrix(const SkMatrix& matrix) = 0;
Aaron Krajeski8a128e232020-12-15 21:47:06[diff] [blame]91 virtual void concat(const SkM44& matrix) = 0;
Aaron Krajeski5e542c82020-12-05 01:50:21[diff] [blame]92 virtual void setMatrix(const SkM44& matrix) = 0;
93
enne98c9f8052017-03-15 19:38:22[diff] [blame]94 virtual void clipRect(const SkRect& rect,
95 SkClipOp op,
96 bool do_anti_alias) = 0;
97 void clipRect(const SkRect& rect, SkClipOp op) { clipRect(rect, op, false); }
98 void clipRect(const SkRect& rect, bool do_anti_alias) {
99 clipRect(rect, SkClipOp::kIntersect, do_anti_alias);
enned2501572017-03-09 19:59:17[diff] [blame]100 }
enne98c9f8052017-03-15 19:38:22[diff] [blame]101 void clipRect(const SkRect& rect) {
102 clipRect(rect, SkClipOp::kIntersect, false);
enned2501572017-03-09 19:59:17[diff] [blame]103 }
104
enne98c9f8052017-03-15 19:38:22[diff] [blame]105 virtual void clipRRect(const SkRRect& rrect,
106 SkClipOp op,
107 bool do_anti_alias) = 0;
108 void clipRRect(const SkRRect& rrect, bool do_anti_alias) {
109 clipRRect(rrect, SkClipOp::kIntersect, do_anti_alias);
enned2501572017-03-09 19:59:17[diff] [blame]110 }
enne98c9f8052017-03-15 19:38:22[diff] [blame]111 void clipRRect(const SkRRect& rrect, SkClipOp op) {
112 clipRRect(rrect, op, false);
enned2501572017-03-09 19:59:17[diff] [blame]113 }
enne98c9f8052017-03-15 19:38:22[diff] [blame]114 void clipRRect(const SkRRect& rrect) {
115 clipRRect(rrect, SkClipOp::kIntersect, false);
enned2501572017-03-09 19:59:17[diff] [blame]116 }
enned2501572017-03-09 19:59:17[diff] [blame]117
enne98c9f8052017-03-15 19:38:22[diff] [blame]118 virtual void clipPath(const SkPath& path,
119 SkClipOp op,
Justin Novosad2756a7d52021-06-09 15:50:38[diff] [blame]120 bool do_anti_alias,
121 UsePaintCache) = 0;
122 void clipPath(const SkPath& path, SkClipOp op, bool do_anti_alias) {
123 clipPath(path, op, do_anti_alias, UsePaintCache::kEnabled);
124 }
125 void clipPath(const SkPath& path, SkClipOp op) {
126 clipPath(path, op, /*do_anti_alias=*/false, UsePaintCache::kEnabled);
127 }
enne98c9f8052017-03-15 19:38:22[diff] [blame]128 void clipPath(const SkPath& path, bool do_anti_alias) {
Justin Novosad2756a7d52021-06-09 15:50:38[diff] [blame]129 clipPath(path, SkClipOp::kIntersect, do_anti_alias,
130 UsePaintCache::kEnabled);
enned2501572017-03-09 19:59:17[diff] [blame]131 }
enne98c9f8052017-03-15 19:38:22[diff] [blame]132
enne98c9f8052017-03-15 19:38:22[diff] [blame]133 virtual SkRect getLocalClipBounds() const = 0;
134 virtual bool getLocalClipBounds(SkRect* bounds) const = 0;
135 virtual SkIRect getDeviceClipBounds() const = 0;
136 virtual bool getDeviceClipBounds(SkIRect* bounds) const = 0;
137 virtual void drawColor(SkColor color, SkBlendMode mode) = 0;
138 void drawColor(SkColor color) { drawColor(color, SkBlendMode::kSrcOver); }
enne59df29de2017-05-02 03:23:37[diff] [blame]139
140 // TODO(enne): This is a synonym for drawColor with kSrc. Remove it.
enne98c9f8052017-03-15 19:38:22[diff] [blame]141 virtual void clear(SkColor color) = 0;
Aaron Krajeskif325d982022-07-08 16:12:35[diff] [blame^]142 virtual void clear(SkColor4f color) = 0;
enne98c9f8052017-03-15 19:38:22[diff] [blame]143
144 virtual void drawLine(SkScalar x0,
145 SkScalar y0,
146 SkScalar x1,
147 SkScalar y1,
148 const PaintFlags& flags) = 0;
149 virtual void drawRect(const SkRect& rect, const PaintFlags& flags) = 0;
150 virtual void drawIRect(const SkIRect& rect, const PaintFlags& flags) = 0;
151 virtual void drawOval(const SkRect& oval, const PaintFlags& flags) = 0;
152 virtual void drawRRect(const SkRRect& rrect, const PaintFlags& flags) = 0;
153 virtual void drawDRRect(const SkRRect& outer,
154 const SkRRect& inner,
155 const PaintFlags& flags) = 0;
enne98c9f8052017-03-15 19:38:22[diff] [blame]156 virtual void drawRoundRect(const SkRect& rect,
157 SkScalar rx,
158 SkScalar ry,
159 const PaintFlags& flags) = 0;
Justin Novosad2756a7d52021-06-09 15:50:38[diff] [blame]160 virtual void drawPath(const SkPath& path,
161 const PaintFlags& flags,
162 UsePaintCache) = 0;
163 void drawPath(const SkPath& path, const PaintFlags& flags) {
164 drawPath(path, flags, UsePaintCache::kEnabled);
165 }
vmpstr94cfa882017-04-14 01:19:35[diff] [blame]166 virtual void drawImage(const PaintImage& image,
enne98c9f8052017-03-15 19:38:22[diff] [blame]167 SkScalar left,
168 SkScalar top,
Mike Reed859086a2021-01-23 18:19:15[diff] [blame]169 const SkSamplingOptions&,
enne98c9f8052017-03-15 19:38:22[diff] [blame]170 const PaintFlags* flags) = 0;
vmpstr94cfa882017-04-14 01:19:35[diff] [blame]171 void drawImage(const PaintImage& image, SkScalar left, SkScalar top) {
Mike Reed859086a2021-01-23 18:19:15[diff] [blame]172 drawImage(image, left, top, SkSamplingOptions(), nullptr);
enned2501572017-03-09 19:59:17[diff] [blame]173 }
174
vmpstr94cfa882017-04-14 01:19:35[diff] [blame]175 virtual void drawImageRect(const PaintImage& image,
enne98c9f8052017-03-15 19:38:22[diff] [blame]176 const SkRect& src,
177 const SkRect& dst,
Mike Reed859086a2021-01-23 18:19:15[diff] [blame]178 const SkSamplingOptions&,
enne98c9f8052017-03-15 19:38:22[diff] [blame]179 const PaintFlags* flags,
jongdeok.kim50b377072020-05-15 22:16:12[diff] [blame]180 SkCanvas::SrcRectConstraint constraint) = 0;
Mike Reed859086a2021-01-23 18:19:15[diff] [blame]181 void drawImageRect(const PaintImage& image,
182 const SkRect& src,
183 const SkRect& dst,
184 SkCanvas::SrcRectConstraint constraint) {
185 drawImageRect(image, src, dst, SkSamplingOptions(), nullptr, constraint);
186 }
enned2501572017-03-09 19:59:17[diff] [blame]187
Malay Keshavcf4ceef12018-10-19 17:56:51[diff] [blame]188 // Draws the frame of the |skottie| animation specified by the normalized time
189 // t [0->first frame..1->last frame] at the destination bounds given by |dst|
Eric Sum4cf51cc2021-11-09 02:21:38[diff] [blame]190 // onto the canvas. |images| is a map from asset id to the corresponding image
191 // to use when rendering this frame; it may be empty if this animation frame
192 // does not contain any images in it.
Malay Keshavcf4ceef12018-10-19 17:56:51[diff] [blame]193 virtual void drawSkottie(scoped_refptr<SkottieWrapper> skottie,
194 const SkRect& dst,
Eric Sum4cf51cc2021-11-09 02:21:38[diff] [blame]195 float t,
Avery Musbachdc01059f2022-01-12 22:10:59[diff] [blame]196 SkottieFrameDataMap images,
Eric Sumc7435712022-02-22 18:33:44[diff] [blame]197 const SkottieColorMap& color_map,
198 SkottieTextPropertyValueMap text_map) = 0;
Malay Keshavcf4ceef12018-10-19 17:56:51[diff] [blame]199
Khushal464808c92018-10-19 23:45:59[diff] [blame]200 virtual void drawTextBlob(sk_sp<SkTextBlob> blob,
enne98c9f8052017-03-15 19:38:22[diff] [blame]201 SkScalar x,
202 SkScalar y,
203 const PaintFlags& flags) = 0;
enned2501572017-03-09 19:59:17[diff] [blame]204
Tao Baiedaf87092019-01-30 23:12:54[diff] [blame]205 virtual void drawTextBlob(sk_sp<SkTextBlob> blob,
206 SkScalar x,
207 SkScalar y,
Tao Bai1e1deb412019-07-21 16:14:00[diff] [blame]208 NodeId node_id,
209 const PaintFlags& flags) = 0;
Tao Baiedaf87092019-01-30 23:12:54[diff] [blame]210
Adrienne Walker15ce23502017-05-08 18:08:15[diff] [blame]211 // Unlike SkCanvas::drawPicture, this only plays back the PaintRecord and does
212 // not add an additional clip. This is closer to SkPicture::playback.
ennedffda502017-03-23 20:46:43[diff] [blame]213 virtual void drawPicture(sk_sp<const PaintRecord> record) = 0;
enned2501572017-03-09 19:59:17[diff] [blame]214
enne98c9f8052017-03-15 19:38:22[diff] [blame]215 virtual bool isClipEmpty() const = 0;
Mike Reedf97e2d162020-01-07 15:26:43[diff] [blame]216 virtual SkMatrix getTotalMatrix() const = 0;
Aaron Krajeskie18de512021-04-15 15:17:03[diff] [blame]217 virtual SkM44 getLocalToDevice() const = 0;
enned2501572017-03-09 19:59:17[diff] [blame]218
Justin Novosaddae425072021-11-11 19:50:43[diff] [blame]219 virtual bool NeedsFlush() const = 0;
220
Florin Malita15935772019-02-06 21:52:24[diff] [blame]221 // Used for printing
enne5fa117a2017-04-04 20:56:58[diff] [blame]222 enum class AnnotationType {
223 URL,
224 NAMED_DESTINATION,
225 LINK_TO_DESTINATION,
226 };
227 virtual void Annotate(AnnotationType type,
228 const SkRect& rect,
229 sk_sp<SkData> data) = 0;
Florin Malita15935772019-02-06 21:52:24[diff] [blame]230 printing::MetafileSkia* GetPrintingMetafile() const { return metafile_; }
231 void SetPrintingMetafile(printing::MetafileSkia* metafile) {
232 metafile_ = metafile;
233 }
ckitagawa53eeaef2019-11-08 15:17:34[diff] [blame]234 paint_preview::PaintPreviewTracker* GetPaintPreviewTracker() const {
235 return tracker_;
236 }
237 void SetPaintPreviewTracker(paint_preview::PaintPreviewTracker* tracker) {
238 tracker_ = tracker;
239 }
enned2501572017-03-09 19:59:17[diff] [blame]240
Wei Li2a9bfe42018-01-13 05:42:56[diff] [blame]241 // Subclasses can override to handle custom data.
242 virtual void recordCustomData(uint32_t id) {}
243
Dominic Mazzonicf5d6b02020-03-06 19:49:12[diff] [blame]244 // Used for marked content in PDF files.
245 virtual void setNodeId(int) = 0;
246
enne59df29de2017-05-02 03:23:37[diff] [blame]247 private:
Florin Malita15935772019-02-06 21:52:24[diff] [blame]248 printing::MetafileSkia* metafile_ = nullptr;
ckitagawa53eeaef2019-11-08 15:17:34[diff] [blame]249 paint_preview::PaintPreviewTracker* tracker_ = nullptr;
enne34f6084c2017-02-02 22:39:08[diff] [blame]250};
251
enned2501572017-03-09 19:59:17[diff] [blame]252class CC_PAINT_EXPORT PaintCanvasAutoRestore {
253 public:
enne98c9f8052017-03-15 19:38:22[diff] [blame]254 PaintCanvasAutoRestore(PaintCanvas* canvas, bool save) : canvas_(canvas) {
enned2501572017-03-09 19:59:17[diff] [blame]255 if (canvas_) {
256 save_count_ = canvas_->getSaveCount();
257 if (save) {
258 canvas_->save();
259 }
260 }
261 }
262
enne98c9f8052017-03-15 19:38:22[diff] [blame]263 ~PaintCanvasAutoRestore() {
enned2501572017-03-09 19:59:17[diff] [blame]264 if (canvas_) {
265 canvas_->restoreToCount(save_count_);
266 }
267 }
268
enne98c9f8052017-03-15 19:38:22[diff] [blame]269 void restore() {
enned2501572017-03-09 19:59:17[diff] [blame]270 if (canvas_) {
271 canvas_->restoreToCount(save_count_);
272 canvas_ = nullptr;
273 }
274 }
275
276 private:
Keishi Hattori0e45c022021-11-27 09:25:52[diff] [blame]277 raw_ptr<PaintCanvas> canvas_ = nullptr;
enned2501572017-03-09 19:59:17[diff] [blame]278 int save_count_ = 0;
279};
280
enne34f6084c2017-02-02 22:39:08[diff] [blame]281} // namespace cc
282
283#endif // CC_PAINT_PAINT_CANVAS_H_