Skip to content

Text Properties

Terry Burton edited this page Jun 16, 2025 · 17 revisions

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

Display the text encoded in this Code 39 symbol:

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

Customise the human readable text of this USPS POSTNET symbol

Data:    64501
Options: includetext textfont=Times-Roman textsize=9
Encoder: postnet

textsize

The font size of the text in points.

Note

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

Example

Customise the human readable text of this USPS POSTNET symbol

Data:    64501
Options: includetext textfont=Times-Roman textsize=9
Encoder: postnet

textgaps

The inter-character spacing of the text.

Note

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

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.

alttextsubspace, extratextsubspace

Specify a set of characters that will be replaced with spaces within the alttext and extratext values.

Note

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

alttextsplit, extratextsplit

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

Note

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

alttextlinegaps

Specify the gap between consecutive alttext lines.

Note

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

extratext, extratextfont, extratextsize, extratextgaps, extratextlinegaps

  • Extra text can be rendered above and to the left of the symbol (default) by setting extratext option to it.
  • The formatting of the text can be specified using the extratextfont, extratextsize, extratextgaps and extratextlinegaps options, which function the same as their textfont, textsize and textgaps analogues.
Clone this wiki locally