source: general/graphlib/libungif.xml@ bae992f

<?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 libungif-download-http "http://prdownloads.sourceforge.net/libungif/libungif-&libungif-version;.tar.bz2">
<!ENTITY libungif-download-ftp " ">
<!ENTITY libungif-md5sum "8c198831cc0495596c78134b8849e9ad">
<!ENTITY libungif-size "430 KB">
<!ENTITY libungif-buildsize "6.2 MB">
<!ENTITY libungif-time "0.16 SBU">
]>

<sect1 id="libungif" xreflabel="libungif-&libungif-version;">
<sect1info>
<othername>$LastChangedBy$</othername>
<date>$Date$</date>
</sect1info>
<?dbhtml filename="libungif.html"?>
<title>libungif-&libungif-version;</title>

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

<para>The <application>libungif</application> package contains libraries for 
reading all <acronym>GIF</acronym>s and writing non-compressed ones 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>

<para>The reason <application>libungif</application> only writes non-compressed 
<acronym>GIF</acronym>s is due to a legal issue with <acronym>LZW</acronym> 
compression (which Unisys claimed a patent on). Reading <acronym>GIF</acronym>s 
is not a problem as the decompression routines do not seem to be limited in 
this way.  Note that this has in the past been disputed. The best way to avoid 
this whole mess is to simply use <application>libungif</application> for 
looking at <acronym>GIF</acronym> images on the web, while in any pages which 
you design, use the open source <acronym>PNG</acronym> format instead (which 
uses, not surprisingly, the <application>libpng</application> library) which 
has no patent issues at all.</para>

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

<sect3><title><application>libungif</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>libungif</application></title>

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

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

</sect2>

<sect2>
<title>Contents</title>

<para>The libungif package contains
<command>gif2epsn</command>,
<command>gif2ps</command>,
<command>gif2rgb</command>,
<command>gif2x11</command>,
<command>gifasm</command>,
<command>gifbg</command>,
<command>gifburst</command>,
<command>gifclip</command>,
<command>gifclrmp</command>,
<command>gifcolor</command>,
<command>gifcomb</command>,
<command>gifcompose</command>,
<command>giffiltr</command>,
<command>giffix</command>,
<command>gifflip</command>, 
<command>gifhisto</command>,
<command>gifinfo</command>, 
<command>gifinter</command>,
<command>gifinto</command>,
<command>gifovly</command>,
<command>gifpos</command>,
<command>gifrotat</command>,
<command>gifrsize</command>,
<command>gifspnge</command>,
<command>giftext</command>,
<command>gifwedge</command>,
<command>icon2gif</command>,
<command>raw2gif</command>,
<command>rgb2gif</command>,
<command>text2gif</command> and
<filename class="libraryfile">libungif</filename> libraries.</para>

</sect2>

<sect2><title>Description</title>

<sect3><title>gif2epsn</title>
<para>Dumps images saved as <acronym>GIF</acronym> files on Epson type 
printers.</para></sect3>

<sect3><title>gif2ps</title>
<para>Print <acronym>GIF</acronym> files on laser printers supporting 
PostScript.</para></sect3>

<sect3><title>gif2rgb</title>
<para>Convert images saved as <acronym>GIF</acronym> to 24-bit 
<acronym>RGB</acronym> image(s).</para></sect3>

<sect3><title>gif2x11</title>
<para>Display images saved as <acronym>GIF</acronym> files
under X Window System.</para></sect3>

<sect3><title>gifasm</title>
<para>Assemble multiple <acronym>GIF</acronym>s into one, or burst a
multiple-image <acronym>GIF</acronym>.</para></sect3>

<sect3><title>gifbg</title>
<para>Generate a single-color test pattern <acronym>GIF</acronym>.</para>
</sect3>

<sect3><title>gifburst</title>
<para>Burst a <acronym>GIF</acronym> image into subrectangles.</para></sect3>

<sect3><title>gifclip</title>
<para>Clip or crop a <acronym>GIF</acronym> image.</para></sect3>

<sect3><title>gifclrmp</title>
<para>Modify <acronym>GIF</acronym> image colormaps.</para></sect3>

<sect3><title>gifcolor</title>
<para>Generate color test patterns.</para></sect3>

<sect3><title>gifcomb</title>
<para>Combine 2 <acronym>GIF</acronym> images of exactly the same size into 
one.</para></sect3>

<sect3><title>gifcompose</title>
<para>Use (un)giflib tools to compose images.</para></sect3>

<sect3><title>giffiltr</title>
<para>Template code for filtering a <acronym>GIF</acronym> 
sequentially.</para></sect3>

<sect3><title>giffix</title>
<para>Clumsily attempts to fix truncated <acronym>GIF</acronym> images.</para>
</sect3>

<sect3><title>gifflip</title>
<para>Flip <acronym>GIF</acronym> image along X or Y axis or rotate by 90
degrees.</para></sect3>

<sect3><title>gifhisto</title>
<para>Generate color-frequency histogram from a <acronym>GIF</acronym>.</para>
</sect3>

<sect3><title>gifinfo</title>
<para>Gives information on a <acronym>GIF</acronym> file.</para></sect3>

<sect3><title>gifinter</title>
<para>Convert between interlaced and non-interlaced images.</para></sect3>

<sect3><title>gifinto</title>
<para>End-of-pipe fitting for <acronym>GIF</acronym>-processing 
pipelines.</para></sect3>

<sect3><title>gifovly</title>
<para>Generate one composite <acronym>GIF</acronym> from a multiple-image
<acronym>GIF</acronym>.</para></sect3>

<sect3><title>gifpos</title>
<para>Change a <acronym>GIF</acronym>'s screen size or recondition 
it.</para></sect3>

<sect3><title>gifrotat</title>
<para>Rotate a <acronym>GIF</acronym> through any desired angle.</para></sect3>

<sect3><title>gifrsize</title>
<para>Resize a <acronym>GIF</acronym> by deletion or duplication of bits.</para>
</sect3>

<sect3><title>gifspnge</title>
<para>Template code for filtering a <acronym>GIF</acronym> with in-core
operations.</para></sect3>

<sect3><title>giftext</title>
<para>Print (text only) general information about a <acronym>GIF</acronym>.
</para></sect3>

<sect3><title>gifwedge</title>
<para>Create a test <acronym>GIF</acronym> image resembling a color monitor
test pattern.</para></sect3>

<sect3><title>icon2gif</title>
<para>Converter/deconverter to/from an editable text format.</para></sect3>

<sect3><title>raw2gif</title>
<para>Convert raw 8-bit image data into <acronym>GIF</acronym> files.</para>
</sect3>

<sect3><title>rgb2gif</title>
<para>Convert 24 bit images to a <acronym>GIF</acronym> image using color
quantization.</para></sect3>

<sect3><title>text2gif</title>
<para>Generate <acronym>GIF</acronym> images out of regular text in 8x8 font.
</para></sect3>

</sect2>

</sect1>