mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-24 23:32:12 +08:00
fce275e955
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@7591 af4574ff-66df-0310-9fd7-8a98e5e911e0
429 lines
15 KiB
XML
429 lines
15 KiB
XML
<?xml version="1.0" encoding="ISO-8859-1"?>
|
|
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
|
|
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
|
|
<!ENTITY % general-entities SYSTEM "../../general.ent">
|
|
%general-entities;
|
|
|
|
<!ENTITY libungif-download-http "&sourceforge-repo;/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;">
|
|
<?dbhtml filename="libungif.html"?>
|
|
|
|
<sect1info>
|
|
<othername>$LastChangedBy$</othername>
|
|
<date>$Date$</date>
|
|
</sect1info>
|
|
|
|
<title>Libungif-&libungif-version;</title>
|
|
|
|
<indexterm zone="libungif">
|
|
<primary sortas="a-Libungif">Libungif</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to Libungif</title>
|
|
|
|
<para>The <application>libungif</application> package contains libraries
|
|
for reading all GIFs and writing non-compressed ones 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>
|
|
|
|
<para>The reason <application>libungif</application> only writes non-compressed
|
|
GIFs is due to a legal issue with LZW compression (which Unisys claimed a patent
|
|
on). Reading GIFs 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 GIF images on the web, while in any pages which you design, use the open
|
|
source PNG format instead (which uses, not surprisingly, the
|
|
<application>libpng</application> library) which has no patent issues at all.</para>
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<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>
|
|
|
|
<bridgehead renderas="sect3">Libungif Dependencies</bridgehead>
|
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
|
<para role="optional"><xref linkend="x-window-system"/></para>
|
|
|
|
<para condition="html" role="usernotes">User Notes:
|
|
<ulink url="&blfs-wiki;/libungif"/></para>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role='installation'>
|
|
<title>Installation of Libungif</title>
|
|
|
|
<para>Install <application>libungif</application> by running the following
|
|
commands:</para>
|
|
|
|
<screen><userinput>./configure --prefix=/usr &&
|
|
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 &&
|
|
install -v -m755 -d /usr/share/doc/libungif-&libungif-version;/html &&
|
|
install -v -m644 doc/*.{png,html} \
|
|
/usr/share/doc/libungif-&libungif-version;/html &&
|
|
install -v -m644 doc/*.txt \
|
|
/usr/share/doc/libungif-&libungif-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>libungif.{so,a}</seg>
|
|
<seg>/usr/share/doc/libungif-&libungif-version;</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="gif2epsn-libungif">
|
|
<term><command>gif2epsn</command></term>
|
|
<listitem>
|
|
<para>dumps images saved as GIF files on Epson type printers.</para>
|
|
<indexterm zone="libungif gif2epsn-libungif">
|
|
<primary sortas="b-gif2epsn">gif2epsn</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gif2ps-libungif">
|
|
<term><command>gif2ps</command></term>
|
|
<listitem>
|
|
<para>print GIF files on laser printers supporting PostScript.</para>
|
|
<indexterm zone="libungif gif2ps-libungif">
|
|
<primary sortas="b-gif2ps">gif2ps</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gif2rgb-libungif">
|
|
<term><command>gif2rgb</command></term>
|
|
<listitem>
|
|
<para>convert images saved as GIF to 24-bit RGB image(s).</para>
|
|
<indexterm zone="libungif gif2rgb-libungif">
|
|
<primary sortas="b-gif2rgb">gif2rgb</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gif2x11-libungif">
|
|
<term><command>gif2x11</command></term>
|
|
<listitem>
|
|
<para>display images saved as GIF files under X Window System.</para>
|
|
<indexterm zone="libungif gif2x11-libungif">
|
|
<primary sortas="b-gif2x11">gif2x11</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifasm-libungif">
|
|
<term><command>gifasm</command></term>
|
|
<listitem>
|
|
<para>assemble multiple GIFs into one, or burst a multiple-image GIF.</para>
|
|
<indexterm zone="libungif gifasm-libungif">
|
|
<primary sortas="b-gifasm">gifasm</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifbg-libungif">
|
|
<term><command>gifbg</command></term>
|
|
<listitem>
|
|
<para>generate a single-color test pattern GIF.</para>
|
|
<indexterm zone="libungif gifbg-libungif">
|
|
<primary sortas="b-gifbg">gifbg</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifburst-libungif">
|
|
<term><command>gifburst</command></term>
|
|
<listitem>
|
|
<para>burst a GIF image into subrectangles.</para>
|
|
<indexterm zone="libungif gifburst-libungif">
|
|
<primary sortas="b-gifburst">gifburst</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifclip-libungif">
|
|
<term><command>gifclip</command></term>
|
|
<listitem>
|
|
<para>clip or crop a GIF image.</para>
|
|
<indexterm zone="libungif gifclip-libungif">
|
|
<primary sortas="b-gifclip">gifclip</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifclrmp-libungif">
|
|
<term><command>gifclrmp</command></term>
|
|
<listitem>
|
|
<para>modify GIF image colormaps.</para>
|
|
<indexterm zone="libungif gifclrmp-libungif">
|
|
<primary sortas="b-gifclrmp">gifclrmp</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifcolor-libungif">
|
|
<term><command>gifcolor</command></term>
|
|
<listitem>
|
|
<para>generate color test patterns.</para>
|
|
<indexterm zone="libungif gifcolor-libungif">
|
|
<primary sortas="b-gifcolor">gifcolor</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifcomb-libungif">
|
|
<term><command>gifcomb</command></term>
|
|
<listitem>
|
|
<para>combine 2 GIF images of exactly the same size into one.</para>
|
|
<indexterm zone="libungif gifcomb-libungif">
|
|
<primary sortas="b-gifcomb">gifcomb</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifcompose-libungif">
|
|
<term><command>gifcompose</command></term>
|
|
<listitem>
|
|
<para>use (un)giflib tools to compose images.</para>
|
|
<indexterm zone="libungif gifcompose-libungif">
|
|
<primary sortas="b-gifcompose">gifcompose</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="giffiltr-libungif">
|
|
<term><command>giffiltr</command></term>
|
|
<listitem>
|
|
<para>template code for filtering a GIF sequentially.</para>
|
|
<indexterm zone="libungif giffiltr-libungif">
|
|
<primary sortas="b-giffiltr">giffiltr</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="giffix-libungif">
|
|
<term><command>giffix</command></term>
|
|
<listitem>
|
|
<para>clumsily attempts to fix truncated GIF images.</para>
|
|
<indexterm zone="libungif giffix-libungif">
|
|
<primary sortas="b-giffix">giffix</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifflip-libungif">
|
|
<term><command>gifflip</command></term>
|
|
<listitem>
|
|
<para>flip GIF image along X or Y axis or rotate by 90 degrees.</para>
|
|
<indexterm zone="libungif gifflip-libungif">
|
|
<primary sortas="b-gifflip">gifflip</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifhisto-libungif">
|
|
<term><command>gifhisto</command></term>
|
|
<listitem>
|
|
<para>generate color-frequency histogram from a GIF.</para>
|
|
<indexterm zone="libungif gifhisto-libungif">
|
|
<primary sortas="b-gifhisto">gifhisto</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifinfo-libungif">
|
|
<term><command>gifinfo</command></term>
|
|
<listitem>
|
|
<para>gives information on a GIF file.</para>
|
|
<indexterm zone="libungif gifinfo-libungif">
|
|
<primary sortas="b-gifinfo">gifinfo</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifinter-libungif">
|
|
<term><command>gifinter</command></term>
|
|
<listitem>
|
|
<para>convert between interlaced and non-interlaced images.</para>
|
|
<indexterm zone="libungif gifinter-libungif">
|
|
<primary sortas="b-gifinter">gifinter</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifinto-libungif">
|
|
<term><command>gifinto</command></term>
|
|
<listitem>
|
|
<para>end-of-pipe fitting for GIF-processing pipelines.</para>
|
|
<indexterm zone="libungif gifinto-libungif">
|
|
<primary sortas="b-gifinto">gifinto</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifovly-libungif">
|
|
<term><command>gifo-libungifvly</command></term>
|
|
<listitem>
|
|
<para>generate one composite GIF from a multiple-image GIF.</para>
|
|
<indexterm zone="libungif gifovly-libungif">
|
|
<primary sortas="b-gifovly">gifovly</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifpos-libungif">
|
|
<term><command>gifpos</command></term>
|
|
<listitem>
|
|
<para>change a GIF's screen size or recondition it.</para>
|
|
<indexterm zone="libungif gifpos-libungif">
|
|
<primary sortas="b-gifpos">gifpos</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifrotat-libungif">
|
|
<term><command>gifrotat</command></term>
|
|
<listitem>
|
|
<para>rotate a GIF through any desired angle.</para>
|
|
<indexterm zone="libungif gifrotat-libungif">
|
|
<primary sortas="b-gifrotat">gifrotat</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifrsize-libungif">
|
|
<term><command>gifrsize</command></term>
|
|
<listitem>
|
|
<para>resize a GIF by deletion or duplication of bits.</para>
|
|
<indexterm zone="libungif gifrsize-libungif">
|
|
<primary sortas="b-gifrsize">gifrsize</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifspnge-libungif">
|
|
<term><command>gifspnge</command></term>
|
|
<listitem>
|
|
<para>template code for filtering a GIF with in-core operations.</para>
|
|
<indexterm zone="libungif gifspnge-libungif">
|
|
<primary sortas="b-gifspnge">gifspnge</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="giftext-libungif">
|
|
<term><command>giftext</command></term>
|
|
<listitem>
|
|
<para>print (text only) general information about a GIF.</para>
|
|
<indexterm zone="libungif giftext-libungif">
|
|
<primary sortas="b-giftext">giftext</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gifwedge-libungif">
|
|
<term><command>gifwedge</command></term>
|
|
<listitem>
|
|
<para>create a test GIF image resembling a color monitor test pattern.</para>
|
|
<indexterm zone="libungif gifwedge-libungif">
|
|
<primary sortas="b-gifwedge">gifwedge</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="icon2gif-libungif">
|
|
<term><command>icon2gif</command></term>
|
|
<listitem>
|
|
<para>converter/deconverter to/from an editable text format.</para>
|
|
<indexterm zone="libungif icon2gif-libungif">
|
|
<primary sortas="b-icon2gif">icon2gif</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="raw2gif-libungif">
|
|
<term><command>raw2gif</command></term>
|
|
<listitem>
|
|
<para>convert raw 8-bit image data into GIF files.</para>
|
|
<indexterm zone="libungif raw2gif-libungif">
|
|
<primary sortas="b-raw2gif">raw2gif</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="rgb2gif-libungif">
|
|
<term><command>rgb2gif</command></term>
|
|
<listitem>
|
|
<para>convert 24 bit images to a GIF image using color quantization.</para>
|
|
<indexterm zone="libungif rgb2gif-libungif">
|
|
<primary sortas="b-rgb2gif">rgb2gif</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="text2gif-libungif">
|
|
<term><command>text2gif</command></term>
|
|
<listitem>
|
|
<para>generate GIF images out of regular text in 8x8 font.</para>
|
|
<indexterm zone="libungif text2gif-libungif">
|
|
<primary sortas="b-text2gif">text2gif</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|