source: general/graphlib/libtiff.xml@ b5a2067

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
   "http://www.oasis-open.org/docbook/xml/4.5/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/libtiff/tiff-&libtiff-version;.tar.gz">
  <!ENTITY libtiff-md5sum        "fbb6f446ea4ed18955e2714934e5b698">
  <!ENTITY libtiff-size          "1.3 MB">
  <!ENTITY libtiff-buildsize     "18.9 MB">
  <!ENTITY libtiff-time          "0.5 SBU">
]>

<sect1 id="libtiff" xreflabel="LibTIFF-&libtiff-version;">
  <?dbhtml filename="libtiff.html"?>

  <sect1info>
    <othername>$LastChangedBy$</othername>
    <date>$Date$</date>
  </sect1info>

  <title>LibTIFF-&libtiff-version;</title>

  <indexterm zone="libtiff">
    <primary sortas="a-LibTIFF">LibTIFF</primary>
  </indexterm>

  <sect2 role="package">
    <title>Introduction to LibTIFF</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>

    <bridgehead renderas="sect3">Package Information</bridgehead>
    <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 MD5 sum: &libtiff-md5sum;</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>

    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
    <itemizedlist spacing="compact">
      <listitem>
        <para>Required patch: <ulink
        url="&patch-root;/tiff-&libtiff-version;-fixes-2.patch"/></para>
      </listitem>
    </itemizedlist>

    <bridgehead renderas="sect3">LibTIFF Dependencies</bridgehead>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional"><xref linkend="libjpeg"/>,
    <xref linkend="x-window-system"/>, and
    <xref linkend="freeglut"/></para>

    <para>Note that if you installed the optional MesaGLUT package with the
    <xref linkend="mesalib"/> package during an <application>Xorg7</application>
    installation, a GLUT library is already installed and you don't need
    <application>freeglut</application>.</para>

    <para condition="html" role="usernotes">User Notes:
    <ulink url="&blfs-wiki;/libtiff"/></para>

  </sect2>

  <sect2 role="installation">
    <title>Installation of LibTIFF</title>

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

<screen><userinput>patch -Np1 -i ../tiff-&libtiff-version;-fixes-2.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make</userinput></screen>

    <para>To test the results, issue: <command>make check</command>.</para>

    <para>Now, as the <systemitem class="username">root</systemitem> user:</para>

