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

STM32 TouchGFX经验分享(五)

[复制链接]
STMCU小助手 发布时间:2023-3-5 12:09
Graph控件是用于实现图表以及需要绘制图像的控件,该控件在TouchGFX Designer中没有体现,但是可以在工程中自行添加,TouchGFX官方给的Demo中有针对于该部分的Demo,这些Demo可以给大家些帮助,下面针对于该控件给大家详细的介绍下。' _$ z  J. ^! d" V+ l
CanvasWidget
9 s6 B/ p3 c5 Y, m+ GCanvas Widgets和Canvas Widget Renderer是TouchGFX的功能强大且用途广泛的附加组件,它使用相对较少的内存就可以提供流畅,抗锯齿的几何形状图形,同时保持了高性能。但是,渲染几何形状必须被视为相当昂贵的操作,并且如果不小心使用,很容易使微控制器资源紧张。
/ d/ O0 E! U& E5 L8 T/ W# @9 \0 @( i; H2 v- M
Canvas Widget Renderer(以下称为CWR)是一种通用的图形API,可为图元提供优化的图形,并自动消除大多数多余的图形。TouchGFX使用CWR绘制复杂的几何形状。几何形状由“画布小部件”定义。TouchGFX随附了许多受支持的Canvas Widget,但就像普通的Widget一样,您可以制作自己的自定义Canvas Widget来满足您的需求。当Canvas Widget定义要由CWR绘制的图形的几何形状时,图形内每个像素的实际颜色由关联的Painter类定义。同样,TouchGFX附带了许多Painter,但是您可以根据自己的需要制作自己的自定义Painter。
8 t; q0 ]" l: l7 t1 i0 t/ s% s* x: Q

# S/ {, h: t8 Z* j& B$ ~TouchGFX中的其他小部件的大小会自动设置。例如,位图小部件将自动获取所包含位图的宽度和高度。因此,足以setXY()在位图小部件上使用以将位图放置在显示器上。! i: d) k2 @3 {( P" S
画布小部件没有默认大小,该默认大小可以自动确定并进行初始设置。必须不仅要注意位置,而且还要正确调整窗口小部件的大小,否则“画布”窗口小部件的宽度和高度将为零,并且在显示器上不会绘制任何内容。1 L+ Y1 @" \4 q9 S' q5 ~0 ?% a/ N# f

) W" f0 D% |9 W! }! \; G因此,不要setXY()使用setPosition()来放置和调整画布小部件的大小,而要使用。另请参阅下面的“自定义画布小部件”,以获取有关如何创建和使用自定义画布小部件的示例。2 F) @1 Z9 p* k
# o6 T! s% Y2 C0 b8 r6 B0 t3 U7 X6 p$ q
设置画布小部件的位置和大小后,便可以在其中绘制几何形状。坐标系将在小部件(而不是显示)的左上角具有(0,0),X轴向右延伸,Y轴向下延伸。
1 ^6 E& U. ^  z3 |. A& L1 y+ G* a" x9 O  }0 N- a  D* u. u/ \
Canvas窗口小部件在TouchGFX Designer中也受支持,它使用法简单并具有自动内存分配功能。
6 V  t& U0 h/ @( b, D" E1 p' e# O6 {$ _! C* R, }+ Y8 i5 |, J' ~" z
) n4 J/ v2 d; I2 E# w( H; Y' ?( i
CanvasWidget内存分配
0 C# C, a2 o/ B1 VTouchGFX Designer中的内存分配' u6 n8 J; W; e6 _- F  t2 V
将小部件添加到屏幕的画布时,会自动生成一个内存缓冲区。缓冲区的大小基于具有以下公式的屏幕宽度(Width × 3)× 5。但是,这并非总是适用于所有情况的理想缓冲区大小。因此,可以覆盖缓冲区大小,如下图所示。
& L; _; ]* j, Z/ V+ o: m
; C9 [9 d/ ?' ]8 g& o
20200628131939213.png ) u) P* C/ Q' s% o& t4 J

0 X; @# T; x( `1 x" Q% G用户代码中的内存分配

9 t8 H7 l0 I" K: B+ ]1 s! R内存可被分配和设置在target/main.cpp与simulator/main.cpp或可以设置和每画面分配。
* g4 y3 R/ B1 q/ M1 l
  1. static const uint16_t CANVAS_BUFFER_SIZE = 3600;
    ' L; L( u, b6 O, E7 K: t
  2. static uint8_t canvasBuffer[CANVAS_BUFFER_SIZE]* t$ a2 c7 l1 v$ c8 J. Q: D
