Hi Werner,
This is a proposal for a tutorial update. Perhaps it is a bit redundant.
Alexei
--- a/tree/freetype2/docs/tutorial/step1.html 2015-12-01 10:47:45.000000000
-0500
+++ b/tree/freetype2/docs/tutorial/step1.html 2015-12-01 11:22:41.776663000
-0500
@@ -566,11 +566,11 @@
<p>The parameter <tt>render_mode</tt> is a set of bit flags
to specify how to render the glyph image.
<tt>FT_RENDER_MODE_NORMAL</tt>, the default, renders an
- anti-aliased bitmap with 256 gray levels (also called
- a <em>pixmap</em>), as this is the default. You can
- alternatively use <tt>FT_RENDER_MODE_MONO</tt> if you want
- to generate a 1-bit monochrome bitmap. More values are
- available for
+ anti-aliased coverage bitmap with 256 gray levels (also
+ called a <em>pixmap</em>), as this is the default. You
+ can alternatively use <tt>FT_RENDER_MODE_MONO</tt> if you
+ want to generate a 1-bit monochrome bitmap. More values
+ are available for
the <a
href="../reference/ft2-base_interface.html#FT_Render_Mode"><tt>FT_Render_Mode</tt></a>
enumeration value.</p>
@@ -578,7 +578,9 @@
directly through <tt>glyph->bitmap</tt> (a simple
descriptor for bitmaps or pixmaps), and position it
through <tt>glyph->bitmap_left</tt> and
- <tt>glyph->bitmap_top</tt>.</p>
+ <tt>glyph->bitmap_top</tt>. For optimal renering on a
+ screen, the bitmap should be used as alpha channel in
+ linear blending with gamma correction.</p>
<p>Note that <tt>bitmap_left</tt> is the horizontal distance
from the current pen position to the leftmost border of
@@ -799,7 +801,10 @@
takes a pointer to
an <a
href="../reference/ft2-basic_types.html#FT_Bitmap"><tt>FT_Bitmap</tt></a>
descriptor and the position of its top-left corner as
- arguments.</li>
+ arguments. For ideal rendering on a screen, this
+ function should perform linear blending with gamma
+ correction, using the bitmap as an alpha channel.
+ </li>
<li>The value of <tt>slot->bitmap_top</tt> is positive
for an <em>upwards</em> vertical distance. Assuming
_______________________________________________
Freetype-devel mailing list
Freetype-devel@nongnu.org
https://lists.nongnu.org/mailman/listinfo/freetype-devel
