μcGUI学习笔记之三文本显示与数值显示-阿里云开发者社区

开发者社区> maojunxu> 正文

μcGUI学习笔记之三文本显示与数值显示

简介:   μc/GUI学习笔记之三文本显示与数值显示 3.1      文本显示 3.1.1   显示支持控制字符 文本显示支持的ASCII字符如图3.1。
+关注继续查看
 

μc/GUI学习笔记之三文本显示与数值显示

3.1      文本显示

3.1.1   显示支持控制字符

文本显示支持的ASCII字符如图3.1。

图3.1  显示支持的ASCII控制字符

字符

C字符

功能

LF

\n

换行符。当前的文本显示位置更改到下一行。类似于C语言中的换行

CR

\r

类似于C语言的回车。不换行,仅回车,X坐标设置为0

3.1.2   文本显示API

主要的文本显示API如下:

l  void GUI_DispChar(U16 c):在当前窗口的当前的文本位置使用当前字体显示一个字符;如果字体不支持,则不会显示;

l  void GUI_DispCharAt(U16 c, I16P x, I16P y):在当前窗口的指定文本位置使用当前字体显示一个字符;如果字体不支持,则不会显示。指定的坐标为显示的字符的左上角坐标;

l  void GUI_DispChars(U16 c, int Cnt):在当前窗口的当前的文本位置使用当前字体显示Cnt个同一字符;如果字体不支持,则不会显示;

l  void GUI_DispNextLine(void):移动光标至下一行行首,相当于换行;

l  void GUI_DispString(const char GUI_FAR *s):在当前窗口的当前的文本位置使用当前字体显示一个字符串,可支持’\n’控制字符;如果字体不支持,则不会显示;

l  void GUI_DispStringLen(const char GUI_FAR *s, int Len); 在当前窗口的当前的文本位置使用当前字体显示一个字符;如果字体不支持,则不会显示.如果字符串长度较短,以空格填充,否则将只显示一部分;

l  void GUI_DispStringAt(const char GUI_FAR *s, int x, int y):在当前窗口的指定的文本位置使用当前字体显示一个字符串,可支持’\n’控制字符;如果字体不支持,则不会显示;

l  GUI_DispStringAtCEOL():显示字符串,并清除至显示串尾至对应行行末的显示内容;

l  void GUI_DispStringHCenterAt(const char GUI_FAR *s, int x, int y): 在当前窗口的以(x,y)为横向居中的位置用当前字体显示一个字符串(文本居中显示);如果字体不支持,则不会显示;

l  void GUI_DispStringInRect(const char GUI_FAR *s, const GUI_RECT *pRect, int Align):在在当前窗口中指定的矩形框内以当前字体显示一个字符串.。坐标的基准为字符串中部位置。对齐方式Align可选值为:

u  GUI_TA_TOP, GUI_TA_BOTTOM, GUI_TA_VCENTER for vertical alignment.;

u  GUI_TA_LEFT, GUI_TA_RIGHT, GUI_TA_HCENTER for horizontal alignment。

选择在矩形框内的对齐方式。如果矩形框太小,则有可能无法显示所有内容。

l  void GUI_DispStringInRectEx(const char GUI_UNI_PTR *s,GUI_RECT* pRect,int TextAlign,int MaxLen,const GUI_ROTATION * pLCD_Api); 在在当前窗口中指定的矩形框内以当前字体显示一个字符串.MaxLen-最大字符串长度。pLCD_Api取值GUI_ROTATE_0,GUI_ROTATE_CCW顺时针旋转90度。

注:上面的API函数主要可分为几类:单个字符的显示、换行、字符串的普通显示、矩形框内的字符串显示。附加的功能是设计显示对齐方式、文本样式。

3.1.3   文本模式的选择

1.   支持四种文本模式

l  GUI_TEXTMODE_NORMAL:普通文本模式,写入文本将覆盖原有LCD上的点;

l  GUI_TEXTMODE_REVERSE:反转模式,显示的文本颜色将反转;前景色与背景色反转;

注:这个暂不清楚功能如何。

