source: general/graphlib/giflib.xml@ 25564573

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

<!ENTITY giflib-download-http "http://prdownloads.sourceforge.net/libungif/giflib-&giflib-version;.tar.bz2">
<!ENTITY giflib-download-ftp " ">
<!ENTITY giflib-md5sum "22efc9599ccf91d288374dcf0679abf1">
<!ENTITY giflib-size "440 KB">
<!ENTITY giflib-buildsize "6.2 MB">
<!ENTITY giflib-time "0.16 SBU">
]>

<sect1 id="giflib" xreflabel="giflib-&giflib-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="giflib.html"?>
<title>giflib-&giflib-version;</title>
<indexterm zone="giflib">
<primary sortas="a-Giflib">Giflib</primary></indexterm>

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

<para>The <application>giflib</application> package contains libraries for 
reading and writing <acronym>GIF</acronym>s as well as 
programs for converting and working with <acronym>GIF</acronym> files. The 
libraries are useful for any graphics program wishing to deal with 
<acronym>GIF</acronym> files while the programs are useful for conversion 
purposes as well as cleaning up images.</para>

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

<sect3><title><application>giflib</application> dependencies</title>
<sect4><title>Optional</title>
<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>)</para>
</sect4>
</sect3>

</sect2>

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

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

<screen><userinput><command>./configure --prefix=/usr &amp;&amp;
make</command></userinput></screen>

<para>Now, as the root user:</para>

