Canvas 处理手机照片:EXIF 方向与几何纯函数

2026-11-19 前端开发 有希 39 次瀏覽

手机竖着拍的照片,在系统相册里是正的,上传到网页后却被画成横的;裁切框在预览里明明贴着人脸,导出的图却偏了一截;几张不同尺寸的截图拼在一起,接缝处忽高忽低。前两个问题通常来自 EXIF 方向,第三个来自布局计算散落在绘制代码里。本文按门户的图片工具实现,说明解码时怎么处理方向,以及为什么把裁切、拼接、宫格的几何计算写成纯函数。

先给结论

手机照片的像素数据和“应该怎么摆”是两件事。JPEG 里存着 EXIF Orientation,解码器可以选择按它旋转,也可以忽略。Canvas 只认解码后的像素,所以正确做法是在解码阶段统一方向,后面所有绘制都按“已经摆正”的坐标计算。

几何计算则要尽量离开 Canvas:裁切框、拼版尺寸、宫格落位都写成纯函数,输入数字,输出数字。这样不用打开浏览器就能断言,也不会因为预览尺寸变化导致导出偏移。

现象:预览是正的,导出是横的

现象常见原因
手机竖拍照片在页面里横过来解码时没应用 EXIF Orientation
只有部分照片方向不对不同相机的 EXIF 写法不同,或回退路径行为不一致
裁切框和导出区域对不上裁切坐标用了预览坐标,没有换算回原图坐标
拼接后图片高低不齐每张图独立缩放,没有统一基准
宫格切图边缘被裁掉cover 的负偏移没有参与切图坐标

“预览正常”不代表“像素正常”。<img> 渲染时可能已经按 EXIF 转了,但 Canvas 拿到的仍是原始像素。只对比预览,很容易把方向问题误判成 CSS 问题。

EXIF 方向:在解码阶段一次解决

JPEG 的 EXIF 里有一个 Orientation 字段,常见取值:

值含义
1正常
3旋转 180°
6顺时针旋转 90°
8逆时针旋转 90°
2 / 4 / 5 / 7带镜像的变体

手机竖拍通常写 6 或 8。像素本身还是横向存储,查看器按 Orientation 旋转后显示。Canvas 的 drawImage 不读 EXIF,所以直接把 Image 画进去,得到的还是横向像素。

门户统一用 createImageBitmap 解码,并显式声明按图片方向矫正:

async function decodeImageLocal(src: string) {
  if (typeof createImageBitmap === 'function') {
    try {
      const blob = await (await fetch(src)).blob()
      const bitmap = await createImageBitmap(blob, {
        imageOrientation: 'from-image'
      })
      return { source: bitmap, width: bitmap.width, height: bitmap.height }
    } catch {
      // 回退到 HTMLImageElement
    }
  }

  return new Promise<{ source: CanvasImageSource; width: number; height: number }>(
    (resolve, reject) => {
      const image = new Image()
      image.onload = () => resolve({
        source: image,
        width: image.naturalWidth,
        height: image.naturalHeight
      })
      image.onerror = () => reject(new Error('图片加载失败'))
      image.src = src
    }
  )
}

imageOrientation: 'from-image' 让解码结果直接按 EXIF 摆正,返回的 width 和 height 也已经是摆正后的尺寸。之后裁切、拼接、宫格都基于这套尺寸,不需要再猜方向。

回退到 HTMLImageElement 时,方向是否被应用取决于浏览器的 image-orientation 行为。门户没有手写 EXIF 解析器,所以这条回退路径要在目标浏览器上实测,不能假设和 createImageBitmap 完全一致。

裁切:坐标只存原图坐标

裁切框在页面上会随容器缩放,但保存时必须用原图坐标。显示时乘以缩放比,导出时直接按原图坐标取像素。反过来的做法——把预览坐标存下来再换算——会在窗口尺寸变化后产生累积误差。

拖动四角时,门户用一个纯函数处理边界和比例:

