显示屏

LCD 屏幕显示库

M5 系列显示库说明

1. 显示

• 底层图形库，提供屏幕绘制、文字、线条、颜色管理等基础功能。

• 可独立使用，适合只需要绘制图形或文字的场景。

2. M5Widgets

• 基础控件库，提供标签、图片显示等 UI 控件。

• 底层依赖 M5GFX。

• 适合需要简单交互控件的界面。

3. M5UI

• 高层 UI 框架，基于 LVGL 封装。

• 提供页面管理、多控件布局和统一事件处理。

使用提示

• ⚠️ 不建议同时混用 M5GFX、M5Widgets、M5UI，可能导致渲染异常或事件冲突。

• 单独绘图 → 使用 M5GFX。

• 简单控件交互 → 使用 M5Widgets。

• 多页面 UI → 使用 M5UI。

UiFlow2 应用示例

基础绘图

在 UiFlow2 上打开 cores3_draw_test_example.m5f2 项目。

本示例演示了 M5.Lcd 的基本绘图功能，包括文字、图片、二维码以及各种图形。

UiFlow2 代码块：

示例输出：

无

画布绘图

在 UiFlow2 上打开 cores3_display_canvas_example.m5f2 项目。

本示例演示了如何创建和使用画布进行绘图。它创建一个 2 位颜色深度的画布，在上面绘制圆形，然后将画布推送到显示屏。

UiFlow2 代码块：

示例输出：

无

MicroPython 应用示例

基础绘图

本示例演示了 M5.Lcd 的基本绘图功能，包括文字、图片、二维码以及各种图形。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT
import os, sys, io
import M5
from M5 import *


def setup():
    M5.begin()
    Widgets.setRotation(1)
    Widgets.fillScreen(0x222222)
    print((str("rotation: ") + str((M5.Lcd.getRotation()))))
    print((str((str("w: ") + str((M5.Lcd.width())))) + str((str("h:") + str((M5.Lcd.height()))))))
    M5.Lcd.setRotation(1)
    M5.Lcd.clear(0x000000)
    M5.Lcd.setTextColor(0x0000FF, 0x000000)
    M5.Lcd.setCursor(200, 3)
    M5.Lcd.printf("hello M5")
    M5.Lcd.print("hello M5", 0x6600CC)
    M5.Lcd.drawImage("/flash/res/img/default.png", 0, 0)
    M5.Lcd.drawQR("Hello", 220, 40, 100, 1)
    M5.Lcd.drawCircle(30, 80, 20, 0x3333FF)
    M5.Lcd.fillCircle(80, 80, 20, 0x009900)
    M5.Lcd.drawEllipse(60, 140, 50, 30, 0x00FF00)
    M5.Lcd.fillEllipse(60, 140, 30, 20, 0xFFFF00)
    M5.Lcd.drawLine(115, 10, 115, 60, 0xFF0000)
    M5.Lcd.drawRect(125, 10, 40, 30, 0xFF0000)
    M5.Lcd.fillRect(125, 50, 40, 30, 0x00FF00)
    M5.Lcd.drawTriangle(135, 150, 110, 190, 160, 190, 0x00FF00)
    M5.Lcd.fillTriangle(145, 150, 170, 190, 190, 150, 0x0000FF)
    M5.Lcd.drawArc(10, 180, 40, 45, 0, 90, 0xFFFF00)
    M5.Lcd.fillArc(20, 190, 40, 45, 0, 90, 0x00FFFF)


def loop():
    M5.update()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

无

画布绘图

本示例演示了如何创建和使用画布进行绘图。它创建一个 2 位颜色深度的画布，在上面绘制圆形，然后将画布推送到显示屏。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT
import os, sys, io
import M5
from M5 import *


title0 = None


def setup():
    global title0
    M5.begin()
    Widgets.setRotation(1)
    Widgets.fillScreen(0x222222)
    title0 = Widgets.Title("Display canvas example", 3, 0xFFFFFF, 0x0000FF, Widgets.FONTS.DejaVu18)
    canvas_rmy = M5.Lcd.newCanvas(100, 100, 2, True)
    canvas_rmy.drawCircle(30, 30, 20, 0xFFFFFF)
    canvas_rmy.drawCircle(30, 50, 20, 0xFFFFFF)
    canvas_rmy.drawCircle(50, 40, 20, 0xFFFFFF)
    canvas_rmy.push(50, 30)
    print((str("colro depth: ") + str((canvas_rmy.getColorDepth()))))


