FreeType 矢量字体 测试移植
Posted x2i0e19linux
tags:
篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了FreeType 矢量字体 测试移植相关的知识，希望对你有一定的参考价值。
之前有做过 ascii 和汉字库的字体点阵在lcd上显示的例子，都是按照指定大小的字库的点阵来显示的，所以一但选定了字体文件后，就固定了大小，不可变化，当然也可以存放各种 大小的字体文件，但这样的话就需要很多的空间，这种方法显然不好使，所以就引入了失量字体，关于字体的特点就不啰嗦了。可以去网上搜到很多说明。下面我们一步一步的来做实验测试了解失量字体的用法，先在PC机上测试，然后再移植到开发板上用lcd显示。
一、首先我们要去获得失量字体的源码和一些文档，https://www.freetype.org/freetype2/docs/documentation.html 这里就是官网。然后按照他的文档来简单了解一下，同时还提供了一个C例子，分析例子，修改后可以先在PC机上测试。
二、得到源码后，解压配置安装。列出步骤和命令。注意这是在PC机上运行的命令如果要在开发板上运行，要用交叉编译 还有配置也有不同
./configure 配置
make 编译
sudo make install 安装
三、把源码例子拿过来编译
gcc -o example example.c -I /usr/local/include/freetype2/ -lfreetype -lm
/* -I /usr/local/include/freetype2/ 指定头文件目录 -lfreetype 指定库类型 -lm 指定数学库 */
/* 这是大i 这是小L 小L */
如果没加会出错，不信可以先不加试一试然后一个一个加试下，这是方法，为什么我也不知道
./example ./simsun.ttc abc 执行就会打印出字体文件在终端上，但是看不到，因为源码里的设置太大了，要改小一些才可以
在执行时需要一个字体文件，可以从C:WindowsFonts里找一个复制过去
下面贴出一段在PC上显示代码 用FreeType官方例子稍改就可以了。
/* 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 <ft2build.h> #include FT_FREETYPE_H /* 这里修改 原来是680 480 太大 */ #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; /* for simplicity, we assume that `bitmap->pixel_mode‘ */ /* is `FT_PIXEL_MODE_GRAY‘ (i.e., not a bitmap font) */ 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++ ) { for ( j = 0; j < WIDTH; j++ ) putchar( image[i][j] == 0 ? ‘ ‘ : image[i][j] < 128 ? ‘+‘ : ‘*‘ ); putchar( ‘ ‘ ); } } 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; if ( argc != 3 ) { fprintf ( stderr, "usage: %s font sample-text ", argv[0] ); exit( 1 ); } filename = argv[1]; /* first argument */ text = argv[2]; /* second argument */ num_chars = strlen( text ); /* 角度设为0不旋转 */ angle = ( 0.0 / 360 ) * 3.14159 * 2; /* use 25 degrees */ target_height = HEIGHT; error = FT_Init_FreeType( &library ); /* initialize library */ /* error handling omitted */ error = FT_New_Face( library, filename, 0, &face );/* create face object */ /* error handling omitted */ #if 0 /* use 50pt at 100dpi */ error = FT_Set_Char_Size( face, 50 * 64, 0, 100, 0 ); /* set character size */ /* error handling omitted */ #else error = FT_Set_Pixel_Sizes( face, /* handle to face object */ 0, /* pixel_width */ 16 ); /* pixel_height */ #endif /* cmap selection omitted; */ /* for simplicity we assume that the font contains a Unicode cmap */ slot = face->glyph; /* set up matrix */ 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 (300,200) relative to the upper left corner */ /* 这里也要改 因为上面改了 */ pen.x = 0 * 64; pen.y = ( target_height - 40 ) * 64; for ( n = 0; n < num_chars; n++ ) { /* set transformation */ FT_Set_Transform( face, &matrix, &pen ); /* load glyph image into the slot (erase previous one) */ error = FT_Load_Char( face, text[n], FT_LOAD_RENDER ); if ( error ) continue; /* ignore errors */ /* now, draw to our target surface (convert position) */ draw_bitmap( &slot->bitmap, slot->bitmap_left, target_height - slot->bitmap_top ); /* 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 */
上面显示了英文字符，通过执行程序时传进去的 abc 如果我们想显示中文怎么办呢，我们在源码里先定义一个字符串，再显示字符串 这里有一个地方要注意，字符串要以宽字符的方式定义保存，不能以 char *str = "矢量字体"； 这样的方式定义，因为中文是用二个字节保存的 英文是一个字节，如果一个字符串里又有中文又有英文就不好处理了。因此又引入了“宽字符” 宽字符怎么用，老办法 搜。wchar_t *str = L"矢量字体"； 这样定义 同时还有一个头文件要包含进去 #include <wchar.h> ,下面列出一个例子，同样是在上面的基础上改的。
在这个例子里会出现编译时 提示无法转换字符集 error:converting to execution character set: Invalid or incomplete multibyte or wide character
在指定字符输入输出字符集编译 gcc -finput-charset=GBK -fexec-charset=UTF-8 -o example example.c -I /usr/local/include/freetype2/ -lfreetype -lm
这里列出源码
/* 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 /* 这里修改 原来是680 480 太大 */ #define WIDTH 100 #define HEIGHT 100 /* 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; /* for simplicity, we assume that `bitmap->pixel_mode‘ */ /* is `FT_PIXEL_MODE_GRAY‘ (i.e., not a bitmap font) */ 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++ ) { for ( j = 0; j < WIDTH; j++ ) putchar( image[i][j] == 0 ? ‘ ‘ : image[i][j] < 128 ? ‘+‘ : ‘*‘ ); putchar( ‘ ‘ ); } } 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"矢量字体"; /* 把参数改为2个 */ if ( argc != 2 ) { fprintf ( stderr, "usage: %s font ", argv[0] ); exit( 1 ); } /* 注释掉这两行 */ filename = argv[1]; /* first argument */ // text = argv[2]; /* second argument */ // num_chars = strlen( text ); /* 角度设为0不旋转 */ angle = ( 0.0 / 360 ) * 3.14159 * 2; /* use 25 degrees */ target_height = HEIGHT; error = FT_Init_FreeType( &library ); /* initialize library */ /* error handling omitted */ error = FT_New_Face( library, filename, 0, &face );/* create face object */ /* error handling omitted */ #if 0 /* use 50pt at 100dpi */ error = FT_Set_Char_Size( face, 50 * 64, 0, 100, 0 ); /* set character size */ /* error handling omitted */ #else /* 直接用这个函数设字像素大小 */ error = FT_Set_Pixel_Sizes( face, /* handle to face object */ 0, /* pixel_width */ 24 ); /* pixel_height */ #endif /* cmap selection omitted; */ /* for simplicity we assume that the font contains a Unicode cmap */ slot = face->glyph; /* set up matrix */ 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 (300,200) relative to the upper left corner */ /* 这里也要改 因为上面改了 */ pen.x = 10 * 64; pen.y = ( target_height - 40 ) * 64; /* man wcslen man strlen 去找到用法 得到字符串长度 */ 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 ); if ( error ) continue; /* ignore errors */ /* now, draw to our target surface (convert position) */ draw_bitmap( &slot->bitmap, slot->bitmap_left, target_height - slot->bitmap_top ); /* 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 */
通过上面的测试，下面总结一下freetype字体的用法，和一些注意事项。参考官方文档。后面会慢慢增加对FreeType的测试代码。
以上是关于FreeType 矢量字体 测试移植的主要内容，如果未能解决你的问题，请参考以下文章