pango_fc_font_map_create_context ()

PangoContext *
pango_fc_font_map_create_context (PangoFcFontMap *fcfontmap);

Creates a new context for this fontmap. This function is intended only for backend implementations deriving from PangoFcFontMap; it is possible that a backend will store additional information needed for correct operation on the PangoContext after calling this function.

Since: 1.4

PangoFcDecoderFindFunc ()

PangoFcDecoder *
(*PangoFcDecoderFindFunc) (FcPattern *pattern,
                           gpointer user_data);

Callback function passed to pango_fc_font_map_add_decoder_find_func().

pango_fc_font_map_add_decoder_find_func ()

void
pango_fc_font_map_add_decoder_find_func
                               (PangoFcFontMap *fcfontmap,
                                PangoFcDecoderFindFunc findfunc,
                                gpointer user_data,
                                GDestroyNotify dnotify);

This function saves a callback method in the PangoFcFontMap that will be called whenever new fonts are created. If the function returns a PangoFcDecoder, that decoder will be used to determine both coverage via a FcCharSet and a one-to-one mapping of characters to glyphs. This will allow applications to have application-specific encodings for various fonts.

Since: 1.6

pango_fc_font_map_find_decoder ()

PangoFcDecoder *
pango_fc_font_map_find_decoder (PangoFcFontMap *fcfontmap,
                                FcPattern *pattern);

Finds the decoder to use for pattern . Decoders can be added to a font map using pango_fc_font_map_add_decoder_find_func().

Since: 1.26

pango_fc_font_map_cache_clear ()

void
pango_fc_font_map_cache_clear (PangoFcFontMap *fcfontmap);

Clear all cached information and fontsets for this font map; this should be called whenever there is a change in the output of the default_substitute() virtual function of the font map, or if fontconfig has been reinitialized to new configuration.

Since: 1.4

pango_fc_font_map_config_changed ()

void
pango_fc_font_map_config_changed (PangoFcFontMap *fcfontmap);

Informs font map that the fontconfig configuration (ie, FcConfig object) used by this font map has changed. This currently calls pango_fc_font_map_cache_clear() which ensures that list of fonts, etc will be regenerated using the updated configuration.

Since: 1.38

pango_fc_font_map_shutdown ()

void
pango_fc_font_map_shutdown (PangoFcFontMap *fcfontmap);

Clears all cached information for the fontmap and marks all fonts open for the fontmap as dead. (See the shutdown() virtual function of PangoFcFont.) This function might be used by a backend when the underlying windowing system for the font map exits. This function is only intended to be called only for backend implementations deriving from PangoFcFontMap.

Since: 1.4

pango_fc_font_map_set_config ()

void
pango_fc_font_map_set_config (PangoFcFontMap *fcfontmap,
                              FcConfig *fcconfig);

Set the FcConfig for this font map to use. The default value is NULL, which causes Fontconfig to use its global "current config". You can create a new FcConfig object and use this API to attach it to a font map.

This is particularly useful for example, if you want to use application fonts with Pango. For that, you would create a fresh FcConfig, add your app fonts to it, and attach it to a new Pango font map.

If fcconfig is different from the previous config attached to the font map, pango_fc_font_map_config_changed() is called.

This function acquires a reference to the FcConfig object; the caller does NOT need to retain a reference.

[skip]

Since: 1.38

pango_fc_font_map_get_config ()

FcConfig *
pango_fc_font_map_get_config (PangoFcFontMap *fcfontmap);

Fetches the FcConfig attached to a font map.

See also: pango_fc_font_map_set_config()

[skip]

Since: 1.38

PangoFcSubstituteFunc ()

void
(*PangoFcSubstituteFunc) (FcPattern *pattern,
                          gpointer data);

Function type for doing final config tweaking on prepared FcPatterns.

pango_fc_font_map_set_default_substitute ()

void
pango_fc_font_map_set_default_substitute
                               (PangoFcFontMap *fontmap,
                                PangoFcSubstituteFunc func,
                                gpointer data,
                                GDestroyNotify notify);

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_fc_font_map_substitute_changed ()

void
pango_fc_font_map_substitute_changed (PangoFcFontMap *fontmap);

Call this function any time the results of the default substitution function set with pango_fc_font_map_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_fc_font_description_from_pattern ()

PangoFontDescription *
pango_fc_font_description_from_pattern
                               (FcPattern *pattern,
                                gboolean include_size);

Creates a PangoFontDescription that matches the specified Fontconfig pattern as closely as possible. Many possible Fontconfig pattern values, such as FC_RASTERIZER or FC_DPI, don't make sense in the context of PangoFontDescription, so will be ignored.

Since: 1.4

PangoFcFontMap

typedef struct _PangoFcFontMap 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.

PangoFcFontMapClass

typedef struct _PangoFcFontMapClass PangoFcFontMapClass;

Class structure for PangoFcFontMap.

PANGO_FC_FONT_FEATURES

#define PANGO_FC_FONT_FEATURES "fontfeatures"

String representing a fontconfig property name 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

PANGO_FC_GRAVITY

#define PANGO_FC_GRAVITY "pangogravity"

String representing a fontconfig property name 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

PANGO_FC_VERSION

#define PANGO_FC_VERSION "pangoversion"

String representing a fontconfig property name that Pango sets on any fontconfig pattern it passes to fontconfig.

The property will have an integer value equal to what 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

PANGO_FC_PRGNAME

#define PANGO_FC_PRGNAME "prgname"

String representing a fontconfig property name 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

PANGO_FC_FONT_VARIATIONS

#define PANGO_FC_FONT_VARIATIONS "fontvariations"

String representing a fontconfig property name 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.