def loop():
    global title0
    M5.update()


if __name__ == "__main__":
    try:
        setup()
        while True:
            loop()
    except (Exception, KeyboardInterrupt) as e:
        try:
            from utility import print_error_msg

            print_error_msg(e)
        except ImportError:
            print("please update to latest firmware")

示例输出：

无

API参考

class M5.Display

width()

获取显示屏水平分辨率。

返回宽度:

水平分辨率。

Return type:

int

UiFlow2 代码块：

MicroPython 代码块：

Display.width()

height()

获取显示屏垂直分辨率。

返回高度:

垂直分辨率。

Return type:

int

UiFlow2 代码块：

MicroPython 代码块：

Display.height()

getRotation()

获取显示屏旋转方向。

返回旋转方向:

旋转方向值

Return type:

int

旋转值：

• 1：0° 旋转。

• 2：旋转 90°

• 3：180° 旋转。

• 4：270° 旋转。

UiFlow2 代码块：

MicroPython 代码块：

Display.getRotation()

getColorDepth()

获取显示屏颜色深度。

返回颜色深度:

以每像素位数表示的颜色深度。

Return type:

int

UiFlow2 代码块：

MicroPython 代码块：

Display.getColorDepth()

getCursor()

获取显示屏绘图光标位置。

返回位置:

tuple (x, y) 光标位置。

Return type:

tuple

UiFlow2 代码块：

MicroPython 代码块：

Display.getCursor()

setRotation(r)

设置显示屏旋转。

参数:

r (int) – 旋转值（1～4）：- 1：旋转 0°。- 2：旋转 90°。- 3：旋转 180°。- 4：旋转 270°。

UiFlow2 代码块：

MicroPython 代码块：

Display.setRotation(2)

setColorDepth(bpp)

设置画布的颜色深度。

参数:

bpp (int) – 期望的颜色深度（以每像素位数表示）。

注意：此方法仅适用于画布对象，不适用于显示屏本身。对于 CoreS3 设备，显示屏颜色深度固定为 16 位。

UiFlow2 代码块：

MicroPython 代码块：

Display.setColorDepth(16)

setEpdMode(epd_mode)

设置显示屏的 EPD 模式。

参数:

epd_mode (int) – 所需 EPD 模式 - 0：M5.Lcd.EPDMode.EPD_QUALITY - 1：M5.Lcd.EPDMode.EPD_TEXT - 2：M5.Lcd.EPDMode.EPD_FAST - 3：M5.Lcd.EPDMode.EPD_FASTEST

注意：仅适用于具有 EPD 功能的设备。

UiFlow2 代码块：

MicroPython 代码块：

Display.setEpdMode(2)

isEPD()

检查显示屏是否为电子墨水屏（EPD）。

返回是否为 EPD:

如果显示屏为 EPD，则返回 True，否则返回 False。

Return type:

bool

UiFlow2 代码块：

MicroPython 代码块：

Display.isEPD()

setFont(font)

置显示字体。

参数:

font –

支持内置字体和字体文件（例如 .bin（lvgl 二进制字体格式）或 .vlw（Processing 字体格式））。可用的内置字体如下：

字体名称	状态	替代字体	不支持的设备
M5.Lcd.FONTS.ASCII7	❌ 已废弃	M5.Lcd.FONTS.Montserrat12
M5.Lcd.FONTS.DejaVu9	❌ 已废弃	M5.Lcd.FONTS.Montserrat12
M5.Lcd.FONTS.DejaVu12	❌ 已废弃	M5.Lcd.FONTS.Montserrat14
M5.Lcd.FONTS.DejaVu18	❌ 已废弃	M5.Lcd.FONTS.Montserrat18
M5.Lcd.FONTS.DejaVu24	❌ 已废弃	M5.Lcd.FONTS.Montserrat24
M5.Lcd.FONTS.DejaVu40	❌ 已废弃	M5.Lcd.FONTS.Montserrat40
M5.Lcd.FONTS.DejaVu56	❌ 已废弃	M5.Lcd.FONTS.Montserrat44
M5.Lcd.FONTS.DejaVu72	❌ 已废弃	M5.Lcd.FONTS.Montserrat48
M5.Lcd.FONTS.EFontCN24	❌ 已废弃	M5.Lcd.FONTS.AlibabaPuHuiTiCN24
M5.Lcd.FONTS.EFontJA24	❌ 已废弃	M5.Lcd.FONTS.AlibabaSansJA24
M5.Lcd.FONTS.EFontKR24	❌ 已废弃	M5.Lcd.FONTS.AlibabaSansKR24
M5.Lcd.FONTS.Montserrat12	✅ 推荐
M5.Lcd.FONTS.Montserrat14	✅ 推荐
M5.Lcd.FONTS.Montserrat16	✅ 推荐
M5.Lcd.FONTS.Montserrat18	✅ 推荐
M5.Lcd.FONTS.Montserrat24	✅ 推荐
M5.Lcd.FONTS.Montserrat40	✅ 推荐
M5.Lcd.FONTS.Montserrat48	✅ 推荐
M5.Lcd.FONTS.AlibabaPuHuiTiCN24	✅ 推荐		M5STACK_StickC_PLUS, M5STACK_CoreInk, M5STACK_StickC, M5STACK_Atom_Lite, M5STACK_Stamp_PICO, M5STACK_Atom_Matrix, M5STACK_AtomU, M5STACK_Atom_Echo, M5STACK_NanoC6
M5.Lcd.FONTS.AlibabaSansJA24	✅ 推荐
M5.Lcd.FONTS.AlibabaSansKR24	✅ 推荐

