韦东山第三期-个人笔记源码注释与扩展-PC上测试freetype

本节的主要实现了在PC上测试freetype

 

本节引入一个新概念 linux宽字符

下面是声明的方法 此字符串每个字符会用4个字节来表示，保存的是Unicode码

wchar_t *chinese_str = L"韦东山g";

 

下面是一些关键点记录

1、freetype文件库的使用

将freetype-2.4.10.tar.bz2拷贝到linux虚拟机后，使用tar xjf freetype-2.4.10.tar.bz2进行解压，进入对应文件夹，输入./configure 然后make，然后sudo make install,进行安装，加上sudo是因为需要安装到根目录

 

2、编译源文件使用的指令

使用库的编译方式

编译命令为gcc -o 目标文件 目标文件.c -I 文件目录 -l 指定库的名字 -l

-I（大写i）可指定头文件目录

-l（小写L）可指定编译时的库

此为使用的具体编译命令 指定头文件所在目录为/usr/local/include/freetype2 指定使用freetype与m(数学)库进行编译

gcc -o example1 example1.c -I /usr/local/include/freetype2 -lfreetype -lm

 

指定字符集的编译方式

编译时指定输入字符集为GBK（视频中是GBK形式）

-finput-charset 指定源文件的编码（若不指定，默认是UTF-8）

-fwide-exec-charset --指定宽字节字符串(const wchar_t*)常量在编译后的程序里的保存的编码集

gcc -finput-charset=GBK -fexec-charset=UTF-8 -o example1 example1.c -I /usr/local/include/freetype2 -lfreetype -lm

 

3、运行命令

./example1 ./simsun.ttc abc (运行此代码时需要和字库文件处于同一文件夹) 

 

下面就是源码注释  想实现字符旋转的话，源码注释中已经有所体现

/* example1.c                                                      */
/*                                                                 */
/* This small program shows how to print a rotated string with the */
/* FreeType 2 library.                                             */


#include <stdio.h>
#include <string.h>
#include <math.h>
#include <wchar.h>

#include <ft2build.h>
#include FT_FREETYPE_H
#include FT_GLYPH_H


#define WIDTH   80 //模拟一个屏幕的分辨率
#define HEIGHT  80


/* origin is the upper left corner */
unsigned char image[HEIGHT][WIDTH];


/* Replace this function with something useful. */

void draw_bitmap( FT_Bitmap*  bitmap,
             FT_Int      x,
             FT_Int      y)
{
  FT_Int  i, j, p, q;
  FT_Int  x_max = x + bitmap->width;
  FT_Int  y_max = y + bitmap->rows;


	//printf("x = %d, y = %d\n", x, y);

  for ( i = x, p = 0; i < x_max; i++, p++ )
  {
    for ( j = y, q = 0; j < y_max; j++, q++ )
    {
      if ( i < 0      || j < 0       ||
           i >= WIDTH || j >= HEIGHT )
        continue;

      image[j][i] |= bitmap->buffer[q * bitmap->width + p];
    }
  }
}


void show_image( void )
{
  int  i, j;


  for ( i = 0; i < HEIGHT; i++ )
  {
  	//printf("%02d", i);
    for ( j = 0; j < WIDTH; j++ )
      putchar( image[i][j] == 0 ? ' '
                                : image[i][j] < 128 ? '+'
                                                    : '*' ); 
    putchar( '\n' );
  }
}


