Emwin常用API函数

目录

1.文本 API

2.图形 API

3.字体 API

4.颜色 API

---

1.文本 API

下表按字母顺序列出了相应类别中与文本相关的可用例程。

函数	描述
显示文本
GUI_DispCEOL()	将当前行从当前位置清除到行末。
GUI_DispChar()	在当前位置显示单个字符。
GUI_DispCharAt()	在指定位置显示单个字符。
GUI_DispChars()	按指定次数显示字符。
GUI_DispString()	在当前位置显示字符串。
GUI_DispStringAt()	在指定位置显示字符串。
GUI_DispStringAtCEOL()	在指定位置显示字符串，并清除至行末。
GUI_DispStringHCenterAt()	在指定位置水平居中显示字符串。
GUI_DispStringInRect()	在指定的矩形区域中显示字符串。
GUI_DispStringInRectEx()	在指定的矩形区域中显示旋转的字符串。
GUI_DispStringInRectWrap()	在指定的矩形区域中显示自动换行的字符串。
GUI_DispStringinRectWrapEx()	在指定的矩形区域中显示旋转的和自动换行的字符串。
GUI_DispStringLen()	在当前位置显示指定字符数的字符串。
GUI_WrapGetNumLines()	返回用于使用给定自动换行模式在给定大小显示给定字符串需要的行号
绘制模式
GUI_GetTextMode()	返回当前设置的绘制模式。
GUI_SetTextMode()	设置绘制模式。
GUI_SetTextStyle()	设置要使用的样式。
对齐
GUI_GetTextAlign()	返回当前设置的文本对齐。
GUI_SetLBorder()	设置换行后左边界的尺寸。
GUI_SetTextAlign()	设置文本对象。
位置
GUI_DispNextLine()	将光标移动到下一行的开始。
GUI_GotoX()	设置 X 坐标。
GUI_GotoXY()	设置 X 和 Y 坐标。
GUI_GotoY()	设置 Y 坐标。
GUI_GetDispPosX()	返回当前 X 坐标。
GUI_GetDispPosY()	返回当前 Y 坐标。

2.图形 API

下表按字母顺序列出了各自类别内可用的与图形相关的函数。

函数	描述
绘制相关的函数
GUI_AddRect()	调整矩形的大小。
GUI_GetClientRect()	返回当前可用绘制区。
GUI_GetDrawMode()	返回当前绘制模式。
GUI_GetPenSize()	返回当前画笔大小，单位：像素。
GUI_GetPixelIndex()	返回给定位置的颜色索引。
GUI_SetClipRect()	设置用于裁剪的矩形。
GUI_SetDrawMode()	设置绘制模式。
GUI_SetPenSize()	设置画笔大小，单位：像素。
基本绘制函数
GUI_Clear()	用背景色填充显示器/激活窗口。
GUI_ClearRect()	用背景色填充一个矩形区域。
GUI_CopyRect()	在显示器上复制一个矩形区域。
GUI_DrawGradientH()	绘制用水平颜色梯度填充的矩形。
GUI_DrawGradientV()	绘制用垂直颜色梯度填充的矩形。
GUI_DrawGradientRoundedH()	绘制用水平颜色梯度填充的圆角矩形。
GUI_DrawGradientRoundedV()	绘制用垂直颜色梯度填充的圆角矩形。
GUI_DrawPixel()	绘制单个像素。
GUI_DrawPoint()	绘制点。
GUI_DrawRect()	绘制矩形。
GUI_DrawRectEx()	绘制矩形。
GUI_DrawRoundedFrame()	绘制圆角框。
GUI_DrawRoundedRect()	绘制圆角矩形。
GUI_FillRect()	绘制填充的矩形。
GUI_FillRectEx()	绘制填充的矩形。
GUI_FillRoundedRect()	绘制填充的圆角矩形。
GUI_InvertRect()	倒转矩形区域。
Alpha 混合
GUI_EnableAlpha()	启用/ 禁用自动 Alpha 混合。
GUI_PreserveTrans()	在绘制操作之后确保 alpha 通道仍然存在。
GUI_RestoreUserAlpha()	恢复之前的用户 Alpha 混合状态。
GUI_SetAlpha()	设置当前的 Alpha 混合值。（弃用）。
GUI_SetUserAlpha()	设置其他值，以用于计算要使用的实际 Alpha 混合值。
绘制位图
GUI_DrawBitmap()	绘制位图。
GUI_DrawBitmapEx()	绘制缩放的位图。
GUI_DrawBitmapHWAlpha()	在具有硬件 Alpha 混合支持的系统上绘制带 Alpha 混合 信息的位图。
GUI_DrawBitmapMag()	绘制放大的位图。

