mirror of
https://github.com/zint/zint
synced 2024-11-16 20:57:25 +13:00
125 lines
4.8 KiB
HTML
125 lines
4.8 KiB
HTML
|
<!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> </P>
|
||
|
|
</TD>
|
||
|
|
<TD WIDTH=33%>
|
||
|
|
<P ALIGN=RIGHT>Using the Front End</P>
|
||
|
|
</TD>
|
||
|
|
</TR>
|
||
|
|
</TABLE>
|
||
|
|
<P><BR><BR>
|
||
|
|
</P>
|
||
|
|
</BODY>
|
||
|
|
</HTML>
|