GUI簡析

對于屏幕而言，如果需要進行畫圖、顯示中英文字符、顯示圖片等怎么辦，這些都是上層應用做的。這有很多小伙伴有問到一些圖形的處理，我們這里提供了一些基本的功能 在目錄：RaspberryPi\c\lib\GUI\GUI_Paint.c(.h)中可以找到GUI

在目錄：RaspberryPi\c\lib\Fonts下是GUI依賴的字符字體，

• 新建圖像屬性:新建一個圖像屬性，這個屬性包括圖像緩存的名稱、寬度、高度、翻轉角度、顏色

void Paint_NewImage(UBYTE *image, UWORD Width, UWORD Height, UWORD Rotate, UWORD Color) 參數： image: 圖像緩存的名稱，實際上是一個指向圖像緩存首地址的指針； Width: 圖像緩存的寬度； Height: 圖像緩存的高度； Rotate：圖像的翻轉的角度 Color ：圖像的初始顏色；

• 選擇圖像緩存:選擇圖像緩存，選擇的目的是你可以創建多個圖像屬性，圖像緩存可以存在多個，你可以選擇你所創建的每一張圖像

void Paint_SelectImage(UBYTE *image) 參數： image: 圖像緩存的名稱，實際上是一個指向圖像緩存首地址的指針；

• 圖像旋轉:設置選擇好的圖像的旋轉角度，最好使用在Paint_SelectImage()后，可以選擇旋轉0、90、180、270

void Paint_SetRotate(UWORD Rotate) 參數： Rotate: 圖像選擇角度，可以選擇ROTATE_0、ROTATE_90、ROTATE_180、ROTATE_270分別對應0、90、180、270度

• 設置像素點的尺寸

void Paint_SetScale(UBYTE scale) 參數： scale: 像素點的尺寸，2：每個像素點占一位；4：每個像素點占兩位

• 圖像鏡像翻轉:設置選擇好的圖像的鏡像翻轉，可以選擇不鏡像、關于水平鏡像、關于垂直鏡像、關于圖像中心鏡像。

void Paint_SetMirroring(UBYTE mirror) 參數： mirror: 圖像的鏡像方式，可以選擇MIRROR_NONE、MIRROR_HORIZONTAL、MIRROR_VERTICAL、MIRROR_ORIGIN分別對應不鏡像、關于水平鏡像、關于垂直鏡像、關于圖像中心鏡像

• 設置點在緩存中顯示位置和顏色：這里是GUI最核心的一個函數、處理點在緩存中顯示位置和顏色；

void Paint_SetPixel(UWORD Xpoint, UWORD Ypoint, UWORD Color) 參數： Xpoint: 點在圖像緩存中X位置 Ypoint: 點在圖像緩存中Y位置 Color: 點顯示的顏色

• 圖像緩存填充顏色:把圖像緩存填充為某顏色，一般作為屏幕刷白的作用

void Paint_Clear(UWORD Color) 參數： Color: 填充的顏色

• 圖像緩存部分窗口填充顏色：把圖像緩存的某部分窗口填充為某顏色，一般作為窗口刷白的作用，常用于時間的顯示，刷白上一秒

void Paint_ClearWindows(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UWORD Color) 參數： Xstart: 窗口的X起點坐標 Ystart: 窗口的Y起點坐標 Xend: 窗口的X終點坐標 Yend: 窗口的Y終點坐標 Color: 填充的顏色

• 畫點:在圖像緩存中，在（Xpoint, Ypoint）上畫點，可以選擇顏色，點的大小，點的風格

