转自:http://www.latelee.org/embedded-linux/use-tslib-to-display-chinese-character.html
终于到了在触摸屏上显示汉字了,真正写代码、测试的时间是1天,在此之前的一切准备、学习花费约2周到3周时间。而为了获取触摸屏上显示的图像,花费约2天。由于网络驱动已经接近于放弃状态,NFS用不了,只好用U盘来回复制(即使没有耐心也必须有耐心了)。明明在内核中选择了支持NTFS格式的读写,但却不能将开发板上的文件复制到U盘,而用另一个FAT32格式的另一牌子的U盘,开发板死活认不出来,网上的资料说要修改代码,我又懒得去改。无奈之下,只好格式化那个NTFS的U盘,结果,这篇文章拖到现在才发表。
郑重说明:
本文作者在本文及前面的文章中没有提及作者的工作内容、工作时间、业余时间及业余生活,因为在这些文章中涉及那些工作、生活内容是不明智的。这些文章并没有任何迹象表明作者没有工作、没有业余生活,也并没有表明作者只生活在写代码中。
免责声明:
本文是作者在研究过程中的一篇文章,本着互联网共享、自由(free,应该不是“免费”)之精神发布于此。本文使用的是Tslib中的代码,并在此基础上添加自己的代码,关于Tslib,作者已经写过很多篇相关的文章了,这里公布的仅仅是自己添加的代码。作者对文中代码没有任何义务,仅因为Tslib使用GPL协议,本文作者必须使用这个协议。作者才疏学浅,孤陋寡闻,能力有限,文中错误的地方,欢迎在文后留言,趁作者还有激情研究之时,大家一直探讨,共同学习,天天向上。
再声明一点,本文作者在S3C2440芯片的开发板上,使用最新下载的tslib,使用汉字字库HZK16、HZK24*,通过自己写的代码,在开发板自带的触摸屏上显示汉字。但是,并没有在其它的测试环境、平台下进行测试。
关于汉字显示的算法(其实没啥算法)、步骤已经在前面的文章说了很多了,此处不再提及。
由于还没有对autotool进行研究,而Tslib又使用这个工具管理代码,因此不懂如何添加新文件,如果让新文件也能编译。只好在原来的原来的文件中添加代码了。添加的代码的函数声明在fbutils.h中,函数定义在fbutils.c文件中,测试代码在ts_test.c中。
代码修改了约三次,基本上都是一些结构上的调整,就不说那些体面的话了。至于真正改动之处,只在最底层的显示字符的代码修改了几个地方,就是将原来的乘法改为移位,而对其它一些地方的乘法及移位测试时,发现没什么区别,因此保留乘法。举一例,如
offset = (*ascii – 0x20 ) * 16;
就没有改为
offset = (*ascii – 0x20 ) << 4;
前者更能让人明白这里的ASCII字符在字库数组中占用16字节,而左移4位,的确让人不知道有什么含义。
已知bug:
1、不在GB2312范围之内的汉字不能正常显示——这是废话,正如在en_US字符集下显示中文一样。
2、UCDOS的HZK24*系列字库文件没有中文字符,像“◆ □ ■ △ ▲”等在16点阵下显示正常,而在24点阵中显示失败(乱码或其它汉字),网上找不到包括完整的中文字符的字库,另外,不知道使用UCDOS的字库算不算侵权(这些东西都可以在网络下载)。
函数声明:
/* new add by Late Lee *//* ascii code */
void put_string_ascii(int x, int y, char *s, unsigned colidx);
void put_string_center_ascii(int x, int y, char *s, unsigned colidx);
/* cineses character */
void put_string_hz(FILE *fp, int x, int y, unsigned char *s, unsigned colidx);
void put_string_center_hz(FILE *fp, int x, int y, unsigned char *s, unsigned colidx);
/* chineses character & ascii */
void put_font(FILE *fp, int x, int y, unsigned char *s, unsigned colidx);
void put_font_center(FILE *fp, int x, int y, unsigned char *s, unsigned colidx);
/* end of new add */
测试代码(ts_test.c):
static FILE *fp; /* HZK file pointer by Late Lee */#define HZK “HZK/HZK16″ /* HZK16 or HZK24K/HZK24S */static void refresh_screen ()
{
……
/* just a test */
unsigned char incode[] = “▲!ADC■测镕试◎示例”; // 注:“镕”字不在GB2312范围之内,不能正常显示。
int y = yres/4+50;
put_string_ascii(0, y, “Powered by Late Lee”, 9);
put_string_hz(fp, 0, y+30, “波神留我看斜阳听取蛙声一片”, 2);
put_font(fp, 0, y+56, incode, 5);
/* end of the test */
……
}
关键的代码(fbutils.c):
/* new add by Late Lee 2011-05-30*///#define HZK24
#ifdef HZK24 /* 24 */
#include “ascii24.h”
#define ASCII_CODE ascii24
#define FONT_SIZE 24 /* size: 24 */
#else /* 16 */
#include “ascii16.h”
#define ASCII_CODE ascii16
#define FONT_SIZE 16 /* size: 16 */
#endif
#define BYTES (FONT_SIZE/8) /* for HZ: 3 bytes 2 bytes*/
#define BUF_SIZE (BYTES * FONT_SIZE) /* HZ buff 3*24 = 72 bytes 2*16 = 32 bytes */
#define ASCII_BYTES (BYTES-1) /* 2 1*/
#define ASCII_SIZE (FONT_SIZE * ASCII_BYTES) /* ASCII buffer: 24*2 = 48 bytes 16 * 1 = 16 bytes */
#define ASCII_WIDTH (FONT_SIZE/2) /* ASCII: 16*8 24*12 */
/* end here Late Lee*/
/*****************************************************************************
* new add by Late Lee 2011-05-30
*****************************************************************************/
/**
* __display_ascii – Display an ASCII code on touch screen
* @x: Column
* @y: Row
* @ascii: Which ASCII code to display
* @colidx: Color index(?)
* This routine display an ASCII code that stored in an array(eg, ASCII_CODE).
* 16×8 ASCII code takes 1 byte, 24*12 ASCII code takes 2 bytes, so we need
* -ASCII_BYTES-.
*/
static void __display_ascii(int x, int y, char *ascii, unsigned colidx)
{
int i, j, k;
unsigned char *p_ascii;
int offset;
offset = (*ascii – 0x20 ) * ASCII_SIZE; /* find the code in the array */
p_ascii = ASCII_CODE + offset;
for(i=0;i<FONT_SIZE;i++)
for(j=0;j<ASCII_BYTES;j++)
for(k=0;k<8;k++)
if( p_ascii[i*ASCII_BYTES+j] & (0x80>>k) )
//if(*( p_ascii + i*ASCII_BYTES+j) & (0x80>>k))
pixel (x + j*8 + k, y + i, colidx);
}
/**
* put_string_ascii – Display an ASCII string on touch screen
* @x: Column
* @y: Row
* @s: Which string to display
* @colidx: Color index
*/
void put_string_ascii(int x, int y, char *s, unsigned colidx)
{
while (*s != 0) {
__display_ascii(x, y, s, colidx);
x += ASCII_WIDTH;
s++;
}
}
/* not test */
void put_string_center_ascii(int x, int y, char *s, unsigned colidx)
{
size_t sl = strlen (s);
put_string_ascii (x – (sl / 2) * ASCII_WIDTH,
y – FONT_SIZE / 2, s, colidx);
}
/**
* __display_font_16 – Display a 16×16 (chinese) character on touch screen
* @fp: File pointer points to HZK(ie, HZK16)
* @x: Column
* @y: Row
* @font: Which (chinese) character to display
* @colidx: Color index
* This routine ONLY display 16*16 character.
* Every character takes two bytes, we show the first 8 bits, then the second 8 bits,
* then the whole world will be shown before us.
*/
static void __display_font_16 (FILE *fp, int x, int y, unsigned char *font, unsigned colidx)
{
int i, j, k;
unsigned char mat[BUF_SIZE]={0};
int qh,wh;
unsigned long offset;
qh = *font – 0xa0;
wh = *(font+1) – 0xa0;
offset = ( 94*(qh-1) + (wh-1) ) * BUF_SIZE; /* offset of the character in HZK */
/* read it */
fseek(fp,offset,SEEK_SET);
fread(mat,BUF_SIZE,1,fp);
/* show it */
for(i=0;i<FONT_SIZE;i++)
for(j=0;j<BYTES;j++)
for(k=0;k<8;k++)
if(mat [i*BYTES+j] & (0x80>>k))
pixel (x + j*8 + k, y + i, colidx);
}
/**
* __display_font_24 – Display a 24×24 (chinese) character on touch screen
* @fp: File pointer points to HZK(ie, HZK24)
* @x: Column
* @y: Row
* @font: Which (chinese) character to display
* @colidx: Color index
*/
static void __display_font_24 (FILE *fp, int x, int y, unsigned char *font, unsigned colidx)
{
unsigned int i, j;
unsigned char mat[FONT_SIZE][BYTES]={{0}};
int qh,wh;
unsigned long offset;
qh = *font – 0xaf;
wh = *(font+1) – 0xa0;
offset = ( 94*(qh-1) + (wh-1) ) * BUF_SIZE;
fseek(fp,offset,SEEK_SET);
fread(mat,BUF_SIZE,1,fp);
for(i=0;i<FONT_SIZE;i++)
for(j=0;j<FONT_SIZE;j++)
if( mat[j][i>>3] & (0x80>>(i&7)) )
// if ( mat[j][i/8] & (0x80>>i%8) ) /* org */
pixel (x + j, y + i, colidx);
}
/**
* put_string_hz – Display a (chinese) character string on touch screen
* @fp: File pointer points to HZK(ie, HZK24 or HZK16)
* @x: Column
* @y: Row
* @s: Which string to display(must be ‘unsigned char*’)
* @colidx: Color index
*/
void put_string_hz (FILE *fp, int x, int y, unsigned char *s, unsigned colidx)
{
while (*s != 0) {
#ifdef HZK24
__display_font_24 (fp, x, y, s, colidx); /* for HZK24 */
#else
__display_font_16 (fp, x, y, s, colidx);
#endif
x += FONT_SIZE;
s += 2; /* 2 bytes */
}
}
/* not test */
void put_string_center_hz (FILE *fp, int x, int y, unsigned char *s, unsigned colidx)
{
size_t sl = strlen ((char *)s);
put_string_hz (fp, x – (sl/2) * FONT_SIZE, y – FONT_SIZE/2, s, colidx);
}
/**
* put_font – Display an ASCII or/and (chinese) character string on touch screen
* @fp: File pointer points to HZK(ie, HZK24 or HZK16)
* @x: Column
* @y: Row
* @s: Which string to display
* @colidx: Color index
*/
void put_font(FILE *fp, int x, int y, unsigned char *s, unsigned colidx)
{
while (*s != 0) {
if ( (*s>0xa0) && (*(s+1)>0xa0) ) {
#ifdef HZK24
__display_font_24 (fp, x, y, s, colidx); /* for HZK24 */
#else
__display_font_16 (fp, x, y, s, colidx); /* for HZK16 */
#endif
x += FONT_SIZE;
s += 2; /* 2 bytes */
} else {
__display_ascii (x, y, (char *)s, colidx);
x += ASCII_WIDTH;
s++; /* 1 byte */
}
}
}
/* not test */
void put_font_center(FILE *fp, int x, int y, unsigned char *s, unsigned colidx)
{
size_t sl = strlen ((char *)s);
put_font (fp, x – (sl/2) * 16, y – 16/2, s, colidx);
}
关于截图:
使用fb2png(可通过google搜索“fb2png”,我是很辛苦才找到的),交叉编译,在开发板上执行如下命令:
fb2png /dev/fb0 filename.png 5 800 600 24
实际中使用的命令为:
fb2png /dev/fb0 filename.png 5 240 320 16
效果图如下(由于图片已经有了本人的大名,故不打水印了):
效果图亦可以参见:
http://www.latelee.org/yetanothertest/display-hz-on-touch-screen.html
临时整理的工程目录压缩包:
下一计划是ADC和TS驱动。
本文固定链接: http://www.latelee.org/embedded-linux/use-tslib-to-display-chinese-character.html