mrdr.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
//

#ifndef _MGNCS_RENDER_H
#define _MGNCS_RENDER_H

#ifdef __cplusplus
extern "C" {
#endif


#define NCS_TYPE_MASK               WE_ATTR_TYPE_MASK
#define NCS_TYPE_COLOR_MASK         WE_ATTR_TYPE_COLOR_MASK
#define NCS_TYPE_INDEX_MASK         WE_ATTR_TYPE_INDEX_MASK

#define NCS_TYPE_METRICS            0x6000
#define NCS_TYPE_COLOR              0x7000
#define NCS_TYPE_IMAGE              0x8000
#define NCS_TYPE_INT                0x9000
#define NCS_TYPE_FGC                NCS_TYPE_COLOR
#define NCS_TYPE_BGC                (NCS_TYPE_COLOR | 0x0100) 

#define NCS_TYPE_IS_IMAGE(id)       (((id) & NCS_TYPE_MASK) == NCS_TYPE_IMAGE)

#define NCS_METRICS_BASEID          (NCS_TYPE_METRICS | 0)
#define NCS_FGC_BASEID              (NCS_TYPE_FGC | 0)
#define NCS_BGC_BASEID              (NCS_TYPE_BGC | 0)
#define NCS_INT_BASEID              (NCS_TYPE_INT | 0)
#define NCS_IMAGE_BASEID            (NCS_TYPE_IMAGE | 0)

#define NCS_FONT_NUMBER             0
#define NCS_METRICS_NUMBER          2 
#define NCS_COLORS_NUMBER           9
#define NCS_IMAGE_NUMBER            17 
#define NCS_INT_NUMBER              5

//common for all renderer
#define NCS_FGC_3DBODY              NCS_FGC_BASEID
#define NCS_BGC_3DBODY              NCS_BGC_BASEID 

#define NCS_FGC_WINDOW              NCS_FGC_BASEID  + 1
#define NCS_BGC_WINDOW              NCS_BGC_BASEID  + 1 

#define NCS_FGC_SELECTED_ITEM       NCS_FGC_BASEID  + 2
#define NCS_BGC_SELECTED_ITEM       NCS_BGC_BASEID  + 2 

#define NCS_FGC_HILIGHT_ITEM        NCS_FGC_BASEID  + 3
#define NCS_BGC_HILIGHT_ITEM        NCS_BGC_BASEID  + 3 

#define NCS_FGC_DISABLED_ITEM       NCS_FGC_BASEID  + 4
#define NCS_BGC_DISABLED_ITEM       NCS_BGC_BASEID  + 4 

#define NCS_BGC_SELITEM_NOFOCUS     NCS_BGC_BASEID  + 5 

#define NCS_IMAGE_BKGND             NCS_IMAGE_BASEID
#define NCS_MODE_BKIMAGE            NCS_INT_BASEID

//flat
#define NCS_METRICS_BORDER_WIDTH    (NCS_METRICS_BASEID)
#define NCS_METRICS_BORDER_RADIUS   (NCS_METRICS_BASEID + 1)

//fashion
#define NCS_METRICS_3DBODY_ROUNDX   (NCS_METRICS_BASEID)
#define NCS_METRICS_3DBODY_ROUNDY   (NCS_METRICS_BASEID + 1)
#define NCS_MODE_BGC                NCS_INT_BASEID  + 1
#define NCS_MODE_FGC                NCS_INT_BASEID  + 2
#define NCS_MODE_ITEM               NCS_INT_BASEID  + 3
#define NCS_MODE_USEFLAT            NCS_INT_BASEID  + 4

//fashion.ProgressBar
#define NCS_BGC_PRGBAR_CHUNK        NCS_BGC_BASEID  + 6
//fashion.TrackBar
#define NCS_BGC_TRKBAR_SLIDER       NCS_BGC_BASEID  + 7
#define NCS_BGC_TRKBAR_THUMB        NCS_BGC_BASEID  + 8

//flat
#define NCS_BGC_PRPSHT_NMLTAB       NCS_BGC_BASEID  + 9

//skin
#define NCS_IMAGE_ARROWS            NCS_IMAGE_BASEID + 1
#define NCS_IMAGE_ARROWSHELL        NCS_IMAGE_BASEID + 2
//skin.Button
#define NCS_IMAGE_BUTTON            NCS_IMAGE_BASEID + 3
//skin.CheckButton
#define NCS_IMAGE_CHKBTN            NCS_IMAGE_BASEID + 4
//skin.RadioButton
#define NCS_IMAGE_RDOBTN            NCS_IMAGE_BASEID + 5
//skin.ListView
#define NCS_IMAGE_LISTV_TREE        NCS_IMAGE_BASEID + 6
#define NCS_IMAGE_LISTV_HDR         NCS_IMAGE_BASEID + 7
//skin.PropSheet
#define NCS_IMAGE_PRPSHT_TAB        NCS_IMAGE_BASEID + 8
//skin.ProgressBar
#define NCS_IMAGE_PRGBAR_HCHUNK     NCS_IMAGE_BASEID + 9
#define NCS_IMAGE_PRGBAR_VCHUNK     NCS_IMAGE_BASEID + 10
#define NCS_IMAGE_PRGBAR_HSLIDER    NCS_IMAGE_BASEID + 11
#define NCS_IMAGE_PRGBAR_VSLIDER    NCS_IMAGE_BASEID + 12
//skin.TrackBar
#define NCS_IMAGE_TRKBAR_HSLIDER    NCS_IMAGE_BASEID + 13
#define NCS_IMAGE_TRKBAR_VSLIDER    NCS_IMAGE_BASEID + 14
#define NCS_IMAGE_TRKBAR_HTHUMB     NCS_IMAGE_BASEID + 15
#define NCS_IMAGE_TRKBAR_VTHUMB     NCS_IMAGE_BASEID + 16

MGNCS_EXPORT DWORD ncsGetElementEx (mWidget *self, const char* rdrName, int id);

MGNCS_EXPORT DWORD ncsSetElementEx (mWidget* self, const char* rdrName, int id, DWORD value);

typedef struct _NCS_RDR_ID_NAME {
    const char* we_name;
    int         we_id;
}NCS_RDR_ID_NAME;

// id_names can be NULL, or end with (NULL, -1)
MGNCS_EXPORT BOOL ncsLoadRdrElementsFromEtcFile(const char* etcfile, const char** rdrNames, int count, NCS_RDR_ID_NAME * id_names);

MGNCS_EXPORT BOOL ncsLoadRdrElementsFromEtcHandle(GHANDLE hEtc, const char** rdrNames, int count, NCS_RDR_ID_NAME* id_names);

MGNCS_EXPORT GHANDLE ncsLoadRdrEtcFile (const char* etcfile, const char** rdrName, int count);

MGNCS_EXPORT int ncsUnloadRdrEtcFile(GHANDLE hEtcFile);

/*
 * \def var g_ncsEtcHandle
 * \breif the MGNCS configuration handle
 */
MGNCS_EXPORT extern GHANDLE g_ncsEtcHandle;

/*
 * \fn ncsSetEtcHandler(GHANDLE hEtc);
 * \brief set the outside of etc handler of mgnc.cfg. 
 * can used for incore resource
 *
 * \sa g_ncsEtcHandler
 */
static inline void ncsSetEtcHandle(GHANDLE hEtc)
{
    g_ncsEtcHandle = hEtc;
}



#define ncsGetElement(self, id) \
    ncsGetElementEx((mWidget*)self, NULL, id)

#define ncsSetElement(self, id, value) \
    ncsSetElementEx((mWidget*)self, NULL, id, value)

MGNCS_EXPORT mWidgetRenderer *ncsRetriveCtrlRDR (const char *rendererName, const char *className);

MGNCS_EXPORT BOOL ncsRegisterCtrlRDR (const char *rendererName, const char *className,
                          mWidgetRenderer *renderer);

MGNCS_EXPORT void ncsUnregisterCtrlRDRs(const char* rdrName/*=NULL*/, const char* className/*=NULL*/);

typedef struct _NCS_RDR_ENTRY
{
  const char *className;
  mWidgetRenderer *renderer;
} NCS_RDR_ENTRY;

MGNCS_EXPORT BOOL ncsRegisterCtrlRDRs (const char *rendererName, NCS_RDR_ENTRY * entries,
                           int count);

MGNCS_EXPORT BOOL ncsSetSystemRenderer(const char* name);

MGNCS_EXPORT const char* ncsGetSystemRenderer(void);

#define INVALID_RDR_VALUE  ((DWORD)-1)

static inline gal_pixel ncsColor2Pixel(HDC hdc, DWORD color)
{
        return RGBA2Pixel(hdc,GetRValue(color),
                GetGValue(color),
                GetBValue(color),
                GetAValue(color));
}

MGNCS_EXPORT void ncsCommRDRDrawFocusFrame(HWND hWnd, HDC hdc, const RECT *rc);
MGNCS_EXPORT BOOL ncsCommRDRDrawBkgnd(HWND hWnd, HDC hdc, const RECT* inv_rc);

MGNCS_EXPORT void ncsCommRDRDraw3dbox(HDC hdc, const RECT* rc,  DWORD color, DWORD flag);
MGNCS_EXPORT void ncsCommRDRDraw3DRoundBox(HDC hdc, const RECT *rc, int rx, int ry, DWORD color, DWORD flag);

#define NCS_ROUND_CORNER_LEFT_TOP                       (0x1)
#define NCS_ROUND_CORNER_LEFT_BOTTOM            (0x2)
#define NCS_ROUND_CORNER_RIGHT_TOP          (0x4)
#define NCS_ROUND_CORNER_RIGHT_BOTTOM       (0x8)
#define NCS_ROUND_CORNER_LEFTS              (NCS_ROUND_CORNER_LEFT_TOP|NCS_ROUND_CORNER_LEFT_BOTTOM)
#define NCS_ROUND_CORNER_RIGHTS             (NCS_ROUND_CORNER_RIGHT_TOP|NCS_ROUND_CORNER_RIGHT_BOTTOM)
#define NCS_ROUND_CORNER_TOPS               (NCS_ROUND_CORNER_LEFT_TOP|NCS_ROUND_CORNER_RIGHT_TOP)
#define NCS_ROUND_CORNER_BOTTOMS            (NCS_ROUND_CORNER_LEFT_BOTTOM|NCS_ROUND_CORNER_RIGHT_BOTTOM)
#define NCS_ROUND_CORNER_ALL                (NCS_ROUND_CORNER_LEFT_TOP|NCS_ROUND_CORNER_LEFT_BOTTOM| \
                                                                                                NCS_ROUND_CORNER_RIGHT_TOP|NCS_ROUND_CORNER_RIGHT_BOTTOM)
