glfs/general/graphlib/libungif.xml
Archaic 5cd0959daa Resetting keywords
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@2592 af4574ff-66df-0310-9fd7-8a98e5e911e0
2004-08-10 04:25:57 +00:00

222 lines
7.9 KiB
XML

<?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;">
<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 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>