zint man page

zint ā€” Encode data as a barcode image.

Synopsis

zint [ Options ] [ -d DATA ]

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>

Info

08 Oct 2010 version 2.4.1