void Paint_DrawPoint(UWORD Xpoint, UWORD Ypoint, UWORD Color, DOT_PIXEL Dot_Pixel, DOT_STYLE Dot_Style) 參數： Xpoint: 點的X坐標 Ypoint: 點的Y坐標 Color: 填充的顏色 Dot_Pixel: 點的大小，提供默認的8種大小點 typedef enum { DOT_PIXEL_1X1 = 1, // 1 x 1 DOT_PIXEL_2X2 , // 2 X 2 DOT_PIXEL_3X3 , // 3 X 3 DOT_PIXEL_4X4 , // 4 X 4 DOT_PIXEL_5X5 , // 5 X 5 DOT_PIXEL_6X6 , // 6 X 6 DOT_PIXEL_7X7 , // 7 X 7 DOT_PIXEL_8X8 , // 8 X 8 } DOT_PIXEL; Dot_Style: 點的風格,大小擴充方式是以點為中心擴大還是以點為左下角往右上擴大 typedef enum { DOT_FILL_AROUND = 1, DOT_FILL_RIGHTUP, } DOT_STYLE;

• 畫線：在圖像緩存中，從 (Xstart, Ystart) 到 (Xend, Yend) 畫線，可以選擇顏色，線的寬度，線的風格

void Paint_DrawLine(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UWORD Color, LINE_STYLE Line_Style , LINE_STYLE Line_Style) 參數： Xstart: 線的X起點坐標 Ystart: 線的Y起點坐標 Xend: 線的X終點坐標 Yend: 線的Y終點坐標 Color: 填充的顏色 Line_width: 線的寬度，提供默認的8種寬度 typedef enum { DOT_PIXEL_1X1 = 1, // 1 x 1 DOT_PIXEL_2X2 , // 2 X 2 DOT_PIXEL_3X3 , // 3 X 3 DOT_PIXEL_4X4 , // 4 X 4 DOT_PIXEL_5X5 , // 5 X 5 DOT_PIXEL_6X6 , // 6 X 6 DOT_PIXEL_7X7 , // 7 X 7 DOT_PIXEL_8X8 , // 8 X 8 } DOT_PIXEL; Line_Style: 線的風格,選擇線是以直線連接還是以虛線的方式連接 typedef enum { LINE_STYLE_SOLID = 0, LINE_STYLE_DOTTED, } LINE_STYLE;

• 畫矩形:在圖像緩存中，從 (Xstart, Ystart) 到 (Xend, Yend) 畫一個矩形，可以選擇顏色，線的寬度，是否填充矩形內部

void Paint_DrawRectangle(UWORD Xstart, UWORD Ystart, UWORD Xend, UWORD Yend, UWORD Color, DOT_PIXEL Line_width, DRAW_FILL Draw_Fill) 參數： Xstart: 矩形的X起點坐標 Ystart: 矩形的Y起點坐標 Xend: 矩形的X終點坐標 Yend: 矩形的Y終點坐標 Color: 填充的顏色 Line_width: 矩形四邊的寬度，提供默認的8種寬度 typedef enum { DOT_PIXEL_1X1 = 1, // 1 x 1 DOT_PIXEL_2X2 , // 2 X 2 DOT_PIXEL_3X3 , // 3 X 3 DOT_PIXEL_4X4 , // 4 X 4 DOT_PIXEL_5X5 , // 5 X 5 DOT_PIXEL_6X6 , // 6 X 6 DOT_PIXEL_7X7 , // 7 X 7 DOT_PIXEL_8X8 , // 8 X 8 } DOT_PIXEL; Draw_Fill: 填充,是否填充矩形的內部 typedef enum { DRAW_FILL_EMPTY = 0, DRAW_FILL_FULL, } DRAW_FILL;

• 畫圓:在圖像緩存中，以 (X_Center Y_Center) 為圓心，畫一個半徑為Radius的圓，可以選擇顏色，線的寬度，是否填充圓內部

void Paint_DrawCircle(UWORD X_Center, UWORD Y_Center, UWORD Radius, UWORD Color, DOT_PIXEL Line_width, DRAW_FILL Draw_Fill) 參數： X_Center: 圓心的X坐標 Y_Center: 圓心的Y坐標 Radius：圓的半徑 Color: 填充的顏色 Line_width: 圓弧的寬度，提供默認的8種寬度 typedef enum { DOT_PIXEL_1X1 = 1, // 1 x 1 DOT_PIXEL_2X2 , // 2 X 2 DOT_PIXEL_3X3 , // 3 X 3 DOT_PIXEL_4X4 , // 4 X 4 DOT_PIXEL_5X5 , // 5 X 5 DOT_PIXEL_6X6 , // 6 X 6 DOT_PIXEL_7X7 , // 7 X 7 DOT_PIXEL_8X8 , // 8 X 8 } DOT_PIXEL; Draw_Fill: 填充,是否填充圓的內部 typedef enum { DRAW_FILL_EMPTY = 0, DRAW_FILL_FULL, } DRAW_FILL;

• 寫Ascii字符:在圖像緩存中，在 (Xstart Ystart) 為左頂點，寫一個Ascii字符，可以選擇Ascii碼可視字符字庫、字體前景色、字體背景色

void Paint_DrawChar(UWORD Xstart, UWORD Ystart, const char Ascii_Char, sFONT* Font, UWORD Color_Foreground, UWORD Color_Background) 參數： Xstart: 字符的左頂點X坐標 Ystart: 字體的左頂點Y坐標 Ascii_Char：Ascii字符 Font: Ascii碼可視字符字庫，在Fonts文件夾中提供了以下字體： font8：5*8的字體 font12：7*12的字體 font16：11*16的字體 font20：14*20的字體 font24：17*24的字體 Color_Foreground: 字體顏色 Color_Background: 背景顏色

• 寫英文字符串:在圖像緩存中，在 (Xstart Ystart) 為左頂點，寫一串英文字符，可以選擇Ascii碼可視字符字庫、字體前景色、字體背景色

void Paint_DrawString_EN(UWORD Xstart, UWORD Ystart, const char * pString, sFONT* Font, UWORD Color_Foreground, UWORD Color_Background) 參數： Xstart: 字符的左頂點X坐標 Ystart: 字體的左頂點Y坐標 pString：字符串，字符串是一個指針 Font: Ascii碼可視字符字庫，在Fonts文件夾中提供了以下字體： font8：5*8的字體 font12：7*12的字體 font16：11*16的字體 font20：14*20的字體 font24：17*24的字體 Color_Foreground: 字體顏色 Color_Background: 背景顏色

• 寫中文字符串：在圖像緩存中，在 (Xstart Ystart) 為左頂點，寫一串中文字符，可以選擇GB2312編碼字符字庫、字體前景色、字體背景色；

void Paint_DrawString_CN(UWORD Xstart, UWORD Ystart, const char * pString, cFONT* font, UWORD Color_Foreground, UWORD Color_Background) 參數： Xstart: 字符的左頂點X坐標 Ystart: 字體的左頂點Y坐標 pString：字符串，字符串是一個指針 Font: GB2312編碼字符字庫，在Fonts文件夾中提供了以下字體： font12CN：ascii字符字體11*21，中文字體16*21 font24CN：ascii字符字體24*41，中文字體32*41 Color_Foreground: 字體顏色 Color_Background: 背景顏色

• 寫數字:在圖像緩存中，在 (Xstart Ystart) 為左頂點，寫一串數字，可以選擇Ascii碼可視字符字庫、字體前景色、字體背景色

void Paint_DrawNum(UWORD Xpoint, UWORD Ypoint, double Nummber, sFONT* Font, UWORD Digit, UWORD Color_Foreground, UWORD Color_Background) 參數： Xpoint: 字符的左頂點X坐標 Ypoint: 字體的左頂點Y坐標 Nummber：顯示的數字，可以是小數 Digit：小數位數，不足補零 Font: Ascii碼可視字符字庫，在Fonts文件夾中提供了以下字體： font8：5*8的字體 font12：7*12的字體 font16：11*16的字體 font20：14*20的字體 font24：17*24的字體 Color_Foreground: 字體顏色 Color_Background: 背景顏色

• 顯示時間:在圖像緩存中，在 (Xstart Ystart) 為左頂點，顯示一段時間，可以選擇Ascii碼可視字符字庫、字體前景色、字體背景色；

void Paint_DrawTime(UWORD Xstart, UWORD Ystart, PAINT_TIME *pTime, sFONT* Font, UWORD Color_Background, UWORD Color_Foreground) 參數： Xstart: 字符的左頂點X坐標 Ystart: 字體的左頂點Y坐標 pTime：顯示的時間，這里定義好了一個時間的結構體，只要把時分秒各位數傳給參數； Font: Ascii碼可視字符字庫，在Fonts文件夾中提供了以下字體： font8：5*8的字體 font12：7*12的字體 font16：11*16的字體 font20：14*20的字體 font24：17*24的字體 Color_Foreground: 字體顏色 Color_Background: 背景顏色

審核編輯：湯梓紅