int main( int     argc,char**  argv )
{
  FT_Library    library;
  FT_Face       face;

  FT_GlyphSlot  slot;
  FT_Matrix     matrix;                 /* transformation matrix */
  FT_Vector     pen;                    /* untransformed origin  */
  FT_Error      error;

  char*         filename;
  char*         text;

  double        angle;
  int           target_height;
  int           n, num_chars;


  wchar_t *chinese_str = L"韦gif"; //wchar_t 宽字符 此字符串每个字符会用4个字节来表示 保存的编码类型是unicode
  unsigned int *p = (wchar_t *)chinese_str;
  int i;
  FT_BBox bbox;
  FT_Glyph  glyph;

  printf("Uniocde: \n");
  for (i = 0; i < wcslen(chinese_str); i++)
  {
  	printf("0x%x ", p[i]);
  }
  printf("\n");

  if ( argc != 2 ) //用来统计程序运行时发送给main函数的命令行参数的个数  如果是输入这样的命令行./example1 ./simsun.ttc  算是2个
  {
    fprintf ( stderr, "usage: %s font sample-text\n", argv[0] );
    exit( 1 );
  }

  filename      = argv[1];                           /* first argument     */
  //text          = argv[2];                           /* second argument    */
  //num_chars     = strlen( text );
  angle         = ( 0.0 / 360 ) * 3.14159 * 2;      /* 初始化角度  想旋转的话直接更改0.0改成自己想要的角度    */
  target_height = HEIGHT;                          

  error = FT_Init_FreeType( &library );              /* 初始化库 */
  /* error handling omitted */

  error = FT_New_Face( library, argv[1], 0, &face ); /* 创建一个face对象 */ 
  /* error handling omitted */

#if 0
  /* use 50pt at 100dpi */
  error = FT_Set_Char_Size( face, 50 * 64, 0,
                            100, 0 );                /* set character size */

	/* pixels = 50 /72 * 100 = 69  */
#else
	FT_Set_Pixel_Sizes(face, 24, 0); //设置像素大小 
#endif
  /* error handling omitted */

  slot = face->glyph;

  /* 设置角度矩阵 */
  matrix.xx = (FT_Fixed)( cos( angle ) * 0x10000L );
  matrix.xy = (FT_Fixed)(-sin( angle ) * 0x10000L );
  matrix.yx = (FT_Fixed)( sin( angle ) * 0x10000L );
  matrix.yy = (FT_Fixed)( cos( angle ) * 0x10000L );

  /* the pen position in 26.6 cartesian space coordinates; */
  /* start at (0,40) relative to the upper left corner  */
  //设置画图的原点 
  pen.x = 0 * 64;
  pen.y = ( target_height - 40 ) * 64;

  for ( n = 0; n < wcslen(chinese_str); n++ )
  {
    /* set transformation */
    FT_Set_Transform( face, &matrix, &pen ); //设置转换参数

    /* load glyph image into the slot (erase previous one) */
    error = FT_Load_Char( face, chinese_str[n], FT_LOAD_RENDER ); //chinese_str传入的是Unicode码 FT_LOAD_RENDER代表glygh会立刻转化成位图 最后会加载到face->glyph
    if ( error )
      continue;                 /* ignore errors */

    error = FT_Get_Glyph( face->glyph, &glyph );//从slot中取出glyph信息
	if (error)
	{
		printf("FT_Get_Glyph error!\n");
		return -1;
	}

    FT_Glyph_Get_CBox(glyph, FT_GLYPH_BBOX_TRUNCATE, &bbox ); //从glyph信息中 以整数像素形式获得bbox 其中保存了图像的最小坐标和最大坐标

    /* now, draw to our target surface (convert position) */
    draw_bitmap( &slot->bitmap,
                 slot->bitmap_left,
                 target_height - slot->bitmap_top ); //开始加载，

	printf("Unicode: 0x%x\n", chinese_str[n]);
	printf("origin.x/64 = %d, origin.y/64 = %d\n", pen.x/64, pen.y/64);
	printf("xMin = %d, xMax = %d, yMin = %d, yMax = %d\n", bbox.xMin, bbox.xMax, bbox.yMin, bbox.yMax);
    printf("slot->advance.x/64 = %d, slot->advance.y/64 = %d\n", slot->advance.x/64, slot->advance.y/64);

    /* increment pen position */
    pen.x += slot->advance.x; //指定下一个原点的位置
    pen.y += slot->advance.y;
  }

  show_image(); //显示图像

  FT_Done_Face    ( face );
  FT_Done_FreeType( library );

  return 0;
}

/* EOF */