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"

Question && Feedback