复制代码
' F3 K0 V2 |2 t
定义内存缓冲区大小的静态const,可以在main.cpp或的开头定义实际的内存缓冲区ScreenView.hpp  K* x1 r0 f0 F; v) p
然后,在任一main()的方法main.cpp或setupScreen()方法ScreenView.cpp中的以下行建立缓冲区可以被添加。( w, Y4 N. o+ I' s  x% J
  1. CanvasWidgetRenderer :: setupBuffer (canvasBuffer ,CANVAS_BUFFER_SIZE );
    " W6 n% z% B4 }& N
复制代码

: ~, ~: t# r, L所需的CWR内存量取决于应用程序中要绘制的形状的最大大小。但是,您可以保留少于最大形状所需的内存。为了处理这种情况,CWR将形状的图纸分成较小的帧缓冲区部分,从而导致稍长的渲染时间,因为在这种情况下,有时不得不多次渲染形状。在模拟器模式下运行时,可以更仔细地调查和微调内存消耗。只需将以下函数调用添加到main.cpp中:
3 N+ Z% D: q! l' Q4 i5 S! G1 E, n
  1. CanvasWidgetRenderer :: setWriteMemoryUsageReport (true );8 K5 c/ S1 V# A8 \" `
复制代码
! u$ h( D' g2 n; B/ [
现在,每当绘制操作完成时,CWR都会报告(在控制台中打印)需要多少内存。对于canvas_widget_example,它可能是“ CWR需要3604字节”(对于第一次绘制操作),然后是“ CWR需要7932字节(缺少4328个字节)”(对于第二次绘制操作)。即使CWR似乎没有足够的内存(在这种情况下,缺少4328字节),应用程序也可以正常运行。这是因为CWR检测到可用内存太少,无法在一次运行中完成复杂的绘制操作。取而代之的是,它将绘制操作分为两个单独的绘制操作,形状将被绘制得很好,但需要更多时间进行渲染。
) D) A0 t' c1 t# q5 x
  G6 q( R9 _) \& K9 W4 b/ {
因此,设置正确的内存缓冲区大小需要在内存和性能(渲染时间)之间进行权衡。好的起始值通常约为3000,但是使用上述技术,通常可以确定更好的值。如果形状太复杂而分配的内存缓冲区太小,则将不会绘制形状的一部分(某些垂直像素线将被跳过),并且有可能根本没有绘制。无论如何,渲染时间都会增加很多。
1 R1 d. s" ~6 @' s! q+ p
% f2 v$ Q; _! e0 ^' u6 K: K
这意味着,如果您希望您的应用程序以最快的速度渲染CWR图形,则需要分配请求的内存量。但是,如果可以使用较慢的渲染计时器,则可以减少内存缓冲区。
% M4 I0 w; k7 O; a$ [2 s7 F5 O& E) d' s5 T2 ?, |1 @
7 r9 t0 I) b. f& S4 Y
CWR坐标系
2 A! o1 d+ j1 r2 S9 Z2 w2 ATouchGFX中的坐标系通常用于寻址像素,以在显示器上定位位图。位图,文本和其他图形元素都放置在坐标系中,其中(0,0)是左上像素,x轴向右延伸,y轴向下延伸。在CWR中,仅能够使用整数寻址像素是不够的,尽管在特殊情况下这可能就足够了,但通常这还远远不够。为了说明这一点,请考虑一个线宽为1的圆,它必须恰好适合5 x 5像素的框。该圆的中心必须位于(2.5,2.5),半径必须为2,因此中心坐标需要分数。同样,如果圆应适合于6 x 6像素的框,则中心必须位于(3,3),半径必须为2.5,因此此处半径必须为分数。( }. e, \9 x# q$ J7 r* c& t) h

3 }, g) G1 c, m这种寻址图形坐标的新方法意味着(0,0)的像素中心具有CWR坐标(0.5,0.5)。因此,包含在屏幕左上角像素的框具有以下轮廓:(0,0)->(1,0)->(1,1)->(0,1)->(0 ,0)。9 s# t& j" r) L( {8 Y% S+ m
4 J$ R1 V9 P; _3 Z
20200628132621835.png % u; k. H  Q* E2 _1 N1 l! e& v4 ?