UiFlow2 代码块：

MicroPython 代码块：

Display.setFont(M5.Lcd.FONTS.DejaVu18)

setTextColor(fgcolor, bgcolor)

设置文本颜色和背景颜色。

参数:

• fgcolor (int) – 文本颜色，RGB888 格式。默认值为 0（黑色）。

• bgcolor (int) – 背景颜色，RGB888 格式。默认值为 0（黑色）

UiFlow2 代码块：

MicroPython 代码块：

Display.setTextColor(0xFF0000, 0x000000)

setTextScroll(scroll)

启用或禁用文本滚动。

参数:

scroll (bool) – 设置为 True 启用文本滚动，设置为 False 禁用文本滚动。默认值为 False。

UiFlow2 代码块：

MicroPython 代码块：

Display.setTextScroll(True)

setTextSize(size)

设置文本的大小。

参数:

size (int) – 期望的文本大小。

UiFlow2 代码块：

MicroPython 代码块：

Display.setTextSize(2)

setCursor(x, y)

设置光标位置。

参数:

• x (int) – 光标的水平位置。默认值为 0。

• y (int) – 光标的垂直位置。默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.setCursor(10, 20)

clear(color)

使用指定颜色清空显示屏

参数:

color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.clear(0xFFFFFF)

fillScreen(color)

用指定颜色填充整个屏幕。

参数:

color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.fillScreen(0xFF0000)

drawPixel(x, y, color)

在屏幕上绘制单个像素。

参数:

• x (int) – 像素的水平坐标。默认值为 -1

• y (int) – 像素的垂直坐标。默认值为 -1

• color (int) – 素的颜色，RGB888 格式。默认值为 0

UiFlow2 代码块：

MicroPython 代码块：

Display.drawPixel(50, 50, 0x00FF00)

drawCircle(x, y, r, color)

绘制一个圆。

参数:

• x (int) – 圆心的 x 坐标。默认值为 -1。

• y (int) – 圆心的 y 坐标。默认值为 -1。

• r (int) – 圆的半径。默认值为 -1。

• color (int) – 圆的颜色，RGB888 格式。默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawCircle(60, 60, 20, 0x0000FF)

fillCircle(x, y, r, color)

绘制一个实心圆。

参数:

• x (int) – 圆心的 x 坐标。默认值为 -1。

• y (int) – 圆心的 y 坐标。默认值为 -1。

• r (int) – 圆的半径。默认值为 -1。

• color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.fillCircle(60, 60, 20, 0x00FFFF)

drawEllipse(x, y, rx, ry, color)

绘制一个椭圆。

参数:

• x (int) – 椭圆中心的 x 坐标。默认值为 -1。

• y (int) – 椭圆中心的 y 坐标。默认值为 -1。

• rx (int) – 椭圆的水平半径。默认值为 -1。

• ry (int) – 椭圆的垂直半径。默认值为 -1。

• color (int) – 椭圆颜色，RGB888 格式。默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawEllipse(80, 40, 30, 20, 0xFF00FF)

fillEllipse(x, y, rx, ry, color)

绘制一个实心椭圆。

参数:

• x (int) – 椭圆中心的 x 坐标。默认值为 -1。

• y (int) – 椭圆中心的 y 坐标。默认值为 -1。

