diff --git a/docs/twodims.html b/docs/twodims.html index fe9a5df5..c417ba91 100644 --- a/docs/twodims.html +++ b/docs/twodims.html @@ -3,19 +3,6 @@ Two-Dimensional Symbols - - - - @@ -48,552 +35,95 @@ their use is depreciated. Symbols encoded using ECC 000 to ECC manufactured since the early 1990s – use ECC 200 instead. The different modes are accessed using the mode= option or by setting option_1.

-
-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Input

- 		-

Mode

- 		-

Error Correction Capacity

- 		-

Recovery Capacity

-
-

1 (default)

- 		-

ECC 200

- 		-

28 - 62%

- 		-

30 - 40%

-
-

2

- 		-

ECC 000

- 		-

0%

- 		-

0%

-
-

3

- 		-

ECC 050

- 		-

25%

- 		-

2.8%

-
-

4

- 		-

ECC 080

- 		-

33%

- 		-

5.5%

-
-

5

- 		-

ECC 100

- 		-

50%

- 		-

12.6%

-
-

6

- 		-

ECC 140

- 		-

75%

- 		-

25%

-
- -



-

+ + + + + + + + + + + + + + + + +
InputModeError Correction CapacityRecovery Capacity
1 (default)ECC 20028 - 62%30 - 40%
2ECC 0000%0%
3ECC 05025%2.8%
4ECC 08033%5.5%
5ECC 10050%12.6%
6ECC 14075%25%

The size of the generated symbol can also be adjusted using the --ver= option or by setting option_2 as shown in the table below.

-



-

- - - - - - - - - - +
-

ECC 200

- 		-

ECC 000 - 140

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Input

- 		-

Symbol Size

- 		-

Input

- 		-

Symbol Size

-
-

1

- 		-

10 x 10

- 		-

16

- 		-

64 x 64

-
-

2

- 		-

12 x 12

- 		-

17

- 		-

72 x 72

-
-

3

- 		-

14 x 14

- 		-

18

- 		-

80 x 80

-
-

4

- 		-

16 x 16

- 		-

19

- 		-

88 x 88

-
-

5

- 		-

18 x 18

- 		-

20

- 		-

96 x 96

-
-

6

- 		-

20 x 20

- 		-

21

- 		-

104 x 104

-
-

7

- 		-

22 x 22

- 		-

22

- 		-

120 x 120

-
-

8

- 		-

24 x 24

- 		-

23

- 		-

132 x 132

-
-

9

- 		-

26 x 26

- 		-

24

- 		-

144 x 144

-
-

10

- 		-

32 x 32

- 		-

25

- 		-

8 x 18

-
-

11

- 		-

36 x 36

- 		-

26

- 		-

8 x 32

-
-

12

- 		-

40 x 40

- 		-

27

- 		-

12 x 26

-
-

13

- 		-

44 x 44

- 		-

28

- 		-

12 x 36

-
-

14

- 		-

48 x 48

- 		-

29

- 		-

16 x 36

-
-

15

- 		-

52 x 52

- 		-

30

- 		-

16 x 48

-
-



-

- 		- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Input

- 		-

Symbol Size

- 		-

Input

- 		-

Symbol Size

-
-

1

- 		-

7 x 7

- 		-

12

- 		-

29 x 29

-
-

2

- 		-

9 x 9

- 		-

13

- 		-

31 x 31

-
-

3

- 		-

11 x 11

- 		-

14

- 		-

33 x 33

-
-

4

- 		-

13 x 13

- 		-

15

- 		-

35 x 35

-
-

5

- 		-

15 x 15

- 		-

16

- 		-

37 x 37

-
-

6

- 		-

17 x 17

- 		-

17

- 		-

39 x 39

-
-

7

- 		-

19 x 19

- 		-

18

- 		-

41 x 41

-
-

8

- 		-

21 x 21

- 		-

19

- 		-

43 x 43

-
-

9

- 		-

23 x 23

- 		-

20

- 		-

45 x 45

-
-

10

- 		-

25 x 25

- 		-

21

- 		-

47 x 47

-
-

