Graphical User Interface
with Graphic Library
Version 4.12
Manual Rev. 0
Micriµm
www.micrium.com
Empowering Embedded Systems
2
User's & reference manual for μC/GUI © 2002-2007 Micrium
Disclaimer
Specifications written in this manual are believed to be accurate, but are not guaran-
teed to be entirely free of error. Specifications in this manual may be changed for
functional or performance improvements without notice. Please make sure your man-
ual is the latest edition. While the information herein is assumed to be accurate,
Micrium Technologies Corporation (the distributor) assumes no responsibility for any
errors or omissions and makes no warranties. The distributor specifically disclaims
any implied warranty of fitness for a particular purpose.
Copyright notice
The latest version of this manual is available as PDF file in the download area of our
website at www.micrium.com. You are welcome to copy and distribute the file as well
as the printed version. You may not extract portions of this manual or modify the PDF
file in any way without the prior written permission of Micrium Technologie Corpora-
tion. 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.
© 2002-2007 Micrium, Weston, Florida 33327-1848, U.S.A.
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 please provide the following information:
• Your full name and the name of your supervisor
• Your company name
• Your job title
• Your email address and telephone number
• Company name and address
• Your company's main phone number
• Your company's web site address
• Name and version of the product
Please send this information to: licensing@micrium.com
Contact address
Micrium Technologies Corporation
949 Crestview Circle
Weston, FL 33327-1848
U.S.A.
Phone : +1 954 217 2036
FAX : +1 954 217 2037
WEB : www.micrium.com
Email : support@micrium.com
User's & reference manual for μC/GUI © 2002-2007 Micrium
3
Manual versions
This manual describes the latest software version. The software version number can
be found in the table ’Software versions’ later in this chapter. If any error occurs,
please inform us and we will try to help you as soon as possible.
For further information on topics or routines not yet specified, please contact us.
Print date: October 9, 2007
4
User's & reference manual for μC/GUI © 2002-2007 Micrium
Manual
version
Date By Explanation
4.12R0 070920 JE
Chapter 7: 2-D Graphic Library
- Functions GUI_DrawPie() and GUI_SetPenSize() added.
Chapter 10: Bitmap Converter
- New 24 bpp format substitutes 888 and M888 format.
Chapter 12: Memory Devices
- 32bpp memory devices added.
Chapter 14: Window manager
- Function WM_SendMessageNoPara() added.
- Function WM_IsCompletelyCovered() added.
Chapter 15: Widgets
- EDIT_SetFloatMode: GUI_EDIT_SUPPRESS_LEADING_ZEROES added.
- GRAPH: New functions for detaching data and scales added.
- FRAMEWIN: New functions for getting bar color and state added.
Chapter 21: Sprites (NEW)
- Software sprites have been added to µC/GUI.
Chapter 25: Display Drivers
- Support for Epson S1D15E06 added to LCD1611.
- Support for Ilitec ILI9161 & ILI9220 added to LCD667XX.
- Support for Solomon SSD1848 added to LCD13700.
- Support for UltraChip UC1608 added to LCDPage1bpp.
- Config option LCD_FIRSTPIXEL0 added to LCD7529.
- Config options of LCD6331 reworked.
4.10R1 070801 JE
Chapter 29: Performance and Resource Usage
- Section ’Memory requirements’ reworked.
4.10R0 070511 JE
Chapter 7: 2-D Graphic Library
- Functions for drawing color gradients added.
Chapter 9: Fonts
- Rough file format description added.
- New font type for using framed fonts added.
- Sample how to declare font prototypes added.
- XBF format available for extended proportional bitmap fonts.
Chapter 10: Bitmap Converter
- New function for saving the palette available.
- Subchapter ’Using a custom palette’ reworked.
Chapter 14: Window Manager
- Explanation of WM_BroadcastMessage() extended.
Chapter 15: Widgets
- EDIT_SetTextColor: Meaning of parameter ’Index’ changed.
Chapter 18: Multi layer / multi display support
- Descriptionadded of how to realize run time display rotation.
Chapter 23: Foreign Language Support
- Character mirroring for RLT aligned text supported.
Chapter 24: Display Drivers
- Support for Solomon SSD1289, Toshiba JBT6K71, Sharp LCY-A06003,
Samsung S6D0129, MagnaChip D54E4PA7551 and Himax HX8312 added
to LCD667XX driver.
- Support for Ultrachip UC1617 added to LCD13700 driver.
- LCD_CONTROLLER configuration changed for Epson S1D13701, Hitachi
HD66750 and Hitachi HD66753
- LCDLin: New driver variant available for 32/16/8 bit access.
Chapter 27: Low level configuration
- Multiple controller configuration reworked.
Chapter 28: High level configuration
- Explanation of GUI_SUPPORT_CURSOR added.
User's & reference manual for μC/GUI © 2002-2007 Micrium
5
4.08R0 070131 JE
Chapter 7: 2-D Graphic library
- Support for general software alpha blending added.
- Support for drawing alpha bitmaps on multi layer systems added.
Chapter 10: Bitmap converter
- Support for creating alpha blending bitmaps added.
Chapter 15: Widgets
- Blinking cursors added to MULTIEDIT and EDIT widget.
- New functions and new notification messages added to MENU widget.
Chapter 24: Display drivers
- Support for Renesas R61509 and R63401 added to LCD667XX.
- 24 and 32 bpp mode added to LCDLin
- Support for Sitronix ST7522 added to LCDPage1bpp
4.06R0 061006 JE
Chapter 6: Displaying values
- Number of digits in GUI_DispDec...() increased to 10.
Chapter 8: Displaying bitmap files
- BMP files: Support for RLE4, RLE8 and 16bpp format added.
Chapter 9: Fonts
- Introduction reworked.
- TrueType support added.
- Explanation of GUI_MAX_XBF_BYTES added.
- New fonts added.
Chapter 10: Bitmap converter
- Description of supported ’C’ file formats added.
Chapter 11: Colors
- New fixed palette mode 5 added.
- Table of default fixed palette modes added.
Chapter 14: Window manager
- Timer message added.
- Timer functions added.
Chapter 15: Widgets
- DROPDOWN: Functions added to manage the disable state of items.
Chapter 18: Multi layer support
- New functions for managing hardware cursors added.
Chapter 24: Display drivers
- LCD7529 now works without cache and in 4bpp mode.
Chapter 29: Performance and Resource usage
- Table of image drawing performance added.
4.04R1 060519 JE
Chapter 24: Display drivers
- Driver LCD15E05 removed.
- Support for Epson S1D15E05 and S1D15719 added to LCD1611 driver.
4.04R0 060505 JE
Chapter 15: Widgets
- Function added to set the rotation mode of a MULTIPAGE widget.
Manual
version
Date By Explanation