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
|
/*
* Copyright 2012 Google Inc.
*
* Use of this source code is governed by a BSD-style license that can be
* found in the LICENSE file.
*/
#ifndef SkTypeface_android_DEFINED
#define SkTypeface_android_DEFINED
#include "SkTypeface.h"
#ifdef SK_BUILD_FOR_ANDROID
class SkPaintOptionsAndroid;
/**
* Get the family name of the font in the fallback font list containing
* the specified character using the system's default language. This function
* also assumes the only families with the elegant or default variants will be
* returned.
*
* @param uni The unicode character to use for the lookup.
* @param name The family name of the font file containing the unicode character
* in the default language
* @return true if a font is found and false otherwise
*/
SK_API bool SkGetFallbackFamilyNameForChar(SkUnichar uni, SkString* name);
/**
* Get the family name of the font in the fallback font list containing
* the specified character taking into account the provided language. This
* function also assumes the only families with the elegant or default variants
* will be returned.
*
* @param uni The unicode character to use for the lookup.
* @param lang The null terminated string representing the BCP 47 language
* identifier for the preferred language. If there is no unique
* fallback chain for that language the system's default language
* will be used.
* @param name The family name of the font file containing the unicode character
* in the preferred language
* @return true if a font is found and false otherwise
*/
SK_API bool SkGetFallbackFamilyNameForChar(SkUnichar uni, const char* lang, SkString* name);
/**
* For test only.
* Load font config from given xml files, instead of those from Android system.
*/
SK_API void SkUseTestFontConfigFile(const char* mainconf, const char* fallbackconf,
const char* fontsdir);
/**
* Given a "current" fontID, return a ref to the next logical typeface
* when searching fonts for a given unicode value. Typically the caller
* will query a given font, and if a unicode value is not supported, they
* will call this, and if 0 is not returned, will search that font, and so
* on. This process must be finite, and when the fonthost sees a
* font with no logical successor, it must return NULL.
*
* The original fontID is also provided. This is the initial font that was
* stored in the typeface of the caller. It is provided as an aid to choose
* the best next logical font. e.g. If the original font was bold or serif,
* but the 2nd in the logical chain was plain, then a subsequent call to
* get the 3rd can still inspect the original, and try to match its
* stylistic attributes.
*/
SkTypeface* SkAndroidNextLogicalTypeface(SkFontID currFontID, SkFontID origFontID,
const SkPaintOptionsAndroid& options);
/**
* Given a glyphID (built using fallback font chaining) and its origin typeface
* return the actual typeface within the fallback chain that this glyphID
* resolves to. If no suitable typeface is found then NULL is returned. However,
* if returned typeface is not NULL it is assumed to be globally cached so the
* caller need not ref it.
*
* Optionally, if lower/upper bound params are provided and the returned
* typeface is not NULL, then these params are populated with the range of
* glyphIDs that this typeface is capable of resolving. The lower bound is
* inclusive while the upper bound is exclusive.
*/
SkTypeface* SkGetTypefaceForGlyphID(uint16_t glyphID, const SkTypeface* origTypeface,
const SkPaintOptionsAndroid& options,
int* lowerBounds = NULL, int* upperBounds = NULL);
#endif // #ifdef SK_BUILD_FOR_ANDROID
#ifdef SK_BUILD_FOR_ANDROID_FRAMEWORK
#include "SkPaintOptionsAndroid.h"
#include "../harfbuzz/src/harfbuzz-shaper.h"
#include "../harfbuzz_ng/src/hb.h"
/**
* Return a new typeface for a fallback script. If the script is
* not valid, or can not map to a font, returns null.
* @param script The harfbuzz script id.
* @param style The font style, for example bold
* @param elegant true if we want the web friendly elegant version of the font
* @return reference to the matching typeface. Caller must call
* unref() when they are done.
*/
SK_API SkTypeface* SkCreateTypefaceForScriptNG(hb_script_t script, SkTypeface::Style style,
SkPaintOptionsAndroid::FontVariant fontVariant = SkPaintOptionsAndroid::kDefault_Variant);
SK_API SkTypeface* SkCreateTypefaceForScript(HB_Script script, SkTypeface::Style style,
SkPaintOptionsAndroid::FontVariant fontVariant = SkPaintOptionsAndroid::kDefault_Variant);
#endif // #ifdef SK_BUILD_FOR_ANDROID_FRAMEWORK
#endif // #ifndef SkTypeface_android_DEFINED
|
