zint - Man Page
Encode data as a barcode image.
Synopsis
Description
zint takes input data from file or directly from the user to encode in a barcode which is then output in a specified image file.
This manpage is a guide to the options available from the zint command line interface only.
Options
General Information
- -h, --help
Print usage information summerising command line options.
- -t, --types
List symbol types and codes supported.
Input Control
- -i, --input=FILE
Obtain data from FILE (assumes UTF-8 encoding by default). Use a single hyphen (-) to capture from standard input.
- -d, --data=DATA
Process literal data given by DATA (assumes UTF-8 encoding by default).
- --gs1
Treat input data as GS1 encoded data with square brackets delimiting Application Indicators.
- --data
Treat input data literally. In most cases this assumes that input data is Latin-1 formatted.
General Processing Options
- -b, --barcode=BARCODE
Set the barcode standard which will be used to encode the data. BARCODE is a numerical representation as shown by the -t option.
- --secure=NUMBER
Set the error correction level for the barcode symbol.
- --vers=NUMBER
Use version NUMBER for creating QR Code symbols.
- --primary=STRING
Set the primary message for Maxicode symbols or the main body data for composite symbols.
- --mode=NUMBER
Set the encoding mode for Maxicode and composite symbols.
- --init
Add reader initialisation (FNC3) characters to Code 128 symbols.
Direct output data
- -o, --output=FILE
Write output image to FILE Image type is determined by file extension (.png, .svg or .eps).
- --directpng
Send output to standard output as a portable network graphic (PNG) image.
- --directeps
Send output to standard output as an encapsulated postscript (EPS) image.
- --directsvg
Send output to standard output as a scalable vector graphic (SVG) image.
- --dump
Output a textual representation of the generated image instead of outputting to file.
Adjust output image
- --height=HEIGHT
Set height of adjustable height symbols to HEIGHT times of the x-dimension of the symbol.
- -w, --whitesp=NUMBER
Set the whitesapce (to the side of the symbol) to NUMBER times the x-dimension of the symbol.
- --border=NUMBER
Set the border width (on all sides of the symbol) to NUMBER times the x-dimension of the symbol.
- --box
Add a boundary box (in foreground colour) around the symbol.
- --bind
Add boundary bars (in foreground colour) to the top and bottom of the symbol.
- -r, --reverse
Set colours to generate a white symbol on a black background.
- --fg=COLOUR
Set the foreground (ink) colour. Input is given in six digit RRGGBB hexadecimal format.
- --bg=COLOUR
Set the background (paper) colour. Input is given in six digit RRGGBB hexadecimal format.
- --scale=NUMBER
Increase the size of the output image to NUMBER times the default width/height.
- --rotate=NUMBER
Rotate a PNG image by NUMBER degrees clockwise. Valid values are 0, 90, 180 and 270.
- --cols=NUMBER
Set the number of columns of data, and hence the width, of certain types of symbol such as PDF417.
- --notext
Override the default settings and supress inclusion of human readable text in the generated image.
- --square
Force Data Marix symbols to use square shaped symbols.
Input Formatting
When entering data using the -d option the following escape characters can be used:
\0 - Null
\E - End of Transmission
\a - Bell
\b - Backspace
\t - Horizontal Tab
\n - Line Feed
\v - Vertical Tab
\f - Form Feed
\r - Carriage Return
\e - Escape
\G - Group Separator
\R - Record Separator
Input which requires GS-1 formatting should use square brackets to separate Application Identifiers from the data. For example:
[01]12345678901234[99]ABCDE
Bugs
Please send bug reports to < zint-barcode@lists.sourceforge.net > rather than the project author so that they can be tracked properly.
See Also
Full documentation for zint and libzint are available from http://www.zint.org.uk
Author
Robin Stuart <robin@zint.org.uk>