www.pudn.com > ucosv2(GUI).rar > GUI.H
/*
*********************************************************************************************************
* uC/GUI
* Universal graphic software for embedded applications
*
* (c) Copyright 2002, Micrium Inc., Weston, FL
* (c) Copyright 2002, SEGGER Microcontroller Systeme GmbH
*
* µC/GUI is protected by international copyright laws. Knowledge of the
* source code may not be used to write a similar product. This file may
* only be used in accordance with a license and should not be redistributed
* in any way. We appreciate your understanding and fairness.
*
----------------------------------------------------------------------
File : GUI.H
Purpose : Include file for 2DGL incl. character related routines.
---------------------------END-OF-HEADER------------------------------
Attention : Do not modify this file ! If you do, you will not
be able do update to a later version of emWin !
*/
#ifndef GUI_H
#define GUI_H
#define __EMWIN_GSC__ /* Allow "C" to find out that emWin GSC is used */
#if defined(__cplusplus)
extern "C" { /* Make sure we have C-declarations in C++ programs */
#endif
#include "GUITYPE.H"
#include "GUICONF.H"
#if GUI_WINSUPPORT
#include "WM.h"
#endif
#define GUI_VERSION 32404
/**********************************************************************
*
* Defaults for config switches
*
***********************************************************************
*/
#ifndef GUI_SUPPORT_TOUCH
#define GUI_SUPPORT_TOUCH 0
#endif
#ifndef GUI_SUPPORT_MOUSE
#define GUI_SUPPORT_MOUSE 0
#endif
#ifndef GUI_SUPPORT_MEMDEV
#define GUI_SUPPORT_MEMDEV 0
#endif
#ifndef GUI_SUPPORT_CURSOR
#define GUI_SUPPORT_CURSOR GUI_SUPPORT_MOUSE
#endif
#ifndef GUI_OS
#define GUI_OS 0
#endif
#ifndef GUI_DEFAULT_FONT
#define GUI_DEFAULT_FONT &GUI_Font6x8
#endif
#ifndef GUI_DEFAULT_BKCOLOR
#define GUI_DEFAULT_BKCOLOR GUI_BLACK
#endif
#ifndef GUI_DEFAULT_COLOR
#define GUI_DEFAULT_COLOR GUI_WHITE
#endif
#ifndef GUI_SUPPORT_UNICODE
#define GUI_SUPPORT_UNICODE 0
#endif
/* In order to avoid warnings for undefined parameters */
#ifndef GUI_USE_PARA
#ifdef __BORLANDC__
#define GUI_USE_PARA(para)
#else
#define GUI_USE_PARA(para) para=para;
#endif
#endif
/* GUI_FLASH allows to put constants into a special memory area
For most CPUs, this is not necessary hence the default is "".
(This makes sense for CPUs like ATMEL AT90 or 8051, where
default pointers are unable to reach ROM/FLASH memory in some
memory models)
*/
#ifndef GUI_FLASH
#define GUI_FLASH
#endif
#ifndef GUI_FAR
#define GUI_FAR
#endif
/* Default for types */
#ifndef GUI_TIMER_TIME
#define GUI_TIMER_TIME int /* default is to use 16 bits for 16 bit CPUs,
32 bits on 32 bit CPUs for timing */
#endif
#ifndef GUI_COMPATIBLE_MODE
#define GUI_COMPATIBLE_MODE 1
#endif
/*********************************************************************
*
* Limitations for certain C51 Keil (__C51__)
*
**********************************************************************
*/
#if defined (__C51__) && GUI_SUPPORT_MEMDEV
#error __C51__ (Keil) can not support function pointers sufficiently ! -> Disable memory devices -> GUI_SUPPORT_MEMDEV 0
#endif
/*********************************************************************
*
* macros, function replacement
*
**********************************************************************
*/
#define GUI_COUNTOF(a) (sizeof(a) / sizeof(a[0]))
/************************************************************
*
* GUI_KEY_...
*
*************************************************************
These ID values are basically meant to be used with widgets
*/
#define GUI_KEY_BACKSPACE 8 /* ASCII: BACKSPACE Crtl-H */
#define GUI_KEY_TAB 9 /* ASCII: TAB Crtl-I */
#define GUI_KEY_ENTER 13 /* ASCII: ENTER Crtl-M */
#define GUI_KEY_LEFT 16
#define GUI_KEY_UP 17
#define GUI_KEY_RIGHT 18
#define GUI_KEY_DOWN 19
#define GUI_KEY_HOME 23
#define GUI_KEY_END 24
#define GUI_KEY_SHIFT 25
#define GUI_KEY_CONTROL 26
#define GUI_KEY_ESCAPE 27 /* ASCII: ESCAPE 0x1b */
#define GUI_KEY_INSERT 29
#define GUI_KEY_DELETE 30
/*********************************************************************
*
* Dialog item IDs
*
* The IDs below are arbitrary values. They just have to be unique
* within the dialog.
*
* If you use your own Ids, we recommend to use values above GUI_ID_USER.
*/
#define GUI_ID_OK 1
#define GUI_ID_CANCEL 2
#define GUI_ID_YES 3
#define GUI_ID_NO 4
#define GUI_ID_CLOSE 5
#define GUI_ID_HELP 6
#define GUI_ID_VSCROLL 0xFE
#define GUI_ID_HSCROLL 0xFF
#define GUI_ID_EDIT0 0x100
#define GUI_ID_EDIT1 0x101
#define GUI_ID_EDIT2 0x102
#define GUI_ID_EDIT3 0x103
#define GUI_ID_EDIT4 0x104
#define GUI_ID_EDIT5 0x105
#define GUI_ID_EDIT6 0x106
#define GUI_ID_EDIT7 0x107
#define GUI_ID_EDIT8 0x108
#define GUI_ID_EDIT9 0x109
#define GUI_ID_LISTBOX0 0x110
#define GUI_ID_LISTBOX1 0x111
#define GUI_ID_LISTBOX2 0x112
#define GUI_ID_LISTBOX3 0x113
#define GUI_ID_LISTBOX4 0x114
#define GUI_ID_LISTBOX5 0x115
#define GUI_ID_LISTBOX6 0x116
#define GUI_ID_LISTBOX7 0x117
#define GUI_ID_LISTBOX8 0x118
#define GUI_ID_LISTBOX9 0x119
#define GUI_ID_CHECK0 0x120
#define GUI_ID_CHECK1 0x121
#define GUI_ID_CHECK2 0x122
#define GUI_ID_CHECK3 0x123
#define GUI_ID_CHECK4 0x124
#define GUI_ID_CHECK5 0x125
#define GUI_ID_CHECK6 0x126
#define GUI_ID_CHECK7 0x127
#define GUI_ID_CHECK8 0x128
#define GUI_ID_SLIDER0 0x130
#define GUI_ID_SLIDER1 0x131
#define GUI_ID_SLIDER2 0x132
#define GUI_ID_SLIDER3 0x133
#define GUI_ID_SLIDER4 0x134
#define GUI_ID_SLIDER5 0x135
#define GUI_ID_SLIDER6 0x136
#define GUI_ID_SLIDER7 0x137
#define GUI_ID_SLIDER8 0x138
#define GUI_ID_SLIDER9 0x139
#define GUI_ID_SCROLLBAR0 0x140
#define GUI_ID_SCROLLBAR1 0x141
#define GUI_ID_SCROLLBAR2 0x142
#define GUI_ID_SCROLLBAR3 0x142
#define GUI_ID_RADIO0 0x150
#define GUI_ID_RADIO1 0x151
#define GUI_ID_RADIO2 0x152
#define GUI_ID_RADIO3 0x152
#define GUI_ID_USER 0x800
/*********************************************************************
*
* Constants needed for GL
*
**********************************************************************
*/
/* *********************************
*
* Linestyles
*
*********************************
*/
#define GUI_LS_SOLID (0)
#define GUI_LS_DASH (1)
#define GUI_LS_DOT (2)
#define GUI_LS_DASHDOT (3)
#define GUI_LS_DASHDOTDOT (4)
/* *********************************
*
* Pen shapes
*
*********************************
*/
#define GUI_PS_ROUND (0)
#define GUI_PS_FLAT (1)
#define GUI_PS_SQUARE (2)
/* *********************************
*
* Standard colors
*
*********************************
*/
#define GUI_BLACK 0x000000
#define GUI_BLUE 0xFF0000
#define GUI_GREEN 0x00ff00
#define GUI_CYAN 0xffff00
#define GUI_RED 0x0000FF
#define GUI_MAGENTA 0x8b008b
#define GUI_BROWN 0x2a2aa5
#define GUI_DARKGRAY 0x404040
#define GUI_GRAY 0x808080
#define GUI_LIGHTGRAY 0xd3d3d3
#define GUI_LIGHTBLUE 0xff8080
#define GUI_LIGHTGREEN 0x80ff80
#define GUI_LIGHTCYAN 0x80ffff
#define GUI_LIGHTRED 0x8080ff
#define GUI_LIGHTMAGENTA 0xff80ff
#define GUI_YELLOW 0x00ffff
#define GUI_WHITE 0xffffff
#define GUI_INVALID_COLOR 0xfffffff /* Invalid color - more than 24 bits */
/* *********************************
*
* Coordinates
*
*********************************
*/
#define GUI_COORD_X 0
#define GUI_COORD_Y 1
/* *********************************
*
* UNICODE support macros
*
*********************************
*/
#define GUI_UC_STARTCHAR 0x1a
#define GUI_UC_ENDCHAR 0xe2
#define GUI_UC_STARTSTRING "\x1a"
#define GUI_UC_ENDSTRING "\xe2"
#define GUI_UC_START GUI_UC_STARTSTRING
#define GUI_UC_END GUI_UC_ENDSTRING
#define GUI_UC_NL "\xe0\x0a"
/*********************************************************************
*
* Standard Fonts supplied with emWin
*
**********************************************************************
Note: The external declarations for the fonts are now also included in
this file.
*/
/* Proportional fonts */
extern const GUI_FONT GUI_Font8_ASCII, GUI_Font8_1;
extern const GUI_FONT GUI_Font10S_ASCII, GUI_Font10S_1;
extern const GUI_FONT GUI_Font10_ASCII, GUI_Font10_1;
extern const GUI_FONT GUI_Font13_ASCII, GUI_Font13_1;
extern const GUI_FONT GUI_Font13B_ASCII, GUI_Font13B_1;
extern const GUI_FONT GUI_Font13H_ASCII, GUI_Font13H_1;
extern const GUI_FONT GUI_Font13HB_ASCII, GUI_Font13HB_1;
extern const GUI_FONT GUI_Font16_ASCII, GUI_Font16_1, GUI_Font16_HK, GUI_Font16_1HK;
extern const GUI_FONT GUI_Font16B_ASCII, GUI_Font16B_1;
extern const GUI_FONT GUI_Font24_ASCII, GUI_Font24_1;
extern const GUI_FONT GUI_Font24B_ASCII, GUI_Font24B_1;
extern const GUI_FONT GUI_Font32_ASCII, GUI_Font32_1;
extern const GUI_FONT GUI_Font32B_ASCII, GUI_Font32B_1;
/* Monospaced */
extern const GUI_FONT GUI_Font4x6;
extern const GUI_FONT GUI_Font6x8, GUI_Font6x9;
extern const GUI_FONT GUI_Font8x8, GUI_Font8x9;
extern const GUI_FONT GUI_Font8x10_ASCII;
extern const GUI_FONT GUI_Font8x12_ASCII;
extern const GUI_FONT GUI_Font8x13_ASCII, GUI_Font8x13_1;
extern const GUI_FONT GUI_Font8x15B_ASCII, GUI_Font8x15B_1;
extern const GUI_FONT GUI_Font8x16, GUI_Font8x17, GUI_Font8x18;
extern const GUI_FONT GUI_Font8x16x1x2, GUI_Font8x16x2x2, GUI_Font8x16x3x3;
/* Digits */
extern const GUI_FONT GUI_FontD24x32;
extern const GUI_FONT GUI_FontD32;
/* Comic fonts */
extern const GUI_FONT GUI_FontComic18B_ASCII, GUI_FontComic18B_1;
extern const GUI_FONT GUI_FontComic24B_ASCII, GUI_FontComic24B_1;
/*
*********************************
* *
* Text and drawing mode defines *
* *
*********************************
These defines come in two flavors: the long version (.._DRAWMODE_..)
and the short ones (.._DM_..). They are identical, feel free to use
which ever one you like best.
*/
#define GUI_DRAWMODE_NORMAL LCD_DRAWMODE_NORMAL
#define GUI_DRAWMODE_XOR LCD_DRAWMODE_XOR
#define GUI_DRAWMODE_TRANS LCD_DRAWMODE_TRANS
#define GUI_DRAWMODE_REV LCD_DRAWMODE_REV
#define GUI_DM_NORMAL LCD_DRAWMODE_NORMAL
#define GUI_DM_XOR LCD_DRAWMODE_XOR
#define GUI_DM_TRANS LCD_DRAWMODE_TRANS
#define GUI_DM_REV LCD_DRAWMODE_REV
#define GUI_TEXTMODE_NORMAL LCD_DRAWMODE_NORMAL
#define GUI_TEXTMODE_XOR LCD_DRAWMODE_XOR
#define GUI_TEXTMODE_TRANS LCD_DRAWMODE_TRANS
#define GUI_TEXTMODE_REV LCD_DRAWMODE_REV
#define GUI_TM_NORMAL LCD_DRAWMODE_NORMAL
#define GUI_TM_XOR LCD_DRAWMODE_XOR
#define GUI_TM_TRANS LCD_DRAWMODE_TRANS
#define GUI_TM_REV LCD_DRAWMODE_REV
/* Text alignment flags, horizontal */
#define GUI_TA_HORIZONTAL (3<<0)
#define GUI_TA_LEFT (0<<0)
#define GUI_TA_RIGHT (1<<0)
#define GUI_TA_CENTER (2<<0)
#define GUI_TA_HCENTER GUI_TA_CENTER /* easier to remember :-) */
/* Text alignment flags, vertical */
#define GUI_TA_VERTICAL (3<<2)
#define GUI_TA_TOP (0<<2)
#define GUI_TA_BOTTOM (1<<2)
#define GUI_TA_BASELINE (2<<2)
#define GUI_TA_VCENTER (3<<2)
/* *********************************
*
* Min/Max coordinates
*
*********************************
*/
/* Define minimum and maximum coordinates in x and y */
#define GUI_XMIN -4095
#define GUI_XMAX 4095
#define GUI_YMIN -4095
#define GUI_YMAX 4095
/*********************************************************************
*
* GUI_CONTEXT
*
**********************************************************************
This structure is public for one reason only:
To allow the application to save and restore the context.
*/
typedef union {
U8 aColorIndex8[2];
U16 aColorIndex16[2];
} LCD_COLORINDEX_UNION;
typedef struct GUI_Context_struct GUI_CONTEXT;
#if !defined (__C51__) /* To bypass Keil-compiler bug */
typedef struct tLCDDEV_APIList_struct tLCDDEV_APIList;
#endif
struct GUI_Context_struct {
/* Variables in LCD module */
LCD_COLORINDEX_UNION LCD;
LCD_RECT ClipRect;
const tLCD_HL_APIList* pLCD_HL;
U8 DrawMode;
/* Variables in GL module */
GUI_RECT* pClipRect_HL;
U8 PenSize;
U8 PenShape;
U8 LineStyle;
U8 FillStyle;
/* Variables in GUICHAR module */
const GUI_FONT* pAFont;
I16P LBorder;
I16P DispPosX, DispPosY;
I16P DrawPosX, DrawPosY;
I16P TextMode;
I16P TextAlign;
/* Variables in WM module */
#if GUI_WINSUPPORT
const GUI_RECT* WM__pUserClipRect;
GUI_HWIN hAWin;
#endif
/* Variables in MEMDEV module (with memory devices only) */
#if GUI_SUPPORT_MEMDEV
const tLCDDEV_APIList* pDeviceAPI; /* function pointers only */
GUI_HMEM hDevData;
GUI_RECT ClipRectPrev;
#endif
/* Variables Anitaliasing module */
U8 AA_Factor;
U8 AA_HiResEnable;
};
/*********************************************************************
*
* General routines
*
**********************************************************************
*/
int GUI_Init(void);
void GUI_SetDefault(void);
GUI_DRAWMODE GUI_SetDrawMode(GUI_DRAWMODE dm);
const char * GUI_GetVersionString(void);
void GUI_SaveContext ( GUI_CONTEXT* pContext);
void GUI_RestoreContext(const GUI_CONTEXT* pContext);
/*********************************************************************
*
* Rectangle helper functions
*
***********************************************************************
*/
int GUI_RectsIntersect(const GUI_RECT* pr0, const GUI_RECT* pr1);
void GUI_MoveRect (GUI_RECT *pRect, int x, int y);
void GUI_MergeRect (GUI_RECT* pDest, const GUI_RECT* pr0, const GUI_RECT* pr1);
int GUI__IntersectRects(GUI_RECT* pDest, const GUI_RECT* pr0, const GUI_RECT* pr1);
void GUI__IntersectRect (GUI_RECT* pDest, const GUI_RECT* pr0);
void GUI__ReduceRect (GUI_RECT* pDest, const GUI_RECT *pRect, int Dist);
/*********************************************************************
*
* Misc helper functions
*
***********************************************************************
*/
int GUI__DivideRound (int a, int b);
/*********************************************************************
*
* Get / Set Attributes
*
**********************************************************************
*/
GUI_COLOR GUI_GetBkColor (void);
GUI_COLOR GUI_GetColor (void);
int GUI_GetBkColorIndex(void);
int GUI_GetColorIndex (void);
U8 GUI_GetPenSize (void);
U8 GUI_GetLineStyle (void);
U8 GUI_GetFillStyle (void);
void GUI_SetBkColor (GUI_COLOR);
void GUI_SetColor (GUI_COLOR);
void GUI_SetBkColorIndex(int Index);
void GUI_SetColorIndex(int Index);
U8 GUI_SetPenSize (U8 Size);
U8 GUI_SetPenShape (U8 Shape);
U8 GUI_SetLineStyle (U8 Style);
U8 GUI_SetFillStyle (U8 Style);
/* Get/Set Character used as decimal point (usually '.' or ',') */
char GUI_GetDecChar(void);
char GUI_SetDecChar(char c);
/*********************************************************************
*
* Color / Index related functions
*
**********************************************************************
*/
int GUI_Color2Index(GUI_COLOR color);
GUI_COLOR GUI_Color2VisColor(GUI_COLOR color);
char GUI_ColorIsAvailable(GUI_COLOR color);
GUI_COLOR GUI_Index2Color(int Index);
void GUI_InitLUT(void);
void GUI_SetLUTEntry (U8 Pos, GUI_COLOR Color);
void GUI_SetLUTColor (U8 Pos, GUI_COLOR Color);
void GUI_SetPhysColor(U8 Pos, GUI_COLOR Color);
/*********************************************************************
*
* Logging
*
**********************************************************************
*/
void GUI_Log (const char *s);
void GUI_Log1 (const char *s, int p0);
void GUI_Log2 (const char *s, int p0, int p1);
void GUI_Log3 (const char *s, int p0, int p1, int p2);
void GUI_Log4 (const char *s, int p0, int p1, int p2,int p3);
void GUI_Warn (const char *s);
void GUI_Warn1 (const char *s, int p0);
void GUI_Warn2 (const char *s, int p0, int p1);
void GUI_Warn3 (const char *s, int p0, int p1, int p2);
void GUI_Warn4 (const char *s, int p0, int p1, int p2, int p3);
void GUI_ErrorOut (const char *s);
void GUI_ErrorOut1(const char *s, int p0);
void GUI_ErrorOut2(const char *s, int p0, int p1);
void GUI_ErrorOut3(const char *s, int p0, int p1, int p2);
void GUI_ErrorOut4(const char *s, int p0, int p1, int p2, int p3);
/*********************************************************************
*
* 2d - GUI
*
**********************************************************************
*/
void GUI_Clear (void);
void GUI_ClearRect (int x0, int y0, int x1, int y1);
void GUI_DrawArc (int x0, int y0, int rx, int ry, int a0, int a1);
void GUI_DrawBitmap (const GUI_BITMAP* pBM, int x0, int y0);
void GUI_DrawBitmapMag (const GUI_BITMAP* pBM, int x0, int y0, int XMul, int YMul);
void GUI_DrawBitmapExp (int x0, int y0, int XSize, int YSize, int XMul, int YMul,
int BitsPerPixel, int BytesPerLine,
const U8* pData, const GUI_LOGPALETTE* pPal);
void GUI_DrawCircle (int x0, int y0, int r);
void GUI_DrawEllipse (int x0, int y0, int rx, int ry);
void GUI_DrawGraph (I16 *pay, int NumPoints, int x0, int y0);
void GUI_DrawHLine (int y0, int x0, int x1);
void GUI_DrawLine (int x0, int y0, int x1, int y1);
void GUI_DrawLineRel (int dx, int dy);
void GUI_DrawLineTo (int x, int y);
void GUI_DrawPie (int x0, int y0, int r, int a0, int a1, int Type);
void GUI_DrawPixel (int x, int y);
void GUI_DrawPoint (int x, int y);
void GUI_DrawPolygon (const GUI_POINT*, int NumPoints, int x0, int y0);
void GUI_DrawPolyLine (const GUI_POINT*, int NumPoints, int x0, int y0);
void GUI_DrawFocusRect (const GUI_RECT *pRect, int Dist);
void GUI_DrawRect (int x0, int y0, int x1, int y1);
void GUI_DrawRectEx (const GUI_RECT *pRect);
void GUI_DrawVLine (int x0, int y0, int y1);
void GUI_FillCircle (int x0, int y0, int r);
void GUI_FillEllipse (int x0, int y0, int rx, int ry);
void GUI_FillPolygon (const GUI_POINT*, int NumPoints, int x0, int y0);
void GUI_FillRect (int x0, int y0, int x1, int y1);
void GUI_FillRectEx (const GUI_RECT* pRect);
void GUI_GetClientRect (GUI_RECT* pRect);
void GUI_InvertRect (int x0, int y0, int x1, int y1);
void GUI_MoveRel (int dx, int dy);
void GUI_MoveTo (int x, int y);
/*********************************************************************
*
* Cursor routines
*
**********************************************************************
*/
#if GUI_SUPPORT_CURSOR
void GUI_CURSOR_Activate(void);
void GUI_CURSOR_Deactivate(void);
void GUI_CURSOR_Clear(void);
void GUI_CURSOR_SetXor(const GUI_BITMAP* pBM, int x, int y);
void GUI_CURSOR_SetPosition(int x, int y);
void GUI_CURSOR_TempHide (const GUI_RECT* pRect);
void GUI_CURSOR_TempUnhide(const GUI_RECT* pRect);
void GUI_CURSOR_Show(void);
#else
#define GUI_CURSOR_Show()
#endif
extern const GUI_BITMAP GUI_MouseArrow;
/*********************************************************************
*
* Text related routines
*
**********************************************************************
*/
void GUI_DispChar (U16 c);
void GUI_DispChars (U16 c, int Cnt);
void GUI_DispCharAt(U16 c, I16P x, I16P y);
void GUI_DispString(const char GUI_FAR *s);
void GUI_DispStringAt(const char GUI_FAR *s, int x, int y);
void GUI_DispStringAtCEOL(const char GUI_FAR *s, int x, int y);
void GUI_DispStringInRect(const char GUI_FAR *s, GUI_RECT* pRect, int Flags);
void GUI_DispStringLen(const char GUI_FAR *s, int Len);
void GUI_GetTextExtend(GUI_RECT* pRect, const char* s, int Len);
int GUI_GetYAdjust(void);
int GUI_GetDispPosX(void);
int GUI_GetDispPosY(void);
const GUI_FONT* GUI_GetFont(void);
int GUI_GetCharDistX(U16 c);
int GUI_GetStringDistX(const char GUI_FAR *s);
int GUI_GetFontDistY(void);
int GUI_GetFontSizeY(void);
int GUI_GetFontSizeYOf(const GUI_FONT* pFont);
void GUI_GetFontInfo(const GUI_FONT*pFont, GUI_FONTINFO* pfi);
int GUI_GetYSizeOfFont(const GUI_FONT* pFont);
int GUI_GetYDistOfFont(const GUI_FONT* pFont);
int GUI_GetTextAlign(void);
int GUI_GetTextMode(void);
char GUI_IsInFont(const GUI_FONT*pFont, U16 c);
void GUI_ScrollWin(int Win, int xDiff, int yDiff);
int GUI_SetTextAlign(int Align);
int GUI_SetTextMode(int Mode);
int GUI_SetLBorder(int x);
void GUI_SetOrg(int x, int y);
void GUI_SetCursor(int x, int y, int xlen);
void GUI_DispFatal(char*s);
const GUI_FONT* GUI_SetFont(const GUI_FONT* pNewFont);
char GUI_GotoXY(int x, int y);
char GUI_GotoX(int x);
char GUI_GotoY(int y);
void GUI_Scroll(int x, int y);
void GUI_DispNextLine(void);
#if GUI_SUPPORT_UNICODE
void GUI_DispString_UC(const U16 GUI_FAR *s);
void GUI_UC2DB (U16 Code, U8* pOut);
U16 GUI_DB2UC (U8 Byte0, U8 Byte1);
#endif
/* *********************************
* *
* GUISTR.C *
* *
*********************************
String functions.
*/
void GUI_DispStringHCenterAt(const char GUI_FAR *s, int x, int y);
/* *********************************
* *
* GUIVAL.C *
* *
*********************************
*/
void GUI_AddHex(U32 v, U8 Len, char**ps);
void GUI_AddDec(I32 v, U8 Len, char**ps);
void GUI_AddDecMin(I32 v, char**ps);
void GUI_AddDecShift(I32 v, U8 Len, U8 Shift, char**ps);
void GUI_DispBin (U32 v, U8 Len);
void GUI_DispBinAt(U32 v, I16P x, I16P y, U8 Len);
void GUI_DispCEOL (void);
void GUI_DispDec (I32 v, U8 Len);
void GUI_DispDecMin(I32 v);
void GUI_DispDecAt (I32 v, I16P x, I16P y, U8 Len);
void GUI_DispDecShift(I32 v, U8 Len, U8 Shift);
void GUI_DispDecSpace(I32 v, U8 MaxDigits);
void GUI_DispHex (U32 v, U8 Len);
void GUI_DispHexAt(U32 v, I16P x, I16P y, U8 Len);
void GUI_DispSDec(I32 v, U8 Len);
void GUI_DispSDecShift(I32 v, U8 Len, U8 Shift);
int GUI_Long2Len(I32 v);
/* *********************************
* *
* GUIVALF.C *
* *
*********************************
Routines to display floating point values. These routines use the routines
defined in the module GUIVAL.C as base routines.
*/
void GUI_DispFloat (float v, char Len);
void GUI_DispFloatFix (float v, char Len, char Fract);
void GUI_DispFloatMin (float v, char Fract);
void GUI_DispSFloatFix(float v, char Len, char Fract);
void GUI_DispSFloatMin(float v, char Fract);
/*********************************************************************
*
* Dynamic memory management
*
**********************************************************************
*/
#if !defined(GUI_ALLOC_ALLOC)
void GUI_ALLOC_Init(void);
void* GUI_ALLOC_h2p (GUI_HMEM hMem);
void GUI_ALLOC_Free (GUI_HMEM hMem);
void GUI_ALLOC_FreePtr (GUI_HMEM *phMem);
GUI_HMEM GUI_ALLOC_Alloc(int size);
/* diagnostics */
int GUI_ALLOC_GetUsed(void);
int GUI_ALLOC_GetNumFreeBytes(void);
int GUI_ALLOC_GetMaxSize(void);
/* macros */
#define GUI_ALLOC_ALLOC(size) GUI_ALLOC_Alloc(size)
#define GUI_ALLOC_H2P(h) GUI_ALLOC_h2p(h)
#define GUI_ALLOC_FREE(handle) GUI_ALLOC_Free(handle)
#define GUI_ALLOC_LOCK(handle) GUI_ALLOC_h2p(handle)
#define GUI_ALLOC_UNLOCK(handle)
#endif
/*********************************************************************
*
* Memory device: GUI_MEMDEV
*
**********************************************************************
*/
#define GUI_MEMDEV_HASTRANS 0
#define GUI_MEMDEV_NOTRANS (1<<0)
#if GUI_SUPPORT_MEMDEV
typedef GUI_HMEM GUI_MEMDEV_Handle;
typedef void GUI_CALLBACK_VOID_P(void* p);
typedef struct {
GUI_RECT rView, rPrev;
char FirstCall;
} GUI_AUTODEV;
typedef struct {
char DrawFixed;
} GUI_AUTODEV_INFO;
int GUI_MEMDEV_CreateAuto(GUI_AUTODEV * pAutoDev);
void GUI_MEMDEV_DeleteAuto(GUI_AUTODEV * pAutoDev);
int GUI_MEMDEV_DrawAuto (GUI_AUTODEV * pAutoDev, GUI_AUTODEV_INFO * pAutoDevInfo, GUI_CALLBACK_VOID_P * pfDraw, void * pData);
/* Create a memory device which is compatible to the selected LCD */
GUI_MEMDEV_Handle GUI_MEMDEV_Create ( int x0, int y0, int XSize, int YSize);
GUI_MEMDEV_Handle GUI_MEMDEV_CreateEx( int x0, int y0, int XSize, int YSize, int Flags);
void GUI_MEMDEV_Clear (GUI_MEMDEV_Handle hMem);
void GUI_MEMDEV_CopyFromLCD (GUI_MEMDEV_Handle hMem);
void GUI_MEMDEV_CopyFromLCDAA (GUI_MEMDEV_Handle hMem);
void GUI_MEMDEV_CopyToLCD (GUI_MEMDEV_Handle hMem);
void GUI_MEMDEV_CopyToLCDAA (GUI_MEMDEV_Handle hMem);
void GUI_MEMDEV_CopyToLCDAt (GUI_MEMDEV_Handle hMem, int x, int y);
int GUI_MEMDEV_CompareWithLCD(GUI_MEMDEV_Handle hMem, int*px, int*py, int *pExp, int*pAct);
void GUI_MEMDEV_Delete (GUI_MEMDEV_Handle MemDev);
int GUI_MEMDEV_GetYSize (GUI_MEMDEV_Handle hMem);
void GUI_MEMDEV_ReduceYSize (GUI_MEMDEV_Handle hMem, int YSize);
void GUI_MEMDEV_Select (GUI_MEMDEV_Handle hMem); /* Select (activate) a particular memory device. */
void GUI_MEMDEV_SetOrg (GUI_MEMDEV_Handle hMem, int x0, int y0);
void GUI_SelectLCD(void);
unsigned int GUI_SelLCD(unsigned int Index);
int GUI_MEMDEV_Draw(GUI_RECT* pRect, GUI_CALLBACK_VOID_P* pfDraw, void* pData, int MemSize, int Flags);
#else
#define GUI_SelectLCD()
#endif
/**************************************************************
*
* Measure device: GUI_MEASDEV
*
***************************************************************
*/
typedef GUI_HMEM GUI_MEASDEV_Handle;
GUI_MEASDEV_Handle GUI_MEASDEV_Create (void);
void GUI_MEASDEV_Delete (GUI_MEASDEV_Handle hMemDev);
void GUI_MEASDEV_Select (GUI_MEASDEV_Handle hMem);
void GUI_MEASDEV_GetRect(GUI_MEASDEV_Handle hMem, GUI_RECT *pRect);
void GUI_MEASDEV_ClearRect(GUI_MEASDEV_Handle hMem);
/************************************************************
*
* Polygon helpers
*
*************************************************************
*/
void GUI_RotatePolygon(GUI_POINT* pDest, const GUI_POINT* pSrc, int NumPoints, float Angle);
void GUI_MagnifyPolygon(GUI_POINT* pDest, const GUI_POINT* pSrc, int NumPoints, int Mag);
void GUI_EnlargePolygon(GUI_POINT* pDest, const GUI_POINT* pSrc, int NumPoints, int Len);
/************************************************************
*
* Streamed bitmap
*
*************************************************************
*/
typedef void GUI_CALLBACK_VOID_U8_P(U8 Data, void* p);
void GUI_DrawStreamedBitmap(const GUI_BITMAP_STREAM *pBitmapStream, int x, int y);
void GUI_StreamBMP (GUI_RECT* pRect, GUI_CALLBACK_VOID_U8_P* pfStream, void*p);
/*********************************************************************
*
* Time / execution related routines
*
**********************************************************************
*/
void GUI_Delay (int Period);
int GUI_GetTime(void);
int GUI_Exec(void); /* Execute all jobs ... Return 0 if nothing was done. */
int GUI_Exec1(void); /* Execute one job ... Return 0 if nothing was done. */
/*********************************************************************
*
* MessageBox
*
**********************************************************************
*/
int GUI_MessageBox(const char* sMessage, const char*sCaption, int Flags);
#define GUI_MESSAGEBOX_CF_MOVEABLE (1<<4)
#define GUI_MB_OK 20
#define GUI_MB_WARNING 21
/*********************************************************************
*
* GUI_TIMER module
*
**********************************************************************
*/
typedef struct GUI_TIMER_Message GUI_TIMER_MESSAGE;
struct GUI_TIMER_Message {
GUI_TIMER_TIME Time;
U32 Context;
};
typedef GUI_HMEM GUI_TIMER_Handle;
typedef void GUI_TIMER_CALLBACK(/*const*/ GUI_TIMER_MESSAGE* pTM);
GUI_TIMER_Handle GUI_TIMER_Create ( GUI_TIMER_CALLBACK* cb, int Time, U32 Context, int Flags);
void GUI_TIMER_Delete (GUI_TIMER_Handle pObj);
/* Methods changing properties */
void GUI_TIMER_SetPeriod (GUI_TIMER_Handle hObj, GUI_TIMER_TIME Period);
void GUI_TIMER_SetTime (GUI_TIMER_Handle hObj, GUI_TIMER_TIME Period);
void GUI_TIMER_SetDelay (GUI_TIMER_Handle hObj, GUI_TIMER_TIME Delay);
void GUI_TIMER_Restart (GUI_TIMER_Handle hObj);
int GUI_TIMER_Exec(void);
/******************************************************************
*
* Anti Aliasing
*
*******************************************************************
*/
void GUI_AA_DisableHiRes (void);
void GUI_AA_EnableHiRes (void);
int GUI_AA_GetFactor (void);
void GUI_AA_SetFactor (int Factor);
void GUI_AA_DrawArc (int x0, int y0, int rx, int ry, int a0, int a1);
void GUI_AA_DrawLine (int x0, int y0, int x1, int y1);
void GUI_AA_DrawPolyOutline(const GUI_POINT* pSrc, int NumPoints, int Thickness, int x, int y);
void GUI_AA_FillCircle (int x0, int y0, int r);
void GUI_AA_FillPolygon (GUI_POINT* pPoints, int NumPoints, int x0, int y0);
/* Defines for compatibility with older versins*/
#if GUI_COMPATIBLE_MODE
#define GUI_DrawArcAA GUI_AA_DrawArc
#define GUI_DrawPolyOutlineAA GUI_AA_DrawPolyOutline
#define GUI_FillCircleAA GUI_AA_FillCircle
#define GUI_FillPolygonAA GUI_AA_FillPolygon
#define GUI_MEMDEV_Load()
#endif
/******************************************************************
*
* Keyboard
*
*******************************************************************
*/
int GUI_GetKey(void);
int GUI_WaitKey(void);
void GUI_StoreKey(int c);
void GUI_ClearKeyBuffer(void);
void GUI_StoreKeyMsg(int Key, int Pressed);
void GUI_SendKeyMsg (int Key, int Pressed);
int GUI_PollKeyMsg(void);
/*********************************************************************
*
* HID
*
**********************************************************************
*/
typedef struct {
int x,y;
unsigned char Pressed;
} GUI_HID_STATE;
void GUI_HID_StoreState(const GUI_HID_STATE *pState);
int GUI_HID_GetState ( GUI_HID_STATE *pState);
/*********************************************************************
*
* Mouse, generic
*/
void GUI_MOUSE_StoreState(const GUI_HID_STATE *pState);
/*********************************************************************
*
* Mouse, PS2 driver
*/
void GUI_MOUSE_DRIVER_PS2_Init(void); /* optional */
void GUI_MOUSE_DRIVER_PS2_OnRx(unsigned char Data);
/*********************************************************************
*
* TOUCH screen, generic (any kind of hardware)
*/
int GUI_TOUCH_GetState(GUI_HID_STATE *pState);
void GUI_TOUCH_StoreState(int x, int y);
/*********************************************************************
*
* TOUCH screen, analog driver
*/
void GUI_TOUCH_Exec(void);
int GUI_TOUCH_Calibrate(int Coord, int Log0, int Log1, int Phys0, int Phys1);
void GUI_TOUCH_SetDefaultCalibration(void);
int GUI_TOUCH_GetxPhys(void); /* for diagnostics only */
int GUI_TOUCH_GetyPhys(void); /* for diagnostics only */
/*********************************************************************
*
* TOUCH
*
* imports
*
**********************************************************************
Please note: The following functions are required by the module.
They need to be part of your application software (or rather, part
of the hardware-layer of your software). If you do not like the names
of these routines, you may rename them easily by defining them in
the Configuration file GUITouch.conf.h
Example:
#define TOUCH_X_MeasureY HARDWARE_ReadY
This will rename the routine TOUCH_X_MeasureY into HARDWARE_ReadY.
*/
void TOUCH_X_ActivateX(void);
void TOUCH_X_ActivateY(void);
void TOUCH_X_Disable(void);
int TOUCH_X_MeasureX(void);
int TOUCH_X_MeasureY(void);
/**************************************************************
*
* Constants for fonts and bitmaps
*
***************************************************************
*/
#define GUI_COMPRESS_RLE4 0
#define GUI_COMPRESS_RLE8 0
#define GUI_DRAW_RLE4 LCD_DrawBitmap_RLE4 /* Function pointer ! */
#define GUI_DRAW_RLE8 LCD_DrawBitmap_RLE8 /* Function pointer ! */
/**************************************************************
*
* Heap public
*
***************************************************************
The main reason why the heap is declared public here is that
an application can perform additional error checking on
pointers. The variable itself is defined in the allocation
module and will only be linke if required.
*/
typedef union {
int aintHeap[GUI_ALLOC_SIZE/4]; /* required for proper alignement */
U8 abHeap[GUI_ALLOC_SIZE];
} GUI_HEAP;
extern GUI_HEAP GUI_Heap; /* Public for debugging only */
/**************************************************************
*
* Defines for constants
*
***************************************************************
*/
#define ________ 0x0
#define _______X 0x1
#define ______X_ 0x2
#define ______XX 0x3
#define _____X__ 0x4
#define _____X_X 0x5
#define _____XX_ 0x6
#define _____XXX 0x7
#define ____X___ 0x8
#define ____X__X 0x9
#define ____X_X_ 0xa
#define ____X_XX 0xb
#define ____XX__ 0xc
#define ____XX_X 0xd
#define ____XXX_ 0xe
#define ____XXXX 0xf
#define ___X____ 0x10
#define ___X___X 0x11
#define ___X__X_ 0x12
#define ___X__XX 0x13
#define ___X_X__ 0x14
#define ___X_X_X 0x15
#define ___X_XX_ 0x16
#define ___X_XXX 0x17
#define ___XX___ 0x18
#define ___XX__X 0x19
#define ___XX_X_ 0x1a
#define ___XX_XX 0x1b
#define ___XXX__ 0x1c
#define ___XXX_X 0x1d
#define ___XXXX_ 0x1e
#define ___XXXXX 0x1f
#define __X_____ 0x20
#define __X____X 0x21
#define __X___X_ 0x22
#define __X___XX 0x23
#define __X__X__ 0x24
#define __X__X_X 0x25
#define __X__XX_ 0x26
#define __X__XXX 0x27
#define __X_X___ 0x28
#define __X_X__X 0x29
#define __X_X_X_ 0x2a
#define __X_X_XX 0x2b
#define __X_XX__ 0x2c
#define __X_XX_X 0x2d
#define __X_XXX_ 0x2e
#define __X_XXXX 0x2f
#define __XX____ 0x30
#define __XX___X 0x31
#define __XX__X_ 0x32
#define __XX__XX 0x33
#define __XX_X__ 0x34
#define __XX_X_X 0x35
#define __XX_XX_ 0x36
#define __XX_XXX 0x37
#define __XXX___ 0x38
#define __XXX__X 0x39
#define __XXX_X_ 0x3a
#define __XXX_XX 0x3b
#define __XXXX__ 0x3c
#define __XXXX_X 0x3d
#define __XXXXX_ 0x3e
#define __XXXXXX 0x3f
#define _X______ 0x40
#define _X_____X 0x41
#define _X____X_ 0x42
#define _X____XX 0x43
#define _X___X__ 0x44
#define _X___X_X 0x45
#define _X___XX_ 0x46
#define _X___XXX 0x47
#define _X__X___ 0x48
#define _X__X__X 0x49
#define _X__X_X_ 0x4a
#define _X__X_XX 0x4b
#define _X__XX__ 0x4c
#define _X__XX_X 0x4d
#define _X__XXX_ 0x4e
#define _X__XXXX 0x4f
#define _X_X____ 0x50
#define _X_X___X 0x51
#define _X_X__X_ 0x52
#define _X_X__XX 0x53
#define _X_X_X__ 0x54
#define _X_X_X_X 0x55
#define _X_X_XX_ 0x56
#define _X_X_XXX 0x57
#define _X_XX___ 0x58
#define _X_XX__X 0x59
#define _X_XX_X_ 0x5a
#define _X_XX_XX 0x5b
#define _X_XXX__ 0x5c
#define _X_XXX_X 0x5d
#define _X_XXXX_ 0x5e
#define _X_XXXXX 0x5f
#define _XX_____ 0x60
#define _XX____X 0x61
#define _XX___X_ 0x62
#define _XX___XX 0x63
#define _XX__X__ 0x64
#define _XX__X_X 0x65
#define _XX__XX_ 0x66
#define _XX__XXX 0x67
#define _XX_X___ 0x68
#define _XX_X__X 0x69
#define _XX_X_X_ 0x6a
#define _XX_X_XX 0x6b
#define _XX_XX__ 0x6c
#define _XX_XX_X 0x6d
#define _XX_XXX_ 0x6e
#define _XX_XXXX 0x6f
#define _XXX____ 0x70
#define _XXX___X 0x71
#define _XXX__X_ 0x72
#define _XXX__XX 0x73
#define _XXX_X__ 0x74
#define _XXX_X_X 0x75
#define _XXX_XX_ 0x76
#define _XXX_XXX 0x77
#define _XXXX___ 0x78
#define _XXXX__X 0x79
#define _XXXX_X_ 0x7a
#define _XXXX_XX 0x7b
#define _XXXXX__ 0x7c
#define _XXXXX_X 0x7d
#define _XXXXXX_ 0x7e
#define _XXXXXXX 0x7f
#define X_______ 0x80
#define X______X 0x81
#define X_____X_ 0x82
#define X_____XX 0x83
#define X____X__ 0x84
#define X____X_X 0x85
#define X____XX_ 0x86
#define X____XXX 0x87
#define X___X___ 0x88
#define X___X__X 0x89
#define X___X_X_ 0x8a
#define X___X_XX 0x8b
#define X___XX__ 0x8c
#define X___XX_X 0x8d
#define X___XXX_ 0x8e
#define X___XXXX 0x8f
#define X__X____ 0x90
#define X__X___X 0x91
#define X__X__X_ 0x92
#define X__X__XX 0x93
#define X__X_X__ 0x94
#define X__X_X_X 0x95
#define X__X_XX_ 0x96
#define X__X_XXX 0x97
#define X__XX___ 0x98
#define X__XX__X 0x99
#define X__XX_X_ 0x9a
#define X__XX_XX 0x9b
#define X__XXX__ 0x9c
#define X__XXX_X 0x9d
#define X__XXXX_ 0x9e
#define X__XXXXX 0x9f
#define X_X_____ 0xa0
#define X_X____X 0xa1
#define X_X___X_ 0xa2
#define X_X___XX 0xa3
#define X_X__X__ 0xa4
#define X_X__X_X 0xa5
#define X_X__XX_ 0xa6
#define X_X__XXX 0xa7
#define X_X_X___ 0xa8
#define X_X_X__X 0xa9
#define X_X_X_X_ 0xaa
#define X_X_X_XX 0xab
#define X_X_XX__ 0xac
#define X_X_XX_X 0xad
#define X_X_XXX_ 0xae
#define X_X_XXXX 0xaf
#define X_XX____ 0xb0
#define X_XX___X 0xb1
#define X_XX__X_ 0xb2
#define X_XX__XX 0xb3
#define X_XX_X__ 0xb4
#define X_XX_X_X 0xb5
#define X_XX_XX_ 0xb6
#define X_XX_XXX 0xb7
#define X_XXX___ 0xb8
#define X_XXX__X 0xb9
#define X_XXX_X_ 0xba
#define X_XXX_XX 0xbb
#define X_XXXX__ 0xbc
#define X_XXXX_X 0xbd
#define X_XXXXX_ 0xbe
#define X_XXXXXX 0xbf
#define XX______ 0xc0
#define XX_____X 0xc1
#define XX____X_ 0xc2
#define XX____XX 0xc3
#define XX___X__ 0xc4
#define XX___X_X 0xc5
#define XX___XX_ 0xc6
#define XX___XXX 0xc7
#define XX__X___ 0xc8
#define XX__X__X 0xc9
#define XX__X_X_ 0xca
#define XX__X_XX 0xcb
#define XX__XX__ 0xcc
#define XX__XX_X 0xcd
#define XX__XXX_ 0xce
#define XX__XXXX 0xcf
#define XX_X____ 0xd0
#define XX_X___X 0xd1
#define XX_X__X_ 0xd2
#define XX_X__XX 0xd3
#define XX_X_X__ 0xd4
#define XX_X_X_X 0xd5
#define XX_X_XX_ 0xd6
#define XX_X_XXX 0xd7
#define XX_XX___ 0xd8
#define XX_XX__X 0xd9
#define XX_XX_X_ 0xda
#define XX_XX_XX 0xdb
#define XX_XXX__ 0xdc
#define XX_XXX_X 0xdd
#define XX_XXXX_ 0xde
#define XX_XXXXX 0xdf
#define XXX_____ 0xe0
#define XXX____X 0xe1
#define XXX___X_ 0xe2
#define XXX___XX 0xe3
#define XXX__X__ 0xe4
#define XXX__X_X 0xe5
#define XXX__XX_ 0xe6
#define XXX__XXX 0xe7
#define XXX_X___ 0xe8
#define XXX_X__X 0xe9
#define XXX_X_X_ 0xea
#define XXX_X_XX 0xeb
#define XXX_XX__ 0xec
#define XXX_XX_X 0xed
#define XXX_XXX_ 0xee
#define XXX_XXXX 0xef
#define XXXX____ 0xf0
#define XXXX___X 0xf1
#define XXXX__X_ 0xf2
#define XXXX__XX 0xf3
#define XXXX_X__ 0xf4
#define XXXX_X_X 0xf5
#define XXXX_XX_ 0xf6
#define XXXX_XXX 0xf7
#define XXXXX___ 0xf8
#define XXXXX__X 0xf9
#define XXXXX_X_ 0xfa
#define XXXXX_XX 0xfb
#define XXXXXX__ 0xfc
#define XXXXXX_X 0xfd
#define XXXXXXX_ 0xfe
#define XXXXXXXX 0xff
/**************************************************************
*
* Compatibility with older version
*
***************************************************************
*/
#define GUI_DrawBitMap(x,y,pBM) GUI_DrawBitmap(pBM,x,y)
#define GUI_TOUCH_tState GUI_HID_STATE
#define GUI_ID_BACKSPACE GUI_KEY_BACKSPACE
#define GUI_ID_TAB GUI_KEY_TAB
#define GUI_ID_ENTER GUI_KEY_ENTER
#define GUI_ID_LEFT GUI_KEY_LEFT
#define GUI_ID_UP GUI_KEY_UP
#define GUI_ID_RIGHT GUI_KEY_RIGHT
#define GUI_ID_DOWN GUI_KEY_DOWN
#define GUI_ID_HOME GUI_KEY_HOME
#define GUI_ID_END GUI_KEY_END
#define GUI_ID_SHIFT GUI_KEY_SHIFT
#define GUI_ID_CONTROL GUI_KEY_CONTROL
#define GUI_ID_ESCAPE GUI_KEY_ESCAPE
#define GUI_ID_INSERT GUI_KEY_INSERT
#define GUI_ID_DELETE GUI_KEY_DELETE
#if defined(__cplusplus)
}
#endif
#endif /* ifdef GUI_H */