getImageData 非万能，需同源、坐标合法、画布已渲染；跨域图须设 img.crossOrigin='anonymous' 且服务端配 CORS；空白画布返回全黑数据；ImageData.data 是 Uint8ClampedArray，按 R-G-B-A 每像素4字节布局，修改后需 putImageData 生效；参数须为非负整数，越界易报错；大图处理宜用 OffscreenCanvas 或 Web Worker。
getImageData 不是“读取像素”的万能开关，它只在满足同源、坐标合法、画布已渲染三个前提下才返回真实数据；否则直接抛 SecurityError 或静默失败。
调用前必须确保 canvas 已绘制且无跨域污染
即使你用 drawImage 把一张图片画进 canvas，只要这张图来自其他域名且没设置 crossOrigin，后续任何 getImageData 都会触发安全异常。
- 加载图片时必须写
img.crossOrigin = 'anonymous'，不能是'*'或空字符串 - 服务端响应头需包含
Access-Control-Allow-Origin（值需匹配或为*） - 本地 file:// 协议下直接加载图片必然失败，必须走 http(s) 服务
- canvas 内容为空白或未执行
drawImage/fillRect等绘制操作，getImageData仍会返回全黑数据（RGBA 均为 0），但不会报错
理解 ImageData.data 的内存布局和索引计算
返回的 data 是 Uint8ClampedArray，不是普通数组，不支持 map、filter 等方法；每个像素占 4 个连续字节，顺序固定为 R→G→B→A。
把任意文章或文档内容转换成精美的全屏翻页 HTML 演示文件（幻灯片风格）。当用户发来一篇文章、文档链接、Markdown 内容、或粘贴的文本，并且希望生成演示用的 HTML 时触发。支持任意内容来源：iWiki 链接、KM 链接、本地文件路径、直接粘贴的文本。生成的 HTML 文件保存到本地工作区，并通过企微直接发送给用户。触发词示例：帮我把这篇文章做成PPT、转成演示文档、生成HTML幻灯片、做个演示、转成可以演示的格式、article to deck、make a slide。
- 第
i行第j列像素（从 0 开始）对应data的起始下标是(i * imageData.width + j) * 4 - 修改单个像素：
data[idx] = r; data[idx + 1] = g; data[idx + 2] = b; data[idx + 3] = a - 遍历全部像素时，循环步长必须是 4，且总长度为
imageData.width * imageData.height * 4 - 直接改
data不影响画布显示，必须显式调用putImageData才生效
常见错误：坐标/尺寸传参越界或非整数
getImageData(x, y, width, height) 对参数类型和范围极其敏感，稍有偏差就报错或返回空数据。
-
x和y必须是整数，小数会被向下取整（如2.9→2），但若超出 canvas 边界（比如y = -1或x > canvas.width），直接抛IndexSizeError -
width和height必须 ≥ 0；传负数在部分浏览器中可能被忽略，但行为不可靠 - 提取区域不能超出 canvas 实际尺寸：例如 canvas 是 300×200，却调用
getImageData(250, 180, 100, 100)，实际只取到右下角那块有效区域，其余填充 0，但不会报错 - 想取单个像素？别用
getImageData(x, y, 1, 1)—— 它开销大；应先获取整块再按公式算下标
最易被忽略的是：所有像素操作都发生在主线程，getImageData 返回的数据量随区域增大呈平方级增长；处理大图（如 2000×1500）时，仅一次调用就可能分配上千万字节内存，卡顿或 OOM 都可能发生。真要批量处理，得考虑 OffscreenCanvas 或 Web Worker 搬运数据。
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
