mirror of
https://github.com/zint/zint
synced 2024-11-16 20:57:25 +13:00
5e2044ff2e
encodation in certain cases (and no pessimizations found so far), props lyngklip (BWIPP); fix extended char latching when exactly 3 extended chars at end; count code set C (not digits) in loop deciding when to shift/latch to extended for better estimate AZTEC: return warning if ECC < 5% (due to bit-stuffing when version given); return error if > 22 layers (Zint 26) for Reader Initialisation symbol requested for better error message AZTEC/HANXIN/QRCODE: consolidate different ECC data size tables into one indexed by ECC DBAR_EXP: check for reduced length <= 77 up front for better error message HANXIN: use `malloc()` rather than `z_alloca()` for large binary array QRCODE: `ecc_level` now 0-based (not 1-based) MICROQR: consolidate different version end routines into one `microqr_end()` and use new `microqr_data` table to simplify code MICROPDF417: use table for max codewords per column library: centralize all error messages using new `errtxt()`, `errtxtf()`, `errtxt_adj()` funcs that protect `symbol->errtxt` from overflow, & try to make error messages more consistent thru-out, adding more feedback info to many, & use positional args "%n$" in prep for l10n (maybe); `is_sane/is_sane_lookup()` -> `not_sane/not_sane_lookup()`, returning 1-based position (zero on failure) instead of bool; `long` ints -> plain `int` (except those dealing with `ftell()`, `fread()` etc) as depend on int being 32-bits already GUI: in "grpDATF.ui" use "PlainText" rather than "RichText" for tracker ratio examples as height of text messing up sometimes manual: clarify Codablock-F length maximum & add examples docs: README: pandoc 3.5, Ubuntu 24.04 CMake: use "-Wpedantic" for Clang only as GNU complains about `errtxtf()` positional args "%n$"
664 lines
24 KiB
Plaintext
664 lines
24 KiB
Plaintext
% ZINT(1) Version 2.13.0.9
|
|
%
|
|
% October 2024
|
|
|
|
# NAME
|
|
|
|
`zint` - encode data as a barcode image
|
|
|
|
# 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.
|
|
|
|
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.
|
|
|
|
The output image file (specified with `-o` | `--output`) may be in one of these formats: Windows Bitmap (`BMP`),
|
|
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`
|
|
|
|
: Print usage information summarizing command line options.
|
|
|
|
`-b TYPE`, `--barcode=TYPE`
|
|
|
|
: Set the barcode symbology that will be used to encode the data. *TYPE* is the number or name of the barcode
|
|
symbology. If not given, the symbology defaults to 20 (Code 128). To see what types are available, use the `-t` |
|
|
`--types` option. Type names are case-insensitive, and non-alphanumerics are ignored.
|
|
|
|
`--addongap=INTEGER`
|
|
|
|
: For EAN/UPC symbologies, set the gap between the main data and the add-on. *INTEGER* is in integral multiples of
|
|
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`
|
|
|
|
: Treat each line of an input file specified with `-i` | `--input` as a separate data set and produce a barcode
|
|
image for each one. The barcode images are outputted by default to numbered filenames starting with "00001.png",
|
|
"00002.png" etc., which can be changed by using the `-o` | `--output` option.
|
|
|
|
`--bg=COLOUR`
|
|
|
|
: Specify a background (paper) colour where *COLOUR* is in hexadecimal `RRGGBB` or `RRGGBBAA` format or in decimal
|
|
`C,M,Y,K` percentages format.
|
|
|
|
`--binary`
|
|
|
|
: Treat input data as raw 8-bit binary data instead of the default UTF-8. Automatic code page translation to an ECI
|
|
page is disabled, and no validation of the data's character encoding takes place.
|
|
|
|
`--bind`
|
|
|
|
: Add horizontal boundary bars (also known as bearer bars) to the symbol. The width of the boundary bars is
|
|
specified by the `--border` option. `--bind` can also be used to add row separator bars to symbols stacked with
|
|
multiple `-d` | `--data` inputs, in which case the width of the separator bars is specified with the `--separator`
|
|
option.
|
|
|
|
`--bindtop`
|
|
|
|
: Add a horizontal boundary bar to the top of the symbol. The width of the boundary bar is specified by the
|
|
`--border` option.
|
|
|
|
`--bold`
|
|
|
|
: Use a bold font for the Human Readable Text (HRT).
|
|
|
|
`--border=INTEGER`
|
|
|
|
: 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.
|
|
|
|
`--box`
|
|
|
|
: Add a box around the symbol. The width of the borders is specified by the `--border` option.
|
|
|
|
`--cmyk`
|
|
|
|
: Use the CMYK colour space when outputting to Encapsulated PostScript (EPS) or TIF files.
|
|
|
|
`--cols=INTEGER`
|
|
|
|
: 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.
|
|
|
|
`--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
|
|
sequences. The *DATA* should be UTF-8, unless the `--binary` option is given, in which case it can be anything.
|
|
|
|
`--direct`
|
|
|
|
: Send output to stdout, which in most cases should be re-directed to a pipe or a file. Use `--filetype` to specify
|
|
output format.
|
|
|
|
`--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).
|
|
|
|
`--dmre`
|
|
|
|
: For Data Matrix symbols, allow Data Matrix Rectangular Extended (DMRE) sizes when considering automatic sizes. See
|
|
also `--square`.
|
|
|
|
`--dotsize=NUMBER`
|
|
|
|
: 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.
|
|
|
|
`--dotty`
|
|
|
|
: Use dots instead of squares for matrix symbols. DotCode is always in dotty mode.
|
|
|
|
`--dump`
|
|
|
|
: Dump a hexadecimal representation of the symbol's encodation to stdout. The same representation may be outputted
|
|
to a file by using a `.txt` extension with `-o` | `--output` or by specifying `--filetype=txt`.
|
|
|
|
`-e`, `--ecinos`
|
|
|
|
: Display the table of ECIs (Extended Channel Interpretations).
|
|
|
|
`--eci=INTEGER`
|
|
|
|
: 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,
|
|
QR Code, rMQR and Ultracode.
|
|
|
|
`--embedfont`
|
|
|
|
: For vector output, embed the font in the file for portability. Currently only available for SVG output.
|
|
|
|
`--esc`
|
|
|
|
: Process escape characters in the input data. The escape sequences are:
|
|
|
|
\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)
|
|
\oNNN (0oNNN) Any 8-bit character where NNN is
|
|
octal (000-377)
|
|
\xNN (0xNN) Any 8-bit character where NN is
|
|
hexadecimal (00-FF)
|
|
\uNNNN (U+NNNN) Any 16-bit Unicode BMP character
|
|
where NNNN is hexadecimal
|
|
\UNNNNNN (U+NNNNNN) Any 21-bit Unicode character
|
|
where NNNNNN is hexadecimal
|
|
|
|
`--extraesc`
|
|
|
|
: For Code 128 only, process the special escape sequences `\^A`, `\^B` and `\^C` that allow manual switching of Code
|
|
Sets, and the special escape sequence `\^1` that inserts an `FNC1` character. The sequence `\^^` can be used to
|
|
encode data that contains special escape sequences.
|
|
|
|
`--fast`
|
|
|
|
: Use faster if less optimal encodation or other shortcuts (affects Data Matrix, MicroPDF417, PDF417, QRCODE & UPNQR
|
|
only).
|
|
|
|
`--fg=COLOUR`
|
|
|
|
: Specify a foreground (ink) colour where *COLOUR* is in hexadecimal `RRGGBB` or `RRGGBBAA` format or in decimal
|
|
`C,M,Y,K` percentages format.
|
|
|
|
`--filetype=TYPE`
|
|
|
|
: Set the output file type to *TYPE*, which is one of `BMP`, `EMF`, `EPS`, `GIF`, `PCX`, `PNG`, `SVG`, `TIF`, `TXT`.
|
|
|
|
`--fullmultibyte`
|
|
|
|
: Use the multibyte modes of Grid Matrix, Han Xin and QR Code for non-ASCII data.
|
|
|
|
`--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
|
|
otherwise contain parentheses.
|
|
|
|
`--gssep`
|
|
|
|
: For Data Matrix in GS1 mode, use `GS` (0x1D) as the GS1 data separator instead of `FNC1`.
|
|
|
|
`--guarddescent=NUMBER`
|
|
|
|
: 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.
|
|
|
|
`--guardwhitespace`
|
|
|
|
: For EAN/UPC symbols, add quiet zone indicators `"<"` and/or `">"` to HRT where applicable.
|
|
|
|
`--height=NUMBER`
|
|
|
|
: Set the height of the symbol in X-dimensions. *NUMBER* may be floating-point.
|
|
|
|
`--heightperrow`
|
|
|
|
: Treat height as per-row. Affects Codablock-F, Code 16K, Code 49, GS1 DataBar Expanded Stacked (DBAR_EXPSTK),
|
|
MicroPDF417 and PDF417.
|
|
|
|
`-i`, `--input=FILE`
|
|
|
|
: Read the input data from *FILE*. Specify a single hyphen (`-`) for *FILE* to read from stdin.
|
|
|
|
`--init`
|
|
|
|
: Create a Reader Initialisation (Programming) symbol.
|
|
|
|
`--mask=INTEGER`
|
|
|
|
: Set the masking pattern to use for DotCode, Han Xin or QR Code to *INTEGER*, overriding the automatic selection.
|
|
|
|
`--mirror`
|
|
|
|
: 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).
|
|
|
|
`--mode=INTEGER`
|
|
|
|
: For MaxiCode and GS1 Composite symbols, set the encoding mode to *INTEGER*.
|
|
|
|
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)
|
|
|
|
For GS1 Composite symbols (names end in `_CC`, i.e. EANX_CC, GS1_128_CC, DBAR_OMN_CC etc.):
|
|
|
|
1 CC-A
|
|
2 CC-B
|
|
3 CC-C (GS1_128_CC only)
|
|
|
|
`--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`
|
|
|
|
: Remove the Human Readable Text (HRT).
|
|
|
|
`-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:
|
|
|
|
~ Insert a number or 0
|
|
# Insert a number or space
|
|
@ Insert a number or * (+ on Windows)
|
|
Any other Insert literally
|
|
|
|
`--primary=STRING`
|
|
|
|
: For MaxiCode, set the content of the primary message. For GS1 Composite symbols, set the content of the linear
|
|
symbol.
|
|
|
|
`--quietzones`
|
|
|
|
: Add compliant quiet zones for symbols that specify them. This is in addition to any whitespace specified by `-w` |
|
|
`--whitesp` or `--vwhitesp`.
|
|
|
|
`-r`, `--reverse`
|
|
|
|
: Reverse the foreground and background colours (white on black). Known as "reflectance reversal" or "reversed
|
|
reflectance".
|
|
|
|
`--rotate=INTEGER`
|
|
|
|
: Rotate the symbol by *INTEGER* degrees, where *INTEGER* can be 0, 90, 270 or 360.
|
|
|
|
`--rows=INTEGER`
|
|
|
|
: Set the number of rows for Codablock-F or PDF417 to *INTEGER*. It will also set the minimum number of rows for
|
|
Code 16K or Code 49, and the maximum number of rows for GS1 DataBar Expanded Stacked (DBAR_EXPSTK).
|
|
|
|
`--scale=NUMBER`
|
|
|
|
: 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.
|
|
|
|
For MaxiCode, the scale is multiplied by 10 for raster output, by 40 for EMF output, and by 2 otherwise.
|
|
|
|
Increments of 0.5 (half-integers) are recommended for non-MaxiCode raster output (BMP, GIF, PCX, PNG and TIF).
|
|
|
|
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
|
|
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.
|
|
|
|
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`.
|
|
|
|
`--scmvv=INTEGER`
|
|
|
|
: For MaxiCode, prefix the Structured Carrier Message (SCM) with `"[)>\R01\Gvv"`, where `vv` is a 2-digit *INTEGER*.
|
|
|
|
`--secure=INTEGER`
|
|
|
|
: Set the error correction level (ECC) to *INTEGER*. The meaning is specific to the following matrix symbols (all
|
|
except PDF417 are approximate):
|
|
|
|
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)
|
|
PDF417 0 to 8 (2^(INTEGER + 1) codewords)
|
|
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%)
|
|
|
|
`--segN=ECI,DATA`
|
|
|
|
: Set the *ECI* & *DATA* content for segment N, where N is 1 to 9. `-d` | `--data` must still be given, and counts
|
|
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
|
|
X-dimension. The default is zero.
|
|
|
|
`--small`
|
|
|
|
: Use a smaller font for Human Readable Text (HRT).
|
|
|
|
`--square`
|
|
|
|
: For Data Matrix symbols, exclude rectangular sizes when considering automatic sizes. See also `--dmre`.
|
|
|
|
`--structapp=I,C[,ID]`
|
|
|
|
: 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
|
|
supported by Aztec Code, Code One, Data Matrix, DotCode, Grid Matrix, MaxiCode, MicroPDF417, PDF417, QR Code and
|
|
Ultracode.
|
|
|
|
`-t`, `--types`
|
|
|
|
: Display the table of barcode types (symbologies). The numbers or names can be used with `-b` | `--barcode`.
|
|
|
|
`--textgap=NUMBER`
|
|
|
|
: Adjust the gap between the barcode and the Human Readable Text (HRT). *NUMBER* is in X-dimensions, and may be
|
|
floating-point. Maximum is 10 and minimum is -5. The default is 1.
|
|
|
|
`--vers=INTEGER`
|
|
|
|
: 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)
|
|
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
|
|
|
|
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
|
|
|
|
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
|
|
|
|
Grid Matrix 1 to 13
|
|
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
|
|
|
|
Han Xin 1 to 84
|
|
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
|
|
|
|
Micro QR 1 to 4 (M1, M2, M3, M4)
|
|
1 11x11 3 15x15
|
|
2 13x13 4 17x17
|
|
|
|
QR Code 1 to 40
|
|
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
|
|
|
|
rMQR 1 to 38 (33 to 38 automatic width) (HxW)
|
|
1 7x43 14 11x77 27 15x139
|
|
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
|
|
|
|
For a number of linear symbols, it specifies check character options ("hide" or "hidden" means don't show in HRT,
|
|
"visible" means do display in HRT):
|
|
|
|
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)
|
|
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)
|
|
Code 39 1 or 2 (add visible or hidden check digit)
|
|
Code 93 1 (hide the default check characters)
|
|
EXCODE39 1 or 2 (add visible or hidden check digit)
|
|
LOGMARS 1 or 2 (add visible or hidden check digit)
|
|
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)
|
|
+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)
|
|
DPD 1 (relabel)
|
|
PZN 1 (PZN7 instead of default PZN8)
|
|
Ultracode 2 (revision 2)
|
|
VIN 1 (add international prefix)
|
|
|
|
`-v`, `--version`
|
|
|
|
: Display zint version.
|
|
|
|
`--vwhitesp=INTEGER`
|
|
|
|
: Set the height of vertical whitespace above and below the barcode, where *INTEGER* is in integral multiples of the
|
|
X-dimension.
|
|
|
|
`-w`, `--whitesp=INTEGER`
|
|
|
|
: Set the width of horizontal whitespace either side of the barcode, where *INTEGER* is in integral multiples of the
|
|
X-dimension.
|
|
|
|
`--werror`
|
|
|
|
: Convert all warnings into errors.
|
|
|
|
# EXIT STATUS
|
|
|
|
`0`
|
|
: Success (including when given informational options `-h` | `--help`, `-e` | `--ecinos`, `-t` | `--types`, `-v` |
|
|
`--version`).
|
|
|
|
`1`
|
|
: Human Readable Text was truncated (maximum 199 bytes) (`ZINT_WARN_HRT_TRUNCATED`)
|
|
|
|
`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`)
|
|
|
|
`15`
|
|
: Error counterpart of warning if `--werror` given (`ZINT_ERROR_HRT_TRUNCATED`)
|
|
|
|
# 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'
|
|
```
|
|
|
|
Use batch mode to read from an input file "ean13nos.txt" containing a list of 13-digit GTINs, each on a separate line,
|
|
to create a series of EAN-13 barcodes, formatting the output filenames to "ean001.gif", "ean002.gif" etc. using the
|
|
special character "~".
|
|
|
|
```bash
|
|
zint -b EANX --batch -i 'ean13nos.txt' -o 'ean~~~.gif'
|
|
```
|
|
|
|
# BUGS
|
|
|
|
Please send bug reports to https://sourceforge.net/p/zint/tickets/.
|
|
|
|
# SEE ALSO
|
|
|
|
Full documention for `zint` (and the API `libzint` and the GUI `zint-qt`) is available from
|
|
|
|
https://zint.org.uk/manual/
|
|
|
|
and at
|
|
|
|
https://sourceforge.net/p/zint/docs/manual.txt
|
|
|
|
# CONFORMING TO
|
|
|
|
Zint is designed to be compliant with a number of international standards, including:
|
|
|
|
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
|
|
|
|
Copyright © 2024 Robin Stuart. Released under GNU GPL 3.0 or later.
|
|
|
|
# AUTHOR
|
|
|
|
Robin Stuart <robin@zint.org.uk>
|