嵌入式Linux—FreeType矢量字体
常用API
1.FT_Init_Freetype函数是Fretype库中的一个函数，其功能是初始化Fretype库，并返回指向FT_Library对象的指针。以下是该函数的参数详细说明:
FT_ErrorFT_Init_FreeType(FT_Library*alibrary);
alibrary:指向FT_Library对象指针的指针用于存储初始化后的Freetype库对象。函数调用后，指针指向的对象将包含初始化的Fretype库信息。如果函数调用成功，返回值为0，则为非零错误代码。
需要注意的是，FT_Init_Freetype函数不需要任何其他参数，因为它的功能是初始化Fretype库，而库中的信息是固定的。该函数将初始化Fretype库，以便准备后续的字体渲染和其他操作。
2.FT_New_Face函数是Fretype库中的一个函数，用于创建一个新的字体面对象，其参数详解如下：
FT_ErrorFT_New_Face(FT_Librarylibrary,constchar*filepathname,FT_Longface_index,FT_Face*aface);
library:一个已初始化的FT_Library对象，指向已初始化的Freetype库。
filepathname:字体文件的路径和文件名称。参数可以是绝对路径，也可以是相对于当前工作目录的路径。请注意，这条路径必须是一个字符串。
face_index:字体文件中的字体表面索引通常为0。当字体文件包含多个字体时，可以通过指定索引选择特定的字体表面。
aface:指向FT_Face对象指针的指针用于存储新创建的字体面对象。函数调用后，指针指向的对象将包含字体面信息。如果函数调用成功，返回值为0，则为非零错误代码。
需要注意的是，FT_New_Face函数将根据提供的字体文件路径和文件名创建一个新的字体面对象，并将其存储在*aface指针中。该函数还可以通过face_index参数指定要选择的字体面。如果您想加载字体数据的内存，可以使用FT_New_MemoryFT_Face函数取代FT_New_Face函数，并提供字体数据的指针和大小作为参数。
3.FT_Set_Pixel_Sizes函数是Fretype库中的一个函数，用于设置字体表面的像素尺寸，其参数详细说明如下：
FT_ErrorFT_Set_Pixel_Sizes(FT_Faceface,FT_UIntpixel_width,FT_UIntpixel_height);
face:FT_Face对象已初始化，指向已加载的字体表面。
pixel_width:字体表面的像素宽度以像素为单位。通常，应用程序应选择合适的像素大小，以便在屏幕或其他设备上正确呈现字体。
pixel_height:字体表面的像素高度以像素为单位。与pixel_width类似，应用程序应选择合适的像素大小，以便正确呈现字体。
需要注意的是，FT_Set_Pixel_sizes函数将根据提供的像素宽度和高度将字体表面的像素尺寸设置为所需尺寸。这对于在屏幕上呈现字体非常重要，因为字体必须与屏幕上的其他元素正确协调。函数调用成功返回0，否则返回非零错误代码。
显示单个字符并旋转实例代码：
#include <sys/mman.h>
#include <sys/types.h>
#include <sys/stat.h>
#include <unistd.h>
#include <linux/fb.h>
#include <fcntl.h>
#include <stdio.h>
#include <stdlib.h>
#include <math.h>
#include <string.h>
#include <sys/ioctl.h>
#include <wchar.h>
#include <ft2build.h>
#include FT_FREETYPE_H
#include FT_GLYPH_H
int fd_fb; //文件描述符
int screen_size; //屏幕总字节数(framebuffer的大小)
struct fb_var_screeninfo var;
unsigned char *fb_base;
unsigned int line_width; //行字节
unsigned int pixel_width; //像素字节
void lcd_put_pixel(int x, int y, unsigned int color) {
unsigned char *add_8 = fb_base + y*line_width + x*pixel_width; //像素点对应的内存地址
unsigned short *add_16;
unsigned int *add_32;
unsigned int red, green, blue;
add_16 = (unsigned short*)add_8; //8位转换为16位
add_32 = (unsigned int*) add_8;
switch(var.bits_per_pixel)
{
case 8:
{
/*代码*/
break;
}
case 16:
{
/* 32位转换为RGB565 */
red = (color >> 16) & 0xff; //保留17-24位
green = (color >> 8) & 0xff; //保留8-16位
blue = (color >> 0) & 0xff; //保留0-8位
color = ((red >> 3) << 11) | ((green >> 2) << 5) | (blue >> 3); //组合为16bit
*add_16 = color; //像素点对应的地址空间赋值
break;
}
case 32:
{
*add_32 = color;
break;
}
default:
printf("can't surport %dbpp\n", var.bits_per_pixel);
break;
}
}
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 ( j = y, q = 0; j < y_max; j++, q++ )
{
for ( i = x, p = 0; i < x_max; i++, p++ )
{
if ( i < 0 || j < 0 ||
i >= var.xres || j >= var.yres )
continue;
//image[j][i] |= bitmap->buffer[q * bitmap->width + p];
lcd_put_pixel(i, j, bitmap->buffer[q * bitmap->width + p]);
}
}
}
int main(int argc, char **argv)
{
wchar_t *chinese_str = L"樊";
FT_Library library; //freetype库对象
FT_Error error; //错误信息
FT_Face face; //字体面对象
FT_GlyphSlot slot; //关键点
int font_size = 24;
FT_Vector pen; //字符原点
FT_Matrix matrix; /* transformation matrix */
double angle; //角度
if(argc < 3) {
printf("Usage : %s <font_file> <angle> [font_size]\n", argv[0]);
return -1;
}
angle = ( 1.0* strtoul(argv[2], NULL, 0) / 360 ) * 3.14159 * 2; //角度转弧度
if(argc == 4) {
font_size = strtoul(argv[3], NULL, 0); //提取数字(字符)
}
/* 1.获取framebuffer描述符 */
fd_fb = open("/dev/fb0", O_RDWR); //可读可写
if(fd_fb == -1) {
printf("can not open /dev/fb0\n");
return -1;
}
/* 2.获取屏幕可变参数 */
if(ioctl(fd_fb, FBIOGET_VSCREENINFO, &var)) { //结构体名不是地址，需要取地址
printf("can not get var\n");
return -1;
}
/* 3.计算framebuffer空间大小 **/
line_width = var.xres * var.bits_per_pixel / 8;
pixel_width = var.bits_per_pixel / 8;
screen_size = var.xres * var.yres * var.bits_per_pixel / 8; //单位：字节
fb_base = (unsigned char*)mmap(NULL, screen_size, PROT_READ | PROT_WRITE, MAP_SHARED, fd_fb, 0);
if(fb_base == (unsigned char*)-1) {
printf("can not mmap\n");
return -1;
}
/* 清屏: 全部设为白色 */
memset(fb_base, 0, screen_size);
error = FT_Init_FreeType(&library); //freetype库初始化
error = FT_New_Face(library, argv[1], 0, &face); //创建字体面对象
slot = face->glyph; //从字体面对象中获取关键点
error = FT_Set_Pixel_Sizes(face, font_size, 0); //设置字体面像素尺寸
/* 确定座标 */
pen.x = 0;
pen.y = 0;
/* 设置矩阵 */
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 );
/* 设置形状 */
FT_Set_Transform( face, &matrix, &pen);
error = FT_Load_Char(face, chinese_str[0], FT_LOAD_RENDER); //提取字渲染位图，字符的位图被存在slot->bitmap里
if(error) {
printf("FT_Load_Char error");
return -1;
}
draw_bitmap(&slot->bitmap, var.xres/2, var.yres/2);
munmap(fb_base , screen_size);
close(fd_fb);
return 0;
}