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= 来显式地调用

freq： LCD （实际上指 SPI 的通讯速率）的频率
color： LCD 初始化的颜色，可以是 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()

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

参数

color： LCD 初始化的颜色，可以是 16 位的 RGB565 颜色值，比如 0xFFFF；或者 RGB888 元组，比如 (236, 36, 36)

lcd.direction(dir)

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

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

参数

dir：正常情况下推荐 lcd.YX_LRUD 和 lcd.YX_RLDU，另外还有其它值，交换 XY 或者 LR 或者 DU即可

lcd.rotation(dir)

设置 LCD 屏幕方向

参数

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

返回值

当前方向，取值[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

img = image.Image("/sd/pic.bmp")
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())

media

sensor

wiki