触摸

Touch 类提供用于读取触摸坐标、触点数量以及带触摸屏的 M5Stack 设备上详细触摸信息的方法。

UiFlow2 应用示例

获取触摸坐标

在 UiFlow2 中打开 cores3_touch_example.m5f2 工程。

该示例演示如何获取触摸事件的 X 和 Y 坐标并将其显示在屏幕上。

UiFlow2 代码块：

示例输出：

屏幕会显示当前触摸事件的 X 和 Y 坐标。

MicroPython 应用示例

获取触摸坐标

该示例演示如何获取触摸事件的 X 和 Y 坐标并将其显示在屏幕上。

MicroPython 代码块：

# SPDX-FileCopyrightText: 2026 M5Stack Technology CO LTD
#
# SPDX-License-Identifier: MIT

import os, sys, io
import M5
from M5 import *


label0 = None
label1 = None


cur_x = None
cur_y = None


def setup():
    global label0, label1, cur_x, cur_y

    M5.begin()
    Widgets.setRotation(0)
    Widgets.fillScreen(0x222222)
    label0 = Widgets.Label("x: 0", 32, 41, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)
    label1 = Widgets.Label("y: 0", 33, 84, 1.0, 0xFFFFFF, 0x222222, Widgets.FONTS.DejaVu18)


def loop():
    global label0, label1, cur_x, cur_y
    M5.update()
    if M5.Touch.getCount():
        cur_x = M5.Touch.getX()
        cur_y = M5.Touch.getY()
        label0.setText(str((str("x: ") + str(cur_x))))
        label1.setText(str((str("y: ") + str(cur_y))))


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")

示例输出：

屏幕会显示当前触摸事件的 X 和 Y 坐标。

API参考

触摸

class M5.Touch

getX()

获取当前触摸点的 X 坐标。

返回的坐标会根据 setRotation() 设置的当前屏幕旋转方向自动调整。

返回:: int - X 坐标。

UiFlow2 代码块：

MicroPython 代码块：

x = M5.Touch.getX()

getY()

获取当前触摸点的 Y 坐标。

返回的坐标会根据 setRotation() 设置的当前屏幕旋转方向自动调整。

返回:: int - Y 坐标。

UiFlow2 代码块：

MicroPython 代码块：

y = M5.Touch.getY()

getCount()

获取当前触点数量。

返回:: int - 当前有效触点数量（无触摸时为 0）。

UiFlow2 代码块：

MicroPython 代码块：

count = M5.Touch.getCount()

getDetail(index=0)

获取指定触点的详细信息。

参数:: index (int) – 触点索引（默认值为 0）。
返回:: 元组 - 一个包含 11 个元素的元组，提供触摸状态的详细信息：[0] deltaX (int)：自上次测量以来在 X 轴上的位移差；[1] deltaY (int)：自上次测量以来在 Y 轴上的位移差；[2] distanceX (int)：自触摸开始以来在 X 轴上的累计移动距离；[3] distanceY (int)：自触摸开始以来在 Y 轴上的累计移动距离；[4] isPressed (bool)：当前是否处于按下状态；[5] wasPressed (bool)：是否刚刚变为按下状态；[6] wasClicked (bool)：是否刚刚完成一次点击；[7] isReleased (bool)：当前是否处于释放状态；[8] wasReleased (bool)：是否刚刚从按下变为释放状态；[9] isHolding (bool)：当前是否处于长按保持状态；[10] wasHold (bool)：是否曾经处于长按保持状态。

MicroPython 代码块：

detail = M5.Touch.getDetail(0)

getTouchPointRaw(index=0)

获取原始触点坐标。

警告

此方法返回 原始硬件坐标，不会根据 setRotation() 设置的当前屏幕方向调整。修改屏幕方向后，必须手动转换坐标，使其与显示方向一致。

单点触摸优先使用会自动适配旋转方向的 getX() / getY()；需要多点触摸时再使用 getTouchPointRaw()。

参数:: index (int) – 触点索引（默认值为 0）。
返回:: 元组 - 一个包含 4 个元素的元组，提供原始触点数据：[0] x (int)：原始 X 坐标；[1] y (int)：原始 Y 坐标；[2] size (int)：触点的大小或压力；[3] id (int)：用于跟踪该触点的唯一标识。

UiFlow2 代码块：

MicroPython 代码块：

raw = M5.Touch.getTouchPointRaw(0)

多点触摸的坐标转换

通过 setRotation() 修改屏幕方向后，必须手动转换 getTouchPointRaw() 返回的原始坐标，使其与当前显示方向一致：

def transform_touch(raw_x, raw_y, rotation, raw_w, raw_h):
    """Transform raw touch coordinates to match display rotation."""
    if rotation == 0:
        return raw_x, raw_y
    elif rotation == 1:
        return raw_y, (raw_w - 1) - raw_x
    elif rotation == 2:
        return (raw_w - 1) - raw_x, (raw_h - 1) - raw_y
    elif rotation == 3:
        return (raw_h - 1) - raw_y, raw_x
    return raw_x, raw_y

# Usage:
raw = M5.Touch.getTouchPointRaw(0)
if raw:
    x, y, _, _ = raw
    # raw_w, raw_h = physical panel size (before rotation)
    sx, sy = transform_touch(x, y, M5.Lcd.getRotation(), 1280, 720)

单点触摸优先使用会自动适配旋转方向的 getX() / getY()。