你的浏览器版本过低,可能导致网站不能正常访问!
为了你能正常使用网站功能,请使用这些浏览器。

【安富莱STemWin教程】第6章 STemWin文本显示

[复制链接]
baiyongbin2009 发布时间:2015-1-10 13:40
本帖最后由 baiyongbin2009 于 2015-1-10 13:42 编辑 1 x# r# y0 o. l6 w& Q+ f
: W7 D. J1 Q+ X4 }6 M) q

特别说明:完整STemWin的1-60期教程和配套实例下载地址:链接

第6章      STemWin文本显示
# b8 Z) t2 V- ^3 o- S; \# w
      本期主要讲文本的显示,整体来说比较的简单,但很适合初学者看,有些文本函数在使用上要特别注意,教程中会给大家详细的讲解。
    6. 1  简单文本显示
    6. 2  文本绘制模式
    6. 3  GUI_DispStringInRectWrap函数的使用
    6. 4  开发板上面实现自动换行的例子
    6. 5  总结
- l9 [5 E2 Z8 I6 f) d
6.1  简单文本显示
    讲解简单的文本显示前得说下控制字符,因为在使用STemwin来做一个文本阅读器时,了解这个很重要。控制字符是指字符代码小于32的字符。控制字符被定义为ASCII代码的一部分。emWin忽略了下表所列字符以外的所有控制字符:
字符代码
ASCII码
C
描述
10
  
LF
  
  
\n
  
  
换行。
  
当前文本位置改变至下一行的开始。默认为:X  = 0。
  
Y + =字体-距离 (单位:像素)(如例程GUI_GetFontDistY()计算得出)
  
13
CR
\r
回车。
  
