summaryrefslogtreecommitdiff
path: root/docs/tmpl/glyphs.sgml
diff options
context:
space:
mode:
authorOwen Taylor <otaylor@redhat.com>2002-12-20 17:18:51 +0000
committerOwen Taylor <otaylor@src.gnome.org>2002-12-20 17:18:51 +0000
commit3a2116e4bc00807b2b353fc953fcc92aa24c67ea (patch)
tree59e3025d6ff0d821f4bfbe2c83a2ddb153eebff9 /docs/tmpl/glyphs.sgml
parent63cd593c34fd384b21722f751c66ed48d722033d (diff)
downloadpango-3a2116e4bc00807b2b353fc953fcc92aa24c67ea.tar.gz
Some unit fixups (#96335)
Fri Dec 20 11:59:22 2002 Owen Taylor <otaylor@redhat.com> Some unit fixups (#96335) * pango/pango-layout.c pango/pango-mapping.c: Fix occurrences of "in thousandths of a device unit" to say "in #PangoGlyphUnit" which will give a link to the PangoGlyphUnit docs. * docs/tmpl/text-attributes.sgml: Change 1000 to PANGO_SCALE. * docs/tmpl/glyphs.sgml: Fix docs for PangoGlyphUnit, fix mention of value of PANGO_SCALE from 1000 to 1024. * pango/pango-layout.c (pango_layout_line_get_x_ranges): Fix the docs for @ranges so it doesn't sound like the coordinates are in pixels.
Diffstat (limited to 'docs/tmpl/glyphs.sgml')
-rw-r--r--docs/tmpl/glyphs.sgml9
1 files changed, 7 insertions, 2 deletions
diff --git a/docs/tmpl/glyphs.sgml b/docs/tmpl/glyphs.sgml
index 4700e713..49ad1cc7 100644
--- a/docs/tmpl/glyphs.sgml
+++ b/docs/tmpl/glyphs.sgml
@@ -23,7 +23,7 @@ The PANGO_SCALE macro represents the scale between dimensions used
for Pango distances and device units. (The definition of device
units is dependent on the output device; it will typically be pixels
for a screen, and points for a printer.) PANGO_SCALE is currently
-1000, but this may be changed in the future.
+1024, but this may be changed in the future.
</para>
<para>
When setting font sizes, device units are always considered to be
@@ -168,7 +168,12 @@ information for a single glyph. Distances are in
<!-- ##### TYPEDEF PangoGlyphUnit ##### -->
<para>
The #PangoGlyphUnit type is used to store dimensions within
-Pango. Dimensions are stored in 1/64ths of a point.
+Pango. Dimensions are stored in 1/PANGO_SCALE of a device unit.
+(A device unit might be a pixel for screen display, or
+a point on a printer.) PANGO_SCALE is currently 1024, and
+is unlikely to change, but you should not depend on its
+exact value. The PANGO_PIXELS() macro can be used to convert
+from glyph units into device units with correct rounding.
</para>