[freetype2] master fc40469: Add example for `FT_Get_Color_Glyph_Layer'.

[Werner LEMBERG]

branch: master
commit fc40469a6f049343f2694d0b724db22558f0d374
Author: Werner Lemberg <address@hidden>
Commit: Werner Lemberg <address@hidden>

    Add example for `FT_Get_Color_Glyph_Layer'.
---
 include/freetype/freetype.h | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)

diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index 1dbcf17..2daf529 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -4256,6 +4256,43 @@ FT_BEGIN_HEADER
    *
    *   @FT_Render_Glyph, however, handles colored glyph layers
    *   automatically if the @FT_LOAD_COLOR flag is passed to it.
+   *
+   * @example:
+   *   {
+   *     FT_Color*         palette;
+   *     FT_LayerIterator  iterator;
+   *
+   *     FT_UInt  layer_glyph_index;
+   *     FT_UInt  layer_color_index;
+   *
+   *
+   *     error = FT_Palette_Select( face, palette_index, &palette );
+   *     if ( error )
+   *       palette = NULL;
+   *
+   *     iterator.p        = NULL;
+   *     layer_glyph_index = FT_Get_Color_Glyph_Layer( face,
+   *                                                   glyph_index,
+   *                                                   &layer_color_index,
+   *                                                   &iterator );
+   *
+   *     if ( palette && layer_glyph_index )
+   *     {
+   *       do
+   *       {
+   *         FT_Color  layer_color = palette[layer_color_index];
+   *
+   *
+   *         // Load and render glyph `layer_glyph_index', then
+   *         // blend resulting pixmap with previously created pixmaps.
+   *
+   *       } while ( ( layer_glyph_index =
+   *                     FT_Get_Color_Glyph_Layer( face,
+   *                                               glyph_index,
+   *                                               &layer_color_index,
+   *                                               &iterator ) ) != 0 );
+   *     }
+   *   }
    */
   FT_EXPORT( FT_UInt )
   FT_Get_Color_Glyph_Layer( FT_Face            face,