qr-code
The Quick Response (QR) bar code is a type of matrix bar code consisting of black modules (square dots) arranged in a square grid on a white background.
The QR code can be used to encode text and binary data of variable length. It is possible to encode up to 2953 code words. The code value is converted from the XML unicode value to the specified encoding.
By default, the bytes encoded in a QR code image are interpreted as characters from the
ISO-8859-1 (Latin 1) encoding. Other encodings can be specified in the encoding attribute and an
extended channel interpretations (ECI) code will be inserted if available for the
encoding. The code covers issues such as:
- Is the data compressed? If yes, how?
- Is the data part of a larger message? If yes, which part?
- Is the data encoded in a non standard way? If yes, which encoding was used?
An ECI code exists for the following encodings:
- Cp437 (0,2)
- ISO-8859-1 (ECI codes 1,3)
- ISO-8859-2 (ECI code 4)
- ISO-8859-3 (ECI code 5)
- ISO-8859-4 (ECI code 6)
- ISO-8859-5 (ECI code 7)
- ISO-8859-6 (ECI code 8)
- ISO-8859-7 (ECI code 9)
- ISO-8859-8 (ECI code 10)
- ISO-8859-9 (ECI code 11)
- ISO-8859-10 (ECI code 12)
- ISO-8859-11 (ECI code 13)
- ISO-8859-13 (ECI code 15)
- ISO-8859-14 (ECI code 16)
- ISO-8859-15 (ECI code 17)
- ISO-8859-16 (ECI code 18)
- Shift_JIS (ECI code 20)
- Cp1250, windows-1250(ECI code 21)
- Cp1251, windows-1251(ECI code 22)
- Cp1252, windows-1252(ECI code 23)
- Cp1256, windows-1256(ECI code 24)
- UnicodeBigUnmarked, UTF-16BE, UnicodeBig (ECI code 25)
- UTF-8 (ECI code 26)
- US-ASCII (ECI codes 27,170)
- Big5 (ECI code 28)
- GB18030, GB2312, EUC_CN, GBK (ECI code 29)
- EUC-KR (ECI code 30)
The attribute (property) errorCorrectionDegree is used by the qr-code bar code type:
The following encodings can be set:
| Encoding Type | Description |
|---|---|
| ISO-8859-1 | Use this setting if all characters in codeValue are from this code page. Some scanners or scanner apps interpret the non-ASCII characters non standard (e.g. as Japanese characters). In this case the scanner may have a setting to change the interpretation. If this is not the case then try using "UTF-8" encoding. Please note that for ISO-8859-1 encoding no ECI code is embedded (Use the encoding ISO-8859-15 to force an ECI inclusion.) |
| Bytes | Use this setting to set the byte values. Literal characters in codeValue are mapped to ISO-8859-1 byte representation and characters not representable in XML documents can be escaped by a backslash ('\') character followed by a 3 digit octal literal. The backslash character itself can be escaped by a sequence of two backslash characters or its octal representation \134 in ISO-8859-1. |
| UTF-8 | This is the default value and should be used unless the two other options from above are applicable. If a scanner fails to interpret the characters correctly and all character in codeValue are available from a different encoding listed by CharsetInfo, then this encoding should be tried next. |
| Any encoding listed by CharsetInfo (e.g. "Shift_JIS", "Big5" or "ISO-8859-8") | If all of the option above are not applicable this option should be used. For encodings for which a ECI code exists, the code will be embedded allowing the scanner to change the interpretation accordingly. |
| Any encoding listed by CharsetInfo prefixes with the string "RAW-" (e.g. "RAW-Shift_JIS", "RAW-Big5" or "RAW-UTF-8" | Some scanners do not recognize ECI codes and expect a specific encoding (other than ISO-8859-1). For this case, this setting should be used. |
Since Genero Report Writer 5.00, multi ECI support has been added for qr-code bar codes and an improved encoding algorithm has been added to render some bar code values smaller.
To revert to the previous versions ECI support and encoding, use the
rendering hint pxmlEncodeQRCodeBackwardCompatible=[true/false] (false).
QR code examples
