/****************************************************************************************
* 文件名：LCDDRIVE.H
* 功能：LCD驅動程序，包括底層驅動，刷新顯示子程序。
* 說明：用于MagicARM2200實驗箱，液晶控制器為S1D13503。
****************************************************************************************/
#ifndef  LCDDRIVE_H
#define  LCDDRIVE_H

/* 定義顏色數據類型(可以是數據結構) */
#define  TCOLOR				uint8

/* 定義LCM像素數宏 */
#define  GUI_LCM_XMAX		320							/* 定義液晶x軸的像素數 */
#define  GUI_LCM_YMAX		240							/* 定義液晶y軸的像素數 */

/* 定義S1D13503控制地址 */
#define  S1D13503_REG    	0x83800000
#define  S1D13503_DAT    	0x83400000


/* 設置顏色宏定義 */
#define   BLACK		0x00        /* 黑色：    0,   0,   0 */
#define   NAVY		0x02        /* 深藍色：  0,   0, 128 */
#define   DGREEN	0x10		/* 深綠色：  0, 128,   0 */
#define   DCYAN		0x12		/* 深青色：  0, 128, 128 */
#define   MAROON	0x80		/* 深紅色：128,   0,   0 */
#define   PURPLE	0x82		/* 紫色：  128,   0, 128 */
#define   OLIVE		0x90   	    /* 橄欖綠：128, 128,   0 */
#define   LGRAY		0xCA		/* 灰白色：192, 192, 192 */
#define   DGRAY		0x92		/* 深灰色：128, 128, 128 */
#define   BLUE		0x03		/* 藍色：    0,   0, 255 */
#define   GREEN		0x1C		/* 綠色：    0, 255,   0 */
#define   CYAN	    0x1F 		/* 青色：    0, 255, 255 */
#define   RED		0xE0		/* 紅色：   55,   0,   0 */
#define   MAGENTA	0xE3		/* 品紅：  255,   0, 255 */
#define   YELLOW	0xFC		/* 黃色：  255, 255, 0   */
#define   WHITE		0xFF		/* 白色：  255, 255, 255 */



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


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


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


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


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



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



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




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

/****************************************************************************
* 名稱：GUI_CopyColor()
* 功能：顏色值復制。
* 入口參數：color1		目標顏色變量
*		   color2		源顏色變量
* 出口參數：無
* 說明：由于顏色類型TCOLOR可以是結構類型，所以需要用戶編寫復制函數。
****************************************************************************/
//extern void  GUI_CopyColor(TCOLOR *color1, TCOLOR color2);
#define  GUI_CopyColor(color1, color2) 	*color1 = color2

#endif