/****************************************************************************************
* 文件名：GUI_BASIC.H
* 功能：GUI基本畫圖函數(shù)。
* 說明：
****************************************************************************************/
#ifndef  GUI_BASIC_H
#define  GUI_BASIC_H

/* 定義坐標(biāo)數(shù)據(jù)結(jié)構(gòu) */
typedef  struct
         {  uint32  x;				// x坐標(biāo)變量
            uint32  y;				// y坐標(biāo)變量
         } 
         PointXY;


/****************************************************************************
* 名稱：GUI_Rectangle()
* 功能：畫矩形。
* 入口參數(shù)： x0		矩形左上角的x坐標(biāo)值
*           y0		矩形左上角的y坐標(biāo)值
*           x1      矩形右下角的x坐標(biāo)值
*           y1      矩形右下角的y坐標(biāo)值
*           color	顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern  void  GUI_Rectangle(uint32 x0, uint32 y0, uint32 x1, uint32 y1, TCOLOR color);


/****************************************************************************
* 名稱：GUI_RectangleFill()
* 功能：填充矩形。畫一個(gè)填充的矩形，填充色與邊框色一樣。
* 入口參數(shù)： x0		矩形左上角的x坐標(biāo)值
*           y0		矩形左上角的y坐標(biāo)值
*           x1      矩形右下角的x坐標(biāo)值
*           y1      矩形右下角的y坐標(biāo)值
*           color	填充顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_RectangleFill(uint32 x0, uint32 y0, uint32 x1, uint32 y1, TCOLOR color);


/****************************************************************************
* 名稱：GUI_Square()
* 功能：畫正方形。
* 入口參數(shù)： x0		正方形左上角的x坐標(biāo)值
*           y0		正方形左上角的y坐標(biāo)值
*           with    正方形的邊長
*           color	顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_Square(uint32 x0, uint32 y0, uint32  with, TCOLOR  color);


/****************************************************************************
* 名稱：GUI_Line()
* 功能：畫任意兩點(diǎn)之間的直線。
* 入口參數(shù)： x0		直線起點(diǎn)的x坐標(biāo)值
*           y0		直線起點(diǎn)的y坐標(biāo)值
*           x1      直線終點(diǎn)的x坐標(biāo)值
*           y1      直線終點(diǎn)的y坐標(biāo)值
*           color	顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_Line(uint32 x0, uint32 y0, uint32 x1, uint32 y1, TCOLOR color);


/****************************************************************************
* 名稱：GUI_LineWith()
* 功能：畫任意兩點(diǎn)之間的直線，并且可設(shè)置線的寬度。
* 入口參數(shù)： x0		直線起點(diǎn)的x坐標(biāo)值
*           y0		直線起點(diǎn)的y坐標(biāo)值
*           x1      直線終點(diǎn)的x坐標(biāo)值
*           y1      直線終點(diǎn)的y坐標(biāo)值
*           with    線寬(0-50)
*           color	顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_LineWith(uint32 x0, uint32 y0, uint32 x1, uint32 y1, uint8 with, TCOLOR color);


/****************************************************************************
* 名稱：GUI_LineS()
* 功能：多個(gè)點(diǎn)之間的連續(xù)連線。從第一點(diǎn)連到第二點(diǎn)，再連到第三點(diǎn)...
* 入口參數(shù)： points  多個(gè)點(diǎn)坐標(biāo)數(shù)據(jù)的指針，數(shù)據(jù)排列為(x0,y0)、(x1,y1)、(x2,y2)...
*           no      點(diǎn)數(shù)目，至少要大于1
*           color	顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_LineS(uint32 const *points, uint8 no, TCOLOR color);


/****************************************************************************
* 名稱：GUI_Circle()
* 功能：指定圓心位置及半徑，畫圓。
* 入口參數(shù)： x0		圓心的x坐標(biāo)值
*           y0		圓心的y坐標(biāo)值
*           r       圓的半徑
*           color	顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_Circle(uint32 x0, uint32 y0, uint32 r, TCOLOR color);


/****************************************************************************
* 名稱：GUI_CircleFill()
* 功能：指定圓心位置及半徑，畫圓并填充，填充色與邊框色一樣。
* 入口參數(shù)： x0		圓心的x坐標(biāo)值
*           y0		圓心的y坐標(biāo)值
*           r       圓的半徑
*           color	填充顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_CircleFill(uint32 x0, uint32 y0, uint32 r, TCOLOR color);


/****************************************************************************
* 名稱：GUI_Ellipse()
* 功能：畫正橢圓。給定橢圓的四個(gè)點(diǎn)的參數(shù)，最左、最右點(diǎn)的x軸坐標(biāo)值為x0、x1，最上、最下點(diǎn)
*      的y軸坐標(biāo)為y0、y1。
* 入口參數(shù)： x0		最左點(diǎn)的x坐標(biāo)值
*           x1		最右點(diǎn)的x坐標(biāo)值
*           y0		最上點(diǎn)的y坐標(biāo)值
*           y1      最下點(diǎn)的y坐標(biāo)值
*           color	顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_Ellipse(uint32 x0, uint32 x1, uint32 y0, uint32 y1, TCOLOR color);


/****************************************************************************
* 名稱：GUI_EllipseFill()
* 功能：畫正橢圓，并填充。給定橢圓的四個(gè)點(diǎn)的參數(shù)，最左、最右點(diǎn)的x軸坐標(biāo)值為x0、x1，最上、最下點(diǎn)
*      的y軸坐標(biāo)為y0、y1。
* 入口參數(shù)： x0		最左點(diǎn)的x坐標(biāo)值
*           x1		最右點(diǎn)的x坐標(biāo)值
*           y0		最上點(diǎn)的y坐標(biāo)值
*           y1      最下點(diǎn)的y坐標(biāo)值
*           color	填充顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_EllipseFill(uint32 x0, uint32 x1, uint32 y0, uint32 y1, TCOLOR color);


/****************************************************************************
* 名稱：GUI_FloodFill()
* 功能：圖形填充，將指定點(diǎn)內(nèi)的封閉圖形進(jìn)行填充。對(duì)指定點(diǎn)的顏色區(qū)域進(jìn)行填充，即不是該顏色
*      的像素為邊界(如，指定點(diǎn)上的顏色為紅色，則其它顏色像素均為邊界)。
* 入口參數(shù)： x0		指定點(diǎn)的x坐標(biāo)值
*           y0		指定點(diǎn)的y坐標(biāo)值
*           color	填充顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍、指定點(diǎn)不在封閉圖形內(nèi)。
****************************************************************************/
extern void  GUI_FloodFill(uint32 x0, uint32 y0, TCOLOR color);


