/****************************************************************************************
* 文件名：LCDDRIVE.H
* 功能：LCD驅(qū)動(dòng)程序，包括底層驅(qū)動(dòng)，刷新顯示子程序。
* 說(shuō)明：
****************************************************************************************/
#ifndef  LCDDRIVE_H
#define  LCDDRIVE_H


/* 定義顏色數(shù)據(jù)類型(可以是數(shù)據(jù)結(jié)構(gòu)) */
#define  TCOLOR				uint8

#define  GUI_LCM_XMAX		320							/* 定義液晶x軸的點(diǎn)數(shù) */
#define  GUI_LCM_YMAX		240							/* 定義液晶y軸的點(diǎn)數(shù) */


/****************************************************************************
* 名稱：GUI_Initialize()
* 功能：初始化GUI，包括初始化顯示緩沖區(qū)，初始化LCM并清屏。
* 入口參數(shù)：無(wú)
* 出口參數(shù)：無(wú)
* 說(shuō)明：用戶根據(jù)LCM的實(shí)際情況編寫此函數(shù)。
****************************************************************************/
extern void  GUI_Initialize(void);


/****************************************************************************
* 名稱：GUI_FillSCR()
* 功能：全屏填充。直接使用數(shù)據(jù)填充顯示緩沖區(qū)。
* 入口參數(shù)：dat		填充的數(shù)據(jù)
* 出口參數(shù)：無(wú)
* 說(shuō)明：用戶根據(jù)LCM的實(shí)際情況編寫此函數(shù)。
****************************************************************************/
extern void  GUI_FillSCR(TCOLOR dat);


/****************************************************************************
* 名稱：GUI_ClearSCR()
* 功能：清屏。
* 入口參數(shù)：無(wú)
* 出口參數(shù)：無(wú)
* 說(shuō)明：用戶根據(jù)LCM的實(shí)際情況編寫此函數(shù)。
****************************************************************************/
extern void  GUI_ClearSCR(void);


/****************************************************************************
* 名稱：GUI_Point()
* 功能：在指定位置上畫點(diǎn)。
* 入口參數(shù)： x		指定點(diǎn)所在列的位置
*           y		指定點(diǎn)所在行的位置
*           color	顯示顏色(對(duì)于黑白色LCM，為0時(shí)滅，為1時(shí)顯示)
* 出口參數(shù)：返回值為1時(shí)表示操作成功，為0時(shí)表示操作失敗。(操作失敗原因是指定地址超出有
*          效范圍)
* 說(shuō)明：用戶根據(jù)LCM的實(shí)際情況編寫此函數(shù)。
****************************************************************************/
extern uint8  GUI_Point(uint32 x, uint32 y, TCOLOR color);


/****************************************************************************
* 名稱：GUI_ReadPoint()
* 功能：讀取指定點(diǎn)的顏色。
* 入口參數(shù)：x			指定點(diǎn)所在列的位置
*          y		指定點(diǎn)所在行的位置
*          ret		保存顏色值的指針
* 出口參數(shù)：返回0時(shí)表示指定地址超出有效范圍。
* 說(shuō)明：對(duì)于單色，設(shè)置ret的d0位為1或0，4級(jí)灰度則為d0、d1有效，8位RGB則d0--d7有效，
*      RGB結(jié)構(gòu)則R、G、B變量有效。
****************************************************************************/
extern int  GUI_ReadPoint(uint32 x, uint32 y, TCOLOR *ret);



/****************************************************************************
* 名稱：GUI_HLine()
* 功能：畫水平線。
* 入口參數(shù)： x0		水平線起點(diǎn)所在列的位置
*           y0		水平線起點(diǎn)所在行的位置
*           x1      水平線終點(diǎn)所在列的位置
*           color	顯示顏色(對(duì)于黑白色LCM，為0時(shí)滅，為1時(shí)顯示)
* 出口參數(shù)：無(wú)
* 說(shuō)明：對(duì)于單色、4級(jí)灰度的液晶，可通過(guò)修改此函數(shù)作圖提高速度，如單色LCM，可以一次更
*      新8個(gè)點(diǎn)，而不需要一個(gè)點(diǎn)一個(gè)點(diǎn)的寫到LCM中。
****************************************************************************/
extern void  GUI_HLine(uint32 x0, uint32 y0, uint32 x1, TCOLOR color);



/****************************************************************************
* 名稱：GUI_RLine()
* 功能：畫垂直線。
* 入口參數(shù)： x0		垂直線起點(diǎn)所在列的位置
*           y0		垂直線起點(diǎn)所在行的位置
*           y1      垂直線終點(diǎn)所在行的位置
*           color	顯示顏色
* 出口參數(shù)：無(wú)
* 說(shuō)明：對(duì)于單色、4級(jí)灰度的液晶，可通過(guò)修改此函數(shù)作圖提高速度，如單色LCM，可以一次更
*      新8個(gè)點(diǎn)，而不需要一個(gè)點(diǎn)一個(gè)點(diǎn)的寫到LCM中。
****************************************************************************/
extern void  GUI_RLine(uint32 x0, uint32 y0, uint32 y1, TCOLOR color);




/****************************************************************************
* 名稱：GUI_CmpColor()
* 功能：判斷顏色值是否一致。
* 入口參數(shù)：color1		顏色值1
*		   color2		顏色值2
* 出口參數(shù)：返回1表示相同，返回0表示不相同。
* 說(shuō)明：由于顏色類型TCOLOR可以是結(jié)構(gòu)類型，所以需要用戶編寫比較函數(shù)。
****************************************************************************/
//extern int  GUI_CmpColor(TCOLOR color1, TCOLOR color2);
#define  GUI_CmpColor(color1, color2)	(color1==color2)

/****************************************************************************
* 名稱：GUI_CopyColor()
* 功能：顏色值復(fù)制。
* 入口參數(shù)：color1		目標(biāo)顏色變量
*		   color2		源顏色變量
* 出口參數(shù)：無(wú)
* 說(shuō)明：由于顏色類型TCOLOR可以是結(jié)構(gòu)類型，所以需要用戶編寫復(fù)制函數(shù)。
****************************************************************************/
//extern void  GUI_CopyColor(TCOLOR *color1, TCOLOR color2);
#define  GUI_CopyColor(color1, color2) 	*color1 = color2



#endif