RT1050 GUI demo using emWin library

Revision:
0:dd702039127a
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/emwin/emWin_header/WM.h	Thu Sep 20 19:16:34 2018 +0000
@@ -0,0 +1,775 @@
+/*********************************************************************
+*                SEGGER Microcontroller GmbH & Co. KG                *
+*        Solutions for real time microcontroller applications        *
+**********************************************************************
+*                                                                    *
+*        (c) 1996 - 2016  SEGGER Microcontroller GmbH & Co. KG       *
+*                                                                    *
+*        Internet: www.segger.com    Support:  support@segger.com    *
+*                                                                    *
+**********************************************************************
+
+** emWin V5.38 - Graphical user interface for embedded applications **
+All  Intellectual Property rights  in the Software belongs to  SEGGER.
+emWin 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 the following terms:
+
+The software has been licensed to  NXP Semiconductors USA, Inc.  whose
+registered  office  is  situated  at 411 E. Plumeria Drive, San  Jose,
+CA 95134, USA  solely for  the  purposes  of  creating  libraries  for
+NXPs M0, M3/M4 and  ARM7/9 processor-based  devices,  sublicensed  and
+distributed under the terms and conditions of the NXP End User License
+Agreement.
+Full source code is available at: www.segger.com
+
+We appreciate your understanding and fairness.
+----------------------------------------------------------------------
+Licensing information
+
+Licensor:                 SEGGER Microcontroller Systems LLC
+Licensed to:              NXP Semiconductors, 1109 McKay Dr, M/S 76, San Jose, CA 95131, USA
+Licensed SEGGER software: emWin
+License number:           GUI-00186
+License model:            emWin License Agreement, dated August 20th 2011
+Licensed product:         -
+Licensed platform:        NXP's ARM 7/9, Cortex-M0,M3,M4
+Licensed number of seats: -
+----------------------------------------------------------------------
+File        : WM.h
+Purpose     : Windows manager include
+----------------------------------------------------------------------
+*/
+
+#ifndef WM_H            /* Make sure we only include it once */
+#define WM_H
+
+
+#include "GUI_ConfDefaults.h"
+#include "GUI_Type.h"      /* Needed because of typedefs only */
+#include "WM_GUI.h"       /* Some functions needed by GUI routines */
+#include "GUI.h"
+
+#if defined(__cplusplus)
+extern "C" {     /* Make sure we have C-declarations in C++ programs */
+#endif
+
+/* Static memory devices */
+#ifndef   WM_SUPPORT_STATIC_MEMDEV
+  #define WM_SUPPORT_STATIC_MEMDEV GUI_SUPPORT_MEMDEV
+#endif
+
+/* Support for transparency. Switching it off makes Wm smaller and faster */
+#ifndef   WM_SUPPORT_TRANSPARENCY
+  #define WM_SUPPORT_TRANSPARENCY 1 /* Should be defined outside of GUI_WINSUPPORT because of '#if GUI_WINSUPPORT && WM_SUPPORT_TRANSPARENCY' in some files */
+#endif
+
+/* This is for tests only. It will fill the invalid area of a window.
+   Can be used for debugging. */
+#ifndef WM_SUPPORT_DIAG
+  #ifdef WIN32   /* In simulation */
+    #define WM_SUPPORT_DIAG GUI_WINSUPPORT
+  #else
+    #define WM_SUPPORT_DIAG 0
+  #endif
+#endif
+
+/* Make sure we actually have configured windows. If we have not,
+  there is no point for a windows manager and it will therefor not
+  generate any code !
+*/
+
+#if GUI_WINSUPPORT
+
+/*********************************************************************
+*
+*       Config defaults
+*/
+#ifndef   WM_ASSERT
+  #define WM_ASSERT(expr) GUI_DEBUG_ASSERT(expr)
+#endif
+
+#ifndef   WM_SUPPORT_TOUCH
+  #define WM_SUPPORT_TOUCH        GUI_SUPPORT_TOUCH
+#endif
+
+/* Allow older API calls */
+#ifndef   WM_COMPATIBLE_MODE
+  #define WM_COMPATIBLE_MODE 1
+#endif
+
+/* Send a message if visibility of a window has changed */
+#ifndef   WM_SUPPORT_NOTIFY_VIS_CHANGED
+  #define WM_SUPPORT_NOTIFY_VIS_CHANGED 0
+#endif
+
+#ifndef   WM_SUPPORT_CPP
+  #if defined (_MSC_VER)
+    #define WM_SUPPORT_CPP 1
+  #else
+    #define WM_SUPPORT_CPP 0
+  #endif
+#endif
+
+/*********************************************************************
+*
+*       Locking macros
+*/
+#define WM_LOCK()   GUI_LOCK()
+#define WM_UNLOCK() GUI_UNLOCK()
+
+#define WM_LOCK_H(hWin) (WM_Obj *)GUI_LOCK_H(hWin)
+
+/*********************************************************************
+*
+*       Data types
+*/
+typedef struct WM_WINDOW_INFO WM_WINDOW_INFO;
+
+struct WM_WINDOW_INFO {
+  GUI_HMEM hWin;
+  GUI_HMEM hParent;
+  GUI_HMEM hFirstChild;
+  GUI_HMEM hNext;
+  GUI_RECT Rect;
+  U32      Status;
+  U32      DebugId;
+  WM_WINDOW_INFO * pNext;
+};
+
+typedef struct {
+  int Key, PressedCnt;
+} WM_KEY_INFO;
+
+typedef struct {
+  int NumItems, v, PageSize;
+} WM_SCROLL_STATE;
+
+typedef struct {
+  int Done;
+  int ReturnValue;
+} WM_DIALOG_STATUS;
+
+typedef struct {
+  int x,y;
+  U8  State;
+  U8  StatePrev;
+} WM_PID_STATE_CHANGED_INFO;
+
+typedef struct {
+  int Cmd;
+  int dx, dy, da;
+  int xPos, yPos;
+  int Period;
+  int SnapX;
+  int SnapY;
+  int FinalMove;
+  U32 Flags;
+  GUI_PID_STATE * pState;
+  GUI_HMEM hContext;
+} WM_MOTION_INFO;
+
+typedef struct {
+  I32       FactorMin;   // Minimum factor to be used (<< 16)
+  I32       FactorMax;   // Maximum factor to be used (<< 16)
+  U32       xSize;       // Native xSize of window to be zoomed in pixels
+  U32       ySize;       // Native ySize of window to be zoomed in pixels
+  U32       xSizeParent; // xSize of parent window
+  U32       ySizeParent; // ySize of parent window
+  I32       Factor0;     // Primary factor when starting zoom gesture (<< 16)
+  int       xPos0;       // Primary window position in x when starting the gesture
+  int       yPos0;       // Primary window position in y when starting the gesture
+  GUI_POINT Center0;     // Primary center point when starting the gesture
+} WM_ZOOM_INFO;
+
+typedef struct {
+  int            Flags;     // Information regarding gesture type
+  GUI_POINT      Point;     // Relative movement
+  GUI_POINT      Center;    // Center point for zooming
+  I32            Angle;     // Angle between the touch points
+  I32            Factor;    // Current zoom factor
+  WM_ZOOM_INFO * pZoomInfo; // Pointer to WM_ZOOM_INFO structure
+} WM_GESTURE_INFO;
+
+typedef struct {
+  int dx, dy;
+} WM_MOVE_INFO;
+
+/*********************************************************************
+*
+*       Gesture flags for multi touch support
+*/
+#define WM_GF_BEGIN  (1 << 0)
+#define WM_GF_END    (1 << 1)
+#define WM_GF_PAN    (1 << 2)
+#define WM_GF_ZOOM   (1 << 3)
+#define WM_GF_ROTATE (1 << 4)
+#define WM_GF_DTAP   (1 << 5)
+
+/*********************************************************************
+*
+*       Messages Ids
+*
+* The following is the list of windows messages.
+*/
+#define WM_CREATE                   0x0001  /* The first message received, right after client has actually been created */
+#define WM_MOVE                     0x0003  /* window has been moved (Same as WIN32) */
+
+#define WM_SIZE                     0x0005  /* Is sent to a window after its size has changed (Same as WIN32, do not change !) */
+
+#define WM_DELETE                   11      /* Delete (Destroy) command: This tells the client to free its data strutures since the window
+                                               it is associates with no longer exists.*/
+#define WM_TOUCH                    0x0240  /* Touch screen message */
+#define WM_TOUCH_CHILD              13      /* Touch screen message to ancestors */
+#define WM_KEY                      14      /* Key has been pressed */
+
+#define WM_PAINT                    0x000F  /* Repaint window (because content is (partially) invalid */
+
+#if GUI_SUPPORT_MOUSE
+#define WM_MOUSEOVER                16      /* Mouse has moved, no key pressed */
+#define WM_MOUSEOVER_END            18      /* Mouse has moved, no key pressed */
+#endif
+
+#define WM_PID_STATE_CHANGED        17      /* Pointer input device state has changed */
+
+#define WM_GET_INSIDE_RECT          20      /* get inside rectangle: client rectangle minus pixels lost to effect */
+#define WM_GET_ID                   21      /* Get id of widget */
+#define WM_SET_ID                   22      /* Set id of widget */
+#define WM_GET_CLIENT_WINDOW        23      /* Get window handle of client window. Default is the same as window */
+#define WM_CAPTURE_RELEASED         24      /* Let window know that mouse capture is over */
+
+#define WM_INIT_DIALOG              29      /* Inform dialog that it is ready for init */
+
+#define WM_SET_FOCUS                30      /* Inform window that it has gotten or lost the focus */
+#define WM_GET_ACCEPT_FOCUS         31      /* Find out if window can accept the focus */
+#define WM_NOTIFY_CHILD_HAS_FOCUS   32      /* Sent to parent when child receives / loses focus */
+
+#define WM_NOTIFY_OWNER_KEY         33      /* Some widgets (e.g. listbox) notify owner when receiving key messages */
+
+#define WM_GET_BKCOLOR              34      /* Return back ground color (only frame window and similar) */
+#define WM_GET_SCROLL_STATE         35      /* Query state of scroll bar */
+
+#define WM_SET_SCROLL_STATE         36      /* Set scroll info ... only effective for scrollbars */
+
+#define WM_NOTIFY_CLIENTCHANGE      37      /* Client area may have changed */
+#define WM_NOTIFY_PARENT            38      /* Notify parent. Information is detailed as notification code */
+#define WM_NOTIFY_PARENT_REFLECTION 39      /* Notify parent reflection.
+                                               Sometimes send back as a result of the WM_NOTIFY_PARENT message
+                                               to let child react on behalf of its parent.
+                                               Information is detailed as notification code */
+#define WM_NOTIFY_ENABLE            40      /* Enable or disable widget */
+#define WM_NOTIFY_VIS_CHANGED       41      /* Visibility of a window has or may have changed */
+
+#define WM_HANDLE_DIALOG_STATUS     42      /* Set or get dialog status */
+#define WM_GET_RADIOGROUP           43      /* Send to all siblings and children of a radio control when
+                                               selection changed */
+#define WM_MENU                     44      /* Send to owner window of menu widget */
+#define WM_SCREENSIZE_CHANGED       45      /* Send to all windows when size of screen has changed */
+#define WM_PRE_PAINT                46      /* Send to a window before it receives a WM_PAINT message */
+#define WM_POST_PAINT               47      /* Send to a window after (the last) WM_PAINT message */
+
+#define WM_MOTION                   48      /* Automatic motion messages */
+
+#define WM_GET_WINDOW_ID            49      /* Return widget type specific Id (DebugId) */
+
+#define WM_PRE_BANDING              50
+#define WM_POST_BANDING             51
+
+#define WM_GESTURE                  0x0119  /* Gesture message */
+
+#define WM_TIMER                    0x0113  /* Timer has expired              (Keep the same as WIN32) */
+#define WM_WIDGET                   0x0300  /* 256 messages reserved for Widget messages */
+#define WM_USER                     0x0400  /* Reserved for user messages ... (Keep the same as WIN32) */
+
+/*********************************************************************
+*
+*       Motion messages
+*/
+#define WM_MOTION_INIT    0
+#define WM_MOTION_MOVE    1
+#define WM_MOTION_GETPOS  2
+#define WM_MOTION_GETCONTEXT 3
+
+/*********************************************************************
+*
+*       Motion flags
+*/
+#define WM_MOTION_MANAGE_BY_WINDOW   (1 << 0) // Window movement is managed by window itself
+
+/*********************************************************************
+*
+*       Notification codes
+*
+* The following is the list of notification codes send
+* with the WM_NOTIFY_PARENT message
+*/
+#define WM_NOTIFICATION_CLICKED             1
+#define WM_NOTIFICATION_RELEASED            2
+#define WM_NOTIFICATION_MOVED_OUT           3
+#define WM_NOTIFICATION_SEL_CHANGED         4
+#define WM_NOTIFICATION_VALUE_CHANGED       5
+#define WM_NOTIFICATION_SCROLLBAR_ADDED     6      /* Scroller added */
+#define WM_NOTIFICATION_CHILD_DELETED       7      /* Inform window that child is about to be deleted */
+#define WM_NOTIFICATION_GOT_FOCUS           8
+#define WM_NOTIFICATION_LOST_FOCUS          9
+#define WM_NOTIFICATION_SCROLL_CHANGED     10
+
+#define WM_NOTIFICATION_WIDGET             11      /* Space for widget defined notifications */
+#define WM_NOTIFICATION_USER               16      /* Space for  application (user) defined notifications */
+
+/*********************************************************************
+*
+*       Memory management
+*/
+#define WM_HWIN        GUI_HWIN
+#define WM_HWIN_NULL   GUI_HMEM_NULL
+#define WM_HMEM        GUI_HMEM
+#define WM_HMEM_NULL   GUI_HMEM_NULL
+#define WM_HTIMER      GUI_HMEM
+
+/*********************************************************************
+*
+*       Window defines
+*/
+#define WM_HBKWIN      WM_GetDesktopWindow()                /* Handle of background window */
+#define WM_UNATTACHED  ((WM_HMEM) - 1)                      /* Do not attach to a window */
+
+/*********************************************************************
+*
+*       Window create flags.
+*
+* These flags can be passed to the create window
+* function as flag-parameter. The flags are combinable using the
+* binary or operator.
+*/
+#define WM_CF_HASTRANS         (1UL << 0)  /* Has transparency. Needs to be defined for windows which do not fill the entire
+                                          section of their (client) rectangle. */
+#define WM_CF_HIDE             (0UL << 1)  /* Hide window after creation (default !) */
+#define WM_CF_SHOW             (1UL << 1)  /* Show window after creation */
+#define WM_CF_MEMDEV           (1UL << 2)  /* Use memory device for redraws */
+#define WM_CF_STAYONTOP        (1UL << 3)  /* Stay on top */
+#define WM_CF_DISABLED         (1UL << 4)  /* Disabled: Does not receive PID (mouse & touch) input */
+
+/* Create only flags ... Not available as status flags */
+#define WM_CF_ACTIVATE         (1UL << 5)  /* If automatic activation upon creation of window is desired */
+#define WM_CF_FGND             (0UL << 6)  /* Put window in foreground after creation (default !) */
+#define WM_CF_BGND             (1UL << 6)  /* Put window in background after creation */
+
+/* Anchor flags */
+#define WM_CF_ANCHOR_RIGHT     (1UL << 7)  /* Right anchor ...  If parent is resized, distance to right  will remain const (left is default) */
+#define WM_CF_ANCHOR_BOTTOM    (1UL << 8)  /* Bottom anchor ... If parent is resized, distance to bottom will remain const (top  is default) */
+#define WM_CF_ANCHOR_LEFT      (1UL << 9)  /* Left anchor ...   If parent is resized, distance to left   will remain const (left is default) */
+#define WM_CF_ANCHOR_TOP       (1UL << 10) /* Top anchor ...    If parent is resized, distance to top    will remain const (top  is default) */
+
+#define WM_CF_CONST_OUTLINE    (1UL << 11) /* Constant outline. This is relevant for transparent windows only. If a window is transparent
+                                              and does not have a constant outline, its background is invalided instead of the window itself.
+                                              This causes add. computation time when redrawing. */
+#define WM_CF_LATE_CLIP        (1UL << 12)
+#define WM_CF_MEMDEV_ON_REDRAW (1UL << 13)
+
+#define WM_SF_INVALID_DRAW     (1UL << 14)
+#define WM_SF_DELETE           (1UL << 15) /* Marks the window to be deleted within WM_Exec() when no callback routine is executed */
+
+#define WM_CF_STATIC           (1UL << 16) /* Use static memory device for redraws */
+
+#define WM_CF_MOTION_X         (1UL << 17) /* Window can be moved automatically in X axis */
+#define WM_CF_MOTION_Y         (1UL << 18) /* Window can be moved automatically in Y axis */
+
+#define WM_CF_GESTURE          (1UL << 19) /* Marks the window to be a able to receive gesture messages */
+
+#define WM_CF_ZOOM             (1UL << 20) /* Window can be scaled automatically by multi touch gesture input */
+
+#define WM_CF_MOTION_R         (1UL << 21) // Window can be rotated
+
+/*********************************************************************
+*
+*       Window manager types
+*/
+typedef struct WM_Obj     WM_Obj;
+typedef struct WM_MESSAGE WM_MESSAGE;
+
+typedef void WM_CALLBACK( WM_MESSAGE * pMsg);
+
+struct WM_MESSAGE {
+  int MsgId;            /* type of message */
+  WM_HWIN hWin;         /* Destination window */
+  WM_HWIN hWinSrc;      /* Source window  */
+  union {
+    const void * p;            /* Some messages need more info ... Pointer is declared "const" because some systems (M16C) have 4 byte const, byte 2 byte default ptrs */
+    int v;
+    GUI_COLOR Color;
+  } Data;
+};
+
+struct WM_Obj {
+  GUI_RECT Rect;        /* Outer dimensions of window */
+  GUI_RECT InvalidRect; /* Invalid rectangle */
+  WM_CALLBACK* cb;      /* Ptr to notification callback */
+  WM_HWIN hNextLin;     /* Next window in linear list */
+  WM_HWIN hParent;
+  WM_HWIN hFirstChild;
+  WM_HWIN hNext;
+  #if WM_SUPPORT_STATIC_MEMDEV
+    GUI_MEMDEV_Handle hMem; /* Static memory device */
+  #endif
+  U32 Status;           /* Status flags */
+  #if WM_SUPPORT_CPP
+    void * ObjPtr;
+  #endif
+};
+
+typedef void WM_tfPollPID(void);
+typedef void WM_tfForEach(WM_HWIN hWin, void * pData);
+
+typedef void (* WM_tfInvalidateParent)  (const GUI_RECT * pInvalidRect, WM_HWIN hParent, WM_HWIN hStop);
+typedef void (* WM_tfInvalidateDrawFunc)(WM_HWIN hWin);
+typedef void (* WM_tfPaint1Func)        (WM_HWIN hWin);
+
+typedef struct {
+  WM_HMEM  hTimer;
+  WM_HWIN  hWin;
+  int      UserId;
+} WM_TIMER_OBJ;
+
+/*********************************************************************
+*
+*       General control routines
+*/
+void WM_Activate  (void);
+void WM_Deactivate(void);
+void WM_Init      (void);
+int  WM_Exec      (void);    /* Execute all jobs ... Return 0 if nothing was done. */
+int  WM_Exec1     (void);    // Execute only one job
+U32  WM_SetCreateFlags(U32 Flags);
+WM_tfPollPID * WM_SetpfPollPID(WM_tfPollPID * pf);
+
+/*********************************************************************
+*
+*       Window manager interface
+*/
+void    WM_AttachWindow              (WM_HWIN hWin, WM_HWIN hParent);
+void    WM_AttachWindowAt            (WM_HWIN hWin, WM_HWIN hParent, int x, int y);
+int     WM_CheckScrollPos            (WM_SCROLL_STATE * pScrollState, int Pos, int LowerDist, int UpperDist); /* not to be documented (may change in future version) */
+void    WM_ClrHasTrans               (WM_HWIN hWin);
+WM_HWIN WM_CreateWindow              (int x0, int y0, int xSize, int ySize, U32 Style, WM_CALLBACK * cb, int NumExtraBytes);
+WM_HWIN WM_CreateWindowAsChild       (int x0, int y0, int xSize, int ySize, WM_HWIN hWinParent, U32 Style, WM_CALLBACK* cb, int NumExtraBytes);
+void    WM_DeleteWindow              (WM_HWIN hWin);
+void    WM_DetachWindow              (WM_HWIN hWin);
+void    WM_EnableGestures            (WM_HWIN hWin, int OnOff);
+int     WM_GetHasTrans               (WM_HWIN hWin);
+WM_HWIN WM_GetFocussedWindow         (void);
+int     WM_GetInvalidRect            (WM_HWIN hWin, GUI_RECT * pRect);
+int     WM_GetStayOnTop              (WM_HWIN hWin);
+void    WM_HideWindow                (WM_HWIN hWin);
+void    WM_InvalidateArea            (const GUI_RECT * pRect);
+void    WM_InvalidateRect            (WM_HWIN hWin, const GUI_RECT * pRect);
+void    WM_InvalidateWindow          (WM_HWIN hWin);
+void    WM_InvalidateWindowAndDescsEx(WM_HWIN hWin, const GUI_RECT * pInvalidRect, U16 Flags);
+void    WM_InvalidateWindowAndDescs  (WM_HWIN hWin);    /* not to be documented (may change in future version) */
+int     WM_IsEnabled                 (WM_HWIN hObj);
+char    WM_IsCompletelyCovered       (WM_HWIN hWin);    /* Checks if the window is completely covered by other windows */
+char    WM_IsCompletelyVisible       (WM_HWIN hWin);    /* Is the window completely visible ? */
+int     WM_IsFocussable              (WM_HWIN hWin);
+int     WM_IsVisible                 (WM_HWIN hWin);
+int     WM_IsWindow                  (WM_HWIN hWin);    /* Check validity */
+void    WM_SetAnchor                 (WM_HWIN hWin, U16 AnchorFlags);
+void    WM_SetHasTrans               (WM_HWIN hWin);
+void    WM_SetId                     (WM_HWIN hObj, int Id);
+void    WM_SetStayOnTop              (WM_HWIN hWin, int OnOff);
+void    WM_SetTransState             (WM_HWIN hWin, unsigned State);
+void    WM_ShowWindow                (WM_HWIN hWin);
+void    WM_ValidateRect              (WM_HWIN hWin, const GUI_RECT * pRect);
+void    WM_ValidateWindow            (WM_HWIN hWin);
+
+/* Gesture support */
+void WM_GESTURE_Enable  (int OnOff);
+int  WM_GESTURE_EnableEx(int OnOff, int MaxFactor);
+void WM_GESTURE_Exec    (void);
+I32  WM_GESTURE_SetThresholdAngle(I32 ThresholdAngle);
+I32  WM_GESTURE_SetThresholdDist (I32 ThresholdDist);
+
+/* Motion support */
+void     WM_MOTION_Enable          (int OnOff);
+void     WM_MOTION_SetMovement     (WM_HWIN hWin, int Axis, I32 Speed, I32 Dist);
+void     WM_MOTION_SetMotion       (WM_HWIN hWin, int Axis, I32 Speed, I32 Deceleration);
+void     WM_MOTION_SetMoveable     (WM_HWIN hWin, U32 Flags, int OnOff);
+void     WM_MOTION_SetDeceleration (WM_HWIN hWin, int Axis, I32 Deceleration);
+unsigned WM_MOTION_SetDefaultPeriod(unsigned Period);
+void     WM_MOTION_SetSpeed        (WM_HWIN hWin, int Axis, I32 Velocity);
+
+/* Motion support, private interface */
+WM_HMEM WM_MOTION__CreateContext(void);
+void    WM_MOTION__DeleteContext(WM_HMEM hContext);
+
+/* Motion support, private function(s) */
+void     WM__SetMotionCallback (void(* cbMotion) (GUI_PID_STATE * pState, void * p));
+
+/* Static memory devices */
+#if (GUI_SUPPORT_MEMDEV)
+  #define GUI_MEMDEV_EDGE_LEFT   0
+  #define GUI_MEMDEV_EDGE_RIGHT  1
+  #define GUI_MEMDEV_EDGE_TOP    2
+  #define GUI_MEMDEV_EDGE_BOTTOM 3
+
+  int               GUI_MEMDEV_BlendWinBk       (WM_HWIN hWin, int Period, U32 BlendColor, U8 BlendIntens);
+  int               GUI_MEMDEV_BlurAndBlendWinBk(WM_HWIN hWin, int Period, U8 BlurDepth, U32 BlendColor, U8 BlendIntens);
+  int               GUI_MEMDEV_BlurWinBk        (WM_HWIN hWin, int Period, U8 BlurDepth);
+  void              GUI_MEMDEV_CreateStatic     (WM_HWIN hWin);
+  GUI_MEMDEV_Handle GUI_MEMDEV_CreateWindowDevice(WM_HWIN hWin);
+  int               GUI_MEMDEV_FadeInWindow     (WM_HWIN hWin, int Period);
+  int               GUI_MEMDEV_FadeOutWindow    (WM_HWIN hWin, int Period);
+  GUI_MEMDEV_Handle GUI_MEMDEV_GetStaticDevice  (WM_HWIN hWin);
+  GUI_MEMDEV_Handle GUI_MEMDEV_GetWindowDevice  (WM_HWIN hWin);
+  int               GUI_MEMDEV_MoveInWindow     (WM_HWIN hWin, int x, int y, int a180, int Period);
+  int               GUI_MEMDEV_MoveOutWindow    (WM_HWIN hWin, int x, int y, int a180, int Period);
+  void              GUI_MEMDEV_Paint1Static     (WM_HWIN hWin);                                     /* not to be documented */
+  int               GUI_MEMDEV_ShiftInWindow    (WM_HWIN hWin, int Period, int Direction);
+  int               GUI_MEMDEV_ShiftOutWindow   (WM_HWIN hWin, int Period, int Direction);
+  int               GUI_MEMDEV_SwapWindow       (WM_HWIN hWin, int Period, int Edge);
+
+  void              GUI_MEMDEV__CreateStatic    (WM_HWIN hWin);
+#endif
+
+/* Move/resize windows */
+void WM_MoveWindow                (WM_HWIN hWin, int dx, int dy);
+void WM_ResizeWindow              (WM_HWIN hWin, int dx, int dy);
+void WM_MoveTo                    (WM_HWIN hWin, int x, int y);
+void WM_MoveChildTo               (WM_HWIN hWin, int x, int y);
+void WM_SetSize                   (WM_HWIN hWin, int XSize, int YSize);
+void WM_SetWindowPos              (WM_HWIN hWin, int xPos, int yPos, int xSize, int ySize);
+int  WM_SetXSize                  (WM_HWIN hWin, int xSize);
+int  WM_SetYSize                  (WM_HWIN hWin, int ySize);
+int  WM_SetScrollbarH             (WM_HWIN hWin, int OnOff); /* not to be documented (may change in future version) */
+int  WM_SetScrollbarV             (WM_HWIN hWin, int OnOff); /* not to be documented (may change in future version) */
+
+/* ToolTip support */
+#define WM_TOOLTIP_PI_FIRST 0
+#define WM_TOOLTIP_PI_SHOW  1
+#define WM_TOOLTIP_PI_NEXT  2
+
+#define WM_TOOLTIP_CI_BK    0
+#define WM_TOOLTIP_CI_FRAME 1
+#define WM_TOOLTIP_CI_TEXT  2
+
+typedef WM_HMEM WM_TOOLTIP_HANDLE;
+
+typedef struct {
+  int          Id;
+  const char * pText;
+} TOOLTIP_INFO;
+
+int               WM_TOOLTIP_AddTool         (WM_TOOLTIP_HANDLE hToolTip, WM_HWIN hTool, const char * pText);
+WM_TOOLTIP_HANDLE WM_TOOLTIP_Create          (WM_HWIN hDlg, const TOOLTIP_INFO * pInfo, unsigned NumItems);
+void              WM_TOOLTIP_Delete          (WM_TOOLTIP_HANDLE hToolTip);
+GUI_COLOR         WM_TOOLTIP_SetDefaultColor (unsigned Index, GUI_COLOR Color);
+const GUI_FONT *  WM_TOOLTIP_SetDefaultFont  (const GUI_FONT * pFont);
+unsigned          WM_TOOLTIP_SetDefaultPeriod(unsigned Index, unsigned Period);
+
+/* ToolTip support, private */
+void WM__SetToolTipCallback(void(* cbToolTip)(GUI_PID_STATE * pState, WM_HWIN));
+
+/* Timer */
+#ifdef GUI_X_CREATE_TIMER
+  int  WM_CreateTimer    (WM_HWIN hWin, int UserID, int Period, int Mode); /* not to be documented (may change in future version) */
+  void WM_DeleteTimer    (WM_HWIN hWin, int UserId); /* not to be documented (may change in future version) */
+#else
+  WM_HMEM WM_CreateTimer (WM_HWIN hWin, int UserID, int Period, int Mode); /* not to be documented (may change in future version) */
+  void    WM_DeleteTimer (WM_HMEM hTimer); /* not to be documented (may change in future version) */
+  void    WM_RestartTimer(WM_HMEM hTimer, int Period);
+#endif
+int WM_GetTimerId(WM_HTIMER hTimer);
+
+/* Diagnostics */
+int WM_GetNumWindows(void);
+int WM_GetNumInvalidWindows(void);
+
+/* Scroll state related functions */
+void WM_CheckScrollBounds(WM_SCROLL_STATE * pScrollState); /* not to be documented (may change in future version) */
+int  WM_GetScrollPosH    (WM_HWIN hWin);
+int  WM_GetScrollPosV    (WM_HWIN hWin);
+void WM_SetScrollPosH    (WM_HWIN hWin, unsigned ScrollPos);
+void WM_SetScrollPosV    (WM_HWIN hWin, unsigned ScrollPos);
+int  WM_SetScrollValue   (WM_SCROLL_STATE * pScrollState, int v); /* not to be documented (may change in future version) */
+
+/* Get / Set (new) callback function */
+WM_CALLBACK * WM_SetCallback(WM_HWIN hWin, WM_CALLBACK * cb);
+WM_CALLBACK * WM_GetCallback(WM_HWIN hWin);
+
+/* Get size/origin of a window */
+void      WM_GetClientRect           (GUI_RECT * pRect);
+void      WM_GetClientRectEx         (WM_HWIN hWin, GUI_RECT * pRect);
+void      WM_GetInsideRect           (GUI_RECT * pRect);
+void      WM_GetInsideRectEx         (WM_HWIN hWin, GUI_RECT * pRect);
+void      WM_GetInsideRectExScrollbar(WM_HWIN hWin, GUI_RECT * pRect); /* not to be documented (may change in future version) */
+void      WM_GetWindowRect           (GUI_RECT * pRect);
+void      WM_GetWindowRectEx         (WM_HWIN hWin, GUI_RECT * pRect);
+int       WM_GetOrgX                 (void);
+int       WM_GetOrgY                 (void);
+int       WM_GetWindowOrgX           (WM_HWIN hWin);
+int       WM_GetWindowOrgY           (WM_HWIN hWin);
+int       WM_GetWindowSizeX          (WM_HWIN hWin);
+int       WM_GetWindowSizeY          (WM_HWIN hWin);
+WM_HWIN   WM_GetFirstChild           (WM_HWIN hWin);
+WM_HWIN   WM_GetNextSibling          (WM_HWIN hWin);
+WM_HWIN   WM_GetParent               (WM_HWIN hWin);
+WM_HWIN   WM_GetPrevSibling          (WM_HWIN hWin);
+int       WM_GetId                   (WM_HWIN hWin);
+WM_HWIN   WM_GetScrollbarV           (WM_HWIN hWin);
+WM_HWIN   WM_GetScrollbarH           (WM_HWIN hWin);
+WM_HWIN   WM_GetScrollPartner        (WM_HWIN hWin);
+WM_HWIN   WM_GetClientWindow         (WM_HWIN hObj);
+GUI_COLOR WM_GetBkColor              (WM_HWIN hObj);
+
+/* Change Z-Order of windows */
+void WM_BringToBottom(WM_HWIN hWin);
+void WM_BringToTop(WM_HWIN hWin);
+
+GUI_COLOR WM_SetDesktopColor  (GUI_COLOR Color);
+GUI_COLOR WM_SetDesktopColorEx(GUI_COLOR Color, unsigned int LayerIndex);
+void      WM_SetDesktopColors (GUI_COLOR Color);
+
+/* Select window used for drawing operations */
+WM_HWIN WM_SelectWindow           (WM_HWIN  hWin);
+WM_HWIN WM_GetActiveWindow        (void);
+void    WM_Paint                  (WM_HWIN hObj);
+void    WM_Update                 (WM_HWIN hWin);
+void    WM_PaintWindowAndDescs    (WM_HWIN hWin);
+void    WM_UpdateWindowAndDescs   (WM_HWIN hWin);
+
+/* Get foreground/background windows */
+WM_HWIN WM_GetDesktopWindow  (void);
+WM_HWIN WM_GetDesktopWindowEx(unsigned int LayerIndex);
+
+/* Reduce clipping area of a window */
+const GUI_RECT * WM_SetUserClipRect(const GUI_RECT * pRect);
+void             WM_SetDefault     (void);
+
+/* Use of memory devices */
+void WM_EnableMemdev              (WM_HWIN hWin);
+void WM_DisableMemdev             (WM_HWIN hWin);
+
+/* Automatic use of multiple buffers */
+int WM_MULTIBUF_Enable  (int OnOff);
+int WM_MULTIBUF_EnableEx(int OnOff, U32 LayerMask);
+
+extern const GUI_MULTIBUF_API * WM_MULTIBUF__pAPI;
+
+typedef void (* T_WM_EXEC_GESTURE)(void);
+
+extern T_WM_EXEC_GESTURE WM__pExecGestures;
+
+/* ... */
+int WM_OnKey(int Key, int Pressed);
+void WM_MakeModal(WM_HWIN hWin);
+int WM_SetModalLayer(int LayerIndex);
+int WM_GetModalLayer(void);
+
+/*********************************************************************
+*
+*       Message related functions
+*
+*  Please note that some of these functions do not yet show up in the
+*  documentation, as they should not be required by application program.
+*/
+void      WM_NotifyParent         (WM_HWIN hWin, int Notification);
+void      WM_SendMessage          (WM_HWIN hWin, WM_MESSAGE * p);
+void      WM_SendMessageNoPara    (WM_HWIN hWin, int MsgId);             /* not to be documented (may change in future */
+void      WM_DefaultProc          (WM_MESSAGE * pMsg);
+int       WM_BroadcastMessage     (WM_MESSAGE * pMsg);
+void      WM_SetScrollState       (WM_HWIN hWin, const WM_SCROLL_STATE * pState);
+void      WM_SetEnableState       (WM_HWIN hItem, int State);
+void      WM_SendToParent         (WM_HWIN hWin, WM_MESSAGE * pMsg);
+int       WM_HasFocus             (WM_HWIN hWin);
+int       WM_SetFocus             (WM_HWIN hWin);
+WM_HWIN   WM_SetFocusOnNextChild  (WM_HWIN hParent);     /* Set the focus to the next child */
+WM_HWIN   WM_SetFocusOnPrevChild  (WM_HWIN hParent);     /* Set the focus to the previous child */
+WM_HWIN   WM_GetDialogItem        (WM_HWIN hWin, int Id);
+void      WM_EnableWindow         (WM_HWIN hWin);
+void      WM_DisableWindow        (WM_HWIN hWin);
+void      WM_GetScrollState       (WM_HWIN hObj, WM_SCROLL_STATE * pScrollState);
+
+/*********************************************************************
+*
+*       Managing user data
+*/
+int       WM_GetUserData   (WM_HWIN hWin, void * pDest, int SizeOfBuffer);
+int       WM_SetUserData   (WM_HWIN hWin, const void * pSrc, int SizeOfBuffer);
+int       WM__GetUserDataEx(WM_HWIN hWin, void * pDest, int NumBytes, int SizeOfObject);
+int       WM__SetUserDataEx(WM_HWIN hWin, const void * pSrc, int NumBytes, int SizeOfObject);
+
+/*********************************************************************
+*
+*       Capturing input focus
+*/
+int  WM_HasCaptured   (WM_HWIN hWin);
+void WM_SetCapture    (WM_HWIN hObj, int AutoRelease);
+void WM_SetCaptureMove(WM_HWIN hWin, const GUI_PID_STATE * pState, int MinVisibility, int LimitTop); /* Not yet documented */
+void WM_ReleaseCapture(void);
+
+/*********************************************************************
+*
+*       Misc routines
+*/
+int       WM_HandlePID      (void);
+WM_HWIN   WM_Screen2hWin    (int x, int y);
+WM_HWIN   WM_Screen2hWinEx  (WM_HWIN hStop, int x, int y);
+void      WM_ForEachDesc    (WM_HWIN hWin, WM_tfForEach * pcb, void * pData);
+void      WM_SetScreenSize  (int xSize, int ySize);
+int       WM_PollSimMsg     (void);
+int       WM_GetWindowInfo  (WM_WINDOW_INFO * pInfo, int FirstWindow);
+
+/*********************************************************************
+*
+*       Diagnostics routines
+*/
+#if (WM_SUPPORT_DIAG)
+void WM_DIAG_EnableInvalidationColoring(int OnOff);
+#endif
+
+/*********************************************************************
+*
+*       Macros for compatibility with older versions
+*/
+#if WM_COMPATIBLE_MODE
+  #define HBWIN             WM_HWIN
+  #define HBWIN_NULL        WM_HWIN_NULL
+
+  #define WM_HideWin        WM_HideWindow
+  #define WM_ShowWin        WM_ShowWindow
+  #define WM_GetKey         GUI_GetKey
+  #define WM_WaitKey        GUI_WaitKey
+
+  #define WM_ExecIdle       WM_Exec
+  #define WM_ExecIdle1      WM_Exec1
+
+  #define WM_Invalidate     WM_InvalidateWindow
+  #define WM_GetWinRect     WM_GetWindowRect
+  #define WM_GetWinOrgX     WM_GetWindowOrgX
+  #define WM_GetWinOrgY     WM_GetWindowOrgY
+  #define WM_GetWinSizeX    WM_GetWindowSizeX
+  #define WM_GetWinSizeY    WM_GetWindowSizeY
+  #define WM_GetXSize       WM_GetWindowSizeX
+  #define WM_GetYSize       WM_GetWindowSizeY
+  #define WM_SelWin         WM_SelectWindow
+  #define WM_GetBackgroundWindow  WM_GetDesktopWindow
+  #define WM_GetForegroundWindow    0
+  #define WM_SetForegroundWindow    WM_BringToTop
+  #define WM_SetUserClipArea WM_SetUserClipRect
+
+
+  #define WM_Start()
+  #define WM_Stop()
+  #define WM_SetBkWindowColor(Color)  WM_SetDesktopColor(Color)
+
+#endif
+
+
+#endif   /* GUI_WINSUPPORT */
+
+#if defined(__cplusplus)
+}
+#endif
+
+#endif   /* WM_H */
+
+/*************************** End of file ****************************/