/* Pango * pangofc-fontmap.h: Base fontmap type for fontconfig-based backends * * Copyright (C) 2003 Red Hat Software * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 of the License, or (at your option) any later version. * * This library is distributed in the hope that it will be useful, * but WITHOUT ANY WARRANTY; without even the implied warranty of * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public * License along with this library; if not, write to the * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ #ifndef __PANGO_FC_FONT_MAP_H__ #define __PANGO_FC_FONT_MAP_H__ #include #include #include #include #include G_BEGIN_DECLS /* * PangoFcFontMap */ #ifdef __GI_SCANNER__ #define PANGO_FC_TYPE_FONT_MAP (pango_fc_font_map_get_type ()) #define PANGO_FC_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_FC_TYPE_FONT_MAP, PangoFcFontMap)) #define PANGO_FC_IS_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_FC_TYPE_FONT_MAP)) #else #define PANGO_TYPE_FC_FONT_MAP (pango_fc_font_map_get_type ()) #define PANGO_FC_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), PANGO_TYPE_FC_FONT_MAP, PangoFcFontMap)) #define PANGO_IS_FC_FONT_MAP(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), PANGO_TYPE_FC_FONT_MAP)) #endif typedef struct _PangoFcFontMap PangoFcFontMap; typedef struct _PangoFcFontMapClass PangoFcFontMapClass; typedef struct _PangoFcFontMapPrivate PangoFcFontMapPrivate; PANGO_AVAILABLE_IN_ALL GType pango_fc_font_map_get_type (void) G_GNUC_CONST; PANGO_AVAILABLE_IN_1_4 void pango_fc_font_map_cache_clear (PangoFcFontMap *fcfontmap); PANGO_AVAILABLE_IN_1_38 void pango_fc_font_map_config_changed (PangoFcFontMap *fcfontmap); PANGO_AVAILABLE_IN_1_38 void pango_fc_font_map_set_config (PangoFcFontMap *fcfontmap, FcConfig *fcconfig); PANGO_AVAILABLE_IN_1_38 FcConfig * pango_fc_font_map_get_config (PangoFcFontMap *fcfontmap); /** * PangoFcDecoderFindFunc: * @pattern: a fully resolved `FcPattern` specifying the font on the system * @user_data: user data passed to * [method@PangoFc.FontMap.add_decoder_find_func] * * Callback function passed to [method@PangoFc.FontMap.add_decoder_find_func]. * * Return value: a new reference to a custom decoder for this pattern, * or %NULL if the default decoder handling should be used. **/ typedef PangoFcDecoder * (*PangoFcDecoderFindFunc) (FcPattern *pattern, gpointer user_data); PANGO_AVAILABLE_IN_1_6 void pango_fc_font_map_add_decoder_find_func (PangoFcFontMap *fcfontmap, PangoFcDecoderFindFunc findfunc, gpointer user_data, GDestroyNotify dnotify); PANGO_AVAILABLE_IN_1_26 PangoFcDecoder *pango_fc_font_map_find_decoder (PangoFcFontMap *fcfontmap, FcPattern *pattern); PANGO_AVAILABLE_IN_1_4 PangoFontDescription *pango_fc_font_description_from_pattern (FcPattern *pattern, gboolean include_size); #ifndef PANGO_DISABLE_DEPRECATED PANGO_DEPRECATED_IN_1_22_FOR(pango_font_map_create_context) PangoContext * pango_fc_font_map_create_context (PangoFcFontMap *fcfontmap); #endif PANGO_AVAILABLE_IN_1_4 void pango_fc_font_map_shutdown (PangoFcFontMap *fcfontmap); PANGO_AVAILABLE_IN_1_44 hb_face_t * pango_fc_font_map_get_hb_face (PangoFcFontMap *fcfontmap, PangoFcFont *fcfont); /** * PangoFcSubstituteFunc: * @pattern: the FcPattern to tweak. * @data: user data. * * Function type for doing final config tweaking on prepared `FcPattern`s. */ typedef void (*PangoFcSubstituteFunc) (FcPattern *pattern, gpointer data); /** * pango_fc_font_map_set_default_substitute: * @fontmap: a `PangoFcFontMap` * @func: function to call to to do final config tweaking on `FcPattern` objects * @data: data to pass to @func * @notify: function to call when @data is no longer used * * Sets a function that will be called to do final configuration * substitution on a `FcPattern` before it is used to load * the font. * * This function can be used to do things like set * hinting and antialiasing options. * * Since: 1.48 */ PANGO_AVAILABLE_IN_1_48 void pango_fc_font_map_set_default_substitute (PangoFcFontMap *fontmap, PangoFcSubstituteFunc func, gpointer data, GDestroyNotify notify); /** * pango_fc_font_map_substitute_changed: * @fontmap: a `PangoFcFontMap` * * Call this function any time the results of the default * substitution function set with * [method@PangoFc.FontMap.set_default_substitute] change. * * That is, if your substitution function will return different * results for the same input pattern, you must call this function. * * Since: 1.48 */ PANGO_AVAILABLE_IN_1_48 void pango_fc_font_map_substitute_changed (PangoFcFontMap *fontmap); /** * PANGO_FC_GRAVITY: * * Fontconfig property that Pango sets on any * fontconfig pattern it passes to fontconfig * if a `PangoGravity` other than %PANGO_GRAVITY_SOUTH * is desired. * * The property will have a `PangoGravity` value as a string, * like "east". This can be used to write fontconfig configuration * rules to choose different fonts for horizontal and vertical * writing directions. * * Since: 1.20 */ #define PANGO_FC_GRAVITY "pangogravity" /** * PANGO_FC_VERSION: * * Fontconfig property that Pango sets on any * fontconfig pattern it passes to fontconfig. * * The property will have an integer value equal to what * [func@Pango.version] returns. This can be used to write * fontconfig configuration rules that only affect certain * pango versions (or only pango-using applications, or only * non-pango-using applications). * * Since: 1.20 */ #define PANGO_FC_VERSION "pangoversion" /** * PANGO_FC_PRGNAME: * * Fontconfig property that Pango sets on any * fontconfig pattern it passes to fontconfig. * * The property will have a string equal to what * g_get_prgname() returns. This can be used to write * fontconfig configuration rules that only affect * certain applications. * * This is equivalent to FC_PRGNAME in versions of * fontconfig that have that. * * Since: 1.24 */ #define PANGO_FC_PRGNAME "prgname" /** * PANGO_FC_FONT_FEATURES: * * Fontconfig property that Pango reads from font * patterns to populate list of OpenType features * to be enabled for the font by default. * * The property will have a number of string elements, * each of which is the OpenType feature tag of one feature * to enable. * * This is equivalent to FC_FONT_FEATURES in versions of * fontconfig that have that. * * Since: 1.34 */ #define PANGO_FC_FONT_FEATURES "fontfeatures" /** * PANGO_FC_FONT_VARIATIONS: * * Fontconfig property that Pango reads from font * patterns to populate list of OpenType font variations * to be used for a font. * * The property will have a string elements, each of which * a comma-separated list of OpenType axis setting of the * form AXIS=VALUE. * * This is equivalent to FC_FONT_VARIATIONS in versions of * fontconfig that have that. */ #define PANGO_FC_FONT_VARIATIONS "fontvariations" G_END_DECLS #endif /* __PANGO_FC_FONT_MAP_H__ */