OLD | NEW |
1 /* | 1 /* |
2 * Copyright 2013 Google Inc. | 2 * Copyright 2013 Google Inc. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license that can be | 4 * Use of this source code is governed by a BSD-style license that can be |
5 * found in the LICENSE file. | 5 * found in the LICENSE file. |
6 */ | 6 */ |
7 | 7 |
8 #ifndef SkCanvasStateUtils_DEFINED | 8 #ifndef SkCanvasStateUtils_DEFINED |
9 #define SkCanvasStateUtils_DEFINED | 9 #define SkCanvasStateUtils_DEFINED |
10 | 10 |
11 #include "SkCanvas.h" | 11 #include "SkCanvas.h" |
12 | 12 |
13 class SkCanvasState; | 13 class SkCanvasState; |
14 | 14 |
15 /** | 15 /** |
16 * A set of functions that are useful for copying the state of an SkCanvas | 16 * A set of functions that are useful for copying the state of an SkCanvas |
17 * across a library boundary where the Skia library on the other side of the | 17 * across a library boundary where the Skia library on the other side of the |
18 * boundary may be newer. The expected usage is outline below... | 18 * boundary may be newer. The expected usage is outline below... |
19 * | 19 * |
20 * Lib Boundary | 20 * Lib Boundary |
21 * CaptureCanvasState(...) ||| | 21 * CaptureCanvasState(...) ||| |
22 * SkCanvas --> SkCanvasState ||| | 22 * SkCanvas --> SkCanvasState ||| |
23 * ||| CreateFromCanvasState(...) | 23 * ||| CreateFromCanvasState(...) |
24 * ||| SkCanvasState --> SkCanvas` | 24 * ||| SkCanvasState --> SkCanvas` |
25 * ||| Draw into SkCanvas` | 25 * ||| Draw into SkCanvas` |
26 * ||| Unref SkCanvas` | 26 * ||| Unref SkCanvas` |
27 * ReleaseCanvasState(...) ||| | 27 * ReleaseCanvasState(...) ||| |
28 * | 28 * |
29 */ | 29 */ |
30 namespace SkCanvasStateUtils { | 30 class SK_API SkCanvasStateUtils { |
| 31 public: |
31 /** | 32 /** |
32 * Captures the current state of the canvas into an opaque ptr that is safe | 33 * Captures the current state of the canvas into an opaque ptr that is safe |
33 * to pass to a different instance of Skia (which may be the same version, | 34 * to pass to a different instance of Skia (which may be the same version, |
34 * or may be newer). The function will return NULL in the event that one of
the | 35 * or may be newer). The function will return NULL in the event that one of
the |
35 * following conditions are true. | 36 * following conditions are true. |
36 * 1) the canvas device type is not supported (currently only raster is sup
ported) | 37 * 1) the canvas device type is not supported (currently only raster is sup
ported) |
37 * 2) the canvas clip type is not supported (currently only non-AA clips ar
e supported) | 38 * 2) the canvas clip type is not supported (currently only non-AA clips ar
e supported) |
38 * | 39 * |
39 * It is recommended that the original canvas also not be used until all | 40 * It is recommended that the original canvas also not be used until all |
40 * canvases that have been created using its captured state have been derefe
renced. | 41 * canvases that have been created using its captured state have been derefe
renced. |
41 * | 42 * |
42 * Finally, it is important to note that any draw filters attached to the | 43 * Finally, it is important to note that any draw filters attached to the |
43 * canvas are NOT currently captured. | 44 * canvas are NOT currently captured. |
44 * | 45 * |
45 * @param canvas The canvas you wish to capture the current state of. | 46 * @param canvas The canvas you wish to capture the current state of. |
46 * @return NULL or an opaque ptr that can be passed to CreateFromCanvasState | 47 * @return NULL or an opaque ptr that can be passed to CreateFromCanvasState |
47 * to reconstruct the canvas. The caller is responsible for calling | 48 * to reconstruct the canvas. The caller is responsible for calling |
48 * ReleaseCanvasState to free the memory associated with this state. | 49 * ReleaseCanvasState to free the memory associated with this state. |
49 */ | 50 */ |
50 SK_API SkCanvasState* CaptureCanvasState(SkCanvas* canvas); | 51 static SkCanvasState* CaptureCanvasState(SkCanvas* canvas); |
51 | 52 |
52 /** | 53 /** |
53 * Create a new SkCanvas from the captured state of another SkCanvas. The | 54 * Create a new SkCanvas from the captured state of another SkCanvas. The |
54 * function will return NULL in the event that one of the | 55 * function will return NULL in the event that one of the |
55 * following conditions are true. | 56 * following conditions are true. |
56 * 1) the captured state is in an unrecognized format | 57 * 1) the captured state is in an unrecognized format |
57 * 2) the captured canvas device type is not supported | 58 * 2) the captured canvas device type is not supported |
58 * | 59 * |
59 * @param state Opaque object created by CaptureCanvasState. | 60 * @param state Opaque object created by CaptureCanvasState. |
60 * @return NULL or an SkCanvas* whose devices and matrix/clip state are | 61 * @return NULL or an SkCanvas* whose devices and matrix/clip state are |
61 * identical to the captured canvas. The caller is responsible for | 62 * identical to the captured canvas. The caller is responsible for |
62 * calling unref on the SkCanvas. | 63 * calling unref on the SkCanvas. |
63 */ | 64 */ |
64 SK_API SkCanvas* CreateFromCanvasState(const SkCanvasState* state); | 65 static SkCanvas* CreateFromCanvasState(const SkCanvasState* state); |
65 | 66 |
66 /** | 67 /** |
67 * Free the memory associated with the captured canvas state. The state | 68 * Free the memory associated with the captured canvas state. The state |
68 * should not be released until all SkCanvas objects created using that | 69 * should not be released until all SkCanvas objects created using that |
69 * state have been dereferenced. Must be called from the same library | 70 * state have been dereferenced. Must be called from the same library |
70 * instance that created the state via CaptureCanvasState. | 71 * instance that created the state via CaptureCanvasState. |
71 * | 72 * |
72 * @param state The captured state you wish to dispose of. | 73 * @param state The captured state you wish to dispose of. |
73 */ | 74 */ |
74 SK_API void ReleaseCanvasState(SkCanvasState* state); | 75 static void ReleaseCanvasState(SkCanvasState* state); |
75 }; | 76 }; |
76 | 77 |
77 #endif | 78 #endif |
OLD | NEW |