lcd(屏幕显示)#
函数#
init
#
lcd.init(type=1, freq=15000000, color=lcd.BLACK, invert = 0, lcd_type = 0)
初始化 LCD
屏幕显示
参数#
type
: 设备的类型(保留给未来使用):0
: None1
: lcd shield(默认值)2
: maix Cube
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_ILI94862
: LCD_TYPE_ILI9481
MaixCube 和 MaixAmigo 使用 LCD 之前需要配置电源芯片,否则会出现花屏现象,这一步 CanMV 固件会自动配置,无需手动操作,用户只需要了解即可
deinit
#
lcd.deinit()
注销 LCD
驱动,释放I/O引脚
width
#
lcd.width()
返回 LCD
的宽度(水平分辨率)
height
#
lcd.height()
返回 LCD
的高度(垂直分辨率)。
type
#
lcd.type()
返回 LCD
的类型(保留给未来使用):
0: None 1: lcd Shield
freq
#
lcd.freq(freq)
设置或者获取 LCD
(SPI) 的频率
参数#
freq
: LCD (SPI) 的频率
返回值#
LCD 的频率
set_backlight
#
lcd.set_backlight(state)
设置 LCD
的背光状态, 关闭背光会大大降低lcd扩展板的能耗
未实现
参数#
state
: 背光亮度, 取值 [0,100]
get_backlight
#
lcd.get_backlight()
返回背光状态
返回值#
背光亮度, 取值 [0,100]
display
#
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
: 设置偏移坐标,设置了这个坐标就不会自动填充周围了
clear
#
lcd.clear()
将液晶屏清空为黑色或者指定的颜色。
参数#
color
:LCD
初始化的颜色, 可以是 16 位的RGB565
颜色值,比如0xFFFF
; 或者RGB888
元组, 比如(236, 36, 36)
rotation
#
lcd.rotation(dir)
设置 LCD
屏幕方向
参数#
dir
: 取值范围 [0,3], 从0
到3
依次顺时针旋转
返回值#
当前方向,取值[0,3]
mirror
#
lcd.mirror(invert)
设置 LCD
是否镜面显示
参数#
invert
: 是否镜面显示,True
或者False
返回值#
当前设置,是否镜面显示,返回True
或者False
bgr_to_rgb
#
lcd.bgr_to_rgb(enable)
设置是否启动 bgr 色彩显示
参数#
enable
:是否启用 bgr 显示,True
或者False
fill_rectangle
#
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 canmv", 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 canmv", 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())