zint/docs/frontend.html

816 lines
18 KiB
HTML
Raw Normal View History

2008-07-14 09:15:55 +12:00
<!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>
</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>
2009-01-03 10:09:16 +13:00
<P><A NAME="INPUT"></A><FONT SIZE=5><B>3.1 Inputting data</B></FONT>
</P>
2009-01-25 04:54:07 +13:00
<P>The data to encode can be entered at
2008-07-14 09:15:55 +12:00
the command line using the -d option, for example:</P>
2009-01-25 04:54:07 +13:00
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
2008-07-14 09:15:55 +12:00
-d 'This Text'</FONT></FONT></P>
2009-01-25 04:54:07 +13:00
<P>This will encode the text <I>This Text</I>.
2008-07-14 09:15:55 +12:00
Zint will use the default symbology, Code 128, and output to the
default file out.png in the current directory.
</P>
2009-01-25 04:54:07 +13:00
<P><A NAME="OUTPUT"></A><FONT SIZE=5><B>3.2
2008-07-14 09:15:55 +12:00
Directing Output</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>Output can be directed to a file other
2008-07-14 09:15:55 +12:00
than the default using the -o switch. For example:</P>
2009-01-25 04:54:07 +13:00
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
2008-07-14 09:15:55 +12:00
-o here.png -d 'This Text'</FONT></FONT></P>
2009-01-25 04:54:07 +13:00
<P>draws a Code 128 barcode in the file
2008-07-14 09:15:55 +12:00
here.png. If an encapsulated Post Script file is needed simply append
the file name with .eps:</P>
2009-01-25 04:54:07 +13:00
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
2008-07-14 09:15:55 +12:00
-o there.eps -d 'This Text'</FONT></FONT></P>
2009-01-03 10:09:16 +13:00
<P>Output can also be directed to stdout using the --<FONT FACE="Courier, monospace">directeps</FONT>
and --<FONT FACE="Courier, monospace">directpng</FONT> switches for
EPS and PNG output respectively.</P>
2009-01-25 04:54:07 +13:00
<P><A NAME="BARTYPE"></A><FONT SIZE=5><B>3.3
2008-07-14 09:15:55 +12:00
Selecting barcode type</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>Selecting which type of barcode you
2008-07-14 09:15:55 +12:00
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>
<CENTER>
2009-01-25 04:54:07 +13:00
<TABLE WIDTH=60% BORDER=1>
2008-07-14 09:15:55 +12:00
<THEAD>
2009-01-25 04:54:07 +13:00
<TR>
<TH>
<P>Numeric Value</P>
2008-07-14 09:15:55 +12:00
</TH>
2009-01-25 04:54:07 +13:00
<TH>
2008-07-14 09:15:55 +12:00
<P>Barcode Name</P>
</TH>
</TR>
</THEAD>
<TBODY>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>1</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 11</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>2</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Standard Code 2 of 5</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>3</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Interleaved 2 of 5</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>4</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 2 of 5 IATA</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>6</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 2 of 5 Data Logic</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>7</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 2 of 5 Industrial</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>8</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 3 of 9 (Code 39)</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>9</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Extended Code 3 of 9 (Code 39+)</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>13</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>EAN</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>16</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>GS1-128 (UCC.EAN-128)</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>18</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Codabar</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>20</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 128 (automatic subset switching)</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>21</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Deutshe Post Leitcode</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>22</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Deutshe Post Identcode</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>23</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 16K</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>25</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 93</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>28</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Flattermarken</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>29</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>GS1 DataBar-14</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>30</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>GS1 DataBar Limited</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>31</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>GS1 DataBar Extended</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>32</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Telepen Alpha</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>34</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>UPC A</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>37</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>UPC E</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>40</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>PostNet</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>47</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>MSI Plessey</P>
2008-07-14 09:15:55 +12:00
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>49</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>FIM</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>50</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>LOGMARS</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>51</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Pharmacode One-Track</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>52</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>PZN</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>53</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Pharmacode Two-Track</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>55</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>PDF417</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>56</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>PDF417 Truncated</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>57</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Maxicode</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>58</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>QR Code</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>60</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Code 128 (Subset B)</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>63</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Australia Post Standard Customer</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>66</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Australia Post Reply Paid</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>67</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Australia Post Routing</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>68</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Australia Post Redirection</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>69</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>ISBN (EAN-13 with verification stage)</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>70</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Royal Mail 4 State (RM4SCC)</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>71</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Data Matrix</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>72</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>EAN-14</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>74</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>Codablock-F</P>
2008-07-14 09:15:55 +12:00
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>75</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>NVE-18</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2009-01-03 10:09:16 +13:00
<P ALIGN=CENTER>77</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2009-01-03 10:09:16 +13:00
<P ALIGN=CENTER>Korea Post</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>79</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>GS1 DataBar-14 Stacked</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>80</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>GS1 DataBar-14 Stacked Omnidirectional</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>81</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>GS1 DataBar Expanded Stacked</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>82</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>PLANET</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>84</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>MicroPDF417</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>85</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>USPS OneCode</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>86</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Plessey Code</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>87</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Telepen Numeric</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>89</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>ITF-14</P>
2008-07-14 09:15:55 +12:00
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>90</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>Dutch Post KIX Code</P>
2008-07-14 09:15:55 +12:00
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>92</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>Aztec Code</P>
2008-07-14 09:15:55 +12:00
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>93</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>DAFT Code</P>
2008-07-14 09:15:55 +12:00
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
<P ALIGN=CENTER>97</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
<P ALIGN=CENTER>Micro QR Code</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-11-09 23:06:05 +13:00
<P ALIGN=CENTER>128</P>
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-11-09 23:06:05 +13:00
<P ALIGN=CENTER>Aztec Runes</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>129</P>
2008-09-03 08:27:56 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>Code 32</P>
2008-09-03 08:27:56 +12:00
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>130</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with EAN linear component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>131</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with GS1-128 linear component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>132</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 linear
component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>133</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Limited
component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>134</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Extended
component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>135</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with UPC A linear component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>136</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with UPC E linear component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>137</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 Stacked
component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>138</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar-14 Stacked
Omnidirectional component</P>
</TD>
</TR>
2009-01-25 04:54:07 +13:00
<TR>
<TD>
2008-09-20 18:07:05 +12:00
<P ALIGN=CENTER>139</P>
2008-07-14 09:15:55 +12:00
</TD>
2009-01-25 04:54:07 +13:00
<TD>
2008-07-14 09:15:55 +12:00
<P ALIGN=CENTER>Composite Symbol with GS1 DataBar Expanded
Stacked component</P>
</TD>
</TR>
</TBODY>
</TABLE>
</CENTER>
<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>
2009-01-25 04:54:07 +13:00
<P><A NAME="WHITESPACE"></A><FONT SIZE=5><B>3.5
2008-07-14 09:15:55 +12:00
Adjusting whitespace</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>The amount of whitespace to the left
2008-07-14 09:15:55 +12:00
and right of the generated barcode can be altered using the -w
switch. For example:</P>
2009-01-25 04:54:07 +13:00
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
2008-07-14 09:15:55 +12:00
-w 10 -d 'This Text'</FONT></FONT></P>
2009-01-25 04:54:07 +13:00
<P>specifies a whitespace width of 10
2008-07-14 09:15:55 +12:00
times the <I>x-resolution</I> of the symbol.</P>
2009-01-25 04:54:07 +13:00
<P><A NAME="BOUNDARY"></A><FONT SIZE=5><B>3.6
2008-07-14 09:15:55 +12:00
Adding boundary bars and boxes</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>Zint allows the symbol to be bound with
2008-07-14 09:15:55 +12:00
'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>
2009-01-25 04:54:07 +13:00
<P>The width of the boundary or box can be
2008-07-14 09:15:55 +12:00
specified using the --border switch. For example:</P>
2009-01-25 04:54:07 +13:00
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
2008-07-14 09:15:55 +12:00
--box --border=10 -d 'This'</FONT></FONT></P>
2009-01-25 04:54:07 +13:00
<P>gives a box with a width 10 times the
2008-07-14 09:15:55 +12:00
<I>x-resolution</I> of the symbol.</P>
2009-01-25 04:54:07 +13:00
<TABLE WIDTH=100% BORDER=0>
<TR>
2008-07-14 09:15:55 +12:00
<TD WIDTH=50%>
2008-09-03 08:27:56 +12:00
<P ALIGN=CENTER><IMG SRC="border.png" NAME="graphics2" ALT="bound symbol" ALIGN=MIDDLE WIDTH=238 HEIGHT=138 BORDER=0></P>
2008-07-14 09:15:55 +12:00
</TD>
<TD WIDTH=50%>
2008-09-03 08:27:56 +12:00
<P ALIGN=CENTER><IMG SRC="box.png" NAME="graphics1" ALT="boxed symbol" ALIGN=MIDDLE WIDTH=238 HEIGHT=138 BORDER=0></P>
2008-07-14 09:15:55 +12:00
</TD>
</TR>
</TABLE>
2009-01-25 04:54:07 +13:00
<P><A NAME="COLOUR"></A><FONT SIZE=5><B>3.7
2008-07-14 09:15:55 +12:00
Using colour</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>The default colours of a symbol are a
2008-07-14 09:15:55 +12:00
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>
2009-01-25 04:54:07 +13:00
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
2008-07-14 09:15:55 +12:00
-r -d 'This'</FONT></FONT></P>
2009-01-25 04:54:07 +13:00
<P>gives an inverted Code 128 symbol. This
2008-07-14 09:15:55 +12:00
is not practical for most symbologies but white-on-black is allowed
2008-09-03 08:27:56 +12:00
by the Data Matrix and Aztec Code symbology specifications.</P>
2009-01-25 04:54:07 +13:00
<P>For more specific needs the foreground
2008-09-03 08:27:56 +12:00
and background colours can be specified using the <FONT FACE="Courier, monospace">--fg=</FONT>
and <FONT FACE="Courier, monospace">--bg=</FONT> options followed by
a number in RGB hexadecimal notation (the same system used in HTML).
For example the command
2008-07-14 09:15:55 +12:00
</P>
2009-01-25 04:54:07 +13:00
<P><FONT FACE="Courier, monospace"><FONT SIZE=2>zint
2008-07-14 09:15:55 +12:00
--fg=004700 -d 'This'</FONT></FONT></P>
2009-01-25 04:54:07 +13:00
<P>alters the symbol to a dark green as
2008-07-14 09:15:55 +12:00
shown below.</P>
2009-01-25 04:54:07 +13:00
<TABLE WIDTH=100% BORDER=0>
<TR>
2008-07-14 09:15:55 +12:00
<TD WIDTH=50%>
2008-09-03 08:27:56 +12:00
<P ALIGN=CENTER><IMG SRC="green.png" NAME="graphics3" ALT="symbol with green ink" ALIGN=BOTTOM WIDTH=238 HEIGHT=138 BORDER=0></P>
2008-07-14 09:15:55 +12:00
</TD>
<TD WIDTH=50%>
2008-09-03 08:27:56 +12:00
<P ALIGN=CENTER><IMG SRC="pink.png" NAME="graphics4" ALT="symbol with pink paper" ALIGN=BOTTOM WIDTH=238 HEIGHT=138 BORDER=0></P>
2008-07-14 09:15:55 +12:00
</TD>
</TR>
</TABLE>
2009-01-25 04:54:07 +13:00
<P><A NAME="ROTATE"></A><FONT SIZE=5><B>3.8
2008-09-03 08:27:56 +12:00
Rotating the Symbol</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>The
2008-09-03 08:27:56 +12:00
symbol can be rotated through four orientations using the <FONT FACE="Courier, monospace">--rotate=</FONT>
option followed by the angle of rotation as shown below. This option
2009-01-25 04:54:07 +13:00
is only available with PNG output.</P>
<TABLE WIDTH=100% BORDER=1>
<TR>
<TD>
<P ALIGN=CENTER><IMG SRC="bar38n.png" NAME="graphics5" WIDTH=200 HEIGHT=118 BORDER=0>
<BR><FONT FACE="Courier, monospace"><FONT SIZE=3>--rotate=0</FONT></FONT><FONT SIZE=3>
(default)</FONT></P>
</TD>
<TD>
<P ALIGN=CENTER><IMG SRC="bar38u.png" NAME="graphics6" WIDTH=200 HEIGHT=118 BORDER=0>
<BR><FONT FACE="Courier, monospace"><FONT SIZE=3>--rotate=180</FONT></FONT></P>
</TD>
</TR>
<TR>
<TD>
<P ALIGN=CENTER><IMG SRC="bar38l.png" NAME="graphics7" WIDTH=118 HEIGHT=200 BORDER=0>
<BR><FONT FACE="Courier, monospace"><FONT SIZE=3>--rotate=270</FONT></FONT></P>
</TD>
<TD>
<P ALIGN=CENTER><IMG SRC="bar38r.png" NAME="graphics8" WIDTH=118 HEIGHT=200 BORDER=0>
<BR><FONT FACE="Courier, monospace"><FONT SIZE=3>--rotate=90</FONT></FONT></P>
</TD>
</TR>
</TABLE>
<P><A NAME="SCALE"></A><FONT SIZE=5><B>3.9
2009-01-03 10:09:16 +13:00
Adjusting image size</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>The scale of the image can be altered
2009-01-03 10:09:16 +13:00
using the <FONT FACE="Courier, monospace">--scale=</FONT> option
followed by a multiple of the default x-dimension. For example for
PNG images a scale of 5 will increase the x-dimension to 10 pixels.
Note that Maxicode symbols output as PNG images cannot be scaled in
this way and that text added to a barcode in PNG images does not
change size.
2008-09-03 08:27:56 +12:00
</P>
2009-01-25 04:54:07 +13:00
<P><A NAME="NULL"></A><FONT SIZE=5><B>3.10
2009-01-03 10:09:16 +13:00
Handling NULL Characters</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>Some symbologies support encoding of
2009-01-03 10:09:16 +13:00
the NULL character (ASCII 0) normally used to indicate the end of a
character string. To support this functionality the <FONT FACE="Courier, monospace">--null=</FONT>
option allows you to substitute another character for NULL. Enter the
decimal number for the character you wish to substitute. For example
<FONT FACE="Courier, monospace">--null=21</FONT> instructs Zint to
treat the NAK control character as a NULL character. Values between 1
2009-01-25 04:54:07 +13:00
and 128 are valid. This applies to Codablock-F, Code 128,
Code 16k, Extended Code 39, Code 93, Maxicode, PDF417, MicroPDF417,
Data Matrix (ECC 200 only) and Telepen.</P>
<P><A NAME="INMODE"></A><FONT SIZE=5><B>3.11
Input modes</B></FONT></P>
<P>GS1 data can be encoded in a number of symbologies. Application
identifiers are enclosed in [square brackets] followed by the data to
be encoded (see 5.1.12.3). To encode GS1 data use
<FONT FACE="Courier, monospace">--gs1</FONT>. GS1 mode is assumed
(and doesn't need to be set) for EAN-128, DataBar and Composite symbologies
but is also available for Code 16k, Codablock-F, Data Matrix (ECC 200 only),
and Aztec Code.</P>
<P>QR Code can encode Kaji characters. This can be accessed using the
<FONT FACE="Courier, monospace">--kanji</FONT> option.</P>
<P><A NAME="OTHER"></A><FONT SIZE=5><B>3.12
2008-07-14 09:15:55 +12:00
Other options</B></FONT></P>
2009-01-25 04:54:07 +13:00
<P>Additional options are available which
2008-07-14 09:15:55 +12:00
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>
<HR>
<TABLE WIDTH=100% BORDER=0 CELLPADDING=0 CELLSPACING=0>
2009-01-25 04:54:07 +13:00
<TR>
2008-07-14 09:15:55 +12:00
<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>
2009-01-25 04:54:07 +13:00
<TR>
2008-07-14 09:15:55 +12:00
<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>
</BODY>
</HTML>