emWin
带图形用户界面的图形库
用户参考手册
文 档: UM03001
软件版本: V5.42
文档修订: 0
日期:July31,2017
A product of SEGGER Microcontroller GmbH & Co. KG
www.segger.com
2 CHAPTER
UM03001 emWin V5.42 用户参考手册 © 1997 - 2017 SEGGER Microcontroller GmbH & Co. KG
免责声明
本文中所含的规格信息据信是准确的，但不担保完全没有错误。本手册中所含信息可能会因功能或性
能改善而变更，恕不另行通知。请确保您手中的手册是最新版本。虽然此处所提供信息据信是准确的，
但如有任何错误或疏漏， SEGGER Microcontroller GmbH & Co. KG （制造商）概不承担任何责
任。制造商不作（用户因而也不会获得）任何担保或条件，无论是明示的、暗含的、法定的还是以任
何函件形式与用户确认的。特别地，制造商拒绝承担任何适销性或特定目的适用性的担保。
版权声明
如无制造商的事先书面许可，不得截取本手册的任何部分或者以任何方式修改 PDF 文件。本文件中所述
软件基于许可证提供，且只能根据此许可证的条款进行使用或复制。
© 1997 - 2017 SEGGER Microcontroller GmbH & Co. KG, Hilden / Germany
商标
本手册中提及的名称可能是其各自所属公司的商标。
各品牌和产品名称均为其各自所有者的商标或注册商标。
联系地址
SEGGER Microcontroller GmbH & Co. KG
In den Weiden 11
D-40721 Hilden
Germany
Tel.+49 2103-2878-0
Fax.+49 2103-2878-28
E-mail: support@segger.com
Internet: http://www.segger.com
手册版本
本手册讲述的是最新软件版本。软件的版本编号请见本章节稍后的“软件版本”表。如有任何差错，请
通知我们，我们将尽快尽力为您提供帮助。
有关任何未明确的其他信息和程序，请联系我们。
印刷日期：July 31, 2017
3
UM03001 emWin V5.42 用户参考手册 © 1997 - 2017 SEGGER Microcontroller GmbH & Co. KG
软件版本 修订 日期 作者 描述
5.42
0
170731
SC
第 6 章 ‘显示文本’
-
添加新函数 GUI_DispStringInRectWrapEx()。
-
添加新函数 GUI_SetStrikeWidth()。
第 8 章 ‘2-D 图形库’
-
添加新函数 GUI_AddRect()。
第 10 章 ‘位图转换器’
-
Description about options dialog
第 19 章 ‘控件’
-
添加新函数 CHECKBOX_GetBkColor()。
-
添加新函数 CHECKBOX_GetBoxBkColor()。
-
添加新函数 CHECKBOX_GetFocusColor()。
-
添加新函数 CHECKBOX_GetFont()。
-
添加新函数 CHECKBOX_GetTextAlign()。
-
添加新函数 CHECKBOX_GetTextColor()。
-
添加新函数 DROPDOWN_GetBkColor()。
-
添加新函数 DROPDOWN_GetColor()。
-
添加新函数 DROPDOWN_GetFont()。
-
添加新函数 DROPDOWN_GetTextColor()。
-
添加新函数 GRAPH_GetColor()。
-
添加新函数 HEADER_GetFont()。
-
添加新函数 ICONVIEW_GetBkColor()。
-
添加新函数 ICONVIEW_GetFont()。
-
添加新函数 ICONVIEW_GetTextColor()。
-
添加新函数 ICONVIEW_GetReleasedItem()。
-
添加新函数 LISTBOX_GetBkColor()。
-
添加新函数 LISTBOX_GetTextColor()。
-
添加新函数 MENU_GetBkColor()。
-
添加新函数 MENU_GetFont()。
-
添加新函数 MENU_GetTextColor()。
-
添加新函数 MULTIEDIT_GetBkColor()。
-
添加新函数 MULTIEDIT_GetFont()。
-
添加新函数 MULTIEDIT_GetTextColor()。
-
添加新函数 MULTIEDIT_ShowCursor()。
-
添加新函数 MULTIPAGE_GetBkColor()。
-
添加新函数 MULTIPAGE_GetTextColor()。
-
添加新函数 PROGBAR_GetBarColor()。
-
添加新函数 PROGBAR_GetFont()。
-
添加新函数 RADIO_GetBkColor()。
-
添加新函数 RADIO_GetFocusColor()。
-
添加新函数 RADIO_GetFont()。
-
添加新函数 RADIO_GetTextColor()。
-
添加新函数 SCROLLBAR_GetColor()。
-
添加新函数 SPINBOX_GetFont()。
-
添加新函数 SPINBOX_GetTextColor()。
-
添加新函数 TEXT_SetDec()。
第 20 章 ‘对话框’
-
添加新函数 CALENDAR_AddKey()。
第 33 章 ‘显示驱动’
-
16bpp 支持 GUIDRV_S1D13L01。
-
16bpp 支持 GUIDRV_S1D13781。
-
添加新函数 LCD_SetBufferPtr()。
-
添加新函数 LCD_SetBufferPtrEx()。
5.40
2
170524
JE
第 9 章 ‘显示位图文件’
-
PNG 库下载链接修改。
-
第 11 章 ‘字体’
-
iType and iTypeSpark glue code 下载链接修改。
-
Freetype 库下载链接修改。
-
XBF 格式描述。
5.40
1
170508
JE
第 33 章 ‘显示驱动’
-
添加新的驱动 GUIDRV_S1D13L01。
-
添加新的驱动 GUIDRV_S1D13L02。
-
添加新的驱动 GUIDRV_S1D13L04。
表 0.1：修订历史
4 CHAPTER
UM03001 emWin V5.42 用户参考手册 © 1997 - 2017 SEGGER Microcontroller GmbH & Co. KG
软件版本 修订 日期 作者 描述
5.40
0
170302
JE
第 3 章 ‘模拟’
-
函数 SIM_GUI_SaveCompositeBMP()。
第 6 章 ‘显示文本’
-
函数 GUI_WrapSetSeparators()。
-
函数 GUI_WrapGetPositions()。
第 13 章 ‘电影’
-
函数 GUI_MOVIE_DrawFrame()。
第 19 章 ‘控件’
-
函数 ICONVIEW_GetItemBitmap()。
-
函数 ICONVIEW_SetOwnerDraw()。
-
函数 MULTIEDIT_SetCursorCharPos()。
-
函数 MULTIEDIT_SetCursorPixelPos()。
-
函数 WIDGET_SetFocusable()。
-
函数 WIDGET_EnableStreamAuto()。
第 10 章 ‘位图转换器’
-
位图转换器现在支持 JPEG 文件
-
新的命令行选项 ’reducecolors’。
-
新的命令行选项’hide’。
-
新的命令行选项’scale’。
第 18 章 ‘窗口管理器’
-
函数 WM_GetNumInvalidWindows()。
-
函数 WM_MOTION_SetThreshold()。
-
’Overlapping’支持添加到 WM_MOTION.
-
添加新变量到 WM_MOTION_INFO.
第 33 章 ‘显示驱动’
-
函数 LCD_On() and LCD_OnEx()。
-
函数 LCD_Off() and LCD_OffEx()。
第 38 章 ‘配置’
-
函数 GUI_SetpfMemset()。
-
函数 GUI_SetpfMemcpy()。
5.38
0
161124
JE
SC
第 3 章 ‘模拟’
-
函数 SIM_GUI_Delay()。
-
函数 SIM_GUI_ExecIdle()。
-
函数 SIM_GUI_GetTime()。
第 8 章 ‘2-D 图形库’
-
函数 GUI_GCACHE_4_Create()。
-
函数 GUI_GCACHE_4_CreateEx()。
第 11 章 ‘字体’
-
函数 GUI_GetDefaultFont()。
第 14 章 ‘动画’
-
函数 GUI_ANIM_StartEx()。
-
函数 GUI_ANIM_Stop()。
第 15 章 ‘颜色’
-
函数 GUI_GetDefaultBkColor()。
-
函数 GUI_GetDefaultColor()。
-
函数 GUI_SetDefaultBkColor()。
-
函数 GUI_SetDefaultColor()。
第 16 章 ‘内存设备’
-
函数 GUI_MEMDEV_MULTIBUF_Enable()。
第 18 章 ‘窗口管理器’
-
解释如何与 WM 和多层工作。
第 19 章 ‘控件’
-
MULTIEDIT: GUI_KEY_PGUP and GUI_KEY_PGDOWN。
第 26 章 ‘指针输入设备’
-
函数 GUI_PID_SetHook()。
第 33 章 ‘显示驱动’
-
LCD_DEVFUNC_DRAWBMP_32BPP 添加到 LCD_SetDevFunc().
-
添加新的驱动 GUIDRV_S1D13513。
-
GUIDRV_FlexColor: 24bpp 模式添加到 F66720.
第 34 章 ‘VNC 服务器’
-
函数 GUI_VNC_SetRetryCount()。
第 36 章 ‘定时和执行相关的函数’
-
函数 GUI_GetTimeSlice()。
-
函数 GUI_SetTimeSlice()。
-
第 38 章 ‘配置’
-
解释添加如何与帧缓冲器和 DCACHE 工作
-
函数 GUI_SetFuncDrawAlpha()。
-
函数 GUI_DCACHE_Clear()。
-
函数 GUI_DCACHE_SetClearCacheHook()。
表 0.1：修订历史
5
UM03001 emWin V5.42 用户参考手册 © 1997 - 2017 SEGGER Microcontroller GmbH & Co. KG
软件版本 修订 日期 作者 描述
5.36
2
160906
JE
第 37 章 ‘性能和资源使用情况’
-
ARM Cortex-M4 和 A9 性能值。
-
图像性能值计算。
5.36 1 160901 JE
第 33 章 ‘显示驱动’
- GUIDRV_FlexColor: 24bpp 模式。
5.36
0
160829
JE
第 19 章 ‘控件’
-
函数 SWIPELIST_GetThreshold()。
-
函数 SWIPELIST_SetThreshold()。
-
函数 SWIPELIST_SetDefaultThreshold()。
-
函数 SWIPELIST_GetDefaultThreshold()。
-
函数 GRAPH_DATA_YT_GetValue()。
-
函数 GRAPH_DATA_XY_GetPoint()。
第 31 章 ‘抗锯齿’
-
函数 GUI_AA_EnableGammaAA4()。
-
函数 GUI_AA_SetGammaAA4()。
-
函数 GUI_AA_GetGammaAA4()。
第 32 章 ‘语言支持’
-
Unicode 标准兼容解释。
-
函数 GUI_UC_SetBaseDir()。
第 33 章 ‘显示驱动’
-
支持 Sitronix ST7796 添加到 GUIDRV_FlexColor.
-
支持 LDT LD7138 添加到 to GUIDRV_FlexColor.
-
支持 SP9230 添加到 to GUIDRV_FlexColor.
-
支持 IST3501 添加到 GUIDRV_SPage.
-
支持 Sitronix ST7570 添加到 GUIDRV_SPage.
5.34 2 160621 JE
第 1 章 ‘简介’
- 添加编译器限制: ’char’需要 8 位。
5.34 1 160517 JE
第 33 章 ‘显示驱动’
- GUIDRV_SH_MEM: LS013B7DH06 删除, 仅支持 b/w。
5.34
0
160425
JE
第 2 章 ‘入门指南’
-
函数 GUI_IsInitialized()。
第 3 章 ‘模拟’
-
函数 SIM_GUI_SaveBMP()。
-
函数 SIM_GUI_SaveBMPEx。
第 8 章 ‘2-D 图形库’
-
函数 GUI_QR_Create()。
-
函数 GUI_QR_Delete()。
-
函数 GUI_QR_Draw()。
-
函数 GUI_QR_GetInfo()。
-
函数 GUI_SetControlHook()。
第 9 章 ‘显示位图文件’
-
函数 GUI_BMP_EnableAlpha()。
第 11 章 ‘字体’
-
支持 iTypeSpark®字体引擎。
第 19 章 ‘控件’
-
函数 LISTBOX_GetOwner()。
第 26 章 ‘指针输入设备’
-
函数 GUI_PID_SetInitFunc()。
第 33 章 ‘显示驱动’
-
Sharp Memory LCDs 新显示驱动。
第 34 章 ‘VNC 服务器’
-
文件传输能力。
第 38 章 ‘配置’
-
Macro GUI_POST_INIT。
表 0.1：修订历史
评论2