Mercurial > hgrepos > Python2 > PyMuPDF

comparison mupdf-source/thirdparty/zint/docs/zint.1.pmd @ 2:b50eed0cc0ef upstream

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4. The directory name has changed: no version number in the expanded directory now.
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 15 Sep 2025 11:43:07 +0200
parents
children
comparison
equal deleted inserted replaced
1:1d09e1dec1d9 2:b50eed0cc0ef
1 % ZINT(1) Version 2.13.0.9
2 %
3 % December 2024
4
5 # NAME
6
7 `zint` - encode data as a barcode image
8
9 # SYNOPSIS
10
11 | `zint` [`-h` | `--help`]
12 | `zint` [*options*]
13
14 # DESCRIPTION
15
16 zint takes input data from the command line or a file to encode in a barcode which is then output to an image file.
17
18 Input data is UTF-8, unless `--binary` is specified.
19
20 Human Readable Text (HRT) is displayed by default for those barcodes that support HRT, unless `--notext` is specified.
21
22 The output image file (specified with `-o` | `--output`) may be in one of these formats: Windows Bitmap (`BMP`),
23 Enhanced Metafile Format (`EMF`), Encapsulated PostScript (`EPS`), Graphics Interchange Format (`GIF`), ZSoft
24 Paintbrush (`PCX`), Portable Network Format (`PNG`), Scalable Vector Graphic (`SVG`), or Tagged Image File Format
25 (`TIF`).
26
27 # OPTIONS
28
29 `-h`, `--help`
30
31 : Print usage information summarizing command line options.
32
33 `-b TYPE`, `--barcode=TYPE`
34
35 : Set the barcode symbology that will be used to encode the data. *TYPE* is the number or name of the barcode
36 symbology. If not given, the symbology defaults to 20 (Code 128). To see what types are available, use the `-t` |
37 `--types` option. Type names are case-insensitive, and non-alphanumerics are ignored.
38
39 `--addongap=INTEGER`
40
41 : For EAN/UPC symbologies, set the gap between the main data and the add-on. *INTEGER* is in integral multiples of
42 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.
43
44 `--batch`
45
46 : Treat each line of an input file specified with `-i` | `--input` as a separate data set and produce a barcode
47 image for each one. The barcode images are outputted by default to numbered filenames starting with "00001.png",
48 "00002.png" etc., which can be changed by using the `-o` | `--output` option.
49
50 `--bg=COLOUR`
51
52 : Specify a background (paper) colour where *COLOUR* is in hexadecimal `RRGGBB` or `RRGGBBAA` format or in decimal
53 `C,M,Y,K` percentages format.
54
55 `--binary`
56
57 : Treat input data as raw 8-bit binary data instead of the default UTF-8. Automatic code page translation to an ECI
58 page is disabled, and no validation of the data's character encoding takes place.
59
60 `--bind`
61
62 : Add horizontal boundary bars (also known as bearer bars) to the symbol. The width of the boundary bars is
63 specified by the `--border` option. `--bind` can also be used to add row separator bars to symbols stacked with
64 multiple `-d` | `--data` inputs, in which case the width of the separator bars is specified with the `--separator`
65 option.
66
67 `--bindtop`
68
69 : Add a horizontal boundary bar to the top of the symbol. The width of the boundary bar is specified by the
70 `--border` option.
71
72 `--bold`
73
74 : Use a bold font for the Human Readable Text (HRT).
75
76 `--border=INTEGER`
77
78 : Set the width of boundary bars (`--bind` or `--bindtop`) or box borders (`--box`), where *INTEGER* is in integral
79 multiples of the X-dimension. The default is zero.
80
81 `--box`
82
83 : Add a box around the symbol. The width of the borders is specified by the `--border` option.
84
85 `--cmyk`
86
87 : Use the CMYK colour space when outputting to Encapsulated PostScript (EPS) or TIF files.
88
89 `--cols=INTEGER`
90
91 : Set the number of data columns in the symbol to *INTEGER*. Affects Codablock-F, DotCode, GS1 DataBar Expanded
92 Stacked (DBAR_EXPSTK), MicroPDF417 and PDF417 symbols.
93
94 `--compliantheight`
95
96 : Warn if the height specified by the `--height` option is not compliant with the barcode's specification, or if
97 `--height` is not given, default to the height specified by the specification (if any).
98
99 `-d`, `--data=DATA`
100
101 : Specify the input *DATA* to encode. The `--esc` option may be used to enter non-printing characters using escape
102 sequences. The *DATA* should be UTF-8, unless the `--binary` option is given, in which case it can be anything.
103
104 `--direct`
105
106 : Send output to stdout, which in most cases should be re-directed to a pipe or a file. Use `--filetype` to specify
107 output format.
108
109 `--dmiso144`
110
111 : For Data Matrix symbols, use the standard ISO/IEC codeword placement for 144 x 144 (`--vers=24`) sized symbols,
112 instead of the default "de facto" placement (which rotates the placement of ECC codewords).
113
114 `--dmre`
115
116 : For Data Matrix symbols, allow Data Matrix Rectangular Extended (DMRE) sizes when considering automatic sizes. See
117 also `--square`.
118
119 `--dotsize=NUMBER`
120
121 : Set the radius of the dots in dotty mode (`--dotty`). *NUMBER* is in X-dimensions, and may be floating-point. The
122 default is 0.8.
123
124 `--dotty`
125
126 : Use dots instead of squares for matrix symbols. DotCode is always in dotty mode.
127
128 `--dump`
129
130 : Dump a hexadecimal representation of the symbol's encodation to stdout. The same representation may be outputted
131 to a file by using a `.txt` extension with `-o` | `--output` or by specifying `--filetype=txt`.
132
133 `-e`, `--ecinos`
134
135 : Display the table of ECIs (Extended Channel Interpretations).
136
137 `--eci=INTEGER`
138
139 : Set the ECI code for the input data to *INTEGER*. See `-e` | `--ecinos` for a list of the ECIs available. ECIs are
140 supported by Aztec Code, Code One, Data Matrix, DotCode, Grid Matrix, Han Xin Code, MaxiCode, MicroPDF417, PDF417,
141 QR Code, rMQR and Ultracode.
142
143 `--embedfont`
144
145 : For vector output, embed the font in the file for portability. Currently only available for SVG output.
146
147 `--esc`
148
149 : Process escape characters in the input data. The escape sequences are:
150
151 \0 (0x00) NUL Null character
152 \E (0x04) EOT End of Transmission
153 \a (0x07) BEL Bell
154 \b (0x08) BS Backspace
155 \t (0x09) HT Horizontal Tab
156 \n (0x0A) LF Line Feed
157 \v (0x0B) VT Vertical Tab
158 \f (0x0C) FF Form Feed
159 \r (0x0D) CR Carriage Return
160 \e (0x1B) ESC Escape
161 \G (0x1D) GS Group Separator
162 \R (0x1E) RS Record Separator
163 \\ (0x5C) \ Backslash
164 \dNNN (NNN) Any 8-bit character where NNN is
165 decimal (000-255)
166 \oNNN (0oNNN) Any 8-bit character where NNN is
167 octal (000-377)
168 \xNN (0xNN) Any 8-bit character where NN is
169 hexadecimal (00-FF)
170 \uNNNN (U+NNNN) Any 16-bit Unicode BMP character
171 where NNNN is hexadecimal
172 \UNNNNNN (U+NNNNNN) Any 21-bit Unicode character
173 where NNNNNN is hexadecimal
174
175 `--extraesc`
176
177 : For Code 128 only, as well as processing the normal escape sequences above, process the special escape sequences
178 `\^A`, `\^B`, `\^C` and `\^@` that allow manual switching of Code Sets, and the special escape sequence `\^1` that
179 inserts an `FNC1` character. The sequence `\@` turns off manual switching. The sequence `\^^` can be used to
180 encode data that contains special escape sequences.
181
182 `--fast`
183
184 : Use faster if less optimal encodation or other shortcuts (affects Data Matrix, MicroPDF417, PDF417, QRCODE & UPNQR
185 only).
186
187 `--fg=COLOUR`
188
189 : Specify a foreground (ink) colour where *COLOUR* is in hexadecimal `RRGGBB` or `RRGGBBAA` format or in decimal
190 `C,M,Y,K` percentages format.
191
192 `--filetype=TYPE`
193
194 : Set the output file type to *TYPE*, which is one of `BMP`, `EMF`, `EPS`, `GIF`, `PCX`, `PNG`, `SVG`, `TIF`, `TXT`.
195
196 `--fullmultibyte`
197
198 : Use the multibyte modes of Grid Matrix, Han Xin and QR Code for non-ASCII data.
199
200 `--gs1`
201
202 : Treat input as GS1 compatible data. Application Identifiers (AIs) should be placed in square brackets `"[]"` (but
203 see `--gs1parens`).
204
205 `--gs1nocheck`
206
207 : Do not check the validity of GS1 data.
208
209 `--gs1parens`
210
211 : Process parentheses `"()"` as GS1 AI delimiters, rather than square brackets `"[]"`. The input data must not
212 otherwise contain parentheses.
213
214 `--gssep`
215
216 : For Data Matrix in GS1 mode, use `GS` (0x1D) as the GS1 data separator instead of `FNC1`.
217
218 `--guarddescent=NUMBER`
219
220 : For EAN/UPC symbols, set the height the guard bars descend below the main bars, where *NUMBER* is in X-dimensions.
221 *NUMBER* may be floating-point.
222
223 `--guardwhitespace`
224
225 : For EAN/UPC symbols, add quiet zone indicators `"<"` and/or `">"` to HRT where applicable.
226
227 `--height=NUMBER`
228
229 : Set the height of the symbol in X-dimensions. *NUMBER* may be floating-point.
230
231 `--heightperrow`
232
233 : Treat height as per-row. Affects Codablock-F, Code 16K, Code 49, GS1 DataBar Expanded Stacked (DBAR_EXPSTK),
234 MicroPDF417 and PDF417.
235
236 `-i`, `--input=FILE`
237
238 : Read the input data from *FILE*. Specify a single hyphen (`-`) for *FILE* to read from stdin.
239
240 `--init`
241
242 : Create a Reader Initialisation (Programming) symbol.
243
244 `--mask=INTEGER`
245
246 : Set the masking pattern to use for DotCode, Han Xin or QR Code to *INTEGER*, overriding the automatic selection.
247
248 `--mirror`
249
250 : Use the batch data to determine the filename in batch mode (`--batch`). The `-o` | `--output` option can be used
251 to specify an output directory (any filename will be ignored).
252
253 `--mode=INTEGER`
254
255 : For MaxiCode and GS1 Composite symbols, set the encoding mode to *INTEGER*.
256
257 For MaxiCode (SCM is Structured Carrier Message, with 3 fields: postcode, 3-digit ISO 3166-1 country code, 3-digit
258 service code):
259
260 2 SCM with 9-digit numeric postcode
261 3 SCM with 6-character alphanumeric postcode
262 4 Enhanced ECC for the primary part of the message
263 5 Enhanced ECC for all of the message
264 6 Reader Initialisation (Programming)
265
266 For GS1 Composite symbols (names end in `_CC`, i.e. EANX_CC, GS1_128_CC, DBAR_OMN_CC etc.):
267
268 1 CC-A
269 2 CC-B
270 3 CC-C (GS1_128_CC only)
271
272 `--nobackground`
273
274 : Remove the background colour (EMF, EPS, GIF, PNG, SVG and TIF only).
275
276 `--noquietzones`
277
278 : Disable any quiet zones for symbols that define them by default.
279
280 `--notext`
281
282 : Remove the Human Readable Text (HRT).
283
284 `-o`, `--output=FILE`
285
286 : Send the output to *FILE*. When not in batch mode, the default is "out.png" (or "out.gif" if zint built without
287 PNG support). When in batch mode (`--batch`), special characters can be used to format the output filenames:
288
289 ~ Insert a number or 0
290 # Insert a number or space
291 @ Insert a number or * (+ on Windows)
292 Any other Insert literally
293
294 `--primary=STRING`
295
296 : For MaxiCode, set the content of the primary message. For GS1 Composite symbols, set the content of the linear
297 symbol.
298
299 `--quietzones`
300
301 : Add compliant quiet zones for symbols that specify them. This is in addition to any whitespace specified by `-w` |
302 `--whitesp` or `--vwhitesp`.
303
304 `-r`, `--reverse`
305
306 : Reverse the foreground and background colours (white on black). Known as "reflectance reversal" or "reversed
307 reflectance".
308
309 `--rotate=INTEGER`
310
311 : Rotate the symbol by *INTEGER* degrees, where *INTEGER* can be 0, 90, 270 or 360.
312
313 `--rows=INTEGER`
314
315 : Set the number of rows for Codablock-F or PDF417 to *INTEGER*. It will also set the minimum number of rows for
316 Code 16K or Code 49, and the maximum number of rows for GS1 DataBar Expanded Stacked (DBAR_EXPSTK).
317
318 `--scale=NUMBER`
319
320 : Adjust the size of the X-dimension. *NUMBER* may be floating-point, and is multiplied by 2 (except for MaxiCode)
321 before being applied. The default scale is 1.
322
323 For MaxiCode, the scale is multiplied by 10 for raster output, by 40 for EMF output, and by 2 otherwise.
324
325 Increments of 0.5 (half-integers) are recommended for non-MaxiCode raster output (BMP, GIF, PCX, PNG and TIF).
326
327 See also `--scalexdimdp` below.
328
329 `--scalexdimdp=X[,R]`
330
331 : Scale the image according to X-dimension *X* and resolution *R*, where *X* is in mm and *R* is in dpmm (dots per
332 mm). *X* and *R* may be floating-point. *R* is optional and defaults to 12 dpmm (approximately 300 dpi). *X* may
333 be zero in which case a symbology-specific default is used.
334
335 The scaling takes into account the output filetype, and deals with all the details mentioned above. Units may be
336 specified for *X* by appending "in" (inch) or "mm", and for *R* by appending "dpi" (dots per inch) or "dpmm" -
337 e.g. `--scalexdimdp=0.013in,300dpi`.
338
339 `--scmvv=INTEGER`
340
341 : For MaxiCode, prefix the Structured Carrier Message (SCM) with `"[)>\R01\Gvv"`, where `vv` is a 2-digit *INTEGER*.
342
343 `--secure=INTEGER`
344
345 : Set the error correction level (ECC) to *INTEGER*. The meaning is specific to the following matrix symbols (all
346 except PDF417 are approximate):
347
348 Aztec Code 1 to 4 (10%, 23%, 36%, 50%)
349 Grid Matrix 1 to 5 (10% to 50%)
350 Han Xin 1 to 4 (8%, 15%, 23%, 30%)
351 Micro QR 1 to 3 (7%, 15%, 25%) (L, M, Q)
352 PDF417 0 to 8 (2^(INTEGER + 1) codewords)
353 QR Code 1 to 4 (7%, 15%, 25%, 30%) (L, M, Q, H)
354 rMQR 2 or 4 (15% or 30%) (M or H)
355 Ultracode 1 to 6 (0%, 5%, 9%, 17%, 25%, 33%)
356
357 `--segN=ECI,DATA`
358
359 : Set the *ECI* & *DATA* content for segment N, where N is 1 to 9. `-d` | `--data` must still be given, and counts
360 as segment 0, its ECI given by `--eci`. Segments must be consecutive.
361
362 `--separator=INTEGER`
363
364 : Set the height of row separator bars for stacked symbologies, where *INTEGER* is in integral multiples of the
365 X-dimension. The default is zero.
366
367 `--small`
368
369 : Use a smaller font for Human Readable Text (HRT).
370
371 `--square`
372
373 : For Data Matrix symbols, exclude rectangular sizes when considering automatic sizes. See also `--dmre`.
374
375 `--structapp=I,C[,ID]`
376
377 : Set Structured Append info, where *I* is the 1-based index, *C* is the total number of symbols in the sequence,
378 and *ID*, which is optional, is the identifier that all symbols in the sequence share. Structured Append is
379 supported by Aztec Code, Code One, Data Matrix, DotCode, Grid Matrix, MaxiCode, MicroPDF417, PDF417, QR Code and
380 Ultracode.
381
382 `-t`, `--types`
383
384 : Display the table of barcode types (symbologies). The numbers or names can be used with `-b` | `--barcode`.
385
386 `--textgap=NUMBER`
387
388 : Adjust the gap between the barcode and the Human Readable Text (HRT). *NUMBER* is in X-dimensions, and may be
389 floating-point. Maximum is 10 and minimum is -5. The default is 1.
390
391 `--vers=INTEGER`
392
393 : Set the symbol version (size, check digits, other options) to *INTEGER*. The meaning is symbol-specific.
394
395 For most matrix symbols, it specifies size:
396
397 Aztec Code 1 to 36 (1 to 4 compact)
398 1 15x15 13 53x53 25 105x105
399 2 19x19 14 57x57 26 109x109
400 3 23x23 15 61x61 27 113x113
401 4 27x27 16 67x67 28 117x117
402 5 19x19 17 71x71 29 121x121
403 6 23x23 18 75x75 30 125x125
404 7 27x27 19 79x79 31 131x131
405 8 31x31 20 83x83 32 135x135
406 9 37x37 21 87x87 33 139x139
407 10 41x41 22 91x91 34 143x143
408 11 45x45 23 95x95 35 147x147
409 12 49x49 24 101x101 36 151x151
410
411 Code One 1 to 10 (9 and 10 variable width) (WxH)
412 1 16x18 6 70x76
413 2 22x22 7 104x98
414 3 28x28 8 148x134
415 4 40x42 9 Wx8
416 5 52x54 10 Wx16
417
418 Data Matrix 1 to 48 (31 to 48 DMRE) (HxW)
419 1 10x10 17 72x72 33 8x80
420 2 12x12 18 80x80 34 8x96
421 3 14x14 19 88x88 35 8x120
422 4 16x16 20 96x96 36 8x144
423 5 18x18 21 104x104 37 12x64
424 6 20x20 22 120x120 38 12x88
425 7 22x22 23 132x132 39 16x64
426 8 24x24 24 144x144 40 20x36
427 9 26x26 25 8x18 41 20x44
428 10 32x32 26 8x32 42 20x64
429 11 36x36 28 12x26 43 22x48
430 12 40x40 28 12x36 44 24x48
431 13 44x44 29 16x36 45 24x64
432 14 48x48 30 16x48 46 26x40
433 15 52x52 31 8x48 47 26x48
434 16 64x64 32 8x64 48 26x64
435
436 Grid Matrix 1 to 13
437 1 18x18 6 78x78 11 138x138
438 2 30x30 7 90x90 12 150x150
439 3 42x42 8 102x102 13 162x162
440 4 54x54 9 114x114
441 5 66x66 10 126x126
442
443 Han Xin 1 to 84
444 1 23x23 29 79x79 57 135x135
445 2 25x25 30 81x81 58 137x137
446 3 27x27 31 83x83 59 139x139
447 4 29x29 32 85x85 60 141x141
448 5 31x31 33 87x87 61 143x143
449 6 33x33 34 89x89 62 145x145
450 7 35x35 35 91x91 63 147x147
451 8 37x37 36 93x93 64 149x149
452 9 39x39 37 95x95 65 151x151
453 10 41x41 38 97x97 66 153x153
454 11 43x43 39 99x99 67 155x155
455 12 45x45 40 101x101 68 157x157
456 13 47x47 41 103x103 69 159x159
457 14 49x49 42 105x105 70 161x161
458 15 51x51 43 107x107 71 163x163
459 16 53x53 44 109x109 72 165x165
460 17 55x55 45 111x111 73 167x167
461 18 57x57 46 113x113 74 169x169
462 19 59x59 47 115x115 75 171x171
463 20 61x61 48 117x117 76 173x173
464 21 63x63 49 119x119 77 175x175
465 22 65x65 50 121x121 78 177x177
466 23 67x67 51 123x123 79 179x179
467 24 69x69 52 125x125 80 181x181
468 25 71x71 53 127x127 81 183x183
469 26 73x73 54 129x129 82 185x185
470 27 75x75 55 131x131 83 187x187
471 28 77x77 56 133x133 84 189x189
472
473 Micro QR 1 to 4 (M1, M2, M3, M4)
474 1 11x11 3 15x15
475 2 13x13 4 17x17
476
477 QR Code 1 to 40
478 1 21x21 15 77x77 29 133x133
479 2 25x25 16 81x81 30 137x137
480 3 29x29 17 85x85 31 141x141
481 4 33x33 18 89x89 32 145x145
482 5 37x37 19 93x93 33 149x149
483 6 41x41 20 97x97 34 153x153
484 7 45x45 21 101x101 35 157x157
485 8 49x49 22 105x105 36 161x161
486 9 53x53 23 109x109 37 165x165
487 10 57x57 24 113x113 38 169x169
488 11 61x61 25 117x117 39 173x173
489 12 65x65 26 121x121 40 177x177
490 13 69x69 27 125x125
491 14 73x73 28 129x129
492
493 rMQR 1 to 38 (33 to 38 automatic width) (HxW)
494 1 7x43 14 11x77 27 15x139
495 2 7x59 15 11x99 28 17x43
496 3 7x77 16 11x139 29 17x59
497 4 7x99 17 13x27 30 17x77
498 5 7x139 18 13x43 31 17x99
499 6 9x43 19 13x59 32 17x139
500 7 9x59 20 13x77 33 7xW
501 8 9x77 21 13x99 34 9xW
502 9 9x99 22 13x139 35 11xW
503 10 9x139 23 15x43 36 13xW
504 11 11x27 24 15x59 37 15xW
505 12 11x43 25 15x77 38 17xW
506 13 11x59 26 15x99
507
508 For a number of linear symbols, it specifies check character options ("hide" or "hidden" means don't show in HRT,
509 "visible" means do display in HRT):
510
511 C25IATA 1 or 2 (add visible or hidden check digit)
512 C25IND ditto
513 C25INTER ditto
514 C25LOGIC ditto
515 C25STANDARD ditto
516 Codabar 1 or 2 (add hidden or visible check digit)
517 Code 11 0 to 2 (2 visible check digits to none)
518 0 (default 2 visible check digits)
519 1 (1 visible check digit)
520 2 (no check digits)
521 Code 39 1 or 2 (add visible or hidden check digit)
522 Code 93 1 (hide the default check characters)
523 EXCODE39 1 or 2 (add visible or hidden check digit)
524 LOGMARS 1 or 2 (add visible or hidden check digit)
525 MSI Plessey 0 to 6 (none to various visible options)
526 1, 2 (mod-10, mod-10 + mod-10)
527 3, 4 (mod-11 IBM, mod-11 IBM + mod-10)
528 5, 6 (mod-11 NCR, mod-11 NCR + mod-10)
529 +10 (hide)
530
531 For a few other symbologies, it specifies other characteristics:
532
533 Channel Code 3 to 8 (no. of channels)
534 DAFT 50 to 900 (permille tracker ratio)
535 DPD 1 (relabel)
536 PZN 1 (PZN7 instead of default PZN8)
537 Ultracode 2 (revision 2)
538 VIN 1 (add international prefix)
539
540 `-v`, `--version`
541
542 : Display zint version.
543
544 `--vwhitesp=INTEGER`
545
546 : Set the height of vertical whitespace above and below the barcode, where *INTEGER* is in integral multiples of the
547 X-dimension.
548
549 `-w`, `--whitesp=INTEGER`
550
551 : Set the width of horizontal whitespace either side of the barcode, where *INTEGER* is in integral multiples of the
552 X-dimension.
553
554 `--werror`
555
556 : Convert all warnings into errors.
557
558 # EXIT STATUS
559
560 `0`
561 : Success (including when given informational options `-h` | `--help`, `-e` | `--ecinos`, `-t` | `--types`, `-v` |
562 `--version`).
563
564 `1`
565 : Human Readable Text was truncated (maximum 199 bytes) (`ZINT_WARN_HRT_TRUNCATED`)
566
567 `2`
568 : Invalid option given but overridden by Zint (`ZINT_WARN_INVALID_OPTION`)
569
570 `3`
571 : Automatic ECI inserted by Zint (`ZINT_WARN_USES_ECI`)
572
573 `4`
574 : Symbol created not compliant with standards (`ZINT_WARN_NONCOMPLIANT`)
575
576 `5`
577 : Input data wrong length (`ZINT_ERROR_TOO_LONG`)
578
579 `6`
580 : Input data incorrect (`ZINT_ERROR_INVALID_DATA`)
581
582 `7`
583 : Input check digit incorrect (`ZINT_ERROR_INVALID_CHECK`)
584
585 `8`
586 : Incorrect option given (`ZINT_ERROR_INVALID_OPTION`)
587
588 `9`
589 : Internal error (should not happen) (`ZINT_ERROR_ENCODING_PROBLEM`)
590
591 `10`
592 : Error opening output file (`ZINT_ERROR_FILE_ACCESS`)
593
594 `11`
595 : Memory allocation (malloc) failure (`ZINT_ERROR_MEMORY`)
596
597 `12`
598 : Error writing to output file (`ZINT_ERROR_FILE_WRITE`)
599
600 `13`
601 : Error counterpart of warning if `--werror` given (`ZINT_ERROR_USES_ECI`)
602
603 `14`
604 : Error counterpart of warning if `--werror` given (`ZINT_ERROR_NONCOMPLIANT`)
605
606 `15`
607 : Error counterpart of warning if `--werror` given (`ZINT_ERROR_HRT_TRUNCATED`)
608
609 # EXAMPLES
610
611 Create "out.png" (or "out.gif" if zint built without PNG support) in the current directory, as a Code 128 symbol.
612
613 ```bash
614 zint -d 'This Text'
615 ```
616
617 Create "qr.svg" in the current directory, as a QR Code symbol.
618
619 ```bash
620 zint -b QRCode -d 'This Text' -o 'qr.svg'
621 ```
622
623 Use batch mode to read from an input file "ean13nos.txt" containing a list of 13-digit GTINs, each on a separate line,
624 to create a series of EAN-13 barcodes, formatting the output filenames to "ean001.gif", "ean002.gif" etc. using the
625 special character "~".
626
627 ```bash
628 zint -b EANX --batch -i 'ean13nos.txt' -o 'ean~~~.gif'
629 ```
630
631 # BUGS
632
633 Please send bug reports to https://sourceforge.net/p/zint/tickets/.
634
635 # SEE ALSO
636
637 Full documention for `zint` (and the API `libzint` and the GUI `zint-qt`) is available from
638
639 https://zint.org.uk/manual/
640
641 and at
642
643 https://sourceforge.net/p/zint/docs/manual.txt
644
645 # CONFORMING TO
646
647 Zint is designed to be compliant with a number of international standards, including:
648
649 ISO/IEC 24778:2008, ANSI/AIM BC12-1998, EN 798:1996,
650 AIM ISS-X-24 (1995), ISO/IEC 15417:2007, EN 12323:2005,
651 ISO/IEC 16388:2007, ANSI/AIM BC6-2000, ANSI/AIM BC5-1995,
652 AIM USS Code One (1994), ISO/IEC 16022:2006, ISO/IEC 21471:2019,
653 ISO/IEC 15420:2009, AIMD014 (v 1.63) (2008), ISO/IEC 24723:2010,
654 ISO/IEC 24724:2011, ISO/IEC 20830:2021, ISO/IEC 16390:2007,
655 ISO/IEC 16023:2000, ISO/IEC 24728:2006, ISO/IEC 15438:2015,
656 ISO/IEC 18004:2015, ISO/IEC 23941:2022, AIM ITS/04-023 (2022)
657
658 # COPYRIGHT
659
660 Copyright © 2024 Robin Stuart. Released under GNU GPL 3.0 or later.
661
662 # AUTHOR
663
664 Robin Stuart <robin@zint.org.uk>