l  GUI_TEXTMODE_TRANS:透明模式,写入文本将在原有的图形顶层显示;

l  GUI_TEXTMODE_XOR:异或模式。

注:这个暂不清楚功能如何。

2.   文本模式相关API

l  int GUI_GetTextMode(void):获取显示的文本模式;

l  int GUI_SetTextMode(int TextMode):设置显示的文本模式;

l  char GUI_SetTextStyle(char Style):设置显示的文本样式,主要样式有:

n  GUI_TS_NORMAL;

n  GUI_TS_UNDERLINE;

n  GUI_TS_STRIKETHRU;

n  GUI_TS_OVERLINE。

注:文本样式,有意思!

3.1.4   文本对齐方式:

l  int GUI_GetTextAlign(void):获取文本对齐方式;

l  int GUI_SetTextAlign(int TextAlign):设置文本的对齐方式;主要对齐方式:

n  GUI_TA_LEFT-GUI_TA_HCENTER-GUI_TA_RIGHT;

n  GUI_TA_TOP-GUI_TA_VCENTER-GUI_TA_BOTTOM。

l  void GUI_SetLBorder(int x):设置显示的左边距。

注:这个应该是设置了变量,然后在调用显示函数时使用。对齐方式应该是用于显示函数参数包含指定坐标的函数,如GUI_DispStringAt()。相应的坐标指定显示对齐用的基准坐标。见程序清单3.1中的左对齐与居中对齐效果。

3.1.5   当前文本位置:

每个任务都对应着一个文本位置,位置相对于窗口的(0,0)坐标而言。用于决定输出文本的当前位置。

l  char GUI_GotoXY(int x, int y);

l  char GUI_GotoX(int x);

l  char GUI_GotoY(int y);

l  int GUI_GetDispPosX(void);

l  int GUI_GetDispPosY(void)。

注:我觉得这里的文本显示位置应该是相对于的活动窗口而言,不是相对于整个液晶屏。当输入一个字符时,显示的起始位置对应于字模图像的左上角的坐标。

3.1.6   窗口的完全与部分清除

l  void GUI_Clear(void):清除当前窗口。如果没有指定当前窗口,则清除整个屏幕;

l  void GUI_DispCEOL(void):从当前窗口的当前位置以当前字体的高度清除文本至当前行行尾。

程序清单3.1文本显示测试程序

 

#include "gui.h"

 

void         MainTask( void )

{

                GUI_RECT rect = { 0, 50, 10, 250 };

 

                GUI_Init();             

                GUI_DispChars( 'C', 20 );                      /* 显示20个字符C                                               */

                GUI_DispNextLine();                                             /* 换行                                                    */

                GUI_DispChars( 'D', 10 );                      /* 显示10个字符D                                              */

 

                GUI_DispString( "Hello, uc/GUI\n" );

                GUI_DispStringLen("Hello,uc/GUI\n", 7 );           /* 显示指定长度的字符                        */

 

                GUI_DispStringHCenterAt( "Hello,uc/GUI!", 0, 0 ); /* 文本居中位置显示                       */

                GUI_SetTextStyle( GUI_TS_UNDERLINE | GUI_TS_OVERLINE );/* 设置文本样式   */

                GUI_DispStringInRect( "Hello,uc/GUI!", &rect, GUI_TA_HCENTER );

 

                /* ------------------------ 文本串显示------------------------------ */

                GUI_SetTextAlign( GUI_TA_HCENTER );                         /* 居中对齐                            */

                GUI_DispStringAt( "GUI_TA_HCENTER!!!", 10, 100 );

 

                GUI_SetTextAlign( GUI_TA_LEFT );                  /* 左对齐                                                */

                GUI_DispStringAt( "GUI_TA_LEFT!!!", 0, 200 );             

 

                GUI_SetColor(GUI_RED);

                GUI_DrawLine(80, 10, 240, 90);

                GUI_DrawLine(80, 90, 240, 10);

                GUI_SetBkColor(GUI_BLACK);

                GUI_SetColor(GUI_RED);

                GUI_SetTextMode(GUI_TM_NORMAL);                           /* 普通显示                            */

                GUI_DispStringHCenterAt("GUI_TM_NORMAL" , 160, 10);

                GUI_SetTextMode(GUI_TM_REV);

                GUI_DispStringHCenterAt("GUI_TM_REV" , 160, 26);

                GUI_SetTextMode(GUI_TM_TRANS);                               /* 透明显示                            */

                GUI_DispStringHCenterAt("GUI_TM_TRANS" , 160, 42);

                GUI_SetTextMode(GUI_TM_XOR);

                GUI_DispStringHCenterAt("GUI_TM_XOR" , 160, 58);

                GUI_SetTextMode(GUI_TM_TRANS | GUI_TM_REV);

                GUI_DispStringHCenterAt("GUI_TM_TRANS | GUI_TM_REV", 160, 74);   

                while( 1 )

                {

                                GUI_Delay( 100 );

                }

}