2 a. X& {# \9 f: |/ L+ K尽管起初看起来似乎很混乱,但很快就变得很自然。当位图的坐标系统处理像素时,画布小部件的相同坐标处理像素之前和上方的间隙。
- y3 b6 \* z( s" P8 _% ^% f; n# w, J1 g+ O/ H9 r7 j
/ ]% Q$ P4 R+ I2 i, p9 z
点、线、面5 Z& ?! M4 i9 q* Q
当创建完画图的画板后就可在其中创建图像, TouchGFX的图像不支持线性的曲率变化,换句话说就是只能通过点去链接线,但是如何能做到曲率的线呢,这时我们可以通过贝塞尔算法,或者其他的曲率算法推算出每一个点的坐标,或者是相隔固定点的坐标,之后在界面上显示出来。
# O4 {) E4 F0 ^; T官方提供了两个demo 分别是TouchGFX Demo1 和TouchGFX Demo2,两个demo中都有graph绘制方法的体现,但体现的方法不同,对用CanvasWidget继承程度也不尽相同。( n0 U# Z# @+ e$ u3 q. _( ^
这里我们讲解个内容比较多的TouchGFX Demo1,我会在下一节提出代码。
" k  {, h: O8 U  ?/ P8 r
$ d7 B7 D5 G6 }

! ?& x  V5 e5 D" k  UDemo

6 P0 M# t8 ~! _% k/ q; D7 @  E首先先看一下该部分代码的调用的方法。
  M4 H+ U4 x& K, V" Q+ c5 w
  1.     primaryGraph.setXY(graphXOffset, graphYOffset);7 D; b. c$ ]/ m
  2.     primaryGraph.setup(graphWidth, graphHeight, Color::getColorFrom24BitRGB(0x24, 0x73, 0xAC), graphBackground.getColor());
    ' n  y1 U# L7 u& B9 N' o, c0 m
  3.     primaryGraph.setDotShape(0, 30, 5);//设置折线上点的参数
    : v# Y$ {3 |' P0 p
  4.     primaryGraph.setDotBackgroundShape(0, 30, 7);//设置折线上点的背景参数  C  W% K& O- L7 f  O& Z) j) W0 J" G
  5.     graphArea.add(primaryGraph);* `' W+ `/ z1 U. k
