source: general/graphlib/libtiff.xml@ 94b1dc3

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;

<!ENTITY libtiff-download-http "http://libtiff.maptools.org/dl/tiff-&libtiff-version;.tar.gz">
<!ENTITY libtiff-download-ftp "ftp://ftp.remotesensing.org/pub/libtiff/tiff-&libtiff-version;.tar.gz">
<!ENTITY libtiff-size "1.2 MB">
<!ENTITY libtiff-buildsize "15.6 MB">
<!ENTITY libtiff-time "0.41 SBU">
]>

<sect1 id="libtiff" xreflabel="libtiff-&libtiff-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="libtiff.html"?>
<title>libtiff-&libtiff-version;</title>

<sect2>
<title>Introduction to <application>libtiff</application></title>

<para>The <application>libtiff</application> package contains the 
<acronym>TIFF</acronym> libraries and associated utilities. The libraries are 
used by many programs for reading and writing <acronym>TIFF</acronym> files 
and the utilities are useful for general work with 
<acronym>TIFF</acronym> files.</para>

<sect3><title>Package information</title>
<itemizedlist spacing='compact'>
<listitem><para>Download (HTTP): <ulink url="&libtiff-download-http;"/></para></listitem>
<listitem><para>Download (FTP): <ulink url="&libtiff-download-ftp;"/></para></listitem>
<listitem><para>Download size: &libtiff-size;</para></listitem>
<listitem><para>Estimated Disk space required: &libtiff-buildsize;</para></listitem>
<listitem><para>Estimated build time: &libtiff-time;</para></listitem></itemizedlist>
</sect3>

<sect3><title>Additional downloads</title>
<!-- <itemizedlist spacing="compact">
<listitem><para>LZW compression support: <ulink
url="ftp://ftp.remotesensing.org/libtiff/libtiff-lzw-compression-kit-1.5.tar.gz"/></para></listitem>
</itemizedlist></sect3> -->

<itemizedlist spacing="compact">
<listitem><para>Required Patch: <ulink
url="&patch-root;/tiff-&libtiff-version;-libtool_fix-1.patch"/></para>
</listitem>
</itemizedlist>
</sect3>

<sect3><title><application>libtiff</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="libjpeg"/>, 
X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and <ulink 
url="http://www.opengl.org/resources/libraries/glut/glut_downloads.html">GLUT</ulink>
</para>
</sect4>
</sect3>

</sect2>

<sect2>
<title>Installation of <application>libtiff</application></title>

<!-- <para>If you wish to allow the creation of compressed
<acronym>TIFF</acronym> images, download the <acronym>LZW</acronym>
Compression Kit and copy the provided <filename>tif_lzw.c</filename>
file to the <filename class="directory">libtiff</filename> subdirectory
of the <application>libtiff</application> source tree.</para> -->

<para>Install <application>libtiff</application> by running the following 
commands:</para>

<screen><userinput><command>patch -Np1 -i ../tiff-&libtiff-version;-libtool_fix-1.patch &amp;&amp;
./configure --prefix=/usr --disable-jpeg &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

</sect2>

<sect2>
<title>Command explanations</title>

<!-- <para><option>-noninteractive</option>: This switch is used to
avoid the configuration routine asking for confirmation of the
installation directories (which is passed to 
<command>configure</command>).</para>

<para><parameter>-with-DIR_MAN=/usr/share/man</parameter>: This is used
because even though <parameter>-prefix=/usr</parameter> is specified, the 
<command>configure</command> routine tries to install the man pages in 
<filename class="directory">/usr/local/man</filename> instead of the correct
place.</para>

<para><parameter>-with-ZIP=yes -with-DIR_GZLIB=/usr/lib</parameter>: This
enables support for the handling of <acronym>TIFF</acronym> images with
deflate-encoded data.</para>

<para><option>-with-JPEG=yes -with-DIR_JPEGLIB=/usr/lib</option>: Use
these switches to enable support for the handling of <acronym>TIFF</acronym>
images with <acronym>JPEG</acronym>-encoded data.</para> -->

<para><option>--disable-jpeg</option>: Remove this parameter to enable 
support for handling <acronym>TIFF</acronym> images with 
<acronym>JPEG</acronym>-encoded data.</para>

</sect2>

<!-- <sect2>
<title>Configuring <application>libtiff</application></title>

<sect3><title>Configuration Information</title>

<xi:include xmlns:xi="http://www.w3.org/2003/XInclude" href="../../lib-config.xml"/> 

</sect3>

</sect2> -->

<sect2>
<title>Contents</title>