3.2      数值显示API

3.2.1   十进制数显示支持

l  void GUI_DispDec(I32 v, U8 Len):显示十进制数,最大长度为9;如果数为负数,则显示时会添加负号。若实际的长度小于Len,则显示时将填0被充;

l  void GUI_DispDecAt(I32 v, I16P x, I16P y, U8 Len):在指定位置显示十进制数,同GUI_DispDec();

l  void GUI_DispDecMin(I32 v); 以最小长度的串显示一个十进制数;

l  void GUI_DispDecShift(I32 v, U8 Len, U8 Shift):指定从右边起有多少位表示小数部分。Len指定显示的串的长度;

l  void DispDecSpace(I32 v, U8 MaxDigits);

l  void GUI_DispSDec(I32 v, U8 Len):显示有符号十进制数;同GUI_DispDec(),但是总是包含+/-符号;

l  void GUI_DispSDecShift(I32 v, U8 Len, U8 Shift)。

注:如果需要指定len,若len较长,则显示将以空格或字符0补空;如len较小,则显示可能会出现不正确。使用GUI_DispDecMin()自动决定显示多长。Shift用于移位,本来是显示整数的,但现在可显示小数。最大支持显示9个字符长度。支持正负号显示。

3.2.2   浮点数显示支持:

l  void GUI_DispFloat(float v, char Len):显示符点数,小数点符号计入显示的符号数;

l  void GUI_DispFloatFix (float v, char Len, char Decs):显示浮点数,len-总长;Decs小数部分的位数;

l  void GUI_DispFloatMin(float f, char Fract):如果Fract值为负,则添加负号。Fract显示最少用的字符长度,并不是必需,实际显示时会根据需要选择最小值;

l  void GUI_DispSFloatFix(float v, char Len, char Decs):

l  void GUI_DispSFloatMin(float f, char Fract);指定显示的小数部分位数;总是在显示值前面显示+/-符号。

注:部分同上。但显示时是在后面补0。

3.2.3   二进制数显示支持:

l  void GUI_DispBin(U32 v, U8 Len):

l  void DispBinAt(U32 v, I16P y, I16P x, U8 Len)。

3.2.4   十六进制数显示支持

l  void GUI_DispHex(U32 v, U8 Len):

l  void GUI_DispHexAt(U32 v, I16P x, I16P y, U8 Len)。

注:没有附加的“0x”字符串显示,且不支持正负符号显示。

3.2.5   测试程序

程序清单3.2  数值显示测试程序

#include "gui.h"

 

void    MainTask( void )

