Question

machine.LCD

machine.LCD 类是 machine 模块下面的一个硬件类，用于对 LCD 的配置和控制，提供对 LCD 设备的操作方法。

IoT board 板载一块 1.3 寸，分辨率为 240*240 的 LCD 显示屏，因此对该屏幕操作时，(x, y) 坐标的范围是 0 - 239。

构造函数

在 RT-Thread MicroPython 中 LCD 对象的构造函数如下：

class machine.LCD()

在给定总线上构造一个 LCD 对象，无入参，初始化的对象取决于特定硬件，初始化方式可参考 示例。

方法

LCD.light(value)

控制是否开启 LCD 背光，入参为 True 则打开 LCD 背光，入参为 False 则关闭 LCD 背光。

LCD.fill(color)

根据给定的颜色填充整个屏幕，支持多种颜色，可以传入的参数有：

WHITE BLACK BLUE BRED GRED GBLUE RED MAGENTA GREEN CYAN YELLOW BROWN BRRED GRAY GRAY175 GRAY151 GRAY240

详细的使用方法可参考示例。

LCD.pixel(x, y, color)

向指定的位置（x, y）画点，点的颜色为 color 指定的颜色，可指定的颜色和上一个功能相同。

注意：(x, y) 坐标的范围是 0 - 239，使用下面的方法对坐标进行操作时同样需要遵循此限制。

LCD.text(str, x, y, size)

在指定的位置（x,y）写入字符串，字符串由 str 指定，字体的大小由 size 指定，size 的大小可为 16，24，32。

LCD.line(x1, y1, x2, y2)

在 LCD 上画一条直线，起始地址为 （x1, y1），终点为（x2, y2）。

LCD.rectangle(x1, y1, x2, y2)

在 LCD 上画一个矩形，左上角的位置为（x1, y1），右下角的位置为（x2, y2）。

LCD.circle(x1, y1, r)

在 LCD 上画一个圆形，圆心的位置为（x1, y1），半径长度为 r。

LCD.show_bmp( x, y, pathname)

在 LCD 指定位置上显示 32-bit bmp 格式的图片信息，注意显示 bmp 图片时，(x, y) 坐标是图片的左下角。

示例

from machine import LCD     # 从 machine 导入 LCD 类
lcd = LCD()                 # 创建一个 lcd 对象
lcd.light(False)            # 关闭背光
lcd.light(True)             # 打开背光
lcd.fill(lcd.BLACK)         # 将整个 LCD 填充为黑色
lcd.fill(lcd.RED)           # 将整个 LCD 填充为红色
lcd.fill(lcd.GRAY)          # 将整个 LCD 填充为灰色
lcd.fill(lcd.WHITE)         # 将整个 LCD 填充为白色
lcd.pixel(50, 50, lcd.BLUE) # 将（50,50）位置的像素填充为蓝色
lcd.text("hello RT-Thread", 0, 0, 16)   # 在（0, 0） 位置以 16 字号打印字符串
lcd.text("hello RT-Thread", 0, 16, 24)  # 在（0, 16）位置以 24 字号打印字符串
lcd.text("hello RT-Thread", 0, 48, 32)  # 在（0, 48）位置以 32 字号打印字符串
lcd.line(0, 50, 239, 50)    # 以起点（0，50），终点（239，50）画一条线
lcd.line(0, 50, 239, 50)    # 以起点（0，50），终点（239，50）画一条线
lcd.rectangle(100, 100, 200, 200) # 以左上角为（100,100），右下角（200,200）画矩形
lcd.circle(150, 150, 80)    # 以圆心位置（150,150），半径为 80 画圆
lcd.show_bmp(180, 50, "sun.bmp")  # 以位置（180,50）为图片左下角坐标显示文件系统中的 bmp 图片 "sun.bmp"