ZXing 二维码倾斜校正：90° 与 45° 两级旋转让歪图也能扫

【免费下载链接】zxingZXing ("Zebra Crossing") barcode scanning library for Java, Android项目地址: https://gitcode.com/gh_mirrors/zx/zxing

手机拍歪的二维码常常解码失败。ZXing 用两级旋转校正解决这个问题：90° 整数倍的方向翻转交给rotateCounterClockwise()一次转回，手持随机倾斜交给rotateCounterClockwise45()绕中心转 45° 再裁剪。下面看这两级校正在代码里怎么落地。

横竖屏切换怎么适配，手持倾斜怎么办

先分清两种"歪"，它们对解码器的破坏方式完全不同。

横竖屏翻转：屏幕转了 90° 的整数倍，条码本身没变形，只是整幅画面方向反了——模块（Module，二维码里最小的黑白方块）依然是正方形，只是"上"变成了"右"。手持随机倾斜：手机与条码平面成任意夹角，模块被压成平行四边形，三个角的定位图案（Position Detection Pattern，扫码时定位用的回字形方块）比例失调，解码器直接找不到码。

应对手段一一对应：翻转只需把像素整体搬一次方向，45° 旋转则是靠"转回近似正方形 + 裁掉边角"逼近原始姿态。

上图来自仓库自带测试集，正是第二类的典型样本：角度不规整、边缘带透视。

90度整数倍旋转怎么实现：一次矩阵搬回方向

方向翻转的实现集中在 J2SE 端的亮度源 BufferedImageLuminanceSource.java。亮度源（LuminanceSource）是解码器读取灰度像素的抽象接口，这个文件负责把它具体化为BufferedImage。它的rotateCounterClockwise()解决"整图方向反了 90°、解码器却假设上就是上"的问题：

AffineTransform transform = new AffineTransform(0.0, -1.0, 1.0, 0.0, 0.0, sourceWidth); BufferedImage rotatedImage = new BufferedImage(sourceHeight, sourceWidth, BufferedImage.TYPE_BYTE_GRAY); Graphics2D g = rotatedImage.createGraphics(); g.drawImage(image, transform, null); g.dispose();

AffineTransform是 Java 里描述旋转与平移的标准工具，输出尺寸sourceHeight × sourceWidth与输入宽高互换，正是转 90° 的结果；方法随后用旋转后的裁剪坐标重建亮度源，只保留原本有效的区域。

45度旋转如何触发：绕中心转 45° 再裁掉边角

手持倾斜几乎不会落在 90° 整数倍上，rotateCounterClockwise45()就是给这种情况的粗校正，思路相当于把歪挂的相框掰正，再裁掉多余边角。它先求图像中心，再围绕中心做旋转：

int oldCenterX = left + width / 2; AffineTransform transform = AffineTransform.getRotateInstance(MINUS_45_IN_RADIANS, oldCenterX, oldCenterY); g.drawImage(image, transform, null);

MINUS_45_IN_RADIANS即Math.toRadians(-45.0)，负号表示逆时针。旋转后有效区域落在正方形画布中间，源码取宽高较大者的一半为halfDimension，从中心向四边量出边界并裁剪，空白边缘和背景噪点被挡在解码视野之外。

orientation 方向信息怎么传递：从传感器字段到结果 Intent

方向数据要穿过三个环节才能回到调用方手里，整条链路如下表：

这条链保证扫码 App 拿到结果时知道"图当时是朝哪个方向的"，需要还原坐标或画提示框时不必再猜。

调优清单：何时禁用自动旋转

• 固定支架场景关掉自动方向适配：KEY_DISABLE_AUTO_ORIENTATION（值"preferences_orientation"，定义于 PreferencesActivity.java）就是对应开关，机位固定时省去每帧的方向重算。
• 低性能设备优先 90° 路径：90° 旋转只做像素搬运，45° 旋转伴随重采样与裁剪；弱机已知姿态只有四种方向时，把 45° 路径留给试错阶段更省开销。
• 用负向测试用例校准识别率：AbstractNegativeBlackBoxTestCase.java 把一批"不该扫出码"的图按 0°、45°、90° 等角度旋转后反复解码，只允许极少误报；照着addTest(误报上限, 旋转角度)的写法即可验证自己的场景图。

两级旋转把"整图方向反了"和"局部角度偏了"分开处理，是 ZXing 应对倾斜扫码最直接的解法。完整接口行为可查仓库内 docs/index.html 生成的 API 文档。

【免费下载链接】zxingZXing ("Zebra Crossing") barcode scanning library for Java, Android项目地址: https://gitcode.com/gh_mirrors/zx/zxing