EMWIN基础显示

注意：在使用DSP库时要在C+±—>Define地方STM32F40_41xxx,USE_STDPERIPH_DRIVER后面添加
__FPU_PRESENT = 1,__FPU_USED=1,ARM_MATH_CM4,__CC_ARM

1.文本显示
重点API函数

(1)GUI_DispChar()
在当前窗口的当前文本位置处，使用当前字体显示单个字符。
原型:xxxxvoid GUI_DispChar(U16 c);

(2)GUI_DispCharAt()
在当前窗口的指定位置处，使用当前字体显示单个字符。
所显示字符的左上角在指定的(X,Y)位置
原型 :void GUI_DispCharAt(U16 c, I16P x, I16P y);

(3)GUI_DispChars()
在当前窗口的当前文本位置处，使用当前字体按指定次数显示字符。
Cnt :重复次数(0 <= Cnt <= 32767)
原型: void GUI_DispChars(U16 c, int Cnt);

(4)void GUI_DispNextLine(void);
将光标移至下一行的开始。

(5)void GUI_DispString(const char GUI_FAR * s);
在当前窗口的当前文本位置处，使用当前字体显示作为参数的字符串。
如：GUI_DispString(“Hello world”); //Disp text

(6)void GUI_DispStringAt(const char GUI_FAR * s, int x, int y);
在当前窗口的指定位置处，使用当前字体显示作为参数的字符串。

(7)GUI_DispStringAtCEOL()
该例程使用的参数与GUI_DispStringAt()完全相同。它也执行同样的操作：在指定的位置显示所给出的字符串。但是，完成此操作后，它会调用GUI_DispCEOL()例程清除本行剩下部分内容直至行末。如果某个字符串要覆盖其他字符串，同时该字符串长度比原先的字符串要短，则使用该例程会很方便。

(8)
void GUI_DispStringHCenterAt(const char GUI_FAR * s, int x, inty);
在当前窗口的指定位置处，使用当前字体水平居中显示作为参数的字符串。

(9)
在当前窗口指定的矩形区域内的指定位置处，使用当前字体显示作为参数的字符串,如果指定的矩形区域太小，文本会被裁剪。

void GUI_DispStringInRect(const char GUI_FAR * s,
GUI_RECT *           pRect,
int                  Align);

pRect :要写入的客户端窗口矩形区域（单位：像素）
Align :
对齐标记，可以通过“OR”操作进行组合。垂直对齐和水平对齐标记应该组合使用。可用的标记有：垂直对齐：GUI_TA_TOP、GUI_TA_BOTTOM、GUI_TA_VCENTER。
水平对齐：GUI_TA_LEFT、GUI_TA_RIGHT、GUI_TA_HCENTER。

(10)
在当前窗口指定的矩形区域内的指定位置处，使用当前字体显示作为参数的字符串，并可旋转（可选）。

void GUI_DispStringInRectEx(const char *         s,
							GUI_RECT *           pRect,
							int                  TextAlign,
							int                  MaxLen,
							const GUI_ROTATION * pLCD_Api);

MaxLen:显示的最大字符数
pLCD_Api :
GUI_ROTATE_0 :不旋转文本。从左到右显示。
GUI_ROTATE_180 ：180度旋转文本。
GUI_ROTATE_CCW ：逆时针旋转文本。
GUI_ROTATE_CW：顺时针旋转文本。

2.选择文本绘制模式
通常，在所选窗口的当前文本位置，使用所选字体以正常文本模式写入文本。正常文本模式意思是指文本覆盖已经显示的任何内容，在这种情况下，字符掩码中设定的位元在屏幕上被设定。在这种模式下，活动位元使用前景颜色写入，而非活动位元用背景颜色写入。但在某些情况下，需要更改这种默认模式。

正常文本
通过指定GUI_TEXTMODE_NORMAL或0，可以正常显示文本。

反转文本
通过指定GUI_TEXTMODE_REV，可以反转显示文本。通常的黑底白字显示方式将变为白
底黑字显示。

透明文本
通过指定GUI_TEXTMODE_TRANS，可以显示为透明文本。透明文本表示文本写在屏幕上
已经可见的内容之上。不同之处在于，屏幕上原有的内容仍然可见，而在正常文本中，
背景会替换为当前选择的背景色。

