source: general/graphlib/libungif.xml@ 70823f8

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

<!ENTITY libungif-download-http "http://ftp.sunfreeware.com/ftp/pub/freeware/SOURCES/libungif-&libungif-version;.tar.gz">
<!ENTITY libungif-download-ftp "ftp://sunfreeware.secsup.org/pub/solaris/freeware/SOURCES/libungif-&libungif-version;.tar.gz">
<!ENTITY libungif-size "343 KB">
<!ENTITY libungif-buildsize "3.1 MB">
<!ENTITY libungif-time "0.11 SBU">

]>

<sect1 id="libungif" xreflabel="libungif-&libungif-version;">
<?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 claims 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 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>Additional downloads</title>
<itemizedlist spacing='compact'>
<listitem><para>Required Patch: <ulink
url="&patch-root;/libungif-&libungif-version;-va_start-1.patch"/></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>patch -Np1 -i ../libungif-&libungif-version;-va_start-1.patch &amp;&amp;
./configure --prefix=/usr &amp;&amp;
make &amp;&amp;
make install</command></userinput></screen>

<!--
<note><para>If you get an error during the make portion compiling
<filename>lib/qprintf.c</filename>,
edit the file and comment out or remove line 14: #include &lt;config.h&gt;
</para></note>
-->

</sect2>

<sect2>
<title>Contents</title>

<para>The libungif package contains <command>gif2epsn</command>,
<command>gif2ps</command>, <command>gif2rgb</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>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>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>