From 394c5821b87bb66d70e04bac9253384b99d0b40a Mon Sep 17 00:00:00 2001 From: Behdad Esfahbod Date: Sat, 28 Jan 2006 20:04:04 +0000 Subject: Documentation improvements. 2006-01-28 Behdad Esfahbod * pango/pangofc-font.h, pango/pangoft2-render.c, pango/pangowin32.c, pango/pangoxft-render.c, docs/tmpl/xft-fonts.sgml: Documentation improvements. --- ChangeLog | 6 ++++++ docs/tmpl/xft-fonts.sgml | 7 +++++-- pango/pangoft2-render.c | 2 +- pango/pangowin32.c | 18 ++++++++++++++++++ pango/pangoxft-render.c | 2 +- 5 files changed, 31 insertions(+), 4 deletions(-) diff --git a/ChangeLog b/ChangeLog index 7f890d5f..dc46406e 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,9 @@ +2006-01-28 Behdad Esfahbod + + * pango/pangofc-font.h, pango/pangoft2-render.c, pango/pangowin32.c, + pango/pangoxft-render.c, docs/tmpl/xft-fonts.sgml: Documentation + improvements. + 2006-01-25 Behdad Esfahbod * configure.in: If major.minor of required and available glib versions diff --git a/docs/tmpl/xft-fonts.sgml b/docs/tmpl/xft-fonts.sgml index fc4d6cae..00f345ae 100644 --- a/docs/tmpl/xft-fonts.sgml +++ b/docs/tmpl/xft-fonts.sgml @@ -41,13 +41,16 @@ overring the #PangoXftRendererClass virtual functions - +#PangoXftFont is an implementation of #PangoFcFont using the Xft +library for rendering. It is used in conjunction with #PangoXftFontMap. - +#PangoXftFontMap is an implementation of #PangoFcFontMap suitable for +the Xft library as the renderer. It is used in to create fonts of +type #PangoXftFont. diff --git a/pango/pangoft2-render.c b/pango/pangoft2-render.c index 1ad03b09..865567e1 100644 --- a/pango/pangoft2-render.c +++ b/pango/pangoft2-render.c @@ -554,7 +554,7 @@ pango_ft2_render_layout_line (FT_Bitmap *bitmap, * pango_ft2_render_transformed: * @bitmap: the FreeType2 bitmap onto which to draw the string * @font: the font in which to draw the string - * @matrix: a #PangoMatrix, or %NULL to use an identity transformation + * @matrix: a #PangoMatrix, or %NULL to use an identity transformation * @glyphs: the glyph string to draw * @x: the x position of the start of the string (in Pango * units in user space coordinates) diff --git a/pango/pangowin32.c b/pango/pangowin32.c index 5f6ab280..2956c69c 100644 --- a/pango/pangowin32.c +++ b/pango/pangowin32.c @@ -395,6 +395,24 @@ pango_win32_render (HDC hdc, g_free (dX); } +/** + * pango_win32_render_transformed: + * @hdc: a windows device context + * @matrix: a #PangoMatrix, or %NULL to use an identity transformation + * @font: the font in which to draw the string + * @glyphs: the glyph string to draw + * @x: the x position of the start of the string (in Pango + * units in user space coordinates) + * @y: the y position of the baseline (in Pango units + * in user space coordinates) + * + * Renders a #PangoGlyphString onto a windows DC, possibly + * transforming the layed-out coordinates through a transformation + * matrix. Note that the transformation matrix for @font is not + * changed, so to produce correct rendering results, the @font + * must have been loaded using a #PangoContext with an identical + * transformation matrix to that passed in to this function. + **/ void pango_win32_render_transformed (HDC hdc, const PangoMatrix *matrix, diff --git a/pango/pangoxft-render.c b/pango/pangoxft-render.c index c1825b31..79163e51 100644 --- a/pango/pangoxft-render.c +++ b/pango/pangoxft-render.c @@ -675,7 +675,7 @@ pango_xft_render_layout_line (XftDraw *draw, * @draw: an #XftDraw * @color: the color in which to draw the glyphs * @font: the font in which to draw the string - * @matrix: a #PangoMatrix, or %NULL to use an identity transformation + * @matrix: a #PangoMatrix, or %NULL to use an identity transformation * @glyphs: the glyph string to draw * @x: the x position of the start of the string (in Pango * units in user space coordinates) -- cgit v1.2.1