blob: c06a14b81214764db9fb826be91db0a4d9bc49fe (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
Flattenables
============
Many objects in Skia, such as SkShaders and other effects on SkPaint, need to be
flattened into a data stream for either transport or as part of the key to the
font cache. Classes for these objects should derive from SkFlattenable or one of
its subclasses. If you create a new flattenable class, you need to make sure you
do a few things so that it will work on all platforms:
1: Override the method flatten (the default scope is protected):
<!--?prettify?-->
~~~~
virtual void flatten(SkFlattenableWriteBuffer& buffer) const SK_OVERRIDE {
this->INHERITED::flatten(buffer);
// Write any private data that needs to be stored to recreate this object
}
~~~~
2: Override the (protected) constructor that creates an object from an
SkFlattenableReadBuffer:
<!--?prettify?-->
~~~~
SkNewClass(SkFlattenableReadBuffer& buffer)
: INHERITED(buffer) {
// Read the data from the buffer in the same order as it was written to the
// SkFlattenableWriteBuffer and construct the new object
}
~~~~
3: Declare a set of deserialization procs for your object in the class declaration:
We have a macro for this:
<!--?prettify?-->
~~~~
public:
SK_DECLARE_PUBLIC_FLATTENABLE_DESERIALIZATION_PROCS(SkNewClass)
~~~~
4: If your class is declared in a .cpp file or in a private header file, create a
function to register its group:
This occurs in cases where the classes are hidden behind a factory, like many effects
and shaders are. Then in the parent class header file (such as SkGradientShader) you
need to add:
<!--?prettify?-->
~~~~
public:
SK_DECLARE_FLATTENABLE_REGISTRAR_GROUP()
~~~~
Then in the cpp file you define all the members of the group together:
<!--?prettify?-->
~~~~
SK_DEFINE_FLATTENABLE_REGISTRAR_GROUP_START(SkGroupClass)
SK_DEFINE_FLATTENABLE_REGISTRAR_ENTRY(SkMemberClass1)
SK_DEFINE_FLATTENABLE_REGISTRAR_ENTRY(SkMemberClass2)
// etc
SK_DEFINE_FLATTENABLE_REGISTRAR_GROUP_END
~~~~
5: Register your flattenable with the global registrar:
You need to add one line to SkFlattenable::InitalizeFlattenables(). To register the
flattenable in a Skia build, that function is defined in SkGlobalInitialization_default.cpp.
For Chromium, it is in SkGlobalInitialization_chromium.cpp.
For a single flattenable add
<!--?prettify?-->
~~~~
SK_DEFINE_FLATTENABLE_REGISTRAR_ENTRY(SkNewClass)
~~~~
For a group, add
<!--?prettify?-->
~~~~
SkGroupClass::InitializeFlattenables();
~~~~
|
