|  |  |  | Pango Reference Manual |  | 
|---|
| Win32 Fonts and RenderingWin32 Fonts and Rendering — Functions for shape engines to manipulate Win32 fonts | 
#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_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 LOGFONT *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); LOGFONT* pango_win32_font_logfont (PangoFont *font);
#define PANGO_RENDER_TYPE_WIN32 "PangoRenderWin32"
A string constant identifying the Win32 renderer. The associated quark (see g_quark_from_string()) is used to identify the renderer in pango_find_map().
PangoContext* pango_win32_get_context (void);
Retrieves a PangoContext appropriate for rendering with Windows fonts.
| Returns : | the new PangoContext | 
void        pango_win32_render              (HDC hdc,
                                             PangoFont *font,
                                             PangoGlyphString *glyphs,
                                             gint x,
                                             gint y);Render a PangoGlyphString onto a Windows DC
| hdc : | the device context | 
| font : | the font in which to draw the string | 
| glyphs : | the glyph string to draw | 
| x : | the x position of start of string (in pixels) | 
| y : | the y position of baseline (in pixels) | 
void        pango_win32_render_transformed  (HDC hdc,
                                             const PangoMatrix *matrix,
                                             PangoFont *font,
                                             PangoGlyphString *glyphs,
                                             int x,
                                             int y);
| hdc : | |
| matrix : | |
| font : | |
| glyphs : | |
| x : | |
| y : | 
void        pango_win32_render_layout_line  (HDC hdc,
                                             PangoLayoutLine *line,
                                             int x,
                                             int y);Render a PangoLayoutLine onto a device context
| hdc : | HDC to use for uncolored drawing | 
| line : | a PangoLayoutLine | 
| x : | the x position of start of string (in pixels) | 
| y : | the y position of baseline (in pixels) | 
void        pango_win32_render_layout       (HDC hdc,
                                             PangoLayout *layout,
                                             int x,
                                             int y);Render a PangoLayoutLine onto an X drawable
| hdc : | HDC to use for uncolored drawing | 
| layout : | a PangoLayout | 
| x : | the X position of the left of the layout (in pixels) | 
| y : | the Y position of the top of the layout (in pixels) | 
PangoGlyph pango_win32_get_unknown_glyph (PangoFont *font, gunichar wc);
Returns the index of a glyph suitable for drawing wc as an unknown character.
| font : | a PangoFont | 
| wc : | the Unicode character for which a glyph is needed. | 
| Returns : | a glyph index into font | 
gint pango_win32_font_get_glyph_index (PangoFont *font, gunichar wc);
Obtains the index of the glyph for wc in font.
| font : | a PangoFont. | 
| wc : | a Unicode character. | 
| Returns : | the glyph index for wc. | 
gboolean pango_win32_get_debug_flag (void);
Returns wether debugging is turned on.
| Returns : | TRUE if debugging is turned on. | 
Since 1.2
HDC pango_win32_get_dc (void);
Obtains a handle to the Windows device context that is used by Pango.
| Returns : | A handle to the Windows device context that is used by Pango. | 
typedef struct _PangoWin32FontCache PangoWin32FontCache;
A PangoWin32FontCache caches HFONTs by their LOGFONT descriptions.
PangoWin32FontCache* pango_win32_font_cache_new (void);
Creates a font cache.
| Returns : | The new font cache. This must be freed with 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.
| cache : | a PangoWin32FontCache | 
HFONT pango_win32_font_cache_load (PangoWin32FontCache *cache, const LOGFONT *logfont);
Creates a HFONT from a LOGFONT. The result may be newly loaded, or it may have been previously stored
| cache : | a PangoWin32FontCache | 
| logfont : | a pointer to a LOGFONT structure describing the font to load. | 
| Returns : | The font structure, or NULL if the font could not be loaded. In order to free this structure, you must call 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_cache_load().
| cache : | a PangoWin32FontCache | 
| hfont : | the HFONT to unload | 
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_shutdown_display().
| Returns : | a PangoFontMap. | 
PangoWin32FontCache* pango_win32_font_map_get_font_cache (PangoFontMap *font_map);
Obtains the font cache associated with the given font map.
| font_map : | a PangoWin32FontMap. | 
| Returns : | the PangoWin32FontCache of font_map. | 
| << Rendering with Pango | FreeType Fonts and Rendering >> |