A product of SEGGER Microcontroller GmbH & Co. KG
emWin
Document: UM03001
Software version: V5.28
Document revision: 1
Date: February 10, 2015
User & Reference Guide
Graphic Library with
Graphical User Interface
www.segger.com
2 CHAPTER
UM03001 User & Reference Guide for emWin V5.28 © 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: February 10, 2015
UM03001 User & Reference Guide for emWin V5.28 © 1997 - 2015 SEGGER Microcontroller GmbH & Co. KG
3
Software Rev. Date By Description
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.
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.
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.
Table 0.1: Revision history
4 CHAPTER
UM03001 User & Reference Guide for emWin V5.28 © 1997 - 2015 SEGGER Microcontroller GmbH & Co. KG
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.
5.24 2 140429
Sc
AS
Table titles were added for all tables except "Permitted values".
Chapter 13 ’Colors’
- Structure ’LCD_PHYSPALETTE’ added.
- Section ’Look-up table API’ added.
- Function ’LCD_SetLUT()’ added.
- Function ’LCD_SetLUTEx()’ added.
- Function ’LCD_SetLUTEntryEx()’ added.
5.24 1 140225
Sc
AS
Various corrections.
Software Rev. Date By Description
Table 0.1: Revision history
UM03001 User & Reference Guide for emWin V5.28 © 1997 - 2015 SEGGER Microcontroller GmbH & Co. KG
5
Software Rev. Date By Description
5.24 0 130801 JE
Chapter 7 ’2-D Graphic Library’
- New function GUI_CreateBitmapFromStreamA555() added.
- New function GUI_CreateBitmapFromStreamAM555() added.
- New function GUI_CreateBitmapFromStreamA565() added.
- New function GUI_CreateBitmapFromStreamAM565() added.
- New function GUI_DrawStreamedBitmapA555Ex() added.
- New function GUI_DrawStreamedBitmapAM555Ex() added.
- New function GUI_DrawStreamedBitmapA565Ex() added.
- New function GUI_DrawStreamedBitmapAM565Ex() added.
Chapter 9 ’Bitmap Converter’
- New bitmap formats added: 16bpp + 8 bit alpha channel.
Chapter 10 ’Fonts’
- New function GUI_TTF_CreateFontAA() added.
Chapter 13 ’Memory Devices’
- New function GUI_MEMDEV_ClearAlpha() added.
- New function GUI_MEMDEV_CreateFixed32() added.
- New function GUI_MEMDEV_BlendColor32() added.
Chapter 16 ’Window Manager’
- Circular motion support added.
Chapter 17 ’Widgets’
- New widget "KNOB" added.
- New function LISTWHEEL_SetDeceleration() added.
- New function DROPDOWN_SetListHeight() added.
- New function ICONVIEW_CreateIndirect() added.
- New function LISTVIEW_OwnerDraw() added.
- New function LISTVIEW_SetOwnerDraw() added.
- New function LISTVIEW_GetWrapMode() added.
- New function MULTIPAGE_GetPageText() added.
- New function SPINBOX_SetEditMode() added.
- New function SPINBOX_SetStep() added.
New chapter 25 ’MultiTouch’ added.
- New function GUI_MTOUCH_Enable() added.
- New function GUI_MTOUCH_GetEvent() added.
- New function GUI_MTOUCH_GetTouchInput() added.
- New function GUI_MTOUCH_IsEmpty() added.
- New function GUI_MTOUCH_SetOrientation() added.
- New function GUI_MTOUCH_SetOrientationEx() added.
- New function GUI_MTOUCH_StoreEvent() added.
- New function WM_EnableGestures() added.
Chapter 29 ’Antialiasing’
- New function GUI_AA_PreserveTrans() added.
Chapter 30 ’Language Support’
- Remark that Devanagari transitions are not supported.
Chapter 31 ’Display Drivers’
- New function LCD_SetChromaEx() added.
- New function LCD_SetChromaModeEx() added.
- New function LCD_SetAlpha() added.
- New function LCD_SetAlphaModeEx() added.
- New function LCD_SetVisEx() added.
- Support for Ilitek ILI9163 added to GUIDRV_FlexColor.
- Support for RAIO8870 added to GUIDRV_FlexColor.
- Support for Solomon SSD1351 added to GUIDRV_FlexColor.
- Support for RAIO 8835 added to GUIDRV_SLin.
- Support for Samsung S6B0108 added to GUIDRV_SPage.
- Support for Hitachi HD61202 added to GUIDRV_SPage.
Chapter 32 ’Touch drivers’
- New multi touch driver added for PIXCIR TangoC32.
Chapter 35 ’Performance and Resource Usage’
- New sub chapter ’Optimizing Footprint’ added.
5.22 2 140108 AS
GUIDRV_CompactColor_16:
- Support for Samsung S6D0128 added to 66772.
- Support for Sitronix ST7789 added to 66717.
5.22 1 130801 AS Various corrections.
5.22 0 130625
JE
AS
New chapter 11 ’Movies’ added.
Chapter 12 ’Colors’
- New color conversion GUICC_8 added.
Chapter 13 ’Memory Devices’
- New function GUI_MEMDEV_BlendWinBk() added.
- New function GUI_MEMDEV_BlurAndBlendWinBk() added.
- New function GUI_MEMDEV_BlurWinBk() added.
Table 0.2: Revision history