mirrors/zint-barcode-generator
1
0
Fork 0
mirror of https://git.code.sf.net/p/zint/code synced 2025-05-29 22:35:27 -04:00
Code Issues Projects Releases Packages Wiki Activity

Initial revision

Browse source
This commit is contained in:
factor 2008-07-13 21:15:55 +00:00
commit 52aa6fdb27
99 changed files with 24846 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

1125
docs/appxa.html Normal file
View file

File diff suppressed because it is too large Load diff

316
docs/appxb.html Normal file
View file

@ -0,0 +1,316 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Three Digit Country Codes</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20070829;23503500">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="appxa.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="appxc.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>B. Three Digit Country Codes (ISO 3166)</H1>
<P>Below are some of the three digit country codes as determined by
ISO 3166 for use with Maxicode symbols.</P>
<PRE>
AFGHANISTAN 004
ALAND ISLANDS 248
ALBANIA 008
ALGERIA 012
AMERICAN SAMOA 016
ANDORRA 020
ANGOLA 024
ANGUILLA 660
ANTARCTICA 010
ANTIGUA AND BARBUDA 028
ARGENTINA 032
ARMENIA 051
ARUBA 533
AUSTRALIA 036
AUSTRIA 040
AZERBAIJAN 031
BAHAMAS 044
BAHRAIN 048
BANGLADESH 050
BARBADOS 052
BELARUS 112
BELGIUM 056
BELIZE 084
BENIN 204
BERMUDA 060
BHUTAN 064
BOLIVIA 068
BOSNIA AND HERZEGOVINA 070
BOTSWANA 072
BOUVET ISLAND 074
BRAZIL 076
BRITISH INDIAN OCEAN TERRITORY 086
BRUNEI DARUSSALAM 096
BULGARIA 100
BURKINA FASO 854
BURUNDI 108
CAMBODIA 116
CAMEROON 120
CANADA 124
CAPE VERDE 132
CAYMAN ISLANDS 136
CENTRAL AFRICAN REPUBLIC 140
CHAD 148
CHILE 152
CHINA 156
CHRISTMAS ISLAND 162
COCOS (KEELING) ISLANDS 166
COLOMBIA 170
COMOROS 174
CONGO 178
CONGO, THE DEMOCRATIC REPUBLIC OF THE 180
COOK ISLANDS 184
COSTA RICA 188
COTE D'IVOIRE 384
CROATIA 191
CUBA 192
CYPRUS 196
CZECH REPUBLIC 203
DENMARK 208
DJIBOUTI 262
DOMINICA 212
DOMINICAN REPUBLIC 214
ECUADOR 218
EGYPT 818
EL SALVADOR 222
EQUATORIAL GUINEA 226
ERITREA 232
ESTONIA 233
ETHIOPIA 231
FALKLAND ISLANDS (MALVINAS) 238
FAROE ISLANDS 234
FIJI 242
FINLAND 246
FRANCE 250
FRENCH GUIANA 254
FRENCH POLYNESIA 258
FRENCH SOUTHERN TERRITORIES 260
GABON 266
GAMBIA 270
GEORGIA 268
GERMANY 276
GHANA 288
GIBRALTAR 292
GREECE 300
GREENLAND 304
GRENADA 308
GUADELOUPE 312
GUAM 316
GUATEMALA 320
GUERNSEY 831
GUINEA 324
GUINEA-BISSAU 624
GUYANA 328
HAITI 332
HEARD ISLAND AND MCDONALD ISLANDS 334
HOLY SEE (VATICAN CITY STATE) 336
HONDURAS 340
HONG KONG 344
HUNGARY 348
ICELAND 352
INDIA 356
INDONESIA 360
IRAN (ISLAMIC REPUBLIC OF) 364
IRAQ 368
IRELAND 372
ISLE OF MAN 833
ISRAEL 376
ITALY 380
JAMAICA 388
JAPAN 392
JERSEY 832
JORDAN 400
KAZAKHSTAN 398
KENYA 404
KIRIBATI 296
KOREA, DEMOCRATIC PEOPLE'S REPUBLIC OF 408
KOREA, REPUBLIC OF 410
KUWAIT 414
KYRGYZSTAN 417
LAO PEOPLE'S DEMOCRATIC REPUBLIC 418
LATVIA 428
LEBANON 422
LESOTHO 426
LIBERIA 430
LIBYAN ARAB JAMAHIRIYA 434
LIECHTENSTEIN 438
LITHUANIA 440
LUXEMBOURG 442
MACAO 446
MACEDONIA, THE FORMER YUGOSLAV REPUBLIC OF 807
MADAGASCAR 450
MALAWI 454
MALAYSIA 458
MALDIVES 462
MALI 466
MALTA 470
MARSHALL ISLANDS 584
MARTINIQUE 474
MAURITANIA 478
MAURITIUS 480
MAYOTTE 175
MEXICO 484
MICRONESIA, FEDERATED STATES OF 583
MOLDOVA, REPUBLIC OF 498
MONACO 492
MONGOLIA 496
MONTENEGRO 499
MONTSERRAT 500
MOROCCO 504
MOZAMBIQUE 508
MYANMAR 104
NAMIBIA 516
NAURU 520
NEPAL 524
NETHERLANDS 528
NETHERLANDS ANTILLES 530
NEW CALEDONIA 540
NEW ZEALAND 554
NICARAGUA 558
NIGER 562
NIGERIA 566
NIUE 570
NORFOLK ISLAND 574
NORTHERN MARIANA ISLANDS 580
NORWAY 578
OMAN 512
PAKISTAN 586
PALAU 585
PALESTINIAN TERRITORY, OCCUPIED 275
PANAMA 591
PAPUA NEW GUINEA 598
PARAGUAY 600
PERU 604
PHILIPPINES 608
PITCAIRN 612
POLAND 616
PORTUGAL 620
PUERTO RICO 630
QATAR 634
REUNION 638
ROMANIA 642
RUSSIAN FEDERATION 643
RWANDA 646
SAINT HELENA 654
SAINT KITTS AND NEVIS 659
SAINT LUCIA 662
SAINT PIERRE AND MIQUELON 666
SAINT VINCENT AND THE GRENADINES 670
SAMOA 882
SAN MARINO 674
SAO TOME AND PRINCIPE 678
SAUDI ARABIA 682
SENEGAL 686
SERBIA 688
SEYCHELLES 690
SIERRA LEONE 694
SINGAPORE 702
SLOVAKIA 703
SLOVENIA 705
SOLOMON ISLANDS 090
SOMALIA 706
SOUTH AFRICA 710
SOUTH GEORGIA AND THE SOUTH SANDWICH ISLANDS 239
SPAIN 724
SRI LANKA 144
SUDAN 736
SURINAME 740
SVALBARD AND JAN MAYEN 744
ST. HELENA 654
ST. PIERRE AND MIQUELON 666
SWAZILAND 748
SWEDEN 752
SWITZERLAND 756
SYRIAN ARAB REPUBLIC 760
TAIWAN, PROVINCE OF CHINA 158
TAJIKISTAN 762
TANZANIA, UNITED REPUBLIC OF 834
THAILAND 764
TIMOR-LESTE 626
TOGO 768
TOKELAU 772
TONGA 776
TRINIDAD AND TOBAGO 780
TUNISIA 788
TURKEY 792
TURKMENISTAN 795
TURKS AND CAICOS ISLANDS 796
TUVALU 798
UGANDA 800
UKRAINE 804
UNITED ARAB EMIRATES 784
UNITED KINGDOM 826
UNITED STATES 840
UNITED STATES MINOR OUTLYING ISLANDS 581
URUGUAY 858
UZBEKISTAN 860
VANUATU 548
VATICAN CITY STATE (HOLY SEE) 336
VENEZUELA 862
VIET NAM 704
VIRGIN ISLANDS (BRITISH) 092
VIRGIN ISLANDS (U.S.) 850
WALLIS AND FUTUNA 876
WESTERN SAHARA 732
YEMEN 887
YUGOSLAVIA 891
ZAMBIA 894
ZIMBABWE 716</PRE>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="appxa.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="appxc.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Appendix A</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Appendix C</P>
</TD>
</TR>
</TABLE>
</BODY>
</HTML>

382
docs/appxc.html Normal file
View file

