lcd(屏幕显示)

函数

lcd.init(type=1, freq=15000000, color=lcd.BLACK, invert = 0, lcd_type = 0)

初始化 LCD 屏幕显示

参数

  • type: 设备的类型(保留给未来使用):
    • 0: None
    • 1: lcd shield(默认值)
    • 2: Maix Cube
    • 5: sipeed rgb 屏转接板

type 是键值参数,必须在函数调用中通过写入 type= 来显式地调用

  • freqLCD (实际上指 SPI 的通讯速率) 的频率

  • colorLCD 初始化的颜色, 可以是 16 位的 RGB565 颜色值,比如 0xFFFF; 或者 RGB888 元组, 比如 (236, 36, 36), 默认 lcd.BLACK

  • invert: LCD 反色显示

  • lcd_type: lcd 类型:

    • 0: 默认类型
    • 1: LCD_TYPE_ILI9486
    • 2: LCD_TYPE_ILI9481
    • 3: LCD_TYPE_5P0_7P0,5 寸或 7 寸 分辨率为 800 * 480 的 lcd (需要搭配 sipeed 转接板)
    • 4: LCD_TYPE_5P0_IPS,5 寸 分辨率为 854*489 的 IPS lcd (需要搭配 sipeed 转接板)
    • 5: LCD_TYPE_480_272_4P3,4.3 寸分辨率为 480*272 的 lcd (需要搭 sipeed 配转接板)

MaixCube 和 MaixAmigo 使用 LCD 之前需要配置电源芯片,否则会出现花屏现象,这一步 MaixPy 固件会自动配置,无需手动操作,用户只需要了解即可

lcd.deinit()

注销 LCD 驱动,释放I/O引脚

lcd.width()

返回 LCD 的宽度(水平分辨率)

lcd.height()

返回 LCD 的高度(垂直分辨率)。

lcd.type()

返回 LCD 的类型(保留给未来使用):

0: None
1: lcd Shield

lcd.freq(freq)

设置或者获取 LCD (SPI) 的频率

Paremeters

  • freq: LCD (SPI) 的频率

Return

LCD 的频率

lcd.set_backlight(state)

设置 LCD 的背光状态, 关闭背光会大大降低lcd扩展板的能耗

未实现

参数

  • state: 背光亮度, 取值 [0,100]

lcd.get_backlight()

返回背光状态

返回值

背光亮度, 取值 [0,100]

lcd.display(image, roi=Auto, oft=(x, y))

在液晶屏上显示一张 image(GRAYSCALE或RGB565)。

roi 是一个感兴趣区域的矩形元组(x, y, w, h)。若未指定,即为图像矩形

若 roi 宽度小于lcd宽度,则用垂直的黑色边框使 roi 居于屏幕中心(即用黑色填充未占用区域)。

若 roi 宽度大于lcd宽度,则 roi 居于屏幕中心,且不匹配像素不会显示(即液晶屏以窗口形态显示 roi 的中心)。

若 roi 高度小于lcd高度,则用垂直的黑色边框使 roi 居于屏幕中心(即用黑色填充未占用区域)。

若 roi 高度大于lcd高度,则 roi 居于屏幕中心,且不匹配像素不会显示(即液晶屏以窗口形态显示 roi 的中心)。

roi 是键值参数,必须在函数调用中通过写入 roi= 来显式地调用。

  • oft: 设置偏移坐标,设置了这个坐标就不会自动填充周围了

lcd.clear()

将液晶屏清空为黑色或者指定的颜色。

参数

  • colorLCD 初始化的颜色, 可以是 16 位的 RGB565 颜色值,比如 0xFFFF; 或者 RGB888 元组, 比如 (236, 36, 36)

lcd.direction(dir)

v0.3.1 之后已经被舍弃, 请使用lcd.rotationlcd.invert代替, 如非必要请勿使用, 接口仍会被保留用于调试使用

设置屏幕方向, 以及是否镜像等

参数

  • dir: 正常情况下推荐 lcd.YX_LRUDlcd.YX_RLDU, 另外还有其它值,交换 XY 或者 LR 或者 DU即可

lcd.rotation(dir)

设置 LCD 屏幕方向

参数

  • dir: 取值范围 [0,3], 从03依次顺时针旋转

返回值

当前方向,取值[0,3]

lcd.mirror(invert)

设置 LCD 是否镜面显示

参数

  • invert: 是否镜面显示, True 或者 False

返回值

当前设置,是否镜面显示,返回True或者False

lcd.bgr_to_rgb(enable)

设置是否启动 bgr 色彩显示

参数

  • enable:是否启用 bgr 显示,True 或者 False

lcd.fill_rectangle(x, y, w, h, color)

填充LCD 指定区域

参数

  • x: 起始坐标x
  • x: 起始坐标y
  • w: 填充宽度
  • h: 填充高度
  • color: 填充颜色, 可以是元组,比如(255, 255, 255),或者RGB565``uint16值, 比如红色0x00F8

例程

例程 1: 显示英文

import lcd

lcd.init()
lcd.draw_string(100, 100, "hello maixpy", lcd.RED, lcd.BLACK)

例程 2: 显示图片

import lcd
import image

lcd.init()
img = image.Image("/sd/pic.bmp")#320*240
lcd.display(img)

例程 3: 利用显示图片的方式显示英文

import lcd
import image

img = image.Image()
img.draw_string(60, 100, "hello maixpy", scale=2) 
lcd.display(img)

例程 4: 实时显示摄像头捕捉到的图像

import sensor, lcd

sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.QVGA)
sensor.run(1)
sensor.skip_frames()
lcd.init()

while(True):
    lcd.display(sensor.snapshot())