source: general/graphlib/libungif.xml@ 07b157f4

<?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 libungif 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 libungif 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 libungif 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 libpng 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>

</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 GIF'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>