Canvas 处理手机照片:EXIF 方向与几何纯函数
手机竖着拍的照片,在系统相册里是正的,上传到网页后却被画成横的;裁切框在预览里明明贴着人脸,导出的图却偏了一截;几张不同尺寸的截图拼在一起,接缝处忽高忽低。前两个问题通常来自 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
}
}
三个关键点:
- 拖动左边或上边时,锚点是对边,返回的
x/y要重新算,不能直接用start.x + dx。 - 最小边长
MIN_CROP = 8是原图像素,不是屏幕像素。高分屏上看起来还很小,实际已经接近边界。 - 比例模式以宽为基准推高,再统一夹进画布,避免宽高分别夹紧后比例失真。
函数返回的是新对象,输入不变。这样测试可以直接断言:
| 输入 | 操作 | 期望 |
|---|---|---|
{x:10,y:10,width:100,height:100},边界 200×200 | se 拖动 dx=50, dy=20 | {x:10,y:10,width:150,height:120} |
| 同上 | nw 拖动 dx=-20, dy=-20 | 左上角跟手,宽高同时增加 |
同上,比例 1 | se 向右拖到超出边界 | 宽高保持 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/20 | 150×120,不越界 |
| 横向拼接 | 100×50 与 100×100,间距 10 | 画布 160×50 |
| 宫格 cover | 1000×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,而是坐标口径。方向在解码时统一,裁切用原图坐标,拼版和宫格先算后画,三类问题就不会互相伪装。
Comments
No comments yet — be the first to say something