当前文本位置改变至当前行的开始。默认为:X = 0。
    控制字符LF的用法在字符串中非常方便。换行符可以作为字符串的一部分,这样,字符串就可以拆分为多行,且只需调用一个例程就能显示。
    下面在emWin5.24的模拟器上面实现一下,下面的这个程序,主要是通过\n实现换行,模拟器的使用方法,看前面几期就会了。
  1. void MainTask(void)7 M6 C, [/ N  Q) U. J, J; Y3 H$ E
  2. { : O9 Y- I' p2 |9 m: c9 _- ?: v6 c% r
  3.      GUI_Init();(1)1 [. C! l8 Z' T7 m6 u. b% r
  4.      /*  对于初学者,这个地方一定要注意,这里只是设置背景颜色,也就是给变量赋值了一下  */
    9 M; @- ?) Z3 D' f) ~& _8 b. a- e  `
  5.      GUI_SetBkColor(GUI_BLUE);3 S% i  B( k; B  f' }
  6.      /* 要实现背景颜色的改变,必须的执行下面这句 */ ; e6 X0 O5 S. g& c( t. z
  7.      GUI_Clear();
    1 p& w1 S3 \  k% b$ h$ Z
  8.      GUI_SetFont(&GUI_Font8x16);
    ' V  P  E4 i2 b, W* f
  9.      /* 这里调用字符串显示  并实现一下换行  */" E& I7 h, X( g+ [4 M0 i
  10.      GUI_DispString("www.armfly.com \navailable");
    7 {/ w% G# _! g3 ~
  11.     & t, P" B0 J% Q
  12.      while (1)+ H8 y- N4 y5 p: n- O
  13.      {     ) n+ {$ o$ w$ A5 [, V
  14.          GUI_Delay(1000);(2)
      ^. ~: v3 F0 v0 [# u) _5 h
  15.      }
    2 K& X+ v' x' q+ j& k# m
  16. }
复制代码
1.    使用STemWin函数前,初始化一定要有。
2.    这里不仅仅是个延迟函数,窗口的刷新等功能最终是由这个函数实现的。
       实际显示效果如下:
6.1.png

, W. v8 v5 o; V& c& i
函数GUI_DispStringAt()
        GUI_DispStringHCenterAt()
        GUI_DispStringInRect() 平时使用的也比较多,有兴趣的可以在模拟器上面练练手。
6.2  文本绘制模式
    通常,在所选窗口的当前文本位置,使用所选字体以正常文本模式写入文本。正常文本模式意思是指文本覆盖已经显示的任何内容,在这种情况下,字符掩码中设定的位元在屏幕上被设定。在这种模式下,活动位元使用前景颜色写入,而非活动位元用背景颜色写入。但在某些情况下,需要更改这种默认模式。STemWin为此提供了四种可以组合使用的标记 (一种默认加三种修改标记):
正常文本
    通过指定GUI_TEXTMODE_NORMAL或0,可以正常显示文本。
反转文本
    通过指定GUI_TEXTMODE_REV,可以反转显示文本。通常的黑底白字显示方式将变为白底黑字显示。
透明文本
    通过指定GUI_TEXTMODE_TRANS,可以显示为透明文本。透明文本表示文本写在屏幕上已经可见的内容之上。不同之处在于,屏幕上原有的内容仍然可见,而在正常文本中,背景会替换为当前选择的背景色。
异或文本
    通过指定GUI_TEXTMODE_XOR,可以使用异或模式显示文本。通常情况下,用白色绘制的 (实际字符)显示是反相的。如果背景色是黑色,效果与默认模式(正常文本)是一样的。如果背景是白色,输出与转文本一样。如果使用彩色,反相的像素由下式计算:
        新像素颜色=颜色的值–实际像素颜色–1。
透明反转文本
    通过指定GUI_TEXTMODE_TRANS | GUI_TEXTMODE_REV,可以显示为透明反转文本。与透明文本一样,它不会覆盖背景,而且和反转文本一样,该文本会反转显示。其他信息请注意,还可以使用缩写形式:例如,GUI_TM_NORMAL。
  1. void MainTask(void)& E0 Q6 T; Q. K5 G4 U' c6 n4 u
  2. {   
    ) t; J0 X' [; \7 V/ }
  3.      GUI_Init();
    4 c% U* E$ e6 Y9 x' a' r
  4.      /* 设置字体 */   7 J, B1 t+ y  }( Z6 A7 d
  5.      GUI_SetFont(&GUI_Font8x16);$ y3 a! o. p& v7 s( ?: H
  6.      /* 设置背景颜色 */   7 M5 u* i2 B" m3 G
  7.      GUI_SetBkColor(GUI_BLUE);
    ! y5 ]7 s+ ^2 s, [- F
  8.      GUI_Clear();      
    9 A  ^+ x  x1 Y' A- p
  9.      /* 设置画笔的粗细以及颜色,只有矢量函数才能设置Size */
    ( \% V' |3 m) h: P) P& n
  10.      GUI_SetPenSize(10);   ( h/ B) t+ m$ \( A+ G5 K+ L/ E. b7 \
  11.      GUI_SetColor(GUI_RED);0 h& L/ A3 \% h5 |! R) i+ T
  12.      GUI_DrawLine(80, 10, 240, 90);   # @9 A) t) }- ~) j' w
  13.      GUI_DrawLine(80, 90, 240, 10);
    0 P. I1 r  F0 G3 Y# A
  14.      GUI_SetBkColor(GUI_BLACK);  p' N- Q3 ]1 g
  15.      GUI_SetColor(GUI_WHITE);      
    9 [% {6 y' J, U7 v0 N2 _
  16.      /* 设置正常模式 */
    " k/ m+ B1 L( J2 S
  17.      GUI_SetTextMode(GUI_TM_NORMAL);  
    5 A; D4 N, k+ A* ^9 T( c
  18.      GUI_DispStringHCenterAt("GUI_TM_NORMAL" , 160, 10);
    * E) T& ]5 t' J  y
  19.      /* 翻转文本 */   
    * z* `. N3 f/ l3 {0 m
  20.      GUI_SetTextMode(GUI_TM_REV);. ^: N* z* I4 l- u0 ^- V
  21.      GUI_DispStringHCenterAt("GUI_TM_REV" , 160, 26);        
    # j" B) c7 l# ~! I
  22.      /* 透明文本 */! H- E! |' Z6 H6 a- [( C3 o
  23.      GUI_SetTextMode(GUI_TM_TRANS);   ; E( A& V& x: E. S6 y- b
  24.      GUI_DispStringHCenterAt("GUI_TM_TRANS" , 160, 42);& G& s( C0 S$ _- {0 ?3 X8 f, x  l
  25.      /* 异或文本 */   
    5 w) m. k$ {, w+ j& J1 c2 J* y
  26.      GUI_SetTextMode(GUI_TM_XOR);. ~. c7 Z3 P" W# b4 a7 @( A
  27.      GUI_DispStringHCenterAt("GUI_TM_XOR" , 160, 58);    ' @9 L+ M1 V" U* Q* [  a
  28.      /* 设置文本模式 */  k8 g2 l: }2 |( e$ K9 H* C
  29.      GUI_SetTextMode(GUI_TM_TRANS | GUI_TM_REV);   
      y- k* L/ o( U& D8 h  g2 h" D; q
  30.      GUI_DispStringHCenterAt("GUI_TM_TRANS | GUI_TM_REV", 160, 74);5 ~' ]6 w# g# ~$ Z) s4 d
  31.      while (1)   4 a( F0 y) W1 k: r. H  [
  32.      {
    & J1 B% p9 S1 u# j2 Z4 Y% K  N
  33.          GUI_Delay(1000);   ; C# B4 k+ d$ t. p
  34.      }/ H9 T% T; A3 _) M% B
  35. }
复制代码
    实际显示效果如下:
6.2.png
: y3 L5 i; ^: Q0 X5 c
    关于文本设置方面还有一个函数这个里面还有一个函数GUI_SetTextStyle(),有兴趣的可以试试。
6.3.png
4 @, C  V, c& u/ c1 Q
6.3  GUI_DispStringInRectWrap函数的使用
    先贴一下官方的使用说明
6.4.png
" G8 J: _* N5 N" y* A
    下面这个例子非常的好,很好的说明了三种模式的区别
  1. #include "GUI.h"3 u! |2 o  y& ]  @3 w  m$ H
  2. 6 R% z+ Z2 `, m/ v8 K
  3. int i;
    . A1 _3 X" _, v8 `, k: {
  4. char acText[] = "This example demonstrates text wrapping";( b5 M$ r1 ~/ [0 Y- ]% m0 w+ ]5 b
  5. GUI_RECT Rect = {10, 10, 59, 59};7 ~' ?% u! Y9 Y/ E. ^* ?
  6. GUI_WRAPMODE aWm[] = {GUI_WRAPMODE_NONE,/ e3 M4 f" I; {5 k
  7.                       GUI_WRAPMODE_CHAR,
    & M. S6 |) B- a; P: w- m8 _
  8.                       GUI_WRAPMODE_WORD};
    3 |/ a9 B% P6 X8 M
  9. void MainTask(void); Y* M- L" v3 c* [! G+ U; X" o
  10. {$ }: w' r& h& C; G( g, P- d/ E  p
  11.     GUI_Init();
    $ \! S% l0 M- F6 g. g
  12.     GUI_SetTextMode(GUI_TM_TRANS);; W! T7 H4 {/ Y$ r& l7 Z
  13.     for (i = 0; i < 3; i++)
    # @2 P1 f& N! D  c* T: Z: X: U
  14.     {: `$ s. |0 |# g' |& c  W' P. v! Q
  15.         GUI_SetColor(GUI_BLUE);8 `# f/ S! L3 o+ V- Q
  16.         GUI_FillRectEx(&Rect);7 V& @. o$ f( G' c
  17.         GUI_SetColor(GUI_WHITE);# q  z( n: N# T8 @/ q$ b
  18.         GUI_DispStringInRectWrap(acText, &Rect, GUI_TA_LEFT, aWm[i]);
    * K$ I$ F  [' I4 |- g0 E
  19.         Rect.x0 += 60;* Q: k: D2 S% r7 D( V7 e( t8 F
  20.         Rect.x1 += 60;$ ]2 L3 a  T1 H2 f/ t* m
  21.     }- U" i9 ^# ?5 R) ~
  22.     while (1)% K8 G0 _9 f" v& j# g7 t
  23.     {
    ! r$ P2 q6 t, G0 }3 M3 d$ N5 o6 t
  24.         GUI_Delay(10);3 G0 U; m2 Q6 \' k8 c! K
  25.     }
    % |. N( l4 D! q& \! D) L3 P4 @
  26. }
复制代码
    实际显示效果如下:
6.5.png
/ r3 G2 Z8 h  O5 m2 t# A/ y
+ z5 @, Y$ C/ u! N. ~. l; D
- G! Z* T7 n  b9 y6 O

- D- n0 E7 S( y* L4 C; j. j' f
赞 收藏 评论1 发布时间:2015-1-10 13:40

举报

1个回答
baiyongbin2009 回答时间:2015-1-10 13:40:50
6.4  开发板上实现自动换行的例子
    下面是在开发板上面实现的自动换行例子:
  1. #include "GUI.h"
    0 A, R! M! v) V2 }  Q" o

  2. ! j& M" O5 b2 ^9 }0 p* w  Z! O# X6 B. P
  3. int i;
    * Z0 V. @9 b6 v; y1 F
  4. char acText[] = "www.armfly.com www.armfly.taobao.com Eric2013";
    * e2 E# D1 Q6 H+ v+ e( c. D
  5. GUI_RECT Rect = {10, 10, 59, 59};
    & A; A! M3 n/ D" W7 D! H) }
  6. GUI_WRAPMODE aWm[] = {GUI_WRAPMODE_NONE,
    , R! T; i% v8 o$ A0 D. [; S
  7. GUI_WRAPMODE_CHAR,
    1 ?) D) a" ^( ^7 f( ]" `
  8. GUI_WRAPMODE_WORD};/ b. o2 T: I9 J, f: [2 i
  9. /*
    , K: Z; I% x) {7 ]! `  Y. [
  10. *********************************************************************************************************
    . k5 P( G& W. W+ s! H- W# M
  11. * 函 数 名: MainTask
    ! V. e! d6 u! ^! V8 G
  12. * 功能说明: GUI主函数
    / W  {3 _+ }/ b: }! w2 D  M/ P
  13. * 形 参:无
    % J* }$ }0 g- D9 A$ D" D6 n3 N
  14. * 返 回 值: 无
    6 f( N/ [5 x0 P$ X  k3 O( J! |( q
  15. *********************************************************************************************************( A% B+ n% O7 m3 e
  16. */* K4 Y: s; z  U) O3 r
  17. void MainTask(void)0 r+ L2 P/ D& f: X8 j/ h
  18. {
    ; F7 Q. E* |( X  ?
  19. GUI_Init();7 a9 G) x$ G8 V) I
  20. GUI_SetTextMode(GUI_TM_TRANS);9 F# f8 u& i; d3 }" b- L; _/ X4 }
  21. for (i = 0; i < 3; i++)
    * j2 W2 ~3 o/ k3 U! n* N; i
  22. {
    3 V  _5 B2 w0 D. `3 x1 e6 W
  23. GUI_SetColor(GUI_BLUE);4 n( u$ K' p% E$ G  W8 s. g; N
  24. GUI_FillRectEx(&Rect);
    ! F$ \- F3 _: A  q9 @: b  m8 d
  25. GUI_SetColor(GUI_WHITE);
    - d- s7 J! ^+ K3 P0 ]
  26. GUI_DispStringInRectWrap(acText, &Rect, GUI_TA_LEFT, aWm[i]);
    + i" G& z/ y2 @$ ?- L  i- N0 D
  27. Rect.x0 += 60;3 {' U; v4 P9 |! O
  28. Rect.x1 += 60;
    9 S  u9 N! H. d8 V8 @8 `, \
  29. }
    ; H9 v8 z, g4 z$ p
  30. while (1)
    2 z) p. P9 v! ^
  31. {# R8 b' Q8 {# c+ A; V/ Z
  32. GUI_Delay(10);* g# q- j1 _$ W7 n( U
  33. }3 m9 D" r+ H5 I, s& k5 ]9 \2 m
  34. }
复制代码
    将上面的代码复制到工程中的MainTask.c文件即可。
6.6.jpg
    实际显示效果如下:
6.7.png
6.5  总结
    文本的显示属于最基本的功能,初学者要多练练这些相关的函数,实践出真知。要不以后做一些复杂的例子,往往就是这些简单的地方出错。
4 x- u/ u6 q( q# f! c
关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版