(fossil repository) or http://sourceforge.net/projects/tclsnippets/files/tzint/ for precompiled binaries, source, ... This package is licensed unter BSD-3.The package has TEA Tcl Extension Architecture and has been tested under AIX, Linux, Mac OS X and Windows XP - 7.
NAME edit
tzint - tcl package for libzint barcode encoding librarySYNOPSIS edit
- package require tzint ?1.0?
- tzint::Encode version
- tzint::Encode symbologies
- tzint::Encode bits | eps | svg | xbm varName data ?-option value ...?
- tzint::RcsId
DESCRIPTION edit
A barcode encoding library supporting over 50 symbologies including Code 128, Data Matrix, USPS OneCode, EAN-128, UPC/EAN, ITF, QR Code, Code 16k, PDF417, MicroPDF417, LOGMARS, Maxicode, GS1 DataBar, Aztec, Composite Symbols and more. No Tk needed!Performs one of several barcode encoding operations, depending on option. The legal commands and options (which may be abbreviated) are:| version | command returns the version of underlaying libzint. |
| symbologies | command returns a list of symbology names that can be encoded. |
| bits | eps | svg | xbm | command encodes a barcode into varName. |
The width of the boundary or box can be specified using the -border integer switch.The default colours of a symbol are a black symbol on a white background. tzint allows you to change this. For more specific needs the foreground and background colours can be specified using the -foreground or -fg or -background or -bg options followed by a number in RGB hexadecimal notation (the same system used in HTML).The symbol can be rotated through four orientations using the -rotate option followed by the angle 0 | 90 | 180 | 270 of rotation.The scale of the image can be altered using the -scale integer option followed by a multiple of the default x-dimension.Input modes
GS1 data can be encoded in a number of symbologies. Application identifiers are enclosed in [square brackets] followed by the data to be encoded. To encode GS1 data use '-format gs1. GS1 mode is assumed (and doesn't need to be set) for EAN-128, DataBar and Composite symbologies but is also available for Code 16k, Data Matrix (ECC 200 only), Aztec Code and QR Code.
QR Code, Micro QR Code and Grid Matrix standards can encode Kanji characters. These can be given in Unicode -format unicode (default) format as part of the input data string. Conversion from Unicode to Shift- JIS or GB 2312 as appropriate is handled by tzint.
If the input data is not Unicode encoded or should be interpreted as an 8-bit data stream then the -format binary option can be used to achieve this.Barcode specific options:
| -cols | integer | number of columns PDF417 (same as -opt2) |
| -vers | integer | option QR Code and Plessy (same as -opt2) |
| -security | integer | error correction level PDF417 and QR Code (same as -opt1) |
| -mode | integer | tructured primary data mode Maxicode and Composite (same as -opt1) |
| -primary | text | structured primary data Maxicode and Composite |
| -notext | boolean | no interpretation line |
| -square | boolean | force DataMatrix symbols to be square (same as -opt3) |
| -init | boolean | create reader initialisation symbol Code128 and DataMatrix |
| -smalltext | boolean | tiny interpretation line font |
| -opt1 | integer | see zint manual |
| -opt2 | integer | see zint manual |
| -opt3 | integer | see zint manual |
Based on Plessey and developed by MSE Data Corporation, MSI Plessey is available with a range of check digit options available by using the -vers integer' option. Any length numeric (digits 0-9) input can be encoded. The table below shows the options available:
| Value | Check Digits |
|---|---|
| 0 | None |
| 1 | Modulo-10 |
| 2 | Modulo-10 & Modulo-10 |
| 3 | Modulo-11 |
| 4 | Modulo-11 & Modulo-10 |
Standard Code 39 was developed in 1974 by Intermec. Input data can be of any length and supports the characters 0-9, A- Z, dash (-), full stop (.), space, asterisk (*), dollar ($), slash (/), plus (+) and percent (%). The standard does not require a check digit but a modulo-43 check digit can be added if required by using '-vers 1.Extended Code 39
Also known as Code 39e and Code39+, this symbology expands on Standard Code 39 to provide support to the full ASCII character set. The standard does not require a check digit but a modulo-43 check digit can be added if required by using -vers 1.GS1 DataBar (ISO 24724)
Also known as RSS (Reduced Spaced Symbology) these symbols are due to replace GS1-128 symbols starting in 2010 in accordance with the GS1 General Specification. If a GS1 DataBar symbol is to be printed with a 2D component as specified in ISO 24723 set option -mode 2 at the command prompt.PDF417 (ISO 15438)
Heavily used in the parcel industry, the PDF417 symbology can encode a vast amount of data into a small space. tzint supports encoding up to the ISO standard maximum symbol size of 925 codewords which (at error correction level 0) allows a maximum data size of 1850 text characters, or 2710 digits. The width of the generated PDF417 symbol can be specified at the command line using the -cols switch followed by a number between 1 and 30, and the amount of check digit information can be specified by using the '-security switch followed by a number between 0 and 8 where the number of codewords used for check information is determined by 2(value + 1). The default level of check information is determined by the amount of data being encoded. International text support is provided using the Latin-1 character set as described in Appendix A. A separate symbology ID can be used to encode Health Industry Barcode (HIBC) data which adds a leading '+' character and a modulo-49 check digit to the encoded data.Channel Code
A highly compressed symbol for numeric data. The number of channels in the symbol can be between 3 and 8 and this can be specified by setting the value of -vers. It can also be determined by the length of the input data e.g. a three character input string generates a 4 channel code by default.
The maximum values permitted depend on the number of channels used as shown in the table below:
| Channels | Minimum Value | Maximum Value |
|---|---|---|
| 3 | 00 | 26 |
| 4 | 000 | 292 |
| 5 | 0000 | 3493 |
| 6 | 00000 | 44072 |
| 7 | 000000 | 576688 |
| 8 | 0000000 | 7742862 |
Also known as Quick Response Code this symbology was developed by Denso. Four levels of error correction are available using the -security option as shown in the following table.
| Input | ECC Level Error | Correction Capacity | Recovery Capacity |
|---|---|---|---|
| 1 | L (default) | Approx 20% of symbol | Approx 7% |
| 2 | M | Approx 37% of symbol | Approx 15% |
| 3 | Q | Approx 55% of symbol | Approx 25% |
| 4 | H | Approx 65% of symbol | Approx 30% |
The maximum capacity for a (version 40) QR Code symbol is 7089 numeric digits, 4296 alphanumeric characters or 2953 bytes of data. QR Code symbols can also be used to encode GS1 data. QR Code symbols can encode characters in the Latin-1 set and Kanji characters which are members of the Shift-JIS encoding scheme. Input should be entered as a UTF-8 stream with conversion to Shift-JIS being carried out automatically by tzint. A separate symbology ID can be used to encode Health Industry Barcode (HIBC) data which adds a leading '+' character and a modulo-49 check digit to the encoded data.GS1 DataBar Expanded Stacked (ISO 24724)
A stacked variation of the GS1 DataBar Expanded symbol for smaller packages. In addition the width of the symbol can be altered using the -cols option. In this case the number of columns relates to the number of character pairs on each row of the symbol. For symbols with a 2D component the number of columns must be at least 2. This symbol can be generated with a two-dimensional component to make a composite symbol.Composite Symbols (ISO 24723)
Composite symbols employ a mixture of components to give more comprehensive information about a product. The permissible contents of a composite symbol is determined by the terms of the GS1 General Specification. Composite symbols consist of a linear component which can be an EAN, UPC, GS1-128 or GS1 DataBar symbol, a 2D component which is based on PDF417 or MicroPDF417, and a separator pattern. The type of linear component to be used is determined using the -symbology option as with other encoding methods.
Valid values are: eanx_cc, ean128_cc, rss14_cc, rss_ltd_cc, rss_exp_cc, upca_cc, upce_cc, rss14stack_cc, rss14_omni_cc and rss_expstack_cc.
The data to be encoded in the linear component of a composite symbol should be entered into a primary string with the data for the 2D component being entered in the normal way (see exmpample below).
EXAMPLE edit
Encode a QR Code with data "Abc12":% package require tzint
% tzint::Encode xbm myXbmVal {Abc12} -symbol qr -stat myStatVal
0myStatVal will be:
zint 2.4.4 error {} rows 21 columns 21 width 42 height 42myXbmVal will be:
#define symbol_width 42
#define symbol_height 42
static unsigned char symbol_bits[] = {
0xff, 0x3f, 0xcc, 0xf3, 0xff, 0x03,
0xff, 0x3f, 0xcc, 0xf3, 0xff, 0x03,
0x03, 0x30, 0xfc, 0x30, 0x00, 0x03,
0x03, 0x30, 0xfc, 0x30, 0x00, 0x03,
0xf3, 0x33, 0xcf, 0x33, 0x3f, 0x03,
0xf3, 0x33, 0xcf, 0x33, 0x3f, 0x03,
0xf3, 0x33, 0xcc, 0x30, 0x3f, 0x03,
0xf3, 0x33, 0xcc, 0x30, 0x3f, 0x03,
0xf3, 0x33, 0x30, 0x33, 0x3f, 0x03,
0xf3, 0x33, 0x30, 0x33, 0x3f, 0x03,
0x03, 0x30, 0x00, 0x33, 0x00, 0x03,
0x03, 0x30, 0x00, 0x33, 0x00, 0x03,
0xff, 0x3f, 0x33, 0xf3, 0xff, 0x03,
0xff, 0x3f, 0x33, 0xf3, 0xff, 0x03,
0x00, 0x00, 0xcf, 0x03, 0x00, 0x00,
0x00, 0x00, 0xcf, 0x03, 0x00, 0x00,
0x3f, 0xff, 0xff, 0x3c, 0x30, 0x00,
0x3f, 0xff, 0xff, 0x3c, 0x30, 0x00,
0x3c, 0x0f, 0x03, 0x30, 0xcc, 0x03,
0x3c, 0x0f, 0x03, 0x30, 0xcc, 0x03,
0x03, 0xff, 0x30, 0x03, 0xc3, 0x03,
0x03, 0xff, 0x30, 0x03, 0xc3, 0x03,
0x0c, 0x0f, 0x3f, 0x30, 0x00, 0x00,
0x0c, 0x0f, 0x3f, 0x30, 0x00, 0x00,
0xc0, 0xfc, 0x30, 0x33, 0x03, 0x03,
0xc0, 0xfc, 0x30, 0x33, 0x03, 0x03,
0x00, 0x00, 0xcf, 0xcc, 0xcc, 0x00,
0x00, 0x00, 0xcf, 0xcc, 0xcc, 0x00,
0xff, 0x3f, 0xc3, 0xfc, 0xcc, 0x03,
0xff, 0x3f, 0xc3, 0xfc, 0xcc, 0x03,
0x03, 0x30, 0xcf, 0xcf, 0x0f, 0x00,
0x03, 0x30, 0xcf, 0xcf, 0x0f, 0x00,
0xf3, 0x33, 0xc3, 0xfc, 0xcc, 0x03,
0xf3, 0x33, 0xc3, 0xfc, 0xcc, 0x03,
0xf3, 0x33, 0x0c, 0xf0, 0xcc, 0x00,
0xf3, 0x33, 0x0c, 0xf0, 0xcc, 0x00,
0xf3, 0x33, 0x0f, 0x03, 0x3f, 0x03,
0xf3, 0x33, 0x0f, 0x03, 0x3f, 0x03,
0x03, 0x30, 0x0f, 0xf0, 0xcf, 0x00,
0x03, 0x30, 0x0f, 0xf0, 0xcf, 0x00,
0xff, 0x3f, 0x33, 0x33, 0xcf, 0x03,
0xff, 0x3f, 0x33, 0x33, 0xcf, 0x03
}The data to be encoded in the linear component of a composite symbol should be entered into a primary string with the data for the 2D component being entered in the normal way. To do this use the --primary option. For example:
% package require tzint
% tzint::Encode xbm myXbmVal {[99]1234-abcd} -symbol eanx-cc -mode 1 -primary {331234567890}
0SEE ALSO edit
http://sourceforge.net/projects/zint/ https://github.com/zint/zint-downloads-sourceforge-archive/blob/master/zint_manual_242.pdf
WEB: BAWT Build Automation With Tcl / Batteries included [1]
LEGAL NOTICE edit
Copyright (C) 2014 Alexander Schoepe, DE and Joerg Mehring, DECopyright (C) 2009 Robin Stuartopen source barcode library libzint (backend license BSD-3; see ZINT mailing list of May 2013 for related mails)
