============================================================================================
一、FreeType使用详解     
参考来源：
1、freetype-doc-2.10.1.tar/freetype-doc-2.10.1/freetype-2.10.1/docs/tutorial/step1.html（文字说明）
2、freetype-2.10.1.tar/freetype-2.10.1/docs/reference/site/ft2-base_interface.html（函数定义）
3、韦东山视频：freetype介绍。
4、项目1数目相框_笔记\04\freetype-doc-2.10.1.tar\freetype-doc-2.10.1\freetype-2.10.1\docs\tutorial\example1.c（freetype-2.10.1工程自带的C代码）。


技巧：如果想更好地理解代码每个函数的定义，可以在source insight添加freetype-2.10.1.tar工程，    结合对应文档进行理解
============================================================================================
I. Simple Glyph Loading(简单字形加载)
    1. Header Files（头文件）
        Include the file named ft2build.h.（包含头文件 ）
       
        #include <ft2build.h>
        #include FT_FREETYPE_H
       
    2. Library Initialization（库初始化）
       
        To initialize the FreeType library, create a variable of type FT_Library named, for example, library, and call the function FT_Init_FreeType.
        用法：为了初始化FreeType library。需要的创建一个FT_Library类型的变量，比如library。然后调用函数FT_Init_FreeType。
        FT_Init_FreeType的用法：{FT_Init_FreeType( &library );}返回值：0表示成功。返回错误码见fterrdef.h.
    3. Loading a Font Face（用三种方式，1、从一个字库文件创建Face对象；2、从From Memory创建一个Face对象；3、其他方式）
        a. From a Font File（通过调用FT_New_Face打开一个字库文件从而创建一个新的face（这个可以理解为一个平面）对象，其代表一个字体文件。）调用函数FT_New_Face{FT_New_Face( library,
                     "/usr/share/fonts/truetype/arial.ttf",
                     0,
                     &face )}参数1：FT_Library类型的变量；参数2：字库文件路径（）；参数3：经常使用0；参数4：为一指针，用来描述face这一个对象。返回值：成功为0.其他看对应文档
            要知道给定字体文件包含多少个面，可以将第三参数设置为-1，然后检查face->num_faces的值，该值指示字体文件中嵌入了多少个面。
        b. From Memory（不常使用）  
            调用函数FT_New_Memory_Face( library,
                            buffer,    /* first byte in memory */
                            size,      /* size in bytes        */
                            0,         /* face_index           */
                            &face );
    4. Accessing the Face Data（访问Face对象中数据）
        可以使用的face?>num_glyphs等等一些成员.方式访问其中的数据。
    5. Setting the Current Pixel Size（设置当前像素大小，即填充生成Face）
        a、使用到的函数（设置一个字符宽和高各多少像素点）定义：  
                FT_Set_Char_Size( FT_Face     face,
                                    FT_F26Dot6  char_width,
                                    FT_F26Dot6  char_height,
                                    FT_UInt     horz_resolution,
                                    FT_UInt     vert_resolution );
        参数1：  之前得到的Face；参数2：字符的高度：参数3：字符宽度；参数4：水平方向分辨率；参数5：竖直方向分辨率
        参数2、3如何设置：
             The character widths and heights are specified in 1/64th of points，A point is a physical distance, equaling 1/72th of an inch。也就是说字符高度和宽度的单位是的1/64*1/72英寸。如果第二个参数的值是0，则表明宽度和高度相等。
        参数4、5如何设置：
            The horizontal and vertical device resolutions are expressed in dots-per-inch, or dpi。也就是说每英寸里面存在多少像素。如果第二个参数0，则表明水平和竖直相等。 If both values are zero, 72 dpi is used for both dimensions.如果都为0，表明都使用72dpi。
        如何计算一个字符里面包含多少个像素点呢：
            举例说明：
            char_width= 100
            char_height= 100
            horz_resolution= 200
            vert_resolution= 200
            计算一个字符宽度由几个像素组成：100*1/64*1/72*200=4.3像素：同理计算字符高度需要多少像素。
        b、如果我们不想使用FT_Set_Char_Size，我们可以使用FT_Set_Pixel_Sizes
            函数定义：  FT_Set_Pixel_Sizes( FT_Face  face,
                                            FT_UInt  pixel_width,
                                            FT_UInt  pixel_height );
        因为使用FT_Set_Char_Size最终是得到了一个字符需要多少个像素组成，而对于使用FT_Set_Pixel_Sizes我们可以直接使用这个函数设置pixel_width和pixel_height。
    6. Loading a Glyph Image
        a. Converting a Character Code Into a Glyph Index
            知识点：
            如果我们想要得到一个字符的glyph（关键信息），我们就需要提供这个字符的（唯一的）字符码（ascii、unicode、GBK等等。）。每一个字库文件中都存在一个charmap表。我可以通过这个表把提供字符码（可能是ascii也有点可能是unicode）作为索引在字库文件中找到该字符对应的glyph。
           
            使用的函数：  FT_Get_Char_Index( FT_Face   face,
                                            FT_ULong  charcode );
        b. Loading a Glyph From the Face
            说明：            
            1、加载找到的The glyph image到 face->glyph插槽中即slot中；
            The glyph image is always stored in a special object called a glyph slot，Each face object has a single glyph slot object that can be accessed as face->glyph.每一个Face都有一个slot object，slot object用来的存储The glyph image
           
            Loading a glyph image into the slot is performed by calling FT_Load_Glyph.加载一个a glyph image到这个插槽对象中，用法如下：
            函数：FT_Load_Glyph( FT_Face   face,
                                        FT_UInt   glyph_index,
                                        FT_Int32  load_flags );
                                       
            2、将slot（face->glyph）中The glyph image转化为位图（真正的图像，也就是字符点阵）
            The field face?>glyph?>format describes the format used for storing the glyph image in the slot. If it is not FT_GLYPH_FORMAT_BITMAP, one can immediately convert it to a bitmap through FT_Render_Glyph.
            说明：如果face?>glyph?>format里面图像格式不是FT_GLYPH_FORMAT_BITMAP，那就立即将slot（face->glyph）中的图像立即的转化为a bitmap（位图），需要使用的函数：
                                        FT_Render_Glyph( FT_GlyphSlot    slot,
                                                    FT_Render_Mode  render_mode );
            参数1：face->glyph变量。
            参数2：位图的呈现模式
        c. Using Other Charmaps
            在6.a步骤中，如果我们不想使用face中charmap表格默认的索引（unicode），我们提供可能是其他编码，我们可以通过相应的函数修该对应的charmaps
                函数：error = FT_Select_Charmap(
                                                    face,               /* target face object */
                                                    FT_ENCODING_BIG5 ); /* encoding
                参数2含义:指定使用编码，这里是FT_ENCODING_BIG5
               
                那么如何确定已经打开的字库文件中包含多少charmaps，可以用以下代码：
                for ( n = 0; n < face->num_charmaps; n++ )
                        {
                            charmap = face->charmaps[n];
                            if ( charmap->platform_id == my_platform_id &&
                                    charmap->encoding_id == my_encoding_id )
                        {
                    found = charmap;
                    break;
                    }

        d. Glyph Transformations
            如果的我们需要将显示字符做一个平移或者旋转，就需要使用一个函数：
              FT_Set_Transform( FT_Face     face,
                                FT_Matrix*  matrix,
                                FT_Vector*  delta );
            参数介绍：
            参数2：指向一个matrix的指针，首先定义一个FT_Matrix的变量。对该变量进行初始化（旋转多少度。）。
            参数3：这个字符基点（原点）在定义的显示区域的位置。
              设置参数3有一个知识点：
               字库文件中的字符基点（原点）使用的是笛卡尔坐标（位于左下角）。而对于LCD而言话，其坐标原点位于屏幕的左上角，因此设置FT_Vector类型变量时。需要将字符位置进行一个转换。矢量坐标表示为1/64个像素(也称为26.6个定点数，因此需要乘以一个64)。
    7. Simple Text Rendering
        The idea is to create a loop that loads one glyph image on each iteration, converts it to a pixmap, draws it on the target surface, then increments the current pen position.(其思想是创建一个循环，在每次迭代中加载一个字形图像，将其转换为像素图，在目标表面绘制它，然后增加当前笔的位置。)
        ========================================================================================================
        a. Basic Code(基本的代码)
        ========================================================================================================
                    ... initialize library ...
                    ... create face object ...
                    ... set character size ...

                    pen_x = 300;                 //字符显示的位置
                    pen_y = 200;
                   
                   
                    for ( n = 0; n < num_chars; n++ ) //使用一个循环遍历整个所要显示的字符
                    {
                      FT_UInt  glyph_index;                                


                      /* retrieve glyph index from character code */
                      glyph_index = FT_Get_Char_Index( face, text[n] );    //循环内step1 寻找第n个字符对应的index

                      /* load glyph image into the slot (erase previous one)：将的生成的image放进slot */
                      error = FT_Load_Glyph( face, glyph_index, FT_LOAD_DEFAULT );  //循环内step2，根据index找到其对应的字形轮廓
                      if ( error )
                        continue;  /* ignore errors */

                      /* convert to an anti-aliased bitmap：转化为位图（位图是点阵吗？） */
                      error = FT_Render_Glyph( face->glyph, FT_RENDER_MODE_NORMAL );  //循环内step3，将字形轮廓转化为位图
                      if ( error )
                        continue;

                      /* now, draw to our target surface */                         //循环内step4
                      my_draw_bitmap( &slot->bitmap,
                                      pen_x + slot->bitmap_left,
                                      pen_y - slot->bitmap_top );
                      /* increment pen position */
                      pen_x += slot->advance.x >> 6;                                //循环内step5
                      pen_y += slot->advance.y >> 6; /* not useful for now */
                    }
                    总结：
                    这一快代码是循环体内最基本代码，目前我的疑惑：
                    my_draw_bitmap函数如何实现（看了源码现在也不太懂（目前不知道slot->bitmap放的是什么,点阵？，那应该是一堆的0和1。但是结合后面调用的show image函数中的{putchar( image[i][j] == 0 ? ' '
                                : image[i][j] < 128 ? '+'
                                                    : '*' );}，又好像不对 。现在无法解决。））
        =======================================================================================================
        b.Refined code(精简的代码)建议使用为什么有这一部分b呢（主要是与a进行对比，不同在for循环体内）
        ========================================================================================================
                    for ( n = 0; n < num_chars; n++ )
                        {
                          /* load glyph image into the slot (erase previous one) */
                          error = FT_Load_Char( face, text[n], FT_LOAD_RENDER );   //step1
                          if ( error )
                            continue;  /* ignore errors */

                          /* now, draw to our target surface */
                          my_draw_bitmap( &slot->bitmap,
                                          pen_x + slot->bitmap_left,
                                          pen_y - slot->bitmap_top );

                          /* increment pen position */
                          pen_x += slot->advance.x >> 6;
                        }
    总结:对比a. Basic Code(基本的代码)和bRefined code(精简的代码)
                a中循环内step1~step3被b中step1替代同样可以达到效果（将得到的glyph转化为位图）
    ============================================================================================