{

    GUI_RECT rect = { 0, 50, 10, 250 };

 

    GUI_Init();

   

    /* ---------- 十进制显示支持 ---------------*/

    GUI_DispString("Disp Dec:\n");

    GUI_DispDec( -32, 9 );              /* 显示负号,以零补空  */

    GUI_DispNextLine();

    GUI_DispDec( 56, 9 );               /* 不显正号,以零补空  */

    GUI_DispNextLine();

    GUI_DispDec( 51, 1 );               /* 不显正号,以零补空  */

    GUI_DispNextLine();

 

    GUI_DispDecMin( -32 );              /* 最小数量显示        */

    GUI_DispNextLine();

    GUI_DispDecMin( 54 );          

    GUI_DispNextLine();

 

    GUI_DispDecShift( -3212, 8, 1 );      /* 1位小数             */

    GUI_DispNextLine();

    GUI_DispDecShift( -3212, 8, 2 );      /* 2位小数             */

    GUI_DispNextLine();

 

    GUI_DispDecSpace( -3212, 9 );       /* 以空格补空          */

 

    /* ---------- 浮点数显示支持 ---------------*/

    GUI_DispNextLine();

    GUI_DispFloat( -3.1232, 9 );        /* 普通浮点显示支持     */

    GUI_DispNextLine();

    GUI_DispFloatFix( -3.14159, 9, 2 );  /* 最大9个字符,2个小数部分*/

    GUI_DispNextLine();

 

    /* ---------- 二进制数显示支持 ---------------*/

    GUI_DispBin( 0xfe, 8 );

    GUI_DispNextLine();

 

    /* ---------- 十六进制数显示支持 ---------------*/

    GUI_DispHex( 0xfe, 4 );

    GUI_DispNextLine();

 

    while( 1 )

    {

        GUI_Delay( 100 );

    }

}

 

By:lstzixing

Mail:blievethink@gmail.com

Blog:http://blog.ednchina.com/lstzixing

2010-5-7

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
显示iOS所有可用字体和颜色
运行时获取类的所有方法,找到获取颜色的方法并记录下来 源码地址
529 0
前端学习 -- Xhtml语法规范
Xhtml语法规范 HTML中不区分大小写,但是尽量使用小写; HTML的注释不能嵌套; 标签必须结构完整{要么成对出现,要么自结束标签,虽然浏览器会帮我们修正一些不符合规范的内容} 标签可以嵌套但是不能交叉嵌套 属性必须有值,且值必须加引号,单引号双引号都可以
690 0
MYSQL时间显示(与ORACLE的区别)
MYSQL和ORACLE的日期字段的数学运算公式有很大的不同   MYSQL找到离当前时间7天用 DATE_FIELD_NAME > SUBDATE(NOW(),INTERVAL 7 DAY); ORACLE找到离当前时间7天用 DATE_FIELD_NAME >SYSDATE - 7;   MYSQL中插入当前时间的几个函数是: NOW()函数以`'YYYY-MM
974 0
笔记本外接显示器,同时使用双显示器
      基本上只要做上面两个地方的设置就行了、、
557 0
用CSS来改变网页鼠标显示样式的方法
一般而言,鼠标以斜向上的箭头显示,移到文本上时变为有头的竖线,移到超级链接上变为手型。但用css可控制鼠标的显示效果,如可使鼠标移到普通文本上也显示成手型。 用css控制的语法如下: 文本或其它页面元素 把 * 换成如下15个效果的一种: hand、crosshair、text、wait、default、help、e-resize、ne-resize、n-resize、nw-resize、w-resize、sw-resize、s-resize、se-resize和auto。
670 0
Docker有关GUI软件的界面显示设计
欢迎关注大数据和人工智能技术文章发布的微信公众号:清研学堂,在这里你可以学到夜白(作者笔名)精心整理的笔记,让我们每天进步一点点,让优秀成为一种习惯! 有幸得到大神的邮件回复,今天突然发觉,大神应该是在自己的mac上通过ssh访问了一台OS为Ubuntu的的机器或者电脑,其中Ubuntu安装了Docker,Docker运行某个软件或者程序,然后将可视化的界面返回了mac上。
1358 0
AliOS Things 3.0应用笔记:摄像头配网 + 钉钉群通知 + 天气显示
AliOS Things 3.0应用笔记:摄像头配网 + 钉钉群通知 + LCD天气显示
2584 0
+关注
702
文章
0
问答
文章排行榜
最热
最新
相关电子书
更多
《2021云上架构与运维峰会演讲合集》
立即下载
《零基础CSS入门教程》
立即下载
《零基础HTML入门教程》
立即下载