@ -0,0 +1,382 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>GS1 General Specification</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080309;20283900">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
PRE { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="appxb.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%></TD>
</TR>
</TABLE>
<HR>
<H1>C. GS1 General Specification</H1>
<P>The GS1 General Specification defines a global standard for
encoding data about products. The full specification is available
<A HREF="http://www.gs1uk.org/EANUCC/WORD_Files/word.html">here</A>.
Data is encoded as a series of number pairs where the first number,
usually shown in (brackets) is an application identifier (AI), and
the second is a formatted representation of the data. For example
(401)6773 can be read as &quot;Consignment Number 6773&quot; where
the AI (401) signifies that the data is a consignment number. Note
that when using Zint AI data is entered using [square] brackets. This
allows rounded brackets to be included in the data which is allowed
by the specification. When the barcode symbol is generated these
square brackets are replaced by rounded brackets in the text. A list
of valid AI numbers is given below.</P>
<P><A NAME="AI"></A><FONT SIZE=4><B>C.1 Application Identifiers [1]</B></FONT></P>
<PRE>00 Serial Shipping Container Code (SSCC)
01 Global Trade Item Number (GTIN)
02 # of containers
10 Batch Number
11 Production Date
13 Packaging Date
15 Sell by Date (Quality Control)
17 Expiration Date
20 Product Variant
21 Serial Number
22 HIBCC Quantity, Date, Batch and Link
23x Lot Number
240 Additional Product Identification
250 Second Serial Number
30 Quantity Each
310y Product Net Weight in kg
311y Product Length/1st Dimension, in meters
312y Product Width/Diameter/2nd Dimension, in meters
313y Product Depth/Thickness/3rd Dimension, in meters
314y Product Area, in square meters
315y Product Volume, in liters
316y product Volume, in cubic meters
320y Product Net Weight, in pounds
321y Product Length/1st Dimension, in inches
322y Product Length/1st Dimension, in feet
323y Product Length/1st Dimension, in yards
324y Product Width/Diameter/2nd Dimension, in inches
325y Product Width/Diameter/2nd Dimension, in feet
326y Product Width/Diameter/2nd Dimension, in yards
327y Product Depth/Thickness/3rd Dimension, in inches
328y Product Depth/Thickness/3rd Dimension, in feet
329y Product Depth/Thickness/3rd Dimension, in yards
330y Container Gross Weight (kg)
331y Container Length/1st Dimension (Meters)
332y Container Width/Diameter/2nd Dimension (Meters)
333y Container Depth/Thickness/3rd Dimension (Meters)
334y Container Area (Square Meters)
335y Container Gross Volume (Liters)
336y Container Gross Volume (Cubic Meters)
340y Container Gross Weight (Pounds)
341y Container Length/1st Dimension, in inches
342y Container Length/1st Dimension, in feet
343y Container Length/1st Dimension in, in yards
344y Container Width/Diameter/2nd Dimension, in inches
345y Container Width/Diameter/2nd Dimension, in feet
346y Container Width/Diameter/2nd Dimension, in yards
347y Container Depth/Thickness/Height/3rd Dimension, in inches
348y Container Depth/Thickness/Height/3rd Dimension, in feet
349y Container Depth/Thickness/Height/3rd Dimension, in yards
350y Product Area (Square Inches)
351y Product Area (Square Feet)
352y Product Area (Square Yards)
353y Container Area (Square Inches)
354y Container Area (Square Feet)
355y Container Area (Suqare Yards)
356y Net Weight (Troy Ounces)
360y Product Volume (Quarts)
361y Product Volume (Gallons)
362y Container Gross Volume (Quarts)
363y Container Gross Volume (Gallons)
364y Product Volume (Cubic Inches)
365y Product Volume (Cubic Feet)
366y Product Volume (Cubic Yards)
367y Container Gross Volume (Cubic Inches)
368y Container Gross Volume (Cubic Feet)
369y Container Gross Volume (Cubic Yards)
37 Number of Units Contained
400 Customer Purchase Order Number
410 Ship To/Deliver To Location Code (Global Location Number)
411 Bill To/Invoice Location Code (Global Location Number)
412 Purchase From Location Code (Global Location Number)
420 Ship To/Deliver To Postal Code (Single Postal Authority)
421 Ship To/Deliver To Postal Code (Multiple Postal Authority)
8001 Roll Products - Width/Length/Core Diameter
8002 Electronic Serial Number (ESN) for Cellular Phone
8003 Global Returnable Asset Identifier
8004 Global Individual Asset Identifier
8005 Price per Unit of Measure
8100 Coupon Extended Code: Number System and Offer
8101 8101 Coupon Extended Code: Number System, Offer, End of Offer
8102 Coupon Extended Code: Number System preceded by 0
90 Mutually Agreed Between Trading Partners
91 Internal Company Codes
92 Internal Company Codes
93 Internal Company Codes
94 Internal Company Codes
95 Internal Company Codes
96 Internal Company Codes
97 Internal Company Codes
98 Internal Company Codes
99 Internal Company Codes</PRE><P>
<A NAME="FIELDS"></A><FONT SIZE=4><B>C.2 Fixed Length Fields</B></FONT></P>
<P STYLE="margin-bottom: 0cm">The GS1 Specification requires that
some of the data to be encoded fits a standard length field. Zint
requires this to be true of input data in order for data to be
encoded correctly but does not check that the input data adheres to
these rules. If this system is not followed then the resulting
barcode symbol may not be readable. The following table details which
AIs have fixed length data fields and how long the data should be for
each:</P>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<CENTER>
<TABLE WIDTH=513 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=161>
<COL WIDTH=325>
<THEAD>
<TR VALIGN=TOP>
<TH WIDTH=161>
<P>Application Identifier</P>
</TH>
<TH WIDTH=325>
<P>Number of characters<BR>(AI and Data Field)</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>00</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>20</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>01</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>16</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>02</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>16</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>03</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>16</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>04</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>18</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>11</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>12</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>13</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>14</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>15</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>16</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>17</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>18</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>19</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>8</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>20</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>4</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>31</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>32</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>33</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>34</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>35</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>36</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=161>
<P ALIGN=CENTER>41</P>
</TD>
<TD WIDTH=325>
<P ALIGN=CENTER>16</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<P STYLE="margin-bottom: 0cm">[1] This information taken from
<A HREF="http://en.wikipedia.org/wiki/GS1-128">Wikipedia</A> and used
under the terms of the <A HREF="http://en.wikipedia.org/wiki/Wikipedia:Text_of_the_GNU_Free_Documentation_License">GNU
Free Documentation License</A>.</P>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<P STYLE="margin-bottom: 0cm"><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="appxb.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%></TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Appendix B</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%></TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/auspost.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 245 B

1390
docs/backend.html Normal file
View file

File diff suppressed because it is too large Load diff

BIN
docs/border.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 343 B

BIN
docs/box.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 342 B

BIN
docs/cca.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 3.3 KiB

BIN
docs/ccb.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 3.7 KiB

BIN
docs/ccc.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 3.9 KiB

BIN
docs/codabar.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.2 KiB

BIN
docs/code11.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.3 KiB

BIN
docs/code128.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.3 KiB

BIN
docs/code16k.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 571 B

BIN
docs/code39.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.2 KiB

19
docs/codesize.txt Normal file
View file

@ -0,0 +1,19 @@
0.1 97.9kB (est)
0.2 150.7kB
0.3 101.0kB
0.4 112.0kB
0.5 111.9kB
0.6 109.6kB
1.0 158.8kB
1.1 168.9kB
1.2 208.5kB
1.3 236.6kB
1.4 246.9kB
1.5 263.4kB
1.5.1a 276.2kB
1.5.1 300.2kB
1.5.2 369.4kB
1.5.3 355.3kB
1.5.4 415.3kB
1.5.5 499.9kB
1.5.6* 600.8kB

BIN
docs/compact417.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 481 B

271
docs/composite.html Normal file
View file

@ -0,0 +1,271 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Composite Symbols</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="0;0">
<META NAME="CHANGED" CONTENT="20080316;12521000">
<META NAME="ProgId" CONTENT="FrontPage.Editor.Document">
<META HTTP-EQUIV="Content-Language" CONTENT="en-gb">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="stacked.html"><FONT COLOR="#0000ff">Prev</FONT></A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="twotrack.html"><FONT COLOR="#0000ff">Next</FONT></A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>5.3 Composite Symbols (ISO 24723)</H1>
<P>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 <A HREF="appxc.html">GS1
General Specification</A>. 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 <FONT FACE="Courier">-b</FONT> or <FONT FACE="Courier">--barcode=</FONT>
switch or by adjusting <FONT FACE="Courier">symbol-&gt;symbology</FONT>
as with other encoding methods. Valid values are shown below.</P>
<CENTER>
<TABLE WIDTH=936 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=105>
<COL WIDTH=254>
<COL WIDTH=540>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER><B>Numeric Value</B></P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><B>Name</B></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER><B>Symbology</B></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>110</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_EANX_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with EAN linear component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>111</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_EAN128_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with GS1-128 linear component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>112</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_RSS14_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 linear
component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>113</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_RSS_LTD_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Limited
component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>114</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_RSS_EXP_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Extended
component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>115</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_UPCA_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with UPC A linear component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>116</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_UPCE_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with UPC E linear component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>117</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_RSS14STACK_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 Stacked
component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>118</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_RSS14_OMNI_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 Stacked
Omnidirectional component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=105>
<P ALIGN=CENTER>119</P>
</TD>
<TD WIDTH=254>
<P ALIGN=CENTER><FONT FACE="Courier">BARCODE_RSS_EXPSTACK_CC</FONT></P>
</TD>
<TD WIDTH=540>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Expanded
Stacked component</P>
</TD>
</TR>
</TABLE>
</CENTER>
<P ALIGN=LEFT>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
at the command prompt use the <FONT FACE="Courier">--primary=</FONT>
command. For example:</P>
<P ALIGN=LEFT><FONT FACE="Courier">zint -b 110 --mode=1
--primary=331234567890 -d &quot;[99]1234-abcd&quot;</FONT></P>
<P ALIGN=LEFT>This creates an EAN-13 linear component with the data
&quot;331234567890&quot; and a 2D CC-A (see below) component with the
data &quot;(99)1234-abcd&quot;. The same results can be achieved
using the API as shown below:</P>
<P ALIGN=LEFT>&nbsp;&nbsp;&nbsp;&nbsp;<FONT FACE="Courier, monospace"><FONT SIZE=2>my_symbol-&gt;symbology
= 110;<BR>&nbsp;&nbsp;&nbsp;&nbsp;my_symbol-&gt;option_1 =
1;<BR>&nbsp;&nbsp;&nbsp;&nbsp;strcpy(my_symbol-&gt;primary,
&quot;331234567890&quot;);<BR>&nbsp;&nbsp;&nbsp;&nbsp;ZBarcode_Encode_and_Print(my_symbol,
&quot;[99]1234-abcd&quot;);</FONT></FONT></P>
<P ALIGN=LEFT>EAN-2 and EAN-5 add-on data can be used with EAN and
UPC symbols using the + symbol as described in section 5.1.3 and
5.1.4.</P>
<P ALIGN=LEFT>The 2D component of a composite symbol can use one of
three systems: CC-A, CC-B and CC-C as described below. The 2D
component type can be selected automatically by Zint dependant on the
length of the input string. Alternatively the three methods can be
accessed using the <FONT FACE="Courier">--mode= </FONT>prompt
followed by 1, 2 or 3 for CC-A, CC-B or CC-C respectively, or by
using the <FONT FACE="Courier">option_1</FONT> variable as shown
above.</P>
<P ALIGN=LEFT><FONT COLOR="#ff0000"><B>NOTE</B></FONT>: <B>2D
component data starting with a production (AI 11) or expiration (AI
17) date must be followed by a batch number (AI 10).</B> In the
absence of real data this value can be entered as &quot;0&quot;. This
is due to a known problem concerning the way the encoding is
optimised for date information. It is hoped this problem will be
resolved in a later release of Zint.</P>
<P ALIGN=LEFT>&nbsp;</P>
<P ALIGN=LEFT><A NAME="CCA"></A><FONT SIZE=5><B>5.3.1 CC-A</B></FONT></P>
<P ALIGN=LEFT>This system uses a variation of MicroPDF417 which
optimised to fit into a small space. The size of the 2D component and
the amount of error correction is determined by the amount of data to
be encoded and the type of linear component which is being used. CC-A
can encode up to 56 numeric digits or an alphanumeric string of
shorter length. To select CC-A use <FONT FACE="Courier">--mode=1</FONT>.</P>
<P ALIGN=LEFT><IMG SRC="cca.png" NAME="graphics1" ALIGN=LEFT WIDTH=223 HEIGHT=204 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="CCB"></A><FONT SIZE=5><B>5.3.2 CC-B</B></FONT></P>
<P ALIGN=LEFT>This system uses MicroPDF417 to encode the 2D
component. The size of the 2D component and the amount of error
correction is determined by the amount of data to be encoded and the
type of linear component which is being used. CC-B can encode up to
338 numeric digits or an alphanumeric string of shorter length. To
select CC-B use <FONT FACE="Courier">--mode=2</FONT>.</P>
<P ALIGN=LEFT><IMG SRC="ccb.png" NAME="graphics2" ALIGN=LEFT WIDTH=218 HEIGHT=200 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="CCC"></A><FONT SIZE=5><B>5.3.3 CC-C</B></FONT></P>
<P ALIGN=LEFT>This system uses PDF417 and can only be used in
conjunction with a GS1-128 linear component. CC-C can encode up to
2361 numeric digits or an alphanumeric string of shorter length. To
select CC-C use <FONT FACE="Courier">--mode=3</FONT>.</P>
<P ALIGN=LEFT><IMG SRC="ccc.png" NAME="graphics3" ALIGN=LEFT WIDTH=322 HEIGHT=202 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="stacked.html"><FONT COLOR="#0000ff">Prev</FONT></A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html"><FONT COLOR="#0000ff">Home</FONT></A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="twotrack.html"><FONT COLOR="#0000ff">Next</FONT></A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Stacked Symbologies</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Two-Track Symbols</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/databar.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 2.2 KiB

BIN
docs/dbexpand.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 486 B

BIN
docs/dbomni.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 391 B

BIN
docs/dbstack.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 198 B

BIN
docs/ean13.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 2 KiB

BIN
docs/fim.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 133 B

228
docs/fourstate.html Normal file
View file

@ -0,0 +1,228 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>4-State Codes</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080316;13072500">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="twotrack.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="twodims.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>5.5 4-State Postal Codes</H1>
<P><A NAME="AUSPOST"></A><FONT SIZE=5><B>5.5.1 Australia Post 4-State
Symbols</B></FONT></P>
<P><A NAME="AUSCUST"></A><FONT SIZE=4><B>5.5.1.1 Customer Barcodes</B></FONT></P>
<P>Australia Post Standard Customer Barcode, Customer Barcode 2 and
Customer Barcode 3 are 37-bar, 52-bar and 67-bar specifications
respectively, developed by Australia Post for printing Delivery Point
ID (DPID) and customer information on mail items. Valid data
characters are 0-9, A-Z, a-z, space and hash (#). A Format Control
Code (FCC) is added by Zint and should not be included in the input
data. Reed-Solomon error correction data is generated by Zint.
Encoding behaviour is determined by the length of the input data
according to the formula shown in the following table:</P>
<CENTER>
<TABLE WIDTH=871 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=110>
<COL WIDTH=322>
<COL WIDTH=175>
<COL WIDTH=89>
<COL WIDTH=115>
<THEAD>
<TR VALIGN=TOP>
<TH WIDTH=110>
<P>Input Length</P>
</TH>
<TH WIDTH=322>
<P>Required Input Format</P>
</TH>
<TH WIDTH=175>
<P>Symbol Length</P>
</TH>
<TH WIDTH=89>
<P>FCC</P>
</TH>
<TH WIDTH=115>
<P>Encoding Table</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN=TOP>
<TD WIDTH=110>
<P ALIGN=CENTER>8</P>
</TD>
<TD WIDTH=322>
<P ALIGN=CENTER>99999999</P>
</TD>
<TD WIDTH=175>
<P ALIGN=CENTER>37-bar</P>
</TD>
<TD WIDTH=89>
<P ALIGN=CENTER>11</P>
</TD>
<TD WIDTH=115>
<P ALIGN=CENTER>None</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=110>
<P ALIGN=CENTER>13</P>
</TD>
<TD WIDTH=322>
<P ALIGN=CENTER>99999999AAAAA</P>
</TD>
<TD WIDTH=175>
<P ALIGN=CENTER>52-bar</P>
</TD>
<TD WIDTH=89>
<P ALIGN=CENTER>59</P>
</TD>
<TD WIDTH=115>
<P ALIGN=CENTER>C</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=110>
<P ALIGN=CENTER>16</P>
</TD>
<TD WIDTH=322>
<P ALIGN=CENTER>9999999999999999</P>
</TD>
<TD WIDTH=175>
<P ALIGN=CENTER>52-bar</P>
</TD>
<TD WIDTH=89>
<P ALIGN=CENTER>59</P>
</TD>
<TD WIDTH=115>
<P ALIGN=CENTER>N</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=110>
<P ALIGN=CENTER>18</P>
</TD>
<TD WIDTH=322>
<P ALIGN=CENTER>99999999AAAAAAAAAA</P>
</TD>
<TD WIDTH=175>
<P ALIGN=CENTER>67-bar</P>
</TD>
<TD WIDTH=89>
<P ALIGN=CENTER>62</P>
</TD>
<TD WIDTH=115>
<P ALIGN=CENTER>C</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=110>
<P ALIGN=CENTER>23</P>
</TD>
<TD WIDTH=322>
<P ALIGN=CENTER>99999999999999999999999</P>
</TD>
<TD WIDTH=175>
<P ALIGN=CENTER>67-bar</P>
</TD>
<TD WIDTH=89>
<P ALIGN=CENTER>62</P>
</TD>
<TD WIDTH=115>
<P ALIGN=CENTER>N</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
</P>
<P><A NAME="AUSREPLY"></A><FONT SIZE=4><B>5.5.1.2 Reply Paid Barcode</B></FONT></P>
<P>A Reply Paid version of the Australia Post 4-State Barcode (FCC
45) which requires an 8-digit DPID input.</P>
<P><A NAME="AUSROUTE"></A><FONT SIZE=4><B>5.5.1.3 Routing Barcode</B></FONT></P>
<P>A Routing version of the Australia Post 4-State Barcode (FCC 87)
which requires an 8-digit DPID input.</P>
<P><A NAME="AUSREDIRECT"></A><FONT SIZE=4><B>5.5.1.4 Redirect Barcode</B></FONT></P>
<P>A Redirection version of the Australia Post 4-State Barcode (FCC
92) which requires an 8-digit DPID input.</P>
<P ALIGN=CENTER><IMG SRC="auspost.png" NAME="graphics1" ALIGN=LEFT WIDTH=266 HEIGHT=20 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="RM4SCC"></A><FONT SIZE=5><B>5.5.2 Royal Mail 4-State
Country Code (RM4SCC)</B></FONT></P>
<P>The RM4SCC standard is used by the Royal Mail in the UK to encode
postcode and customer data on mail items. Data input can consist of
numbers 0-9 and letters A-Z and usually includes delivery postcode
followed by house number. For example &quot;W1J0TR01&quot; for 1
Picadilly Circus in London. Check digit data is generated by Zint.</P>
<P ALIGN=CENTER><IMG SRC="rm4scc.png" NAME="graphics2" ALIGN=LEFT WIDTH=166 HEIGHT=20 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="ONECODE"></A><FONT SIZE=5><B>5.5.3 USPS OneCode</B></FONT></P>
<P>Also known as the Intelligent Mail Barcode and used in the US by
the United States Postal Service (USPS), the OneCode system is due to
replace the PostNet and PLANET symbologies by 2009. OneCode is a
fixed length (65-bar) symbol which combines routing and customer
information in a single symbol. Input data consists of a 20 digit
tracking code, followed by a dash (-), followed by a delivery point
zip-code which can be 0, 5, 9 or 11 digits in length. For example all
of the following inputs are valid data entries:</P>
<P><FONT FACE="Courier">&quot;01234567094987654321&quot;<BR>&quot;01234567094987654321-01234&quot;<BR>&quot;01234567094987654321-012345678&quot;<BR>&quot;01234567094987654321-01234567891&quot;</FONT></P>
<P ALIGN=CENTER><IMG SRC="onecode.png" NAME="graphics3" ALIGN=LEFT WIDTH=258 HEIGHT=12 BORDER=0><BR CLEAR=LEFT><BR><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="twotrack.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="twodims.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Two-Track Symbols</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Two-Dimensional Symbols</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

765
docs/frontend.html Normal file
View file

@ -0,0 +1,765 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Using the Front End</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080309;20090400">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="installing.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="backend.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>3. Using the Front End</H1>
<P STYLE="font-style: normal">Zint can be used to generate barcodes
as PNG images or as encapsulated Post Script (EPS) files. This page
describes how to encode data using the command line front end
program.</P>
<P><BR><BR>
</P>
<H1><A NAME="INPUT"></A><FONT SIZE=5><B>3.1 Inputting data</B></FONT></H1>
<P STYLE="font-style: normal">The data to encode can be entered at
the command line using the -d option, for example:</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
-d 'This Text'</FONT></FONT></P>
<P STYLE="font-style: normal">This will encode the text <I>This Text</I>.
Zint will use the default symbology, Code 128, and output to the
default file out.png in the current directory.
</P>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="OUTPUT"></A><FONT SIZE=5><B>3.2
Directing Output</B></FONT></P>
<P STYLE="font-style: normal">Output can be directed to a file other
than the default using the -o switch. For example:</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
-o here.png -d 'This Text'</FONT></FONT></P>
<P STYLE="font-style: normal">draws a Code 128 barcode in the file
here.png. If an encapsulated Post Script file is needed simply append
the file name with .eps:</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
-o there.eps -d 'This Text'</FONT></FONT></P>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="BARTYPE"></A><FONT SIZE=5><B>3.3
Selecting barcode type</B></FONT></P>
<P STYLE="font-style: normal">Selecting which type of barcode you
wish to produce (i.e. which symbology to use) can be done at the
command line using the -b or --barcode= switch followed by the
appropriate integer value in the following table.</P>
<P ALIGN=JUSTIFY STYLE="page-break-before: always"><BR><BR>
</P>
<CENTER>
<TABLE WIDTH=809 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=139>
<COL WIDTH=643>
<THEAD>
<TR VALIGN=TOP>
<TH WIDTH=139>
<P>ID</P>
</TH>
<TH WIDTH=643>
<P>Barcode Name</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>1</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 11</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>2</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Standard Code 2 of 5</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>3</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Interleaved 2 of 5</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>4</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 2 of 5 IATA</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>6</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 2 of 5 Data Logic</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>7</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 2 of 5 Industrial</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>8</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 3 of 9 (Code 39)</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>9</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Extended Code 3 of 9 (Code 39+)</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>13</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>EAN</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>16</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>GS1-128 (UCC.EAN-128)</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>18</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Codabar</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>20</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 128 (automatic subset switching)</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>21</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Deutshe Post Leitcode</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>22</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Deutshe Post Identcode</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>23</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 16K</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>25</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 93</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>28</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Flattermarken</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>29</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>GS1 DataBar-14</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>30</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>GS1 DataBar Limited</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>31</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>GS1 DataBar Extended</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>32</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Telepen Alpha</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>34</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>UPC A</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>37</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>UPC E</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>40</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>PostNet</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>47</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>MSI Code</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>49</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>FIM</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>50</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>LOGMARS</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>51</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Pharmacode One-Track</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>52</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>PZN</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>53</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Pharmacode Two-Track</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>55</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>PDF417</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>56</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>PDF417 Truncated</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>57</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Maxicode</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>58</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>QR Code</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>60</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 128 (Subset B)</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>63</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Australia Post Standard Customer</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>66</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Australia Post Reply Paid</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>67</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Australia Post Routing</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>68</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Australia Post Redirection</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>69</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>ISBN (EAN-13 with verification stage)</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>70</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Royal Mail 4 State (RM4SCC)</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>71</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Data Matrix</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>72</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>ITF-14</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>75</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>NVE-18</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>79</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>GS1 DataBar-14 Stacked</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>80</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>GS1 DataBar-14 Stacked Omnidirectional</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>81</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>GS1 DataBar Expanded Stacked</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>82</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>PLANET</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>84</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>MicroPDF417</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>85</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>USPS OneCode</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>86</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Plessey Code</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>100</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Telepen Numeric</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>101</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>MSI Plessey + mod 10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>102</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>MSI Plessey + mod 10 + mod 10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>103</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>MSI Plessey + mod 11</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>104</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>MSI Plessey + mod 10 + mod 11</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>105</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Code 39 + mod 43</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>106</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Extended Code 39 + mod 43</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>110</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with EAN linear component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>111</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with GS1-128 linear component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>112</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 linear
component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>113</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Limited
component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>114</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Extended
component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>115</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with UPC A linear component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>116</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with UPC E linear component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>117</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 Stacked
component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>118</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 Stacked
Omnidirectional component</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>119</P>
</TD>
<TD WIDTH=643>
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Expanded
Stacked component</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<P ALIGN=JUSTIFY><BR><BR>
</P>
<P><A NAME="HEIGHT"></A><FONT SIZE=5><B>3.4 Adjusting height</B></FONT></P>
<P>The height of the symbol can be adjusted using the --height
switch. For example:</P>
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint --height=100 -d
'This Text'</FONT></FONT></P>
<P>specifies a symbol height of 100 times the <I>x-resolution</I> of
the symbol.</P>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="WHITESPACE"></A><FONT SIZE=5><B>3.5
Adjusting whitespace</B></FONT></P>
<P STYLE="font-style: normal">The amount of whitespace to the left
and right of the generated barcode can be altered using the -w
switch. For example:</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
-w 10 -d 'This Text'</FONT></FONT></P>
<P STYLE="font-style: normal">specifies a whitespace width of 10
times the <I>x-resolution</I> of the symbol.</P>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="BOUNDARY"></A><FONT SIZE=5><B>3.6
Adding boundary bars and boxes</B></FONT></P>
<P STYLE="font-style: normal">Zint allows the symbol to be bound with
'boundary bars' using the option --bind. These bars help to prevent
misreading of the symbol by corrupting a scan if the scanning beam
strays off the top or bottom of the symbol. Zint can also put a
border right around the symbol and its whitespace with the --box
option. This option is automatically chosen for ITF-14 symbols.</P>
<P STYLE="font-style: normal">The width of the boundary or box can be
specified using the --border switch. For example:</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
--box --border=10 -d 'This'</FONT></FONT></P>
<P STYLE="font-style: normal">gives a box with a width 10 times the
<I>x-resolution</I> of the symbol.</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<COL WIDTH=128*>
<COL WIDTH=128*>
<TR VALIGN=TOP>
<TD WIDTH=50%>
<P ALIGN=CENTER><IMG SRC="border.png" NAME="graphics2" ALT="bound symbol" ALIGN=MIDDLE WIDTH=238 HEIGHT=120 BORDER=0></P>
</TD>
<TD WIDTH=50%>
<P ALIGN=CENTER><IMG SRC="box.png" NAME="graphics1" ALT="boxed symbol" ALIGN=MIDDLE WIDTH=238 HEIGHT=120 BORDER=0></P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="COLOUR"></A><FONT SIZE=5><B>3.7
Using colour</B></FONT></P>
<P STYLE="font-style: normal">The default colours of a symbol are a
black symbol on a white background. Zint allows you to change this.
The -r switch allows the default colours to be inverted so that a
white symbol is shown on a black background. For example the command</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
-r -d 'This'</FONT></FONT></P>
<P STYLE="font-style: normal">gives an inverted Code 128 symbol. This
is not practical for most symbologies but white-on-black is allowed
by the Data Matrix symbology specification.</P>
<P STYLE="font-style: normal">For more specific needs the foreground
and background colours can be specified using the --fg= and --bg=
options followed by a number in RGB hexadecimal notation (the same
system used in HTML). For example the command
</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
--fg=004700 -d 'This'</FONT></FONT></P>
<P STYLE="font-style: normal">alters the symbol to a dark green as
shown below.</P>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<COL WIDTH=128*>
<COL WIDTH=128*>
<TR VALIGN=TOP>
<TD WIDTH=50%>
<P ALIGN=CENTER><IMG SRC="green.png" NAME="graphics3" ALT="symbol with green ink" ALIGN=BOTTOM WIDTH=238 HEIGHT=120 BORDER=0></P>
</TD>
<TD WIDTH=50%>
<P ALIGN=CENTER><IMG SRC="pink.png" NAME="graphics4" ALT="symbol with pink paper" ALIGN=BOTTOM WIDTH=238 HEIGHT=120 BORDER=0></P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="OTHER"></A><FONT SIZE=5><B>3.8
Other options</B></FONT></P>
<P STYLE="font-style: normal">Additional options are available which
are specific to certain symbologies. These may, for example, control
the quantity of error correction data or the size of the symbol.
These options are discussed in section 5 of this guide.</P>
<P><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="installing.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="backend.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Installation</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Using the API</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/gplv3-127x51.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 4.3 KiB

BIN
docs/green.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 370 B

317
docs/index.html Normal file
View file

@ -0,0 +1,317 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Zint Barcode Generator</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070802;10154800">
<META NAME="CHANGED" CONTENT="20080422;8300800">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H3 { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
DT { color: #000000 }
DD { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<H1>Zint Barcode Generator</H1>
<H3>by Robin Stuart</H3>
<P>version 1.6, 22nd April 2008</P>
<P>This document is a guide to Zint, the <I>libzint</I> library and
the barcode symbologies supported by them.</P>
<HR>
<DL>
<DT><B>Table of Contents</B>
</DT><DT>
1. <A HREF="introduction.html">Introduction</A>
</DT><DT>
2. <A HREF="installing.html">Installing Zint</A>
</DT><DL>
<DT>
2.1 <A HREF="installing.html#BACKEND">Installing the Back End</A>
</DT><DT>
2.2 <A HREF="installing.html#FRONTEND">Installing the Front End</A>
</DT><DT>
2.3 <A HREF="installing.html#TESTING">Testing the Installation</A>
</DT></DL>
<DT>
3. <A HREF="frontend.html">Using the Front End</A>
</DT><DL>
<DT>
3.1 <A HREF="frontend.html#INPUT">Inputting Data</A>
</DT><DT>
3.2 <A HREF="frontend.html#OUTPUT">Directing Output</A>
</DT><DT>
3.3 <A HREF="frontend.html#BARTYPE">Selecting Barcode Type</A>
</DT><DT>
3.4 <A HREF="frontend.html#HEIGHT">Adjusting Height</A>
</DT><DT>
3.5 <A HREF="frontend.html#WHITESPACE">Adjusting Whitespace</A>
</DT><DT>
3.6 <A HREF="frontend.html#BOUNDARY">Adding Boundary Bars and Boxes</A>
</DT><DT>
3.7 <A HREF="frontend.html#COLOUR">Using Colour</A>
</DT><DT>
3.8 <A HREF="frontend.html#OTHER">Other Options</A>
</DT></DL>
<DT>
4. <A HREF="backend.html">Using the API</A>
</DT><DL>
<DT>
4.1 <A HREF="backend.html#CREATE">Creating and Deleting Symbols</A>
</DT><DT>
4.2 <A HREF="backend.html#ENCODE">Encoding and Saving to File</A>
</DT><DT>
4.3 <A HREF="backend.html#OPTIONS">Setting Options</A>
</DT><DT>
4.4 <A HREF="backend.html#ERRORS">Handling Errors</A>
</DT><DT>
4.5 <A HREF="backend.html#SYMBOL">Specifying a Symbology</A>
</DT><DT>
4.6 <A HREF="backend.html#BOXES">Adding Boxes and Boundary Bars</A>
</DT></DL>
<DT>
5. <A HREF="symbologies.html">Types of Symbol</A>
</DT><DL>
<DT>
5.1 <A HREF="onedim.html">One-Dimensional Symbols</A>
</DT><DL>
<DT>
5.1.1 <A HREF="onedim.html#CODE11">Code 11</A>
</DT><DT>
5.1.2 <A HREF="onedim.html#CODE25">Code 2 of 5</A>
</DT><DL>
<DT>
5.1.2.1 <A HREF="onedim.html#CODE25STAND">Standard Code 2 of 5</A>
</DT><DT>
5.1.2.2 <A HREF="onedim.html#IATA">IATA Code 2 of 5</A>
</DT><DT>
5.1.2.3 <A HREF="onedim.html#IND25">Industrial 2 of 5</A>
</DT><DT>
5.1.2.4 <A HREF="onedim.html#INTER25">Interleaved Code 2 of 5</A>
</DT><DT>
5.1.2.5 <A HREF="onedim.html#DLOGIC">Code 2 of 5 Data Logic</A>
</DT><DT>
5.1.2.6 <A HREF="onedim.html#ITF14">ITF-14</A>
</DT><DT>
5.1.2.7 <A HREF="onedim.html#DPLEIT">Deutche Post Leitcode</A>
</DT><DT>
5.1.2.8 <A HREF="onedim.html#DPIDENT">Deutche Post Identcode</A>
</DT></DL>
<DT>
5.1.3 <A HREF="onedim.html#UPC">Universal Product Code (EN 797)</A>
</DT><DL>
<DT>
5.1.3.1 <A HREF="onedim.html#UPCA">UPC version A</A>
</DT><DT>
5.1.3.2 <A HREF="onedim.html#UPCE">UPC version E</A>
</DT></DL>
<DT>
5.1.4 <A HREF="onedim.html#EAN">European Article Number (EN 797)</A>
</DT><DL>
<DT>
5.1.4.1 <A HREF="onedim.html#EANX">EAN-2, EAN-5, EAN-8 and EAN-13</A>
</DT><DT>
5.1.4.2 <A HREF="onedim.html#ISBN">SBN, ISBN and ISBN-13</A>
</DT></DL>
<DT>
5.1.5 <A HREF="onedim.html#PLESSEY">Plessey</A>
</DT><DT>
5.1.6 <A HREF="onedim.html#MSI">MSI Plessey</A>
</DT><DT>
5.1.7 <A HREF="onedim.html#TELEPEN">Telepen</A>
</DT><DL>
<DT>
5.1.7.1 <A HREF="onedim.html#TELEPENASCII">Telepen Alpha</A>
</DT><DT>
5.1.7.2 <A HREF="onedim.html#TELENUM">Telepen Numeric</A>
</DT></DL>
<DT>
5.1.8 <A HREF="onedim.html#CODE39">Code 39</A>
</DT><DL>
<DT>
5.1.8.1 <A HREF="onedim.html#CODE39STAND">Standard Code 39 (ISO
16388)</A>
</DT><DT>
5.1.8.2 <A HREF="onedim.html#EXCODE39">Extended Code 39</A>
</DT><DT>
5.1.8.3 <A HREF="onedim.html#CODE93">Code 93</A>
</DT><DT>
5.1.8.4 <A HREF="onedim.html#PZN">PZN</A>
</DT><DT>
5.1.8.5 <A HREF="onedim.html#LOGMARS">LOGMARS</A>
</DT></DL>
<DT>
5.1.9 <A HREF="onedim.html#CODABAR">Codabar (EN 798)</A>
</DT><DT>
5.1.10 <A HREF="onedim.html#PHARMA">Pharmacode</A>
</DT><DT>
5.1.11 <A HREF="onedim.html#CODE128">Code 128</A>
</DT><DL>
<DT>
5.1.11.1 <A HREF="onedim.html#CODE128STAND">Standard Code 128
(ISO 15417)</A>
</DT><DT>
5.1.11.2 <A HREF="onedim.html#CODE128B">Code 128 subset B</A>
</DT><DT>
5.1.11.3 <A HREF="onedim.html#EAN128">EAN-128</A>
</DT><DT>
5.1.11.4 <A HREF="onedim.html#NVE18">NVE-18</A>
</DT></DL>
<DT>
5.1.12 <A HREF="onedim.html#DATABAR">GS1 DataBar (ISO 24724)</A>
</DT><DL>
<DT>
5.1.12.1 <A HREF="onedim.html#RSS14">DataBar-14 and DataBar-14
Truncated</A></DT><DT>
5.1.12.2 <A HREF="onedim.html#RSSLTD">DataBar Limited</A></DT><DT>
5.1.12.3 <A HREF="onedim.html#RSSEXP">DataBar Expanded</A></DT></DL>
</DL>
<DT>
5.2 <A HREF="stacked.html">Stacked Symbologies</A>
</DT><DL>
<DT>
5.2.1 <A HREF="stacked.html#BASIC">Basic Symbol Stacking</A>
</DT><DT>
5.2.2 <A HREF="stacked.html#CODE16K">Code 16k (EN 12323)</A>
</DT><DT>
5.2.3 <A HREF="stacked.html#PDF417">PDF417 (ISO 15438)</A>
</DT><DT>
5.2.4 <A HREF="stacked.html#PDF417T">Compact PDF417</A>
</DT><DT>
5.2.5 <A HREF="stacked.html#MICROPDF">MicroPDF417 (ISO 24728)</A>
</DT><DT>
5.2.6 <A HREF="stacked.html#RSS14STACK">GS1 DataBar-14 Stacked
(ISO 24724)</A></DT><DT>
5.2.7 <A HREF="stacked.html#RSS14OMNI">GS1 DataBar-14 Stacked
Omnidirectional (ISO 24724)</A></DT><DT>
5.2.8 <A HREF="stacked.html#RSSEXPSTACK">GS1 DataBar Expanded
Stacked (ISO 24724)</A>
</DT></DL>
<DT>
5.3 <A HREF="composite.html">Composite Symbols (ISO 24723)</A>
</DT><DL>
<DT>
5.3.1 <A HREF="composite.html#CCA">CC-A</A>
</DT><DT>
5.3.2 <A HREF="composite.html#CCB">CC-B</A>
</DT><DT>
5.3.3 <A HREF="composite.html#CCC">CC-C</A>
</DT></DL>
<DT>
5.4 <A HREF="twotrack.html">Two-Track Symbologies</A>
</DT><DL>
<DT>
5.4.1 <A HREF="twotrack.html#PHARMA">Two-Track Pharmacode</A>
</DT><DT>
5.4.2 <A HREF="twotrack.html#POSTNET">PostNet</A>
</DT><DT>
5.4.3 <A HREF="twotrack.html#PLANET">PLANET</A>
</DT></DL>
<DT>
5.5 <A HREF="fourstate.html">4-State Postal Codes</A>
</DT><DL>
<DT>
5.5.1 <A HREF="fourstate.html#AUSPOST">Australia Post 4-State
Symbols</A>
</DT><DL>
<DT>
5.5.1.1 <A HREF="fourstate.html#AUSCUST">Customer Barcodes</A>
</DT><DT>
5.5.1.2 <A HREF="fourstate.html#AUSREPLY">Reply Paid Barcode</A>
</DT><DT>
5.5.1.3 <A HREF="fourstate.html#AUSROUTE">Routing Barcode</A>
</DT><DT>
5.5.1.4 <A HREF="fourstate.html#AUSREDIRECT">Redirect Barcode</A>
</DT></DL>
<DT>
5.5.2 <A HREF="fourstate.html#RM4SCC">Royal Mail 4-State Country
Code (RM4SCC)</A>
</DT><DT>
5.5.3 <A HREF="fourstate.html#ONECODE">USPS OneCode</A>
</DT></DL>
<DT>
5.6 <A HREF="twodims.html">Two-Dimensional Symbols</A>
</DT><DL>
<DT>
5.6.1 <A HREF="twodims.html#DMATRIX">Data Matrix (ISO 16022)</A>
</DT><DT>
5.6.2 <A HREF="twodims.html#QRCODE">QR Code (ISO 18004)</A>
</DT><DT>
5.6.3 <A HREF="twodims.html#MAXI">Maxicode (ISO 16023)</A></DT></DL>
<DT>
5.7 <A HREF="markings.html">Other Barcode-Like Markings</A>
</DT><DL>
<DT>
5.7.1 <A HREF="markings.html#FIM">Facing Identification Mark (FIM)</A>
</DT><DT>
5.7.2 <A HREF="markings.html#FLAT">Flattermarken</A>
</DT></DL>
</DT></DL>
<DT>
6 <A HREF="legal.html">Legal and Version Information</A>
</DT><DL>
<DT>
6.1 <A HREF="legal.html#LICENSE">License</A>
</DT><DT>
6.2 <A HREF="legal.html#PATENT">Patent Issues</A>
</DT><DT>
6.3 <A HREF="legal.html#VERSION">Version Information</A>
</DT><DT>
6.4 <A HREF="legal.html#CREDITS">Sources of Information</A>
</DT><DT>
6.5 <A HREF="legal.html#STANDARD">Standard Compliance</A>
</DT></DL>
<DT>
A <A HREF="appxa.html">Appendix A: Character Encoding</A>
</DT><DL>
<DT>
A.1 <A HREF="appxa.html#ASCII">ASCII Standard</A>
</DT><DT>
A.2 <A HREF="appxa.html#LATIN1">Latin Alphabet No 1 (ISO 8859-1)</A>
</DT></DL>
<DT>
B <A HREF="appxb.html">Appendix B: Three Digit Country Codes (ISO
3166)</A>
</DT><DT>
C <A HREF="appxc.html">Appendix C: GS1 General Specification</A>
</DT><DL>
<DT>
C.1 <A HREF="appxc.html#AI">Application Identifiers</A>
</DT><DT>
C.2 <A HREF="appxc.html#FIELDS">Fixed Length Fields</A>
</DT></DL>
</DL>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>&nbsp;</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="introduction.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>&nbsp;</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Introduction</P>
</TD>
</TR>
</TABLE>
</BODY>
</HTML>

125
docs/installing.html Normal file
View file

@ -0,0 +1,125 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Installing Zint</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080329;19111200">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="introduction.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="frontend.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>2. Installing Zint</H1>
<P>These instructions relate to installing Zint on a GNU/Linux
machine but should be the same or similar for other POSIX compliant
systems (including UNIX and BSD based systems). Installation on
Windows or MacOS based system should be possible but is not covered
here.</P>
<P>Zint is currently only available as source code. First download
the source code .tar.gz file from <A HREF="http://www.sourceforge.net/projects/zint">SourceForge</A>
and unpack it. The package consists of two distinct parts: a <I>front
end</I> which provides a command line interface, and a <I>back end</I>
which provides an API which allows developers to integrate encoding
into their own project. You will notice that the sorce code is
suitably arranged into frontend and backend folders. The front end
requires the back end to be installed, so the back end should be
installed first.</P>
<P><A NAME="BACKEND"></A><FONT SIZE=5><B>2.1 Installing the back end</B></FONT></P>
<P>The Zint back end, <I>libzint</I>, requires the libpng and libz
libraries. The latest version of these libraries is available from
<A HREF="http://www.libpng.org/pub/png/libpng.html">http://www.libpng.org/pub/png/libpng.html</A>.
Install these first before trying to install Zint. In addition, if
you require QR Code support, Zint uses <I>libqrencode</I> which is
available from
<A HREF="http://megaui.net/fukuchi/works/qrencode/index.en.html">http://megaui.net/fukuchi/works/qrencode/index.en.html</A>.
If you don't need QR Code support this can be disabled during
compilation.</P>
<P STYLE="font-style: normal">To install libzint with QR Code support
follow these steps</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>cd
backend<BR>make<BR>make install</FONT></FONT></P>
<P STYLE="font-style: normal">If you do not want QR Code support use
the following steps</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>cd
backend<BR>make libzint_noqr<BR>make install</FONT></FONT></P>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="FRONTEND"></A><FONT SIZE=5><B>2.2
Installing the front end</B></FONT></P>
<P STYLE="font-style: normal">To install the front end follow these
steps</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>cd
frontend<BR>make<BR>make install</FONT></FONT></P>
<P><BR><BR>
</P>
<P STYLE="font-style: normal"><A NAME="TESTING"></A><FONT SIZE=5><B>2.3
Testing the Installation</B></FONT></P>
<P STYLE="font-style: normal">To test that the installation has been
sucessful a shell script is included in the frontend folder. To run
the test type</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>./test.sh</FONT></FONT></P>
<P STYLE="font-style: normal">This should create numerous files
showing the many modes of operation which are available from Zint. If
you get the following message...</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint:
error while loading shared libraries: libzint.so: cannot open shared
object file: No such file or directory</FONT></FONT></P>
<P STYLE="font-style: normal">try the following as root:</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>ldconfig</FONT></FONT></P>
<P><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="introduction.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="frontend.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Introduction</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Using the Front End</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

97
docs/introduction.html Normal file
View file

@ -0,0 +1,97 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Introduction</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080309;19055500">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="index.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="installing.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1><A NAME="INTRODUCTION"></A>1. Introduction</H1>
<P>Zint is an open source barcode generator which allows you to
encode data in over 30 types of barcode symbol. In this documentation
a barcode encoding method is termed a <I>symbology</I> and the
resulting barcode image is termed a <I>symbol</I>. The symbologies
currently supported by Zint are: [1]</P>
<P>Code 11, Standard Code 2 of 5, IATA Code 2 of 5, Industrial Code 2
of 5, Interleaved Code 2 of 5, Code 2 of 5 Data Logic, ITF-14,
Deutche Post Leitcode, Deutche Post Identcode, UPC-A, UPC-E, EAN-2,
EAN-5, EAN-8, EAN-13, UK Plessey, MSI Plessey, Telepen Alpha, Telepen
Numeric, Code 39, Extended Code 39, Code 93, PZN, LOGMARS, Codabar,
Pharmacode, Code 128, GS1-128, NVE-18, GS1 DataBar, DataBar-14,
DataBar Limited, DataBar Extended, Code 16k, PDF417, MicroPDF417,
Two-Track Pharmacode, PostNet, PLANET, Australia Post 4-State
Symbols, RM4SCC, USPS OneCode, Data Matrix, QR Code, Maxicode,
Composite Symbols, FIM and Flattermarken.</P>
<P>In addition Zint also provides barcode stacking, colour options
and a verification stage for SBN, ISBN and ISBN-13 data. The aim of
the Zint project is to provide an open source API for encoding all
public domain barcode symbologies.</P>
<P>This document is a guide to the Zint API and front end program as
well as a guide to the barcode technologies which they make
available. Please remember that, although a great deal of care has
been taken to de-bug Zint, many of the symbologies have not been
tested with commercial barcode scanners so you are recommended to
test that symbols decode properly before you use them.</P>
<P><BR><BR>
</P>
<P>[1] Note that some of these symbologies have more than one name,
and that some of the names given in this list are not the official
names for the symbologies referred to.</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT><A HREF="index.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="installing.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Zint Barcode Generator</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Installing Zint</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/itf14.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.8 KiB

265
docs/legal.html Normal file
View file

@ -0,0 +1,265 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Legal and Version Information</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080422;8453800">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="markings.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="appxa.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>6. Legal and Version Information</H1>
<P><A NAME="LICENSE"></A><FONT SIZE=5><B>6.1 License</B></FONT></P>
<P><IMG SRC="gplv3-127x51.png" NAME="graphics1" ALIGN=RIGHT WIDTH=127 HEIGHT=51 BORDER=0>Zint
and <I>libzint</I> are Copyright &copy; 2008 Robin Stuart and are
distributed under the terms of the <A HREF="http://www.gnu.org/copyleft/gpl.html">GNU
General Public License</A> version 3 [1]. See the file <FONT FACE="Courier">COPYING</FONT>
for more information. The following terms form part of the GPL:</P>
<P><FONT FACE="Courier">This program is free software; you can
redistribute it and/or modify it under the terms of the GNU General
Public License as published by the Free Software Foundation; either
version 3 of the License, or (at your option) any later version.</FONT></P>
<P><FONT FACE="Courier">This program is distributed in the hope that
it will be useful, but WITHOUT ANY WARRANTY; without even the implied
warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See
the GNU General Public License for more details.</FONT></P>
<P>Data Matrix code is Copyright &copy; 2004 Adrian Kennard, Andrews
&amp; Arnold Ltd and &copy; 2006 Stefan Schmidt, used under the terms
of the GNU General Public Licence.</P>
<P>Reed-Solomon code is Copyright &copy; 2004 Cliff Hones, used under
the terms of the GNU General Public Licence.</P>
<P>Portions of GS1 DataBar and Composite Symbology code are Copyright
&copy; 2006 ISO/BSI Global and used with permission.</P>
<P>Portions of OneCode code is &copy; 2006 United States Postal
Service. This is indicated where appropriate in the source code and
is used on the understanding that this code has been released to the
public domain and that such use is intended by the copyright holder.</P>
<P><I>libqrencode</I> is Copyright &copy; 2006, 2007, 2008 Kentaro
Fukuchi and is released under the terms of the GNU General Public
Licence.</P>
<P>QR Code is a registered trademark of Denso Corp. of Kariya, Japan.</P>
<P><A NAME="PATENT"></A><FONT SIZE=5><B>6.2 Patent Issues</B></FONT></P>
<P>All of the code in Zint is developed using information in the
public domain, usually freely available on the Internet. Some of the
techniques used may be subject to patents and other intellectual
property legislation. It is my belief that any patents involved in
the technology underlying symbologies utilised by Zint are
'unadopted', that is the holder does not object to their methods
being used. If, however, you are a patent holder or hold any other
intellectual property rights on the methods used by Zint or the
symbologies which Zint generates, and do not want Zint to continue to
support your symbology then please contact me and I will update the
code to accommodate your wishes at the soonest opportunity.</P>
<P>Any methods patented or owned by third parties or trademarks or
registered trademarks used within Zint or in this document are and
remain the property of their respective owners and do not indicate
endorsement or affiliation with those owners, companies or
organisations.</P>
<P><A NAME="VERSION"></A><FONT SIZE=5><B>6.3 Version Information</B></FONT></P>
<P>v0.1 - (as <I>Zebar</I>) Draws UPC-A. UPC-E, EAN-8, EAN-13,
Interlaced 2 of 5, Codabar, Code 39, Extended Code 39 and Code 93
barcodes and Add-on codes EAN-2 and EAN-5 without parity. 13/11/2006</P>
<P>v0.2 - Added Code 128 (which is now the default), Code 11, Code 2
of 5, Add-on codes EAN-2 and EAN-5 parity and MSI/Plessey without
check digit. 12/12/2006</P>
<P>v0.3 - Added MSI/Plessey Mod 10 check and 2 x Mod 10 check
options, Telepen ASCII and Telepen numeric, Postnet, RM4SCC. Code has
been tidied up quite a bit. Bind option added. 30/12/2006</P>
<P>v0.4 - Added barcode stacking (now stacks up to 16 barcodes) and
Code16k (stub). 15/1/2007</P>
<P>v0.5 - Added Australia Post 4-State Barcodes and Pharmacode (1 and
2 track). 4-state codes now draw with correct height/width ratio.
28/2/2007</P>
<P>v0.6 - Added Plessey and some derivative codes (EAN-128, Code 128
subset B, Auspost Reply, Auspost Routing, Auspost Redirect, ITF-14).
Tidied up code again: separated symbologies into more files and put
all lookup tables into arrays (much reducing the amount of code,
especially for Code 39e and Code 93). Errors now output to stderr.
Added proper input verification. Distribution now packs with this
HTML page instead of separate README. Outputs to PNG. Outputs colour.
User variable whitespace and border width. Box option. Fixed EAN
add-on bug. Added whitespace and height options. Project name changed
to Zint to avoid conflict with extant trade name. Added escape
character input. 1/4/2007</P>
<P>v1.0 - Corrected problem with escape character codes. Supports
PDF417. This completes the list of features I originally wanted (plus
a few more), hence skip to version 1.0. 20/4/2007</P>
<P>v1.1 - Added more derivatives (Code 2 of 5 Matrix, IATA and Data
Logic, Truncated PDF417, Deutsche Post Leitcode and Identcode,
Pharmazentralnummer, Planet) and Flattermarken. Tidied up 2 of 5
code. 26/4/2007</P>
<P>v1.2 - Supports Data Matrix (by absorption of IEC16022 code by
Stefan Schmidt et al). Added reverse colours, FIM, MSI/Plessey Modulo
11 and Modulo 11/10. Corrected Code 16k check digit calculation.
28/5/2007</P>
<P>v1.3 - Supports USPS OneCode and LOGMARS. Brought all usage
information into one User Manual document. 13/6/2007</P>
<P>v1.4 - Added NVE-18 support. Corrected some problems with
compilation and input verification. Added zint.1 man page. Command
line option handling now uses getopt(), and all the switches have
changed. Added --font option. 20/6/2007</P>
<P>v1.5 - Pulled everything together to make an API. Corrected errors
with EAN-13, PDF417 and LOGMARS. Added EPS output. Added QR Code
support using libqrencode. Corrected ISBN verification error.
Re-compiled documentation in HTML form. Put in place proper error
handling routines. --font option removed. Encoding is now done with a
restructured zint_symbol structure. Added make install option and
optional QR Code support to Makefile. Corrected minor problem with
4-State Codes. Restructured code into fewer source code files. Added
MicroPDF417 support. 12/8/2007</P>
<P>v1.5.1 - Added formatting code to EPS output of EAN and UPC
symbols according to EN 797:1996. Checked against and, where
appropriate, altered or corrected to comply with ISO 16388 and ISO
15417 including Latin-1 support. Altered default image settings,
added automatic ITF border. Corrected error with USPS OneCode. Tidied
up Code 39 quite a bit, added Mod 43 options. 3/9/2007</P>
<P>v1.5.2 - Added extended ASCII support to Code 16k. Corrected Code
128 error. Added Maxicode support by integrating code by John Lien.
26/9/2007</P>
<P>v1.5.3 - Made huge corrections to Maxicode support by removing and
re-writing much of John's code. Maxicode now supports extended ASCII
and modes 4, 5 and 6. 10/10/2007</P>
<P>v1.5.4 - Added GS1 DataBar (Reduced Space Symbology) support.
26/11/2007</P>
<P>v1.5.5 - Added composite symbology support. Corrected errors with
GS1-128 and PDF417/MicroPDF417 byte processing. Transferred licence
to GPL version 3. 9/3/2008</P>
<P>v1.6 – Data Matrix, Maxicode and Australia Post now use common
Reed-Solomon functions – this also fixes a bug in Maxicode error
correction and replaces the last of the Lien code. Added PNG output
for Maxicode symbols. Removed some useless code. Updated QR support
for <I>libqrencode</I> v2.0.0. 22/4/2008</P>
<P><A NAME="CREDITS"></A><FONT SIZE=5><B>6.4 Sources of Information</B></FONT></P>
<P>Below is a list of some of the sources used in rough chronological
order:</P>
<P><A HREF="http://www.spatula.net/proc/barcode/index.src">Nick
Johnson's Barcode Specifications</A></P>
<P><A HREF="http://www.barcode-1.net/pub/russadam/spec.html">Bar Code
1 Specification Source Page</A></P>
<P><A HREF="http://www.telepen-barcode.co.uk/">SB Electronic Systems
Telepen website</A></P>
<P>Pharmacode specifications from <A HREF="http://www.laetus.com/">Laetus</A></P>
<P><A HREF="http://www.morovia.com/education/symbology/royalmail.asp">Morovia
RM4SCC specification</A></P>
<P><A HREF="http://www.auspost.com.au/">Austalia Post's</A> 'A Guide
to Printing the 4-State Barcode' and bcsample source code</P>
<P>Plessey algorithm from <A HREF="http://ar.linux.it/pub/barcode">GNU-Barcode
v0.98</A> by Leonid A. Broukhis</P>
<P><A HREF="http://www.gs1uk.org/EANUCC/WORD_Files/word.html">GS1
General Specifications v 7.0</A></P>
<P><A HREF="http://www.linpng.org/pub/png/book/">PNG: The Definitive
Guide</A> and wpng source code by Greg Reolofs</P>
<P>PDF417 specification and pdf417 source code by <A HREF="http://grandzebu.net/index.php">Grand
Zebu</A></P>
<P>Barcode Reference, TBarCode/X User Documentation and TBarCode/X
demonstration program from <A HREF="http://www.tec-it.com/">Tec-It</A></P>
<P><A HREF="http://www.datenfreihafen.org/projects/iec16022.html">IEC16022
source code by Stefan Schmidt et al</A></P>
<P><A HREF="http://ribbs.usps.gov/onecodesolution/">United States
Postal Service Specification USPS-B-3200</A></P>
<P>Adobe Systems Incorporated Encapsulated PostScript File Format
Specification</P>
<P><A HREF="http://www.bsi-global.com/">BSI Online</A> Library</P>
<P><A NAME="STANDARD"></A><FONT SIZE=5><B>6.5 Standard Compliance</B></FONT></P>
<P>Zint was developed to provide compliance with the following
British and international standards:
</P>
<P>BS EN 797:1996 Bar coding – Symbology specifications - 'EAN/UPC'</P>
<P>BS EN 798:1996 Bar coding – Symbology specifications - “Codabar”</P>
<P>BS ISO/IEC 12323:2005 AIDC technologies – Symbology
specifications – Code 16K</P>
<P>BS ISO/IEC 15417:2007 Information technology – Automatic
identification and data capture techniques – Code 128 bar code
symbology specification</P>
<P>BS ISO/IEC 15438:2006 Information technology – Automatic
identification and data capture techniques – PDF417 bar code
symbology specification</P>
<P>BS ISO/IEC 16022:2006 Information technology – Automatic
identification and data capture techniques – Data Matrix bar code
symbology specification</P>
<P>BS ISO/IEC 16023:2000 Information technology – International
symbology specification - Maxicode</P>
<P>BS ISO/IEC 16388:2007 Information technology – Automatic
identification and data capture techniques – Code 39 bar code
symbology specification</P>
<P>BS ISO/IEC 18004:2006 Information technology – Automatic
identification and data capture techniques – QR Code 2005 bar code
symbology specification</P>
<P>BS ISO/IEC 24723:2006 Information technology – Automatic
identification and data capture techniques – EAN.UCC Composite bar
code symbology specification</P>
<P>BS ISO/IEC 24724:2006 Information technology – Automatic
identification and data capture techniques – Reduced Space
Symbology (RSS) bar code symbology specification</P>
<P>BS ISO/IEC 24728:2006 Information technology – Automatic
identification and data capture techniques – MicroPDF417 bar code
symbology specification</P>
<P ALIGN=LEFT><BR><BR>
</P>
<P ALIGN=LEFT>[1] Some of the third party code in this library was
distributed under the terms of <A HREF="http://www.gnu.org/licenses/old-licenses/gpl-2.0.html">version
2 of the GNU Public Licence</A> with the option of using a later
version. For the purpose of Zint as a whole package I have chosen to
take this option and redistribute the code under version 3 of the
licence. This decision takes effect from version 1.5.5 of the code
and does not affect the licence of previously released versions of
the code. Some third party source code files, however, are included
in Zint as verbatim (unaltered) copies and therefore the right to
change the license terms remains exclusively with the original
copyright holder. R. Stuart 9/3/2008</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="markings.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="appxa.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Other Markings</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Appendix A</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

138
docs/markings.html Normal file
View file

@ -0,0 +1,138 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Other Markings</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080316;13275900">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="twodims.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="legal.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>5.7 Other Barcode-Like Markings</H1>
<P><A NAME="FIM"></A><FONT SIZE=5><B>5.7.1. Facing Identification
Mark (FIM)</B></FONT></P>
<P ALIGN=LEFT>Used by the United States Postal Service (USPS), the
FIM symbology is used to assist automated mail processing. There are
only 4 valid symbols which can be generated using the characters A-D
as shown in the table below.</P>
<CENTER>
<TABLE WIDTH=776 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=124>
<COL WIDTH=625>
<THEAD>
<TR VALIGN=TOP>
<TH WIDTH=124>
<P>Code Letter</P>
</TH>
<TH WIDTH=625>
<P>Usage</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN=TOP>
<TD WIDTH=124>
<P ALIGN=CENTER>A</P>
</TD>
<TD WIDTH=625>
<P ALIGN=CENTER>Used for courtesy reply mail and metered reply
mail with a pre-printed PostNet symbol.</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=124>
<P ALIGN=CENTER>B</P>
</TD>
<TD WIDTH=625>
<P ALIGN=CENTER>Used for business reply mail without a
pre-printed zip code.</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=124>
<P ALIGN=CENTER>C</P>
</TD>
<TD WIDTH=625>
<P ALIGN=CENTER>Used for business reply mail with a pre-printed
zip code.</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=124>
<P ALIGN=CENTER>D</P>
</TD>
<TD WIDTH=625>
<P ALIGN=CENTER>Used for Information Based Indicia (IBI)
postage.</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<P ALIGN=CENTER><BR><BR>
</P>
<P ALIGN=LEFT><IMG SRC="fim.png" NAME="graphics1" ALIGN=LEFT WIDTH=30 HEIGHT=100 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="FLAT"></A><FONT SIZE=5><B>5.7.2 Flattermarken</B></FONT></P>
<P ALIGN=LEFT>Used for the recognition of page sequences in
print-shops, the Flattermarken is not a true barcode symbol and
requires precise knowledge of the position of the mark on the page.
The Flattermarken system can encode any length numeric data and does
not include a check digit.<BR><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="twodims.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="legal.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>4-State Codes</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Legal</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/matrix.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 312 B

BIN
docs/maxicode.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 4.3 KiB

BIN
docs/micropdf.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 625 B

BIN
docs/msi.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.3 KiB

BIN
docs/onecode.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 205 B

413
docs/onedim.html Normal file
View file

@ -0,0 +1,413 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>One-Dimensional Symbols</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080316;11412400">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="symbologies.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="stacked.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>5.1 One-Dimensional Symbols</H1>
<P>One-Dimensional Symbols are what most people associate with the
term <I>barcode</I>. They consist of a number of bars and a number of
spaces of differing widths.</P>
<P><BR><BR>
</P>
<P><A NAME="CODE11"></A><FONT SIZE=5><B>5.1.1 Code 11</B></FONT></P>
<P>Developed by Intermec in 1977, Code 11 is similar to Code 2 of 5
Matrix and is primarily used in telecommunications. The symbol can
encode any length string consisting of the digits 0-9 and the dash
character (-). One modulo-11 check digit is calculated.</P>
<P ALIGN=CENTER><IMG SRC="code11.png" NAME="graphics1" ALIGN=LEFT WIDTH=225 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="CODE25"></A><FONT SIZE=5><B>5.1.2 Code 2 of 5</B></FONT></P>
<P>Code 2 of 5 is a family of one-dimensional symbols, 8 of which are
supported by Zint.</P>
<P><A NAME="CODE25STAND"></A><FONT SIZE=4><B>5.1.2.1 Standard Code 2
of 5</B></FONT></P>
<P>Also known as Code 2 of 5 Matrix is a self-checking code used in
industrial applications and photo development. Standard Code 2 of 5
will encode any length numeric input (digits 0-9).</P>
<P><A NAME="IATA"></A><FONT SIZE=4><B>5.1.2.2 IATA Code 2 of 5</B></FONT></P>
<P>Used for baggage handling in the air-transport industry by the
International Air Transport Agency, this self-checking code will
encode any length numeric input (digits 0-9) and does not include a
check digit.</P>
<P><A NAME="IND25"></A><FONT SIZE=4><B>5.1.2.3 Industrial Code 2 of 5</B></FONT></P>
<P>Industrial Code 2 of 5 can encode any length numeric input (digits
0-9) and does not include a check digit.</P>
<P><A NAME="INTER25"></A><FONT SIZE=4><B>5.1.2.4 Interleaved Code 2
of 5</B></FONT></P>
<P>This self-checking symbology encodes pairs of numbers, and so can
only encode an even number of digits (0-9). If an odd number of
digits is entered a leading zero is added by Zint. No check digit is
added.</P>
<P><A NAME="DLOGIC"></A><FONT SIZE=4><B>5.1.2.5 Code 2 of 5 Data
Logic</B></FONT></P>
<P>Data Logic is a proprietary variation of Standard Code 2 of 5.
Data Logic does not include a check digit and can encode any length
numeric input (digits 0-9).</P>
<P><A NAME="ITF14"></A><FONT SIZE=4><B>5.1.2.6 ITF-14</B></FONT></P>
<P>ITF-14, also known as UPC Shipping Container Symbol, Case Code and
EAN-14, is based on Interleaved Code 2 of 5 and requires a 13 digit
numeric input (digits 0-9). One modulo-10 check digit is calculated.</P>
<P><A NAME="DPLEIT"></A><FONT SIZE=4><B>5.1.2.7 Deutche Post Leitcode</B></FONT></P>
<P>Leitcode is based on Interleaved Code 2 of 5 and is used by
Deutche Post for mailing purposes. Leitcode requires a 13-digit
numerical input and includes a check digit.</P>
<P><A NAME="DPIDENT"></A><FONT SIZE=4><B>5.1.2.8 Deutche Post
Identcode</B></FONT></P>
<P>Identcode is based on Interleaved Code 2 of 5 and is used by
Deutche Post for mailing purposes. Identcode requires an 11-digit
numerical input and includes a check digit.</P>
<P ALIGN=CENTER><IMG SRC="itf14.png" NAME="graphics2" ALIGN=LEFT WIDTH=451 HEIGHT=177 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="UPC"></A><FONT SIZE=5><B>5.1.3 Universal Product Code (EN
797)</B></FONT></P>
<P><A NAME="UPCA"></A><FONT SIZE=4><B>5.1.3.1 UPC Version A</B></FONT></P>
<P>UPC-A is used in the United States for retail applications. The
symbol requires an 11 digit article number. The check digit is
calculated by Zint. In addition EAN-2 and EAN-5 add-on symbols can be
added using the + character. For example, to draw a UPC-A symbol with
the data 72527270270 with an EAN-5 add-on showing the data 12345 use
the command:</P>
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint --barcode=34 -d
72527270270+12345</FONT></FONT></P>
<P>or encode a data string with the + character included:
</P>
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>my_symbol-&gt;symbology
= BARCODE_UPCA;<BR>error = ZBarcode_Encode_and_Print(my_symbol,
&quot;72527270270+12345&quot;);</FONT></FONT></P>
<P><A NAME="UPCE"></A><FONT SIZE=4><B>5.1.3.2 UPC Version E</B></FONT></P>
<P>UPC-E is a zero-compressed version of UPC-A developed for smaller
packages. The code requires a 6 digit article number (digits 0-9).
The check digit is calculated by Zint. EAN-2 and EAN-5 add-on symbols
can be added using the + character as with UPC-A. In addition Zint
also supports Number System 1 encoding by entering a 7-digit article
number stating with the digit 1. For example:</P>
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint --barcode=37 -d
1123456</FONT></FONT></P>
<P>or</P>
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>my_symbol-&gt;symbology
= BARCODE_UPCE;<BR>error = ZBarcode_Encode_and_Print(my_symbol,
&quot;1123456&quot;);</FONT></FONT></P>
<P><IMG SRC="upca.png" NAME="graphics3" ALIGN=LEFT WIDTH=272 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="EAN"></A><FONT SIZE=5><B>5.1.4 European Article Number
(EN 797)</B></FONT></P>
<P><A NAME="EANX"></A><FONT SIZE=4><B>5.1.5.1 EAN-2, EAN-5, EAN-8 and
EAN-13</B></FONT></P>
<P>The EAN system is used in retail across Europe and includes
standards for EAN-2 and EAN-5 add-on codes, EAN-8 and EAN-13 which
encode 2, 5, 7 or 12 digit numbers respectively. Zint will decide
which symbology to use depending on the length of the input data. In
addition EAN-2 and EAN-5 add-on symbols can be added using the +
symbol as with UPC symbols. For example</P>
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint --barcode=13 -d
54321</FONT></FONT></P>
<P>will encode a stand-alone EAN-5, whereas</P>
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint --barcode=13 -d
7432365+54321</FONT></FONT></P>
<P>will encode an EAN-8 symbol with an EAN-5 add-on. As before these
results can be achieved using the API:</P>
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>my_symbol-&gt;symbology
= BARCODE_EANX<BR>error = ZBarcode_Encode_and_Print(my_symbol,
&quot;54321&quot;);<BR>error = ZBarcode_Encode_and_Print(my_symbol,
&quot;7432365+54321&quot;);</FONT></FONT></P>
<P>All of the EAN symbols include check data which is added by Zint.</P>
<P><A NAME="ISBN"></A><FONT SIZE=4><B>5.1.4.2 SBN, ISBN and ISBN-13</B></FONT></P>
<P>EAN-13 symbols (also known as Bookland EAN-13) can also be
produced from 9-digit SBN, 10-digit ISBN or 13-digit ISBN-13 data.
The relevant check digit needs to be present in the input data and
will be verified before the symbol is generated. In addition EAN-2
and EAN-5 add-on symbols can be added using the + symbol as with UPC
symbols.</P>
<P><IMG SRC="ean13.png" NAME="graphics4" ALIGN=LEFT WIDTH=272 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="PLESSEY"></A><FONT SIZE=5><B>5.1.5 Plessey</B></FONT></P>
<P>Also known as Plessey Code, this symbology was developed by the
Plessey Company Ltd. in the UK. The symbol can encode any length data
consisting of digits (0-9) or letters A-F and includes a CRC check
digit.</P>
<P ALIGN=CENTER><IMG SRC="plessey.png" NAME="graphics5" ALIGN=LEFT WIDTH=461 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="MSI"></A><FONT SIZE=5><B>5.1.6 MSI Plessey</B></FONT></P>
<P>Based on Plessey and developed by MSE Data Corporation, MSI
Plessey is available with a range of check digit options. Any length
numeric (digits 0-9) input can be encoded. The table below shows the
options available:</P>
<CENTER>
<TABLE WIDTH=817 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=139>
<COL WIDTH=263>
<COL WIDTH=377>
<THEAD>
<TR VALIGN=TOP>
<TH WIDTH=139>
<P>Symbology ID</P>
</TH>
<TH WIDTH=263>
<P>Symbology Name</P>
</TH>
<TH WIDTH=377>
<P>Check Digits</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>47</P>
</TD>
<TD WIDTH=263>
<P ALIGN=CENTER><FONT FACE="Courier, monospace">BARCODE_MSI_PLESSEY</FONT></P>
</TD>
<TD WIDTH=377>
<P ALIGN=CENTER>None</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>101</P>
</TD>
<TD WIDTH=263>
<P ALIGN=CENTER><FONT FACE="Courier, monospace">BARCODE_MSI_10</FONT></P>
</TD>
<TD WIDTH=377>
<P ALIGN=CENTER>Modulo-10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>102</P>
</TD>
<TD WIDTH=263>
<P ALIGN=CENTER><FONT FACE="Courier, monospace">BARCODE_MSI_10_10</FONT></P>
</TD>
<TD WIDTH=377>
<P ALIGN=CENTER>Modulo-10 &amp; Modulo-10</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>103</P>
</TD>
<TD WIDTH=263>
<P ALIGN=CENTER><FONT FACE="Courier, monospace">BARCODE_MSI_11</FONT></P>
</TD>
<TD WIDTH=377>
<P ALIGN=CENTER>Modulo-11</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=139>
<P ALIGN=CENTER>104</P>
</TD>
<TD WIDTH=263>
<P ALIGN=CENTER><FONT FACE="Courier, monospace">BARCODE_MSI_11_10</FONT></P>
</TD>
<TD WIDTH=377>
<P ALIGN=CENTER>Modulo-11 &amp; Modulo-10</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<P><BR><BR>
</P>
<P ALIGN=CENTER><IMG SRC="msi.png" NAME="graphics6" ALIGN=LEFT WIDTH=244 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="TELEPEN"></A><FONT SIZE=5><B>5.1.7 Telepen</B></FONT></P>
<P><A NAME="TELEPENASCII"></A><FONT SIZE=4><B>5.1.7.1 Telepen Alpha</B></FONT></P>
<P>Telepen Alpha was developed by SB Electronic Systems Limited and
can encode any length of ASCII text input. Telepen includes a
modulo-127 check digit.</P>
<P><A NAME="TELENUM"></A><FONT SIZE=4><B>5.1.7.2 Telepen Numeric</B></FONT></P>
<P>Telepen Numeric allows compression of purely numeric data into a
Telepen symbol and includes a modulo-127 check digit.</P>
<P ALIGN=CENTER><IMG SRC="telepen.png" NAME="graphics7" ALIGN=LEFT WIDTH=378 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="CODE39"></A><FONT SIZE=5><B>5.1.8 Code 39</B></FONT></P>
<P><A NAME="CODE39STAND"></A><FONT SIZE=4><B>5.1.8.1 Standard Code 39
(ISO 16388)</B></FONT></P>
<P>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 original standard (symbology 8) does not require a
check digit but a modulo-43 check digit can be added if required
(symbology 105).</P>
<P><A NAME="EXCODE39"></A><FONT SIZE=4><B>5.1.8.2 Extended Code 39</B></FONT></P>
<P>Also known as Code 39e and Code39+, this symbology expands on
Standard Code 39 to provide support to the full ASCII character set.
The original standard (symbology 9) does not require a check digit
but a modulo-43 check digit can be added if required (symbology 106).</P>
<P><A NAME="CODE93"></A><FONT SIZE=4><B>5.1.8.3 Code 93</B></FONT></P>
<P>A variation of Extended Code 39, Code 93 also supports full ASCII
text. Two check digits are added.</P>
<P><A NAME="PZN"></A><FONT SIZE=4><B>5.1.8.4 PZN</B></FONT></P>
<P>PZN is a Code 39 based symbology used by the pharmaceutical
industry in Germany. PZN encodes a 6 digit number and includes a
modulo-10 check digit.</P>
<P><A NAME="LOGMARS"></A><FONT SIZE=4><B>5.1.8.5 LOGMARS</B></FONT></P>
<P>LOGMARS (Logistics Applications of Automated Marking and Reading
Symbols) is a variation of the Code 39 symbology used by the US
Department of Defence. LOGMARS encodes the same character set as
Standard Code 39 and adds a modulo-43 check digit.</P>
<P ALIGN=CENTER><IMG SRC="code39.png" NAME="graphics8" ALIGN=LEFT WIDTH=244 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="CODABAR"></A><FONT SIZE=5><B>5.1.9 Codabar (EN 798)</B></FONT></P>
<P>Also known as NW-7, Monarch, ABC Codabar, USD-4, Ames Code and
Code 27, this symbology was developed in 1972 by Monarch Marketing
Systems for retail purposes. The American Blood Commission adopted
Codabar in 1977 as the standard symbology for blood identification.
Codabar can encode any length string starting and ending with the
letters A-D and containing between these letters the numbers 0-9,
dash (-), dollar ($), colon (:), slash (/), full stop (.) or plus
(+). No check digit is generated.</P>
<P ALIGN=CENTER><IMG SRC="codabar.png" NAME="graphics9" ALIGN=LEFT WIDTH=194 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="PHARMA"></A><FONT SIZE=5><B>5.1.10 Pharmacode</B></FONT></P>
<P>Developed by Laetus, Pharmacode One-Track is used for the
identification of pharmaceuticals. The symbology is able to encode
whole numbers between 3 and 131070.</P>
<P ALIGN=LEFT><IMG SRC="pharma.png" NAME="graphics10" ALIGN=LEFT WIDTH=116 HEIGHT=100 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="CODE128"></A><FONT SIZE=5><B>5.1.11 Code 128</B></FONT></P>
<P><A NAME="CODE128STAND"></A><FONT SIZE=4><B>5.1.11.1 Standard Code
128 (ISO 15417)</B></FONT></P>
<P>One of the most widely used one-dimensional barcode symbologies,
Code 128 was developed in 1981 by Computer Identics. This symbology
supports full ASCII text and uses a three-mode system to compress the
data into a smaller symbol. Zint automatically switches between modes
and adds a modulo-103 check digit. Code 128 is the default barcode
symbology used by Zint. In addition Zint supports the encoding of
Latin-1 (non-English) characters in Code 128 symbols. The Latin-1
character set is shown in <A HREF="appxa.html">Appendix A</A>.</P>
<P><A NAME="CODE128B"></A><FONT SIZE=4><B>5.1.11.2 Code 128 Subset B</B></FONT></P>
<P>It is sometimes advantageous to stop Code 128 from using subset
mode C which compresses numerical data. The <FONT FACE="Courier, monospace">BARCODE_CODE128B</FONT>
option suppresses mode C in favour of mode B.</P>
<P><A NAME="EAN128"></A><FONT SIZE=4><B>5.1.11.3 GS1-128</B></FONT></P>
<P>A variation of Code 128 also known as UCC/EAN-128, this symbology
is defined by the <A HREF="appxc.html">GS1 General Specification.</A>
Application Identifiers (AIs) should be entered using [square
brackets] notation. These will be converted to (round brackets) for
the human readable text. This will allow (round brackets) to be used
in the data strings to be encoded. Fixed length data should be
entered at the appropriate length for correct encoding - this is not
checked by Zint and incorrect length data will result in a symbol
which does not read correctly (see <A HREF="appxc.html">Appendix C</A>).
GS1-128 does not support extended ASCII characters. Check digits for
GTIN data (AI 01) are not generated and need to be included in input
data. The following is an example of a valid GS1-128 input:</P>
<P ALIGN=LEFT STYLE="font-weight: medium"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
--barcode=16 -d &quot;[01]98898765432106[3202]012345[15]991231&quot;</FONT></FONT></P>
<P><A NAME="NVE18"></A><FONT SIZE=4><B>5.1.11.4 NVE-18</B></FONT></P>
<P>A variation of Code 128 the Nummber der Versandeinheit standard
includes both modulo-10 and modulo-103 check digits. NVE-18 requires
a 17 digit numerical input.</P>
<P ALIGN=CENTER><IMG SRC="code128.png" NAME="graphics11" ALIGN=LEFT WIDTH=291 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="DATABAR"></A><FONT SIZE=5><B>5.1.12 GS1
DataBar (ISO 24724)</B></FONT></P>
<P ALIGN=LEFT>Also known as RSS (Reduced Spaced Symbology) these
symbols are due to replace GS1-128 symbols starting in 2010 in
accordance with the <A HREF="http://www.gs1uk.org/EANUCC/WORD_Files/word.html">GS1
General Specification.</A> If a GS1 DataBar symbol is to be printed
with a 2D component as specified in ISO 24723 set <FONT FACE="Courier, monospace">option_1
= 2</FONT> or use the option <FONT FACE="Courier, monospace">--mode=2</FONT>
at the command prompt. See the section <A HREF="composite.html">Composite
Symbols</A> to generate DataBar symbols with 2D components.</P>
<P ALIGN=LEFT><A NAME="RSS14"></A><FONT SIZE=4><B>5.1.12.1 DataBar-14
and DataBar-14 Truncated</B></FONT></P>
<P ALIGN=LEFT STYLE="font-weight: medium"><FONT SIZE=3>Also known as
RSS-14 the DataBar-14 encodes a 13 digit item code. A check digit and
application identifier of (01) are added by Zint. Note that for full
standard compliance symbol height should be greater than or equal to
33 modules. For DataBar-14 Truncated set the symbol height to a
minimum of 13.</FONT></P>
<P ALIGN=LEFT><A NAME="RSSLTD"></A><FONT SIZE=4><B>5.1.12.2 DataBar
Limited</B></FONT></P>
<P ALIGN=LEFT STYLE="font-weight: medium"><FONT SIZE=3>Also known as
RSS Limited the DataBar Limited symbol also encodes 13 digit item
codes and can be used in the same way as DataBar-14 above. DataBar
Limited, however, is limited to data starting with digits 0 and 1
(i.e. numbers in the range 0 to 1999999999999). As with DataBar-14 a
check digit and application identifier of (01) are added by Zint.</FONT></P>
<P ALIGN=LEFT><A NAME="RSSEXP"></A><FONT SIZE=4><B>5.1.12.3 DataBar
Expanded</B></FONT></P>
<P ALIGN=LEFT><FONT SIZE=3><SPAN STYLE="font-weight: medium">Also
known as RSS Expanded this is a variable length symbology capable of
encoding data from a number of AIs in a single symbol. AIs should be
encased in [square brackets] in the input data. This will be
converted to (rounded brackets) before it is included in the human
readable text attached to the symbol. This method allows the
inclusion of rounded brackets in the data to be encoded. GTIN data
(AI 01) should also include the check digit data as this is not
calculated by Zint when this symbology is encoded. </SPAN></FONT><SPAN STYLE="font-weight: medium">Fixed
length data should be entered at the appropriate length for correct
encoding - this is not checked by Zint and incorrect length data will
result in a symbol which does not read correctly (see <A HREF="appxc.html">Appendix
C</A>). </SPAN><FONT SIZE=3><SPAN STYLE="font-weight: medium">The
following is an example of a valid DataBar Expanded input</SPAN></FONT></P>
<P ALIGN=LEFT STYLE="font-weight: medium"><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
--barcode=31 -d &quot;[01]98898765432106[3202]012345[15]991231&quot;</FONT></FONT></P>
<P ALIGN=CENTER><IMG SRC="databar.png" NAME="graphics12" ALIGN=LEFT WIDTH=357 HEIGHT=140 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="symbologies.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="stacked.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Types of Symbol</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Stacked Symbols</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/pdf417.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 566 B

BIN
docs/pharma.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 233 B

BIN
docs/pharma2.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 193 B

BIN
docs/pink.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 372 B

BIN
docs/planet.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 206 B

BIN
docs/plessey.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 1.4 KiB

BIN
docs/postnet.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 195 B

BIN
docs/qr.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 366 B

BIN
docs/rm4scc.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 197 B

172
docs/stacked.html Normal file
View file

@ -0,0 +1,172 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Stacked Symbols</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080316;12224200">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="onedim.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="composite.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1 ALIGN=LEFT>5.2 Stacked Symbologies</H1>
<P ALIGN=LEFT><A NAME="BASIC"></A><FONT SIZE=5><B>5.2.1 Basic Symbol
Stacking</B></FONT></P>
<P ALIGN=LEFT>An early innovation to get more information into a
symbol, used primarily in the vehicle industry, is to simply stack
one-dimensional codes on top of each other. This can be achieved at
the command prompt by giving more than one set of input data. For
example</P>
<P ALIGN=LEFT><FONT FACE="Courier, monospace"><FONT SIZE=2>zint -d
'This' -d 'That'</FONT></FONT></P>
<P ALIGN=LEFT>will draw two Code 128 symbols, one on top of the
other. The same result can be achieved using the API by executing the
<FONT FACE="Courier, monospace">ZBarcode_Encode() </FONT>function
more than once on a symbol. For example:</P>
<P ALIGN=LEFT><FONT FACE="Courier, monospace"><FONT SIZE=2>my_symbol-&gt;symbology
= BARCODE_CODE128;<BR>error = ZBarcode_Encode(my_symbol,
&quot;This&quot;);<BR>error = ZBarcode_Encode(my_symbol,
&quot;That&quot;);<BR>error = ZBarcode_Print(my_symbol);</FONT></FONT></P>
<P ALIGN=LEFT>The example below shows 5 EAN-13 symbols stacked in
this way.</P>
<P ALIGN=LEFT><IMG SRC="stacked.png" NAME="graphics1" ALIGN=LEFT WIDTH=190 HEIGHT=100 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="CODE16K"></A><FONT SIZE=5><B>5.2.2 Code 16k
(EN 12323)</B></FONT></P>
<P ALIGN=LEFT>A more sophisticated method is to use some type of line
indexing which indicates to the barcode reader which order the
symbols should be read. This is demonstrated by Code 16k which uses a
Code128 based system which can stack up to 16 rows in a block. This
gives a maximum data capacity of 77 characters or 154 numerical
digits and includes two modulo-107 check digits. Code 16k also
supports extended ASCII character encoding in the same manner as Code
128.</P>
<P ALIGN=LEFT><IMG SRC="code16k.png" NAME="graphics2" ALIGN=LEFT WIDTH=212 HEIGHT=120 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="PDF417"></A><FONT SIZE=5><B>5.2.3 PDF417 (ISO
15438)</B></FONT></P>
<P ALIGN=LEFT>Heavily used in the parcel industry, the PDF417
symbology can encode a vast amount of data into a small space. Zint
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<SUP>(value + 1)</SUP>. If using the API these values are assigned
to <FONT FACE="Courier, monospace">option_2</FONT> and <FONT FACE="Courier, monospace">option_1</FONT>
respectively. 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 <A HREF="appxa.html">Appendix
A</A>.</P>
<P ALIGN=LEFT><IMG SRC="pdf417.png" NAME="graphics3" ALIGN=LEFT WIDTH=240 HEIGHT=54 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="PDF417T"></A><FONT SIZE=5><B>5.2.4 Compact
PDF417</B></FONT></P>
<P ALIGN=LEFT>Also known as truncated PDF417. Options are as for
PDF417 above.</P>
<P ALIGN=LEFT><IMG SRC="compact417.png" NAME="graphics4" ALIGN=LEFT WIDTH=172 HEIGHT=54 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="MICROPDF"></A><FONT SIZE=5><B>5.2.5
MicroPDF417 (ISO 24728)</B></FONT></P>
<P ALIGN=LEFT>A variation of the PDF417 standard, MicroPDF417 is
intended for applications where symbol size needs to be kept to a
minimum. 34 pre-defined symbol sizes are available with 1 - 4 columns
and 4 - 44 rows. The maximum size MicroPDF417 symbol can hold 250
alphanumeric characters or 366 digits. The amount of error correction
used is dependant on symbol size. The number of columns used can be
determined using the <FONT FACE="Courier, monospace">--cols</FONT>
switch or <FONT FACE="Courier, monospace">option_2</FONT> as with
PDF417.</P>
<P ALIGN=LEFT><IMG SRC="micropdf.png" NAME="graphics5" ALIGN=LEFT WIDTH=110 HEIGHT=80 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="RSS14STACK"></A><FONT SIZE=5><B>5.2.6 GS1
DataBar-14 Stacked (ISO 24724)</B></FONT></P>
<P ALIGN=LEFT>A stacked variation of the GS1 DataBar-14 symbol
requiring the same input (see section <A HREF="onedim.html#RSS14">5.1.12.1</A>).
The height of this symbol is fixed. The data is encoded in two rows
of bars with a central finder pattern. This symbol can be generated
with a two-dimensional component to make a <A HREF="composite.html">composite
symbol</A>.</P>
<P ALIGN=LEFT><IMG SRC="dbstack.png" NAME="graphics6" ALIGN=LEFT WIDTH=100 HEIGHT=26 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="RSS14OMNI"></A><FONT SIZE=5><B>5.2.7 GS1
DataBar-14 Stacked Omnidirectional (ISO 24724)</B></FONT></P>
<P ALIGN=LEFT>Another variation of the GS1 DataBar-14 symbol
requiring the same input (see section <A HREF="onedim.html#RSS14">5.1.12.1</A>).
The data is encoded in two rows of bars with a central finder
pattern. This symbol can be generated with a two-dimensional
component to make a <A HREF="composite.html">composite symbol</A>.</P>
<P ALIGN=LEFT><IMG SRC="dbomni.png" NAME="graphics7" ALIGN=LEFT WIDTH=100 HEIGHT=138 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="RSSEXPSTACK"></A><FONT SIZE=5><B>5.2.8 GS1
DataBar Expanded Stacked (ISO 24724)</B></FONT></P>
<P ALIGN=LEFT>A stacked variation of the GS1 DataBar Expanded symbol
for smaller packages. Input is the same as for GS1 DataBar Expanded
(see section <A HREF="onedim.html#RSSEXP">5.1.12.3</A>). In addition
the width of the symbol can be altered using the <FONT FACE="Courier, monospace">--cols</FONT>
switch or <FONT FACE="Courier, monospace">option_2</FONT>. 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 <A HREF="composite.html">composite
symbol</A>.</P>
<P ALIGN=LEFT><IMG SRC="dbexpand.png" NAME="graphics8" ALIGN=LEFT WIDTH=204 HEIGHT=100 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="onedim.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="composite.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>One-Dimensional Symbols</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Composite Symbols</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/stacked.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 457 B

183
docs/symbologies.html Normal file
View file

@ -0,0 +1,183 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Types of Symbol</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080316;13273800">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="backend.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="onedim.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>5. Types of Symbol</H1>
<P STYLE="font-style: normal">This section is intended to be a brief
guide to the barcode symbologies supported by Zint. The symbologies
break down easily into groups as shown in the table below. Each group
has a page dedicated to it.</P>
<P ALIGN=JUSTIFY STYLE="margin-bottom: 0cm"><BR>
</P>
<CENTER>
<TABLE WIDTH=868 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=265>
<COL WIDTH=318>
<COL WIDTH=247>
<THEAD>
<TR VALIGN=TOP>
<TH WIDTH=265>
<P>Symbol Type</P>
</TH>
<TH WIDTH=318>
<P>Example Symbol</P>
</TH>
<TH WIDTH=247>
<P>Example Symbologies</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN=TOP>
<TD WIDTH=265>
<P ALIGN=CENTER><A HREF="onedim.html">One-Dimensional</A></P>
</TD>
<TD WIDTH=318>
<P ALIGN=CENTER><IMG SRC="box.png" NAME="graphics1" ALIGN=BOTTOM WIDTH=238 HEIGHT=120 BORDER=0></P>
</TD>
<TD WIDTH=247>
<P ALIGN=CENTER STYLE="font-style: normal; font-weight: medium">Code
11, Code 2 of 5, UPC, EAN, Plessey, MSI, Telepen, Code 39,
Codabar, Pharmacode</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=265>
<P ALIGN=CENTER><A HREF="stacked.html">Stacked Symbols</A></P>
</TD>
<TD WIDTH=318>
<P ALIGN=CENTER><IMG SRC="code16k.png" NAME="graphics2" ALIGN=BOTTOM WIDTH=212 HEIGHT=120 BORDER=0></P>
</TD>
<TD WIDTH=247>
<P ALIGN=CENTER STYLE="font-style: normal; font-weight: medium">Code
16k, PDF417</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=265>
<P ALIGN=CENTER><A HREF="composite.html">Composite Symbols</A></P>
</TD>
<TD WIDTH=318>
<P ALIGN=CENTER><IMG SRC="cca.png" NAME="graphics3" ALIGN=BOTTOM WIDTH=160 HEIGHT=146 BORDER=0></P>
</TD>
<TD WIDTH=247>
<P ALIGN=CENTER>CC-A, CC-B, CC-C</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=265>
<P ALIGN=CENTER><A HREF="twotrack.html">Two-Track Symbols</A></P>
</TD>
<TD WIDTH=318>
<P ALIGN=CENTER><IMG SRC="postnet.png" NAME="graphics4" ALIGN=BOTTOM WIDTH=246 HEIGHT=24 BORDER=0></P>
</TD>
<TD WIDTH=247>
<P ALIGN=CENTER STYLE="font-style: normal; font-weight: medium">Two-Track
Pharmacode, PostNet, PLANET</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=265>
<P ALIGN=CENTER><A HREF="fourstate.html">4-State Codes</A></P>
</TD>
<TD WIDTH=318>
<P ALIGN=CENTER><IMG SRC="auspost.png" NAME="graphics5" ALIGN=BOTTOM WIDTH=266 HEIGHT=20 BORDER=0></P>
</TD>
<TD WIDTH=247>
<P ALIGN=CENTER STYLE="font-style: normal; font-weight: medium">USPS
OneCode, RM4SCC, Australia Post 4-State Codes</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=265>
<P ALIGN=CENTER><A HREF="twodims.html">Two-Dimensional</A></P>
</TD>
<TD WIDTH=318>
<P ALIGN=CENTER><IMG SRC="qr.png" NAME="graphics6" ALIGN=BOTTOM WIDTH=50 HEIGHT=50 BORDER=0></P>
</TD>
<TD WIDTH=247>
<P ALIGN=CENTER STYLE="font-style: normal; font-weight: medium">Data
Matrix, QR Code, Maxicode</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=265>
<P ALIGN=CENTER><A HREF="markings.html">Other Markings</A></P>
</TD>
<TD WIDTH=318>
<P ALIGN=CENTER><IMG SRC="fim.png" NAME="graphics7" ALIGN=BOTTOM WIDTH=30 HEIGHT=100 BORDER=0></P>
</TD>
<TD WIDTH=247>
<P ALIGN=CENTER STYLE="font-style: normal; font-weight: medium">FIM,
Flattermarken</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<P ALIGN=JUSTIFY><BR><BR>
</P>
<P><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="backend.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="onedim.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Using the API</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>One-Dimensional Symbols</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/telepen.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 984 B

375
docs/twodims.html Normal file
View file

@ -0,0 +1,375 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Two-Dimensional Symbols</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080422;8283700">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="fourstate.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="markings.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1>5.6 Two-Dimensional Symbols</H1>
<P><A NAME="DMATRIX"></A><FONT SIZE=5><B>5.6.1 Data Matrix (ISO
16022)</B></FONT></P>
<P>Also known as Semacode this symbology can encode a large amount of
data in a small area. Any length ASCII string can be encoded up to
780 characters. Symbol size is determined by the length of the input
data and Reed-Solomon error correction is added.</P>
<P ALIGN=CENTER><IMG SRC="matrix.png" NAME="graphics1" ALIGN=LEFT WIDTH=44 HEIGHT=44 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="QRCODE"></A><FONT SIZE=5><B>5.6.2 QR Code (ISO 18004)</B></FONT></P>
<P>Also known as Quick Response Code this symbology was developed by
Denso. QR Code support in Zint relies on <I>libqrencode</I> (version
2.0.0) which is available from
<A HREF="http://megaui.net/fukuchi/works/qrencode/index.en.html">http://megaui.net/fukuchi/works/qrencode/index.en.html</A>.
Support for QR Code through <I>libzint</I> means that developers only
need to write handlers for one API which covers QR Code as well as
all of the other code symbologies provided by <I>libzint</I>. Four
levels of error correction are available using the <FONT FACE="Courier, monospace">security=</FONT>
option or setting <FONT FACE="Courier, monospace">option_1</FONT> as
shown in the following table.</P>
<DL>
<DL>
<DL>
<DL>
<DL>
<DL>
<DL>
<DD>
<TABLE WIDTH=715 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=74>
<COL WIDTH=113>
<COL WIDTH=261>
<COL WIDTH=218>
<TR VALIGN=TOP>
<TD WIDTH=74>
<P ALIGN=CENTER><B>Input</B></P>
</TD>
<TD WIDTH=113>
<P ALIGN=CENTER><B>ECC Level</B></P>
</TD>
<TD WIDTH=261>
<P ALIGN=CENTER><B>Error Correction Capacity</B></P>
</TD>
<TD WIDTH=218>
<P ALIGN=CENTER><B>Recovery Capacity</B></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=74>
<P ALIGN=CENTER>1</P>
</TD>
<TD WIDTH=113>
<P ALIGN=CENTER>L (default)</P>
</TD>
<TD WIDTH=261>
<P ALIGN=CENTER>Approx 20% of symbol</P>
</TD>
<TD WIDTH=218>
<P ALIGN=CENTER>Approx 7%</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=74>
<P ALIGN=CENTER>2</P>
</TD>
<TD WIDTH=113>
<P ALIGN=CENTER>M</P>
</TD>
<TD WIDTH=261>
<P ALIGN=CENTER>Approx 37% of symbol</P>
</TD>
<TD WIDTH=218>
<P ALIGN=CENTER>Approx 15%</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=74>
<P ALIGN=CENTER>3</P>
</TD>
<TD WIDTH=113>
<P ALIGN=CENTER>Q</P>
</TD>
<TD WIDTH=261>
<P ALIGN=CENTER>Approx 55% of symbol</P>
</TD>
<TD WIDTH=218>
<P ALIGN=CENTER>Approx 25%</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=74>
<P ALIGN=CENTER>4</P>
</TD>
<TD WIDTH=113>
<P ALIGN=CENTER>H</P>
</TD>
<TD WIDTH=261>
<P ALIGN=CENTER>Approx 65% of symbol</P>
</TD>
<TD WIDTH=218>
<P ALIGN=CENTER>Approx 30%</P>
</TD>
</TR>
</TABLE>
</DL>
</DL>
</DL>
</DL>
</DL>
</DL>
</DL>
<P><BR><BR>
</P>
<P>The size of the symbol can be set by using the <FONT FACE="Courier, monospace">vers=</FONT>
option or setting <FONT FACE="Courier, monospace">option_2</FONT> to
the QR Code version required (1-40). The maximum capacity of a
(version 40) QR Code symbol is 7089 numeric digits, 4296 alphanumeric
characters or 2953 bytes of data.</P>
<P ALIGN=CENTER><IMG SRC="qr.png" NAME="graphics2" ALIGN=LEFT WIDTH=50 HEIGHT=50 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P><A NAME="MAXI"></A><FONT SIZE=5><B>5.6.3 Maxicode (ISO 16023)</B></FONT></P>
<P ALIGN=LEFT>Developed by UPS the Maxicode symbology employs a grid
of hexagons surrounding a 'bulls-eye' finder pattern. This symbology
is designed for the identification of parcels. Zint encodes Maxicode
symbols in Mode 2 or Mode 3 depending on the postcode data entered.
In these modes Maxicode symbols are composed of two parts named the
primary and secondary messages. The primary message consists of a
structured data field which includes various data about the package
being sent, the secondary message usually consists of address data in
a data structure. The format of the primary message is given in the
following table:
</P>
<CENTER>
<TABLE WIDTH=810 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=270>
<COL WIDTH=513>
<THEAD>
<TR VALIGN=TOP>
<TH WIDTH=270>
<P>Characters</P>
</TH>
<TH WIDTH=513>
<P>Meaning</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN=TOP>
<TD WIDTH=270>
<P ALIGN=CENTER>1-9</P>
</TD>
<TD WIDTH=513>
<P ALIGN=CENTER>Postcode data which can consist of up to 9
digits (for mode 2) or up to 6 alphanumeric characters (for mode
3). Remaining unused characters should be filled with the SPACE
character (ASCII 32).</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=270>
<P ALIGN=CENTER>10-12</P>
</TD>
<TD WIDTH=513>
<P ALIGN=CENTER>Three digit country code according to ISO 3166
(see <A HREF="appxb.html">Appendix B</A>).</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=270>
<P ALIGN=CENTER>13-15</P>
</TD>
<TD WIDTH=513>
<P ALIGN=CENTER>Three digit service code. This depends on your
parcel courier.</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<P ALIGN=LEFT><BR><BR>
</P>
<P ALIGN=LEFT>The primary message can be designated at the command
prompt using the <FONT FACE="Courier, monospace">--primary=</FONT>
switch. The secondary message uses the normal data entry method. For
example:</P>
<P ALIGN=LEFT><FONT FACE="Courier, monospace">zint -o test.eps -b 57
--primary='999999999840012' -d 'Secondary Message Here'</FONT></P>
<P ALIGN=LEFT>When using the API the primary message must be placed
in the <FONT FACE="Courier, monospace">symbol-&gt;primary</FONT>
string. The secondary is entered in the same way as described in
section 4.2.</P>
<P ALIGN=LEFT>Modes 4 to 6 can be encoded using the <FONT FACE="Courier, monospace">--mode=</FONT>
switch or by setting <FONT FACE="Courier, monospace">option_1</FONT>.
Modes 4 to 6 do not require a primary message. For example:</P>
<P ALIGN=LEFT><FONT FACE="Courier, monospace">zint -o test.eps -b 57
--mode=4 -d 'A MaxiCode Message in Mode 4'</FONT></P>
<P ALIGN=LEFT>Mode 6 is reserved for the maintenance of scanner
hardware and should not be used to encode user data. All modes
support extended ASCII characters and number compression. The maximum
length of text which can be placed in a Maxicode symbol depends on
the type of characters used in the text. Example maximum data lengths
are given in the table below:</P>
<CENTER>
<TABLE WIDTH=664 BORDER=1 CELLPADDING=4 CELLSPACING=3>
<COL WIDTH=138>
<COL WIDTH=160>
<COL WIDTH=164>
<COL WIDTH=153>
<THEAD>
<TR VALIGN=TOP>
<TH WIDTH=138>
<P>Mode</P>
</TH>
<TH WIDTH=160>
<P>Maximum Data Length for Capital Letters</P>
</TH>
<TH WIDTH=164>
<P>Maximum Data Length for Numeric Digits</P>
</TH>
<TH WIDTH=153>
<P>Number of Error Correction Codewords</P>
</TH>
</TR>
</THEAD>
<TBODY>
<TR VALIGN=TOP>
<TD WIDTH=138>
<P ALIGN=CENTER>2 (secondary only)</P>
</TD>
<TD WIDTH=160>
<P ALIGN=CENTER>84</P>
</TD>
<TD WIDTH=164>
<P ALIGN=CENTER>126</P>
</TD>
<TD WIDTH=153>
<P ALIGN=CENTER>50</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=138>
<P ALIGN=CENTER>3 (secondary only)</P>
</TD>
<TD WIDTH=160>
<P ALIGN=CENTER>84</P>
</TD>
<TD WIDTH=164>
<P ALIGN=CENTER>126</P>
</TD>
<TD WIDTH=153>
<P ALIGN=CENTER>50</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=138>
<P ALIGN=CENTER>4</P>
</TD>
<TD WIDTH=160>
<P ALIGN=CENTER>93</P>
</TD>
<TD WIDTH=164>
<P ALIGN=CENTER>135</P>
</TD>
<TD WIDTH=153>
<P ALIGN=CENTER>50</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=138>
<P ALIGN=CENTER>5</P>
</TD>
<TD WIDTH=160>
<P ALIGN=CENTER>77</P>
</TD>
<TD WIDTH=164>
<P ALIGN=CENTER>110</P>
</TD>
<TD WIDTH=153>
<P ALIGN=CENTER>66</P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=138>
<P ALIGN=CENTER>6</P>
</TD>
<TD WIDTH=160>
<P ALIGN=CENTER>93</P>
</TD>
<TD WIDTH=164>
<P ALIGN=CENTER>135</P>
</TD>
<TD WIDTH=153>
<P ALIGN=CENTER>50</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<P ALIGN=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><B>PLEASE NOTE</B> that due to the unique style of the
Maxicode symbol not all of the options available for other
symbologies are available. Settings for height, whitespace width,
border width and output options will be ignored. Colour options are
available as with other symbologies. PNG output is set at a
resolution of 12 pixels per millimetre (approx 300 dpi) and uses the
methods set out in Annex J of the ISO/IEC standard.</P>
<P ALIGN=LEFT><IMG SRC="maxicode.png" NAME="graphics3" ALIGN=LEFT WIDTH=150 HEIGHT=150 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="fourstate.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="markings.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>4-State Codes</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>Markings</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

95
docs/twotrack.html Normal file
View file

@ -0,0 +1,95 @@
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
<TITLE>Two-Track Symbols</TITLE>
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.3 (Linux)">
<META NAME="CREATED" CONTENT="20070730;21081900">
<META NAME="CHANGED" CONTENT="20080316;13023600">
<STYLE TYPE="text/css">
<!--
TD P { color: #000000 }
H1 { color: #000000 }
P { color: #000000 }
TH P { color: #000000 }
A:link { color: #0000ff }
A:visited { color: #840084 }
-->
</STYLE>
</HEAD>
<BODY LANG="en-GB" TEXT="#000000" LINK="#0000ff" VLINK="#840084" BGCOLOR="#ffffff" DIR="LTR">
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0 STYLE="page-break-before: always">
<TR>
<TH COLSPAN=3>
<P ALIGN=CENTER>Zint Barcode Generator</P>
</TH>
</TR>
<TR VALIGN=BOTTOM>
<TD WIDTH=10%>
<P ALIGN=LEFT><A HREF="composite.html">Prev</A></P>
</TD>
<TD WIDTH=80%></TD>
<TD WIDTH=10%>
<P ALIGN=RIGHT><A HREF="fourstate.html">Next</A></P>
</TD>
</TR>
</TABLE>
<HR>
<H1 ALIGN=LEFT>5.4 Two-Track Symbols</H1>
<P ALIGN=LEFT><A NAME="PHARMA"></A><FONT SIZE=5><B>5.4.1 Two-Track
Pharmacode</B></FONT></P>
<P ALIGN=LEFT>Developed by Laetus, Pharmacode Two-Track is an
alternative system to Pharmacode One-Track used for the
identification of pharmaceuticals. The symbology is able to encode
whole numbers between 4 and 64570080.</P>
<P ALIGN=LEFT><IMG SRC="pharma2.png" NAME="graphics1" ALIGN=LEFT WIDTH=58 HEIGHT=100 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="POSTNET"></A><FONT SIZE=5><B>5.4.2 PostNet</B></FONT></P>
<P ALIGN=LEFT>Used by the United States Postal Service and due to be
superseded by the OneCode system by 2009, the PostNet barcode is used
for encoding zip-codes on mail items. PostNet uses numerical input
data and includes a modulo-10 check digit. While Zint will encode
PostNet symbols of any length, standard lengths used by USPS are
PostNet6 (5 digits ZIP input), PostNet10 (5 digit ZIP + 4 digit user
data) and PostNet12 (5 digit ZIP + 6 digit user data).</P>
<P ALIGN=LEFT><IMG SRC="postnet.png" NAME="graphics2" ALIGN=LEFT WIDTH=246 HEIGHT=24 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P ALIGN=LEFT><A NAME="PLANET"></A><FONT SIZE=5><B>5.4.3 PLANET</B></FONT></P>
<P ALIGN=LEFT>Used by the United States Postal Service and due to be
superseded by the OneCode system by 2009, the PLANET (Postal Alpha
Numeric Encoding Technique) barcode is used for encoding routing data
on mail items. Planet uses numerical input data and includes a
modulo-10 check digit. While Zint will encode PLANET symbols of any
length, standard lengths used by USPS are Planet12 (11 digit input)
and Planet14 (13 digit input).</P>
<P ALIGN=LEFT><IMG SRC="planet.png" NAME="graphics3" ALIGN=LEFT WIDTH=286 HEIGHT=24 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
<TR VALIGN=TOP>
<TD WIDTH=33% HEIGHT=5>
<P ALIGN=LEFT><A HREF="composite.html">Prev</A></P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER><A HREF="index.html">Home</A></P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT><A HREF="fourstate.html">Next</A></P>
</TD>
</TR>
<TR VALIGN=TOP>
<TD WIDTH=33%>
<P ALIGN=LEFT>Composite Symbols</P>
</TD>
<TD WIDTH=34%>
<P ALIGN=CENTER>&nbsp;</P>
</TD>
<TD WIDTH=33%>
<P ALIGN=RIGHT>4-State Codes</P>
</TD>
</TR>
</TABLE>
<P><BR><BR>
</P>
</BODY>
</HTML>

BIN
docs/upca.png Normal file
View file

Binary file not shown.
Side by side

After

Width:  |  Height:  |  Size: 2.1 KiB