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
|
/**
* @defgroup Elm_Fonts Elementary Fonts
* @ingroup Elementary
*
* These are functions dealing with font rendering, selection and the
* like for Elementary applications. One might fetch which system
* fonts are there to use and set custom fonts for individual classes
* of UI items containing text (text classes).
*
* @{
*/
typedef struct _Elm_Font_Properties
{
const char *name;
Eina_List *styles;
} Elm_Font_Properties;
/**
* Translate a font (family) name string in fontconfig's font names
* syntax into an @c Elm_Font_Properties struct.
*
* @param font The font name and styles string
* @return the font properties struct
*
* @ingroup Elm_Fonts
*
* @note The reverse translation can be achieved with
* elm_font_fontconfig_name_get(), for one style only (single font
* instance, not family).
*/
EAPI Elm_Font_Properties *elm_font_properties_get(const char *font);
/**
* Free font properties return by elm_font_properties_get().
*
* @param efp the font properties struct
*
* @ingroup Elm_Fonts
*/
EAPI void elm_font_properties_free(Elm_Font_Properties *efp);
/**
* Translate a font name, bound to a style, into fontconfig's font names
* syntax.
*
* @param name The font (family) name
* @param style The given style (may be @c NULL)
*
* @return the font name and style string
*
* @ingroup Elm_Fonts
*
* @note The reverse translation can be achieved with
* elm_font_properties_get(), for one style only (single font
* instance, not family).
*/
EAPI char *elm_font_fontconfig_name_get(const char *name, const char *style);
/**
* Free the font string return by elm_font_fontconfig_name_get().
*
* @param name the font properties struct
*
* @ingroup Elm_Fonts
*/
EAPI void elm_font_fontconfig_name_free(char *name);
/**
* Create a font hash table of available system fonts.
*
* One must call it with @p list being the return value of
* evas_font_available_list(). The hash will be indexed by font
* (family) names, being its values @c Elm_Font_Properties blobs.
*
* @param list The list of available system fonts, as returned by
* evas_font_available_list().
* @return the font hash.
*
* @ingroup Elm_Fonts
*
* @note The user is supposed to get it populated at least with 3
* default font families (Sans, Serif, Monospace), which should be
* present on most systems.
*/
EAPI Eina_Hash *elm_font_available_hash_add(Eina_List *list);
/**
* Free the hash returned by elm_font_available_hash_add().
*
* @param hash the hash to be freed.
*
* @ingroup Elm_Fonts
*/
EAPI void elm_font_available_hash_del(Eina_Hash *hash);
/**
* @}
*/
|
