class DSIDisplay – DSI 显示驱动程序

DSIDisplay 类用于驱动MIPI LCD。

使用示例驱动 800x480 MIPI LCD:

import sensor, display

# Setup camera.
sensor.reset()
sensor.set_pixformat(sensor.RGB565)
sensor.set_framesize(sensor.LCD)
sensor.skip_frames()
lcd = display.DSIDisplay(controller=display.ST7701())

# Show image.
while(True):
    lcd.write(sensor.snapshot())

构造函数

class display.DSIDisplay([framesize=display.FWVGA[, refresh=60[, portrait=False[, channel=0[, controller[, backlight]]]]]])

framesize 支持的标准分辨率之一。

refresh 设置屏幕刷新率（赫兹）。这控制了DSI LCD 时钟。

portrait 交换帧大小的宽度和高度。

channel 用于与显示屏通信的虚拟 MIPI DSI 通道。

controller 在此处传递控制器芯片类以初始化它以及显示屏。例如，display.ST7701() 是 MIPI DSI 显示器的标准显示控制器。

backlight 指定要使用的背光控制器模块。默认情况下，背光将通过 GPIO 引脚控制。

方法

DSIDisplay.deinit()

释放类使用的 I/O 引脚和 RAM。在销毁时自动调用此方法。

DSIDisplay.width()

返回屏幕的宽度。

DSIDisplay.height()

返回屏幕的高度。

DSIDisplay.refresh()

返回刷新率。

DSIDisplay.write(image, [x=0, [y=0, [x_scale=1.0, [y_scale=1.0, [roi=None, [rgb_channel=-1, [alpha=256, [color_palette=None, [alpha_palette=None]]]]]]]]]])

显示一个左上角从位置x，y开始的 image。

您也可以传递路径而不是图像对象给此方法，一边从磁盘加载图像并在一步中绘制它。例如 write("test.jpg")。

x_scale 控制图像在 x 方向的显示比例（float）。如果此值为负，则图像将水平翻转。注意，如果未指定 y_scale，则它将与 x_scale 匹配，以保持纵横比。

y_scale 控制图像在 y 方向的显示比例（float）。如果此值为负，则图像将垂直翻转。注意，如果未指定 x_scale，则它将与 x_scale 匹配，以保持纵横比。

roi 是要显示的图像的感兴趣区域矩形元组（x、y、w、h）。这允许您仅提取感兴趣区域的像素以进行缩放。

rgb_channel 是从RGB565图像（如果传递）中提取和在显示屏上渲染的RGB通道（0=R, G=1, B=2）。例如，如果传递 rgb_channel=1 ，则会提取RGB565图像的绿色通道并以灰度显示。

alpha 控制图像的不透明度。职位256显示不透明图像，而低于256的值会产生黑色透明图像。0会产生完全黑色图像。

color_palette 如果不是 -1 ，可以是 image.PALETTE_RAINBOW、image.PALETTE_IRONBOW 或总共256像素的RGB565图像，用作输入图像的灰度值的颜色查找表。如果使用了 rgb_channel，则会在缩放之后应用此选项。

alpha_palette 如果不是 -1，可以是总共 256 像素的 GRAYSCALE 图像，用作 alpha 调色板，以像素级别调制正在显示的输入图像的 alpha 值，从而精确控制根据其灰度值的像素的 alpha 值。 alpha 查找表中值为 255 的像素是不透明的，小于 255 的值会更加透明直到 0。如果使用了 rgb_channel，则会在缩放之后应用此选项。

hint 可以是标志的逻辑 OR：

DSIDisplay.clear([display_off=False])

将LCD屏幕清除为黑色。

display_off 如果为 True则关闭显示逻辑，而不是将 LCD 帧缓冲区清除为黑色。之后，还应关闭背光，以确保屏幕变为黑色，因为许多显示器仅在打开背光时为白色。

DSIDisplay.backlight([value])

设置LCD背光调光值。0（关闭）至100（开启）。

请注意，除非传递 DACBacklight 或 PWMBacklight ，否则背光将作为GPIO引脚进行控制，并且只能从0（关闭）到非0（开启）。

不传递参数以获取背光值的状态。

DSIDisplay.bus_write(cmd[, args=None[, dcs=False]])

发送带有 args 的 DSI 显示器 cmd。

DSIDisplay.bus_read(cmd[, len[, args=None[, dcs=False]]])

使用 args 和 cmd 从 DSI 显示器读取 len。