Skip to main content

PDF417

PDF417 is a stacked linear barcode capable of encoding large amounts of data.

Mandatory properties

The following properties are available in addition to the common label object properties.

PropertyTypeDescription
typestringMust be PDF417.
textstringBarcode data. May contain dynamic text.
barWidthnumberX-dimension: width of the narrowest bar element.

Optional properties

The following properties are available in addition to the common label object properties.

PropertyTypeDescription
aspectnumberRow height to module width aspect ratio. If omitted, a default aspect is used.
rowHeightnumberFixed row height. Overrides aspect if set.
rowsintegerFixed number of rows. If omitted, chosen automatically.
columnsintegerFixed number of data columns. If omitted, chosen automatically.
errorCorrectionintegerError correction level (0–8). If omitted, chosen automatically based on data size.
eciintegerECI (Extended Channel Interpretation) value for the data encoding. Common values: 3 (ISO-8859-1), 26 (UTF-8).
compactbooleanIf true, use compact PDF417 (omits right-side stop pattern). Default is false.
quietZonebooleanEnable or disable the quiet zone. Default is true.
extraQuietZonenumberExtra quiet zone added on all sides.
debleednumberInk spread compensation.
barColorstringColor of the bars. May contain dynamic text. Default is black.

Example

{
"type": "PDF417",
"x": 10.0,
"y": 10.0,
"text": "Hello, world!",
"barWidth": 0.5
}