/****************************************************************************
* 名稱：GUI_Arc4()
* 功能：畫弧。起點(diǎn)及終點(diǎn)只能為0度-90度、90度-180度、180度-270度、270度-0度等。即分別
*      為第1-4像限的90度弧。
* 入口參數(shù)： x0		圓心的x坐標(biāo)值
*           y0		圓心的y坐標(biāo)值
*           r       圓弧的半徑
*           angle	畫弧的像限(1-4)
*           color	顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_Arc4(uint32 x, uint32 y, uint32 r, uint8 angle, TCOLOR color);



/****************************************************************************
* 名稱：GUI_Arc()
* 功能：指定起點(diǎn)、終點(diǎn)及半徑畫弧(不能畫圓)。使用的是順時(shí)針方向畫圖。
* 入口參數(shù)： x			圓心的x坐標(biāo)值
*           y			圓心的y坐標(biāo)值
*           stangle 	起始角度(0-359度)
*           endangle	終止角度(0-359度)
*           r  			圓的半徑終點(diǎn)
*           color		顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_Arc(uint32 x, uint32 y, uint32 r, uint32 stangle, uint32 endangle, TCOLOR color);


/****************************************************************************
* 名稱：GUI_Pieslice()
* 功能：指定起點(diǎn)、終點(diǎn)及半徑扇形(不能畫圓)。使用的是順時(shí)針方向畫圖。
* 入口參數(shù)： x			圓心的x軸坐標(biāo)值
*           y			圓心的y軸坐標(biāo)值
*           stangle 	起始角度(0-359度)
*           endangle	終止角度(0-359度)
*           r  			圓的半徑終點(diǎn)
*           color		顯示顏色
* 出口參數(shù)：無
* 說明：操作失敗原因是指定地址超出有效范圍。
****************************************************************************/
extern void  GUI_Pieslice(uint32 x, uint32 y, uint32 r, uint32 stangle, uint32 endangle, TCOLOR color);


#endif