#define NCS_BORDER_LEFT                     0x1000
#define NCS_BORDER_RIGHT                    0x2000
#define NCS_BORDER_TOP                      0x4000
#define NCS_BORDER_BOTTOM                   0x8000
#define NCS_BORDER_ALL                      (NCS_BORDER_LEFT|NCS_BORDER_RIGHT|NCS_BORDER_TOP|NCS_BORDER_BOTTOM)

MGNCS_EXPORT void ncsCommRDRDraw3DHalfRoundBox(HDC hdc, const RECT *rc, int rx, int ry, DWORD color, DWORD flag, DWORD part_flag);
MGNCS_EXPORT void ncsCommRDRDrawHalfRoundRect(HDC hdc, const RECT *rc, int rx, int ry, DWORD color, DWORD part_flag);

MGNCS_EXPORT void ncsCommRDRFillHalfRoundRect(HDC hdc, const RECT *rc, int rx, int ry, DWORD color, DWORD part_flag);

MGNCS_EXPORT void ncsCommRDRDraw3DEllipse(HDC hdc, const RECT *rc, DWORD color1, DWORD color2, DWORD flag);

MGNCS_EXPORT void ncsCommRDRDrawCheckbox(HDC hdc, const RECT* rc, DWORD fgcolor, DWORD bgcolor, DWORD discolor, DWORD flag);

