NXP / Mbed OS rt1050_emwin_gui_demo

RT1050 GUI demo using emWin library

emwin/emWin_header/FRAMEWIN.h@0:dd702039127a, 2018-09-20 (annotated)

Committer:
alejandroRL
Date:
Thu Sep 20 19:16:34 2018 +0000
Revision:
0:dd702039127a
emWin GUI Demo for RT1050

Who changed what in which revision?

UserRevisionLine numberNew contents of line
alejandroRL 0:dd702039127a 1 /*********************************************************************
alejandroRL 0:dd702039127a 2 * SEGGER Microcontroller GmbH & Co. KG *
alejandroRL 0:dd702039127a 3 * Solutions for real time microcontroller applications *
alejandroRL 0:dd702039127a 4 **********************************************************************
alejandroRL 0:dd702039127a 5 * *
alejandroRL 0:dd702039127a 6 * (c) 1996 - 2016 SEGGER Microcontroller GmbH & Co. KG *
alejandroRL 0:dd702039127a 7 * *
alejandroRL 0:dd702039127a 8 * Internet: www.segger.com Support: support@segger.com *
alejandroRL 0:dd702039127a 9 * *
alejandroRL 0:dd702039127a 10 **********************************************************************
alejandroRL 0:dd702039127a 11
alejandroRL 0:dd702039127a 12 ** emWin V5.38 - Graphical user interface for embedded applications **
alejandroRL 0:dd702039127a 13 All Intellectual Property rights in the Software belongs to SEGGER.
alejandroRL 0:dd702039127a 14 emWin is protected by international copyright laws. Knowledge of the
alejandroRL 0:dd702039127a 15 source code may not be used to write a similar product. This file may
alejandroRL 0:dd702039127a 16 only be used in accordance with the following terms:
alejandroRL 0:dd702039127a 17
alejandroRL 0:dd702039127a 18 The software has been licensed to NXP Semiconductors USA, Inc. whose
alejandroRL 0:dd702039127a 19 registered office is situated at 411 E. Plumeria Drive, San Jose,
alejandroRL 0:dd702039127a 20 CA 95134, USA solely for the purposes of creating libraries for
alejandroRL 0:dd702039127a 21 NXPs M0, M3/M4 and ARM7/9 processor-based devices, sublicensed and
alejandroRL 0:dd702039127a 22 distributed under the terms and conditions of the NXP End User License
alejandroRL 0:dd702039127a 23 Agreement.
alejandroRL 0:dd702039127a 24 Full source code is available at: www.segger.com
alejandroRL 0:dd702039127a 25
alejandroRL 0:dd702039127a 26 We appreciate your understanding and fairness.
alejandroRL 0:dd702039127a 27 ----------------------------------------------------------------------
alejandroRL 0:dd702039127a 28 Licensing information
alejandroRL 0:dd702039127a 29
alejandroRL 0:dd702039127a 30 Licensor: SEGGER Microcontroller Systems LLC
alejandroRL 0:dd702039127a 31 Licensed to: NXP Semiconductors, 1109 McKay Dr, M/S 76, San Jose, CA 95131, USA
alejandroRL 0:dd702039127a 32 Licensed SEGGER software: emWin
alejandroRL 0:dd702039127a 33 License number: GUI-00186
alejandroRL 0:dd702039127a 34 License model: emWin License Agreement, dated August 20th 2011
alejandroRL 0:dd702039127a 35 Licensed product: -
alejandroRL 0:dd702039127a 36 Licensed platform: NXP's ARM 7/9, Cortex-M0,M3,M4
alejandroRL 0:dd702039127a 37 Licensed number of seats: -
alejandroRL 0:dd702039127a 38 ----------------------------------------------------------------------
alejandroRL 0:dd702039127a 39 File : FRAMEWIN.h
alejandroRL 0:dd702039127a 40 Purpose : Frame window include
alejandroRL 0:dd702039127a 41 --------------------END-OF-HEADER-------------------------------------
alejandroRL 0:dd702039127a 42 */
alejandroRL 0:dd702039127a 43
alejandroRL 0:dd702039127a 44 #ifndef FRAMEWIN_H
alejandroRL 0:dd702039127a 45 #define FRAMEWIN_H
alejandroRL 0:dd702039127a 46
alejandroRL 0:dd702039127a 47 #include "WM.h"
alejandroRL 0:dd702039127a 48 #include "WIDGET.h" /* Req. for WIDGET_DRAW_ITEM_FUNC */
alejandroRL 0:dd702039127a 49 #if GUI_WINSUPPORT
alejandroRL 0:dd702039127a 50 #include "DIALOG_Intern.h" /* Req. for Create indirect data structure */
alejandroRL 0:dd702039127a 51
alejandroRL 0:dd702039127a 52 #if defined(__cplusplus)
alejandroRL 0:dd702039127a 53 extern "C" { /* Make sure we have C-declarations in C++ programs */
alejandroRL 0:dd702039127a 54 #endif
alejandroRL 0:dd702039127a 55
alejandroRL 0:dd702039127a 56 /*********************************************************************
alejandroRL 0:dd702039127a 57 *
alejandroRL 0:dd702039127a 58 * Defines
alejandroRL 0:dd702039127a 59 *
alejandroRL 0:dd702039127a 60 **********************************************************************
alejandroRL 0:dd702039127a 61 */
alejandroRL 0:dd702039127a 62 /*********************************************************************
alejandroRL 0:dd702039127a 63 *
alejandroRL 0:dd702039127a 64 * Configuration
alejandroRL 0:dd702039127a 65 */
alejandroRL 0:dd702039127a 66 #ifndef FRAMEWIN_ALLOW_DRAG_ON_FRAME
alejandroRL 0:dd702039127a 67 #define FRAMEWIN_ALLOW_DRAG_ON_FRAME 1
alejandroRL 0:dd702039127a 68 #endif
alejandroRL 0:dd702039127a 69
alejandroRL 0:dd702039127a 70 /*********************************************************************
alejandroRL 0:dd702039127a 71 *
alejandroRL 0:dd702039127a 72 * Color indices
alejandroRL 0:dd702039127a 73 */
alejandroRL 0:dd702039127a 74 #define FRAMEWIN_CI_INACTIVE 0
alejandroRL 0:dd702039127a 75 #define FRAMEWIN_CI_ACTIVE 1
alejandroRL 0:dd702039127a 76
alejandroRL 0:dd702039127a 77 /*********************************************************************
alejandroRL 0:dd702039127a 78 *
alejandroRL 0:dd702039127a 79 * Create / Status flags
alejandroRL 0:dd702039127a 80 */
alejandroRL 0:dd702039127a 81 #define FRAMEWIN_CF_ACTIVE (1<<3)
alejandroRL 0:dd702039127a 82 #define FRAMEWIN_CF_MOVEABLE (1<<4)
alejandroRL 0:dd702039127a 83 #define FRAMEWIN_CF_TITLEVIS (1<<5)
alejandroRL 0:dd702039127a 84 #define FRAMEWIN_CF_MINIMIZED (1<<6)
alejandroRL 0:dd702039127a 85 #define FRAMEWIN_CF_MAXIMIZED (1<<7)
alejandroRL 0:dd702039127a 86 #define FRAMEWIN_CF_DRAGGING (1<<8)
alejandroRL 0:dd702039127a 87
alejandroRL 0:dd702039127a 88 #define FRAMEWIN_SF_ACTIVE FRAMEWIN_CF_ACTIVE
alejandroRL 0:dd702039127a 89 #define FRAMEWIN_SF_MOVEABLE FRAMEWIN_CF_MOVEABLE
alejandroRL 0:dd702039127a 90 #define FRAMEWIN_SF_TITLEVIS FRAMEWIN_CF_TITLEVIS
alejandroRL 0:dd702039127a 91 #define FRAMEWIN_SF_MINIMIZED FRAMEWIN_CF_MINIMIZED
alejandroRL 0:dd702039127a 92 #define FRAMEWIN_SF_MAXIMIZED FRAMEWIN_CF_MAXIMIZED
alejandroRL 0:dd702039127a 93 #define FRAMEWIN_SF_DRAGGING FRAMEWIN_CF_DRAGGING
alejandroRL 0:dd702039127a 94
alejandroRL 0:dd702039127a 95 /*********************************************************************
alejandroRL 0:dd702039127a 96 *
alejandroRL 0:dd702039127a 97 * BUTTON Flags
alejandroRL 0:dd702039127a 98 */
alejandroRL 0:dd702039127a 99 #define FRAMEWIN_BUTTON_RIGHT (1<<0)
alejandroRL 0:dd702039127a 100 #define FRAMEWIN_BUTTON_LEFT (1<<1)
alejandroRL 0:dd702039127a 101
alejandroRL 0:dd702039127a 102 /*********************************************************************
alejandroRL 0:dd702039127a 103 *
alejandroRL 0:dd702039127a 104 * Skinning property indices
alejandroRL 0:dd702039127a 105 */
alejandroRL 0:dd702039127a 106 #define FRAMEWIN_SKINFLEX_PI_ACTIVE 0
alejandroRL 0:dd702039127a 107 #define FRAMEWIN_SKINFLEX_PI_INACTIVE 1
alejandroRL 0:dd702039127a 108
alejandroRL 0:dd702039127a 109 /*********************************************************************
alejandroRL 0:dd702039127a 110 *
alejandroRL 0:dd702039127a 111 * Getting border size
alejandroRL 0:dd702039127a 112 */
alejandroRL 0:dd702039127a 113 #define FRAMEWIN_BORDERSIZE_T 0
alejandroRL 0:dd702039127a 114 #define FRAMEWIN_BORDERSIZE_L 1
alejandroRL 0:dd702039127a 115 #define FRAMEWIN_BORDERSIZE_B 2
alejandroRL 0:dd702039127a 116 #define FRAMEWIN_BORDERSIZE_R 3
alejandroRL 0:dd702039127a 117
alejandroRL 0:dd702039127a 118 /*********************************************************************
alejandroRL 0:dd702039127a 119 *
alejandroRL 0:dd702039127a 120 * Types
alejandroRL 0:dd702039127a 121 *
alejandroRL 0:dd702039127a 122 **********************************************************************
alejandroRL 0:dd702039127a 123 */
alejandroRL 0:dd702039127a 124 typedef WM_HMEM FRAMEWIN_Handle;
alejandroRL 0:dd702039127a 125
alejandroRL 0:dd702039127a 126 typedef struct {
alejandroRL 0:dd702039127a 127 GUI_COLOR aColorFrame[3];
alejandroRL 0:dd702039127a 128 GUI_COLOR aColorTitle[2];
alejandroRL 0:dd702039127a 129 int Radius;
alejandroRL 0:dd702039127a 130 int SpaceX;
alejandroRL 0:dd702039127a 131 int BorderSizeL;
alejandroRL 0:dd702039127a 132 int BorderSizeR;
alejandroRL 0:dd702039127a 133 int BorderSizeT;
alejandroRL 0:dd702039127a 134 int BorderSizeB;
alejandroRL 0:dd702039127a 135 } FRAMEWIN_SKINFLEX_PROPS;
alejandroRL 0:dd702039127a 136
alejandroRL 0:dd702039127a 137 /*********************************************************************
alejandroRL 0:dd702039127a 138 *
alejandroRL 0:dd702039127a 139 * Create functions
alejandroRL 0:dd702039127a 140 *
alejandroRL 0:dd702039127a 141 **********************************************************************
alejandroRL 0:dd702039127a 142 */
alejandroRL 0:dd702039127a 143 FRAMEWIN_Handle FRAMEWIN_Create (const char * pTitle, WM_CALLBACK * cb, int Flags, int x0, int y0, int xSize, int ySize);
alejandroRL 0:dd702039127a 144 FRAMEWIN_Handle FRAMEWIN_CreateAsChild (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, const char * pText, WM_CALLBACK * cb, int Flags);
alejandroRL 0:dd702039127a 145 FRAMEWIN_Handle FRAMEWIN_CreateEx (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id, const char * pTitle, WM_CALLBACK * cb);
alejandroRL 0:dd702039127a 146 FRAMEWIN_Handle FRAMEWIN_CreateUser (int x0, int y0, int xSize, int ySize, WM_HWIN hParent, int WinFlags, int ExFlags, int Id, const char * pTitle, WM_CALLBACK * cb, int NumExtraBytes);
alejandroRL 0:dd702039127a 147 FRAMEWIN_Handle FRAMEWIN_CreateIndirect(const GUI_WIDGET_CREATE_INFO * pCreateInfo, WM_HWIN hWinParent, int x0, int y0, WM_CALLBACK * cb);
alejandroRL 0:dd702039127a 148
alejandroRL 0:dd702039127a 149 /*********************************************************************
alejandroRL 0:dd702039127a 150 *
alejandroRL 0:dd702039127a 151 * The callback ...
alejandroRL 0:dd702039127a 152 *
alejandroRL 0:dd702039127a 153 * Do not call it directly ! It is only to be used from within an
alejandroRL 0:dd702039127a 154 * overwritten callback.
alejandroRL 0:dd702039127a 155 */
alejandroRL 0:dd702039127a 156 void FRAMEWIN_Callback(WM_MESSAGE * pMsg);
alejandroRL 0:dd702039127a 157
alejandroRL 0:dd702039127a 158 /*********************************************************************
alejandroRL 0:dd702039127a 159 *
alejandroRL 0:dd702039127a 160 * Member functions: Set Properties
alejandroRL 0:dd702039127a 161 *
alejandroRL 0:dd702039127a 162 **********************************************************************
alejandroRL 0:dd702039127a 163 */
alejandroRL 0:dd702039127a 164 WM_HWIN FRAMEWIN_AddButton (FRAMEWIN_Handle hObj, int Flags, int Off, int Id);
alejandroRL 0:dd702039127a 165 WM_HWIN FRAMEWIN_AddCloseButton(FRAMEWIN_Handle hObj, int Flags, int Off);
alejandroRL 0:dd702039127a 166 WM_HWIN FRAMEWIN_AddMaxButton (FRAMEWIN_Handle hObj, int Flags, int Off);
alejandroRL 0:dd702039127a 167 void FRAMEWIN_AddMenu (FRAMEWIN_Handle hObj, WM_HWIN hMenu);
alejandroRL 0:dd702039127a 168 WM_HWIN FRAMEWIN_AddMinButton (FRAMEWIN_Handle hObj, int Flags, int Off);
alejandroRL 0:dd702039127a 169 void FRAMEWIN_Minimize (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 170 void FRAMEWIN_Maximize (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 171 void FRAMEWIN_Restore (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 172 void FRAMEWIN_SetActive (FRAMEWIN_Handle hObj, int State);
alejandroRL 0:dd702039127a 173 void FRAMEWIN_SetBarColor (FRAMEWIN_Handle hObj, unsigned Index, GUI_COLOR Color);
alejandroRL 0:dd702039127a 174 void FRAMEWIN_SetBorderSize (FRAMEWIN_Handle hObj, unsigned Size);
alejandroRL 0:dd702039127a 175 void FRAMEWIN_SetClientColor(FRAMEWIN_Handle hObj, GUI_COLOR Color);
alejandroRL 0:dd702039127a 176 void FRAMEWIN_SetFont (FRAMEWIN_Handle hObj, const GUI_FONT * pFont);
alejandroRL 0:dd702039127a 177 void FRAMEWIN_SetMoveable (FRAMEWIN_Handle hObj, int State);
alejandroRL 0:dd702039127a 178 void FRAMEWIN_SetOwnerDraw (FRAMEWIN_Handle hObj, WIDGET_DRAW_ITEM_FUNC * pfDrawItem);
alejandroRL 0:dd702039127a 179 void FRAMEWIN_SetResizeable (FRAMEWIN_Handle hObj, int State);
alejandroRL 0:dd702039127a 180 void FRAMEWIN_SetText (FRAMEWIN_Handle hObj, const char* s);
alejandroRL 0:dd702039127a 181 void FRAMEWIN_SetTextAlign (FRAMEWIN_Handle hObj, int Align);
alejandroRL 0:dd702039127a 182 void FRAMEWIN_SetTextColor (FRAMEWIN_Handle hObj, GUI_COLOR Color);
alejandroRL 0:dd702039127a 183 void FRAMEWIN_SetTextColorEx(FRAMEWIN_Handle hObj, unsigned Index, GUI_COLOR Color);
alejandroRL 0:dd702039127a 184 void FRAMEWIN_SetTitleVis (FRAMEWIN_Handle hObj, int Show);
alejandroRL 0:dd702039127a 185 int FRAMEWIN_SetTitleHeight(FRAMEWIN_Handle hObj, int Height);
alejandroRL 0:dd702039127a 186 int FRAMEWIN_SetUserData (FRAMEWIN_Handle hObj, const void * pSrc, int NumBytes);
alejandroRL 0:dd702039127a 187
alejandroRL 0:dd702039127a 188 /*********************************************************************
alejandroRL 0:dd702039127a 189 *
alejandroRL 0:dd702039127a 190 * Member functions: Skinning
alejandroRL 0:dd702039127a 191 *
alejandroRL 0:dd702039127a 192 **********************************************************************
alejandroRL 0:dd702039127a 193 */
alejandroRL 0:dd702039127a 194 void FRAMEWIN_GetSkinFlexProps (FRAMEWIN_SKINFLEX_PROPS * pProps, int Index);
alejandroRL 0:dd702039127a 195 void FRAMEWIN_SetSkinClassic (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 196 void FRAMEWIN_SetSkin (FRAMEWIN_Handle hObj, WIDGET_DRAW_ITEM_FUNC * pfDrawSkin);
alejandroRL 0:dd702039127a 197 int FRAMEWIN_DrawSkinFlex (const WIDGET_ITEM_DRAW_INFO * pDrawItemInfo);
alejandroRL 0:dd702039127a 198 void FRAMEWIN_SetSkinFlexProps (const FRAMEWIN_SKINFLEX_PROPS * pProps, int Index);
alejandroRL 0:dd702039127a 199 void FRAMEWIN_SetDefaultSkinClassic(void);
alejandroRL 0:dd702039127a 200 WIDGET_DRAW_ITEM_FUNC * FRAMEWIN_SetDefaultSkin(WIDGET_DRAW_ITEM_FUNC * pfDrawSkin);
alejandroRL 0:dd702039127a 201
alejandroRL 0:dd702039127a 202 #define FRAMEWIN_SKIN_FLEX FRAMEWIN_DrawSkinFlex
alejandroRL 0:dd702039127a 203
alejandroRL 0:dd702039127a 204 /*********************************************************************
alejandroRL 0:dd702039127a 205 *
alejandroRL 0:dd702039127a 206 * Member functions: Get Properties
alejandroRL 0:dd702039127a 207 *
alejandroRL 0:dd702039127a 208 **********************************************************************
alejandroRL 0:dd702039127a 209 */
alejandroRL 0:dd702039127a 210 const GUI_FONT * FRAMEWIN_GetFont(FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 211
alejandroRL 0:dd702039127a 212 int FRAMEWIN_GetActive (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 213 int FRAMEWIN_GetTitleHeight (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 214 GUI_COLOR FRAMEWIN_GetBarColor (FRAMEWIN_Handle hObj, unsigned Index);
alejandroRL 0:dd702039127a 215 int FRAMEWIN_GetBorderSize (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 216 int FRAMEWIN_GetBorderSizeEx(FRAMEWIN_Handle hObj, unsigned Edge);
alejandroRL 0:dd702039127a 217 void FRAMEWIN_GetText (FRAMEWIN_Handle hObj, char * pBuffer, int MaxLen);
alejandroRL 0:dd702039127a 218 int FRAMEWIN_GetTextAlign (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 219 int FRAMEWIN_GetUserData (FRAMEWIN_Handle hObj, void * pDest, int NumBytes);
alejandroRL 0:dd702039127a 220 int FRAMEWIN_IsMinimized (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 221 int FRAMEWIN_IsMaximized (FRAMEWIN_Handle hObj);
alejandroRL 0:dd702039127a 222
alejandroRL 0:dd702039127a 223 /*********************************************************************
alejandroRL 0:dd702039127a 224 *
alejandroRL 0:dd702039127a 225 * Managing default values
alejandroRL 0:dd702039127a 226 *
alejandroRL 0:dd702039127a 227 **********************************************************************
alejandroRL 0:dd702039127a 228 */
alejandroRL 0:dd702039127a 229 GUI_COLOR FRAMEWIN_GetDefaultBarColor (unsigned Index);
alejandroRL 0:dd702039127a 230 int FRAMEWIN_GetDefaultBorderSize (void);
alejandroRL 0:dd702039127a 231 int FRAMEWIN_GetDefaultTitleHeight(void);
alejandroRL 0:dd702039127a 232 GUI_COLOR FRAMEWIN_GetDefaultClientColor(void);
alejandroRL 0:dd702039127a 233 const GUI_FONT * FRAMEWIN_GetDefaultFont (void);
alejandroRL 0:dd702039127a 234 GUI_COLOR FRAMEWIN_GetDefaultTextColor (unsigned Index);
alejandroRL 0:dd702039127a 235 int FRAMEWIN_OwnerDraw (const WIDGET_ITEM_DRAW_INFO * pDrawItemInfo);
alejandroRL 0:dd702039127a 236 void FRAMEWIN_SetDefaultBarColor (unsigned Index, GUI_COLOR Color);
alejandroRL 0:dd702039127a 237 void FRAMEWIN_SetDefaultBorderSize (int DefaultBorderSize);
alejandroRL 0:dd702039127a 238 void FRAMEWIN_SetDefaultTitleHeight(int DefaultTitleHeight);
alejandroRL 0:dd702039127a 239 void FRAMEWIN_SetDefaultClientColor(GUI_COLOR Color);
alejandroRL 0:dd702039127a 240 void FRAMEWIN_SetDefaultFont (const GUI_FONT * pFont);
alejandroRL 0:dd702039127a 241 int FRAMEWIN_SetDefaultTextAlign (int TextAlign);
alejandroRL 0:dd702039127a 242 void FRAMEWIN_SetDefaultTextColor (unsigned Index, GUI_COLOR Color);
alejandroRL 0:dd702039127a 243
alejandroRL 0:dd702039127a 244 /*********************************************************************
alejandroRL 0:dd702039127a 245 *
alejandroRL 0:dd702039127a 246 * Macros for compatibility
alejandroRL 0:dd702039127a 247 *
alejandroRL 0:dd702039127a 248 **********************************************************************
alejandroRL 0:dd702039127a 249 */
alejandroRL 0:dd702039127a 250 #define FRAMEWIN_SetDefaultCaptionSize(Height) FRAMEWIN_SetDefaultTitleHeight(Height)
alejandroRL 0:dd702039127a 251 #define FRAMEWIN_GetDefaultCaptionSize() FRAMEWIN_GetDefaultTitleHeight()
alejandroRL 0:dd702039127a 252 #define FRAMEWIN_CreateButton(hObj, Flags, Off, Id) FRAMEWIN_AddButton(hObj, Flags, Off, Id)
alejandroRL 0:dd702039127a 253 #define FRAMEWIN_CreateCloseButton(hObj, Flags, Off) FRAMEWIN_AddCloseButton(hObj, Flags, Off)
alejandroRL 0:dd702039127a 254 #define FRAMEWIN_CreateMaxButton(hObj, Flags, Off) FRAMEWIN_AddMaxButton(hObj, Flags, Off)
alejandroRL 0:dd702039127a 255 #define FRAMEWIN_CreateMinButton(hObj, Flags, Off) FRAMEWIN_AddMinButton(hObj, Flags, Off)
alejandroRL 0:dd702039127a 256
alejandroRL 0:dd702039127a 257 #if defined(__cplusplus)
alejandroRL 0:dd702039127a 258 }
alejandroRL 0:dd702039127a 259 #endif
alejandroRL 0:dd702039127a 260
alejandroRL 0:dd702039127a 261 #endif // GUI_WINSUPPORT
alejandroRL 0:dd702039127a 262 #endif // FRAMEWIN_H
alejandroRL 0:dd702039127a 263
alejandroRL 0:dd702039127a 264 /*************************** End of file ****************************/