Text Properties

Text Properties

includetext

Show human readable text for data in symbol.

Notes

• If a character in the data does not have a printable representation then it is not displayed

Example

Data:    SEE ME
Options: includetext
Encoder: code39

textfont

The PostScript font name for text.

Notes

• The font name must be the literal name of a PostScript font that is available to the system.
• This option should be used in combination with the includetext option.
• The PostScript font name for a font file can be determined with the following command from the fontconfig library:
  • fc-scan --format "%{postscriptname}\n" /usr/share/fonts/truetype/somefont.ttf

Example

Data:    FONT
Options: includetext textfont=Times-Roman
Encoder: code39

textsize

The font size of the text in points.

Note

• This option should be used in combination with the includetext option.

Example

Data:    SIZE
Options: includetext textsize=20 textyoffset=-12
Encoder: code39

textgaps

The inter-character spacing of the text.

Note

• This option should be used in combination with the textxalign option.

Example

Data:    HELLO
Options: includetext textxalign=center textgaps=10
Encoder: code128

alttext

Specify text to display other than what is provided in the data field.

Note

• This option should be used in combination with the includetext option.

Example

Data:    ABC123
Options: includetext alttext=CUSTOM-TEXT
Encoder: code128

alttextsubspace

Specify a set of characters that will be replaced with spaces within the alttext value.

Note

• This option should be used in combination with the alttext option.

Example

Data:    ABC123
Options: includetext alttext=WITH~SPACES alttextsubspace=~
Encoder: code128

alttextsplit

Specify a character by which to split alttext into separate lines.

Note

• This option should be used in combination with the alttext option.

Example

Data:    ABC123
Options: includetext alttext=LINE~ONE|LINE~TWO alttextsubspace=~ alttextsplit=|
Encoder: code128

textlinegaps

Specify the gap between consecutive text lines.

Note

• This option should be used in combination with the alttextsplit option.

Example

Data:    ABC123
Options: includetext alttext=LINE~ONE|LINE~TWO alttextsubspace=~
         alttextsplit=| textlinegaps=10
Encoder: code128

extratext

Extra text can be rendered above and to the left of the symbol (default) by setting extratext option to it.

Example

Data:    Hello
Options: version=8 includetext alttext=Hello extratext=SCAN~ME
         extratextsubspace=~ extratextfont=Helvetica-Bold
         extratextsize=8 extratextyoffset=6
Encoder: qrcode

extratextfont, extratextsize, extratextgaps

The formatting of extra text can be specified using the extratextfont, extratextsize and extratextgaps options, which function the same as their textfont, textsize and textgaps analogues.

extratextsubspace, extratextsplit, extratextlinegaps

Extra text supports the same substitution and line splitting options as alttext via extratextsubspace, extratextsplit and extratextlinegaps.