glfs/general/graphlib/giflib.xml
Randy McMurchy 10fddb0117 Updated to giflib-4.1.4
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@5526 af4574ff-66df-0310-9fd7-8a98e5e911e0
2006-01-05 06:42:50 +00:00

444 lines
15 KiB
XML

<?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 "ftp://ftp.fu-berlin.de/unix/linux/mirrors/gentoo/distfiles/giflib-&giflib-version;.tar.gz">
<!ENTITY giflib-http-md5sum "827d338961482a986f39c7f114531636">
<!ENTITY giflib-http-size "483 KB">
<!ENTITY giflib-ftp-md5sum "950943daa71350a558c3edf41c3f0f9f">
<!ENTITY giflib-ftp-size "605 KB">
<!ENTITY giflib-buildsize "6.8 MB">
<!ENTITY giflib-time "0.2 SBU">
]>
<sect1 id="giflib" xreflabel="giflib-&giflib-version;">
<?dbhtml filename="giflib.html"?>
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
<keywordset>
<keyword role="package">giflib-&giflib-version;.tar</keyword>
<keyword role="ftpdir">giflib</keyword>
</keywordset>
</sect1info>
<title>giflib-&giflib-version;</title>
<indexterm zone="giflib">
<primary sortas="a-Giflib">Giflib</primary>
</indexterm>
<sect2 role="package">
<title>Introduction to giflib</title>
<para>The <application>giflib</application> package contains libraries
for reading and writing GIFs as well as programs for converting and
working with GIF files. The libraries are useful for any graphics program
wishing to deal with GIF files while the programs are useful for conversion
purposes as well as cleaning up images.</para>
<bridgehead renderas="sect3">Package Information</bridgehead>
<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 (HTTP) MD5 sum: &giflib-http-md5sum;</para>
</listitem>
<listitem>
<para>Download (HTTP) size: &giflib-http-size;</para>
</listitem>
<listitem>
<para>Download (FTP) MD5 sum: &giflib-ftp-md5sum;</para>
</listitem>
<listitem>
<para>Download (FTP) size: &giflib-ftp-size;</para>
</listitem>
<listitem>
<para>Estimated disk space required: &giflib-buildsize;</para>
</listitem>
<listitem>
<para>Estimated build time: &giflib-time;</para>
</listitem>
</itemizedlist>
<bridgehead renderas="sect3">giflib Dependencies</bridgehead>
<bridgehead renderas="sect4">Optional</bridgehead>
<para role="optional">X (<xref linkend="xfree86"/> or
<xref linkend="xorg"/>)</para>
</sect2>
<sect2 role="installation">
<title>Installation of giflib</title>
<para>Install <application>giflib</application> by running the following
commands:</para>
<screen><userinput>./configure --prefix=/usr &amp;&amp;
make</userinput></screen>
<para>This package does not come with a test suite.</para>
<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
<screen role="root"><userinput>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;</userinput></screen>
</sect2>
<sect2 role="content">
<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, and 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"?>
<?dbhtml list-presentation="table"?>
<varlistentry id="gif2epsn">
<term><command>gif2epsn</command></term>
<listitem>
<para>dumps images saved as GIF 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 GIF 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 GIF to 24-bit RGB 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 GIF 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 GIFs into one, or burst a multiple-image GIF.</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 GIF.</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 GIF 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 GIF 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 GIF 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 GIF 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 GIF 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 GIF 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 GIF 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 GIF.</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 GIF 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 GIF-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 GIF from a multiple-image GIF.</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 GIF'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 GIF 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 GIF 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 GIF 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 GIF 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 GIF 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 GIF 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 GIF 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 GIF 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 API functions required by the
<application>giflib</application> programs and any other programs needing
library functionality to read, write and manipulate GIF images.</para>
<indexterm zone="giflib libgif">
<primary sortas="c-libgif">libgif.[so,a]</primary>
</indexterm>
</listitem>
</varlistentry>
</variablelist>
</sect2>
</sect1>