mgutils.h

Go to the documentation of this file.

//
//                          IMPORTANT NOTICE
//
// The following open source license statement does not apply to any
// entity in the Exception List published by FMSoft.
//
// For more information, please visit:
//
// https://www.fmsoft.cn/exception-list
//

/*
 * $Id: mgutils.h 231 2017-10-26 07:25:36Z weiym $
 *
 *      mGUtils: A MiniGUI component which contains miscellaneous 
 *      utilities like ColorSelectionDialogBox, FileOpenDialogBox, and so on. 
 *
 */

#ifndef _MGUTILS_H
#define _MGUTILS_H

#ifdef  __cplusplus
extern "C" {
#endif

#if !defined(__NODLL__) && (defined (WIN32) || defined (__NUCLEUS_MNT__))
  #ifdef __MGUTILS_LIB__
  #define MGUTILS_EXPORT       __declspec(dllexport)
  #else
  #define MGUTILS_EXPORT       __declspec(dllimport) 
  #endif
#elif defined(__NODLL__) && defined(WIN32)
  #define MGUTILS_EXPORT       __declspec(dllimport) 
#else
  #define MGUTILS_EXPORT       
#endif

#ifndef MGUTILS_MAJOR_VERSION
#   undef PACKAGE
#   undef VERSION
#   undef PACKAGE_BUGREPORT
#   undef PACKAGE_NAME
#   undef PACKAGE_STRING
#   undef PACKAGE_TARNAME
#   undef PACKAGE_VERSION
#   ifdef __MGUTILS_LIB__
#       include "../mgutilsconfig.h"
#   else
#       include "mgutilsconfig.h"
#   endif
#endif

#define MGUTILS_MSG_BASE            MSG_USER + 0x40
#define MSG_FILESELOK               (MGUTILS_MSG_BASE + 1)
#define MSG_FILESELCANCEL           (MGUTILS_MSG_BASE + 2)
#define MSG_COLORSELOK              (MGUTILS_MSG_BASE + 3)
#define MSG_COLORSELCANCEL          (MGUTILS_MSG_BASE + 4)
#define MSG_FONTSELOK               (MGUTILS_MSG_BASE + 5)
#define MSG_FONTSELCANCEL           (MGUTILS_MSG_BASE + 6)

#ifdef _MGUTILS_MYWINS

MGUTILS_EXPORT int myMessageBox (HWND hwnd, DWORD dwStyle, const char* title,
                const char* text, ...);

MGUTILS_EXPORT int myWinMessage (HWND hwnd, const char* title, 
                const char* button1, const char* text, ...);

MGUTILS_EXPORT int myWinChoice (HWND hwnd, const char* title, 
                const char* button1, const char* button2, 
                const char* text, ...);

MGUTILS_EXPORT int myWinTernary (HWND hwnd, const char* title, 
                const char* button1, const char* button2, const char* button3,
                const char* text, ...);

MGUTILS_EXPORT void errorWindow (HWND hwnd, const char* str, const char* title);

MGUTILS_EXPORT HWND createStatusWin (HWND hParentWnd, int width, int height, 
                const char* title, const char* text, ...);

MGUTILS_EXPORT void destroyStatusWin (HWND hwnd);

/* back-compatibility definitions */
#define createToolTipWin CreateToolTipWin
#define resetToolTipWin ResetToolTipWin
#define destroyToolTipWin DestroyToolTipWin

#ifdef _MGCTRL_PROGRESSBAR

MGUTILS_EXPORT HWND createProgressWin (HWND hParentWnd, const char* title, 
                const char* label, int id, int range);

MGUTILS_EXPORT void destroyProgressWin (HWND hwnd);

#endif /* _MGCTRL_PROGRESSBAR */

typedef struct _myWinButton
{
    char*   text;
    int     id;
    DWORD   flags;
} myWINBUTTON;

/* This is an internal structure. */
typedef struct _myWinMenuItems
{
    /* The pointer to the array of the item strings. */
    char**      items;
    /* The identifier of the listbox display the menu items. */
    int         listboxid;
    /* The pointer to the array of the selection status of the items. */
    int*        selected;
    /* The minimal button identifier. */
    int         minbuttonid;
    /* The maximal button identifier. */
    int         maxbuttonid;
} myWINMENUITEMS;

MGUTILS_EXPORT int myWinMenu (HWND hParentWnd, const char* title, 
                const char* label, int width, int listboxheight, 
                char ** items, int * listItem, myWINBUTTON* buttons);

typedef struct _myWinEntry
{
    char*   text;
    char**  value;
    int     maxlen;
    DWORD   flags;
} myWINENTRY;

/* This is an internal structure. */
typedef struct _myWinEntryItems
{
    myWINENTRY* entries;
    int         entrycount;
    int         firstentryid;
    int         minbuttonid;
    int         maxbuttonid;
} myWINENTRYITEMS;

MGUTILS_EXPORT int myWinEntries (HWND hParentWnd, const char* title, 
                const char* label, int width, int editboxwidth, 
                BOOL fIME, myWINENTRY* items, myWINBUTTON* buttons);

MGUTILS_EXPORT int myWinHelpMessage (HWND hwnd, int width, int height,
                const char* help_title, const char* help_msg);

#endif /* _MGUTILS_MYWINS */

#ifdef _MGUTILS_VCONGUI

#ifndef __cplusplus
#ifndef __ECOS__
typedef enum {false, true} bool;
#endif
#endif

#define VCONGUI_VERSION "Version 0.8 (Feb. 2018)"

#define MIN_COLS    10
#define MAX_COLS    100
#define MIN_ROWS    10
#define MAX_ROWS    60

#define GetCharWidth GetSysCharWidth
#define GetCCharWidth GetSysCCharWidth
#define GetCharHeight GetSysCharHeight

typedef struct _CHILDINFO
{
    bool startupMessage;
    const char* startupStr;
    const char* execProg;
    const char* execArgs;
    
    WNDPROC     DefWinProc;
    bool        fMenu;
    int         left, top;
    int         rows, cols;
}CHILDINFO;
typedef CHILDINFO* PCHILDINFO;

void* VCOnMiniGUI (void* data);

#ifdef _MGRM_THREADS
void* NewVirtualConsole (PCHILDINFO pChildInfo);
#endif

#endif /* _MGUTILS_VCONGUI */

MGUTILS_EXPORT BOOL ShowCommonDialog (PDLGTEMPLATE dlg_template, HWND hwnd, 
        WNDPROC proc, void* private_data);

#ifdef _MGUTILS_DLGOPENFILE

#ifndef WIN32
#include <sys/types.h>
#include <dirent.h>
#endif

#define FILE_ERROR_OK           0

#define FILE_ERROR_PARAMERR     -1

#define FILE_ERROR_PATHNOTEXIST -2

#define MAX_FILTER_LEN          255

#define MY_NAMEMAX      127

#define MY_PATHMAX      255
typedef struct _FILEDLGDATA
{
        BOOL        is_save;
        
        BOOL        is_trans;
        
        char        filefullname[MY_NAMEMAX + MY_PATHMAX + 1];
        
        char        filename[MY_NAMEMAX + 1];
        
        char        filepath[MY_PATHMAX + 1];
        
        char        filter[MAX_FILTER_LEN + 1];
        
        int         filterindex;
        
        WNDPROC     hook;
} FILEDLGDATA, *PFILEDLGDATA;

#define IDC_FOSD_BASE                   520
#define IDC_FOSD_PATH_NOTE              (IDC_FOSD_BASE + 1) 
#define IDC_FOSD_PATH                   (IDC_FOSD_BASE + 2) 
#define IDC_FOSD_UPPER                  (IDC_FOSD_BASE + 3) 
#define IDC_FOSD_FILELIST               (IDC_FOSD_BASE + 4) 
#define IDC_FOSD_FILENAME_NOTE          (IDC_FOSD_BASE + 5) 
#define IDC_FOSD_FILENAME               (IDC_FOSD_BASE + 6) 
#define IDC_FOSD_FILETYPE_NOTE          (IDC_FOSD_BASE + 7) 
#define IDC_FOSD_FILETYPE               (IDC_FOSD_BASE + 8) 
#define IDC_FOSD_ISHIDE                 (IDC_FOSD_BASE + 9) 
#define IDC_FOSD_OK                     (IDC_FOSD_BASE + 10)
#define IDC_FOSD_CANCEL                 (IDC_FOSD_BASE + 11)

MGUTILS_EXPORT BOOL FileOpenSaveDialog  (PDLGTEMPLATE dlg_template, HWND hwnd, 
        WNDPROC proc, PFILEDLGDATA pfdd);

MGUTILS_EXPORT extern DLGTEMPLATE DefFileDlg;
MGUTILS_EXPORT extern DLGTEMPLATE DefSimpleFileDlg;

MGUTILS_EXPORT LRESULT DefFileDialogProc (HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam);

typedef struct _NEWFILEDLGDATA
{
    BOOL    IsSave;
    BOOL    IsTrans;
    char    filefullname[MY_NAMEMAX + MY_PATHMAX + 1];
    char    filename[MY_NAMEMAX + 1];
    char    filepath[MY_PATHMAX + 1];
    char    filter[MAX_FILTER_LEN + 1];
    int     filterindex;
} NEWFILEDLGDATA;
typedef NEWFILEDLGDATA* PNEWFILEDLGDATA;

MGUTILS_EXPORT int ShowOpenDialog (HWND hWnd, int lx, int ty, 
                int w, int h, PNEWFILEDLGDATA pnfdd);

#endif /* _MGUTILS_DLGOPENFILE */

#ifdef _MGUTILS_DLGCOLORSEL

void RGB2HSV (Uint8 r, Uint8 g, Uint8 b, 
                Uint16 *hout, Uint8 *sout, Uint8 *vout);

void HSV2RGB (Uint16 hin, Uint8 sin, Uint8 vin, 
                Uint8 *rout, Uint8 *gout, Uint8 *bout);

void YUV2RGB (int y, int u, int v, Uint8 *r, Uint8 *g, Uint8 *b);

MG_EXPORT void RGB2YUV (Uint8 r, Uint8 g, Uint8 b, int *y, int *u, int *v);

typedef struct _COLORDLGDATA {
        gal_pixel       pixel;
        
        Uint8           r, g, b;
        
        Uint16          h;
        
        Uint8           s, v;

        BOOL            is_trans;
        
        WNDPROC         hook;
} COLORDLGDATA, *PCOLORDLGDATA;

#define IDC_CSD_BASE                600 
#define IDC_CSD_BASIC_COLOR_NOTE    (IDC_CSD_BASE + 1) 
#define IDC_CSD_BASIC_COLOR          (IDC_CSD_BASE + 2)
#define IDC_CSD_BASIC_COLOR_0       (IDC_CSD_BASE + 2)
#define IDC_CSD_BASIC_COLOR_1       (IDC_CSD_BASE + 3)
#define IDC_CSD_BASIC_COLOR_2       (IDC_CSD_BASE + 4)
#define IDC_CSD_BASIC_COLOR_3       (IDC_CSD_BASE + 5)
#define IDC_CSD_BASIC_COLOR_4       (IDC_CSD_BASE + 6)
#define IDC_CSD_BASIC_COLOR_5       (IDC_CSD_BASE + 7)
#define IDC_CSD_BASIC_COLOR_6       (IDC_CSD_BASE + 8)
#define IDC_CSD_BASIC_COLOR_7       (IDC_CSD_BASE + 9)
#define IDC_CSD_BASIC_COLOR_8       (IDC_CSD_BASE + 10)  
#define IDC_CSD_BASIC_COLOR_9       (IDC_CSD_BASE + 11)
#define IDC_CSD_BASIC_COLOR_10      (IDC_CSD_BASE + 12)
#define IDC_CSD_BASIC_COLOR_11      (IDC_CSD_BASE + 13)
#define IDC_CSD_BASIC_COLOR_12      (IDC_CSD_BASE + 14)
#define IDC_CSD_BASIC_COLOR_13      (IDC_CSD_BASE + 15)
#define IDC_CSD_BASIC_COLOR_14      (IDC_CSD_BASE + 16)
#define IDC_CSD_BASIC_COLOR_15      (IDC_CSD_BASE + 17)
#define IDC_CSD_BASIC_COLOR_16      (IDC_CSD_BASE + 18)
#define IDC_CSD_BASIC_COLOR_17      (IDC_CSD_BASE + 19)
#define IDC_CSD_BASIC_COLOR_18      (IDC_CSD_BASE + 20)
#define IDC_CSD_BASIC_COLOR_19      (IDC_CSD_BASE + 21)
#define IDC_CSD_BASIC_COLOR_20      (IDC_CSD_BASE + 22)
#define IDC_CSD_BASIC_COLOR_21      (IDC_CSD_BASE + 23)
#define IDC_CSD_BASIC_COLOR_22      (IDC_CSD_BASE + 24)
#define IDC_CSD_BASIC_COLOR_23      (IDC_CSD_BASE + 25)
#define IDC_CSD_BASIC_COLOR_24      (IDC_CSD_BASE + 26)
#define IDC_CSD_BASIC_COLOR_25      (IDC_CSD_BASE + 27)
#define IDC_CSD_BASIC_COLOR_26      (IDC_CSD_BASE + 28)
#define IDC_CSD_BASIC_COLOR_27      (IDC_CSD_BASE + 29)
#define IDC_CSD_BASIC_COLOR_28      (IDC_CSD_BASE + 30)
#define IDC_CSD_BASIC_COLOR_29      (IDC_CSD_BASE + 31)
#define IDC_CSD_CUSTOM_COLOR_NOTE   (IDC_CSD_BASE + 32)
#define IDC_CSD_CUSTOM_COLOR_0      (IDC_CSD_BASE + 33)
#define IDC_CSD_CUSTOM              (IDC_CSD_BASE + 33)
#define IDC_CSD_CUSTOM_COLOR_1      (IDC_CSD_BASE + 34)
#define IDC_CSD_CUSTOM_COLOR_2      (IDC_CSD_BASE + 35)
#define IDC_CSD_CUSTOM_COLOR_3      (IDC_CSD_BASE + 36)
#define IDC_CSD_CUSTOM_COLOR_4      (IDC_CSD_BASE + 37)
#define IDC_CSD_CUSTOM_COLOR_5      (IDC_CSD_BASE + 38)
#define IDC_CSD_SPACE               (IDC_CSD_BASE + 39)
#define IDC_CSD_YSPACE              (IDC_CSD_BASE + 40)
#define IDC_CSD_COLOR               (IDC_CSD_BASE + 41)
#define IDC_CSD_NOTE_H              (IDC_CSD_BASE + 42)
#define IDC_CSD_NOTE_S              (IDC_CSD_BASE + 43)
#define IDC_CSD_NOTE_V              (IDC_CSD_BASE + 44)
#define IDC_CSD_NOTE_R              (IDC_CSD_BASE + 45)
#define IDC_CSD_NOTE_G              (IDC_CSD_BASE + 46)
#define IDC_CSD_NOTE_B              (IDC_CSD_BASE + 47)
#define IDC_CSD_VALUE_H             (IDC_CSD_BASE + 48)
#define IDC_CSD_VALUE_S             (IDC_CSD_BASE + 49)
#define IDC_CSD_VALUE_V             (IDC_CSD_BASE + 50)
#define IDC_CSD_VALUE_R             (IDC_CSD_BASE + 51)
#define IDC_CSD_VALUE_G             (IDC_CSD_BASE + 52)
#define IDC_CSD_VALUE_B             (IDC_CSD_BASE + 53)
#define IDC_CSD_ADD                 (IDC_CSD_BASE + 54)
#define IDC_CSD_OK                  (IDC_CSD_BASE + 55)
#define IDC_CSD_CANCEL              (IDC_CSD_BASE + 56)

MGUTILS_EXPORT BOOL ColorSelectDialog  (PDLGTEMPLATE dlg_template, HWND hwnd, 
        WNDPROC proc, PCOLORDLGDATA pcdd);

MGUTILS_EXPORT extern DLGTEMPLATE DefColorDlg;
MGUTILS_EXPORT extern DLGTEMPLATE DefSimpleColorDlg;

MGUTILS_EXPORT LRESULT DefColorDialogProc (HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam);

typedef struct _COLORDATA {
    DWORD           style;
    gal_pixel       pixel;
    Uint8           r, g, b;
    Uint16          h;
    Uint8           s, v;
    BOOL            is_trans;
} COLORDATA, *PCOLORDATA;

/* Internal use */
#define SELCOLOR_OK     IDOK
/* Internal use */
#define SELCOLOR_CANCEL IDCANCEL

MGUTILS_EXPORT int ColorSelDialog (HWND hWnd, int x, int y, 
                int w, int h, PCOLORDATA pClrData);

#endif /* _MGUTILS_DLGCOLORSEL */

#ifdef _MGUTILS_DLGFONTSEL

typedef struct _FONTDLGDATA {
        /* The font minimize size. */
        int             min_size;
        /* The font maximize size. */
        int             max_size;
        /* Indicates the controls is transparent or no?*/
        BOOL            is_trans;       
        
        /* The font color. */
        RGB             color;
        PLOGFONT        logfont;
        
        WNDPROC         hook;
} FONTDLGDATA, *PFONTDLGDATA;

#define IDC_FSD_BASE            540
#define IDC_FSD_FONT_NOTE       (IDC_FSD_BASE + 1) 
#define IDC_FSD_FONT            (IDC_FSD_BASE + 2)
#define IDC_FSD_STYLE_NOTE      (IDC_FSD_BASE + 3)
#define IDC_FSD_STYLE           (IDC_FSD_BASE + 4)
#define IDC_FSD_SIZE_NOTE       (IDC_FSD_BASE + 5)
#define IDC_FSD_SIZE            (IDC_FSD_BASE + 6)
#define IDC_FSD_EFFECTS_NOTE    (IDC_FSD_BASE + 7)
#define IDC_FSD_FLIP_NOTE       (IDC_FSD_BASE + 8)
#define IDC_FSD_FLIP            (IDC_FSD_BASE + 9)
#define IDC_FSD_COLOR_NOTE      (IDC_FSD_BASE + 10)  
#define IDC_FSD_COLOR           (IDC_FSD_BASE + 11)
#define IDC_FSD_ITALIC          (IDC_FSD_BASE + 12)
#define IDC_FSD_STRIKEOUT       (IDC_FSD_BASE + 13)
#define IDC_FSD_UNDERLINE       (IDC_FSD_BASE + 14)
#define IDC_FSD_SAMPLE_NOTE     (IDC_FSD_BASE + 15)
#define IDC_FSD_SAMPLE          (IDC_FSD_BASE + 16)
#define IDC_FSD_CHARSET_NOTE    (IDC_FSD_BASE + 17)
#define IDC_FSD_CHARSET         (IDC_FSD_BASE + 18)
#define IDC_FSD_OK              (IDC_FSD_BASE + 19)
#define IDC_FSD_CANCEL          (IDC_FSD_BASE + 20)

MGUTILS_EXPORT BOOL FontSelectDialog  (PDLGTEMPLATE dlg_template, HWND hwnd, 
        WNDPROC proc, PFONTDLGDATA pfsd);

MGUTILS_EXPORT extern DLGTEMPLATE DefSimpleFontDlg;
MGUTILS_EXPORT extern DLGTEMPLATE DefFontDlg;

MGUTILS_EXPORT LRESULT DefFontDialogProc (HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam);

#endif /* _MGUTILS_DLGFONTSEL */

#ifdef _MGUTILS_DLGSHOWINFO

typedef struct _INFODLGDATA {
        const char*     msg;
        WNDPROC         hook;
        
        /* for internal usage.*/
        int             nr_lines;
        int             vis_lines;
        int             start_line;
        RECT            rc;
} INFODLGDATA, *PINFODLGDATA;

#define IDC_IFD_SPIN      580

MGUTILS_EXPORT BOOL InfoShowDialog  (PDLGTEMPLATE dlg_template, HWND hwnd, 
        WNDPROC proc, PINFODLGDATA pidd);

MGUTILS_EXPORT extern DLGTEMPLATE DefInfoDlg;
MGUTILS_EXPORT extern DLGTEMPLATE DefSimpleInfoDlg;

MGUTILS_EXPORT LRESULT DefInfoDialogProc (HWND hDlg, UINT message, WPARAM wParam, LPARAM lParam);

#endif /* _MGUTILS_DLGSHOWINFO */

#ifdef  _MGUTILS_SKIN

/* skin messages (send to items) */
#define SKIN_MSG_LBUTTONDOWN    1
#define SKIN_MSG_LBUTTONUP      2
#define SKIN_MSG_CLICK          3
/*#define SKIN_MSG_DBCLICK      4 */
#define SKIN_MSG_MOUSEMOVE      5
#define SKIN_MSG_MOUSEDRAG      6
#define SKIN_MSG_SETFOCUS       7
#define SKIN_MSG_KILLFOCUS      8

/* type of item */

#define SI_TYPE_NRMLABEL        0x10000000

#define SI_TYPE_BMPLABEL        0x20000000

#define SI_TYPE_CMDBUTTON       0x30000000

#define SI_TYPE_CHKBUTTON       0x40000000

#define SI_TYPE_NRMSLIDER       0x50000000

#ifdef _MGHAVE_FIXED_MATH

#define SI_TYPE_ROTSLIDER       0x60000000
#endif

#define SI_TYPE_CONTROL         0x70000000

#define SI_TYPE_MASK            0xF0000000

/* type of hittest shape */

#define SI_TEST_SHAPE_RECT      0x01000000

#define SI_TEST_SHAPE_ELLIPSE   0x02000000

#define SI_TEST_SHAPE_LOZENGE   0x03000000

#define SI_TEST_SHAPE_LTRIANGLE 0x04000000

#define SI_TEST_SHAPE_RTRIANGLE 0x05000000

#define SI_TEST_SHAPE_UTRIANGLE 0x06000000

#define SI_TEST_SHAPE_DTRIANGLE 0x07000000

#define SI_TEST_SHAPE_MASK      0x0F000000

/* common status of item */

#define SI_STATUS_OK            0x00000001

#define SI_STATUS_VISIBLE       0x00000002

#define SI_STATUS_DISABLED      0x00000004

#define SI_STATUS_HILIGHTED     0x00000008

#define SI_STATUS_MASK          0x0000000F

/* status of button item */

#define SI_BTNSTATUS_CLICKED    0x00000010

#define SI_BTNSTATUS_CHECKED    SI_BTNSTATUS_CLICKED

#define SI_STATUS_CLICKED       SI_BTNSTATUS_CLICKED

#define SI_BTNSTATUS_MASK       0x000000F0

#define SI_CMDBUTTON_2STATE     0x00000100

/* style of normal slider item */

#define SI_NRMSLIDER_HORZ       0x00000100

#define SI_NRMSLIDER_VERT       0x00000200

#define SI_NRMSLIDER_STATIC     0x00000400

#ifdef _MGHAVE_FIXED_MATH

/* style of rotation slider item */

#define SI_ROTSLIDER_CW         0x00000100

#define SI_ROTSLIDER_ANTICW     0x00000200

#define SI_ROTSLIDER_STATIC     0x00000400

#endif /* _MGHAVE_FIXED_MATH */

#define SI_STYLE_MASK           0x0000FF00

#define CTRL_SKIN               "skin"

typedef struct skin_item_ops_s skin_item_ops_t;

typedef struct skin_head_s skin_head_t;

typedef struct skin_item_s
{
    int id;

    DWORD style;

    int x;
    int y;

    RECT item_rc;

    union {
        int bmp_index;

        HWND hwnd;
    };

    char* tip;

    DWORD attached;

    void* type_data;

    /******** start of internal fields ********/
    /* The bounding rectangle of the item. */
    RECT shape;
    /* The hit-test rectangle of the item. */
    RECT rc_hittest;
    /* The region for mouse hittest. */
    CLIPRGN region;
    /* The operation routines of the item. */
    skin_item_ops_t *ops;
    /* The parent skin. */
    skin_head_t *hostskin;
} skin_item_t;

struct skin_item_ops_s
{
    int (*init) (skin_head_t*, skin_item_t*);
    int (*deinit) (skin_item_t*);

    int (*on_create) (skin_item_t*);
    int (*on_destroy) (skin_item_t*);

    void (*draw_bg) (HDC, skin_item_t*);
    void (*draw_attached) (HDC, skin_item_t*);

    DWORD (*get_value) (skin_item_t *item);
    DWORD (*set_value) (skin_item_t *item, DWORD status);
    
    int (*item_msg_proc) (skin_item_t* item, int message, 
                    WPARAM wparam, LPARAM lparam);
};

typedef struct sie_slider_s
{
    int min_pos;
    int max_pos;
    int cur_pos;
} sie_slider_t;

typedef struct si_nrmlabel_s
{
    char* label;        

    DWORD color;        
    DWORD color_focus;  
    DWORD color_click;  
    int font_index;
} si_nrmlabel_t;

typedef struct si_bmplabel_s
{
    char* label;
    const char* label_chars;
} si_bmplabel_t;

typedef struct si_nrmslider_s
{
    sie_slider_t    slider_info;

    int thumb_bmp_index;
} si_nrmslider_t;

#ifdef _MGHAVE_FIXED_MATH

typedef struct si_rotslider_s
{
    int radius;
    int start_deg;
    int end_deg;
    int cur_pos;

    int thumb_bmp_index;
} si_rotslider_t;

#endif /* _MGHAVE_FIXED_MATH */

#define SIE_BUTTON_CLICKED      0x00000001

#define SIE_SLIDER_CHANGED      0x00000002

#define SIE_GAIN_FOCUS          0x00010000

#define SIE_LOST_FOCUS          0x00020000

typedef int (* skin_event_cb_t) (HWND hwnd, skin_item_t* item, 
                int event, void* data);
#define MSG_CB_GOON     0

#define MSG_CB_DEF_GOON 1

#define MSG_CB_STOP     2

typedef int (* skin_msg_cb_t) (HWND hwnd, int message, 
                WPARAM wparam, LPARAM lparam, int* result);

#define SKIN_STYLE_NONE     0x00000000

#define SKIN_STYLE_TOOLTIP  0x00000001

#define SKIN_STYLE_MODAL    0x00000002

struct skin_head_s
{
    char* name;

    DWORD style;

    const BITMAP* bmps;
    const LOGFONT* fonts;

    int bk_bmp_index;

    int nr_items;
    skin_item_t* items;

    DWORD attached;

    /******** start of internal fields ********/

    /* The event callback function of the skin. */
    skin_event_cb_t event_cb;

    /* The window message procedure of the skin window. */
    skin_msg_cb_t msg_cb;

    /**** The fields initialized when skin_init called. ****/
    /* The rectangle heap for hit-test regions. */
    BLOCKHEAP rc_heap;

    /**** 
     * The fields initialized when create_skin_main_window or 
     * create_skin_control called.
     ****/
    /* The handle of window in which the skin locates. */
    HWND hwnd;
    /* The handle of tool tip window. */
    HWND tool_tip;

    /* The old x and y. */
    int oldx, oldy;
    /* The current hilighted item. */
    skin_item_t* hilighted;

    /* cached identifier. */
    int cached_id;
    /* the item whose identifier is cached_id. */
    skin_item_t* cached_item;
};

MGUTILS_EXPORT BOOL skin_init (skin_head_t* skin, 
                skin_event_cb_t event_cb, skin_msg_cb_t msg_cb);

MGUTILS_EXPORT void skin_deinit (skin_head_t* skin);

MGUTILS_EXPORT HWND create_skin_main_window_ex (skin_head_t* skin, HWND hosting, 
                int lx, int ty, int rx, int by, DWORD dwExStyle, BOOL modal);
#define create_skin_main_window(skin, hosting, lx, ty, rx, by, modal) \
                create_skin_main_window_ex (skin, hosting, lx, ty, rx, by, 0, modal)

MGUTILS_EXPORT HWND create_skin_control (skin_head_t* skin, HWND parent, 
                int id, int x, int y, int w, int h);

MGUTILS_EXPORT BOOL is_skin_main_window (HWND hwnd);

MGUTILS_EXPORT void destroy_skin_window (HWND hwnd);

MGUTILS_EXPORT skin_head_t* set_window_skin (HWND hwnd, skin_head_t *new_skin);

MGUTILS_EXPORT skin_head_t* get_window_skin (HWND hwnd);

static inline skin_event_cb_t skin_set_event_cb (skin_head_t* skin, 
                skin_event_cb_t event_cb)
{
    skin_event_cb_t old = skin->event_cb;
    skin->event_cb = event_cb;
    return old;
}

static inline skin_msg_cb_t skin_set_msg_cb (skin_head_t* skin, 
                skin_msg_cb_t msg_cb)
{
    skin_msg_cb_t old = skin->msg_cb;
    skin->msg_cb = msg_cb;
    return old;
}

MGUTILS_EXPORT skin_item_t* skin_get_item (skin_head_t* skin, int id);

MGUTILS_EXPORT DWORD skin_get_item_status (skin_head_t* skin, int id);

MGUTILS_EXPORT DWORD skin_set_item_status (skin_head_t* skin, int id, DWORD status);

MGUTILS_EXPORT skin_item_t* skin_get_hilited_item (skin_head_t* skin);

MGUTILS_EXPORT DWORD skin_show_item (skin_head_t* skin, int id, BOOL show);

MGUTILS_EXPORT DWORD skin_enable_item (skin_head_t* skin, int id, BOOL enable);

MGUTILS_EXPORT skin_item_t* skin_set_hilited_item (skin_head_t* skin, int id);

MGUTILS_EXPORT BOOL skin_get_check_status (skin_head_t* skin, int id);

MGUTILS_EXPORT DWORD skin_set_check_status (skin_head_t* skin, 
                int id, BOOL check);

MGUTILS_EXPORT const char* skin_get_item_label (skin_head_t* skin, int id);

MGUTILS_EXPORT BOOL skin_set_item_label (skin_head_t* skin, 
                int id, const char* label);

MGUTILS_EXPORT HWND skin_get_control_hwnd (skin_head_t* skin, int id);

MGUTILS_EXPORT int skin_get_thumb_pos (skin_head_t* skin, int id);

MGUTILS_EXPORT BOOL skin_set_thumb_pos (skin_head_t* skin, int id, int pos);

MGUTILS_EXPORT BOOL skin_get_slider_info (skin_head_t* skin, 
                int id, sie_slider_t* sie);

MGUTILS_EXPORT BOOL skin_set_slider_info (skin_head_t* skin, 
                int id, const sie_slider_t* sie);

MGUTILS_EXPORT int skin_scale_slider_pos (const sie_slider_t* org, 
                int new_min, int new_max);

#endif /*  _MGUTILS_SKIN */

#ifdef  __cplusplus
}
#endif

#endif /* _MGUTILS_H */