source: general/graphlib/libtiff.xml@ 82bc335

<?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-v&libtiff-version;.tar.gz">
<!ENTITY libtiff-download-ftp " ">
<!ENTITY libtiff-size "1.1 MB">
<!ENTITY libtiff-buildsize "11 MB">
<!ENTITY libtiff-time "0.16 SBU">

]>

<sect1 id="libtiff" xreflabel="libtiff-&libtiff-version;">
<?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 tiff libraries and associated
utilities.  The libraries are used by many programs for reading and
writing tiff files and the utilities are useful for general work with
tiff 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>

<sect3><title><application>libtiff</application> dependencies</title>
<sect4><title>Optional</title>
<para><xref linkend="libjpeg"/>
</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>./configure --prefix=/usr --noninteractive \
    --with-DIR_MAN=/usr/share/man \
    --with-ZIP=yes --with-DIR_GZLIB=/usr/lib &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>

</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 libtiff package contains
<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>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>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>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>tiff libraries</title>
<para>The tiff libraries are used by many programs to read and write
tiff files.</para></sect3>

</sect2>

</sect1>