绘制线条
GUI_DrawHLine()	绘制水平线。
GUI_DrawLine()	绘制从某个指定起点到指定终点的线条（绝对坐标）。
GUI_DrawLineRel()	绘制从当前位置到按 X 和 Y 距离指定的终点的线条（相对 坐标）。
GUI_DrawLineTo()	绘制从当前位置到指定终点的线条。
GUI_DrawPolyLine()	绘制折线。
GUI_DrawVLine()	绘制垂直线。
GUI_GetLineStyle()	返回当前的线条样式。
GUI_MoveRel()	相对于其当前位置移动线条指针。
GUI_MoveTo()	将线条指针移动到给定位置。
GUI_SetLineStyle()	设置当前的线条样式。
绘制多边形
GUI_DrawPolygon()	绘制多边形的轮廓。
GUI_EnlargePolygon()	扩展多边形。
GUI_FillPolygon()	绘制填充的多边形。
GUI_MagnifyPolygon()	放大多边形。
GUI_RotatePolygon()	按指定角度旋转多边形。
绘制圆
GUI_DrawCircle()	绘制圆的轮廓。
GUI_FillCircle()	绘制填充的圆。
绘制椭圆
GUI_DrawEllipse()	绘制椭圆的轮廓。
GUI_FillEllipse()	绘制填充的椭圆。
绘制弧线
GUI_DrawArc()	绘制弧线。
绘制曲线
GUI_DrawGraph()	绘制曲线。
绘制 QR-codes
GUI_QR_Create()	创建 QR-code 位图。
GUI_QR_Delete()	删除 QR-code 位图。
GUI_QR_Draw()	绘制 QR-code 位图。

3.字体 API

下表按字母顺序列出了各自类别内可用的与字体相关的例程。

函数	描述
’SIF’文件相关的字体函数
GUI_SIF_CreateFont()	通过将指针传递至系统独立字体数据创建和选择字体。
GUI_SIF_DeleteFont()	删除使用GUI_SIF_CreateFont()创建的字体
’TTF’文件相关的字体函数
GUI_TTF_CreateFont()	基于TTF 字体文件创建GUI 字体。
GUI_TTF_CreateFontAA()	从带抗锯齿的 TTF 字体文件创建 GUI 字体。
GUI_TTF_DestroyCache()	解除TTF 引擎的缓存。
GUI_TTF_Done()	释放TTF 引擎动态分配的所有内存。
GUI_TTF_GetFamilyName()	返回字体的系列名称。
GUI_TTF_GetStyleName()	返回字体的样式名称。
GUI_TTF_SetCacheSize()	可用于设置TTF 缓存的默认大小。
’XBF’文件相关的字体函数
GUI_XBF_CreateFont()	通过将指针传递至负责从 XB 字体文件获取数据的回调函数创建和选择字体。
GUI_XBF_DeleteFont()	删除使用GUI_XBF_CreateFont()创建的字体
常用字体相关的函数
GUI_GetCharDistX()	返回当前字体中指定字符的宽度像素 （ X 大小）。
GUI_GetDefaultFont()	返回默认字体。
GUI_GetFont()	返回当前选择的字体的指针。
GUI_GetFontDistY()	返回当前字体的Y 间距。
GUI_GetFontInfo()	返回包含字体信息的结构。
GUI_GetFontSizeY()	返回当前字体的高度像素（ Y 大小）。
GUI_GetLeadingBlankCols()	返回给定字符的前导空格像素列数。
GUI_GetStringDistX()	返回使用当前字体的文本的X 大小。
GUI_GetTextExtend()	评估使用当前字体的文本的大小。
GUI_GetTrailingBlankCols()	返回给定字符的后导空格像素列数。
GUI_GetYDistOfFont()	返回特定字体的Y 间距。
GUI_GetYSizeOfFont()	返回特定字体的Y 大小。
GUI_IsInFont()	评估特定字体中是否存在指定的字符。
GUI_SetDefaultFont()	设置GUI_Init() 之后使用的默认字体。
GUI_SetFont()	设置当前字体。

4.颜色 API

下表按字母顺序在各自类别中列出了可用的颜色相关函数。

函数	描述
基本函数
GUI_GetBkColor()	返回当前背景色。
GUI_GetBkColorIndex()	返回当前背景色的索引。
GUI_GetColor()	返回当前前景色。
GUI_GetColorIndex()	返回当前前景色的索引。
GUI_GetDefaultColor()	返回默认前景色。
GUI_GetDefaultBkColor()	返回默认背景色。
GUI_SetBkColor()	设置当前背景色。
GUI_SetBkColorIndex()	设置当前背景色的索引。
GUI_SetColor()	设置当前前景色。
GUI_SetColorIndex()	设置当前前景色的索引。
GUI_SetDefaultColor()	设置默认前景色。
GUI_SetDefaultBkColor()	设置默认背景色。
转换函数
GUI_CalcColorDist()	返回 2 种颜色之间的差值
GUI_CalcVisColorError()	将差值返回给下一可用颜色
GUI_Color2Index()	将颜色转换为颜色索引。
GUI_Color2VisColor()	返回最接近的可用颜色
GUI_ColorIsAvailable()	检查给定的颜色是否可用
GUI_Index2Color()	将颜色索引转换为颜色。