二、使用韦老师提供的freetype-2.4.10源码进行编译安装 freetype，然后运行韦老师的代码
============================================================================================
因为编写的代码代码需要调用的安装freetype所生成的库文件（包括头文件，函数的定义等等）。
自己的体会：
1、如何安装freetype。可从源码根目录中READM出发，查看安装的过程。
2、安装freetype之后，就会在/user/local（默认）下面的目录（环境变量）中生成库文件。安装文档中也有讲。
3、下面就是执行韦老师的程序了
gcc -o example1 example1.c
出错信息：/usr/local/include/ft2build.h:56:38: fatal error: freetype/config/ftheader.h: No such file or directory
但是经过查看/usr/local/include/ft2build.h中56行 #include <freetype/config/ftheader.h>。在进行查看发现/usr/local/include/freetype2/freetype/config/ftheader.h存在头文件。这表示程序未找到对应路径因此需要指定路径：gcc -o example1 example1.c -I /usr/local/include/freetype2/。也就是说在freetype2/然后执行#include <freetype/config/ftheader.h>。执行发现

example1.c:(.text+0x25b): undefined reference to `FT_Init_FreeType'
example1.c:(.text+0x284): undefined reference to `FT_New_Face'
example1.c:(.text+0x29d): undefined reference to `FT_Set_Pixel_Sizes'
example1.c:(.text+0x2c4): undefined reference to `cos'
example1.c:(.text+0x2f5): undefined reference to `sin'
example1.c:(.text+0x332): undefined reference to `sin'
example1.c:(.text+0x363): undefined reference to `cos'
example1.c:(.text+0x3b6): undefined reference to `FT_Set_Transform'
example1.c:(.text+0x3de): undefined reference to `FT_Load_Char'
example1.c:(.text+0x465): undefined reference to `FT_Done_Face'
example1.c:(.text+0x471): undefined reference to `FT_Done_FreeType'
提示是未定义，但是，我们已经包含了对应的头文件，因此程序链接的时候未找到安装freetype生成的库文件，因此的需要指定生成的库文件（注意:去掉lib前缀）：
gcc -o example1 example1.c -I /usr/local/include/freetype2/ -lfreetype   执行发现：
example1.c:(.text+0x2c4): undefined reference to `cos'
example1.c:(.text+0x2f5): undefined reference to `sin'
example1.c:(.text+0x332): undefined reference to `sin'
example1.c:(.text+0x363): undefined reference to `cos'
表明链接的时候未找到对应的数学库，因此执行（不能加-lmath而是加-lm）：
gcc -o example1 example1.c -I /usr/local/include/freetype2/ -lfreetype -lm                成功
然后执行./example1 BROADW.TTF abc.
执行成功
============================================================================================
三、使用韦老师提供的freetype-2.4.10源码进行编译安装 freetype，然后运行自己写的代码
============================================================================================
自己写的代码，是可以运行出结果，只能显示单个字符，如果是多个字符的话，就会导致，字符存在重合，我的代码里面已经使用
        pen.x += slot->advance.x;
        pen.y += slot->advance.y;
        者这句代码，但是实验的结果，表明第二字符之后origin（原点仍然没用移动），后面解决这个问题。