# `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` 粉红色 *****