Add new letter_spacing attribute.

Wed Jun 23 11:17:51 2004  Owen Taylor  <otaylor@redhat.com>

        * pango/pango-attributes.[ch]: Add new letter_spacing
        attribute.

        * pango/pango-attributes.c (pango_attr_rise_new): Correct
        description; rise is in Pango units, not em-relative.

        * pango/pango-glyph-item.c: Break out iteration-over-clusters
        from ApplyAttrsState into a separate GlyphItemIter.

        * pango/pango-glyph-item.[ch]: New function
        pango_glyph_item_letter_space() to add add letter spacing
        to a single glyph item.

        * pango/pango-markup.c: Add a letter_spacing attribute.

        * pango/pango-layout.c: Use G_DEFINE_TYPE().

        * pango/pango-layout.c (pango_layout_get_item_properties):
        Switch to use a structure rather than a pile of out
        parameters.

        * pango/pango-layout.c (pango_run_get_extents): Remove
        the unused shape_set out parameter.

        * pango/pangofc-decoder.[ch] pango/pangofc-fontmap.[ch]:
        Doc fixes.

        * pango/pango-types.h: Deprecate pango_get_mirror_char()

        * pango/pango-utils.c (pango_get_mirror_char): Add docs.

        * docs/pango-sections.txt docs/pango-docs.sgml: Add
        PangoFcDecoder and letter spacing.

1 files changed, 24 insertions, 21 deletions

diff --git a/pango/pangofc-decoder.c b/pango/pangofc-decoder.c
index ff177b1e..118c17e8 100644
--- a/pango/pangofc-decoder.c
+++ b/pango/pangofc-decoder.c
@@ -41,19 +41,19 @@ pango_fc_decoder_class_init (PangoFcDecoderClass *klass)
 
 /**
  * pango_fc_decoder_get_charset:
- * @decoder: A #PangoFcDecoder to use when querying the font for a
- * supported #FcCharSet.
- * @fcfont: The #PangoFcFont to query.
+ * @decoder: a #PangoFcDecoder
+ * @fcfont: the #PangoFcFont to query.
  *
  * Generates an #FcCharSet of supported characters for the fcfont
- * given.  The returned #FcCharSet should be a reference to an
- * internal value stored by the #PangoFcDecoder and will not be freed
- * by Pango.
+ * given.  The returned #FcCharSet will be a reference to an
+ * internal value stored by the #PangoFcDecoder and must not
+ * be modified or freed.
  *
- * Since: 1.6
+ * Return value: the #FcCharset for @fcfont; must not be modified
+ *   or freed.
  *
- */
-
+ * Since: 1.6
+ **/
 FcCharSet *
 pango_fc_decoder_get_charset (PangoFcDecoder *decoder,
 			      PangoFcFont    *fcfont)
@@ -65,22 +65,25 @@ pango_fc_decoder_get_charset (PangoFcDecoder *decoder,
 
 /**
  * pango_fc_decoder_get_glyph:
- * @decoder: A #PangoFcDecoder to use when querying the font.
- * @fcfont: The #PangoFcFont to query.
- * @wc: The unicode code point that you would like to see converted to
- * a single #PangoGlyph.
+ * @decoder: a #PangoFcDecoder
+ * @fcfont: a #PangoFcFont to query.
+ * @wc: the unicode code point to convert to a single #PangoGlyph.
  *
- * Generates a #PangoGlyph for the given unicode point with the custom
- * decoder.
+ * Generates a #PangoGlyph for the given unicode point using the
+ * custom decoder. For complex scripts where there can be multiple
+ * glyphs for a single character, the decoder will return whatever
+ * glyph is most convenient for it. (Usually whatever glyph is directly
+ * in the fonts character map table.)
  *
- * Since: 1.6
+ * Return value: the glyph index, or 0 if the glyph isn't covered
+ *  by the font.
  *
- */
-
+ * Since: 1.6
+ **/
 PangoGlyph
-pango_fc_decoder_get_glyph   (PangoFcDecoder *decoder,
-			      PangoFcFont    *fcfont,
-			      guint32         wc)
+pango_fc_decoder_get_glyph (PangoFcDecoder *decoder,
+			    PangoFcFont    *fcfont,
+			    guint32         wc)
 {
   g_return_val_if_fail (PANGO_IS_FC_DECODER (decoder), 0);