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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
/*
* Copyright 2014 Google Inc.
*
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef SkRemotableFontMgr_DEFINED
#define SkRemotableFontMgr_DEFINED
#include "../private/SkTemplates.h"
#include "SkFontStyle.h"
#include "SkRefCnt.h"
#include "SkTypes.h"
class SkDataTable;
class SkStreamAsset;
struct SK_API SkFontIdentity {
static const uint32_t kInvalidDataId = 0xFFFFFFFF;
// Note that fDataId is a data identifier, not a font identifier.
// (fDataID, fTtcIndex) can be seen as a font identifier.
uint32_t fDataId;
uint32_t fTtcIndex;
// On Linux/FontConfig there is also the ability to specify preferences for rendering
// antialias, embedded bitmaps, autohint, hinting, hintstyle, lcd rendering
// may all be set or set to no-preference
// (No-preference is resolved against globals set by the platform)
// Since they may be selected against, these are really 'extensions' to SkFontStyle.
// SkFontStyle should pick these up.
SkFontStyle fFontStyle;
};
class SK_API SkRemotableFontIdentitySet : public SkRefCnt {
public:
SkRemotableFontIdentitySet(int count, SkFontIdentity** data);
int count() const { return fCount; }
const SkFontIdentity& at(int index) const { return fData[index]; }
static SkRemotableFontIdentitySet* NewEmpty();
private:
SkRemotableFontIdentitySet() : fCount(0), fData() { }
friend SkRemotableFontIdentitySet* sk_remotable_font_identity_set_new();
int fCount;
SkAutoTMalloc<SkFontIdentity> fData;
typedef SkRefCnt INHERITED;
};
class SK_API SkRemotableFontMgr : public SkRefCnt {
public:
/**
* Returns the names of the known fonts on the system.
* Will not return NULL, will return an empty table if no families exist.
*
* The indexes may be used with getIndex(int) and
* matchIndexStyle(int, SkFontStyle).
*/
virtual sk_sp<SkDataTable> getFamilyNames() const = 0;
/**
* Returns all of the fonts with the given familyIndex.
* Returns NULL if the index is out of bounds.
* Returns empty if there are no fonts at the given index.
*
* The caller must unref() the returned object.
*/
virtual SkRemotableFontIdentitySet* getIndex(int familyIndex) const = 0;
/**
* Returns the closest match to the given style in the given index.
* If there are no available fonts at the given index, the return value's
* data id will be kInvalidDataId.
*/
virtual SkFontIdentity matchIndexStyle(int familyIndex, const SkFontStyle&) const = 0;
/**
* Returns all the fonts on the system with the given name.
* If the given name is NULL, will return the default font family.
* Never returns NULL; will return an empty set if the name is not found.
*
* It is possible that this will return fonts not accessible from
* getIndex(int) or matchIndexStyle(int, SkFontStyle) due to
* hidden or auto-activated fonts.
*
* The matching may be done in a system dependent way. The name may be
* matched case-insensitive, there may be system aliases which resolve,
* and names outside the current locale may be considered. However, this
* should only return fonts which are somehow associated with the requested
* name.
*
* The caller must unref() the returned object.
*/
virtual SkRemotableFontIdentitySet* matchName(const char familyName[]) const = 0;
/**
* Returns the closest matching font to the specified name and style.
* If there are no available fonts which match the name, the return value's
* data id will be kInvalidDataId.
* If the given name is NULL, the match will be against any default fonts.
*
* It is possible that this will return a font identity not accessible from
* methods returning sets due to hidden or auto-activated fonts.
*
* The matching may be done in a system dependent way. The name may be
* matched case-insensitive, there may be system aliases which resolve,
* and names outside the current locale may be considered. However, this
* should only return a font which is somehow associated with the requested
* name.
*
* The caller must unref() the returned object.
*/
virtual SkFontIdentity matchNameStyle(const char familyName[], const SkFontStyle&) const = 0;
/**
* Use the system fall-back to find a font for the given character.
* If no font can be found for the character, the return value's data id
* will be kInvalidDataId.
* If the name is NULL, the match will start against any default fonts.
* If the bpc47 is NULL, a default locale will be assumed.
*
* Note that bpc47 is a combination of ISO 639, 15924, and 3166-1 codes,
* so it is fine to just pass a ISO 639 here.
*/
virtual SkFontIdentity matchNameStyleCharacter(const char familyName[], const SkFontStyle&,
const char* bcp47[], int bcp47Count,
SkUnichar character) const=0;
/**
* Returns the data for the given data id.
* Will return NULL if the data id is invalid.
* Note that this is a data id, not a font id.
*
* The caller must unref() the returned object.
*/
virtual SkStreamAsset* getData(int dataId) const = 0;
private:
typedef SkRefCnt INHERITED;
};
#endif
|
