2022-12-13 10:45:16 +13:00
|
|
|
% ZINT(1) Version 2.12.0.9
|
2022-05-23 08:33:45 +12:00
|
|
|
%
|
2023-12-06 08:00:01 +13:00
|
|
|
% December 2023
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
# NAME
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
`zint` - encode data as a barcode image
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
# SYNOPSIS
|
|
|
|
|
|
|
|
| `zint` [`-h` | `--help`]
|
|
|
|
| `zint` [*options*]
|
|
|
|
|
|
|
|
# DESCRIPTION
|
|
|
|
|
|
|
|
zint takes input data from the command line or a file to encode in a barcode which is then output to an image file.
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
Input data is UTF-8, unless `--binary` is specified.
|
|
|
|
|
|
|
|
Human Readable Text (HRT) is displayed by default for those barcodes that support HRT, unless `--notext` is specified.
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
The output image file (specified with `-o` | `--output`) may be in one of these formats: Windows Bitmap (`BMP`),
|
2022-05-19 21:17:51 +12:00
|
|
|
Enhanced Metafile Format (`EMF`), Encapsulated PostScript (`EPS`), Graphics Interchange Format (`GIF`), ZSoft
|
|
|
|
Paintbrush (`PCX`), Portable Network Format (`PNG`), Scalable Vector Graphic (`SVG`), or Tagged Image File Format
|
|
|
|
(`TIF`).
|
|
|
|
|
|
|
|
# OPTIONS
|
|
|
|
|
|
|
|
`-h`, `--help`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
: Print usage information summarizing command line options.
|
|
|
|
|
|
|
|
`-b TYPE`, `--barcode=TYPE`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
: Set the barcode symbology that will be used to encode the data. *TYPE* is the number or name of the barcode
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
symbology. If not given, the symbology defaults to 20 (Code 128). To see what types are available, use the `-t` |
|
2022-05-23 08:33:45 +12:00
|
|
|
`--types` option. Type names are case-insensitive, and non-alphanumerics are ignored.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--addongap=INTEGER`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: For EAN/UPC symbologies, set the gap between the main data and the add-on. *INTEGER* is in integral multiples of
|
2022-05-19 21:17:51 +12:00
|
|
|
the X-dimension. The maximum gap that can be set is 12. The minimum is 7, except for UPC-A, when the minimum is 9.
|
|
|
|
|
|
|
|
`--batch`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Treat each line of an input file specified with `-i` | `--input` as a separate data set and produce a barcode
|
2022-05-19 21:17:51 +12:00
|
|
|
image for each one. The barcode images are outputted by default to numbered filenames starting with "00001.png",
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
"00002.png" etc., which can be changed by using the `-o` | `--output` option.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--bg=COLOUR`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
- `zint_symbol->fgcolour` & `bgcolour` buffer lengths extended 10
-> 16 to allow for "C,M,Y,K" comma-separated decimal percentage
strings
- API/CLI/GUI: allow foreground/background colours to be specified
as comma-separated decimal "C,M,Y,K" strings where "C", "M" etc.
are percentages (0-100) (ticket #281, 3rd point)
- output.c: new funcs `out_colour_get_rgb()` & `out_colour_get_cmyk()`
and use in bmp/emf/gif etc.
- PCX: add alpha support
- GUI: fix fg/gbcolor icon background not being reset on zap
- GUI: Rearrange some Appearance tab inputs (Border Type <-> Width,
Show Text <-> Font, Text/Font <-> Printing Scale/Size) to flow
more naturally (hopefully)
- GUI: save button "Save As..." -> "Save..." and add icon
- CLI: add --bgcolor/colour & --fgcolor/colour synonyms
2023-01-30 08:51:11 +13:00
|
|
|
: Specify a background (paper) colour where *COLOUR* is in hexadecimal `RRGGBB` or `RRGGBBAA` format or in decimal
|
|
|
|
`C,M,Y,K` percentages format.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--binary`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
: Treat input data as raw 8-bit binary data instead of the default UTF-8. Automatic code page translation to an ECI
|
2022-05-20 20:42:19 +12:00
|
|
|
page is disabled, and no validation of the data's character encoding takes place.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--bind`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Add horizontal boundary bars (also known as bearer bars) to the symbol. The width of the boundary bars is
|
2022-05-23 08:33:45 +12:00
|
|
|
specified by the `--border` option. `--bind` can also be used to add row separator bars to symbols stacked with
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
multiple `-d` | `--data` inputs, in which case the width of the separator bars is specified with the `--separator`
|
|
|
|
option.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
2022-11-11 11:13:41 +13:00
|
|
|
`--bindtop`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
2022-11-11 11:13:41 +13:00
|
|
|
: Add a horizontal boundary bar to the top of the symbol. The width of the boundary bar is specified by the
|
|
|
|
`--border` option.
|
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
`--bold`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Use bold text for the Human Readable Text (HRT).
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--border=INTEGER`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
2022-11-11 11:13:41 +13:00
|
|
|
: Set the width of boundary bars (`--bind` or `--bindtop`) or box borders (`--box`), where *INTEGER* is in integral
|
|
|
|
multiples of the X-dimension. The default is zero.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--box`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Add a box around the symbol. The width of the borders is specified by the `--border` option.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--cmyk`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
: Use the CMYK colour space when outputting to Encapsulated PostScript (EPS) or TIF files.
|
|
|
|
|
|
|
|
`--cols=INTEGER`
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Set the number of data columns in the symbol to *INTEGER*. Affects Codablock-F, DotCode, GS1 DataBar Expanded
|
|
|
|
Stacked (DBAR_EXPSTK), MicroPDF417 and PDF417 symbols.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--compliantheight`
|
|
|
|
|
|
|
|
: Warn if the height specified by the `--height` option is not compliant with the barcode's specification, or if
|
|
|
|
`--height` is not given, default to the height specified by the specification (if any).
|
|
|
|
|
|
|
|
`-d`, `--data=DATA`
|
|
|
|
|
|
|
|
: Specify the input *DATA* to encode. The `--esc` option may be used to enter non-printing characters using escape
|
2022-05-20 20:42:19 +12:00
|
|
|
sequences. The *DATA* should be UTF-8, unless the `--binary` option is given, in which case it can be anything.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--direct`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Send output to stdout, which in most cases should be re-directed to a pipe or a file. Use `--filetype` to specify
|
|
|
|
output format.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
2023-10-31 09:28:00 +13:00
|
|
|
`--dmiso144`
|
|
|
|
|
|
|
|
: For Data Matrix symbols, use the standard ISO/IEC codeword placement for 144 x 144 (`--vers=24`) sized symbols,
|
|
|
|
instead of the default "de facto" placement (which rotates the placement of ECC codewords).
|
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
`--dmre`
|
|
|
|
|
2023-10-31 09:28:00 +13:00
|
|
|
: For Data Matrix symbols, allow Data Matrix Rectangular Extended (DMRE) sizes when considering automatic sizes. See
|
|
|
|
also `--square`.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--dotsize=NUMBER`
|
|
|
|
|
2023-07-24 23:56:40 +12:00
|
|
|
: Set the radius of the dots in dotty mode (`--dotty`). *NUMBER* is in X-dimensions, and may be floating-point. The
|
|
|
|
default is 0.8.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--dotty`
|
|
|
|
|
|
|
|
: Use dots instead of squares for matrix symbols. DotCode is always in dotty mode.
|
|
|
|
|
|
|
|
`--dump`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Dump a hexadecimal representation of the symbol's encodation to stdout. The same representation may be outputted
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
to a file by using a `.txt` extension with `-o` | `--output` or by specifying `--filetype=txt`.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`-e`, `--ecinos`
|
|
|
|
|
|
|
|
: Display the table of ECIs (Extended Channel Interpretations).
|
|
|
|
|
|
|
|
`--eci=INTEGER`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Set the ECI code for the input data to *INTEGER*. See `-e` | `--ecinos` for a list of the ECIs available. ECIs are
|
|
|
|
supported by Aztec Code, Code One, Data Matrix, DotCode, Grid Matrix, Han Xin Code, MaxiCode, MicroPDF417, PDF417,
|
2022-08-19 09:25:09 +12:00
|
|
|
QR Code, rMQR and Ultracode.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
2023-06-12 12:25:55 +12:00
|
|
|
`--embedfont`
|
|
|
|
|
2023-06-14 05:12:20 +12:00
|
|
|
: For vector output, embed the font in the file for portability. Currently only available for SVG output.
|
2023-06-12 12:25:55 +12:00
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
`--esc`
|
|
|
|
|
|
|
|
: Process escape characters in the input data. The escape sequences are:
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
\0 (0x00) NUL Null character
|
|
|
|
\E (0x04) EOT End of Transmission
|
|
|
|
\a (0x07) BEL Bell
|
|
|
|
\b (0x08) BS Backspace
|
|
|
|
\t (0x09) HT Horizontal Tab
|
|
|
|
\n (0x0A) LF Line Feed
|
|
|
|
\v (0x0B) VT Vertical Tab
|
|
|
|
\f (0x0C) FF Form Feed
|
|
|
|
\r (0x0D) CR Carriage Return
|
|
|
|
\e (0x1B) ESC Escape
|
|
|
|
\G (0x1D) GS Group Separator
|
|
|
|
\R (0x1E) RS Record Separator
|
|
|
|
\\ (0x5C) \ Backslash
|
|
|
|
\dNNN (NNN) Any 8-bit character where NNN is
|
|
|
|
decimal (000-255)
|
2022-12-20 05:28:15 +13:00
|
|
|
\oNNN (0oNNN) Any 8-bit character where NNN is
|
|
|
|
octal (000-377)
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
\xNN (0xNN) Any 8-bit character where NN is
|
2022-12-20 05:28:15 +13:00
|
|
|
hexadecimal (00-FF)
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
\uNNNN (U+NNNN) Any 16-bit Unicode BMP character
|
|
|
|
where NNNN is hexadecimal
|
2022-06-25 01:38:48 +12:00
|
|
|
\UNNNNNN (U+NNNNNN) Any 21-bit Unicode character
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
where NNNNNN is hexadecimal
|
2022-05-19 21:17:51 +12:00
|
|
|
|
2023-01-15 13:22:43 +13:00
|
|
|
`--extraesc`
|
|
|
|
|
|
|
|
: Process the special escape sequences `\^A`, `\^B` and `\^C` that allow manual switching of Code Sets (Code 128
|
|
|
|
only). The sequence `\^^` can be used to encode data that contains special escape sequences.
|
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
`--fast`
|
|
|
|
|
2022-12-05 23:11:36 +13:00
|
|
|
: Use faster if less optimal encodation or other shortcuts (affects Data Matrix, MicroPDF417, PDF417, QRCODE & UPNQR
|
|
|
|
only).
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--fg=COLOUR`
|
|
|
|
|
- `zint_symbol->fgcolour` & `bgcolour` buffer lengths extended 10
-> 16 to allow for "C,M,Y,K" comma-separated decimal percentage
strings
- API/CLI/GUI: allow foreground/background colours to be specified
as comma-separated decimal "C,M,Y,K" strings where "C", "M" etc.
are percentages (0-100) (ticket #281, 3rd point)
- output.c: new funcs `out_colour_get_rgb()` & `out_colour_get_cmyk()`
and use in bmp/emf/gif etc.
- PCX: add alpha support
- GUI: fix fg/gbcolor icon background not being reset on zap
- GUI: Rearrange some Appearance tab inputs (Border Type <-> Width,
Show Text <-> Font, Text/Font <-> Printing Scale/Size) to flow
more naturally (hopefully)
- GUI: save button "Save As..." -> "Save..." and add icon
- CLI: add --bgcolor/colour & --fgcolor/colour synonyms
2023-01-30 08:51:11 +13:00
|
|
|
: Specify a foreground (ink) colour where *COLOUR* is in hexadecimal `RRGGBB` or `RRGGBBAA` format or in decimal
|
|
|
|
`C,M,Y,K` percentages format.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--filetype=TYPE`
|
|
|
|
|
|
|
|
: Set the output file type to *TYPE*, which is one of `BMP`, `EMF`, `EPS`, `GIF`, `PCX`, `PNG`, `SVG`, `TIF`, `TXT`.
|
|
|
|
|
|
|
|
`--fullmultibyte`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Use the multibyte modes of Grid Matrix, Han Xin and QR Code for non-ASCII data.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--gs1`
|
|
|
|
|
|
|
|
: Treat input as GS1 compatible data. Application Identifiers (AIs) should be placed in square brackets `"[]"` (but
|
|
|
|
see `--gs1parens`).
|
|
|
|
|
|
|
|
`--gs1nocheck`
|
|
|
|
|
|
|
|
: Do not check the validity of GS1 data.
|
|
|
|
|
|
|
|
`--gs1parens`
|
|
|
|
|
|
|
|
: Process parentheses `"()"` as GS1 AI delimiters, rather than square brackets `"[]"`. The input data must not
|
2022-05-23 08:33:45 +12:00
|
|
|
otherwise contain parentheses.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--gssep`
|
|
|
|
|
|
|
|
: For Data Matrix in GS1 mode, use `GS` (0x1D) as the GS1 data separator instead of `FNC1`.
|
|
|
|
|
2022-05-25 08:54:44 +12:00
|
|
|
`--guarddescent=NUMBER`
|
2022-05-19 21:17:51 +12:00
|
|
|
|
2023-07-24 23:56:40 +12:00
|
|
|
: For EAN/UPC symbols, set the height the guard bars descend below the main bars, where *NUMBER* is in X-dimensions.
|
|
|
|
*NUMBER* may be floating-point.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
2023-06-12 12:25:55 +12:00
|
|
|
`--guardwhitespace`
|
|
|
|
|
|
|
|
: For EAN/UPC symbols, add quiet zone indicators `"<"` and/or `">"` to HRT where applicable.
|
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
`--height=NUMBER`
|
|
|
|
|
2023-07-24 23:56:40 +12:00
|
|
|
: Set the height of the symbol in X-dimensions. *NUMBER* may be floating-point.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--heightperrow`
|
|
|
|
|
2022-10-14 01:33:59 +13:00
|
|
|
: Treat height as per-row. Affects Codablock-F, Code 16K, Code 49, GS1 DataBar Expanded Stacked (DBAR_EXPSTK),
|
2022-05-19 21:17:51 +12:00
|
|
|
MicroPDF417 and PDF417.
|
|
|
|
|
|
|
|
`-i`, `--input=FILE`
|
|
|
|
|
2023-02-11 03:44:10 +13:00
|
|
|
: Read the input data from *FILE*. Specify a single hyphen (`-`) for *FILE* to read from stdin.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--init`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Create a Reader Initialisation (Programming) symbol.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--mask=INTEGER`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Set the masking pattern to use for DotCode, Han Xin or QR Code to *INTEGER*, overriding the automatic selection.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--mirror`
|
|
|
|
|
2022-12-06 01:55:28 +13:00
|
|
|
: Use the batch data to determine the filename in batch mode (`--batch`). The `-o` | `--output` option can be used
|
|
|
|
to specify an output directory (any filename will be ignored).
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--mode=INTEGER`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: For MaxiCode and GS1 Composite symbols, set the encoding mode to *INTEGER*.
|
2022-05-23 08:33:45 +12:00
|
|
|
|
|
|
|
For MaxiCode (SCM is Structured Carrier Message, with 3 fields: postcode, 3-digit ISO 3166-1 country code, 3-digit
|
|
|
|
service code):
|
|
|
|
|
|
|
|
2 SCM with 9-digit numeric postcode
|
|
|
|
3 SCM with 6-character alphanumeric postcode
|
|
|
|
4 Enhanced ECC for the primary part of the message
|
|
|
|
5 Enhanced ECC for all of the message
|
|
|
|
6 Reader Initialisation (Programming)
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
For GS1 Composite symbols (names end in `_CC`, i.e. EANX_CC, GS1_128_CC, DBAR_OMN_CC etc.):
|
2022-05-23 08:33:45 +12:00
|
|
|
|
|
|
|
1 CC-A
|
|
|
|
2 CC-B
|
|
|
|
3 CC-C (GS1_128_CC only)
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--nobackground`
|
|
|
|
|
|
|
|
: Remove the background colour (EMF, EPS, GIF, PNG, SVG and TIF only).
|
|
|
|
|
|
|
|
`--noquietzones`
|
|
|
|
|
|
|
|
: Disable any quiet zones for symbols that define them by default.
|
|
|
|
|
|
|
|
`--notext`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Remove the Human Readable Text (HRT).
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`-o`, `--output=FILE`
|
|
|
|
|
|
|
|
: Send the output to *FILE*. When not in batch mode, the default is "out.png" (or "out.gif" if zint built without
|
|
|
|
PNG support). When in batch mode (`--batch`), special characters can be used to format the output filenames:
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
~ Insert a number or 0
|
|
|
|
# Insert a number or space
|
2022-07-09 06:16:02 +12:00
|
|
|
@ Insert a number or * (+ on Windows)
|
2022-05-23 08:33:45 +12:00
|
|
|
Any other Insert literally
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--primary=STRING`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: For MaxiCode, set the content of the primary message. For GS1 Composite symbols, set the content of the linear
|
|
|
|
symbol.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--quietzones`
|
|
|
|
|
2022-06-17 03:47:34 +12:00
|
|
|
: Add compliant quiet zones for symbols that specify them. This is in addition to any whitespace specified by `-w` |
|
2022-05-23 08:33:45 +12:00
|
|
|
`--whitesp` or `--vwhitesp`.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`-r`, `--reverse`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Reverse the foreground and background colours (white on black). Known as "reflectance reversal" or "reversed
|
|
|
|
reflectance".
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--rotate=INTEGER`
|
|
|
|
|
|
|
|
: Rotate the symbol by *INTEGER* degrees, where *INTEGER* can be 0, 90, 270 or 360.
|
|
|
|
|
|
|
|
`--rows=INTEGER`
|
|
|
|
|
2022-05-20 20:42:19 +12:00
|
|
|
: Set the number of rows for Codablock-F or PDF417 to *INTEGER*. It will also set the minimum number of rows for
|
2022-10-14 01:33:59 +13:00
|
|
|
Code 16K or Code 49, and the maximum number of rows for GS1 DataBar Expanded Stacked (DBAR_EXPSTK).
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--scale=NUMBER`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Adjust the size of the X-dimension. *NUMBER* may be floating-point, and is multiplied by 2 (except for MaxiCode)
|
|
|
|
before being applied. The default scale is 1.
|
|
|
|
|
- API: add new zint_symbol `dpmm` field for output resolution (BMP/
EMF/PCX/PNG/TIF only, i.e. excluding EPS, GIF & SVG)
- Add support for specifying scale by X-dimension and resolution
with new option `--scalexdimdp` for CLI/Tcl & new API function
`ZBarcode_Scale_From_XdimDp()` (+ `ZBarcode_XdimDp_From_Scale()`
& `ZBarcode_Default_Xdim()`) and new GUI popup; manual: document
- BMP/EMF/PCX/PNG/TIF: use new `dpmm` resolution field (for EMF
following Inkscape)
- backend_qt: add `dpmm()`, `vectorWidth()`, `vectorHeight()`,
`noPng()`, `getVersion()`, `takesGS1AIData()`, & `XdimDp` stuff
incl. new `QZintXdimDp` struct for passing around scale vars &
use in `getAsCLI()`; add comments
- Raise `scale` limit to 200 (from 100) to allow for large dpmm
- output: create directories & subdirectories as necessary for
output path using new function `out_fopen()` and use in BMP/EMF/
EPS/GIF/PCX/PNG/SVG/TIF
- DPLEIT/DPIDENT: format HRT according to (incomplete)
documentation, and set default height to 72X (from 50X)
- CODE128B renamed to CODE128AB as can use subsets A and/or B
- CODABAR: fix minimum height calc
- EMF: fix indexing of handles (zero-based not 1-based)
- GUI: fix symbology zap (previous technique of clearing and
re-loading settings without doing a sync no longer works);
fix UPCEAN guard descent enable
- MAILMARK: better error message if input < 14 characters
- GUI: add "Default" button for DAFT tracker ratio & enable/disable
various default buttons; use new `takesGS1AIData()` to
enable/disable GS1-specific checkboxes
- CLI: use new `validate_float()` to parse float options (7
significant digits allowed only, no scientific notation)
- DATAMATRIX/GRIDMATRIX/PDF417/QR/ULTRA: micro-optimize structapp
ID parse
- library/CLI: fiddle with static asserts (make CHAR_BIT sensitive,
supposedly)
- win32/README: update building libpng (assembly removed)
- README.linux: document incompatibility of Qt6 >= 6.3
- manual: expand Barcode Studio waffle
- test suite: change range separator to hyphen and allow multiple
excludes
2022-12-03 10:39:01 +13:00
|
|
|
For MaxiCode, the scale is multiplied by 10 for raster output, by 40 for EMF output, and by 2 otherwise.
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
|
|
|
|
Increments of 0.5 (half-integers) are recommended for non-MaxiCode raster output (BMP, GIF, PCX, PNG and TIF).
|
2022-05-19 21:17:51 +12:00
|
|
|
|
- API: add new zint_symbol `dpmm` field for output resolution (BMP/
EMF/PCX/PNG/TIF only, i.e. excluding EPS, GIF & SVG)
- Add support for specifying scale by X-dimension and resolution
with new option `--scalexdimdp` for CLI/Tcl & new API function
`ZBarcode_Scale_From_XdimDp()` (+ `ZBarcode_XdimDp_From_Scale()`
& `ZBarcode_Default_Xdim()`) and new GUI popup; manual: document
- BMP/EMF/PCX/PNG/TIF: use new `dpmm` resolution field (for EMF
following Inkscape)
- backend_qt: add `dpmm()`, `vectorWidth()`, `vectorHeight()`,
`noPng()`, `getVersion()`, `takesGS1AIData()`, & `XdimDp` stuff
incl. new `QZintXdimDp` struct for passing around scale vars &
use in `getAsCLI()`; add comments
- Raise `scale` limit to 200 (from 100) to allow for large dpmm
- output: create directories & subdirectories as necessary for
output path using new function `out_fopen()` and use in BMP/EMF/
EPS/GIF/PCX/PNG/SVG/TIF
- DPLEIT/DPIDENT: format HRT according to (incomplete)
documentation, and set default height to 72X (from 50X)
- CODE128B renamed to CODE128AB as can use subsets A and/or B
- CODABAR: fix minimum height calc
- EMF: fix indexing of handles (zero-based not 1-based)
- GUI: fix symbology zap (previous technique of clearing and
re-loading settings without doing a sync no longer works);
fix UPCEAN guard descent enable
- MAILMARK: better error message if input < 14 characters
- GUI: add "Default" button for DAFT tracker ratio & enable/disable
various default buttons; use new `takesGS1AIData()` to
enable/disable GS1-specific checkboxes
- CLI: use new `validate_float()` to parse float options (7
significant digits allowed only, no scientific notation)
- DATAMATRIX/GRIDMATRIX/PDF417/QR/ULTRA: micro-optimize structapp
ID parse
- library/CLI: fiddle with static asserts (make CHAR_BIT sensitive,
supposedly)
- win32/README: update building libpng (assembly removed)
- README.linux: document incompatibility of Qt6 >= 6.3
- manual: expand Barcode Studio waffle
- test suite: change range separator to hyphen and allow multiple
excludes
2022-12-03 10:39:01 +13:00
|
|
|
See also `--scalexdimdp` below.
|
|
|
|
|
|
|
|
`--scalexdimdp=X[,R]`
|
|
|
|
|
|
|
|
: Scale the image according to X-dimension *X* and resolution *R*, where *X* is in mm and *R* is in dpmm (dots per
|
2023-11-20 08:39:54 +13:00
|
|
|
mm). *X* and *R* may be floating-point. *R* is optional and defaults to 12 dpmm (approximately 300 dpi). *X* may
|
|
|
|
be zero in which case a symbology-specific default is used.
|
- API: add new zint_symbol `dpmm` field for output resolution (BMP/
EMF/PCX/PNG/TIF only, i.e. excluding EPS, GIF & SVG)
- Add support for specifying scale by X-dimension and resolution
with new option `--scalexdimdp` for CLI/Tcl & new API function
`ZBarcode_Scale_From_XdimDp()` (+ `ZBarcode_XdimDp_From_Scale()`
& `ZBarcode_Default_Xdim()`) and new GUI popup; manual: document
- BMP/EMF/PCX/PNG/TIF: use new `dpmm` resolution field (for EMF
following Inkscape)
- backend_qt: add `dpmm()`, `vectorWidth()`, `vectorHeight()`,
`noPng()`, `getVersion()`, `takesGS1AIData()`, & `XdimDp` stuff
incl. new `QZintXdimDp` struct for passing around scale vars &
use in `getAsCLI()`; add comments
- Raise `scale` limit to 200 (from 100) to allow for large dpmm
- output: create directories & subdirectories as necessary for
output path using new function `out_fopen()` and use in BMP/EMF/
EPS/GIF/PCX/PNG/SVG/TIF
- DPLEIT/DPIDENT: format HRT according to (incomplete)
documentation, and set default height to 72X (from 50X)
- CODE128B renamed to CODE128AB as can use subsets A and/or B
- CODABAR: fix minimum height calc
- EMF: fix indexing of handles (zero-based not 1-based)
- GUI: fix symbology zap (previous technique of clearing and
re-loading settings without doing a sync no longer works);
fix UPCEAN guard descent enable
- MAILMARK: better error message if input < 14 characters
- GUI: add "Default" button for DAFT tracker ratio & enable/disable
various default buttons; use new `takesGS1AIData()` to
enable/disable GS1-specific checkboxes
- CLI: use new `validate_float()` to parse float options (7
significant digits allowed only, no scientific notation)
- DATAMATRIX/GRIDMATRIX/PDF417/QR/ULTRA: micro-optimize structapp
ID parse
- library/CLI: fiddle with static asserts (make CHAR_BIT sensitive,
supposedly)
- win32/README: update building libpng (assembly removed)
- README.linux: document incompatibility of Qt6 >= 6.3
- manual: expand Barcode Studio waffle
- test suite: change range separator to hyphen and allow multiple
excludes
2022-12-03 10:39:01 +13:00
|
|
|
|
|
|
|
The scaling takes into account the output filetype, and deals with all the details mentioned above. Units may be
|
|
|
|
specified for *X* by appending "in" (inch) or "mm", and for *R* by appending "dpi" (dots per inch) or "dpmm" -
|
|
|
|
e.g. `--scalexdimdp=0.013in,300dpi`.
|
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
`--scmvv=INTEGER`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: For MaxiCode, prefix the Structured Carrier Message (SCM) with `"[)>\R01\Gvv"`, where `vv` is a 2-digit *INTEGER*.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--secure=INTEGER`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Set the error correction level (ECC) to *INTEGER*. The meaning is specific to the following matrix symbols (all
|
|
|
|
except PDF417 are approximate):
|
2022-05-23 08:33:45 +12:00
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
Aztec Code 1 to 4 (10%, 23%, 36%, 50%)
|
|
|
|
Grid Matrix 1 to 5 (10% to 50%)
|
|
|
|
Han Xin 1 to 4 (8%, 15%, 23%, 30%)
|
|
|
|
Micro QR 1 to 3 (7%, 15%, 25%) (L, M, Q)
|
2022-05-23 08:33:45 +12:00
|
|
|
PDF417 0 to 8 (2^(INTEGER + 1) codewords)
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
QR Code 1 to 4 (7%, 15%, 25%, 30%) (L, M, Q, H)
|
|
|
|
rMQR 2 or 4 (15% or 30%) (M or H)
|
|
|
|
Ultracode 1 to 6 (0%, 5%, 9%, 17%, 25%, 33%)
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--segN=ECI,DATA`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Set the *ECI* & *DATA* content for segment N, where N is 1 to 9. `-d` | `--data` must still be given, and counts
|
2022-05-19 21:17:51 +12:00
|
|
|
as segment 0, its ECI given by `--eci`. Segments must be consecutive.
|
|
|
|
|
|
|
|
`--separator=INTEGER`
|
|
|
|
|
|
|
|
: Set the height of row separator bars for stacked symbologies, where *INTEGER* is in integral multiples of the
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
X-dimension. The default is zero.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--small`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Use small text for Human Readable Text (HRT).
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--square`
|
|
|
|
|
2023-10-31 09:28:00 +13:00
|
|
|
: For Data Matrix symbols, exclude rectangular sizes when considering automatic sizes. See also `--dmre`.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--structapp=I,C[,ID]`
|
|
|
|
|
- API: add new zint_symbol `dpmm` field for output resolution (BMP/
EMF/PCX/PNG/TIF only, i.e. excluding EPS, GIF & SVG)
- Add support for specifying scale by X-dimension and resolution
with new option `--scalexdimdp` for CLI/Tcl & new API function
`ZBarcode_Scale_From_XdimDp()` (+ `ZBarcode_XdimDp_From_Scale()`
& `ZBarcode_Default_Xdim()`) and new GUI popup; manual: document
- BMP/EMF/PCX/PNG/TIF: use new `dpmm` resolution field (for EMF
following Inkscape)
- backend_qt: add `dpmm()`, `vectorWidth()`, `vectorHeight()`,
`noPng()`, `getVersion()`, `takesGS1AIData()`, & `XdimDp` stuff
incl. new `QZintXdimDp` struct for passing around scale vars &
use in `getAsCLI()`; add comments
- Raise `scale` limit to 200 (from 100) to allow for large dpmm
- output: create directories & subdirectories as necessary for
output path using new function `out_fopen()` and use in BMP/EMF/
EPS/GIF/PCX/PNG/SVG/TIF
- DPLEIT/DPIDENT: format HRT according to (incomplete)
documentation, and set default height to 72X (from 50X)
- CODE128B renamed to CODE128AB as can use subsets A and/or B
- CODABAR: fix minimum height calc
- EMF: fix indexing of handles (zero-based not 1-based)
- GUI: fix symbology zap (previous technique of clearing and
re-loading settings without doing a sync no longer works);
fix UPCEAN guard descent enable
- MAILMARK: better error message if input < 14 characters
- GUI: add "Default" button for DAFT tracker ratio & enable/disable
various default buttons; use new `takesGS1AIData()` to
enable/disable GS1-specific checkboxes
- CLI: use new `validate_float()` to parse float options (7
significant digits allowed only, no scientific notation)
- DATAMATRIX/GRIDMATRIX/PDF417/QR/ULTRA: micro-optimize structapp
ID parse
- library/CLI: fiddle with static asserts (make CHAR_BIT sensitive,
supposedly)
- win32/README: update building libpng (assembly removed)
- README.linux: document incompatibility of Qt6 >= 6.3
- manual: expand Barcode Studio waffle
- test suite: change range separator to hyphen and allow multiple
excludes
2022-12-03 10:39:01 +13:00
|
|
|
: Set Structured Append info, where *I* is the 1-based index, *C* is the total number of symbols in the sequence,
|
|
|
|
and *ID*, which is optional, is the identifier that all symbols in the sequence share. Structured Append is
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
supported by Aztec Code, Code One, Data Matrix, DotCode, Grid Matrix, MaxiCode, MicroPDF417, PDF417, QR Code and
|
|
|
|
Ultracode.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`-t`, `--types`
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Display the table of barcode types (symbologies). The numbers or names can be used with `-b` | `--barcode`.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
2023-02-11 03:44:10 +13:00
|
|
|
`--textgap=NUMBER`
|
|
|
|
|
2023-07-24 23:56:40 +12:00
|
|
|
: Adjust the gap between the barcode and the Human Readable Text (HRT). *NUMBER* is in X-dimensions, and may be
|
2023-11-20 08:39:54 +13:00
|
|
|
floating-point. Maximum is 10 and minimum is -5. The default is 1.
|
2023-02-11 03:44:10 +13:00
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
`--vers=INTEGER`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Set the symbol version (size, check digits, other options) to *INTEGER*. The meaning is symbol-specific.
|
|
|
|
|
|
|
|
For most matrix symbols, it specifies size:
|
|
|
|
|
|
|
|
Aztec Code 1 to 36 (1 to 4 compact)
|
2023-11-20 08:39:54 +13:00
|
|
|
1 15x15 13 53x53 25 105x105
|
|
|
|
2 19x19 14 57x57 26 109x109
|
|
|
|
3 23x23 15 61x61 27 113x113
|
|
|
|
4 27x27 16 67x67 28 117x117
|
|
|
|
5 19x19 17 71x71 29 121x121
|
|
|
|
6 23x23 18 75x75 30 125x125
|
|
|
|
7 27x27 19 79x79 31 131x131
|
|
|
|
8 31x31 20 83x83 32 135x135
|
|
|
|
9 37x37 21 87x87 33 139x139
|
|
|
|
10 41x41 22 91x91 34 143x143
|
|
|
|
11 45x45 23 95x95 35 147x147
|
|
|
|
12 49x49 24 101x101 36 151x151
|
2023-12-07 01:05:45 +13:00
|
|
|
|
2023-11-20 08:39:54 +13:00
|
|
|
Code One 1 to 10 (9 and 10 variable width) (WxH)
|
|
|
|
1 16x18 6 70x76
|
|
|
|
2 22x22 7 104x98
|
|
|
|
3 28x28 8 148x134
|
|
|
|
4 40x42 9 Wx8
|
|
|
|
5 52x54 10 Wx16
|
2023-12-07 01:05:45 +13:00
|
|
|
|
2023-11-20 08:39:54 +13:00
|
|
|
Data Matrix 1 to 48 (31 to 48 DMRE) (HxW)
|
|
|
|
1 10x10 17 72x72 33 8x80
|
|
|
|
2 12x12 18 80x80 34 8x96
|
|
|
|
3 14x14 19 88x88 35 8x120
|
|
|
|
4 16x16 20 96x96 36 8x144
|
|
|
|
5 18x18 21 104x104 37 12x64
|
|
|
|
6 20x20 22 120x120 38 12x88
|
|
|
|
7 22x22 23 132x132 39 16x64
|
|
|
|
8 24x24 24 144x144 40 20x36
|
|
|
|
9 26x26 25 8x18 41 20x44
|
|
|
|
10 32x32 26 8x32 42 20x64
|
|
|
|
11 36x36 28 12x26 43 22x48
|
|
|
|
12 40x40 28 12x36 44 24x48
|
|
|
|
13 44x44 29 16x36 45 24x64
|
|
|
|
14 48x48 30 16x48 46 26x40
|
|
|
|
15 52x52 31 8x48 47 26x48
|
|
|
|
16 64x64 32 8x64 48 26x64
|
2023-12-07 01:05:45 +13:00
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
Grid Matrix 1 to 13
|
2023-11-20 08:39:54 +13:00
|
|
|
1 18x18 6 78x78 11 138x138
|
|
|
|
2 30x30 7 90x90 12 150x150
|
|
|
|
3 42x42 8 102x102 13 162x162
|
|
|
|
4 54x54 9 114x114
|
|
|
|
5 66x66 10 126x126
|
2023-12-07 01:05:45 +13:00
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
Han Xin 1 to 84
|
2023-11-20 08:39:54 +13:00
|
|
|
1 23x23 29 79x79 57 135x135
|
|
|
|
2 25x25 30 81x81 58 137x137
|
|
|
|
3 27x27 31 83x83 59 139x139
|
|
|
|
4 29x29 32 85x85 60 141x141
|
|
|
|
5 31x31 33 87x87 61 143x143
|
|
|
|
6 33x33 34 89x89 62 145x145
|
|
|
|
7 35x35 35 91x91 63 147x147
|
|
|
|
8 37x37 36 93x93 64 149x149
|
|
|
|
9 39x39 37 95x95 65 151x151
|
|
|
|
10 41x41 38 97x97 66 153x153
|
|
|
|
11 43x43 39 99x99 67 155x155
|
|
|
|
12 45x45 40 101x101 68 157x157
|
|
|
|
13 47x47 41 103x103 69 159x159
|
|
|
|
14 49x49 42 105x105 70 161x161
|
|
|
|
15 51x51 43 107x107 71 163x163
|
|
|
|
16 53x53 44 109x109 72 165x165
|
|
|
|
17 55x55 45 111x111 73 167x167
|
|
|
|
18 57x57 46 113x113 74 169x169
|
|
|
|
19 59x59 47 115x115 75 171x171
|
|
|
|
20 61x61 48 117x117 76 173x173
|
|
|
|
21 63x63 49 119x119 77 175x175
|
|
|
|
22 65x65 50 121x121 78 177x177
|
|
|
|
23 67x67 51 123x123 79 179x179
|
|
|
|
24 69x69 52 125x125 80 181x181
|
|
|
|
25 71x71 53 127x127 81 183x183
|
|
|
|
26 73x73 54 129x129 82 185x185
|
|
|
|
27 75x75 55 131x131 83 187x187
|
|
|
|
28 77x77 56 133x133 84 189x189
|
2023-12-07 01:05:45 +13:00
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
Micro QR 1 to 4 (M1, M2, M3, M4)
|
2023-11-20 08:39:54 +13:00
|
|
|
1 11x11 3 15x15
|
|
|
|
2 13x13 4 17x17
|
2023-12-07 01:05:45 +13:00
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
QR Code 1 to 40
|
2023-11-20 08:39:54 +13:00
|
|
|
1 21x21 15 77x77 29 133x133
|
|
|
|
2 25x25 16 81x81 30 137x137
|
|
|
|
3 29x29 17 85x85 31 141x141
|
|
|
|
4 33x33 18 89x89 32 145x145
|
|
|
|
5 37x37 19 93x93 33 149x149
|
|
|
|
6 41x41 20 97x97 34 153x153
|
|
|
|
7 45x45 21 101x101 35 157x157
|
|
|
|
8 49x49 22 105x105 36 161x161
|
|
|
|
9 53x53 23 109x109 37 165x165
|
|
|
|
10 57x57 24 113x113 38 169x169
|
|
|
|
11 61x61 25 117x117 39 173x173
|
|
|
|
12 65x65 26 121x121 40 177x177
|
|
|
|
13 69x69 27 125x125
|
|
|
|
14 73x73 28 129x129
|
2023-12-07 01:05:45 +13:00
|
|
|
|
2023-11-20 08:39:54 +13:00
|
|
|
rMQR 1 to 38 (33 to 38 automatic width) (HxW)
|
2023-12-05 08:22:00 +13:00
|
|
|
1 7x43 14 11x77 27 15x139
|
2023-11-20 08:39:54 +13:00
|
|
|
2 7x59 15 11x99 28 17x43
|
|
|
|
3 7x77 16 11x139 29 17x59
|
|
|
|
4 7x99 17 13x27 30 17x77
|
|
|
|
5 7x139 18 13x43 31 17x99
|
|
|
|
6 9x43 19 13x59 32 17x139
|
|
|
|
7 9x59 20 13x77 33 7xW
|
|
|
|
8 9x77 21 13x99 34 9xW
|
|
|
|
9 9x99 22 13x139 35 11xW
|
|
|
|
10 9x139 23 15x43 36 13xW
|
|
|
|
11 11x27 24 15x59 37 15xW
|
|
|
|
12 11x43 25 15x77 38 17xW
|
|
|
|
13 11x59 26 15x99
|
2022-05-23 08:33:45 +12:00
|
|
|
|
|
|
|
For a number of linear symbols, it specifies check character options ("hide" or "hidden" means don't show in HRT,
|
2022-08-23 03:28:22 +12:00
|
|
|
"visible" means do display in HRT):
|
2022-05-23 08:33:45 +12:00
|
|
|
|
|
|
|
C25IATA 1 or 2 (add visible or hidden check digit)
|
|
|
|
C25IND ditto
|
|
|
|
C25INTER ditto
|
|
|
|
C25LOGIC ditto
|
|
|
|
C25STANDARD ditto
|
|
|
|
Codabar 1 or 2 (add hidden or visible check digit)
|
2022-12-20 05:28:15 +13:00
|
|
|
Code 11 0 to 2 (2 visible check digits to none)
|
|
|
|
0 (default 2 visible check digits)
|
|
|
|
1 (1 visible check digit)
|
|
|
|
2 (no check digits)
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
Code 39 1 or 2 (add visible or hidden check digit)
|
2022-05-23 08:33:45 +12:00
|
|
|
Code 93 1 (hide the default check characters)
|
Remove `bitmap_byte_length` member from `zint_symbol`
(was only set on BMP output to length of BMP pixel array)
EXCODE39: change to display check digit in HRT by default
CODE39/EXCODE39/LOGMARS: new hidden check digit option
(`option_2 = 2`)
qr.c: suppress bogus gcc-13 warning (only appears on optimize)
GUI: move some symbology-specific options into Data Tab so
separate tab unnecessary (those with few options and no
Composite/ECI), namely: all C25XXX, CODE39/EXCODE39/LOGMARS,
MSI_PLESSEY, CODABAR, DAFT, DPD, MAILMARK_2D, ITF-14, PZN,
UPNQR, CHANNEL, CODE93 and VIN, adjusting grp uis.
change Data dialog button (ellipsis) QToolButton -> QPushButton
& vice versa zap/clear/eye/swap/scale buttons QPushButton ->
QToolButton for better mac compat (also makes sense);
remove some mac hacks that no longer seem necessary;
use folder icon for Export dialog directory button
manual: document new Symbology-specific groupbox & CODE39/etc
hidden check digit option; add annexes on Qt and Tcl backends;
narrow some tables for better txt output;
remove echoed image tags in txt (pandoc 3.1.5 regression?);
add one-page HTML output to Makefile; also tex output (debug);
add class attributes to images to aid HTML styling;
various other fiddlings
2023-07-18 22:11:50 +12:00
|
|
|
EXCODE39 1 or 2 (add visible or hidden check digit)
|
|
|
|
LOGMARS 1 or 2 (add visible or hidden check digit)
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
MSI Plessey 0 to 6 (none to various visible options)
|
|
|
|
1, 2 (mod-10, mod-10 + mod-10)
|
|
|
|
3, 4 (mod-11 IBM, mod-11 IBM + mod-10)
|
|
|
|
5, 6 (mod-11 NCR, mod-11 NCR + mod-10)
|
2022-05-23 08:33:45 +12:00
|
|
|
+10 (hide)
|
|
|
|
|
|
|
|
For a few other symbologies, it specifies other characteristics:
|
|
|
|
|
|
|
|
Channel Code 3 to 8 (no. of channels)
|
|
|
|
DAFT 50 to 900 (permille tracker ratio)
|
2022-11-11 11:13:41 +13:00
|
|
|
DPD 1 (relabel)
|
2022-12-10 03:51:26 +13:00
|
|
|
PZN 1 (PZN7 instead of default PZN8)
|
2022-05-23 08:33:45 +12:00
|
|
|
Ultracode 2 (revision 2)
|
|
|
|
VIN 1 (add international prefix)
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`-v`, `--version`
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
: Display zint version.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--vwhitesp=INTEGER`
|
|
|
|
|
2022-05-20 20:42:19 +12:00
|
|
|
: Set the height of vertical whitespace above and below the barcode, where *INTEGER* is in integral multiples of the
|
2022-05-19 21:17:51 +12:00
|
|
|
X-dimension.
|
|
|
|
|
|
|
|
`-w`, `--whitesp=INTEGER`
|
|
|
|
|
2022-05-20 20:42:19 +12:00
|
|
|
: Set the width of horizontal whitespace either side of the barcode, where *INTEGER* is in integral multiples of the
|
|
|
|
X-dimension.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
`--werror`
|
|
|
|
|
|
|
|
: Convert all warnings into errors.
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
# EXIT STATUS
|
|
|
|
|
|
|
|
`0`
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
: Success (including when given informational options `-h` | `--help`, `-e` | `--ecinos`, `-t` | `--types`, `-v` |
|
2022-05-23 08:33:45 +12:00
|
|
|
`--version`).
|
|
|
|
|
2023-06-23 04:48:54 +12:00
|
|
|
`1`
|
2023-11-20 08:39:54 +13:00
|
|
|
: Human Readable Text was truncated (maximum 199 bytes) (`ZINT_WARN_HRT_TRUNCATED`)
|
2023-06-23 04:48:54 +12:00
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
`2`
|
|
|
|
: Invalid option given but overridden by Zint (`ZINT_WARN_INVALID_OPTION`)
|
|
|
|
|
|
|
|
`3`
|
|
|
|
: Automatic ECI inserted by Zint (`ZINT_WARN_USES_ECI`)
|
|
|
|
|
|
|
|
`4`
|
|
|
|
: Symbol created not compliant with standards (`ZINT_WARN_NONCOMPLIANT`)
|
|
|
|
|
|
|
|
`5`
|
|
|
|
: Input data wrong length (`ZINT_ERROR_TOO_LONG`)
|
|
|
|
|
|
|
|
`6`
|
|
|
|
: Input data incorrect (`ZINT_ERROR_INVALID_DATA`)
|
|
|
|
|
|
|
|
`7`
|
|
|
|
: Input check digit incorrect (`ZINT_ERROR_INVALID_CHECK`)
|
|
|
|
|
|
|
|
`8`
|
|
|
|
: Incorrect option given (`ZINT_ERROR_INVALID_OPTION`)
|
|
|
|
|
|
|
|
`9`
|
|
|
|
: Internal error (should not happen) (`ZINT_ERROR_ENCODING_PROBLEM`)
|
|
|
|
|
|
|
|
`10`
|
|
|
|
: Error opening output file (`ZINT_ERROR_FILE_ACCESS`)
|
|
|
|
|
|
|
|
`11`
|
|
|
|
: Memory allocation (malloc) failure (`ZINT_ERROR_MEMORY`)
|
|
|
|
|
|
|
|
`12`
|
|
|
|
: Error writing to output file (`ZINT_ERROR_FILE_WRITE`)
|
|
|
|
|
|
|
|
`13`
|
|
|
|
: Error counterpart of warning if `--werror` given (`ZINT_ERROR_USES_ECI`)
|
|
|
|
|
|
|
|
`14`
|
|
|
|
: Error counterpart of warning if `--werror` given (`ZINT_ERROR_NONCOMPLIANT`)
|
|
|
|
|
2023-06-23 04:48:54 +12:00
|
|
|
`15`
|
|
|
|
: Error counterpart of warning if `--werror` given (`ZINT_ERROR_HRT_TRUNCATED`)
|
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
# EXAMPLES
|
|
|
|
|
|
|
|
Create "out.png" (or "out.gif" if zint built without PNG support) in the current directory, as a Code 128 symbol.
|
|
|
|
|
|
|
|
```bash
|
|
|
|
zint -d 'This Text'
|
|
|
|
```
|
|
|
|
|
|
|
|
Create "qr.svg" in the current directory, as a QR Code symbol.
|
|
|
|
|
|
|
|
```bash
|
|
|
|
zint -b QRCode -d 'This Text' -o 'qr.svg'
|
|
|
|
```
|
|
|
|
|
2023-06-23 04:48:54 +12:00
|
|
|
Use batch mode to read from an input file "ean13nos.txt" containing 13-digit GTINs, to create a series of EAN-13
|
2022-05-23 08:33:45 +12:00
|
|
|
barcodes, formatting the output filenames to "ean001.gif", "ean002.gif" etc. using the special character "~".
|
|
|
|
|
|
|
|
```bash
|
2023-06-23 04:48:54 +12:00
|
|
|
zint -b EANX --batch -i 'ean13nos.txt' -o 'ean~~~.gif'
|
2022-05-23 08:33:45 +12:00
|
|
|
```
|
|
|
|
|
2022-05-19 21:17:51 +12:00
|
|
|
# BUGS
|
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
Please send bug reports to https://sourceforge.net/p/zint/tickets/.
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
# SEE ALSO
|
|
|
|
|
|
|
|
Full documention for `zint` (and the API `libzint` and the GUI `zint-qt`) is available from
|
2022-07-21 23:29:53 +12:00
|
|
|
|
2022-08-26 00:03:04 +12:00
|
|
|
https://zint.org.uk/manual/
|
2022-07-21 23:29:53 +12:00
|
|
|
|
|
|
|
and at
|
|
|
|
|
|
|
|
https://sourceforge.net/p/zint/docs/manual.txt
|
2022-05-19 21:17:51 +12:00
|
|
|
|
2022-05-23 08:33:45 +12:00
|
|
|
# CONFORMING TO
|
2022-05-19 21:17:51 +12:00
|
|
|
|
|
|
|
Zint is designed to be compliant with a number of international standards, including:
|
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
ISO/IEC 24778:2008, ANSI/AIM BC12-1998, EN 798:1996,
|
|
|
|
AIM ISS-X-24 (1995), ISO/IEC 15417:2007, EN 12323:2005,
|
|
|
|
ISO/IEC 16388:2007, ANSI/AIM BC6-2000, ANSI/AIM BC5-1995,
|
|
|
|
AIM USS Code One (1994), ISO/IEC 16022:2006, ISO/IEC 21471:2019,
|
|
|
|
ISO/IEC 15420:2009, AIMD014 (v 1.63) (2008), ISO/IEC 24723:2010,
|
|
|
|
ISO/IEC 24724:2011, ISO/IEC 20830:2021, ISO/IEC 16390:2007,
|
|
|
|
ISO/IEC 16023:2000, ISO/IEC 24728:2006, ISO/IEC 15438:2015,
|
|
|
|
ISO/IEC 18004:2015, ISO/IEC 23941:2022, AIM ITS/04-023 (2022)
|
|
|
|
|
|
|
|
# COPYRIGHT
|
|
|
|
|
2023-01-15 13:22:43 +13:00
|
|
|
Copyright © 2023 Robin Stuart. Released under GNU GPL 3.0 or later.
|
2022-05-23 08:33:45 +12:00
|
|
|
|
RMQR: update to ISO/IEC 23941:2022 - R13x77 numeric cclens change 8 -> 7
QRCODE: use stricter interpretation of ZINT_FULL_MULTIBYTE, excluding
certain trailing bytes
libzint: fix some confusing error messages introduced by segment stuff
general: new escape chars \U, \d and \o
backend_qt: fudge rendering of border rectangles due to scaling/translation
rounding errors TODO: better fudge
GUI: foreground/background colours -> text boxes and icon buttons, add swap
button, independently movable picker (NULL parent), preview colour changes,
preview Data Window changes, add clear data (del) buttons, add zap button
and Factory Reset menu option, various other fixes
libzint: remove STATIC_UNLESS_ZINT_TEST, use wrappers
CMake: add find package QtSvg, remove QtXml
manual: split symbology and general specs and sort, move DAFT to 4-state,
UPC/EAN -> EAN/UPC, DataBar -> GS1 DataBar always, expand MAILMARK info,
various other fiddlings
man page: options or -> |, expand MSI Plessey check digit options
README.linux: add packages info
license: add SPDX-License-Identifier to touched files
2022-06-10 08:52:02 +12:00
|
|
|
# AUTHOR
|
2022-05-23 08:33:45 +12:00
|
|
|
|
|
|
|
Robin Stuart <robin@zint.org.uk>
|