zint/docs/installing.html

107 lines
4.0 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>Installing Zint</TITLE>
2008-10-19 21:57:58 +13:00
<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.4 (Unix)">
2008-07-14 09:15:55 +12:00
<META NAME="CREATED" CONTENT="20070730;21081900">
2008-10-19 21:57:58 +13:00
<META NAME="CHANGED" CONTENT="20081019;8493400">
2008-07-14 09:15:55 +12:00
<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>
2008-10-19 21:57:58 +13:00
<P>To install Zint with QR Code support follow these steps</P>
<P STYLE="font-style: normal"><FONT FACE="Courier, monospace"><FONT SIZE=2>make<BR>make
install</FONT></FONT></P>
2008-07-14 09:15:55 +12:00
<P STYLE="font-style: normal">If you do not want QR Code support use
the following steps</P>
2008-10-19 21:57:58 +13:00
<P><FONT FACE="Courier, monospace"><SPAN STYLE="font-style: normal"><FONT SIZE=2>make
libzint_noqr<BR>make install</FONT></SPAN></FONT></P>
<P STYLE="font-style: normal"><A NAME="TESTING"></A><FONT SIZE=5><B>2.2
2008-07-14 09:15:55 +12:00
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>
2008-10-19 21:57:58 +13:00
<P>This should create numerous files showing the many modes of
operation which are available from Zint.
2008-07-14 09:15:55 +12:00
</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>