• rx (int) – 椭圆的水平半径。默认值为 -1。

• ry (int) – 椭圆的垂直半径。默认值为 -1。

• color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.fillEllipse(80, 40, 30, 20, 0x00FF00)

drawLine(x0, y0, x1, y1, color)

绘制一条直线。

参数:

• x0 (int) – 直线起点坐标 x，默认值为 -1。

• y0 (int) – 直线起点坐标 y，默认值为 -1。

• x1 (int) – 直线终点坐标 x，默认值为 -1。

• y1 (int) – 直线终点坐标 y，默认值为 -1。

• color (int) – 线颜色，RGB888 格式，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawLine(10, 10, 100, 100, 0xFF0000)

drawRect(x, y, w, h, color)

绘制一个矩形。

参数:

• x (int) – 形左上角坐标 x，默认值为 -1。”

• y (int) – 矩形左上角坐标 y，默认值为 -1。

• w (int) – 矩形的宽度，默认值为 -1。

• h (int) – 矩形的高度，默认值为 -1。

• color (int) – 矩形颜色，RGB888 格式，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

display.drawRect(20, 20, 80, 50, 0x00FF00)

fillRect(x, y, w, h, color)

绘制一个填充矩形。

参数:

• x (int) – 形左上角坐标 x，默认值为 -1。”

• y (int) – 矩形左上角坐标 y，默认值为 -1。

• w (int) – 矩形的宽度，默认值为 -1。

• h (int) – 矩形的高度，默认值为 -1。

• color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.fillRect(20, 20, 80, 50, 0x0000FF)

drawRoundRect(x, y, w, h, r, color)

绘制一个圆角矩形。

参数:

• x (int) – 形左上角坐标 x，默认值为 -1。”

• y (int) – 矩形左上角坐标 y，默认值为 -1。

• w (int) – 矩形的宽度，默认值为 -1。

• h (int) – 矩形的高度，默认值为 -1。

• r (int) – 圆角半径，默认值为 -1。

• color (int) – 矩形颜色，RGB888 格式，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawRoundRect(30, 30, 60, 40, 10, 0xFF00FF)

fillRoundRect(x, y, w, h, r, color)

绘制一个填充圆角矩形。

参数:

• x (int) – 形左上角坐标 x，默认值为 -1。”

• y (int) – 矩形左上角坐标 y，默认值为 -1。

• w (int) – 矩形的宽度，默认值为 -1。

• h (int) – 矩形的高度，默认值为 -1。

• r (int) – 圆角半径，默认值为 -1。

• color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.fillRoundRect(30, 30, 60, 40, 10, 0x00FFFF)

drawTriangle(x0, y0, x1, y1, x2, y2, color)

绘制一个三角形。

参数:

• x0 (int) – 第一个顶点的坐标 x，默认值为 -1。

• y0 (int) – 第一个顶点的坐标 y，默认值为 -1。

• x1 (int) – 第二个顶点的坐标 x，默认值为 -1。

• y1 (int) – 第二个顶点的坐标 y，默认值为 -1

• x2 (int) – 第三个顶点的坐标 x，默认值为 -1。

• y2 (int) – 第三个顶点的坐标 y，默认值为 -1。

• color (int) – 三角形颜色，RGB888 格式，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawTriangle(10, 10, 50, 80, 90, 10, 0xFF0000)

fillTriangle(x0, y0, x1, y1, x2, y2, color)

绘制一个填充三角形。

参数:

• x0 (int) – 第一个顶点的坐标 x，默认值为 -1。

• y0 (int) – 第一个顶点的坐标 y，默认值为 -1。

• x1 (int) – 第二个顶点的坐标 x，默认值为 -1。

• y1 (int) – 第二个顶点的坐标 y，默认值为 -1

• x2 (int) – 第三个顶点的坐标 x，默认值为 -1。

• y2 (int) – 第三个顶点的坐标 y，默认值为 -1。

• color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.fillTriangle(10, 10, 50, 80, 90, 10, 0x00FF00)

drawArc(x, y, r0, r1, angle0, angle1, color)

绘制一个弧线。

参数:

• x (int) – 弧线的中心坐标 x，默认值为 -1。

• y (int) – 弧线的中心坐标 y，默认值为 -1。

• r0 (int) – 第一个半径，默认值为 -1。

• r1 (int) – 第二个半价，默认值为 -1。

• angle0 (int) – 弧线的起始角度（单位：度），默认值为 -1。