export function resizeCropRect(
  start: CropRect,
  handle: 'move' | 'nw' | 'ne' | 'sw' | 'se',
  dx: number,
  dy: number,
  bounds: { width: number; height: number },
  ratio?: number
): CropRect {
  if (handle === 'move') {
    return {
      x: clamp(start.x + dx, 0, bounds.width - start.width),
      y: clamp(start.y + dy, 0, bounds.height - start.height),
      width: start.width,
      height: start.height
    }
  }

  const west = handle.includes('w')
  const north = handle.includes('n')
  const leftAnchor = start.x
  const rightAnchor = start.x + start.width
  const topAnchor = start.y
  const bottomAnchor = start.y + start.height

  if (!ratio) {
    const x = west ? clamp(start.x + dx, 0, rightAnchor - MIN_CROP) : leftAnchor
    const right = west
      ? rightAnchor
      : clamp(rightAnchor + dx, leftAnchor + MIN_CROP, bounds.width)
    const y = north ? clamp(start.y + dy, 0, bottomAnchor - MIN_CROP) : topAnchor
    const bottom = north
      ? bottomAnchor
      : clamp(bottomAnchor + dy, topAnchor + MIN_CROP, bounds.height)
    return { x, y, width: right - x, height: bottom - y }
  }

  // 比例模式:宽驱动,超出边界就整体收缩
  let width = Math.round(west ? rightAnchor - (start.x + dx) : rightAnchor + dx - leftAnchor)
  let height = Math.round(width / ratio)
  // ...夹进 maxWidth / maxHeight,并保证不小于 MIN_CROP
  return {
    x: west ? rightAnchor - width : leftAnchor,
    y: north ? bottomAnchor - height : topAnchor,
    width,
    height
  }
}

三个关键点:

  1. 拖动左边或上边时,锚点是对边,返回的 x / y 要重新算,不能直接用 start.x + dx。
  2. 最小边长 MIN_CROP = 8 是原图像素,不是屏幕像素。高分屏上看起来还很小,实际已经接近边界。
  3. 比例模式以宽为基准推高,再统一夹进画布,避免宽高分别夹紧后比例失真。

函数返回的是新对象,输入不变。这样测试可以直接断言:

输入操作期望
{x:10,y:10,width:100,height:100},边界 200×200se 拖动 dx=50, dy=20{x:10,y:10,width:150,height:120}
同上nw 拖动 dx=-20, dy=-20左上角跟手,宽高同时增加
同上,比例 1se 向右拖到超出边界宽高保持 1:1,并夹在 200 内

拼接:先统一基准,再算落位

多张图拼接最容易出现“每张都按自己高度缩放”,结果接缝错位。门户的 calcStitchLayout 在横向拼接时取所有图片的最小高度作为基准,把每张图按比例缩到同一高度;只缩不放,避免小图被拉糊。

export function calcStitchLayout(boxes, options = {}) {
  const horizontal = options.direction !== 'vertical'
  const gap = Math.max(0, Math.round(options.gap ?? 0))
  let sizes = boxes.map(box => ({ ...box }))

  if (options.fit !== 'original' && sizes.length > 1) {
    if (horizontal) {
      const base = Math.min(...sizes.map(box => box.height))
      sizes = sizes.map(box => ({
        width: Math.round((box.width * base) / box.height),
        height: base
      }))
    } else {
      const base = Math.min(...sizes.map(box => box.width))
      sizes = sizes.map(box => ({
        width: base,
        height: Math.round((box.height * base) / box.width)
      }))
    }
  }

  const main = sizes.reduce(
    (sum, box) => sum + (horizontal ? box.width : box.height),
    gap * (sizes.length - 1)
  )
  // ...计算交叉轴最大值、画布上限和每张图的 offset
}

两张图 100×50 和 100×100 横向拼接,间距 10:基准高度是 50,第二张缩成 50×50,画布宽 100 + 50 + 10 = 160,高 50。这个结果不需要 Canvas 就能验证。

如果拼版超过边长上限 8192,整体等比缩小,间距也一起缩,保持观感一致。分开缩图片、不缩间距,接缝会越拼越宽。

宫格:cover 的负偏移要参与切图

宫格切图先算整图在正方形底图上的落位,再按格裁切。cover 取最大缩放铺满,溢出部分被裁,偏移是负数;contain 取最小缩放完整显示,偏移是正数,四周留白。