异或文本

通过指定GUI_TEXTMODE_XOR，可以使用异或模式显示文本。通常情况下，用白色绘制
的（实际字符）显示是反相的。如果背景色是黑色，效果与默认模式（正常文本）是一
样的。如果背景是白色，输出与反转文本一样。如果使用彩色，反相的像素由下式计
算：新像素颜色=颜色的值–实际像素颜色–1。

透明反转文本
通过指定GUI_TEXTMODE_TRANS | GUI_TEXTMODE_REV，可以显示为透明反转文本。与
透明文本一样，它不会覆盖背景，而且和反转文本一样，该文本会反转显示。

(1)int GUI_SetTextMode(int TextMode);
按照指定的参数设置文本模式。
如：GUI_SetTextMode(GUI_TEXTMODE_REV); 设置反转文本

(2)char GUI_SetTextStyle(char Style);
按照指定的参数设置文本样式。

Style:
GUI_TS_NORMAL   显示正常文本（默认）。
GUI_TS_UNDERLINE  显示带下划线的文本。
GUI_TS_STRIKETHRU  显示带删除线的文本。
GUI_TS_OVERLINE  显示带顶线的文本。

(3)void GUI_SetLBorder(int x)
设置当前窗口换行后的左边界。
x 新的左边界

(4)int GUI_SetTextAlign(int TextAlign);
TextAlign:设置的文本对齐模式，可以是水平和垂直对齐标记的组合

3.当前文本位置
每个任务都有一个当前文本位置。该位置以窗口的原点（通常是(0,0)）为参考，如果调用文本输出例程，下一个字符就会写在该位置上。最初，该位置是(0,0)，即当前窗口的左上角。有三个函数可以用于设置当前文本位置。
设置当前文本写入位置
char GUI_GotoXY(int x, int y);
char GUI_GotoX(int x);
char GUI_GotoY(int y);

GUI_GotoXY()对当前文本位置的X和Y位置同时设置。
GUI_GotoX()仅对当前文本位置的X位置进行设置，Y位置保持不变。GUI_GotoY()仅对当前文本位置的X位置进行设置，X位置保持不变。

int GUI_GetDispPosX(void);返回当前X位置。
int GUI_GetDispPosY(void);返回当前Y位置

4.清除窗口

(1)void GUI_Clear(void);
如果没有定义窗口，则当前窗口为整个显示区。在这种情况下，整个显示区都会被清除。

(2)void GUI_DispCEOL(void);
清除当前窗口（或显示）从当前文本位置到行末的内容，高度为当前字体高度

5.显示数值

void GUI_DispDec(I32 v, U8 Len);  显示指定字符数的十进制数值
void GUI_DispDecAt(I32 v, I16P x, I16P y, U8 Len);在指定位置显示数组
void GUI_DispDecShift(I32 v, U8 Len, U8 Shift); Shift 小数点右边显示的位数显示的最大字符数为9（包括符号和小数点）
void GUI_DispSDec(I32 v, U8 Len);带符号数值


void GUI_DispFloat(float v, char Len);显示指定字符数的浮点数值


void GUI_DispBin(U32 v, U8 Len);二进制显示
void GUI_DispHex(U32 v, U8 Len);十六进制

6.2D图形库
(1) 绘制模式
NORMAL模式： 在该模式下，显示的内容将被超量绘制。

XOR模式：超量绘制时显示的内容方向将倒转
仅在活动窗口或屏幕内使用两种显示颜色时比较有用

	•emWin的部分绘制函数在此绘制模式下无法正确运行。一般而言，此					模式仅适用于一像素的画笔大小。这意味着，在XOR模式下运行时，使用GUI_DrawLine()、GUI_DrawCircle()、GUI_DrawRect()等函数之前，必须确保画笔大小设置为“1”。
	•使用大于1位/像素(bpp)的色深绘制位图时，此绘制模式则不起作用。
	•使用GUI_DrawPolyLine()等绘制函数或多次调用GUI_DrawLineTo()时，支点将进行两次倒转。其结果是这些像素依然留在背景颜色中

GUI_DRAWMODE GUI_SetDrawMode(GUI_DRAWMODE mode);
GUI_DM_NORMAL    默认：绘制点、线、区域、位图。
GUI_DM_XOR      在显示器中重写其他对象的颜色时倒转点、线、区域。