• angle1 (int) – 弧线的终止角度（单位：度），默认值为 -1。

• color (int) – 弧线颜色，RGB888 格式，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawArc(50, 50, 20, 30, 0, 180, 0xFF0000)

fillArc(x, y, r0, r1, angle0, angle1, color)

绘制一个填充弧线。

参数:

• x (int) – 弧线的中心坐标 x，默认值为 -1。

• y (int) – 弧线的中心坐标 y，默认值为 -1。

• r0 (int) – 第一个半径，默认值为 -1。

• r1 (int) – 第二个半价，默认值为 -1。

• angle0 (int) – 弧线的起始角度（单位：度），默认值为 -1。

• angle1 (int) – 弧线的终止角度（单位：度），默认值为 -1。

• color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.fillArc(50, 50, 20, 30, 0, 180, 0x00FF00)

drawEllipseArc(x, y, r0x, r1x, r0y, r1y, angle0, angle1, color)

绘制一个椭圆弧线。

参数:

• x (int) – 弧线的中心坐标 x，默认值为 -1。

• y (int) – 弧线的中心坐标 y，默认值为 -1。

• r0x (int) – 第一个水平半径，默认值为 -1。

• r1x (int) – 第二个水平半径，默认值为 -1。

• r0y (int) – 第一个垂直半径，默认值为 -1。

• r1y (int) – 二个垂直半径，默认值为 -1。”

• angle0 (int) – 弧线的起始角度（单位：度），默认值为 -1。

• angle1 (int) – 椭圆弧线的终止角度（单位：度），默认值为 0。

• color (int) – 弧线颜色，RGB888 格式，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawEllipseArc(50, 50, 20, 40, 10, 30, 0, 180, 0xFF00FF)

fillEllipseArc(x, y, r0x, r1x, r0y, r1y, angle0, angle1, color)

绘制一个填充椭圆弧线。

参数:

• x (int) – 弧线的中心坐标 x，默认值为 -1。

• y (int) – 弧线的中心坐标 y，默认值为 -1。

• r0x (int) – 第一个水平半径，默认值为 -1。

• r1x (int) – 第二个水平半径，默认值为 -1。

• r0y (int) – 第一个垂直半径，默认值为 -1。

• r1y (int) – 二个垂直半径，默认值为 -1。”

• angle0 (int) – 弧线的起始角度（单位：度），默认值为 -1。

• angle1 (int) – 椭圆弧线的终止角度（单位：度），默认值为 0。

• color (int) – 填充颜色，使用 RGB888 格式（默认值为 0）。

UiFlow2 代码块：

MicroPython 代码块：

Display.fillEllipseArc(50, 50, 20, 40, 10, 30, 0, 180, 0x00FFFF)

drawQR(text, x, y, w, version)

绘制二维码。

参数:

• text (str) – 二维码内容

• x (int) – 二维码显示的起始坐标 x，默认值为 0。

• y (int) – 二维码显示的起始坐标 y，默认值为 0。

• w (int) – 二维码的宽度，默认值为 0。

• version (int) – 二维码版本（默认值为 1，范围：0~38）。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawQR("Hello", 0, 0, 200)

drawPng(img, x, y, maxW, maxH, offX, offY, scaleX, scaleY)

绘制 PNG 图片。

参数:

• img (str) – 图片文件路径或已打开的图片数据。

• x (int) – 图片显示的起始坐标 x，默认值为 0。

• y (int) – 图片显示的起始坐标 y，默认值为 0。

• maxW (int) – 要绘制的宽度

• maxH (int) – 要绘制的高度

• offX (int) – 图片中起始的偏移量 x，默认值为 0。

• offY (int) – 图片中起始的偏移量 y，默认值为 0。

• scaleX (bool) – 是否水平缩放图片，默认值分别为 True。

• scaleY (bool) – 是否垂直缩放图片，默认值分别为 False。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawPng("res/img/uiflow.png", 0, 0)

示例：

Display.drawPng("res/img/uiflow.png", 0, 0)
img = open("res/img/uiflow.png", "b")
img.seek(0)
Display.drawPng(img.read(), 0, 100)
img.close()

drawJpg(img, x, y, maxW, maxH, offX, offY)

绘制 JPG 图片。

参数:

• img – 图片文件路径或已打开的图片数据。

• x (int) – 图片显示的起始坐标 x，默认值为 0。

• y (int) – 图片显示的起始坐标 y，默认值为 0。

