A product of SEGGER Microcontroller GmbH & Co. KG
emWin
Document: UM03001
Software version: V5.32
Document revision: 0
Date: October 6, 2015
User & Reference Guide
Graphic Library with
Graphical User Interface
www.segger.com
2 CHAPTER
UM03001 User & Reference Guide for emWin V5.32 © 1997 - 2015 SEGGER Microcontroller GmbH & Co. KG
Disclaimer
Specifications written in this document are believed to be accurate, but are not guar-
anteed to be entirely free of error. The information in this manual is subject to
change for functional or performance improvements without notice. Please make sure
your manual is the latest edition. While the information herein is assumed to be
accurate, SEGGER Microcontroller GmbH & Co. KG (SEGGER) assumes no responsibil-
ity for any errors or omissions. SEGGER makes and you receive no warranties or con-
ditions, express, implied, statutory or in any communication with you. SEGGER
specifically disclaims any implied warranty of merchantability or fitness for a particu-
lar purpose.
Copyright notice
You may not extract portions of this manual or modify the PDF file in any way without
the prior written permission of SEGGER. The software described in this document is
furnished under a license and may only be used or copied in accordance with the
terms of such a license.
© 1997 - 2015 SEGGER Microcontroller GmbH & Co. KG, Hilden / Germany
Trademarks
Names mentioned in this manual may be trademarks of their respective companies.
Brand and product names are trademarks or registered trademarks of their respec-
tive holders.
Contact address
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
Manual versions
This manual describes the current software version. If any error occurs, inform us
and we will try to assist you as soon as possible.
Contact us for further information on topics or routines not yet specified.
Print date: October 6, 2015
UM03001 User & Reference Guide for emWin V5.32 © 1997 - 2015 SEGGER Microcontroller GmbH & Co. KG
3
Software Rev. Date By Description
5.32 0 150930 JE
Chapter 3 ’Simulation’
- Function SIM_GUI_GetCompositeTouch() added.
- Function SIM_GUI_SetCompositeTouch() added.
Chapter 5 ’emWinSPY’
- RTT connection added.
Chapter 19 ’Widgets’
- New widget 'SWIPELIST' added.
- Function LISTVIEW_SetSelCol() added.
- Function SLIDER_GetRange() added.
- Function EDIT_EnableInversion() added.
Chapter 32 ’Language Support’
- Function GUI_LANG_GetLang() added.
Chapter 33 ’Display Drivers’
- Commands added to LCD_X_DisplayDriver():
LCD_X_SHOWBUFFER, LCD_X_SETVIS, LCD_X_SETPOS,
LCD_X_SETSIZE, LCD_X_SETALPHA
Table 0.1: Revision history
4 CHAPTER
UM03001 User & Reference Guide for emWin V5.32 © 1997 - 2015 SEGGER Microcontroller GmbH & Co. KG
5.30 0 150706
JE
AS
Chapter 8 ’2-D Graphic Library’
- Function GUI_PreserveTrans() added.
- Function GUI_SetAlphaMask8888() added.
Chapter 10 ’Bitmap Converter’
- Saving of PNGs now supported.
- New bitmap format M8888I supported.
Chapter 12 ’Font Converter’
- Loading of Adobe (B)itmap (D)istribution (F)ormat (BDF) added.
Chapter 14 ’Animations’
- Function GUI_ANIM_AddItem() added.
- Function GUI_ANIM_Create() added.
- Function GUI_ANIM_Delete() added.
- Function GUI_ANIM_Exec() added.
- Function GUI_ANIM_Start() added.
Chapter 15 ’Colors’
- New logical color mode ARGB added.
Chapter 16 ’Memory Devices’
- Function GUI_MEMDEV_WriteOpaque() added.
- Function GUI_MEMDEV_WriteOpaqueAt() added.
Chapter 18 ’Window Manager’
- Explanation of tiling algorithm added.
Chapter 19 ’Widgets’
- Function LISTWHEEL_IsMoving() added.
- Function PROGBAR_GetMinMax() added.
- Function PROGBAR_GetValue() added.
- Function TEXT_GetBkColor() added.
- Function TEXT_GetFont() added.
- Function TEXT_GetTextAlign() added.
- Function TEXT_GetTextColor() added.
- Function TEXT_GetWrapMode() added.
- Function TEXT_GetDefaultTextColor() added.
- Function TEXT_GetDefaultWrapMode() added.
Chapter 33 ’Display Drivers’
- Support for HX8369 added to GUIDRV_FlexColor.
- Support for ST7715 added to GUIDRV_FlexColor.
- Support for SSD1325 added to GUIDRV_SLin.
5.28 1 150206 JE Licensing information of TTF and PNG support changed.
5.28 0 150128
JE
AS
Chapter 3 ’Simulation’
- Function SIM_GUI_SetTransMode() added.
New Chapter 5 ’emWinSPY’
- New tool emWinSPY added:
- Function GUI_SPY_Process() added.
- Function GUI_SPY_SetMemHandler() added.
- Function GUI_SPY_StartServer() added.
- Function GUI_SPY_X_StartServer() added.
Chapter 8 ’2-D Graphic Library’
- Function GUI_SetRefreshHook() added.
Chapter 11 ’Fonts’
- Commas added to standard digit fonts.
Chapter 18 ’Widgets’
- Some new default values added to FRAMEWIN and WINDOW.
- Function LISTBOX_EnableWrapMode() added.
Software Rev. Date By Description
Table 0.1: Revision history
UM03001 User & Reference Guide for emWin V5.32 © 1997 - 2015 SEGGER Microcontroller GmbH & Co. KG
5
Software Rev. Date By Description
5.28 0 150128
JE
AS
Chapter 24 ’Multi layer / multi display support’
- Softlayers added:
- Function GUI_SOFTLAYER_Enable() added.
- Function GUI_SOFTLAYER_MULTIBUF_Enable() added.
- Function GUI_SOFTLAYER_Refresh() added.
- Function GUI_SOFTLAYER_SetCompositeColor() added.
Chapter 28 ’Sprites’
- Sprites now support true color bitmaps with alpha blending.
Chapter 32 ’Display drivers’
- LCD_DEVFUNC_DRAWBMP_8BPP added to LCD_SetDevFunc().
- Support for ST7789 added to GUIDRV_FlexColor.
- Support for UC1638 added to GUIDRV_SPage
- Support for Avant Electronics SBN0064G added to
GUIDRV_SPage
- New display driver GUIDRV_7528 added
Chapter 37 ’Configuration’
- Function GUITASK_GetMaxTask() added.
- Function GUICC_M1555I_SetCustColorConv() added.
- Function GUICC_M565_SetCustColorConv() added.
- Function GUICC_M4444I_SetCustColorConv() added.
- Function GUICC_M888_SetCustColorConv() added.
- Function GUICC_M8888I_SetCustColorConv() added.
- Function GUI_SetFuncAlphaBlending() added.
- Function GUI_SetFuncGetpPalConvTable() added.
- Function GUI_SetFuncMixColors() added.
- Function GUI_SetFuncMixColorsBulk() added.
- Function GUI_AA_SetpfDrawCharAA4() added.
- Function GUI_MEMDEV_SetDrawMemdev16bppFunc() added.
5.26 2 141128 AS Various corrections.
5.26 1 140821
JE
AS
Chapter 17 ’Widgets’
- Function MULTIPAGE_SetDefaultBorderSizeX() added.
- Function MULTIPAGE_SetDefaultBorderSizeY() added.
Various corrections.
5.26 0 140805
JE
AS
Chapter 7 ’2-D Graphic Library’
- Function GUI_DIRTYDEVICE_Create() added.
- Function GUI_DIRTYDEVICE_CreateEx() added.
- Function GUI_DIRTYDEVICE_Delete() added.
- Function GUI_DIRTYDEVICE_DeleteEx() added.
- Function GUI_DIRTYDEVICE_Fetch() added.
- Function GUI_DIRTYDEVICE_FetchEx() added.
Chapter 9 ’Bitmap Converter’
- Dithering added.
Chapter 14 ’Memory Devices’
- Function GUI_MEMDEV_FadeOutDevices() added.
- Function GUI_MEMDEV_RotateHQAlpha() added.
- Function GUI_MEMDEV_RotateAlpha() added.
- Function GUI_MEMDEV_Dither32() added.
Chapter 16 ’The Window Manager (WM)’
- Function WM_GetScrollbarH() added.
- Function WM_GetScrollbarV() added.
- Function WM_SetModalLayer() added.
- Function WM_GetModalLayer() added.
Chapter 17 ’Widgets’
- Function LISTVIEW_EnableCellSelect() added.
- Function LISTVIEW_GetItemRect() added.
- Function LISTVIEW_SetItemTextSorted() added.
- Function MULTIPAGE_EnableScrollBar() added.
- Function MULTIPAGE_SetBitmap() added.
- Function MULTIPAGE_SetBitmapEx() added.
- Function MULTIPAGE_SetTabHeight() added.
- Function MULTIPAGE_SetTabWidth() added.
- Function MULTIPAGE_SetTextAlign() added.
Chapter 29 ’Antialiasing’
- Function GUI_AA_FillEllipse() added.
Chapter 31 ’Display drivers’
- Support for LGDP4525 added to GUIDRV_FlexColor.
- Support for Ilitek ILI9488 added to GUIDRV_FlexColor.
- Support for Himax HX8357 added to GUIDRV_FlexColor.
- Support for Raio RA8875 added to GUIDRV_FlexColor.
- Support for OriseTech SPLC502B added to GUIDRV_SPage.
Table 0.2: Revision history