2. 坐标系基础：屏幕坐标系与触摸屏坐标系的映射关系
做触摸开发，第一个绕不开的坎就是坐标系。说白了，屏幕有屏幕的坐标，触摸屏有触摸屏的坐标，它们不是一回事。我刚开始接触这块时，以为触摸点直接对应像素点，结果画出来的东西全跑偏了——嗯，后来才明白，这中间隔着一层映射关系。
2.1 两个坐标系，各说各话
先搞清楚两个坐标系分别长什么样。
| 坐标系 | 原点位置 | 单位 | 典型范围 |
|---|---|---|---|
| 屏幕坐标系 | 左上角 (0,0) | 像素 (px) | 0 ~ 屏幕宽/高 - 1 |
| 触摸屏坐标系 | 由硬件决定，通常也是左上角 | 原始采样值 (ADC counts) | 0 ~ 触摸控制器最大值 |
屏幕坐标系很好理解——你写 UI 时用的 x、y 就是它。触摸屏坐标系就有点意思了。触摸屏本身是一层电阻或电容感应层，它输出的不是像素，而是电压或电容变化量，经过 ADC 转换后变成一串数字。这串数字的范围取决于触摸控制器的精度，比如 12 位 ADC 就是 0~4095。
关键认知：触摸屏输出的原始坐标是「物理量」，不是「像素量」。你不能直接用 raw_x 去 setX()，必须先做映射。
2.2 映射公式：从触摸坐标到屏幕坐标
映射本质上是一个线性变换。假设触摸屏的 X 轴范围是 [touch_min_x, touch_max_x]，屏幕的 X 轴范围是 [0, screen_width]，那么映射公式就是：
screen_x = (raw_x - touch_min_x) * screen_width / (touch_max_x - touch_min_x)
screen_y = (raw_y - touch_min_y) * screen_height / (touch_max_y - touch_min_y)这个公式看起来简单，但坑全在参数上。我遇到过好几次，触摸屏的物理范围并不是从 0 开始的——有些控制器在没触摸时输出一个非零值，触摸时反而变小。你想想看，如果直接用 raw_x 去算，结果肯定不对。
我的习惯：每次拿到新硬件，第一件事就是打印触摸屏的原始范围。用手指从屏幕最左滑到最右，记录 min 和 max。别信数据手册，实测最靠谱。
2.3 校准：为什么映射会偏移？
理论上公式没问题，但实际中你会发现，触摸点总是偏那么几个像素。原因主要有三个：
- 触摸屏贴合偏差——触摸感应层和 LCD 面板之间有一层光学胶，贴合时会有微米级的偏移。别小看这点偏移，在边缘区域可能差出 10~20 个像素。
- ADC 非线性——触摸控制器的 ADC 并不是完美的线性器件，尤其在两端区域，采样值会偏离理想曲线。
- 屏幕缩放/旋转——如果你做了 UI 缩放或者横竖屏切换，坐标系又多了一层变换。
我曾经在一个 7 寸屏的项目上，触摸点总是往右下角偏 5 个像素。查了两天，最后发现是触摸屏的 FPC 排线在组装时被压到了，导致感应层阻抗变化。嗯，硬件问题也能造成坐标系偏移，这一点很多人想不到。
2.4 多点触摸的坐标系
单点触摸的映射还算简单，多点触摸就复杂了。每个触摸点都有自己的原始坐标，而且触摸控制器上报的顺序不一定和物理位置对应。比如你同时按了左上和右下，控制器可能先报右下再报左上。
这时候你需要做两件事：
- 给每个触摸点分配一个唯一的 ID——跟踪同一个手指从按下到抬起的完整轨迹。
- 对每个 ID 独立做坐标映射——每个点的 raw_x/raw_y 都要走一遍上面的公式。
注意：有些触摸控制器在多点模式下会做「坐标平滑」或「抖动过滤」，这会导致原始坐标滞后。如果你发现触摸响应慢，先检查控制器配置，别急着改软件。
2.5 坐标系映射的完整流程
下面这张图展示了从触摸事件发生到屏幕坐标输出的完整链路：
2.6 实战：写一个简单的映射函数
理论讲完了，直接上代码。下面这个 Python 函数演示了如何做单点映射：
def map_touch_to_screen(raw_x, raw_y, touch_range, screen_size):
"""
将触摸原始坐标映射到屏幕像素坐标
参数:
raw_x, raw_y: 触摸控制器输出的原始值
touch_range: (min_x, max_x, min_y, max_y) 触摸屏物理范围
screen_size: (width, height) 屏幕像素尺寸
返回:
(screen_x, screen_y) 像素坐标
"""
tx_min, tx_max, ty_min, ty_max = touch_range
sw, sh = screen_size
# 防止除零
if tx_max - tx_min == 0 or ty_max - ty_min == 0:
return (0, 0)
# 线性映射
screen_x = (raw_x - tx_min) * sw / (tx_max - tx_min)
screen_y = (raw_y - ty_min) * sh / (ty_max - ty_min)
# 边界裁剪
screen_x = max(0, min(sw - 1, screen_x))
screen_y = max(0, min(sh - 1, screen_y))
return (int(screen_x), int(screen_y))避坑指南：我曾经在边界裁剪上吃过亏。如果不做裁剪，触摸点在边缘时可能算出负值或超出屏幕宽度的值，轻则 UI 错位，重则数组越界崩溃。所以映射之后一定要 clamp 一下。
2.7 坐标系映射的常见陷阱
- 方向不一致——有些触摸屏的 Y 轴方向是反的（原点在左下角），需要做翻转：
screen_y = screen_height - 1 - mapped_y。 - 缩放因子不对——如果你在 UI 层做了 DPI 缩放，触摸坐标要先映射到逻辑分辨率，再乘以缩放因子。
- 多屏拼接——双屏或异形屏场景下，每个屏幕有自己的触摸屏，坐标需要加上屏幕偏移量。
警告：不要在生产环境中硬编码触摸范围参数。每台设备的触摸屏都有个体差异，同一型号的两台设备，触摸范围可能差 5%~10%。一定要做运行时校准或出厂校准数据存储。
坐标系映射是整个触摸刷新机制的基石。你想想看，如果连触摸点在哪都搞不准，后面所有的刷新优化都是空中楼阁。我个人习惯在项目初期就写一个坐标映射的单元测试，用已知的物理位置去验证映射结果——这一步花不了多少时间，但能省掉后面大量的调试时间。