<para>The <application>libtiff</application> package contains
<command>bmp2tiff</command>,
<command>fax2ps</command>,
<command>fax2tiff</command>,
<command>gif2tiff</command>,
<command>pal2rgb</command>,
<command>ppm2tiff</command>,
<command>ras2tiff</command>,
<command>raw2tiff</command>,
<command>rgb2ycbcr</command>,
<command>thumbnail</command>,
<command>tiff2bw</command>,
<command>tiff2pdf</command>,
<command>tiff2ps</command>,
<command>tiff2rgba</command>,
<command>tiffcmp</command>,
<command>tiffcp</command>,
<command>tiffdither</command>,
<command>tiffdump</command>,
<command>tiffgt</command>,
<command>tiffinfo</command>,
<command>tiffmedian</command>,
<command>tiffset</command>,
<command>tiffsplit</command> and
<filename class="libraryfile">libtiff</filename> libraries.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>bmp2tiff</title>
<para><command>bmp2tiff</command> converts a Microsoft Windows Device 
Independent Bitmap image file to a <acronym>TIFF</acronym> image.</para></sect3>

<sect3><title>fax2ps</title>
<para><command>fac2ps</command> converts a <acronym>TIFF</acronym>
facsimile to compressed PostScript file.</para></sect3>

<sect3><title>fax2tiff</title>
<para><command>fax2tiff</command> creates a <acronym>TIFF</acronym>
Class F fax file from raw fax data.</para></sect3>

<sect3><title>gif2tiff</title>
<para><command>gif2tiff</command> creates a <acronym>TIFF</acronym> file
from a <acronym>GIF87</acronym> format image file.</para></sect3>

<sect3><title>pal2rgb</title>
<para><command>pal2rgb</command> converts a palette color
<acronym>TIFF</acronym> image to a full color image.</para></sect3>

<sect3><title>ppm2tiff</title>
<para><command>ppm2tiff</command> creates a <acronym>TIFF</acronym> file
from a <acronym>PPM</acronym> image file.</para></sect3>

<sect3><title>ras2tiff</title>
<para><command>ras2tiff</command> creates a <acronym>TIFF</acronym> file
from a Sun rasterfile.</para></sect3>

<sect3><title>raw2tiff</title>
<para><command>raw2tiff</command> converts a raw byte sequence into
<acronym>TIFF</acronym>.</para></sect3>

<sect3><title>rgb2ycbcr</title>
<para><command>rgb2ycbcr</command> converts non-YCbCr
<acronym>TIFF</acronym> images to a YCbCr <acronym>TIFF</acronym>
image.</para></sect3>

<sect3><title>thumbnail</title>
<para><command>thumbnail</command> creates a <acronym>TIFF</acronym>
file with thumbnail images.</para></sect3>

<sect3><title>tiff2bw</title>
<para><command>tiff2bw</command> converts a color
<acronym>TIFF</acronym> image to grayscale.</para></sect3>

<sect3><title>tiff2pdf</title>
<para><command>tiff2pdf</command> converts a <acronym>TIFF</acronym>
image to a <acronym>PDF</acronym> document.</para></sect3>

<sect3><title>tiff2ps</title>
<para><command>tiff2ps</command> converts a <acronym>TIFF</acronym>
image to a PostScript file.</para></sect3>

<sect3><title>tiff2rgba</title>
<para><command>tiff2rgba</command> converts a wide variety of
<acronym>TIFF</acronym> images into an <acronym>RGBA</acronym>
<acronym>TIFF</acronym> image.</para></sect3>

<sect3><title>tiffcmp</title>
<para><command>tiffcmp</command> compares two <acronym>TIFF</acronym>
files.</para></sect3>

<sect3><title>tiffcp</title>
<para><command>tiffcp</command> copies (and possibly converts) a
<acronym>TIFF</acronym> file.</para></sect3>

<sect3><title>tiffdither</title>
<para><command>tiffdither</command> converts a grayscale image to
bilevel using dithering.</para></sect3>

<sect3><title>tiffdump</title>
<para><command>tiffdump</command> prints verbatim information about
<acronym>TIFF</acronym> files.</para></sect3>

<sect3><title>tiffgt</title>
<para><command>tiffgt</command> displays an image stored in a 
<acronym>TIFF</acronym> file in an <application>X</application>
window.</para></sect3>

<sect3><title>tiffinfo</title>
<para><command>tiffinfo</command> prints information about
<acronym>TIFF</acronym> files.</para></sect3>

<sect3><title>tiffmedian</title>
<para><command>tiffmedian</command> applies the median cut algorithm to
data in a <acronym>TIFF</acronym> file.</para></sect3>

<sect3><title>tiffsplit</title>
<para><command>tiffsplit</command> splits a multi-image
<acronym>TIFF</acronym> into single-image <acronym>TIFF</acronym>
files.</para></sect3>

<sect3><title>libtiff libraries</title>
<para>The libtiff libraries are used by many programs to read and write 
<acronym>TIFF</acronym> files.</para></sect3>

</sect2>

</sect1>