MGNCS_EXPORT void ncsCommRDRDrawRadio(HDC hdc, const RECT* rc,  DWORD fgcolor, DWORD bgcolor, DWORD discolor,DWORD flag);

MGNCS_EXPORT void ncsCommRDRDrawArrow(HDC hdc, const RECT* rc, int arrow,DWORD color, BOOL bFill);

MGNCS_EXPORT void ncsCommRDRDrawItem(HDC hdc, const RECT* rc, DWORD color);

MGNCS_EXPORT void ncsCommRDRDrawSmallHalfRoundBox(HDC hdc, const RECT *rc, DWORD flags, BOOL bFill);

enum ncsCommRDRColorCalc {
        NCSR_COLOR_DARKER = -100,
        NCSR_COLOR_DARKEST = -200 ,
        NCSR_COLOR_LIGHTER = 100 ,
        NCSR_COLOR_LIGHTEST = 200
};

MGNCS_EXPORT DWORD ncsCommRDRCalc3dboxColor(DWORD color, int degree);

//skin

#define DI_FILL_TILE    0x01
#define DI_FILL_STRETCH 0x02

/* Draw info */
typedef struct _DRAWINFO
{
    /* The pointer to the whole bitmap. */
    const BITMAP* bmp;

    /* The number of line in this bitmap. */
    unsigned int nr_line;

    /* The number of colume in this bitmap. */
    unsigned int nr_col;

    /* The index of line to current sub bitmap. */
    unsigned int idx_line;

    /* The index of colume to current sub bitmap. */
    unsigned int idx_col;

    /* The left/top margin value of current sub bitmap. */
    unsigned int margin1;

    /* The right/bottom margin value of current sub bitmap. */
    unsigned int margin2;

    /* The margin direct. FALSE for left-to-right (default), 
     * TRUE for top-to-bottom. */
    BOOL direct;

    /* The flip flag. FALSE for not flip sub bitmap (default), 
     * TRUE for flip. It can be used by draw_tab function.*/
    BOOL flip;

    /* The style of drawing bitmap. It can be one of the 
     * following value:
     *  - DI_FILL_TILE
     *  - DI_FILL_STRETCH
     */
    unsigned int style;

} DRAWINFO;

MGNCS_EXPORT void ncsSkinDraw(HDC hdc, const RECT* rc, const DRAWINFO *di);

#ifdef __cplusplus
}
#endif

#endif