A-A+
使用Tslib在触摸屏上显示汉字
终于到了在触摸屏上显示汉字了，真正写代码、测试的时间是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 */
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 */
……
}
{
……
/* 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).
* 16x8 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 16x16 (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 24x24 (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);
}
#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).
* 16x8 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 16x16 (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 24x24 (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
效果图如下(由于图片已经有了本人的大名，故不打水印了)：
效果图亦可以参见：
/yetanothertest/display-hz-on-touch-screen.html
临时整理的工程目录压缩包：
能显示汉字的tslib压缩包
下一计划是ADC和TS驱动。
