Debian Codegraph @

lib/fontconfig/font-manager-fontconfig.h

raw
1 /* font-manager-fontconfig.h
2 *
3 * Copyright (C) 2009-2025 Jerry Casiano
4 *
5 * This program is free software: you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation, either version 3 of the License, or
8 * (at your option) any later version.
9 *
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
14 *
15 * You should have received a copy of the GNU General Public License
16 * along with this program.
17 *
18 * If not, see <http://www.gnu.org/licenses/gpl-3.0.txt>.
19 */
20
21 #pragma once
22
23 #include <stdio.h>
24 #include <glib.h>
25 #include <glib/gi18n-lib.h>
26 #include <glib/gprintf.h>
27 #include <glib/gstdio.h>
28 #include <fontconfig/fontconfig.h>
29 #include <fontconfig/fcfreetype.h>
30 #include <json-glib/json-glib.h>
31 #include <pango/pango-font.h>
32 #include <pango/pangofc-font.h>
33 #include <pango/pangofc-fontmap.h>
34 #include <pango/pango-utils.h>
35 #include <pango/pango-version-macros.h>
36
37 #include "font-manager-json.h"
38 #include "font-manager-utils.h"
39 #include "unicode-info.h"
40
41 /**
42 * FontManagerFontconfigError:
43 * @FONT_MANAGER_FONTCONFIG_ERROR_FAILED: Call to Fontconfig library failed
44 */
45 typedef enum
46 {
47 FONT_MANAGER_FONTCONFIG_ERROR_FAILED
48 }
49 FontManagerFontconfigError;
50
51 GQuark font_manager_fontconfig_error_quark ();
52 #define FONT_MANAGER_FONTCONFIG_ERROR font_manager_fontconfig_error_quark()
53
54 void font_manager_clear_application_fonts (void);
55 gboolean font_manager_add_application_font (const gchar *filepath);
56 gboolean font_manager_add_application_font_directory (const gchar *dir);
57 gboolean font_manager_update_font_configuration (void);
58 GList * font_manager_list_available_font_files (void);
59 FontManagerStringSet * font_manager_list_available_font_families (void);
60 GList * font_manager_get_langs_from_fontconfig_pattern (FcPattern *pattern);
61 JsonObject * font_manager_get_attributes_from_filepath (const gchar *filepath, GError **error);
62 JsonObject * font_manager_get_attributes_from_fontconfig_pattern (FcPattern *pattern);
63 JsonObject * font_manager_get_available_fonts (const gchar *family_name);
64 JsonObject * font_manager_get_available_fonts_for_chars (const gchar *chars);
65 JsonArray * font_manager_sort_json_font_listing (JsonObject *json_obj);
66
67 /**
68 * FontManagerWeight:
69 * @FONT_MANAGER_WEIGHT_THIN: FC_WEIGHT_THIN
70 * @FONT_MANAGER_WEIGHT_ULTRALIGHT: FC_WEIGHT_ULTRALIGHT
71 * @FONT_MANAGER_WEIGHT_LIGHT: FC_WEIGHT_LIGHT
72 * @FONT_MANAGER_WEIGHT_SEMILIGHT: FC_WEIGHT_SEMILIGHT
73 * @FONT_MANAGER_WEIGHT_BOOK: FC_WEIGHT_BOOK
74 * @FONT_MANAGER_WEIGHT_REGULAR: FC_WEIGHT_REGULAR
75 * @FONT_MANAGER_WEIGHT_MEDIUM: FC_WEIGHT_MEDIUM
76 * @FONT_MANAGER_WEIGHT_SEMIBOLD: FC_WEIGHT_SEMIBOLD
77 * @FONT_MANAGER_WEIGHT_BOLD: FC_WEIGHT_BOLD
78 * @FONT_MANAGER_WEIGHT_ULTRABOLD: FC_WEIGHT_ULTRABOLD
79 * @FONT_MANAGER_WEIGHT_HEAVY: FC_WEIGHT_HEAVY
80 * @FONT_MANAGER_WEIGHT_ULTRABLACK: FC_WEIGHT_ULTRABLACK
81 *
82 * These weight values map directly to those defined by Fontconfig.
83 */
84 typedef enum
85 {
86 FONT_MANAGER_WEIGHT_THIN = FC_WEIGHT_THIN,
87 FONT_MANAGER_WEIGHT_ULTRALIGHT = FC_WEIGHT_ULTRALIGHT,
88 FONT_MANAGER_WEIGHT_LIGHT = FC_WEIGHT_LIGHT,
89 FONT_MANAGER_WEIGHT_SEMILIGHT = FC_WEIGHT_SEMILIGHT,
90 FONT_MANAGER_WEIGHT_BOOK = FC_WEIGHT_BOOK,
91 FONT_MANAGER_WEIGHT_REGULAR = FC_WEIGHT_REGULAR,
92 FONT_MANAGER_WEIGHT_MEDIUM = FC_WEIGHT_MEDIUM,
93 FONT_MANAGER_WEIGHT_SEMIBOLD = FC_WEIGHT_SEMIBOLD,
94 FONT_MANAGER_WEIGHT_BOLD = FC_WEIGHT_BOLD,
95 FONT_MANAGER_WEIGHT_ULTRABOLD = FC_WEIGHT_ULTRABOLD,
96 FONT_MANAGER_WEIGHT_HEAVY = FC_WEIGHT_HEAVY,
97 FONT_MANAGER_WEIGHT_ULTRABLACK = FC_WEIGHT_ULTRABLACK
98 }
99 FontManagerWeight;
100
101 GType font_manager_weight_get_type (void);
102 #define FONT_MANAGER_TYPE_WEIGHT (font_manager_weight_get_type ())
103
104 const gchar * font_manager_weight_to_string (FontManagerWeight weight);
105 gboolean font_manager_weight_defined (FontManagerWeight weight);
106
107 /**
108 * FontManagerSlant:
109 * @FONT_MANAGER_SLANT_ROMAN: FC_SLANT_ROMAN
110 * @FONT_MANAGER_SLANT_ITALIC: FC_SLANT_ITALIC
111 * @FONT_MANAGER_SLANT_OBLIQUE: FC_SLANT_OBLIQUE
112 *
113 * These slant values map directly to those defined by Fontconfig.
114 */
115 typedef enum
116 {
117 FONT_MANAGER_SLANT_ROMAN = FC_SLANT_ROMAN,
118 FONT_MANAGER_SLANT_ITALIC = FC_SLANT_ITALIC,
119 FONT_MANAGER_SLANT_OBLIQUE = FC_SLANT_OBLIQUE
120 }
121 FontManagerSlant;
122
123 GType font_manager_slant_get_type (void);
124 #define FONT_MANAGER_TYPE_SLANT (font_manager_slant_get_type ())
125
126 const gchar * font_manager_slant_to_string (FontManagerSlant slant);
127
128 /**
129 * FontManagerWidth:
130 * @FONT_MANAGER_WIDTH_ULTRACONDENSED: FC_WIDTH_ULTRACONDENSED
131 * @FONT_MANAGER_WIDTH_EXTRACONDENSED: FC_WIDTH_EXTRACONDENSED
132 * @FONT_MANAGER_WIDTH_CONDENSED: FC_WIDTH_CONDENSED
133 * @FONT_MANAGER_WIDTH_SEMICONDENSED: FC_WIDTH_SEMICONDENSED
134 * @FONT_MANAGER_WIDTH_NORMAL: FC_WIDTH_NORMAL
135 * @FONT_MANAGER_WIDTH_SEMIEXPANDED: FC_WIDTH_SEMIEXPANDED
136 * @FONT_MANAGER_WIDTH_EXPANDED: FC_WIDTH_EXPANDED
137 * @FONT_MANAGER_WIDTH_EXTRAEXPANDED: FC_WIDTH_EXTRAEXPANDED
138 * @FONT_MANAGER_WIDTH_ULTRAEXPANDED: FC_WIDTH_ULTRAEXPANDED
139 *
140 * These widths map directly to those defined by Fontconfig.
141 */
142 typedef enum
143 {
144 FONT_MANAGER_WIDTH_ULTRACONDENSED = FC_WIDTH_ULTRACONDENSED,
145 FONT_MANAGER_WIDTH_EXTRACONDENSED = FC_WIDTH_EXTRACONDENSED,
146 FONT_MANAGER_WIDTH_CONDENSED = FC_WIDTH_CONDENSED,
147 FONT_MANAGER_WIDTH_SEMICONDENSED = FC_WIDTH_SEMICONDENSED,
148 FONT_MANAGER_WIDTH_NORMAL = FC_WIDTH_NORMAL,
149 FONT_MANAGER_WIDTH_SEMIEXPANDED = FC_WIDTH_SEMIEXPANDED,
150 FONT_MANAGER_WIDTH_EXPANDED = FC_WIDTH_EXPANDED,
151 FONT_MANAGER_WIDTH_EXTRAEXPANDED = FC_WIDTH_EXTRAEXPANDED,
152 FONT_MANAGER_WIDTH_ULTRAEXPANDED = FC_WIDTH_ULTRAEXPANDED
153 }
154 FontManagerWidth;
155
156 GType font_manager_width_get_type (void);
157 #define FONT_MANAGER_TYPE_WIDTH (font_manager_width_get_type ())
158
159 const gchar * font_manager_width_to_string (FontManagerWidth width);
160 gboolean font_manager_width_defined (FontManagerWidth width);
161
162 /**
163 * FontManagerSpacing:
164 * @FONT_MANAGER_SPACING_PROPORTIONAL: FC_PROPORTIONAL
165 * @FONT_MANAGER_SPACING_DUAL: FC_DUAL
166 * @FONT_MANAGER_SPACING_MONO: FC_MONO
167 * @FONT_MANAGER_SPACING_CHARCELL: FC_CHARCELL
168 *
169 * These spacing values map directly to those defined by Fontconfig.
170 */
171 typedef enum
172 {
173 FONT_MANAGER_SPACING_PROPORTIONAL = FC_PROPORTIONAL,
174 FONT_MANAGER_SPACING_DUAL = FC_DUAL,
175 FONT_MANAGER_SPACING_MONO = FC_MONO,
176 FONT_MANAGER_SPACING_CHARCELL = FC_CHARCELL
177 }
178 FontManagerSpacing;
179
180 GType font_manager_spacing_get_type (void);
181 #define FONT_MANAGER_TYPE_SPACING (font_manager_spacing_get_type ())
182
183 const gchar * font_manager_spacing_to_string (FontManagerSpacing spacing);
184
185 /**
186 * FontManagerSubpixelOrder:
187 * @FONT_MANAGER_SUBPIXEL_ORDER_UNKNOWN: FC_RGBA_UNKNOWN
188 * @FONT_MANAGER_SUBPIXEL_ORDER_RGB: FC_RGBA_RGB
189 * @FONT_MANAGER_SUBPIXEL_ORDER_BGR: FC_RGBA_BGR
190 * @FONT_MANAGER_SUBPIXEL_ORDER_VRGB: FC_RGBA_VRGB
191 * @FONT_MANAGER_SUBPIXEL_ORDER_VBGR: FC_RGBA_VBGR
192 * @FONT_MANAGER_SUBPIXEL_ORDER_NONE: FC_RGBA_NONE
193 *
194 * These rgba values map directly to those defined by Fontconfig.
195 */
196 typedef enum
197 {
198 FONT_MANAGER_SUBPIXEL_ORDER_UNKNOWN = FC_RGBA_UNKNOWN,
199 FONT_MANAGER_SUBPIXEL_ORDER_RGB = FC_RGBA_RGB,
200 FONT_MANAGER_SUBPIXEL_ORDER_BGR = FC_RGBA_BGR,
201 FONT_MANAGER_SUBPIXEL_ORDER_VRGB = FC_RGBA_VRGB,
202 FONT_MANAGER_SUBPIXEL_ORDER_VBGR = FC_RGBA_VBGR,
203 FONT_MANAGER_SUBPIXEL_ORDER_NONE = FC_RGBA_NONE
204 }
205 FontManagerSubpixelOrder;
206
207 GType font_manager_subpixel_order_get_type (void);
208 #define FONT_MANAGER_TYPE_SUBPIXEL_ORDER (font_manager_subpixel_order_get_type ())
209
210 const gchar * font_manager_subpixel_order_to_string (FontManagerSubpixelOrder rgba);
211
212 /**
213 * FontManagerHintStyle:
214 * @FONT_MANAGER_HINT_STYLE_NONE: FC_HINT_NONE
215 * @FONT_MANAGER_HINT_STYLE_SLIGHT: FC_HINT_SLIGHT
216 * @FONT_MANAGER_HINT_STYLE_MEDIUM: FC_HINT_MEDIUM
217 * @FONT_MANAGER_HINT_STYLE_FULL: FC_HINT_FULL
218 *
219 * These hinting values map directly to those defined by Fontconfig.
220 */
221 typedef enum
222 {
223 FONT_MANAGER_HINT_STYLE_NONE = FC_HINT_NONE,
224 FONT_MANAGER_HINT_STYLE_SLIGHT = FC_HINT_SLIGHT,
225 FONT_MANAGER_HINT_STYLE_MEDIUM = FC_HINT_MEDIUM,
226 FONT_MANAGER_HINT_STYLE_FULL = FC_HINT_FULL
227 }
228 FontManagerHintStyle;
229
230 GType font_manager_hint_style_get_type (void);
231 #define FONT_MANAGER_TYPE_HINT_STYLE (font_manager_hint_style_get_type ())
232
233 const gchar * font_manager_hint_style_to_string (FontManagerHintStyle hinting);
234
235 /**
236 * FontManagerLCDFilter:
237 * @FONT_MANAGER_LCD_FILTER_NONE: FC_LCD_NONE
238 * @FONT_MANAGER_LCD_FILTER_DEFAULT: FC_LCD_DEFAULT
239 * @FONT_MANAGER_LCD_FILTER_LIGHT: FC_LCD_LIGHT
240 * @FONT_MANAGER_LCD_FILTER_LEGACY: FC_LCD_LEGACY
241 *
242 * These filter values map directly to those defined by Fontconfig.
243 */
244 typedef enum
245 {
246 FONT_MANAGER_LCD_FILTER_NONE = FC_LCD_NONE,
247 FONT_MANAGER_LCD_FILTER_DEFAULT = FC_LCD_DEFAULT,
248 FONT_MANAGER_LCD_FILTER_LIGHT = FC_LCD_LIGHT,
249 FONT_MANAGER_LCD_FILTER_LEGACY = FC_LCD_LEGACY
250 }
251 FontManagerLCDFilter;
252
253 GType font_manager_lcd_filter_get_type (void);
254 #define FONT_MANAGER_TYPE_LCD_FILTER (font_manager_lcd_filter_get_type ())
255
256 const gchar * font_manager_lcd_filter_to_string (FontManagerLCDFilter filter);
257