开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > 通讯/手机编程 > GPS编程 > 查看源码
common.h
资源名称：GPRS_work.rar　[点击查看]
上传用户：sdaoma
上传日期：2013-08-07
资源大小：3838k
文件大小：35k
源码类别：

GPS编程

开发平台：

C/C++

common.h：源码内容
  1. /**
  2.  * file common.h
  3.  * author Wei Yongming <ymwei@minigui.org>
  4.  * date 2002/01/06
  5.  * 
  6.  * This file includes macro definitions and typedefs that commonly used 
  7.  * by MiniGUI.
  8.  *
  9.  verbatim
  10.     Copyright (C) 1998-2002 Wei Yongming.
  11.     Copyright (C) 2002-2004 Feynman Software.
  13.     This file is part of MiniGUI, a compact cross-platform Graphics 
  14.     User Interface (GUI) support system for real-time embedded systems.
  16.     This program is free software; you can redistribute it and/or modify
  17.     it under the terms of the GNU General Public License as published by
  18.     the Free Software Foundation; either version 2 of the License, or
  19.     (at your option) any later version.
  21.     This program is distributed in the hope that it will be useful,
  22.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  23.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  24.     GNU General Public License for more details.
  26.     You should have received a copy of the GNU General Public License
  27.     along with this program; if not, write to the Free Software
  28.     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  30.  endverbatim
  31.  */
  33. /*
  34.  * $Id: common.h,v 1.64 2004/10/20 02:02:11 weiym Exp $
  35.  *
  36.  *             MiniGUI for Linux/uClinux, eCos, uC/OS-II, and VxWorks version 1.6.x
  37.  *             Copyright (C) 1998-2002 Wei Yongming.
  38.  *             Copyright (C) 2002-2004 Feynman Software.
  39.  *
  40.  *             Some data types and byte order macros come from
  41.  *             LGPL'ed SDL by (Sam Lantinga, slouken@devolution.com).
  42.  *             Copyright (C) 1997-2001 Sam Lantinga
  43.  *
  44.  *             Fix point math routines come from Allegro (a gift software)
  45.  *             By Shawn Hargreaves and others.
  46.  */
  48. #ifndef _MGUI_COMMON_H
  49.   #define _MGUI_COMMON_H
  50.  
  51. #ifdef __MINIGUI_LIB__
  52.     #include "../config.h"
  53. #else
  54. //    #include "config.h"
  55. #endif
  57.     /**
  58.      * defgroup macros_types Macros and data types commonly used
  59.      * @{
  60.      */
  62.     /**
  63.      * defgroup version_info Version information
  64.      * @{
  65.      */
  67. /**
  68.  * def _VERSION_CODE(major, minor, micro)
  69.  * brief A macro that returns the version code from a major, a minor 
  70.  * and a micro version number.
  71.  *
  72.  * MiniGUI uses this macro to evaluate the version code of current MiniGUI 
  73.  * library installed in your system, and define it to _MINIGUI_VERSION_CODE. 
  74.  *
  75.  * sa _MINIGUI_VERSION_CODE
  76.  */
  77. #define _VERSION_CODE(major, minor, micro)  (((major)<<16) | ((minor)<<8) | (micro))
  79. /**
  80.  * def _MINIGUI_VERSION_CODE
  81.  * brief Version code of MiniGUI.
  82.  *
  83.  * sa _VERSION_CODE
  84.  */
  85. #define _MINIGUI_VERSION_CODE 
  86.         ((MINIGUI_MAJOR_VERSION << 16) | (MINIGUI_MINOR_VERSION << 8) | MINIGUI_MICRO_VERSION)
  88.     /** @} end of version_info */
  90.     /**
  91.      * defgroup basic_types Basic data types
  92.      * @{
  93.      */
  95. /**
  96.  * var typedef unsigned char Uint8
  97.  * brief A type definition for an 8-bit unsigned character.
  98.  */
  99. typedef unsigned char   Uint8;
  100. /**
  101.  * var typedef signed char Sint8
  102.  * brief A type definition for an 8-bit signed character.
  103.  */
  104. typedef signed char     Sint8;
  105. /**
  106.  * var typedef unsigned short Uint16
  107.  * brief A type definition for a 16-bit unsigned integer.
  108.  */
  109. typedef unsigned short  Uint16;
  110. /**
  111.  * var typedef signed short Sint16
  112.  * brief A type definition for a 16-bit signed integer.
  113.  */
  114. typedef signed short    Sint16;
  115. /**
  116.  * var typedef unsigned int Uint32
  117.  * brief A type definition for a 32-bit unsigned integer.
  118.  */
  119. typedef unsigned int    Uint32;
  120. /**
  121.  * var typedef signed int Sint32
  122.  * brief A type definition for a 32-bit signed integer.
  123.  */
  124. typedef signed int      Sint32;
  126. /* Figure out how to support 64-bit datatypes */
  127. #if !defined(__STRICT_ANSI__)
  128. #if defined(__GNUC__)
  129. #define MGUI_HAS_64BIT_TYPE long long
  130. #endif
  131. #if defined(__CC_ARM)
  132. #define MGUI_HAS_64BIT_TYPE long long
  133. #endif
  134. #endif /* !__STRICT_ANSI__ */
  136. /* The 64-bit datatype isn't supported on all platforms */
  137. #ifdef MGUI_HAS_64BIT_TYPE
  139. /**
  140.  * var typedef unsigned long long Uint64
  141.  * brief A type definition for a 64-bit unsigned integer.
  142.  *
  143.  * warning Only available under GNU C.
  144.  */
  145. typedef unsigned MGUI_HAS_64BIT_TYPE Uint64;
  146. /**
  147.  * var typedef signed long long Sint64
  148.  * brief A type definition for a 64-bit signed integer.
  149.  *
  150.  * warning Only available under GNU C.
  151.  */
  152. typedef signed MGUI_HAS_64BIT_TYPE Sint64;
  153. #else
  154. /* This is really just a hack to prevent the compiler from complaining */
  155. typedef struct {
  156. Uint32 hi;
  157. Uint32 lo;
  158. } Uint64, Sint64;
  159. #endif
  161. /* Make sure the types really have the right sizes */
  162. #define MGUI_COMPILE_TIME_ASSERT(name, x)               
  163.        typedef int MGUI_dummy_ ## name[(x) * 2 - 1]
  165. MGUI_COMPILE_TIME_ASSERT(uint8, sizeof(Uint8) == 1);
  166. MGUI_COMPILE_TIME_ASSERT(sint8, sizeof(Sint8) == 1);
  167. MGUI_COMPILE_TIME_ASSERT(uint16, sizeof(Uint16) == 2);
  168. MGUI_COMPILE_TIME_ASSERT(sint16, sizeof(Sint16) == 2);
  169. MGUI_COMPILE_TIME_ASSERT(uint32, sizeof(Uint32) == 4);
  170. MGUI_COMPILE_TIME_ASSERT(sint32, sizeof(Sint32) == 4);
  171. MGUI_COMPILE_TIME_ASSERT(uint64, sizeof(Uint64) == 8);
  172. MGUI_COMPILE_TIME_ASSERT(sint64, sizeof(Sint64) == 8);
  174. #undef MGUI_COMPILE_TIME_ASSERT
  176.     /** @} end of basic_types */
  178.     /**
  179.      * defgroup endian_info Endianness information
  180.      * @{
  181.      */
  183. /**
  184.  * def MGUI_LIL_ENDIAN
  185.  * brief Little endianness.
  186.  */
  187. #define MGUI_LIL_ENDIAN  1234
  188. /**
  189.  * def MGUI_BIG_ENDIAN
  190.  * brief Big endianness.
  191.  */
  192. #define MGUI_BIG_ENDIAN  4321
  194. /* Pardon the mess, I'm trying to determine the endianness of this host.
  195.  *    I'm doing it by preprocessor defines rather than some sort of configure
  196.  *    script so that application code can use this too.  The "right" way would
  197.  *    be to dynamically generate this file on install, but that's a lot of work.
  198.  */
  200. /**
  201.  * def MGUI_BYTEORDER
  202.  * brief The byte order (endianness) of the target system.
  203.  *
  204.  * This macro will be either defined to MGUI_LIL_ENDIAN or MGUI_BIG_ENDIAN.
  205.  * You can use the code like below
  206.  *
  207.  * code
  208.  * #if MGUI_BYTEORDER == MGUI_LIL_ENDIAN
  209.  *     ... // code for little endian system.
  210.  * #else
  211.  *     ... // code for big endian system.
  212.  * #endif
  213.  * endcode
  214.  *
  215.  * to write endianness independent code.
  216.  */
  217. #if  defined(__i386__) || defined(__ia64__) || 
  218.     (defined(__alpha__) || defined(__alpha)) || 
  219.      defined(__arm__) || 
  220.     (defined(__CC_ARM) && !defined(__BIG_ENDIAN)) || 
  221.     (defined(__mips__) && defined(__MIPSEL__)) || 
  222.      defined(__LITTLE_ENDIAN__)
  223. #define MGUI_BYTEORDER   MGUI_LIL_ENDIAN
  224. #else
  225. #define MGUI_BYTEORDER   MGUI_BIG_ENDIAN
  226. #endif
  228.     /** @} end of endian_info */
  230.     /**
  231.      * defgroup simple_types Simple and common types and macros
  232.      * @{
  233.      */
  235. /**
  236.  * var typedef int BOOL
  237.  * brief A type definition for boolean value.
  238.  */
  239. #ifndef __VXSIM__
  240. typedef int BOOL;
  241. #endif
  243. /**
  244.  * def FALSE
  245.  * brief FALSE value, defined as 0 by MiniGUI.
  246.  */
  247. #ifndef FALSE
  248.     #define FALSE       0
  249. #endif
  250. /**
  251.  * def TRUE
  252.  * brief TRUE value, defined as 1 by MiniGUI.
  253.  */
  254. #ifndef TRUE
  255.     #define TRUE        1
  256. #endif
  258. /**
  259.  * def NULL
  260.  * brief A value indicates null pointer.
  261.  */
  262. #ifndef NULL
  263. #define NULL            ((void *)0)
  264. #endif
  266. #define VOID            void
  267. #define GUIAPI
  269.     /** @} end of simple_types */
  271.     /**
  272.      * defgroup handles MiniGUI handles
  273.      * @{
  274.      */
  276. /**
  277.  * var typedef unsigned int GHANDLE
  278.  * brief General handle.
  279.  */
  280. typedef unsigned int GHANDLE;
  281. /**
  282.  * var typedef unsigned int HWND
  283.  * brief Handle to main window or control.
  284.  */
  285. typedef unsigned int HWND;
  286. /**
  287.  * var typedef unsigned int HDC
  288.  * brief Handle to device context.
  289.  */
  290. typedef unsigned int HDC;
  291. /**
  292.  * var typedef unsigned int HCURSOR
  293.  * brief Handle to cursor.
  294.  */
  295. typedef unsigned int HCURSOR;
  296. /**
  297.  * var typedef unsigned int HICON
  298.  * brief Handle to icon.
  299.  */
  300. typedef unsigned int HICON;
  301. /**
  302.  * var typedef unsigned int HMENU
  303.  * brief Handle to menu.
  304.  */
  305. typedef unsigned int HMENU;
  306. /**
  307.  * var typedef unsigned int HACCEL
  308.  * brief Handle to accelarator.
  309.  */
  310. typedef unsigned int HACCEL;
  311. /**
  312.  * var typedef unsigned int HDLG
  313.  * brief Handle to dialog box, same as HWND.
  314.  */
  315. typedef unsigned int HDLG;
  316. /**
  317.  * var typedef unsigned int HHOOK
  318.  * brief Handle to keyboard or mouse event hook.
  319.  */
  320. typedef unsigned int HHOOK;
  322.     /** @} end of handles */
  324.     /**
  325.      * defgroup win32_types Win32-like data types and macros
  326.      * @{
  327.      */
  329. /**
  330.  * var typedef unsigned char BYTE
  331.  * brief A type definition for unsigned character (byte).
  332.  */
  333. typedef unsigned char   BYTE;
  334. /**
  335.  * var typedef signed char BYTE
  336.  * brief A type definition for signed character.
  337.  */
  338. typedef signed char     SBYTE;
  339. /**
  340.  * var typedef unsigned short WORD 
  341.  * brief A type definition for unsigned short integer (word).
  342.  */
  343. #ifndef __VXSIM__
  344. typedef unsigned short  WORD;
  345. #endif
  346. /**
  347.  * var typedef signed short SWORD 
  348.  * brief A type definition for signed short integer.
  349.  */
  350. typedef signed short    SWORD;
  351. /**
  352.  * var typedef unsigned long DWORD
  353.  * brief A type definition for unsigned long integer (double word).
  354.  */
  355. #ifndef __VXSIM__
  356. typedef unsigned long   DWORD;
  357. #endif
  358. /**
  359.  * var typedef signed long SDWORD
  360.  * brief A type definition for signed long integer.
  361.  */
  362. typedef signed long     SDWORD;
  364. /**
  365.  * var typedef unsigned int UINT
  366.  * brief A type definition for unsigned integer.
  367.  */
  368. #ifndef __VXSIM__
  369. typedef unsigned int    UINT;
  370. #endif
  371. /**
  372.  * var typedef long LONG
  373.  * brief A type definition for long integer.
  374.  */
  375. typedef long            LONG;
  377. /**
  378.  * var typedef UINT WPARAM
  379.  * brief A type definition for the first message paramter.
  380.  */
  382. #ifndef __VXSIM__
  383. typedef UINT            WPARAM;
  384. #else
  385. typedef unsigned int    WPARAM;
  386. #endif
  387. /**
  388.  * var typedef DWORD WPARAM
  389.  * brief A type definition for the second message paramter.
  390.  */
  391. #ifndef __VXSIM__
  392. typedef DWORD           LPARAM;
  393. #else
  394. typedef unsigned long   LPARAM;
  395. #endif
  397. /**
  398.  * def LOBYTE(w)
  399.  * brief Returns the low byte of the word a w.
  400.  *
  401.  * sa MAKEWORD
  402.  */
  403. #define LOBYTE(w)           ((BYTE)(w))
  404. /**
  405.  * def HIBYTE(w)
  406.  * brief Returns the high byte of the word a w.
  407.  *
  408.  * sa MAKEWORD
  409.  */
  410. #define HIBYTE(w)           ((BYTE)(((WORD)(w) >> 8) & 0xFF))
  412. /**
  413.  * def MAKEWORD(low, high)
  414.  * brief Makes a word from a low byte and a high byte.
  415.  */
  416. #define MAKEWORD(low, high) ((WORD)(((BYTE)(low)) | (((WORD)((BYTE)(high))) << 8)))
  418. /**
  419.  * def LOWORD(l)
  420.  * brief Returns the low word of the double word a l
  421.  *
  422.  * sa MAKELONG
  423.  */
  424. #define LOWORD(l)           ((WORD)(DWORD)(l))
  425. /**
  426.  * def HIWORD(l)
  427.  * brief Returns the high word of the double word a l
  428.  *
  429.  * sa MAKELONG
  430.  */
  431. #define HIWORD(l)           ((WORD)((((DWORD)(l)) >> 16) & 0xFFFF))
  433. /**
  434.  * def LOSWORD(l)
  435.  * brief Returns the low signed word of the double word a l
  436.  *
  437.  * sa MAKELONG
  438.  */
  439. #define LOSWORD(l)          ((SWORD)(DWORD)(l))
  440. /**
  441.  * def HISWORD(l)
  442.  * brief Returns the high signed word of the double word a l
  443.  *
  444.  * sa MAKELONG
  445.  */
  446. #define HISWORD(l)          ((SWORD)((((DWORD)(l)) >> 16) & 0xFFFF))
  448. /**
  449.  * def MAKELONG(low, high)
  450.  * brief Makes a double word from a low word and a high word.
  451.  */
  452. #define MAKELONG(low, high) ((DWORD)(((WORD)(low)) | (((DWORD)((WORD)(high))) << 16)))
  454. /**
  455.  * def GetRValue(rgb)
  456.  * brief Gets the red component from a RGB triple value a rgb.
  457.  *
  458.  * You can make a RGB triple by using MakeRGB.
  459.  *
  460.  * sa MakeRGB
  461.  */
  462. #define GetRValue(rgb)      ((BYTE)(rgb))
  463. /**
  464.  * def GetGValue(rgb)
  465.  * brief Gets the green component from a RGB triple value a rgb.
  466.  *
  467.  * You can make a RGB triple by using MakeRGB.
  468.  *
  469.  * sa MakeRGB
  470.  */
  471. #define GetGValue(rgb)      ((BYTE)(((WORD)(rgb)) >> 8))
  472. /**
  473.  * def GetBValue(rgb)
  474.  * brief Gets the blue component from a RGB triple value a rgb.
  475.  *
  476.  * You can make a RGB triple by using MakeRGB.
  477.  *
  478.  * sa MakeRGB
  479.  */
  480. #define GetBValue(rgb)      ((BYTE)((rgb) >> 16))
  482. /**
  483.  * def MakeRGB(r, g, b)
  484.  * brief Makes a RGB triple value from red a r, green a g, and blue a b components.
  485.  *
  486.  * note The red, green, and blue components are all ranged from 0 to 255,
  487.  * and the returned value will be a double word.
  488.  *
  489.  * sa GetRValue, GetGValue, GetBValue
  490.  */
  491. #define MakeRGB(r, g, b)    (((DWORD)((BYTE)(r))) | ((DWORD)((BYTE)(g)) << 8) 
  492.                 | ((DWORD)((BYTE)(b)) << 16))
  494. /**
  495.  * A rectangle defined by coordinates of corners.
  496.  *
  497.  * note The lower-right corner does not belong to the rectangle,
  498.  * i.e. the bottom horizontal line and the right vertical line are excluded
  499.  * from the retangle.
  500.  *
  501.  * sa PRECT, GAL_Rect
  502.  */
  503. typedef struct _RECT
  504. {
  505.     /**
  506.      * the x coordinate of the upper-left corner of the rectangle.
  507.      */
  508.     int left;
  509.     /**
  510.      * the y coordinate of the upper-left corner of the rectangle.
  511.      */
  512.     int top;
  513.     /**
  514.      * the x coordinate of the lower-right corner of the rectangle.
  515.      */
  516.     int right;
  517.     /**
  518.      * the y coordinate of the lower-right corner of the rectangle.
  519.      */
  520.     int bottom;
  521. } RECT;
  522. /**
  523.  * var typedef RECT* PRECT
  524.  * brief Data type of the pointer to a RECT.
  525.  *
  526.  * sa RECT
  527.  */
  528. typedef RECT* PRECT;
  530. /**
  531.  * Point structure.
  532.  * sa PPOINT
  533.  */
  534. typedef struct _POINT
  535. {
  536.     /**
  537.      * the x coordinate of the point.
  538.      */
  539.     int x;
  540.     /**
  541.      * the y coordinate of the point.
  542.      */
  543.     int y;
  544. } POINT;
  545. /**
  546.  * var typedef POINT* PPOINT
  547.  * brief Data type of the pointer to a POINT.
  548.  *
  549.  * sa POINT
  550.  */
  551. typedef POINT* PPOINT;
  553. /**
  554.  * Size structure of a 2-dimension object.
  555.  * sa PSIZE
  556.  */
  557. typedef struct _SIZE
  558. {
  559.     /**
  560.      * the extent in x coordinate of a 2D object.
  561.      */
  562.     int cx;
  563.     /**
  564.      * the extent in y coordinate of a 2D object.
  565.      */
  566.     int cy;
  567. } SIZE;
  568. /**
  569.  * var typedef SIZE* PSIZE
  570.  * brief Data type of the pointer to a SIZE.
  571.  *
  572.  * sa SIZE
  573.  */
  574. typedef SIZE* PSIZE;
  576. /**
  577.  * RGB triple structure.
  578.  * sa PRGB, GAL_Color
  579.  */
  580. typedef struct _RGB
  581. {
  582.     /**
  583.      * the red component of a RGB triple.
  584.      */
  585.     BYTE r;
  586.     /**
  587.      * the green component of a RGB triple.
  588.      */
  589.     BYTE g;
  590.     /**
  591.      * the blue component of a RGB triple.
  592.      */
  593.     BYTE b;
  594.     /**
  595.      * Reserved for alignment, maybe used for the alpha component of a RGB triple. 
  596.      */
  597.     BYTE a;
  598. } RGB;
  599. typedef RGB* PRGB;
  601.     /** @} end of win32_types */
  603.     /**
  604.      * defgroup gdi_types Data types for GDI
  605.      * @{
  606.      */
  607. /**
  608.  * var typedef Sint8 gal_sint8
  609.  * brief Data type of 8-bit signed integer.
  610.  *
  611.  * sa Sint8
  612.  */
  613. typedef Sint8       gal_sint8;
  614. /**
  615.  * var typedef Uint8 gal_uint8
  616.  * brief Data type of 8-bit unsigned integer.
  617.  *
  618.  * sa Uint8
  619.  */
  620. typedef Uint8       gal_uint8;
  622. /**
  623.  * var typedef Sint16 gal_sint16
  624.  * brief Data type of 16-bit signed integer.
  625.  *
  626.  * sa Sint16
  627.  */
  628. typedef Sint16      gal_sint16;
  629. /**
  630.  * var typedef Uint16 gal_uint16
  631.  * brief Data type of 16-bit unsigned integer.
  632.  *
  633.  * sa Uint16
  634.  */
  635. typedef Uint16      gal_uint16;
  637. /**
  638.  * var typedef Sint32 gal_sint16
  639.  * brief Data type of 32-bit signed integer.
  640.  *
  641.  * sa Sint32
  642.  */
  643. typedef Sint32      gal_sint32;
  644. /**
  645.  * var typedef Uint32 gal_uint16
  646.  * brief Data type of 32-bit unsigned integer.
  647.  *
  648.  * sa Uint32
  649.  */
  650. typedef Uint32      gal_uint32;
  652. /**
  653.  * var typedef signed int gal_sint
  654.  * brief Data type of signed integer.
  655.  */
  656. typedef signed int      gal_sint;
  657. /**
  658.  * var typedef unsigned int gal_uint
  659.  * brief Data type of unsigned integer.
  660.  */
  661. typedef unsigned int    gal_uint;
  663. /**
  664.  * var typedef Uint32 gal_pixel 
  665.  * brief Data type of pixel value
  666.  */
  667. typedef Uint32          gal_pixel;
  668. /**
  669.  * var typedef Uint32 gal_attr
  670.  * brief Data type of attribute value
  671.  */
  672. typedef Uint32          gal_attr;
  674. /**
  675.  * var typedef long fixed.
  676.  * brief Data type of fixed point.
  677.  */
  678. typedef long fixed;
  680. /**
  681.  * RGBA quarter structure.
  682.  * sa RGB
  683.  */
  684. typedef struct GAL_Color
  685. {
  686.     /**
  687.      * the red component of a RGBA quarter.
  688.      */
  689.     gal_uint8 r;
  690.     /**
  691.      * the green component of a RGBA quarter.
  692.      */
  693.     gal_uint8 g;
  694.     /**
  695.      * the blue component of a RGBA quarter.
  696.      */
  697.     gal_uint8 b;
  698.     /**
  699.      * the alpha component of a RGBA quarter.
  700.      */
  701.     gal_uint8 a;
  702. } GAL_Color;
  704. /**
  705.  * Palette structure.
  706.  * sa GAL_Color
  707.  */
  708. typedef struct GAL_Palette
  709. {
  710.     /**
  711.      * the number of palette items.
  712.      */
  713.     int        ncolors;
  714.     /**
  715.      * the pointer to the array of palette items.
  716.      */
  717.     GAL_Color* colors;
  718. } GAL_Palette;
  720. /**
  721.  * A rectangle defined by upper-left coordinates and width/height.
  722.  * sa RECT 
  723.  */
  724. typedef struct GAL_Rect {
  725.     /**
  726.      * the coordinates of the upper-left corner of the rectangle.
  727.      */
  728.     Sint32      x, y;
  729.     /**
  730.      * the width and height of the rectangle.
  731.      */
  732.     Sint32      w, h;
  733. } GAL_Rect;
  735.     /** @} end of gdi_types */
  737.     /**
  738.      * defgroup key_defs Macros for key codes and shift status
  739.      * @{
  740.      */
  742. /**
  743.  * def MGUI_NR_KEYS
  744.  * brief Number of MiniGUI keys.
  745.  *
  746.  * The number of MiniGUI keys is defined to 255 by default. This means that
  747.  * MiniGUI can destinguish 255 different keys with each has an unique scan code.
  748.  * The scan codes below 129 are defined for PC keyboard by default. 
  749.  * If your system has a large amount of keys, you can define the scan code of keys 
  750.  * ranged from 1 to 255 in your IAL engine. And your application will receive
  751.  * a MSG_KEYDOWN and MSG_KEYUP messages when a key pressed and released, and the
  752.  * wParam of the messages will be defined to be equal to the scan code
  753.  * of the key.
  754.  *
  755.  * sa NR_KEYS, SCANCODE_USER
  756.  */
  757. #define MGUI_NR_KEYS                    255
  759. /**
  760.  * def NR_KEYS
  761.  * brief The number of keys defined by Linux operating system. 
  762.  *
  763.  * For a PC box, NR_KEYS is defined to 128 by default. You can define
  764.  * some input events from an input device other than keyboard, e.g. 
  765.  * your remote controller, as key events with different scan codes from 
  766.  * those of PC's. MiniGUI can support 255 keys, and the constant
  767.  * define by MGUI_NR_KEYS.
  768.  *
  769.  * sa MGUI_NR_KEYS
  770.  */
  771. #ifndef NR_KEYS
  772. #define NR_KEYS                         128
  773. #endif
  775. /**
  776.  * def SCANCODE_USER
  777.  * brief The first key scan code different from OS defined ones.
  778.  *
  779.  * You can define your special key scan codes like below
  780.  *
  781.  * code
  782.  * #define SCANCODE_PLAY    (SCANCODE_USER)
  783.  * #define SCANCODE_STOP    (SCANCODE_USER + 1)
  784.  * #define SCANCODE_PAUSE   (SCANCODE_USER + 2)
  785.  * endcode
  786.  *
  787.  * to distinguish the keys on your remote controller.
  788.  *
  789.  * sa MGUI_NR_KEYS, NR_KEYS
  790.  */
  791. #define SCANCODE_USER                   (NR_KEYS + 1)
  793. #define SCANCODE_ESCAPE                 1
  795. #define SCANCODE_1                      2
  796. #define SCANCODE_2                      3
  797. #define SCANCODE_3                      4
  798. #define SCANCODE_4                      5
  799. #define SCANCODE_5                      6
  800. #define SCANCODE_6                      7
  801. #define SCANCODE_7                      8
  802. #define SCANCODE_8                      9
  803. #define SCANCODE_9                      10
  804. #define SCANCODE_0                      11
  806. #define SCANCODE_MINUS                  12
  807. #define SCANCODE_EQUAL                  13
  809. #define SCANCODE_BACKSPACE              14
  810. #define SCANCODE_TAB                    15
  812. #define SCANCODE_Q                      16
  813. #define SCANCODE_W                      17
  814. #define SCANCODE_E                      18
  815. #define SCANCODE_R                      19
  816. #define SCANCODE_T                      20
  817. #define SCANCODE_Y                      21
  818. #define SCANCODE_U                      22
  819. #define SCANCODE_I                      23
  820. #define SCANCODE_O                      24
  821. #define SCANCODE_P                      25
  822. #define SCANCODE_BRACKET_LEFT           26
  823. #define SCANCODE_BRACKET_RIGHT          27
  825. #define SCANCODE_ENTER                  28
  827. #define SCANCODE_LEFTCONTROL            29
  829. #define SCANCODE_A                      30
  830. #define SCANCODE_S                      31
  831. #define SCANCODE_D                      32
  832. #define SCANCODE_F                      33
  833. #define SCANCODE_G                      34
  834. #define SCANCODE_H                      35
  835. #define SCANCODE_J                      36
  836. #define SCANCODE_K                      37
  837. #define SCANCODE_L                      38
  838. #define SCANCODE_SEMICOLON              39
  839. #define SCANCODE_APOSTROPHE             40
  840. #define SCANCODE_GRAVE                  41
  842. #define SCANCODE_LEFTSHIFT              42
  843. #define SCANCODE_BACKSLASH              43
  845. #define SCANCODE_Z                      44
  846. #define SCANCODE_X                      45
  847. #define SCANCODE_C                      46
  848. #define SCANCODE_V                      47
  849. #define SCANCODE_B                      48
  850. #define SCANCODE_N                      49
  851. #define SCANCODE_M                      50
  852. #define SCANCODE_COMMA                  51
  853. #define SCANCODE_PERIOD                 52
  854. #define SCANCODE_SLASH                  53
  856. #define SCANCODE_RIGHTSHIFT             54
  857. #define SCANCODE_KEYPADMULTIPLY         55
  859. #define SCANCODE_LEFTALT                56
  860. #define SCANCODE_SPACE                  57
  861. #define SCANCODE_CAPSLOCK               58
  863. #define SCANCODE_F1                     59
  864. #define SCANCODE_F2                     60
  865. #define SCANCODE_F3                     61
  866. #define SCANCODE_F4                     62
  867. #define SCANCODE_F5                     63
  868. #define SCANCODE_F6                     64
  869. #define SCANCODE_F7                     65
  870. #define SCANCODE_F8                     66
  871. #define SCANCODE_F9                     67
  872. #define SCANCODE_F10                    68
  874. #define SCANCODE_NUMLOCK                69
  875. #define SCANCODE_SCROLLLOCK             70
  877. #define SCANCODE_KEYPAD7                71
  878. #define SCANCODE_CURSORUPLEFT           71
  879. #define SCANCODE_KEYPAD8                72
  880. #define SCANCODE_CURSORUP               72
  881. #define SCANCODE_KEYPAD9                73
  882. #define SCANCODE_CURSORUPRIGHT          73
  883. #define SCANCODE_KEYPADMINUS            74
  884. #define SCANCODE_KEYPAD4                75
  885. #define SCANCODE_CURSORLEFT             75
  886. #define SCANCODE_KEYPAD5                76
  887. #define SCANCODE_KEYPAD6                77
  888. #define SCANCODE_CURSORRIGHT            77
  889. #define SCANCODE_KEYPADPLUS             78
  890. #define SCANCODE_KEYPAD1                79
  891. #define SCANCODE_CURSORDOWNLEFT         79
  892. #define SCANCODE_KEYPAD2                80
  893. #define SCANCODE_CURSORDOWN             80
  894. #define SCANCODE_KEYPAD3                81
  895. #define SCANCODE_CURSORDOWNRIGHT        81
  896. #define SCANCODE_KEYPAD0                82
  897. #define SCANCODE_KEYPADPERIOD           83
  899. #define SCANCODE_LESS                   86
  901. #define SCANCODE_F11                    87
  902. #define SCANCODE_F12                    88
  904. #define SCANCODE_KEYPADENTER            96
  905. #define SCANCODE_RIGHTCONTROL           97
  906. #define SCANCODE_CONTROL                97
  907. #define SCANCODE_KEYPADDIVIDE           98
  908. #define SCANCODE_PRINTSCREEN            99
  909. #define SCANCODE_RIGHTALT               100
  910. #define SCANCODE_BREAK                  101    /* Beware: is 119     */
  911. #define SCANCODE_BREAK_ALTERNATIVE      119    /* on some keyboards! */
  913. #define SCANCODE_HOME                   102
  914. #define SCANCODE_CURSORBLOCKUP          103    /* Cursor key block */
  915. #define SCANCODE_PAGEUP                 104
  916. #define SCANCODE_CURSORBLOCKLEFT        105    /* Cursor key block */
  917. #define SCANCODE_CURSORBLOCKRIGHT       106    /* Cursor key block */
  918. #define SCANCODE_END                    107
  919. #define SCANCODE_CURSORBLOCKDOWN        108    /* Cursor key block */
  920. #define SCANCODE_PAGEDOWN               109
  921. #define SCANCODE_INSERT                 110
  922. #define SCANCODE_REMOVE                 111
  924. #define SCANCODE_PAUSE                  119
  926. #define SCANCODE_POWER                  120
  927. #define SCANCODE_SLEEP                  121
  928. #define SCANCODE_WAKEUP                 122
  930. #define SCANCODE_LEFTWIN                125
  931. #define SCANCODE_RIGHTWIN               126
  932. #define SCANCODE_MENU                   127
  934. #define SCANCODE_LEFTBUTTON             0x1000
  935. #define SCANCODE_RIGHTBUTTON            0x2000
  936. #define SCANCODE_MIDDLBUTTON            0x4000
  938. /**
  939.  * def KS_CAPTURED 
  940.  * brief This status indicate that the mouse is captured by a window when 
  941.  * the mouse message posted.
  942.  *
  943.  * You can test the status by AND'ed with lParam of the message, like below:
  944.  *
  945.  * code
  946.  *      switch (message) {
  947.  *      case MSG_MOUSEMOVE:
  948.  *          if (lParam & KS_CAPTURED) {
  949.  *              // the mouse is captured by this window.
  950.  *              ...
  951.  *          }
  952.  *          break;
  953.  *      ...
  954.  * endcode
  955.  *
  956.  * sa mouse_msgs
  957.  */
  958. #define KS_CAPTURED                     0x00000400
  959. /**
  960.  * def KS_IMEPOST
  961.  * brief This status indicate that the key message is posted by the IME window.
  962.  *
  963.  * sa key_msgs
  964.  */
  965. #define KS_IMEPOST                      0x00000200
  966. /**
  967.  * def KS_CAPSLOCK
  968.  * brief This status indicate that the CapsLock key was locked when 
  969.  * the key or mouse message posted to the window.
  970.  *
  971.  * You can test the status by AND'ed with lParam of the message, like below
  972.  *
  973.  * code
  974.  *      switch (message) {
  975.  *      case MSG_KEYDOWN:
  976.  *          if (lParam & KS_CAPSLOCK) {
  977.  *              // the CapsLock key is locked.
  978.  *              ...
  979.  *          }
  980.  *          break;
  981.  *      ...
  982.  * endcode
  983.  *
  984.  * sa key_msgs
  985.  */
  986. #define KS_CAPSLOCK                     0x00000100
  987. /**
  988.  * def KS_NUMLOCK
  989.  * brief This status indicate that the NumLock key was locked when 
  990.  * the key or mouse message posted to the window.
  991.  *
  992.  * sa key_msgs
  993.  */
  994. #define KS_NUMLOCK                      0x00000080
  995. /**
  996.  * def KS_SCROLLLOCK
  997.  * brief This status indicate that the ScrollLock key was locked when
  998.  * the key or mouse message posted to the window.
  999.  *
  1000.  * sa key_msgs
  1001.  */
  1002. #define KS_SCROLLLOCK                   0x00000040
  1003. /**
  1004.  * def KS_LEFTCTRL
  1005.  * brief This status indicate that the left-Ctrl key was pressed when
  1006.  * the key or mouse message posted to the window.
  1007.  *
  1008.  * sa key_msgs
  1009.  */
  1010. #define KS_LEFTCTRL                     0x00000020
  1011. /**
  1012.  * def KS_RIGHTCTRL
  1013.  * brief This status indicate that the right-Ctrl key was pressed when
  1014.  * the key or mouse message posted to the window.
  1015.  *
  1016.  * sa key_msgs
  1017.  */
  1018. #define KS_RIGHTCTRL                    0x00000010
  1019. /**
  1020.  * def KS_CTRL
  1021.  * brief This status indicate that either the left-Ctrl key or the right-Ctrl key 
  1022.  * was pressed when the key or mouse message posted to the window.
  1023.  *
  1024.  * sa key_msgs
  1025.  */
  1026. #define KS_CTRL                         0x00000030
  1027. /**
  1028.  * def KS_LEFTALT
  1029.  * brief This status indicate that left-Alt key was pressed when
  1030.  * the key  or mouse message posted to the window.
  1031.  *
  1032.  * sa key_msgs
  1033.  */
  1034. #define KS_LEFTALT                      0x00000008
  1035. /**
  1036.  * def KS_RIGHTALT
  1037.  * brief This status indicate that right-Alt key was pressed when
  1038.  * the key  or mouse message posted to the window.
  1039.  *
  1040.  * sa key_msgs
  1041.  */
  1042. #define KS_RIGHTALT                     0x00000004
  1043. /**
  1044.  * def KS_ALT
  1045.  * brief This status indicate that either the left-Alt key or the right-Alt key 
  1046.  * was pressed when the key or mouse message posted to the window.
  1047.  *
  1048.  * sa key_msgs
  1049.  */
  1050. #define KS_ALT                          0x0000000C
  1051. /**
  1052.  * def KS_LEFTSHIFT
  1053.  * brief This status indicate that left-Shift key was pressed when
  1054.  * the key  or mouse message posted to the window.
  1055.  *
  1056.  * sa key_msgs
  1057.  */
  1058. #define KS_LEFTSHIFT                    0x00000002
  1059. /**
  1060.  * def KS_RIGHTSHIFT
  1061.  * brief This status indicate that right-Shift key was pressed when
  1062.  * the key  or mouse message posted to the window.
  1063.  *
  1064.  * sa key_msgs
  1065.  */
  1066. #define KS_RIGHTSHIFT                   0x00000001
  1067. /**
  1068.  * def KS_SHIFT
  1069.  * brief This status indicate that either the left-Shift key or the right-Shift key 
  1070.  * was pressed when the key or mouse message posted to the window.
  1071.  *
  1072.  * sa key_msgs
  1073.  */
  1074. #define KS_SHIFT                        0x00000003
  1075. /**
  1076.  * def MASK_KS_SHIFTKEYS
  1077.  * brief The mask of key status.
  1078.  */
  1079. #define MASK_KS_SHIFTKEYS               0x00000FFF
  1081. /**
  1082.  * def KS_LEFTBUTTON
  1083.  * brief This status indicate that left button was pressed when 
  1084.  * the key or mouse message posted to the window.
  1085.  *
  1086.  * sa key_msgs
  1087.  */
  1088. #define KS_LEFTBUTTON                   0x00001000
  1089. /**
  1090.  * def KS_RIGHTBUTTON
  1091.  * brief This status indicate that right button was pressed when 
  1092.  * the key or mouse message posted to the window.
  1093.  *
  1094.  * sa key_msgs
  1095.  */
  1096. #define KS_RIGHTBUTTON                  0x00002000
  1097. /**
  1098.  * def KS_MIDDLBUTTON
  1099.  * brief This status indicate that middle button was pressed when 
  1100.  * the key or mouse message posted to the window.
  1101.  *
  1102.  * sa key_msgs
  1103.  */
  1104. #define KS_MIDDLBUTTON                  0x00004000
  1105. /**
  1106.  * def MASK_KS_BUTTONS
  1107.  * brief The mask of mouse button status.
  1108.  */
  1109. #define MASK_KS_BUTTONS                 0x0000F000
  1111.     /** @} end of key_defs */
  1113.     /**
  1114.      * defgroup err_codes Error codes
  1115.      * @{
  1116.      */
  1117. #define ERR_OK                   0
  1118. #define ERR_INV_HWND            -1
  1119. #define ERR_QUEUE_FULL          -2
  1121. #define ERR_INVALID_HANDLE      -3
  1122. #define ERR_INVALID_HMENU       -4
  1123. #define ERR_INVALID_POS         -5
  1124. #define ERR_INVALID_ID          -6
  1125. #define ERR_RES_ALLOCATION      -7
  1127. #define ERR_CTRLCLASS_INVNAME   -8
  1128. #define ERR_CTRLCLASS_INVLEN    -9
  1129. #define ERR_CTRLCLASS_MEM       -10
  1130. #define ERR_CTRLCLASS_INUSE     -11
  1132. #define ERR_ALREADY_EXIST       -12
  1133. #define ERR_NO_MATCH            -13
  1134. #define ERR_BAD_OWNER           -14
  1136. #define ERR_IME_TOOMUCHIMEWND   -15
  1137. #define ERR_IME_NOSUCHIMEWND    -16
  1138. #define ERR_IME_NOIMEWND        -17
  1140. #define ERR_CONFIG_FILE         -18
  1141. #define ERR_FILE_IO             -19
  1142. #define ERR_GFX_ENGINE          -20
  1143. #define ERR_INPUT_ENGINE        -21
  1144. #define ERR_NO_ENGINE           -22
  1146.     /** @} end of err_codes */
  1148.     /**
  1149.      * defgroup misc_macros Miscellaneous macros
  1150.      * @{
  1151.      */
  1152. /**
  1153.  * def TABLESIZE(table)
  1154.  * brief A macro returns the number of elements in a a table.
  1155.  */
  1156. #define TABLESIZE(table)    (sizeof(table)/sizeof(table[0]))
  1158. /* MAX/MIN/ABS macors */
  1159. /**
  1160.  * def MAX(x, y)
  1161.  * brief A macro returns the maximum of a x and a y.
  1162.  */
  1163. #ifndef MAX
  1164. #define MAX(x, y)           ((x > y)?x:y)
  1165. #endif
  1166. /**
  1167.  * def MIN(x, y)
  1168.  * brief A macro returns the minimum of a x and a y.
  1169.  */
  1170. #ifndef MIN
  1171. #define MIN(x, y)           ((x < y)?x:y)
  1172. #endif
  1173. /**
  1174.  * def ABS(x)
  1175.  * brief A macro returns the absolute value of a x.
  1176.  */
  1177. #ifndef ABS
  1178. #define ABS(x)              (((x)<0) ? -(x) : (x))
  1179. #endif
  1181. #ifndef __NOLINUX__
  1182. /* Common used definitions */
  1183. #ifndef PATH_MAX
  1184. //    #include <dirent.h>
  1185. #endif
  1187. #ifndef PATH_MAX
  1188.     #define PATH_MAX    128
  1189. #endif
  1191. #ifndef NAME_MAX
  1192.     #define NAME_MAX    64
  1193. #endif
  1194. /**
  1195.  * def MAX_PATH
  1196.  * brief The possible maximal length of a path name.
  1197.  * note This definition is an alias of PATH_MAX
  1198.  */
  1199. #define MAX_PATH        PATH_MAX
  1200. /**
  1201.  * def MAX_NAME
  1202.  * brief The possible maximal length of a file name.
  1203.  * note This definition is an alias of NAME_MAX
  1204.  */
  1205. #define MAX_NAME        NAME_MAX
  1206. #else
  1207. #define MAX_PATH        256
  1208. #define MAX_NAME        64
  1209. #endif
  1211. /**
  1212.  * enum SBPolicyType
  1213.  * brief Scroll bar display policies in scrolled window
  1214.  */
  1215. typedef enum
  1216. {
  1217.   /**
  1218.    * the scroll bar is always visible
  1219.    */
  1220.   SB_POLICY_ALWAYS,
  1221.   /**
  1222.    * the scroll bar is shown or hided automatically
  1223.    */
  1224.   SB_POLICY_AUTOMATIC,
  1225.   /** the scroll bar is never visbile
  1226.    */
  1227.   SB_POLICY_NEVER
  1228. } SBPolicyType;
  1231.     /** @} end of misc_macros */
  1233.     /** @} end of macros_types */
  1235. #ifdef __cplusplus
  1236. extern "C" {
  1237. #endif
  1239. #ifdef __UCOSII__
  1241. /* use our own implementation of strdup */
  1242. #undef HAVE_STRDUP
  1243. #define strdup own_strdup
  1245. /* The entry of MiniGUI */
  1246. int minigui_entry (int argc, const char* argv[]);
  1247. int ucos2_posix_pthread_init (void);
  1248. int ucos2_malloc_init (void);
  1250. #endif
  1252. #ifndef HAVE_STRDUP
  1253. char *strdup(const char *s);
  1254. #endif
  1256. #ifndef HAVE_STRCASECMP
  1257. int strcasecmp(const char *s1, const char *s2);
  1258. #endif
  1260. #if 0
  1261. #include <sys/time.h>
  1262. struct timezone;
  1263. int gettimeofday(struct timeval *tv, struct timezone* tz);
  1264. #endif
  1266. #ifdef __cplusplus
  1267. };  /* end of extern "C" */
  1268. #endif
  1270. #ifdef _USE_OWN_MALLOC
  1272. #define USE_DL_PREFIX
  1274. #include "own_malloc.h"
  1276. /* wrappers for malloc functions */
  1277. #define calloc      dlcalloc
  1278. #define free        dlfree
  1279. #define malloc      dlmalloc
  1280. #define memalign    dlmemalign
  1281. #define realloc     dlrealloc
  1282. #define valloc      dlvalloc
  1284. #endif
  1286. /* Do not use the alloca of ARMCC */
  1287. #if defined(__CC_ARM)
  1288. #   undef HAVE_ALLOCA
  1289. #   undef HAVE_ALLOCA_H
  1290. #endif
  1292. #ifdef HAVE_ALLOCA_H
  1293. #   include <alloca.h>
  1294. #   define ALLOCATE_LOCAL(size)    alloca((int)(size))
  1295. #   define DEALLOCATE_LOCAL(ptr)   /* as nothing */
  1296. #else
  1297. #   define ALLOCATE_LOCAL(size)    malloc((int)(size))
  1298. #   define DEALLOCATE_LOCAL(ptr)   free(ptr)
  1299. #endif
  1301. #ifdef _USE_OWN_STDIO
  1303. #if defined (__UCOSII__) || defined (__VXWORKS__)
  1304. #   undef _PRINTF_FLOATING_POINT
  1305. #   undef _SCANF_FLOATING_POINT
  1306. #else
  1307. #   ifdef HAVE_MATH_H
  1308. #       define _PRINTF_FLOATING_POINT      1
  1309. #       define _SCANF_FLOATING_POINT       1
  1310. #   endif
  1311. #endif
  1313. #undef _I18N_MB_REQUIRED
  1315. #if defined(__VXWORKS__)
  1316.   #define _USE_OWN_SNPRINTF
  1317.   #define _USE_OWN_VSNPRINTF
  1318.   #define _USE_OWN_VFNPRINTF
  1319. #else
  1320.   #define _USE_OWN_PRINTF
  1321.   #define _USE_OWN_FPRINTF
  1322.   #define _USE_OWN_SPRINTF
  1323.   #define _USE_FNPRINTF
  1324.   #define _USE_OWN_SNPRINTF
  1325.   #define _USE_OWN_VPRINTF
  1326.   #define _USE_OWN_VFPRINTF
  1327.   #define _USE_OWN_VSPRINTF
  1328.   #define _USE_OWN_VFNPRINTF
  1329.   #define _USE_OWN_VSNPRINTF
  1330.   #define _USE_OWN_SCANF
  1331.   #define _USE_OWN_FSCANF
  1332.   #define _USE_OWN_SSCANF
  1333.   #define _USE_OWN_VSCANF
  1334.   #define _USE_OWN_VFSCANF
  1335.   #define _USE_OWN_VSSCANF
  1336. #endif
  1338. #include "own_stdio.h"
  1340. /* wrappers for stdio functions */
  1341. #ifdef _USE_OWN_PRINTF
  1342.   #define printf      own_printf
  1343. #endif
  1345. #ifdef _USE_OWN_FPRINTF
  1346.   #define fprintf     own_fprintf
  1347. #endif
  1349. #ifdef _USE_OWN_SPRINTF
  1350.   #define sprintf     own_sprintf
  1351. #endif
  1353. #ifdef _USE_FNPRINTF
  1354.   #define fnprintf    own_fnprintf
  1355. #endif
  1357. #ifdef _USE_OWN_SNPRINTF
  1358.   #define snprintf    own_snprintf
  1359. #endif
  1361. #ifdef _USE_OWN_VPRINTF
  1362.   #define vprintf     own_vprintf
  1363. #endif
  1365. #ifdef _USE_OWN_VFPRINTF
  1366.   #define vfprintf    own_vfprintf
  1367. #endif
  1369. #ifdef _USE_OWN_VSPRINTF
  1370.   #define vsprintf    own_vsprintf
  1371. #endif
  1373. #ifdef _USE_OWN_VFNPRINTF
  1374.   #define vfnprintf   own_vfnprintf
  1375. #endif
  1377. #ifdef _USE_OWN_VSNPRINTF
  1378.   #define vsnprintf   own_vsnprintf
  1379. #endif
  1381. #ifdef _USE_OWN_SCANF
  1382.   #define scanf       own_scanf
  1383. #endif
  1385. #ifdef _USE_OWN_FSCANF
  1386.   #define fscanf      own_fscanf
  1387. #endif
  1389. #ifdef _USE_OWN_SSCANF
  1390.   #define sscanf      own_sscanf
  1391. #endif
  1393. #ifdef _USE_OWN_VSCANF
  1394.   #define vscanf      own_vscanf
  1395. #endif
  1397. #ifdef _USE_OWN_VFSCANF
  1398.   #define vfscanf     own_vfscanf
  1399. #endif
  1401. #ifdef _USE_OWN_VSSCANF
  1402.   #define vsscanf     own_vsscanf
  1403. #endif
  1405. #endif /* _USE_OWN_STDIO */
  1407. #ifdef _DEBUG_MSG
  1408. #   define _MG_PRINTF(fmt...) fprintf (stderr, fmt)
  1409. #else
  1410. #   define _MG_PRINTF(fmt) 
  1411. #endif
  1413. #endif /* _MGUI_COMMON_H */