~/notes/screenpin-02-svg-coordinates-and-drag-performance.md1159 字

项目实战ScreenPin 桌面编辑器学习笔记 · 02/03

ScreenPin(二):SVG 逆矩阵与拖拽事件合并

通过 clientToImage 和 requestAnimationFrame,解释窗口压缩后的坐标偏移,以及如何减少重绘而保留手绘采样点。

目录 4 节

截图标注使用原图坐标,鼠标事件却提供视口坐标。窗口缩放和平铺布局改变两者的关系,高频 pointer 事件又可能放大布局测量与渲染开销。

本篇围绕 src/EditorCanvas.tsx 的两个修复展开:使用 SVG 逆矩阵映射坐标,在保留输入数据的同时合并画面更新。

一、窗口缩放之后,鼠标坐标不能直接除以宽度

标注需要保存在原图坐标系中,但鼠标事件给的是视口坐标,两者之间存在缩放和偏移。

最初的计算方式是减去画布位置,再按显示宽度和原图宽度换算。普通窗口里它可能看起来正常,但平铺合成器压缩窗口后,SVG 会按自身的比例规则缩放,并在容器中居中留边。容器尺寸和真实图像显示区域就不再相同。

此时再直接用容器宽度计算,标注会偏离光标。窗口越受约束,这类问题越容易被看见。

修复使用 SVG 的实际变换矩阵,把屏幕点映射回原图坐标:

const matrix = svg.getScreenCTM()?.inverse();
if (!matrix) return;

const point = new DOMPoint(clientX, clientY).matrixTransform(matrix);

这是项目实现的简化片段。实际拖拽还会缓存矩阵并捕获 pointer,避免光标离开对象后中断操作。

getScreenCTM() 给出 SVG 局部坐标到视口坐标的变换。鼠标点已经在视口坐标中,所以要取逆矩阵,得到回到 SVG 坐标的映射。src/EditorCanvas.tsx 中的 clientToImage 封装了这一步。

这次问题的关键是采用真实的渲染变换。只要 SVG 发生了比例缩放、居中或其他坐标变换,就不应该继续假设它恰好铺满外层盒子。

二、拖拽事件很多,不需要每次都重绘

拖拽卡顿来自另一条路径:每次 pointermove 都读取 getBoundingClientRect(),再生成新数组推动 React 重绘整张 SVG。

高频鼠标会在一秒内产生大量事件,反复读布局和更新画面就增加了主线程负担。

现在几何信息在拖拽开始时测量,事件通过 requestAnimationFrame 按帧合并。移动和缩放可以在这一帧使用最新位置,手绘则保留所有采样点,统一提交显示更新。

这里需要分开“记录事件”和“更新画面”。降低更新次数,不应该顺便删掉手绘轨迹中的中间点,否则画笔可能变得不连贯。

同一轮还把 PNG 截图改为读取尺寸后原样传递,减少无谓的重新编码;标注比较则改为逐字段判断,避免对象属性顺序和可选字段差异造成未保存状态误报。

三、坐标变换和更新频率分别检查

可以用一个简化场景理解逆矩阵:假设图像显示缩小为原来的二分之一,并在容器左侧留出边距。鼠标横坐标需要先去掉真实图像的偏移,再除以缩放比例。外层盒子的宽度无法单独给出这两个量,SVG 自身的矩阵则包含实际变换。

这个例子只是原理说明。完整实现还会在拖拽开始时缓存逆矩阵并使用 pointer capture;如果扩展交互时允许拖拽过程中改变画布变换,就需要重新检查缓存何时失效。

验证拖拽时,坐标映射和更新节奏应分别看:缩放与留边下落点是否正确,手绘是否保留全部采样点,更新次数是否受帧调度约束。仓库记录中仍列有低缩放、大图和平铺压缩等人工回归事项,本文没有重新执行这些桌面操作。

本系列对应仓库目前为私有,代码片段取自已核对的实现;删去的字段或流程已在相关段落注明。

系列阅读

上一章:ScreenPin(一):可编辑标注、工程文件与图片导出

下一章:ScreenPin(三):Wayland 快捷键授权与会话切换

  1. ScreenPin(一):可编辑标注、工程文件与图片导出
  2. ScreenPin(二):SVG 逆矩阵与拖拽事件合并
  3. ScreenPin(三):Wayland 快捷键授权与会话切换