<screen role="root"><userinput>make install</userinput></screen>

  </sect2>

  <sect2 role="commands">
    <title>Command Explanations</title>

    <para><option>--disable-static</option>: This switch prevents the
    static library from being built.</para>

  </sect2>

  <sect2 role="content">
    <title>Contents</title>

    <segmentedlist>
      <segtitle>Installed Programs</segtitle>
      <segtitle>Installed Libraries</segtitle>
      <segtitle>Installed Directory</segtitle>

      <seglistitem>
        <seg>bmp2tiff, fax2ps, fax2tiff, gif2tiff, pal2rgb, ppm2tiff, ras2tiff,
        raw2tiff, rgb2ycbcr, thumbnail, tiff2bw, tiff2pdf, tiff2ps, tiff2rgba,
        tiffcmp, tiffcp, tiffdither, tiffdump, tiffgt, tiffinfo, tiffmedian, tiffset,
        and tiffsplit</seg>
        <seg>libtiff.{so,a} and libtiffxx.{so,a}</seg>
        <seg>/usr/share/doc/tiff-&libtiff-version;</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

      <varlistentry id="bmp2tiff">
        <term><command>bmp2tiff</command></term>
        <listitem>
          <para>converts a Microsoft Windows Device Independent Bitmap image
          file to a TIFF image.</para>
          <indexterm zone="libtiff bmp2tiff">
            <primary sortas="b-bmp2tiff">bmp2tiff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="fax2ps">
        <term><command>fax2ps</command></term>
        <listitem>
          <para>converts a TIFF facsimile to compressed PostScript file.</para>
          <indexterm zone="libtiff fax2ps">
            <primary sortas="b-fax2ps">fax2ps</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="fax2tiff">
        <term><command>fax2tiff</command></term>
        <listitem>
          <para>creates a TIFF Class F fax file from raw fax data.</para>
          <indexterm zone="libtiff fax2tiff">
            <primary sortas="b-fax2tiff">fax2tiff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="gif2tiff">
        <term><command>gif2tiff</command></term>
        <listitem>
          <para>creates a TIFF file from a GIF87 format image file.</para>
          <indexterm zone="libtiff gif2tiff">
            <primary sortas="b-gif2tiff">gif2tiff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="pal2rgb">
        <term><command>pal2rgb</command></term>
        <listitem>
          <para>converts a palette color TIFF image to a full color image.</para>
          <indexterm zone="libtiff pal2rgb">
            <primary sortas="b-pal2rgb">pal2rgb</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ppm2tiff">
        <term><command>ppm2tiff</command></term>
        <listitem>
          <para>creates a TIFF file from a PPM image file.</para>
          <indexterm zone="libtiff ppm2tiff">
            <primary sortas="b-ppm2tiff">ppm2tiff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="ras2tiff">
        <term><command>ras2tiff</command></term>
        <listitem>
          <para>creates a TIFF file from a Sun rasterfile.</para>
          <indexterm zone="libtiff ras2tiff">
            <primary sortas="b-ras2tiff">ras2tiff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="raw2tiff">
        <term><command>raw2tiff</command></term>
        <listitem>
          <para>converts a raw byte sequence into TIFF.</para>
          <indexterm zone="libtiff raw2tiff">
            <primary sortas="b-raw2tiff">raw2tiff</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="rgb2ycbcr">
        <term><command>rgb2ycbcr</command></term>
        <listitem>
          <para>converts non-YCbCr TIFF images to YCbCr TIFF images.</para>
          <indexterm zone="libtiff rgb2ycbcr">
            <primary sortas="b-rgb2ycbcr">rgb2ycbcr</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="thumbnail">
        <term><command>thumbnail</command></term>
        <listitem>
          <para>creates a TIFF file with thumbnail images.</para>
          <indexterm zone="libtiff thumbnail">
            <primary sortas="b-thumbnail">thumbnail</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiff2bw">
        <term><command>tiff2bw</command></term>
        <listitem>
          <para>converts a color TIFF image to grayscale.</para>
          <indexterm zone="libtiff tiff2bw">
            <primary sortas="b-tiff2bw">tiff2bw</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiff2pdf">
        <term><command>tiff2pdf</command></term>
        <listitem>
          <para>converts a TIFF image to a PDF document.</para>
          <indexterm zone="libtiff tiff2pdf">
            <primary sortas="b-tiff2pdf">tiff2pdf</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiff2ps">
        <term><command>tiff2ps</command></term>
        <listitem>
          <para>converts a TIFF image to a PostScript file.</para>
          <indexterm zone="libtiff tiff2ps">
            <primary sortas="b-tiff2ps">tiff2ps</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiff2rgba">
        <term><command>tiff2rgba</command></term>
        <listitem>
          <para>converts a wide variety of TIFF images into an RGBA
          TIFF image.</para>
          <indexterm zone="libtiff tiff2rgba">
            <primary sortas="b-tiff2rgba">tiff2rgba</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffcmp">
        <term><command>tiffcmp</command></term>
        <listitem>
          <para>compares two TIFF files.</para>
          <indexterm zone="libtiff tiffcmp">
            <primary sortas="b-tiffcmp">tiffcmp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffcp">
        <term><command>tiffcp</command></term>
        <listitem>
          <para> copies (and possibly converts) a TIFF file.</para>
          <indexterm zone="libtiff tiffcp">
            <primary sortas="b-tiffcp">tiffcp</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffdither">
        <term><command>tiffdither</command></term>
        <listitem>
          <para>converts a grayscale image to bilevel using dithering.</para>
          <indexterm zone="libtiff tiffdither">
            <primary sortas="b-tiffdither">tiffdither</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffdump">
        <term><command>tiffdump</command></term>
        <listitem>
          <para>prints verbatim information about TIFF files.</para>
          <indexterm zone="libtiff tiffdump">
            <primary sortas="b-tiffdump">tiffdump</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffgt">
        <term><command>tiffgt</command></term>
        <listitem>
          <para>displays an image stored in a TIFF file in
          an <application>X</application> window.</para>
          <indexterm zone="libtiff tiffgt">
            <primary sortas="b-tiffgt">tiffgt</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffinfo">
        <term><command>tiffinfo</command></term>
        <listitem>
          <para>prints information about TIFF files.</para>
          <indexterm zone="libtiff tiffinfo">
            <primary sortas="b-tiffinfo">tiffinfo</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffmedian">
        <term><command>tiffmedian</command></term>
        <listitem>
          <para>applies the median cut algorithm to data in a TIFF file.</para>
          <indexterm zone="libtiff tiffmedian">
            <primary sortas="b-tiffmedian">tiffmedian</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffset">
        <term><command>tiffset</command></term>
        <listitem>
          <para>sets the value of a TIFF header to a specified value.</para>
          <indexterm zone="libtiff tiffset">
            <primary sortas="b-tiffset">tiffset</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="tiffsplit">
        <term><command>tiffsplit</command></term>
        <listitem>
          <para>splits a multi-image TIFF into single-image TIFF files.</para>
          <indexterm zone="libtiff tiffsplit">
            <primary sortas="b-tiffsplit">tiffsplit</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libtiff-lib">
        <term><filename class='libraryfile'>libtiff.{so,a}</filename></term>
        <listitem>
          <para>contains the API functions used by the
          <application>libtiff</application> programs as well as other
          programs to read and write TIFF files.</para>
          <indexterm zone="libtiff libtiff-lib">
            <primary sortas="c-libtiff">libtiff.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libtiffxx">
        <term><filename class='libraryfile'>libtiffxx.{so,a}</filename></term>
        <listitem>
          <para>contains the C++ API functions used
          by programs to read and write TIFF files.</para>
          <indexterm zone="libtiff libtiffxx">
            <primary sortas="c-libtiffxx">libtiffxx.{so,a}</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>