• maxW (int) – 要绘制的宽度

• maxH (int) – 要绘制的高度

• offX (int) – 图片中起始的偏移量 x，默认值为 0。

• offY (int) – 图片中起始的偏移量 y，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawJpg("res/img/uiflow.jpg", 0, 0)

示例：

Display.drawJpg("res/img/uiflow.jpg", 0, 0)
img = open("res/img/uiflow.jpg", "b")
img.seek(0)
Display.drawJpg(img.read(), 0, 100)
img.close()

drawBmp(img, x, y, maxW, maxH, offX, offY)

绘制 BMP 图片。

参数:

• img – 图片文件路径或已打开的图片数据。

• x (int) – 图片显示的起始坐标 x，默认值为 0。

• y (int) – 图片显示的起始坐标 y，默认值为 0。

• maxW (int) – 要绘制的宽度

• maxH (int) – 要绘制的高度

• offX (int) – 图片中起始的偏移量 x，默认值为 0。

• offY (int) – 图片中起始的偏移量 y，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawBmp("res/img/uiflow.bmp", 0, 0)

示例：

Display.drawBmp("res/img/uiflow.bmp", 0, 0)
img = open("res/img/uiflow.bmp", "b")
img.seek(0)
Display.drawBmp(img.read(), 0, 100)
img.close()

drawImage(img, x, y, maxW, maxH, offX, offY)

绘制图片。

参数:

• img – 图片文件路径或已打开的图片数据。

• x (int) – 图片显示的起始坐标 x，默认值为 0。

• y (int) – 图片显示的起始坐标 y，默认值为 0。

• maxW (int) – 要绘制的宽度

• maxH (int) – 要绘制的高度

• offX (int) – 图片中起始的偏移量 x，默认值为 0。

• offY (int) – 图片中起始的偏移量 y，默认值为 0。

UiFlow2 代码块：

MicroPython 代码块：

img = open("res/img/uiflow.jpg", "b")

示例：

img = open("res/img/uiflow.jpg", "b")
img.seek(0)
Display.drawImage(img.read(), 0, 0)
img.close()

drawRawBuf(buf, x, y, w, h, len, swap)

绘制缓冲区中的图片。

参数:

• buf – 图像数据

• x (int) – 图片显示的起始坐标 x，默认值为 0。

• y (int) – 图片显示的起始坐标 y，默认值为 0。

• w (int) – 图像宽

• h (int) – 图像高

• len (int) – 图像大小

• swap (bool) – 是否反色显示（默认值为 False）。

UiFlow2 代码块：

MicroPython 代码块：

Display.drawRawBuf(raw_buf, 0, 0, 100, 100, len(raw_buf), swap=False)

示例：

width, height = 40, 30
green565 = 0x07E0
raw_buf = bytearray(width * height * 2)
for i in range(width * height):
    raw_buf[2*i]   = (green565 >> 8) & 0xFF
    raw_buf[2*i+1] = green565 & 0xFF
Display.drawRawBuf(raw_buf, 100, 100, width, height, len(raw_buf), swap=False)

print(text, color)

显示字符串（不支持格式化）。

参数:

• text (str) – 要显示的字符串。

• color (int) – 颜色值，RGB888 格式。

UiFlow2 代码块：

MicroPython 代码块：

Display.print("Hello World", color=0xFF0000)

printf(text)

显示格式化字符串。

参数:

text (str) – 要显示的格式化字符串。

UiFlow2 代码块：

MicroPython 代码块：

Display.printf("Value: %d" % 100)

newCanvas(w, h, bpp, psram)

创建一个画布。

参数:

• w (int) – 画布宽

• h (int) – 画布高

• bpp (int) – 颜色深度

• psram (bool) – 使用 PSRAM

返回:

创建画布对象。

UiFlow2 代码块：

MicroPython 代码块：

w1 = Display.newCanvas(w=100, h=100, bpp=16)

示例：

w1 = Display.newCanvas(w=100, h=100, bpp=16)
w1.drawImage("res/img/uiflow.jpg", 80, 0)
w1.push(30, 0)

startWrite()

开始向显示屏写入内容。

UiFlow2 代码块：

MicroPython 代码块：

Display.startWrite()

示例：

Display.startWrite()
Display.drawPixel(10, 10, 0xFF0000)
Display.endWrite()

endWrite()

结束显示屏写入。

UiFlow2 代码块：

MicroPython 代码块：

Display.endWrite()