Synopsis#define PANGO_RENDER_TYPE_WIN32 PangoContext* pango_win32_get_context (void); void pango_win32_render (HDC hdc, PangoFont *font, PangoGlyphString *glyphs, gint x, gint y); void pango_win32_render_transformed (HDC hdc, const PangoMatrix *matrix, PangoFont *font, PangoGlyphString *glyphs, int x, int y); void pango_win32_render_layout_line (HDC hdc, PangoLayoutLine *line, int x, int y); void pango_win32_render_layout (HDC hdc, PangoLayout *layout, int x, int y); PangoGlyph pango_win32_get_unknown_glyph (PangoFont *font, gunichar wc); gint pango_win32_font_get_glyph_index (PangoFont *font, gunichar wc); gboolean pango_win32_font_select_font (PangoFont *font, HDC hdc); void pango_win32_font_done_font (PangoFont *font); double pango_win32_font_get_metrics_factor (PangoFont *font); gboolean pango_win32_get_debug_flag (void); HDC pango_win32_get_dc (void); PangoWin32FontCache; PangoWin32FontCache* pango_win32_font_cache_new (void); void pango_win32_font_cache_free (PangoWin32FontCache *cache); HFONT pango_win32_font_cache_load (PangoWin32FontCache *cache, const LOGFONTA *logfont); HFONT pango_win32_font_cache_loadw (PangoWin32FontCache *cache, const LOGFONTW *logfont); void pango_win32_font_cache_unload (PangoWin32FontCache *cache, HFONT hfont); PangoFontMap* pango_win32_font_map_for_display (void); void pango_win32_shutdown_display (void); PangoWin32FontCache* pango_win32_font_map_get_font_cache (PangoFontMap *font_map); LOGFONTA* pango_win32_font_logfont (PangoFont *font); LOGFONTW* pango_win32_font_logfontw (PangoFont *font); PangoFontDescription* pango_win32_font_description_from_logfont (const LOGFONTA *lfp); PangoFontDescription* pango_win32_font_description_from_logfontw (const LOGFONTW *lfp); DescriptionThe macros and functions in this section are used to access fonts natively on Win32 systems and to render text in conjunction with Win32 APIs. DetailsPANGO_RENDER_TYPE_WIN32#define PANGO_RENDER_TYPE_WIN32 "PangoRenderWin32"
A string constant identifying the Win32 renderer. The associated quark (see
pango_win32_get_context ()PangoContext* pango_win32_get_context (void); Warning
Retrieves a PangoContext appropriate for rendering with Windows fonts.
pango_win32_render ()void pango_win32_render (HDC hdc, PangoFont *font, PangoGlyphString *glyphs, gint x, gint y); Render a PangoGlyphString onto a Windows DC
pango_win32_render_transformed ()void pango_win32_render_transformed (HDC hdc, const PangoMatrix *matrix, PangoFont *font, PangoGlyphString *glyphs, int x, int y);
Renders a PangoGlyphString onto a windows DC, possibly
transforming the layed-out coordinates through a transformation
matrix. Note that the transformation matrix for
pango_win32_render_layout_line ()void pango_win32_render_layout_line (HDC hdc, PangoLayoutLine *line, int x, int y); Render a PangoLayoutLine onto a device context. For underlining to work property the text alignment of the DC should have TA_BASELINE and TA_LEFT.
pango_win32_render_layout ()void pango_win32_render_layout (HDC hdc, PangoLayout *layout, int x, int y); Render a PangoLayoutLine onto an X drawable
pango_win32_get_unknown_glyph ()PangoGlyph pango_win32_get_unknown_glyph (PangoFont *font, gunichar wc); Warning
Returns the index of a glyph suitable for drawing
Use
pango_win32_font_get_glyph_index ()gint pango_win32_font_get_glyph_index (PangoFont *font, gunichar wc);
Obtains the index of the glyph for
pango_win32_font_select_font ()gboolean pango_win32_font_select_font (PangoFont *font, HDC hdc);
Selects the font into the specified DC and changes the mapping mode
and world transformation of the DC appropriately for the font.
You may want to surround the use of this function with calls
to
See
pango_win32_font_done_font ()void pango_win32_font_done_font (PangoFont *font);
Releases any resources allocated by
pango_win32_font_get_metrics_factor ()double pango_win32_font_get_metrics_factor (PangoFont *font);
Returns the scale factor from logical units in the coordinate
space used by
pango_win32_get_debug_flag ()gboolean pango_win32_get_debug_flag (void); Returns whether debugging is turned on.
Since 1.2 pango_win32_get_dc ()HDC pango_win32_get_dc (void); Obtains a handle to the Windows device context that is used by Pango.
PangoWin32FontCachetypedef struct _PangoWin32FontCache PangoWin32FontCache; A PangoWin32FontCache caches HFONTs by their LOGFONT descriptions. pango_win32_font_cache_new ()PangoWin32FontCache* pango_win32_font_cache_new (void); Creates a font cache.
pango_win32_font_cache_free ()void pango_win32_font_cache_free (PangoWin32FontCache *cache); Frees a PangoWin32FontCache and all associated memory. All fonts loaded through this font cache will be freed along with the cache.
pango_win32_font_cache_load ()HFONT pango_win32_font_cache_load (PangoWin32FontCache *cache, const LOGFONTA *logfont); Creates a HFONT from a LOGFONTA. The result may be newly loaded, or it may have been previously stored
pango_win32_font_cache_loadw ()HFONT pango_win32_font_cache_loadw (PangoWin32FontCache *cache, const LOGFONTW *logfont); Creates a HFONT from a LOGFONTW. The result may be newly loaded, or it may have been previously stored
Since 1.16 pango_win32_font_cache_unload ()void pango_win32_font_cache_unload (PangoWin32FontCache *cache, HFONT hfont);
Frees a font structure previously loaded with
pango_win32_font_map_for_display ()PangoFontMap* pango_win32_font_map_for_display (void);
Returns a PangoWin32FontMap. Font maps are cached and should
not be freed. If the font map is no longer needed, it can
be released with
pango_win32_font_map_get_font_cache ()PangoWin32FontCache* pango_win32_font_map_get_font_cache (PangoFontMap *font_map); Obtains the font cache associated with the given font map.
pango_win32_font_logfont ()LOGFONTA* pango_win32_font_logfont (PangoFont *font);
Determine the LOGFONTA struct for the specified font. Note that
Pango internally uses LOGFONTW structs, so if converting the UTF-16
face name in the LOGFONTW struct to system codepage fails, the
returned LOGFONTA will have an emppty face name. To get the
LOGFONTW of a PangoFont, use
pango_win32_font_logfontw ()LOGFONTW* pango_win32_font_logfontw (PangoFont *font); Determine the LOGFONTW struct for the specified font.
Since 1.16 pango_win32_font_description_from_logfont ()PangoFontDescription* pango_win32_font_description_from_logfont (const LOGFONTA *lfp); Creates a PangoFontDescription that matches the specified LOGFONTA.
The face name, italicness and weight fields in the LOGFONTA are used
to set up the resulting PangoFontDescription. If the face name in
the LOGFONTA contains non-ASCII characters the font is temporarily
loaded (using
Since 1.12 pango_win32_font_description_from_logfontw ()PangoFontDescription* pango_win32_font_description_from_logfontw (const LOGFONTW *lfp); Creates a PangoFontDescription that matches the specified LOGFONTW.
The face name, italicness and weight fields in the LOGFONTW are used
to set up the resulting PangoFontDescription. If the face name in
the LOGFONTW contains non-ASCII characters the font is temporarily
loaded (using
Since 1.16 |