emWin
Graphic Library with
Graphical User Interface
Version 5.12
Manual Rev. 0
www.segger.com
solutions for embedded software
2 CHAPTER
User's & reference manual for emWin V5.10 © 1997 - 2011 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 (the manufacturer) assumes no
responsibility for any errors or omissions. The manufacturer makes and you receive
no warranties or conditions, express, implied, statutory or in any communication with
you. The manufacturer 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 the manufacturer. The software described in this doc-
ument is furnished under a license and may only be used or copied in accordance
with the terms of such a license.
© 2011 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.
Registration
Please register the software via email. This way we can make sure you will receive
updates or notifications of updates as soon as they become available.
For registration, provide the following:
• Company name and address
•Your name
• Your job title
• Your email address and telephone number
• Name and version of the product
Please send this information to: register@segger.com
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 latest software version. The version number of the soft-
ware can be found in the table ’Software versions’ later in this chapter. If any error
occurs, inform us and we will try to assist you as soon as possible.
For further information on topics or routines not yet specified, contact us.
Print date: 6/28/11
User's & reference manual for emWin V5.10 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG
3
Version Date By Description
5.12R0 110621
AS
JE
Chapter 17 ’Window Objects (Widgets)’
- New function LISTVIEW_SetHeaderHeight() added.
- New function ICONVIEW_AddStreamedBitmapItem() added.
- New function ICONVIEW_GetItemText() added.
- New function ICONVIEW_GetItemUserData() added.
- New function ICONVIEW_GetNumItems() added.
- New function ICONVIEW_InsertBitmapItem() added.
- New function ICONVIEW_InsertStreamedBitmapItem() added.
- New function ICONVIEW_SetBitmapItem() added.
- New function ICONVIEW_SetFrame() added.
- New function ICONVIEW_SetItemText() added.
- New function ICONVIEW_SetItemUserData() added.
- New function ICONVIEW_SetSpace() added.
- New function ICONVIEW_SetStreamedBitmapItem() added.
- New function ICONVIEW_SetTextAlign() added.
- New function TEXT_GetNumLines() added.
Chapter 30 ’Display Drivers’
- New display driver added:
GUIDRV_Dist
GUIDRV_SPage
- New display controller supported by GUIDRV_CompactColor_16:
66709: Solomon SSD1961
- LCD_SetDevFunc(): LCD_DEVFUNC_COPYRECT added.
- GUIDRV_Lin: Support for LCD_DEVFUNC_COPYRECT added.
5.10R1 110531
AS
JE
Chapter 30 ’Display Drivers
- New display driver: GUIDRV_FlexColor
5.10R0 110329
AS
JE
Chapter 14 ’Memory Devices’
- Default for GUI_USE_MEMDEV_1BPP_FOR_SCREEN is 1.
- New function GUI_MEMDEV_MarkDirty() added.
Chapter 19 ’GUIBuilder’ added.
Chapter 30 ’Display Drivers’
- New display controllers supporter by GUIDRV_CompactColor_16:
66708: Ilitek ILI9328
66709: Sitronix ST7715
66772: Ilitek ILI9221
- New function GUIDRV_BitPlains_Config() added.
4 CHAPTER
User's & reference manual for emWin V5.10 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG
5.08R0 110112
AS
JE
Chapter 9 ’2D Graphic Library’
- New function GUI_CreateBitmapFromStreamRLEAlpha() added.
- New function GUI_CreateBitmapFromStreamRLE32() added.
- Function GUI_CreateBitmapFromStream() supports additional formats.
- New function GUI_UC_EnableBIDI() added.
Chapter 12 ’Bitmap Converter’
- New format 'Alpha channel, compressed' added.
- New format 'True color with alpha channel, compressed' added.
- New function 'Image/Convert Into/Best Palette + transparency' added.
Chapter 14 ’Memory Devices’
- New function GUI_MEMDEV_SetAnimationCallback() added.
- New function GUI_MEMDEV_ShiftInWindow() added.
- New function GUI_MEMDEV_ShiftOutWindow() added.
Chapter 15 ’Execution Model’
- New function GUI_SetSignalEventFunc() added.
- New function GUI_SetWaitEventFunc() added.
- New function GUI_SetWaitEventTimedFunc() added.
- Definitions of compile time configuration macros changed.
Chapter 16 ’Window manager’
- New function WM_MULTIBUF_Enable() added.
- New messages WM_PRE_PAINT and WM_POST_PAINT added.
Chapter 17 ’Widgets’
- LISTVIEW_SetUserData() renamed o LISTVIEW_SetUserDataRow().
- LISTVIEW_GetUserData() renamed o LISTVIEW_GetUserDataRow().
- New function <WIDGET>_SetUserData added for all widgets.
- New function <WIDGET>_GetUserData added for all widgets.
- New function <WIDGET>_CreateUser added for all widgets.
- New function BUTTON_GetTextAlign() added.
- New function BUTTON_SetReactOnLevel() added.
- New function ICONVIEW_CreateIndirect() added.
- New function ICONVIEW_DeleteItem() added.
- New function LISTWHEEL_CreateIndirect() added.
- New function SCROLLBAR_SetThumbSizeMin() added.
- New function SCROLLBAR_GetThumbSizeMin() added.
- New function TREEVIEW_ITEM_CollapseAll() added.
- New function TREEVIEW_ITEM_ExpandAll() added.
Chapter 19 ’Skinning’
- New compile time configuration macro WIDGET_USE_FLEX_SKIN added.
- New message WIDGET_ITEM_GET_RADIUS added to frame window skin.
Chapter 20 ’Multiple buffering’.
- New function GUI_MULTIBUF_Begin() added.
- New function GUI_MULTIBUF_End() added.
- New function GUI_MULTIBUF_Config() added.
5.06R0 100907 JE
Chapter 9 ’Fonts’:
- New function GUI_SetDefaultFont() added.
Chapter 12 ’Memory Devices’:
- New function GUI_MEMDEV_FadeDevices() added.
Chapter 15 ’Widgets’:
- New function SCROLLBAR_GetNumItems() added.
- New function SCROLLBAR_GetPageSize() added.
- New function BUTTON_SetReactOnLevel() added.
- New function LISTWHEEL_SetPos() added.
- New function GRAPH_DATA_XY_SetOwnerDraw() added.
- New function LISTVIEW_SetItemBitmap() added.
New chapter 17 ’Skinning’:
- Skinning for the most common widgets added.
Chapter 26 ’Display Driver’:
- New function GUI_SetOrientation() added (rotation device).
- New OXY-orientations for 16, 24 and 32 bpp added to GUIDRV_Lin.
5.04R2 100526 AS
- New function LISTVIEW_SetItemBitmap() in Chapter ’Widgets’
- New function GRAPH_DATA_XY_SetOwnerDraw() in Chapter ’Widgets’
- New function GUI_SetDefaultFont() in Chapter ’Fonts’
- New function GUI_GetPixelIndex() in Chapter ’2-D Graphic Library’
- New function GUITASK_SetMaxTask() in Chapter ’Execution Model’
- GUIDRV_CompactColor_16:
Support for the following display controllers added:
Himax HX8353, LGDP4551, Orisetech SPFD54124C, Renesas R61505,
Sitronix ST7735 and ST7787, Solomon SSD1284 and SSD2119.
- Added driver macros to each driver which uses them.
Version Date By Description
User's & reference manual for emWin V5.10 © 1997 - 2011 SEGGER Microcontroller GmbH & Co. KG
5
5.04R1 100505 AS
Drivers ’GUIDRV_S1D15G00’ and ’GUIDRV_SLin’ added
Various corrections
Chapter ’2-D Graphic Library’:
- New function GUI_DrawGradientRoundedV()
- New function GUI_DrawGradientRoundedH()
- New function GUI_DrawRoundedFrame()
Chapter ’Memory Devices’:
- New function GUI_MEMDEV_MoveInWindow()
- New function GUI_MEMDEV_MoveOutWindow()
- New function GUI_MEMDEV_FadeInWindow()
- New function GUI_MEMDEV_FadeOutWindow()
Chapter ’Simulation’
- New function SIM_GUI_SetCallback()
- New function SIM_GUI_ShowDevice()
5.04R0 100104 JE
Chapter 26 ’VNC Server’:
- New function GUI_VNC_EnableKeyboardInput() added.
- New function GUI_VNC_GetNumConnections() added.
- New function GUI_VNC_SetPassword() added.
- New function GUI_VNC_SetProgName() added.
- New function GUI_VNC_SetSize() added.
- New function GUI_VNC_RingBell() added.
Version Date By Description
- 1
- 2
- 3
- 4
- 5
- 6
前往页