A product of SEGGER Microcontroller GmbH & Co. KG
emWin
Document: UM03001
Software version: V5.22
Document revision: 0
Date: July 4, 2013
User & Reference Guide
Graphic Library with
Graphical User Interface
www.segger.com
2 CHAPTER
UM03001 User & Reference Guide for emWin V5.22 © 1997 - 2013 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 - 2013 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: July 4, 2013
UM03001 User & Reference Guide for emWin V5.22 © 1997 - 2013 SEGGER Microcontroller GmbH & Co. KG
3
Software Rev. Date By Description
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.
- New function GUI_MEMDEV_CreateBlurredDevice32() added.
- New function GUI_MEMDEV_CreateBlurredDevice32HQ() added.
- New function GUI_MEMDEV_CreateBlurredDevice32LQ() added.
- New function GUI_MEMDEV_PunchOutDevice() added.
- New function GUI_MEMDEV_RotateHQHR() added.
- New function GUI_MEMDEV_RotateHR() added.
- New function GUI_MEMDEV_SetBlurHQ() added.
- New function GUI_MEMDEV_SetBlurLQ() added.
Chapter 16 ’ Widgets’
- Added notification messages sent by the IMAGE widget.
- Added notification messages sent by the TEXT widget.
- New function GRAPH_SetAutoScrollbar() added.
- New function GRAPH_GetScrollValue() added.
- New function GRAPH_SetScrollValue() added.
- New function ICONVIEW_SetIconAlign() added.
- New function LISTWHEEL_GetItemFromPos() added.
- New function MULTIEDIT_SetFocussable() added.
- New function MULTIPAGE_GetPageText() added.
- New function TREEVIEW_ScrollToSel() added.
- New section 16.1.2 ’Custom widgets’ added.
Chapter 25 ’Sprites’
- New function GUI_SPRITE_SetLoop() added.
- New function GUI_SPRITE_StartAnim() added.
- New function GUI_SPRITE_StopAnim() added.
Chapter 27 ’Antialiasing’
- New function GUI_AA_FillRoundedRect() added.
- New function GUI_AA_FillRoundedRectEx() added.
- New function GUI_AA_DrawRoundedRect() added.
- New function GUI_AA_DrawRoundedRectEx() added.
Chapter 29 ’Display drivers’
- New display driver GUIDRV_UC1698G added.
- Support for Solomon SSD1306 added to GUIDRV_SPage.
Chapter 33 ’Timing- and execution-related functions’
- New function GUI_TIMER_Create() added.
- New function GUI_TIMER_Delete() added.
- New function GUI_TIMER_Restart() added.
- New function GUI_TIMER_SetPeriod() added.
4 CHAPTER
UM03001 User & Reference Guide for emWin V5.22 © 1997 - 2013 SEGGER Microcontroller GmbH & Co. KG
Software Rev. Date By Description
5.20 4 130409 AS
GUIDRV_SPage:
- Support for Solomon SSD1305 added to 1510.
5.20 3 130409 AS Various corrections / improvements.
5.20 2 130308 AS
Chapter 28 ’Language Support’
- New function GUI_LANG_GetTextBuffered() added.
- New function GUI_LANG_GetTextBufferedEx() added.
5.20 1 130305 AS
Chapter 19 ’Skinning’
- New function CHECKBOX_GetSkinFlexButtonSize() added.
- New function CHECKBOX_SetSkinFlexButtonSize() added.
5.20 0 130218 JE
Chapter 10 ’Fonts’
- Support for iType® fonts of Monotype Imaging added.
Chapter 12 ’Colors’
- New color conversions added:
GUICC_M8888I, GUICC_M1555I, GUICC_M4444I, GUICC_1616I,
GUICC_88666I
Chapter 17 ’Dialogs’
- CALENDAR dialog and functions added:
CALENDAR_Create()
CALENDAR_GetDate()
CALENDAR_GetSel()
CALENDAR_SetDate()
CALENDAR_SetSel()
CALENDAR_SetDefaultBkColor()
CALENDAR_SetDefaultColor()
CALENDAR_SetDefaultDays()
CALENDAR_SetDefaultFont()
CALENDAR_SetDefaultMonths()
CALENDAR_SetDefaultSize()
UM03001 User & Reference Guide for emWin V5.22 © 1997 - 2013 SEGGER Microcontroller GmbH & Co. KG
5
Software Rev. Date By Description
5.20 0 130218 JE
Chapter 25 ’Sprites’
- New function GUI_SPRITE_CreateHidden() added.
- New function GUI_SPRITE_CreateHiddenEx() added.
Chapter 29 ’Display Drivers’
GUIDRV_FlexColor:
- Support for Himax HX8340 added to 66712.
- New module 66772 added wit support for:
Hitachi HD66772, Samsung S6D0117, Sitronix ST7712,
Himax HX8301, Ilitek ILI9220 and ILI9221
GUIDRV_SLin:
- Support for Epson S1D13305 added.
Chapter 30 ’VNC-Server’
- New function GUI_VNC_SetLockFrame() added.
Chapter 32 ’Timing and execution’
- New function GUI_Error() added.
Chapter 34 ’Configuration’
- New function GUI_SetOnErrorFunc() added.
5.18 0 120917
JE
AS
Chapter 8 ’Displaying bitmap files’
- New function GUI_BMP_SerializeExBpp() added.
Chapter 9 ’Bitmap Converter’
- New functions added to create animated sprites and cursors out
of animated GIF files.
Chapter 13 ’Memory Devices’
- New function GUI_MEMDEV_SerializeBMP() added.
Chapter 15 ’The Window Manager (WM)’
New function WM_SetCaptureMove() added.
New function WM_Screen2hWin() added.
New function WM_Screen2hWinEx() added.
Chapter 16 ’Window Objects (Widgets)’
- New functions added:
TEXT_GetText()
LISTVIEW_SetWrapMode()
Chapter 27 ’Antialiasing’
- New function GUI_AA_SetDrawMode() added.
Chapter 28 ’Foreign Language Support’
- New feature "Text- and language resource files" added.
Chapter 29 ’Display drivers’
GUIDRV_FlexColor:
- Function GUIDRV_FlexColor_SetInterface66709_B16() replaced
by the function GUIDRV_FlexColor_SetReadFunc66709_B16().
- Function GUIDRV_FlexColor_SetInterface66720_B16() replaced
by the function GUIDRV_FlexColor_SetReadFunc66720_B16().
- New module 66702 added:
Solomon SSD1284, SSD1289, SSD1298
- New module 66715 added:
Himax HX8352B
- Recommended calling sequence for configuration functions
added.
GUIDRV_S1D13781:
- Additional information about initialized registers added.
5.16 2 120809 AS
Chapter 16 ’Window Objects (Widgets)’
- New function SPINBOX_SetRange() added.
Various corrections.
5.16 1 120628 AS
Chapter 15 ’The Window Manager (WM)’
Descriptions of the following functions reworked:
- WM_GetScrollPosH()
- WM_GetScrollPosV()
- WM_SetScrollPosH()
- WM_SetScrollPosV()
Preface, About and Chapter 1 ’Intro’ reworked.
5.16 0 120605
JE
AS
Chapter 12 ’Colors’
- New color conversion routine added to support
1bpp at different color depths.
Chapter 13 ’Memory Devices’
- New function GUI_MEMDEV_RotateHQT() added.