复制代码
: M' h8 _6 x6 K! a# B' [
在此可以看出graph作为一个控件调用方法是一致的,都是先设置x,y的位置,也需要设置画布的宽高,以及转向点或者其他的设置。
2 ~% E2 X7 U% f( m9 t5 W  g这里唯一的不一样的地方是setup()函数,这个函数中除了宽高外还有颜色,颜色的含义则是画笔的颜色,想要作画除了画布同样还需要画笔。至于化成什么样子则是我们掌握的,下面看下setup函数。6 B9 V7 u4 L9 y0 E1 A4 N; p0 i
  1. void Graph::setup(int newWidth, int newHeight, colortype lineColor, colortype backgroundColor)
    0 w* m3 R: l0 n5 z( X* d
  2. {
    * n) x8 x! A. O* j$ j
  3.     setWidth(newWidth);* g; J5 }7 ?1 c) A& Q
  4.     setHeight(newHeight);
    9 W1 x* G& a9 Y4 H2 p2 G9 m. P
  5. # K  i+ z' c$ f0 a% R' t. u& u# g
  6.     graphLinePainter.setColor(lineColor);+ Z8 b! N; t; ~; k2 N' c
  7.     graphAreaPainter.setColor(lineColor, 255);& w* @' N% J( g# G6 H! r
  8.     graphDotsPainter.setColor(lineColor);4 j: r9 [- P! ]  c2 Y, c( ^
  9.     graphDotsBackgroundPainter.setColor(backgroundColor);
    + d- T2 o1 j2 ~4 `! h
  10. & e8 E; i. ~5 C* x8 C) a
  11.     graphLine.setLinkedGraph(graphArea);5 V. {+ ~, A! E% p: I. v/ g
  12.     graphLine.setLinkedGraph(graphDots);
    * s) L8 w. B: q& n4 T5 C0 S
  13.     graphLine.setLinkedGraph(graphDotsBackground);
    " R1 {, I6 G, _4 u$ g

  14. 6 b' p0 K9 d6 X( U7 n5 {8 t7 t
  15.     graphLine.setPosition(0, 0, getWidth(), getHeight());
    . {; h& V# w1 A
  16.     graphLine.setPainter(graphLinePainter);
    4 ?' U3 S% W) m# i, n# M1 ~9 J
  17.     graphLine.setBuffer(graphBuffer, NUMBER_OF_POINTS);- X9 d3 N* J& c5 H
  18.     graphLine.setLineWidth(1);
    2 v$ N1 h5 v* Q6 ]
  19.     graphLine.setRange(-2, 216, 400, 0);
    ; \! ~. L* p) z! ^' ^

  20. ) Q/ ]4 ^3 Q4 A. Z. Y
  21.     graphArea.setPainter(graphAreaPainter);! z! a# O7 U; b# y% c
  22.     graphArea.setLineWidth(0);
    4 s6 t0 }2 q6 v+ R

  23. % B- n8 z7 M, l0 A
  24.     graphDots.setPainter(graphDotsPainter);* P+ _# Y& V/ X+ m
  25.     graphDots.setLineWidth(7);
    ' D7 A* h" i$ s5 {
  26.     graphDots.setDotShape(0, 90);
      \. g2 G2 n5 m: x" W" c
  27. 6 Y, W( B) p8 r* X' v
  28.     graphDotsBackground.setPainter(graphDotsBackgroundPainter);
    1 ^6 Q# c: u( E
  29.     graphDotsBackground.setLineWidth(9);
    : O: {' \) Y1 V
  30.     graphDots.setDotShape(0, 30);
    " ~2 `  ?$ W( q1 O; s9 t. C; U

  31. 7 j  w! f1 e: h* U7 ?
  32.     add(graphArea);, t% A3 j1 B1 e/ R; n
  33.     add(graphLine);/ L7 T  B! l- i! T! g  O0 Z( T
  34.     add(graphDotsBackground);
    % n* |* ?4 s( t8 _( Q
  35.     add(graphDots);5 J3 F3 F9 t* U( g% ?3 c
  36. }
    ( Z+ m) W  H2 f; Z* k$ }
复制代码
% v/ L& A5 n# T4 {5 ]) u
可以看出,整体采用的画笔以及将其画布放置在一起的过程。/ Y* X% G  ]8 R' V, }9 ~4 U
除此之外还有些细节的这里不将展示。需要可以参考官方的代码,我将具体的部分放到这里供大家快速定位。
9 N+ c' J6 H+ p+ e$ |
& R: G( z$ R% p' P, I4 U) A
20200628134829920.png
, ~! ]* O  @$ S3 r) Z. j

: K1 U1 v% i( Y$ B8 i6 @. w3 A  f; FGraphView.cpp中放的是使用方法,文件夹graph_widget文件夹中放的是控件的源码,大家可以根据需要自己研究下该控件。
4 X( D2 E( B6 c2 k6 D
( a) |  S6 m0 |8 c' j2 d' K

: ]! V7 `# L- i/ @4 V# a- |注意
6 x/ z3 z2 X' r+ u本人在开发该部分控件时,会弹出buffer空间不足的提示框,原因则是在新建的工程中未添加画布空间的buffer,所以才会报错,具体请参照本章内容。) d( n9 ]" @. k3 d
————————————————9 J* \4 f: P! |/ d: {# T! s
版权声明:空闲的程序员
8 _3 r  ?1 p3 ]' I) ]$ o1 p* w. {( N% z4 d$ y

9 ]# F# {. `- q2 v5 R7 A/ J* i
赞 收藏 评论0 发布时间:2023-3-5 12:09

举报

0个回答

所属标签

相似技术帖

关于
我们是谁
投资者关系
意法半导体可持续发展举措
创新与技术
意法半导体官网
联系我们
联系ST分支机构
寻找销售人员和分销渠道
社区
媒体中心
活动与培训
隐私策略
隐私策略
Cookies管理
行使您的权利
官方最新发布
人形机器人运动控制、感知与智能配电
半导体创新技术与应用方向
EE架构与软件定义汽车
12V/48V 汽车智能配电(SPD)
区域控制单元(ZCU)与分区架构
关注我们
st-img 微信公众号
st-img 手机版