QR Code

QR code (abbreviated from Quick Response Code) is the trademark for a type of matrix barcode (or two-dimensional barcode)

江湖人称二维码。

qr-code-tutorial

二维码的代码生成

java实现二维码生成的几个方法

zxing

google-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

zxing-qrcode-helloWorld

jquery-qrcode

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 的正方形。

qr-code-example

一、定位图案

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的定义表。

绘制

绘制过于细碎，暂时略。

QR Code
二维码的代码生成
- zxing
- jquery-qrcode
生成细节和原理

QR Code

二维码的代码生成

zxing

jquery-qrcode

生成细节和原理

基础知识

数据编码

结束符和补齐符

纠错码

最终编码

绘制

更多学习