export function calcGridLayout(sourceWidth, sourceHeight, tileSize, grid, fit) {
  const total = tileSize * grid
  const scale = fit === 'contain'
    ? Math.min(total / sourceWidth, total / sourceHeight)
    : Math.max(total / sourceWidth, total / sourceHeight)

  const drawWidth = Math.round(sourceWidth * scale)
  const drawHeight = Math.round(sourceHeight * scale)

  return {
    total,
    scale,
    drawWidth,
    drawHeight,
    offsetX: Math.round((total - drawWidth) / 2),
    offsetY: Math.round((total - drawHeight) / 2)
  }
}

以 1000×500 原图、单格 300、3 格、cover 为例:

项值
底图边长900
缩放比1.8
绘制尺寸1800×900
水平偏移-450
垂直偏移0

负偏移表示左右各裁掉 450 像素。切第 0 列时,源坐标不是 0,而是从底图的 0 开始取,因为整图已经先画到底图上;底图坐标和原图坐标不要混用。

验证:先验函数,再验像素

检查项输入期望
裁切边界100×100 框在 200×200 画布上向右下拖 50/20150×120,不越界
横向拼接100×50 与 100×100,间距 10画布 160×50
宫格 cover1000×500,300×3底图 900,绘制 1800×900,偏移 -450
EXIF 竖拍带 Orientation=6 的 JPEG解码后宽高互换,人物朝上
导出同一裁切框在预览缩放前后输出像素一致

前四项可以直接在 Node 里断言,最后一项要在浏览器里改窗口尺寸再导出对比。把几何计算和绘制分开,测试才能覆盖边界,而不是靠肉眼拖几下。

边界与坑

createImageBitmap 不是所有环境都支持。 回退到 Image 时,方向处理依赖浏览器,必须实测。不能因为 Chrome 正常就认为所有浏览器都正常。

EXIF 方向只对带该字段的图片有意义。 PNG、WebP 通常没有 Orientation;截图也不会有。不要给所有图片都套旋转逻辑。

裁切坐标用原图,不用预览。 预览容器缩放、设备像素比变化都不应该改变保存的裁切区。

JPEG 没有透明通道。 导出 JPG 前要铺白底,否则透明区域会变黑。PNG 才保留 alpha。

拼接和宫格都有画布上限。 门户上限 8192,超过就整体缩放。不要指望浏览器无限承受大画布。

drawImage 的九参数版本容易写错。 源矩形和目标矩形顺序是 sx, sy, sw, sh, dx, dy, dw, dh,裁切偏移错一位,结果就会整体平移。

相关工具

手机照片的方向和裁切可以直接在 图片裁切工具 里验证;多张图对齐拼接用 图片拼接工具;需要切成九宫格发社交平台时用 九宫格切图工具。更多 Canvas 图片处理的记录放在 技术笔记。

FAQ

为什么手机照片在网页里会横过来?

JPEG 像素可能按传感器方向存储,靠 EXIF Orientation 告诉查看器怎么旋转。Canvas 不自动读这个字段,所以解码时要用 createImageBitmap 的 imageOrientation: 'from-image' 摆正。

预览正常,为什么导出的图还是偏?

通常是裁切框保存了预览坐标,而不是原图坐标。预览缩放后,同一个数值对应的像素变了,导出就会偏。坐标应始终按原图保存。

拼接时要不要把每张图都放大到同一高度?

不要。统一到最小高度只缩不放,避免小图被拉糊。需要更大输出时,应该从原图重新导出,而不是在拼版阶段放大。

这些几何计算为什么单独写成函数?

因为它们只依赖数字,不依赖 Canvas。写成纯函数后可以在 Node 里断言边界、比例和偏移,绘制层只负责调用,排查时能快速区分“算错了”还是“画错了”。

图片处理里最贵的不是绘图 API,而是坐标口径。方向在解码时统一,裁切用原图坐标,拼版和宫格先算后画,三类问题就不会互相伪装。

評論

登入後即可參與評論

還沒有評論,來說兩句吧

相關文章