encoding (Encoding)
The encoding property sets the encoding for non-ASCII characters in the code value.
In the Properties view, this property is the Encoding property in the Bar Code category.
This property is used by the pdf-417 and qr-code bar code types.
Type: Encoding
PDF-417
Run "java CharsetInfo" for a list of character set encodings available on a particular platform. Valid example values are 'ISO-8859-15' or 'IBM437'.
Fails if:
- Value is not a valid host name
- Socket connection cannot be established
Default value: not set (the lower 8 bits of the unicode values are encoded)
QR-Code
In the QR-Code bar code, 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. |
Fails if: Value is not a valid encoding name.
Default value: UTF-8