# `lcd`_顯示驅動（`import lcd`） 屏幕顯示2.8‘’ LCD 240*320驅動配置 * [ ] **初始化顯示** ``` lcd.init(type=1, freq=15000000, color=lcd.BLACK) ``` > 初始化`LCD`屏幕顯示 *參數:* * `type`：`LCD`的類型（保留給未來使用）： * `0`: None * `1`: lcd shield（默認值） * `freq`：`LCD`（實際上指`SPI`的通訊速率） 的頻率 * `color`：`LCD`初始化的顏色： * `RGB565`16 位的顏色值，比如`0xFFFF` * `RGB888`元組， 比如`(236, 36, 36)` * 系統`color`常量，默認`lcd.BLACK` *返回：* * `None` ***** * [ ] **注銷驅動** ``` lcd.deinit() ``` > 注銷`LCD`驅動，釋放I/O引腳 *參數：* * 無 *返回：* * `None` ***** * [ ] **獲取分辨率寬度** ``` lcd.width() ``` > 獲取`LCD`的寬度（水平分辨率） *參數：* * 無 *返回：* * `int`類型的屏幕分辨率寬度 ***** * [ ] **獲取分辨率高度** ``` lcd.height() ``` > 獲取`LCD`的高度（垂直分辨率） *參數：* * 無 *返回：* * `int`類型的屏幕分辨率高度 ***** * [ ] **獲取/設置頻率** ``` lcd.height() ``` > 設置或者獲取`LCD`（SPI） 的頻率 *參數：* * `freq`: `LCD `(SPI) 的頻率 *返回：* * `int`類型的屏幕 (SPI) 的頻率 ***** * [ ] **顯示圖像** ``` lcd.display(image, roi=Auto) ``` > 在液晶屏上顯示一張`image`（GRAYSCALE或RGB565） *參數:* * `image`：顯示圖像`image`（`GRAYSCALE`或`RGB565`） * `roi` ：一個感興趣區域的矩形元組`(x, y, w, h)`，若未指定，即為圖像矩形 * 若 roi 寬度小于lcd寬度，則用垂直的黑色邊框使 roi 居于屏幕中心（即用黑色填充未占用區域） * 若 roi 寬度大于lcd寬度，則 roi 居于屏幕中心，且不匹配像素不會顯示（即液晶屏以窗口形態顯示 roi 的中心） * 若 roi 高度小于lcd高度，則用垂直的黑色邊框使 roi 居于屏幕中心（即用黑色填充未占用區域） * 若 roi 高度大于lcd高度，則 roi 居于屏幕中心，且不匹配像素不會顯示（即液晶屏以窗口形態顯示 roi 的中心） *返回：* * `None` > roi 是鍵值參數，必須在函數調用中通過寫入 roi= 來顯式地調用 ***** * [ ] **屏幕清空** ``` lcd.clear(color) ``` > 將液晶屏清空為黑色或者指定的顏色 *參數:* * color ：將屏幕清空為黑（默認值）或者指定的顏色 * `RGB565`16 位的顏色值，比如`0xFFFF` * `RGB888`元組， 比如`(236, 36, 36)` * 系統`color`常量，默認`lcd.BLACK` *返回：* * `None` ***** * [ ] **設置屏幕方向** ``` lcd.rotation(dir) ``` > 設置`LCD`屏幕方向 *參數：* * `dir`: 取值范圍 [0,3]， 從`0`到`3`依次順時針旋轉 *返值：* * 當前方向，取值[0,3] ***** * [ ] **設置鏡面顯示** ``` lcd.mirror(invert) ``` > 設置`LCD`是否鏡面顯示 *參數：* * `invert`： 是否鏡面顯示，`True`或者`False` *返值：* * 當前設置，是否鏡面顯示，返回`True`或者`False` ***** * [ ] **顯示文本** ``` lcd.draw_string(x, y, text, text_color, color) ``` > 在液晶屏上顯示文本字符（不支持中文） *參數:* *`x`,`y`：圖像中的`(x, y)`位置開始繪制，您可以單獨傳遞`x`，`y`，也可以作為元組`(x，y)`傳遞 * ` text` ：寫入圖像的字符串。`\n`,`\r`, 和`\r\n`結束符將光標移至下一行 * `text_color`：文本字符顏色 * `RGB565`16 位的顏色值，比如`0xFFFF` * 系統`color`常量，默認`lcd.RED` * `color`：屏幕背景顏色 * `RGB565`16 位的顏色值，比如`0xFFFF` * 系統`color`常量，默認`lcd.BLACK` *返回：* * `None` * [ ] **系統默認常量`color`顏色:** > `lcd.BLACK` `0x0000` 黑色 > `lcd.NAVY ` `0x000F` 深藍色 > `lcd.DARKGREEN ` `0x03E0` 深綠色 > `lcd.DARKCYAN` `0x03EF` 深青色 > `lcd.MAROON ` `0x7800` 褐紅色 > `lcd.PURPLE` `0x780F` 紫色 > `lcd.OLIVE` `0x7BE0` 橄欖色 > `lcd.LIGHTGREY` `0xC618` 淺灰色 > `lcd.DARKGREY` `0x7BEF` 深灰色 > `lcd.BLUE` `0x001F` 藍色 > `lcd.GREEN` `0x07E0` 綠色 > `lcd.CYAN ` `0x07FF` 青色 > `lcd.RED` `0xF800` 紅色 > `lcd.MAGENTA` `0xF81F` 洋紅色 > `lcd.YELLOW` `0xFFE0` 黃色 > `lcd.WHITE` `0xFFFF` 白色 > `lcd.ORANGE` `0xFD20` 橙色 > `lcd.GREENYELLOW ` `0xAFE5` 綠黃色 > `lcd.PINK` `0xF81F` 粉紅色 *****