背景

之前浏览过草料二维码的网站,他的二维码美化功能很强大,可以分别自定义码眼和码点的形状和颜色,功能十分强大 💪!

碰巧之前写过一个 npm 插件 qrcode-with-logos, 用于前端生成带 logo 的二维码。

而且在 github 的 issues 里有外国友人 👨‍🦱 问我能否实现不同样式的二维码,刚好以此作为新需求,模仿草料二维码的样式和功能,开发了 qrcode-with-logos 的 v1.1.0 版本。

有了 qrcode-with-logos 这款 npm 插件,你也可以在你的网站实现不同风格组合的 qrcode 了!

原文首发在此!“山寨版”《草料二维码》 | 小皮咖 (zxpsuper.github.io)

实现功能

  • 自定义码眼码点颜色!
  • 自定义码眼码点形状!
  • 自动计算合适的 logo 大小!
  • 自由选择不同宽高比的 logo, 不再是之前限定的 1:1
  • 自动选择合适的容错率版本!
  • 相比之前版本更快的绘制速度!

Demo 及文档点击👉这里, 实现的效果如下:

image.png

实现原理

qrcode 的原理在这里就不过多介绍了,有兴趣的小伙伴可以网上搜索一下。

本插件是基于 qrcode 插件生成的记录二维码点阵的一维数组,从而得知每个点的黑白情况。

import QRCode from 'qrcode'
const QRDATA = QRCode.create(content, nodeQrCodeOptions)

const size = QRDATA.modules.size
const version = QRDATA.version
const qrcodeArray = QRDATA.modules.data

如:9*9 的点阵二维码,其数组长度 81,内容大致为:[1,1,1,1,1,1,1,0,0,0,0,0,....],其中 1 代表黑点,0 代表白点。

/**判断当前坐标是否为黑点 */
function isDark(x: number, y: number) {
  return qrcodeArray[x + y * size] === 1
}

根据此数据我们可以分别绘制码眼码点及 logo。

  • 首先绘制码点,在绘制码点之前,我们需要计算 logo 所占位置的区域,此区域内不绘制码点,(之前是 logo 直接覆盖码点,效果不好),提高绘制速度。
  • 其次绘制码眼,码眼长度固定为 7 * 7, 码眼内部固定为 3*3 的实心矩形,当然也可以自由绘制其他形状。
  • 最后在 logo 区域绘制 logo 及 logo 背景色。

逻辑比较简单,具体代码实现有兴趣的小伙伴请移步 Github!

踩坑过程

  1. 之前版本是支持自定义 logo 的大小的,但是这种过于自由导致二维码的识别效率不高,容易出现识别不出的情况,因此这次版本去掉了自定义 logo 大小的功能,根据 qrcode 的容错率计算 logo 最大能占用的面积大小,用于计算 logo 的最大大小。
  2. 在实现液化码点的时候,圆液化实现效果比较好,但是 fluid-line 实现的效果远不及原版的液化效果,有没有小伙伴有更好的思路可以在评论区或者 Github 讨论一下。

suporka
949 声望61 粉丝

小皮咖,大前端