2
Disclaimer
Specifications written in this document are believed to be accurate, but are not guaranteed 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 (SEG-
GER) assumes no responsibility for any errors or omissions. SEGGER makes and you receive no
warranties or conditions, express, implied, statutory or in any communication with you. SEGGER
specifically disclaims any implied warranty of merchantability or fitness for a particular 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.
© 2019 SEGGER Microcontroller GmbH, Monheim am Rhein / 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 respective holders.
Contact address
SEGGER Microcontroller GmbH
Ecolab-Allee 5
D-40789 Monheim am Rhein
Germany
Tel. +49 2173-99312-0
Fax. +49 2173-99312-28
E-mail:
*
Internet: www.segger.com
*
By sending us an email your (personal) data will automatically be processed. For further information please refer to our
privacy policy which is available at https://www.segger.com/legal/privacy-policy/.
emWin User Guide & Reference Manual © 2019 SEGGER Microcontroller GmbH
3
Manual versions
This manual describes the current software version. If you find an error in the manual or a
problem in the software, please inform us and we will try to assist you as soon as possible.
Contact us for further information on topics or functions that are not yet documented.
Print date: December 19, 2019
Software Revision Date By Description
6.10 0 200106 FO
New chapter ’AppWizard’
• New function APPW_SetVarData() added.
• New function APPW_GetVarData() added.
Chapter ’Displaying Text’
• New function GUI_GetCharFromPos() added.
Chapter ’2-D Graphic Library’
• New function GUI_BARCODE_Draw() added.
• New function GUI_BARCODE_GetXSize() added.
• New function GUI_DrawGradientVEx() added.
• New function GUI_DrawGradientHEx() added.
• New function GUI_DrawGradientMVEx() added.
• New function GUI_DrawGradientMHEx() added.
• New function GUI_DrawGradientRoundedVEx() added.
• New function GUI_DrawGradientRoundedHEx() added.
• New function GUI_FillRoundedRectEx() added.
• New function GUI_YUV_Create() added.
• New function GUI_YUV_CreateEx() added.
• New function GUI_YUV_Delete() added.
• New function GUI_YUV_DeleteEx() added.
• New function GUI_YUV_GetpData() added.
• New function GUI_YUV_GetpDataEx() added.
• New function GUI_YUV_InvalidateArea() added.
• New function GUI_YUV_SetPeriodEx() added.
• New function GUI_YUV_SetPeriod() added.
Chapter ’Animations’
• New function GUI_ANIM_DeleteAll() added.
• New function GUI_ANIM_GetFirst() added.
• New function GUI_ANIM_GetNext() added.
• New function GUI_ANIM_GetData() added.
• New function GUI_ANIM_IsRunning() added.
• New function GUI_ANIM_GetNumItems() added.
• New function GUI_ANIM_GetItemData() added.
Chapter ’Widgets’
• New ROTARY widget added.
• New SWITCH widget added.
• New function EDIT_GetCharAtPixel() added.
• New function EDIT_GetSel() added.
• New function EDIT_GetSelText() added.
• New function GRAPH_DATA_YT_SetColor() added.
• New function GRAPH_DATA_XY_SetColor() added.
• New function HEADER_GetColumnFromPos() added.
• New function LISTBOX_EnableMotion() added.
• New function LISTVIEW_EnableMotion() added.
• New function MULTIEDIT_GetNumChars() added.
• New function MULTIEDIT_GetTextFromLine() added.
• New function MULTIEDIT_GetTextFromPos() added.
• New function MULTIPAGE_GetTabHeight() added.
• New function MULTIPAGE_GetTabWidth() added.
• New function MULTIPAGE_GetNumTabs() added.
• New function SWIPELIST_IsSepItem() added.
• Fixed a bug with the LISTVIEW widget where column headers would
not move in fixed mode.
• Fixed a bug with LISTWHEEL_SetItemData() that would cause a crash.
• Fixed a bug where if SKINFLEX_PROPS where set only for the SPIN-
BOX_SKINFLEX_PI_FOCUSED state, the lower button wasn’t drawn correctly.
• Fixed a bug where if DROPDOWN was collapsed it was possible to se-
lect disabled item by keyboard.
• Fixed a bug where some widgets in a MULTIPAGE widget wouldn’t get
the focus.
Chapter ’Sprites’
• Fixed a bug where sprites weren’t working with 1bpp bitmaps.
Chapter ’Anti-aliasing’
• Fixed a bug where GUI_AA_DrawLine() didn’t draw a line in a window
properly, added missing WM_ADDORG(x1, y1).
emWin User Guide & Reference Manual © 2019 SEGGER Microcontroller GmbH
4
Software Revision Date By Description
Chapter ’Display Drivers’
• GUIDRV_FlexColor supports UC1698, GUIDRV_FlexColor_Func66725
Chapter ’VNC Server’
• emVNC is now available for MacOS and Linux.
• New functions such as managing last connections, zooming in and out
and fullscreen mode.
5.50 1 191015 FO
Various corrections and improvements.
5.50 0 190528 SC
Chapter ’Displaying Text’
• New function GUI_ShowMissingCharacters() added.
Chapter ’2-D Graphic Library’
• New function GUI_DrawGradientMH() added.
• New function GUI_DrawGradientMV() added.
Chapter ’Memory Devices’
• New function GUI_MEMDEV_CreateCopy() added.
Chapter ’Window Manager’
• New function WM_SetUntouchable() added.
Chapter ’Widgets’
• New function GRAPH_InvertScrollBar() added.
• New function GRAPH_DATA_YT/XY_SetColor() added.
• New function KNOB_SetInvert() added.
• New function KNOB_SetRotateHQ() added.
• New function KNOB_SetRotateLQ() added.
• New function SLIDER_EnableFocusRect() added.
• New function SLIDER_SetInvertDir() added.
• New function SPINBOX_SetTimerPeriod() added.
Chapter ’Display Drivers’
• New driver GUIDRV_SLinEPD added.
• New driver GUIDRV_SSD1322 added.
Chapter ’Configuration’
• New function GUI_AlphaEnableFillRectHW() added.
5.48 0 180611 SC
Chapter ’Displaying Text’
• New function GUI_SetClearTextRectMode() added.
Chapter ’Window Manager’
• New function WM_Rect2Screen() added.
• New function WM_Rect2Client() added.
• New function WM_XY2Screen() added.
• New function WM_XY2Client() added.
Chapter ’Widgets’
• New function LISTBOX_SetFixedScrollPos() added.
Chapter ’Language Support’
• New function GUI_UC_SetEncodeSJIS() added.
Chapter ’Display Drivers’
• New function GUIDRV_FlexColor_SetOrientation() added.
• New function GUIDRV_S1D13781_SetOrientation() added.
• New function GUIDRV_S1D13L01_SetOrientation() added.
• New fucntion LCD_Refresh() added.
• New function LCD_RefreshEx() added.
• New function LCD_ROTATE_AddDriver() added.
• New function LCD_ROTATE_AddDriverEx() added.
• New function LCD_ROTATE_DecSel() added.
• New function LCD_ROTATE_DecSelEx() added.
• New function LCD_ROTATE_IncSel() added.
• New function LCD_ROTATE_IncSelEx() added.
• New function LCD_ROTATE_SetCallback() added.
• New function LCD_ROTATE_SetSel() added.
• New function LCD_ROTATE_SetSelEx() added.
• GUIDRV_FlexColor support for SSD1353 added.
Chapter ’Configuration’
• New function GUI_ALLOC_GetMemInfo() added.
• New function GUI_AA_SetFuncFillCircle() added.
• New function GUI_AA_SetFuncFillPolygon() added.
• New function GUI_AA_SetFuncDrawCircle() added.
• New function GUI_AA_SetFuncDrawLine() added.
• New function GUI_AA_SetFuncDrawPolyOutline() added.
• New function GUI_AA_SetFuncDrawArc() added.
• New function GUI_AA_SetpfStrcmp() added.
• New function GUI_AA_SetpfStrcpy() added.
• New function GUI_AA_SetpfStrlen() added.
5.46 0 171212 SC
Chapter ’Introduction to emWin’
• Support of 64 bit data models added.
Chapter ’Bitmap Converter’
emWin User Guide & Reference Manual © 2019 SEGGER Microcontroller GmbH
5
Software Revision Date By Description
• Description of DTA files added.
Chapter ’The Window Manager (WM)’
• New message WM_SET_CALLBACK added.
• Desktop window (WM_HBKWIN) is able to get user data now.
Chapter ’Widgets (window objects)’
• New functon CHECKBOX_GetImage() added.
• New function HEADER_GetItemText() added.
Chapter ’Display drivers’
• New function LCD_GetVRAMAddr() added.
• New function LCD_GetVRAMAddrEx() added.
• GUIDRV_FlexColor support for HX8367 added.
• GUIDRV_SPage support for UC1628 added.
• GUIDRV_SPage support for ST75320 added.
• GUIDRV_SPage support for SSD1309 added.
Chapter ’Timing- and execution-related functions’
• renamed GUI_Error() to GUI_ErrorOut().
5.44 1 171115 SC
Fixed table description.
5.44 0 171020 SC
Chapter ’emWin SPY’
• New function GUI_SPY_StartServerEx() added.
Chapter ’2-D Graphic Library’
• New function GUI_SPLINE_Create() added.
• New function GUI_SPLINE_Draw() added.
• New function GUI_SPLINE_Delete() added.
• New function GUI_SPLINE_GetY() added.
• New function GUI_SPLINE_GetXSize() added.
• New function GUI_SPLINE_DrawAA() added.
Chapter ’Displaying bitmap files’
• New function GUI_JPEG_SetpfDrawEx() added.
Chapter ’Movies’
• New function GUI_MOVIE_SetpfNotify() added.
• New functionality of displaying AVI files added.
Chapter ’The Window Manager (WM)’
• New message WM_USER_DATA added.
Chapter ’Widgets’
• New function EDIT_GetTextAlign() added.
Chapter ’Anti-aliasing’
• New function GUI_AA_DrawCircle() added.
Chapter ’Display drivers’
• New driver GUIDRV_SH_MEM_3 added.
• GUIDRV_FlexColor support for ST7775 added.
• New function GUIDRV_SPage_SetUC1610() added.
• GUIDRV_1611 removed, covered by GUIDRV_SPage.
Chapter ’Configuration’
• New function GUI_ALLOC_GetMaxUsedBytes() added.
• New function GUI_RegisterAfterInitHook() added.
• New functionality, interface for JPEG hardware support.
5.42 0 170731 SC
Chapter ’Displaying Text’
• New function GUI_DispStringInRectWrapEx() added.
• New function GUI_SetStrikeWidth() added.
Chapter ’2-D Graphic Library’
• New function GUI_AddRect() added.
Chapter ’Bitmap Converter’
• Description about options dialog
Chapter ’Widgets’
• New function CHECKBOX_GetBkColor() added.
• New function CHECKBOX_GetBoxBkColor() added.
• New function CHECKBOX_GetFocusColor() added.
• New function CHECKBOX_GetFont() added.
• New function CHECKBOX_GetTextAlign() added.
• New function CHECKBOX_GetTextColor() added.
• New function DROPDOWN_GetBkColor() added.
• New function DROPDOWN_GetColor() added.
• New function DROPDOWN_GetFont() added.
• New function DROPDOWN_GetTextColor() added.
• New function GRAPH_GetColor() added.
• New function HEADER_GetFont() added.
• New function ICONVIEW_GetBkColor() added.
• New function ICONVIEW_GetFont() added.
• New function ICONVIEW_GetTextColor() added.
• New function ICONVIEW_GetReleasedItem() added.
• New function LISTBOX_GetBkColor() added.
emWin User Guide & Reference Manual © 2019 SEGGER Microcontroller GmbH
评论0