OLD | NEW |
| (Empty) |
1 /* | |
2 * Copyright 2014 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 SkDrawable_DEFINED | |
9 #define SkDrawable_DEFINED | |
10 | |
11 #include "SkRefCnt.h" | |
12 | |
13 class SkCanvas; | |
14 class SkPicture; | |
15 struct SkRect; | |
16 | |
17 /** | |
18 * Base-class for objects that draw into SkCanvas. | |
19 * | |
20 * The object has a generation ID, which is guaranteed to be unique across all
drawables. To | |
21 * allow for clients of the drawable that may want to cache the results, the dr
awable must | |
22 * change its generation ID whenever its internal state changes such that it wi
ll draw differently. | |
23 */ | |
24 class SkDrawable : public SkRefCnt { | |
25 public: | |
26 SkDrawable(); | |
27 | |
28 /** | |
29 * Draws into the specified content. The drawing sequence will be balanced
upon return | |
30 * (i.e. the saveLevel() on the canvas will match what it was when draw() w
as called, | |
31 * and the current matrix and clip settings will not be changed. | |
32 */ | |
33 void draw(SkCanvas*); | |
34 | |
35 SkPicture* newPictureSnapshot(); | |
36 | |
37 /** | |
38 * Return a unique value for this instance. If two calls to this return the
same value, | |
39 * it is presumed that calling the draw() method will render the same thing
as well. | |
40 * | |
41 * Subclasses that change their state should call notifyDrawingChanged() to
ensure that | |
42 * a new value will be returned the next time it is called. | |
43 */ | |
44 uint32_t getGenerationID(); | |
45 | |
46 /** | |
47 * Return the (conservative) bounds of what the drawable will draw. If the
drawable can | |
48 * change what it draws (e.g. animation or in response to some external cha
nge), then this | |
49 * must return a bounds that is always valid for all possible states. | |
50 */ | |
51 SkRect getBounds(); | |
52 | |
53 /** | |
54 * Calling this invalidates the previous generation ID, and causes a new on
e to be computed | |
55 * the next time getGenerationID() is called. Typically this is called by t
he object itself, | |
56 * in response to its internal state changing. | |
57 */ | |
58 void notifyDrawingChanged(); | |
59 | |
60 protected: | |
61 virtual SkRect onGetBounds() = 0; | |
62 virtual void onDraw(SkCanvas*) = 0; | |
63 | |
64 /** | |
65 * Default implementation calls onDraw() with a canvas that records into a
picture. Subclasses | |
66 * may override if they have a more efficient way to return a picture for t
he current state | |
67 * of their drawable. Note: this picture must draw the same as what would b
e drawn from | |
68 * onDraw(). | |
69 */ | |
70 virtual SkPicture* onNewPictureSnapshot(); | |
71 | |
72 private: | |
73 int32_t fGenerationID; | |
74 }; | |
75 | |
76 #endif | |
OLD | NEW |