11

- 		-

27 x 27

- 		-


-

- 		-


-

-
-



-

-
+ + + +
ECC 200ECC 000 - 140
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
InputSymbol SizeInputSymbol Size
110 x 101664 x 64
212 x 121772 x 72
314 x 141880 x 80
416 x 161988 x 88
518 x 182096 x 96
620 x 2021104 x 104
722 x 2222120 x 120
824 x 2423132 x 132
926 x 2624144 x 144
1032 x 32258 x 18
1136 x 36268 x 32
1240 x 402712 x 26
1344 x 442812 x 36
1448 x 482916 x 36
1552 x 523016 x 48
 + + + + + + + + + + + + + + + + + + + + + + + + + +
InputSymbol SizeInputSymbol Size
17 x 71229 x 29
29 x 91331 x 31
311 x 111433 x 33
413 x 131535 x 35
515 x 151637 x 37
617 x 171739 x 39
719 x 191841 x 41
821 x 211943 x 43
923 x 232045 x 45
1025 x 252147 x 47
1127 x 27
-



-

-




-

+

5.6.2 QR Code (ISO 18004)

Also known as Quick Response Code this symbology was developed by Denso. QR Code support in Zint relies on libqrencode (version @@ -605,100 +135,31 @@ all of the other code symbologies provided by libzint. Four levels of error correction are available using the security= option or setting option_1 as shown in the following table.

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Input

- 		-

ECC Level

- 		-

Error Correction Capacity

- 		-

Recovery Capacity

-
-

1

- 		-

L (default)

- 		-

Approx 20% of symbol

- 		-

Approx 7%

-
-

2

- 		-

M

- 		-

Approx 37% of symbol

- 		-

Approx 15%

-
-

3

- 		-

Q

- 		-

Approx 55% of symbol

- 		-

Approx 25%

-
-

4

- 		-

H

- 		-

Approx 65% of symbol

- 		-

Approx 30%

-
-
-



-

+ + + + + + + + + + + + +
InputECC LevelError Correction CapacityRecovery Capacity
1L (default)Approx 20% of symbolApprox 7%
2MApprox 37% of symbolApprox 15%
3QApprox 55% of symbolApprox 25%
4HApprox 65% of symbolApprox 30%

The size of the symbol can be set by using the vers= option or setting option_2 to the QR Code version required (1-40). The maximum capacity of a (version 40) QR Code symbol is 7089 numeric digits, 4296 alphanumeric characters or 2953 bytes of data.

-




-

+

5.6.3 Micro QR Code (ISO 18004)

A miniature version of the QR Code symbol for short messages. ECC levels can be selected as for QR Code (above). Micro QR Code support does not require libqrencode.

-




-

+

5.6.4 Maxicode (ISO 16023)

Developed by UPS the Maxicode symbology employs a grid of hexagons surrounding a 'bulls-eye' finder pattern. This symbology @@ -711,55 +172,25 @@ being sent, the secondary message usually consists of address data in a data structure. The format of the primary message is given in the following table:

-
- - - - - - - - - - - - - - - - - - - - - - - -
-

Characters

- 		-

Meaning

-
-

1-9

- 		-

Postcode data which can consist of up to 9 - digits (for mode 2) or up to 6 alphanumeric characters (for mode - 3). Remaining unused characters should be filled with the SPACE - character (ASCII 32).

-
-

10-12

- 		-

Three digit country code according to ISO 3166 - (see Appendix B).

-
-

13-15

- 		-

Three digit service code. This depends on your - parcel courier.

-
-
-



-

+ + + + + + + + + + +
CharactersMeaning
1-9 +

Postcode data which can consist of up to 9 + digits (for mode 2) or up to 6 alphanumeric characters (for mode + 3). Remaining unused characters should be filled with the SPACE + character (ASCII 32).

10-12 +

Three digit country code according to ISO 3166 + (see Appendix B).

13-15 +

Three digit service code. This depends on your + parcel courier.

The primary message can be designated at the command prompt using the --primary= switch. The secondary message uses the normal data entry method. For @@ -781,113 +212,28 @@ support extended ASCII characters and number compression. The maximum length of text which can be placed in a Maxicode symbol depends on the type of characters used in the text. Example maximum data lengths are given in the table below:

-
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
-

Mode

- 		-

Maximum Data Length for Capital Letters

- 		-

Maximum Data Length for Numeric Digits

- 		-

Number of Error Correction Codewords

-
-

2 (secondary only)

- 		-

84

- 		-

126

- 		-

50

-
-

3 (secondary only)

- 		-

84

- 		-

126

- 		-

50

-
-

4

- 		-

93

- 		-

135

- 		-

50

-
-

5

- 		-

77

- 		-

110

- 		-

66

-
-

6

- 		-

93

- 		-

135

- 		-

50

-
-
-



-

+ + + + + + + + + + + + + + +
ModeMaximum Data Length for Capital LettersMaximum Data Length for Numeric DigitsNumber of Error Correction Codewords
2 (secondary only)8412650
3 (secondary only)8412650
49313550
57711066
69313550

PLEASE NOTE that due to the unique style of the Maxicode symbol not all of the options available for other -symbologies are available. Settings for height, whitespace width, -border width and output options will be ignored. Colour options are -available as with other symbologies. PNG output is set at a -resolution of 12 pixels per millimetre (approx 300 dpi) and uses the -methods set out in Annex J of the ISO/IEC standard.

-




-

+symbologies are available. Settings for height and scale will be +ignored. Colour options are available as with other symbologies. PNG +output is set at a resolution of 12 pixels per millimetre (approx 300 +dpi) and uses the methods set out in Annex J of the ISO/IEC standard.

+

5.6.5 Aztec Code (ISO 24778)

Invented by Andrew Longacre at Welch Allyn Inc in 1995 the Aztec Code symbol is a matrix symbol with a distinctive bulls-eye @@ -901,39 +247,15 @@ symbol. Two options are available to change this behaviour:

--ver= switch followed by (or setting option_2 to) a value between 1 and 36 according to the following table:

-
- - - - - - - - - - - - - - - -
-

Value Entered

- 		-

Symbol Generated

-
-

1-4

- 		-

Compact Aztec Code with [value] layers

-
-

5-36

- 		-

“Full-Range” Aztec Code with [value – 4] - layers

-
-
-



-

+ + + + + + + + +
Value EnteredSymbol Generated
1-4Compact Aztec Code with [value] layers
5-36“Full-Range” Aztec Code with [value – 4] layers

Note that in symbols which have a specified size the amount of error correction is dependent on the length of the data input and Zint will allow error correction capacities as low as 3 @@ -942,71 +264,34 @@ codewords.

be specified by use of the --mode= switch followed by (or setting option_1 to) a value from the following table:

-
- - - - - - - - - - - - - - - - - - - - - - - -
-

Mode

- 		-

Error Correction Capacity

-
-

1

- 		-

>10% + 3 codewords

-
-

2

- 		-

>23% + 3 codewords

-
-

3

- 		-

>36% + 3 codewords

-
-

4

- 		-

>50% + 3 codewords

-
-
-



-

+ + + + + + + + + + + + +
ModeError Correction Capacity
1>10% + 3 codewords
2>23% + 3 codewords
3>36% + 3 codewords
4>50% + 3 codewords

It is not possible to select both symbol size and error correction capacity for the same symbol. If both options are selected then the error correction capacity selection will be ignored.

Aztec Code is able to encode any extended ASCII character data up to a maximum length of approximately 3823 numeric or 3067 alphabetic characters or 1914 bytes of data.

-




-

+

5.6.6 Aztec Runes

A truncated version of compact Aztec Code for encoding whole integers between 0 and 255. Includes Reed-Solomon error correction. As defined in ISO/IEC 24778 Annex A.

-




-

+
- + @@ -1017,7 +302,7 @@ correction. As defined in ISO/IEC 24778 Annex A.

Next

- + @@ -1029,7 +314,5 @@ correction. As defined in ISO/IEC 24778 Annex A.

Prev

4-State Codes
-



-

- \ No newline at end of file +