1zint(1) General Commands Manual zint(1)
2
3
4
6 zint - Encode data as a barcode image.
7
9 zint [ OPTIONS ] [ -d DATA ]
10
12 zint takes input data from file or directly from the user to encode in
13 a barcode which is then output in a specified image file.
14
15 This manpage is a guide to the options available from the zint command
16 line interface only.
17
19 General Information
20 -h, --help
21 Print usage information summerising command line options.
22
23 -t, --types
24 List symbol types and codes supported.
25
26 Input Control
27 -i, --input=FILE
28 Obtain data from FILE (assumes UTF-8 encoding by default). Use a
29 single hyphen (-) to capture from standard input.
30
31 -d, --data=DATA
32 Process literal data given by DATA (assumes UTF-8 encoding by
33 default).
34
35 --gs1 Treat input data as GS1 encoded data with square brackets delim‐
36 iting Application Indicators.
37
38 --data Treat input data literally. In most cases this assumes that
39 input data is Latin-1 formatted.
40
41 General Processing Options
42 -b, --barcode=BARCODE
43 Set the barcode standard which will be used to encode the data.
44 BARCODE is a numerical representation as shown by the -t option.
45
46 --secure=NUMBER
47 Set the error correction level for the barcode symbol.
48
49 --vers=NUMBER
50 Use version NUMBER for creating QR Code symbols.
51
52 --primary=STRING
53 Set the primary message for Maxicode symbols or the main body
54 data for composite symbols.
55
56 --mode=NUMBER
57 Set the encoding mode for Maxicode and composite symbols.
58
59 --init Add reader initialisation (FNC3) characters to Code 128 symbols.
60
61 Direct output data
62 -o, --output=FILE
63 Write output image to FILE Image type is determined by file
64 extension (.png, .svg or .eps).
65
66 --directpng
67 Send output to standard output as a portable network graphic
68 (PNG) image.
69
70 --directeps
71 Send output to standard output as an encapsulated postscript
72 (EPS) image.
73
74 --directsvg
75 Send output to standard output as a scalable vector graphic
76 (SVG) image.
77
78 --dump Output a textual representation of the generated image instead
79 of outputting to file.
80
81 Adjust output image
82 --height=HEIGHT
83 Set height of adjustable height symbols to HEIGHT times of the
84 x-dimension of the symbol.
85
86 -w, --whitesp=NUMBER
87 Set the whitesapce (to the side of the symbol) to NUMBER times
88 the x-dimension of the symbol.
89
90 --border=NUMBER
91 Set the border width (on all sides of the symbol) to NUMBER
92 times the x-dimension of the symbol.
93
94 --box Add a boundary box (in foreground colour) around the symbol.
95
96 --bind Add boundary bars (in foreground colour) to the top and bottom
97 of the symbol.
98
99 -r, --reverse
100 Set colours to generate a white symbol on a black background.
101
102 --fg=COLOUR
103 Set the foreground (ink) colour. Input is given in six digit
104 RRGGBB hexadecimal format.
105
106 --bg=COLOUR
107 Set the background (paper) colour. Input is given in six digit
108 RRGGBB hexadecimal format.
109
110 --scale=NUMBER
111 Increase the size of the output image to NUMBER times the
112 default width/height.
113
114 --rotate=NUMBER
115 Rotate a PNG image by NUMBER degrees clockwise. Valid values are
116 0, 90, 180 and 270.
117
118 --cols=NUMBER
119 Set the number of columns of data, and hence the width, of cer‐
120 tain types of symbol such as PDF417.
121
122 --notext
123 Override the default settings and supress inclusion of human
124 readable text in the generated image.
125
126 --square
127 Force Data Marix symbols to use square shaped symbols.
128
130 When entering data using the -d option the following escape characters
131 can be used:
132
133 \0 - Null
134
135 \E - End of Transmission
136
137 \a - Bell
138
139 \b - Backspace
140
141 \t - Horizontal Tab
142
143 \n - Line Feed
144
145 \v - Vertical Tab
146
147 \f - Form Feed
148
149 \r - Carriage Return
150
151 \e - Escape
152
153 \G - Group Separator
154
155 \R - Record Separator
156
157 Input which requires GS-1 formatting should use square brackets to sep‐
158 arate Application Identifiers from the data. For example:
159
160 [01]12345678901234[99]ABCDE
161
163 Please send bug reports to < zint-barcode@lists.sourceforge.net >
164 rather than the project author so that they can be tracked properly.
165
167 Full documentation for zint and libzint are available from
168 http://www.zint.org.uk
169
171 Robin Stuart <robin@zint.org.uk>
172
173
174
175version 2.4.1 08 Oct 2010 zint(1)