| Top | |
|
|
|
| PangoMap * | pango_find_map () |
| PangoEngine * | pango_map_get_engine () |
| void | pango_map_get_engines () |
| void | pango_module_register () |
Functions and macros in this section are used to support loading dynamic modules that add engines to Pango at run time.
PangoMap * pango_find_map (PangoLanguage *language,guint engine_type_id,guint render_type_id);
Locate a PangoMap for a particular engine type and render type. The resulting map can be used to determine the engine for each character.
PangoEngine * pango_map_get_engine (PangoMap *map,PangoScript script);
Returns the best engine listed in the map for a given script
the best engine, if one is listed for the script,
or NULL. The lookup may cause the engine to be loaded;
once an engine is loaded, it won't be unloaded. If multiple
engines are exact for the script, the choice of which is
returned is arbitrary.
void pango_map_get_engines (PangoMap *map,PangoScript script,GSList **exact_engines,GSList **fallback_engines);
Finds engines in the map that handle the given script. The returned lists should be freed with g_slist_free, but the engines in the lists are owned by GLib and will be kept around permanently, so they should not be unref'ed.
map |
a PangoMap |
|
script |
||
exact_engines |
location to store list of engines that exactly handle this script. |
|
fallback_engines |
location to store list of engines that approximately handle this script. |
Since 1.4
void
pango_module_register (PangoIncludedModule *module);
Registers a statically linked module with Pango. The PangoIncludedModule structure that is passed in contains the functions that would otherwise be loaded from a dynamically loaded module.
struct PangoIncludedModule {
void (*list) (PangoEngineInfo **engines,
int *n_engines);
void (*init) (GTypeModule *module);
void (*exit) (void);
PangoEngine *(*create) (const char *id);
};
The PangoIncludedModule structure for a statically linked module contains the functions that would otherwise be loaded from a dynamically loaded module.
typedef struct _PangoMap PangoMap;
A PangoMap structure can be used to determine the engine to use for each character.
typedef struct _PangoMapEntry PangoMapEntry;
A PangoMapEntry contains information about the engine that should be used for the codepoint to which this entry belongs and also whether the engine matches the language tag for this entry's map exactly or just approximately.