QR Code
QR code (abbreviated from Quick Response Code) is the trademark for a type of matrix barcode (or two-dimensional barcode)
江湖人称二维码。
二维码的代码生成
zxing
- pom.xml
引入需要的 jar
<dependencies>
<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>core</artifactId>
<version>3.3.0</version>
</dependency>
<dependency>
<groupId>com.google.zxing</groupId>
<artifactId>javase</artifactId>
<version>3.3.0</version>
</dependency>
</dependencies>
- main()
/**
* @since 1.6
*/
public static void main(String []args)throws Exception{
String text = "你好";
int width = 100;
int height = 100;
String format = "png";
Hashtable hints= new Hashtable();
hints.put(EncodeHintType.CHARACTER_SET, "utf-8");
BitMatrix bitMatrix = new MultiFormatWriter().encode(text, BarcodeFormat.QR_CODE, width, height,hints);
File outputFile = new File("new.png");
MatrixToImageWriter.writeToPath(bitMatrix, format, outputFile.toPath());
}
- result
jquery-qrcode
<!DOCTYPE html>
<html>
<head>
<title>basic example</title>
</head>
<body>
<script src="https://ajax.googleapis.com/ajax/libs/jquery/1.5.2/jquery.min.js"></script>
<!--<script type="text/javascript" src="../jquery.qrcode.min.js"></script>
--><script type="text/javascript" src="../src/jquery.qrcode.js"></script>
<script type="text/javascript" src="../src/qrcode.js"></script>
<p>Render in table</p>
<div id="qrcodeTable"></div>
<p>Render in canvas</p>
<div id="qrcodeCanvas"></div>
<script>
//jQuery('#qrcode').qrcode("this plugin is great");
jQuery('#qrcodeTable').qrcode({
render : "table",
text : "http://jetienne.com"
});
jQuery('#qrcodeCanvas').qrcode({
text : "http://jetienne.com"
});
</script>
</body>
</html>
生成细节和原理
基础知识
首先，我们先说一下二维码一共有40个尺寸。官方叫版本Version。Version 1是21 x 21的矩阵，Version 2是 25 x 25的矩阵，Version 3是29的尺寸，
每增加一个version，就会增加4的尺寸，公式是：(V-1)*4 + 21（V是版本号） 最高Version 40，(40-1)*4+21 = 177，所以最高是177 x 177 的正方形。
一、定位图案
Position Detection Pattern 是定位图案，用于标记二维码的矩形大小。
这三个定位图案有白边叫 Separators for Postion Detection Patterns。 之所以三个而不是四个意思就是三个就可以标识一个矩形了。（ps:两个点不就可以标识矩形了吗？）
Timing Patterns 也是用于定位的。原因是二维码有40种尺寸，尺寸过大了后需要有根标准线，不然扫描的时候可能会扫歪了。
Alignment Patterns 只有 Version 2 及以上的二维码需要这个东东，同样是为了定位用的。
二、功能性数据
-
Format Information 存在于所有的尺寸中，用于存放一些格式化数据的。
-
Version Information 在 Version 7 及以上，需要预留两块 3 x 6 的区域存放一些版本信息。
三、数据码和纠错码
除了上述的那些地方，剩下的地方存放 Data Code 数据码 和 Error Correction Code 纠错码。
数据编码
QR码支持如下的编码：
Numeric mode 数字编码，从0到9。如果需要编码的数字的个数不是3的倍数，那么，最后剩下的1或2位数会被转成4或7bits，则其它的每3位数字会被编成 10，12，14bits， 编成多长还要看二维码的尺寸。
| char | value |
|---|---|
| 0 | 0 |
| 1 | 1 |
| 2 | 2 |
| 3 | 3 |
| 4 | 4 |
| 5 | 5 |
| 6 | 6 |
| 7 | 7 |
| 8 | 8 |
| 9 | 9 |
Alphanumeric mode 字符编码。包括 0-9，大写的A到Z（没有小写），以及符号 $ % * + – . / : 包括空格。这些字符会映射成一个字符索引表。
如下所示：（其中的SP是空格，Char是字符，Value是其索引值） 编码的过程是把字符两两分组，然后转成下表的45进制，然后转成11bits的二进制，
如果最后有一个落单的，那就转成6bits的二进制。而编码模式和字符的个数需要根据不同的Version尺寸编成9, 11或13个二进制。
| char | value |
|---|---|
| A | 10 |
| B | 11 |
| C | 12 |
| … | … |
| X | 33 |
| Y | 34 |
| Z | 35 |
| SP | 36 |
| $ | 37 |
| % | 38 |
| * | 39 |
| + | 40 |
| - | 41 |
| . | 42 |
| / | 43 |
| : | 44 |
Byte mode, 字节编码，可以是0-255的ISO-8859-1字符。有些二维码的扫描器可以自动检测是否是UTF-8的编码。
Kanji mode 这是日文编码，也是双字节编码。同样，也可以用于中文编码。日文和汉字的编码会减去一个值。 如：在0X8140 to 0X9FFC中的字符会减去8140，在0XE040到0XEBBF中的字符要减去0XC140，然后把结果前两个16进制位拿出来乘以0XC0，然后再加上后两个16进制位，最后转成13bit的编码。
| Inputcharacter | “茗” | “点” |
|---|---|---|
| (Shift JIS value): | 935F | E4AA |
| 1.Subtract 8140 or C140 | 935F- 8140 = 121F | E4AA-C140= 236A |
| 2.Multiply m.s.b.by C0 | 12xC0=D80 | 23xC0=1A40 |
| 3.Add l.s.b. | D80+1F=D9F | 1A40+6A= 1AAA |
| 4.Convert to 13 bit binary | 0D9F->30110110011111 | 1AAA->1101010101010 |
Extended Channel Interpretation (ECI) mode 主要用于特殊的字符集。并不是所有的扫描器都支持这种编码。
Structured Append mode 用于混合编码，也就是说，这个二维码中包含了多种编码格式。
FNC1 mode 这种编码方式主要是给一些特殊的工业或行业用的。比如GS1条形码之类的。
简单起见，后面三种不会在本文中讨论。
Mode indicators
| Mode | Indicator |
|---|---|
| ECI | 0111 |
| Numeric | 0001 |
| Alphanumeric | 0010 |
| 8-bit Byte | 0100 |
| Kanji | 1000 |
| Structured Append | 0011 |
| FNC1 | 0101(First position) 1001(Second position) |
| Teminator (End of Message) | OOOO |
Number of bits in Character Count Indicator
| Version | Numeric Mode | Alphanumeric Mode | 8-bit Byte Mode | Kanji Mode |
|---|---|---|---|---|
| 1~9 | 10 | 9 | 8 | 8 |
| 10~26 | 12 | 11 | 16 | 10 |
| 27~40 | 14 | 13 | 16 | 12 |
一、案例1
在Version 1的尺寸下，纠错级别为H的情况下，编码： 01234567
-
把上述数字分成三组: 012 345 67
-
把他们转成二进制: 012 转成 0000001100； 345 转成 0101011001； 67 转成 1000011。
-
把这三个二进制串起来: 0000001100 0101011001 1000011
-
把数字的个数转成二进制 (version 1-H是10 bits ): 8个数字的二进制是 0000001000
-
把数字编码的标志0001和第4步的编码加到前面: 0001 0000001000 0000001100 0101011001 1000011
二、案例2
在Version 1的尺寸下，纠错级别为H的情况下，编码: AC-42
-
从字符索引表中找到 AC-42 这五个字条的索引 (10,12,41,4,2)
-
两两分组: (10,12) (41,4) (2)
-
把每一组转成11bits的二进制: (10,12) 1045+12 等于 462 转成 00111001110；(41,4) 4145+4 等于 1849 转成 11100111001；(2) 等于 2 转成 000010
-
把这些二进制连接起来：00111001110 11100111001 000010
-
把字符的个数转成二进制 (Version 1-H为9 bits ): 5个字符，5转成 000000101
-
在头上加上编码标识 0010 和第5步的个数编码: 0010 000000101 00111001110 11100111001 000010
结束符和补齐符
对 HELLO WORLD 进行编码。
一、编码
| 编码 | 字符数 | HELLO WORLD的编码 |
|---|---|---|
| 0010 | 000001011 | 01100001011 01111000110 10001011100 10110111000 10011010100 001101 |
二、结束符
| 编码 | 字符数 | HELLO WORLD的编码 | 结束符 |
|---|---|---|---|
| 0010 | 000001011 | 01100001011 01111000110 10001011100 10110111000 10011010100 001101 | 0000 |
三、8bits 重排
如果所有的编码加起来不是8个倍数我们还要在后面加上足够的0。
比如上面一共有78个bits，所以，我们还要加上2个0：
00100000 01011011 00001011 01111000 11010001 01110010 11011100 01001101 01000011 01000000
四、补齐码（Padding Bytes）
最后，如果如果还没有达到我们最大的bits数的限制，我们还要加一些补齐码（Padding Bytes）。
Padding Bytes就是重复下面的两个bytes：11101100 00010001 （这两个二进制转成十进制是236和17，我也不知道为什么，只知道Spec上是这么写的）
关于每一个Version的每一种纠错级别的最大Bits限制，可以参看QR Code Spec的第28页到32页的Table-7一表。
假设我们需要编码的是Version 1的Q纠错级，那么，其最大需要104个bits，而我们上面只有80个bits，所以，还需要补24个bits，也就是需要3个Padding Bytes，我们就添加三个，于是得到下面的编码：
00100000 01011011 00001011 01111000 11010001 01110010 11011100 01001101 01000011 01000000 11101100 00010001 11101100
上面的编码就是数据码了，叫Data Codewords，每一个8bits叫一个codeword，我们还要对这些数据码加上纠错信息。
纠错码
上面我们说到了一些纠错级别(Error Correction Code Level)，二维码中有四种级别的纠错，这就是为什么二维码有残缺还能扫出来，也就是为什么有人在二维码的中心位置加入图标。
| Level | 错误修正容量 |
|---|---|
| L水平 | 7%的字码可被修正 |
| M水平 | 15%的字码可被修正 |
| Q水平 | 25%的字码可被修正 |
| H水平 | 30%的字码可被修正 |
QR是怎么对数据码加上纠错码的？
首先，我们需要对数据码进行分组，也就是分成不同的Block，然后对各个Block进行纠错编码，对于如何分组，我们可以查看QR Code Spec的第33页到44页的Table-13到Table-22的定义表。 注意最后两列：
-
Number of Error Code Correction Blocks ：需要分多少个块。
-
Error Correction Code Per Blocks：每一个块中的code个数，所谓的code的个数，也就是有多少个8bits的字节。
举个例子：上述的Version 5 + Q纠错级：需要4个Blocks（2个Blocks为一组，共两组），头一组的两个Blocks中各15个bits数据 + 各 9个bits的纠错码（注：表中的codewords就是一个8bits的byte）
（再注：最后一例中的（c, k, r ）的公式为：c = k + 2 * r，因为后脚注解释了：纠错码的容量小于纠错码的一半）
| 组 | 块 | 数据 | 对每个块的纠错码 |
|---|---|---|---|
| 1 | 1 | 67 85 70 134 87 38 85 194 119 50 6 18 6 103 38 | 213 199 11 45 115 247 241 223 229 248 154 117 154 111 86 161 111 39 |
| 1 | 2 | 246 246 66 7 118 134 242 7 38 86 22 198 199 146 6 87 | 204 96 60 202 182 124 157 200 134 27 129 209 17 163 163 120 133 |
| 2 | 1 | 182 230 247 119 50 7 118 134 87 38 82 6 134 151 50 7 | 148 116 177 212 76 133 75 242 238 76 195 230 189 10 108 240 192 141 |
| 2 | 2 | 70 247 118 86 194 6 151 50 16 236 17 236 17 236 17 236 | 235 159 5 173 24 147 59 33 106 40 255 172 82 2 131 32 178 236 |
最终编码
一、穿插放置
如果你以为我们可以开始画图，你就错了。二维码的混乱技术还没有玩完，它还要把数据码和纠错码的各个codewords交替放在一起。如何交替呢，规则如下：
- 数据码
把每个块的第一个 codewords 先拿出来按顺度排列好，然后再取第一块的第二个，如此类推。如：上述示例中的Data Codewords如下：
| 块 1 | 67 | 85 | 70 | 134 | 87 | 38 | 85 | 194 | 119 | 50 | 6 | 18 | 6 | 103 | 38 | |
| 块 2 | 246 | 246 | 66 | 7 | 118 | 134 | 242 | 7 | 38 | 86 | 22 | 198 | 199 | 146 | 6 | |
| 块 3 | 182 | 230 | 247 | 119 | 50 | 7 | 118 | 134 | 87 | 38 | 82 | 6 | 134 | 151 | 50 | 7 |
| 块 4 | 70 | 247 | 118 | 86 | 194 | 6 | 151 | 50 | 16 | 236 | 17 | 236 | 17 | 236 |
我们先取第一列的：67， 246， 182， 70
然后再取第二列的：67， 246， 182， 70， 85，246，230 ，247
如此类推：67， 246， 182， 70， 85，246，230 ，247 ，…，38，6，50，17，7，236
- 纠错码
| 块 1 | 213 | 199 | 11 | 45 | 115 | 247 | 241 | 223 | 229 | 248 | 154 | 117 | 154 | 111 | 86 | 161 | 111 | 39 |
| 块 2 | 87 | 204 | 96 | 60 | 202 | 182 | 124 | 157 | 200 | 134 | 27 | 129 | 209 | 17 | 163 | 163 | 120 | 133 |
| 块 3 | 148 | 116 | 177 | 212 | 76 | 133 | 75 | 242 | 238 | 76 | 195 | 230 | 189 | 10 | 108 | 240 | 192 | 141 |
| 块 4 | 235 | 159 | 5 | 173 | 24 | 147 | 59 | 33 | 106 | 40 | 255 | 172 | 82 | 2 | - | - | - | - |
同理得到：
213，87，148，235，199，204，116，159，...，39，133，141，236
然后，再把这两组放在一起（纠错码放在数据码之后）得到：
67, 246, 182, 70, 85, 246, 230, 247, 70, 66, 247, 118, 134, 7, 119, 86, 87, 118, 50, 194, 38, 134, 7, 6, 85, 242, 118, 151,
194, 7, 134, 50, 119, 38, 87, 16, 50, 86, 38, 236, 6, 22, 82, 17, 18, 198, 6, 236, 6, 199, 134, 17, 103, 146, 151, 236, 38,
6, 50, 17, 7, 236, 213, 87, 148, 235, 199, 204, 116, 159, 11, 96, 177, 5, 45, 60, 212, 173, 115, 202, 76, 24, 247, 182, 133,
147, 241, 124, 75, 59, 223, 157, 242, 33, 229, 200, 238, 106, 248, 134, 76, 40, 154, 27, 195, 255, 117, 129, 230, 172, 154,
209, 189, 82, 111, 17, 10, 2, 86, 163, 108, 131, 161, 163, 240, 32, 111, 120, 192, 178, 39, 133, 141, 236
二、Remainder Bis
最后再加上 Reminder Bits，对于某些Version的QR，上面的还不够长度，还要加上Remainder Bits。
比如：上述的5Q版的二维码，还要加上7个bits，Remainder Bits加零就好了。
关于哪些Version需要多少个Remainder bit，可以参看QR Code Spec的第15页的Table-1的定义表。
绘制
绘制过于细碎，暂时略。
