source: general/graphlib/libtiff.xml@ 7b96a69

<?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
           "https://download.osgeo.org/libtiff/tiff-&libtiff-version;.tar.gz">
<!--  <!ENTITY libtiff-download-ftp
           "ftp://ftp.remotesensing.org/libtiff/tiff-&libtiff-version;.tar.gz">-->
  <!ENTITY libtiff-download-ftp  " ">
  <!ENTITY libtiff-md5sum        "376f17f189e9d02280dfe709b2b2bbea">
  <!ENTITY libtiff-size          "2.7 MB">
  <!ENTITY libtiff-buildsize     "33 MB (with tests)">
  <!ENTITY libtiff-time          "less than 0.1 SBU (with tests)">
]>

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


  <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
      used for general work with TIFF files.
    </para>

    &lfs112_checked;

    <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;-upstream_fixes-1.patch"/>
        </para>
      </listitem>
    </itemizedlist>

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

    <bridgehead renderas="sect4">Recommended</bridgehead>
    <para role="recommended">
      <xref linkend="cmake"/>
    </para>

    <bridgehead renderas="sect4">Optional</bridgehead>
    <para role="optional">
      <xref linkend="freeglut"/> (required for <command>tiffgt</command>),
      <xref linkend="libjpeg"/>,
      <xref linkend="libwebp"/>, and
      <ulink url="https://www.cl.cam.ac.uk/~mgk25/jbigkit/">JBIG-KIT</ulink>
    </para>

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

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

    <para>
      First fix several security issues identified upstream:
    </para>

<screen><userinput>patch -Np1 -i ../tiff-&libtiff-version;-upstream_fixes-1.patch</userinput></screen>

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

<!-- "build" exists in the source tree -->
<screen><userinput>mkdir -p libtiff-build &amp;&amp;
cd       libtiff-build &amp;&amp;

cmake -DCMAKE_INSTALL_DOCDIR=/usr/share/doc/libtiff-&libtiff-version; \
      -DCMAKE_INSTALL_PREFIX=/usr -G Ninja .. &amp;&amp;
ninja</userinput></screen>

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

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

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

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

    <para>
      <command>sed -i /Version/...</command>: When building with cmake/ninja,
      the Version field in the pkgconfig file is empty. This command
      fixes that field.
    </para>

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

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

      <seglistitem>
        <seg>
          fax2ps, fax2tiff, pal2rgb, ppm2tiff,
          raw2tiff, tiff2bw, tiff2pdf, tiff2ps,
          tiff2rgba, tiffcmp, tiffcp, tiffcrop, tiffdither, tiffdump, tiffgt,
          tiffinfo, tiffmedian, tiffset and tiffsplit
        </seg>
        <seg>
          libtiff.so and libtiffxx.so
        </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="tiffcrop">
        <term><command>tiffcrop</command></term>
        <listitem>
          <para>
            selects, copies, crops, converts, extracts and/or processes
            one or more TIFF files
          </para>
          <indexterm zone="libtiff tiffcrop">
            <primary sortas="b-tiffcrop">tiffcrop</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
          </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</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</primary>
          </indexterm>
        </listitem>
      </varlistentry>

      <varlistentry id="libtiffxx">
        <term><filename class="libraryfile">libtiffxx.so</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</primary>
          </indexterm>
        </listitem>
      </varlistentry>

    </variablelist>

  </sect2>

</sect1>