(2)设置画笔大小
U8 GUI_SetPenSize(U8 PenSize);

(3)矩形区域填充背景颜色
void GUI_ClearRect(int x0, int y0, int x1, int y1);
左上角(x0,y0) 右下角(x1,y1）

(4)GUI_CopyRect()
将给定矩形区域的内容复制到指定位置。

void GUI_CopyRect(int x0, int y0, int x1, int y1, int xSize, int ySize);

(5)GUI_DrawGradientH()
绘制用水平颜色梯度填充的矩形。

void GUI_DrawGradientH(int x0, int y0, int x1, int y1,GUI_COLOR Color0, GUI_COLOR Color1);

(6)GUI_DrawGradientV()
绘制用垂直颜色梯度填充的矩形。与5类似

void GUI_DrawGradientV(int x0, int y0, int x1, int y1,
GUI_COLOR Color0, GUI_COLOR Color1);

(7)GUI_DrawGradientRoundedH()
绘制用水平颜色梯度填充的圆角矩形。

void GUI_DrawGradientRoundedH(int x0, int y0, int x1, int y1, int rd
GUI_COLOR Color0, GUI_COLOR Color1);

(8)GUI_DrawGradientRoundedV()
绘制用垂直颜色梯度填充的圆角矩形。与7类似

void GUI_DrawGradientRoundedV(int x0,   int y0, int x1,   int y1,
GUI_COLOR Color0, GUI_COLOR Color1);

(9)void GUI_DrawPixel(int x, int y);
在当前窗口中的指定位置绘制像素。

(10)void GUI_DrawPoint(int x, int y);
在当前窗口中的指定位置以当前画笔大小绘制点

(11)void GUI_DrawRect(int x0, int y0, int x1, int y1);
在当前窗口中的指定位置绘制矩形。左上角(x0,y0) 右下角(x1,y1）

(12)GUI_DrawRoundedFrame()
在当前窗口中的指定位置绘制指定宽度的圆角框。

void GUI_DrawRoundedFrame(int x0, int y0, int x1, int y1, int r, int w);
//左上角(x0,y0) 右下角(x1,y1）
//r:圆角使用的半径。w:框的绘制宽度。

(13)GUI_DrawRoundedRect()

void GUI_DrawRoundedRect(int x0, int y0, int x1, int y1, int r);
//左上角(x0,y0) 右下角(x1,y1） r圆角使用的半径

(14)void GUI_FillRect(int x0, int y0, int x1, int y1);
在当前窗口中的指定位置绘制填充的矩形区域。

(15)void GUI_FillRoundedRect(int x0, int y0, int x1, int y1, int r);
在当前窗口中的指定位置绘制填充的圆角矩形。

(16)void GUI_InvertRect(int x0, int y0, int x1, int y1);
在当前窗口中的指定位置绘制倒转的矩形区域。

小结：

7.Alpha混合
Alpha混合是一种合并前景图像(上层图层)与背景来创建半透明效果的方法。Alpha值决定可见的像素数以及背景透露的像素数。Alpha值为0表示不透明，值为255表示完全透明。

unsigned GUI_SetAlpha(U8 Value);
Value:用于所有后续绘制操作的Alpha值。默认为0，表示无Alpha混合。

函数设置用于所有后续绘制操作的Alpha值。参数Alpha值为0表示不透明（禁用Alpha
混合），值为255表示完全透明（不可见）。
请注意，软件Alpha混合会增加CPU负荷。此外，强烈建议在绘制操作完成后，将Alpha
值设回默认值。

8.图形绘制

1.绘制线条

2.绘制图形

9.颜色
预定义颜色

调色板

一般使用GUI_DEVICE_CreateAndLink()来设置调色板，选举GUICC_M565这个调试板

颜色API函数

GUI_COLOR GUI_SetBkColor(GUI_COLOR Color); //设置当前背景色
Color:背景的颜色，24位RGB值。

int GUI_SetBkColorIndex(int Index); //设置当前背景色的索引。
Index:要使用颜色的索引。


void GUI_SetColor(GUI_COLOR Color);//设置当前前景色。
void GUI_SetColorIndex(int Index);//设置当前前景色的索引。