<screen><userinput role='root'><command>make install &amp;&amp;
install -v -m755 -d /usr/share/doc/giflib-&giflib-version;/html &amp;&amp;
install -v -m644 doc/*.{png,html} \
    /usr/share/doc/giflib-&giflib-version;/html &amp;&amp;
install -v -m644 doc/*.txt \
    /usr/share/doc/giflib-&giflib-version;</command></userinput></screen>

</sect2>

<sect2>
<title>Contents</title>

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

<seglistitem>
<seg>gif2epsn, gif2ps, gif2rgb, gif2x11, gifasm, gifbg, gifburst, gifclip, 
gifclrmp, gifcolor, gifcomb, gifcompose, giffiltr, giffix, gifflip, gifhisto, 
gifinfo, gifinter, gifinto, gifovly, gifpos, gifrotat, gifrsize, gifspnge, 
giftext, gifwedge, icon2gif, raw2gif, rgb2gif, text2gif</seg>
<seg>libgif.[so,a]</seg>
<seg>/usr/share/doc/giflib-&giflib-version;</seg>
</seglistitem>
</segmentedlist>

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

<varlistentry id="gif2epsn">
<term><command>gif2epsn</command></term>
<listitem><para>dumps images saved as <acronym>GIF</acronym> files on Epson 
type printers.</para>
<indexterm zone="giflib gif2epsn">
<primary sortas="b-gif2epsn">gif2epsn</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gif2ps">
<term><command>gif2ps</command></term>
<listitem><para>prints <acronym>GIF</acronym> files on laser printers 
supporting PostScript.</para>
<indexterm zone="giflib gif2ps">
<primary sortas="b-gif2ps">gif2ps</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gif2rgb">
<term><command>gif2rgb</command></term>
<listitem><para>converts images saved as <acronym>GIF</acronym> to 24-bit 
<acronym>RGB</acronym> images.</para>
<indexterm zone="giflib gif2rgb">
<primary sortas="b-gif2rgb">gif2rgb</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gif2x11">
<term><command>gif2x11</command></term>
<listitem><para>displays images saved as <acronym>GIF</acronym> files 
under X Window System.</para>
<indexterm zone="giflib gif2x11">
<primary sortas="b-gif2x11">gif2x11</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifasm">
<term><command>gifasm</command></term>
<listitem><para>assembles multiple <acronym>GIF</acronym>s into one, or burst 
a multiple-image <acronym>GIF</acronym>.</para>
<indexterm zone="giflib gifasm">
<primary sortas="b-gifasm">gifasm</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifbg">
<term><command>gifbg</command></term>
<listitem><para>generates a single-color test pattern 
<acronym>GIF</acronym>.</para>
<indexterm zone="giflib gifbg">
<primary sortas="b-gifbg">gifbg</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifburst">
<term><command>gifburst</command></term>
<listitem><para>bursts a <acronym>GIF</acronym> image into 
subrectangles.</para>
<indexterm zone="giflib gifburst">
<primary sortas="b-gifburst">gifburst</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifclip">
<term><command>gifclip</command></term>
<listitem><para>clips or crops a <acronym>GIF</acronym> image.</para>
<indexterm zone="giflib gifclip">
<primary sortas="b-gifclip">gifclip</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifclrmp">
<term><command>gifclrmp</command></term>
<listitem><para>modifies <acronym>GIF</acronym> image colormaps.</para>
<indexterm zone="giflib gifclrmp">
<primary sortas="b-gifclrmp">gifclrmp</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifcolor">
<term><command>gifcolor</command></term>
<listitem><para>generates color test patterns.</para>
<indexterm zone="giflib gifcolor">
<primary sortas="b-gifcolor">gifcolor</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifcomb">
<term><command>gifcomb</command></term>
<listitem><para>combines two <acronym>GIF</acronym> images of exactly the 
same size into one.</para>
<indexterm zone="giflib gifcomb">
<primary sortas="b-gifcomb">gifcomb</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifcompose">
<term><command>gifcompose</command></term>
<listitem><para>uses giflib tools to compose images.</para>
<indexterm zone="giflib gifcompose">
<primary sortas="b-gifcompose">gifcompose</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="giffiltr">
<term><command>giffiltr</command></term>
<listitem><para>is a template for filtering a <acronym>GIF</acronym> 
sequentially.</para>
<indexterm zone="giflib giffiltr">
<primary sortas="b-giffiltr">gifiltr</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="giffix">
<term><command>giffix</command></term>
<listitem><para>clumsily attempts to fix truncated <acronym>GIF</acronym> 
images.</para>
<indexterm zone="giflib giffix">
<primary sortas="b-gifix">gifix</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifflip">
<term><command>gifflip</command></term>
<listitem><para>flips a <acronym>GIF</acronym> image along the X or Y axis or 
rotates an image by 90 degrees.</para>
<indexterm zone="giflib gifflip">
<primary sortas="b-gifflip">gifflip</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifhisto">
<term><command>gifhisto</command></term>
<listitem><para>generate a color-frequency histogram from a 
<acronym>GIF</acronym>.</para>
<indexterm zone="giflib gifhisto">
<primary sortas="b-gifhisto">gifhisto</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifinfo">
<term><command>gifinfo</command></term>
<listitem><para>gives information about a <acronym>GIF</acronym> file.</para>
<indexterm zone="giflib gifinfo">
<primary sortas="b-gifinfo">gifinfo</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifinter">
<term><command>gifinter</command></term>
<listitem><para>converts between interlaced and non-interlaced images.</para>
<indexterm zone="giflib gifinter">
<primary sortas="b-gifinter">gifinter</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifinto">
<term><command>gifinto</command></term>
<listitem><para>is an end-of-pipe fitting for 
<acronym>GIF</acronym>-processing pipelines.</para>
<indexterm zone="giflib gifinto">
<primary sortas="b-gifinto">gifinto</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifovly">
<term><command>gifovly</command></term>
<listitem><para>generates one composite <acronym>GIF</acronym> from a 
multiple-image <acronym>GIF</acronym>.</para>
<indexterm zone="giflib gifovly">
<primary sortas="b-gifovly">gifovly</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifpos">
<term><command>gifpos</command></term>
<listitem><para>changes a <acronym>GIF</acronym>'s screen size or 
reconditions it.</para>
<indexterm zone="giflib gifpos">
<primary sortas="b-gifpos">gifpos</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifrotat">
<term><command>gifrotat</command></term>
<listitem><para>rotates a <acronym>GIF</acronym> through any desired 
angle.</para>
<indexterm zone="giflib gifrotat">
<primary sortas="b-gifrotat">gifrotat</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifrsize">
<term><command>gifrsize</command></term>
<listitem><para>resizes a <acronym>GIF</acronym> by deletion or duplication 
of bits.</para>
<indexterm zone="giflib gifrsize">
<primary sortas="b-gifrsize">gifrsize</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifspnge">
<term><command>gifspnge</command></term>
<listitem><para>is a template for filtering a <acronym>GIF</acronym> with 
in-core operations.</para>
<indexterm zone="giflib gifspnge">
<primary sortas="b-gifspnge">gifspnge</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="giftext">
<term><command>giftext</command></term>
<listitem><para>prints (text only) general information about a 
<acronym>GIF</acronym> file.</para>
<indexterm zone="giflib giftext">
<primary sortas="b-giftext">giftext</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="gifwedge">
<term><command>gifwedge</command></term>
<listitem><para>creates a test <acronym>GIF</acronym> image resembling a 
color monitor test pattern.</para>
<indexterm zone="giflib gifwedge">
<primary sortas="b-gifwedge">gifwedge</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="icon2gif">
<term><command>icon2gif</command></term>
<listitem><para>is a converter/deconverter to/from an editable text 
format.</para>
<indexterm zone="giflib icon2gif">
<primary sortas="b-icon2gif">icon2gif</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="raw2gif">
<term><command>raw2gif</command></term>
<listitem><para>converts raw 8-bit image data into <acronym>GIF</acronym> 
files.</para>
<indexterm zone="giflib raw2gif">
<primary sortas="b-raw2gif">raw2gif</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="rgb2gif">
<term><command>rgb2gif</command></term>
<listitem><para>converts 24 bit images to a <acronym>GIF</acronym> image 
using color quantization.</para>
<indexterm zone="giflib rgb2gif">
<primary sortas="b-rgb2gif">rgb2gif</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="text2gif">
<term><command>text2gif</command></term>
<listitem><para>generates <acronym>GIF</acronym> images out of regular text 
in 8x8 font.</para>
<indexterm zone="giflib text2gif">
<primary sortas="b-text2gif">text2gif</primary>
</indexterm></listitem>
</varlistentry>

<varlistentry id="libgif">
<term><filename class='libraryfile'>libgif.[so,a]</filename></term>
<listitem><para>contains <acronym>API</acronym> functions required by the 
<application>giflib</application> programs and any other programs needing 
library functionality to read, write and manipulate <acronym>GIF</acronym> 
images.</para>
<indexterm zone="giflib libgif">
<primary sortas="c-libgif">libgif.[so,a]</primary>
</indexterm></listitem>
</varlistentry>
</variablelist>

</sect2>

</sect1>