/* 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 G_BEGIN_DECLS #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)) typedef struct _PangoFcFontMap PangoFcFontMap; typedef struct _PangoFcFontMapClass PangoFcFontMapClass; typedef struct _PangoFcFontMapPrivate PangoFcFontMapPrivate; #ifdef PANGO_ENABLE_BACKEND #define PANGO_FC_FONT_MAP_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST ((klass), PANGO_TYPE_FC_FONT_MAP, PangoFcFontMapClass)) #define PANGO_IS_FC_FONT_MAP_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE ((klass), PANGO_TYPE_FC_FONT_MAP)) #define PANGO_FC_FONT_MAP_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), PANGO_TYPE_FC_FONT_MAP, PangoFcFontMapClass)) /** * PangoFcFontMap: * * #PangoFcFontMap is a base class for font map implementations * using the FontConfig and FreeType libraries. To create a new * backend using Fontconfig and FreeType, you derive from this class * and implement a new_font() virtual function that creates an * instance deriving from #PangoFcFont. **/ struct _PangoFcFontMap { PangoFontMap parent_instance; PangoFcFontMapPrivate *priv; }; /** * PangoFcFontMapClass: * @default_substitute: Substitutes in default values for * unspecified fields in a #FcPattern. This will be called * prior to creating a font for the pattern. May be %NULL. * Deprecated in favor of @context_substitute(). * @new_font: Creates a new #PangoFcFont for the specified * pattern of the appropriate type for this font map. The * @pattern argument must be passed to the "pattern" property * of #PangoFcFont when you call g_object_new(). Deprecated * in favor of @create_font(). * @get_resolution: Gets the resolution (the scale factor * between logical and absolute font sizes) that the backend * will use for a particular fontmap and context. @context * may be null. * @context_key_get: Gets an opaque key holding backend * specific options for the context that will affect * fonts created by create_font(). The result must point to * persistant storage owned by the fontmap. This key * is used to index hash tables used to look up fontsets * and fonts. * @context_key_copy: Copies a context key. Pango uses this * to make a persistant copy of the value returned from * @context_key_get. * @context_key_free: Frees a context key copied with * @context_key_copy. * @context_key_hash: Gets a hash value for a context key * @context_key_equal: Compares two context keys for equality. * @create_font: Creates a new #PangoFcFont for the specified * pattern of the appropriate type for this font map using * information from the context that is passed in. The * @pattern argument must be passed to the "pattern" property * of #PangoFcFont when you call g_object_new(). Deprecated * in favor of @create_font(). If %NULL, new_font() is used. * @context_substitute: Substitutes in default values for * unspecified fields in a #FcPattern. This will be called * prior to creating a font for the pattern. May be %NULL. * * Class structure for #PangoFcFontMap. **/ struct _PangoFcFontMapClass { /*< private >*/ PangoFontMapClass parent_class; /*< public >*/ /* Deprecated in favor of context_substitute */ void (*default_substitute) (PangoFcFontMap *fontmap, FcPattern *pattern); /* Deprecated in favor of create_font */ PangoFcFont *(*new_font) (PangoFcFontMap *fontmap, FcPattern *pattern); double (*get_resolution) (PangoFcFontMap *fcfontmap, PangoContext *context); gconstpointer (*context_key_get) (PangoFcFontMap *fcfontmap, PangoContext *context); gpointer (*context_key_copy) (PangoFcFontMap *fcfontmap, gconstpointer key); void (*context_key_free) (PangoFcFontMap *fcfontmap, gpointer key); guint32 (*context_key_hash) (PangoFcFontMap *fcfontmap, gconstpointer key); gboolean (*context_key_equal) (PangoFcFontMap *fcfontmap, gconstpointer key_a, gconstpointer key_b); void (*context_substitute) (PangoFcFontMap *fontmap, PangoContext *context, FcPattern *pattern); PangoFcFont *(*create_font) (PangoFcFontMap *fontmap, PangoContext *context, const PangoFontDescription *desc, FcPattern *pattern); /*< private >*/ /* Padding for future expansion */ void (*_pango_reserved1) (void); void (*_pango_reserved2) (void); void (*_pango_reserved3) (void); void (*_pango_reserved4) (void); }; PangoContext * pango_fc_font_map_create_context (PangoFcFontMap *fcfontmap); void pango_fc_font_map_cache_clear (PangoFcFontMap *fcfontmap); void pango_fc_font_map_shutdown (PangoFcFontMap *fcfontmap); #endif GType pango_fc_font_map_get_type (void); /** * PangoFcDecoderFindFunc: * @pattern: a fully resolved #FcPattern specifying the font on the system * @user_data: user data passed to pango_fc_font_map_add_decoder_find_func() * * Callback function passed to pango_fc_font_map_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); void pango_fc_font_map_add_decoder_find_func (PangoFcFontMap *fcfontmap, PangoFcDecoderFindFunc findfunc, gpointer user_data, GDestroyNotify dnotify); PangoFontDescription *pango_fc_font_description_from_pattern (FcPattern *pattern, gboolean include_size); G_END_DECLS #endif /* __PANGO_FC_FONT_MAP_H__ */