mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-01-24 23:32:12 +08:00
0ad800b207
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17450 af4574ff-66df-0310-9fd7-8a98e5e911e0
545 lines
18 KiB
XML
545 lines
18 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 gimp-download-http "http://download.gimp.org/pub/gimp/v2.8/gimp-&gimp-version;.tar.bz2">
|
|
<!ENTITY gimp-download-ftp " ">
|
|
<!-- <!ENTITY gimp-download-ftp "ftp://mirrors.xmission.com/gimp/gimp/v2.8/gimp-&gimp-version;.tar.bz2">-->
|
|
<!ENTITY gimp-md5sum "30e0a1b7c18b0e3415f4ac54567252ac">
|
|
<!ENTITY gimp-size "20 MB">
|
|
<!ENTITY gimp-buildsize "632 MB (additional 690 MB to run
|
|
the test suite)">
|
|
<!ENTITY gimp-time "4.2 SBU (additional 0.7 SBU to run
|
|
the test suite)">
|
|
|
|
|
|
<!ENTITY gimp-help-version "2.8.2">
|
|
<!ENTITY gimp-help-download "http://download.gimp.org/pub/gimp/help/gimp-help-&gimp-help-version;.tar.bz2">
|
|
<!ENTITY gimp-help-md5sum "a591c8974b2f4f584d0a769d52ed6c5b">
|
|
<!ENTITY gimp-help-size "152 MB">
|
|
<!ENTITY gimp-help-buildsize "From 307 MB (en only) to 1257 MB (all 18
|
|
languages), average of 52 MB per translation">
|
|
<!ENTITY gimp-help-time "0.8 SBU (en only), average of 1.2 SBU per
|
|
translation (measured with 5 languages), 5.9
|
|
SBU, with parallelism=8, for all languages">
|
|
]>
|
|
|
|
<sect1 id="gimp" xreflabel="Gimp-&gimp-version;">
|
|
<?dbhtml filename="gimp.html" ?>
|
|
|
|
<sect1info>
|
|
<othername>$LastChangedBy$</othername>
|
|
<date>$Date$</date>
|
|
</sect1info>
|
|
|
|
<title>Gimp-&gimp-version;</title>
|
|
|
|
<indexterm zone="gimp">
|
|
<primary sortas="a-Gimp">Gimp</primary>
|
|
</indexterm>
|
|
|
|
<sect2 role="package">
|
|
<title>Introduction to Gimp</title>
|
|
|
|
<para>
|
|
The <application>Gimp</application> package contains
|
|
the GNU Image Manipulation Program which is useful for
|
|
photo retouching, image composition and image authoring.
|
|
</para>
|
|
|
|
&lfs79_checked;&gcc6_checked;
|
|
|
|
<bridgehead renderas="sect3">Package Information</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Download (HTTP): <ulink url="&gimp-download-http;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download (FTP): <ulink url="&gimp-download-ftp;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download MD5 sum: &gimp-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &gimp-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &gimp-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &gimp-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<bridgehead renderas="sect3">Additional Downloads</bridgehead>
|
|
<itemizedlist spacing="compact">
|
|
<listitem>
|
|
<para>
|
|
Optional help files: <ulink url="&gimp-help-download;"/>
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download MD5 sum: &gimp-help-md5sum;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Download size: &gimp-help-size;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated disk space required: &gimp-help-buildsize;
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
Estimated build time: &gimp-help-time;
|
|
</para>
|
|
</listitem>
|
|
</itemizedlist>
|
|
|
|
<bridgehead renderas="sect3">Gimp Dependencies</bridgehead>
|
|
|
|
<bridgehead renderas="sect4">Required</bridgehead>
|
|
<para role="required">
|
|
<xref linkend="gegl"/> and
|
|
<xref linkend="gtk2"/>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Recommended</bridgehead>
|
|
<para role="recommended">
|
|
<xref linkend="pygtk"/> (including the gtk and pango modules)
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Optional</bridgehead>
|
|
<para role="optional">
|
|
<xref linkend="aalib"/>,
|
|
<xref linkend="alsa-lib"/>,
|
|
<xref linkend="curl"/>,
|
|
<xref linkend="dbus-glib"/>,
|
|
<xref linkend="gs"/> (with libgs installed),
|
|
<xref linkend="gvfs"/>,
|
|
<xref linkend="iso-codes"/>,
|
|
<xref linkend="jasper"/>,
|
|
<xref linkend="lcms"/> or <xref linkend="lcms2"/>,
|
|
<xref linkend="libexif"/>,
|
|
<xref linkend="libgudev"/>,
|
|
<xref linkend="libmng"/>,
|
|
<xref linkend="librsvg"/>,
|
|
<xref linkend="poppler"/>,
|
|
an <xref linkend="server-mail"/> (that provides a
|
|
<command>sendmail</command> program),
|
|
<xref linkend="gtk-doc"/>,
|
|
<!--xref linkend="webkitgtk2"/> (required for the help-plugin) and-->
|
|
<ulink url="http://webkitgtk.org/releases/">WebKitGTK+-2.4.x</ulink> (required for the help-plugin), and
|
|
<ulink url="http://wvware.sourceforge.net/libwmf.html">libwmf</ulink>
|
|
</para>
|
|
|
|
<bridgehead renderas="sect4">Optional, for optimizing the PNG files in the
|
|
help system</bridgehead>
|
|
<para role="optional">
|
|
<ulink url="http://pngnq.sourceforge.net/">pngnq</ulink> and
|
|
<ulink url="http://pmt.sourceforge.net/pngcrush/">pngcrush</ulink>
|
|
</para>
|
|
|
|
<para condition="html" role="usernotes">User Notes:
|
|
<ulink url="&blfs-wiki;/gimp"/>
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Gimp</title>
|
|
|
|
<para>
|
|
Install <application>Gimp</application> by running
|
|
the following commands:
|
|
</para>
|
|
|
|
<screen><userinput>sed -i '/gegl/s/2/3/' configure.ac &&
|
|
autoreconf -fiv &&
|
|
|
|
./configure --prefix=/usr \
|
|
--sysconfdir=/etc \
|
|
--without-gvfs &&
|
|
make</userinput></screen>
|
|
|
|
<para>
|
|
To test the results (requires an X-Windowed terminal) issue:
|
|
<command>make check</command>.
|
|
</para>
|
|
|
|
<para>
|
|
Now, as the <systemitem class="username">root</systemitem>
|
|
user:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>make install</userinput></screen>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/update-icons-and-desktop.xml"/>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="installation">
|
|
<title>Installation of Gimp-Help</title>
|
|
|
|
<para>
|
|
The <filename>gimp-help</filename> tarball contains images and English
|
|
text help for help files, together with translations.
|
|
</para>
|
|
|
|
<para>
|
|
If you downloaded the <filename>gimp-help</filename> tarball, unpack
|
|
it and change into the root of the newly created source tree. Prepare for
|
|
the build with the following command:
|
|
</para>
|
|
|
|
<screen><userinput>ALL_LINGUAS="ca da de el en en_GB es fr it ja ko nl nn pt_BR ru sl sv zh_CN" \
|
|
./configure --prefix=/usr &&</userinput></screen>
|
|
|
|
<para>
|
|
Remove from <envar>ALL_LINGUAS</envar> the codes for any languages which
|
|
you do not wish to install. Alternatively, remove the line starting with
|
|
<envar>ALL_LINGUAS</envar>, if you wish to build all languages.
|
|
</para>
|
|
|
|
<para>
|
|
Now build the help files:
|
|
</para>
|
|
|
|
<screen><userinput>make</userinput></screen>
|
|
|
|
<para>
|
|
Issue the following commands as the
|
|
<systemitem class="username">root</systemitem> user to install the help
|
|
files:
|
|
</para>
|
|
|
|
<screen role="root"><userinput>make install &&
|
|
chown -R root:root /usr/share/gimp/2.0/help</userinput></screen>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="commands" id="gimp-cmd-explanations">
|
|
<title>Command Explanations</title>
|
|
|
|
<para>
|
|
<command> sed ... configure.ac</command>: This command allows
|
|
building with the current version of gegl.
|
|
</para>
|
|
|
|
<para>
|
|
<envar>ALL_LINGUAS="ca da de el en en_GB ..."</envar>: by
|
|
default, the help files will be rendered in all the available languages.
|
|
Remove the codes of any languages you do not wish to build.
|
|
</para>
|
|
|
|
<para>
|
|
<parameter>--without-gvfs</parameter>: the choice of the backend to
|
|
handle URI information, e.g., when dragging images from a browser into the
|
|
<application>Gimp</application>, is made at compile time. This parameter will
|
|
ensure that <application>cURL</application> is used at run-time, instead of
|
|
<application>Gvfs</application>. You can omit this if you are installing
|
|
<application>Gvfs</application> AND will be running <command>gvfsd</command>,
|
|
e.g., in a <application>GNOME</application> desktop.
|
|
</para>
|
|
|
|
<para><option>--disable-python</option>: This option is necessary if
|
|
you have not installed <application>PyGTK</application>.</para>
|
|
|
|
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
|
|
href="../../xincludes/gtk-doc-rebuild.xml"/>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="configuration">
|
|
<title>Configuring The Gimp</title>
|
|
|
|
<sect3 id="gimp-config">
|
|
<title>Config Files</title>
|
|
|
|
<para>
|
|
<filename>/etc/gimp/2.0/*</filename> and
|
|
<filename>~/.gimp-2.8/gimprc</filename>
|
|
</para>
|
|
|
|
<indexterm zone="gimp gimp-config">
|
|
<primary sortas="e-AA.gimp-2.0/gimprc">~/.gimp-2.0/gimprc</primary>
|
|
</indexterm>
|
|
|
|
<indexterm zone="gimp gimp-config">
|
|
<primary sortas="e-etc-gimp-2.0-star">/etc/gimp/2.0/*</primary>
|
|
</indexterm>
|
|
|
|
</sect3>
|
|
|
|
<sect3>
|
|
<title>Configuration Information</title>
|
|
|
|
<para>
|
|
The <application>Gimp</application> executes a configuration wizard
|
|
for each user upon their initial use of the program.
|
|
</para>
|
|
|
|
<para>
|
|
The GIMP uses either a plugin or a browser for its help system. The
|
|
depedency to build the plugin, WebKitGTK+-2.4.x, has been deprecated
|
|
and is no longer in BLFS. To set up the help system to work with the
|
|
default browser, use Edit -> Preferences -> Help System and select 'Web
|
|
Browser' for the 'Help Browser to use' setting.
|
|
</para>
|
|
</sect3>
|
|
|
|
</sect2>
|
|
|
|
<sect2 role="content">
|
|
<title>Contents</title>
|
|
|
|
<segmentedlist>
|
|
<segtitle>Installed Programs</segtitle>
|
|
<segtitle>Installed Libraries</segtitle>
|
|
<segtitle>Installed Directories</segtitle>
|
|
|
|
<seglistitem>
|
|
<seg>
|
|
gimp, gimp-2.8,
|
|
gimp-console, gimp-console-2.8, and
|
|
gimptool-2.0
|
|
</seg>
|
|
<seg>
|
|
libgimp-2.0.so, libgimpbase-2.0.so, libgimpcolor-2.0.so,
|
|
libgimpconfig-2.0.so, libgimpmath-2.0.so, libgimpmodule-2.0.so,
|
|
libgimpthumb-2.0.so, libgimpui-2.0.so, and libgimpwidgets-2.0.so
|
|
</seg>
|
|
<seg>
|
|
/etc/gimp,
|
|
/usr/include/gimp-2.0,
|
|
/usr/{lib,share}/gimp,
|
|
/usr/share/gimp/2.0/help/{en,lang2,lang3,...},
|
|
/usr/share/gtk-doc/html/libgimp{,base,color,config}, and
|
|
/usr/share/gtk-doc/html/libgimp{math,module,thumb,widgets}
|
|
</seg>
|
|
</seglistitem>
|
|
</segmentedlist>
|
|
|
|
<variablelist>
|
|
<bridgehead renderas="sect3">Short Descriptions</bridgehead>
|
|
<?dbfo list-presentation="list"?>
|
|
<?dbhtml list-presentation="table"?>
|
|
|
|
<varlistentry id="gimp-prog">
|
|
<term><command>gimp</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a symbolic link to <command>gimp-2.8</command>.
|
|
</para>
|
|
<indexterm zone="gimp gimp-prog">
|
|
<primary sortas="b-gimp">gimp</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimp-2.8">
|
|
<term><command>gimp-2.8</command></term>
|
|
<listitem>
|
|
<para>
|
|
is the Gnu Image Manipulation Program. It works with a variety
|
|
of image formats and provides a large selection of tools.
|
|
</para>
|
|
<indexterm zone="gimp gimp-2.8">
|
|
<primary sortas="b-gimp-2.8">gimp-2.8</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimp-console">
|
|
<term><command>gimp-console</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a symbolic link to <command>gimp-console-2.8</command>.
|
|
</para>
|
|
<indexterm zone="gimp gimp-console">
|
|
<primary sortas="b-gimp-console">gimp-console</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimp-console-2.8">
|
|
<term><command>gimp-console-2.8</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a console program that behaves as if The
|
|
<application>Gimp</application> was called with the
|
|
<option>--no-interface</option> command-line option.
|
|
</para>
|
|
<indexterm zone="gimp gimp-console-2.8">
|
|
<primary sortas="b-gimp-console-2.8">gimp-console-2.8</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="gimptool-2.0">
|
|
<term><command>gimptool-2.0</command></term>
|
|
<listitem>
|
|
<para>
|
|
is a tool that can build plug-ins or scripts and install them
|
|
if they are distributed in one source file.
|
|
<command>gimptool-2.0</command> can also be used by programs that
|
|
need to know what libraries and include-paths The
|
|
<application>Gimp</application> was compiled with.
|
|
</para>
|
|
<indexterm zone="gimp gimptool-2.0">
|
|
<primary sortas="b-gimptool-2.0">gimptool-2.0</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimp-2.0">
|
|
<term><filename class="libraryfile">libgimp-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides C bindings for The <application>Gimp</application>'s
|
|
Procedural Database (PDB) which offers an interface to core functions
|
|
and to functionality provided by plug-ins.
|
|
</para>
|
|
<indexterm zone="gimp libgimp-2.0">
|
|
<primary sortas="c-libgimp-2.0">libgimp-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpbase-2.0">
|
|
<term><filename class="libraryfile">libgimpbase-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the C functions for basic
|
|
<application>Gimp</application> functionality such as determining
|
|
enumeration data types, gettext translation, determining The
|
|
<application>Gimp</application>'s version number and capabilities,
|
|
handling data files and accessing the environment.
|
|
</para>
|
|
<indexterm zone="gimp libgimpbase-2.0">
|
|
<primary sortas="c-libgimpbase-2.0">libgimpbase-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpcolor-2.0">
|
|
<term><filename
|
|
class="libraryfile">libgimpcolor-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the C functions relating to RGB, HSV and CMYK colors as
|
|
well as converting colors between different color models and
|
|
performing adaptive supersampling on an area.
|
|
</para>
|
|
<indexterm zone="gimp libgimpcolor-2.0">
|
|
<primary sortas="c-libgimpcolor-2.0">libgimpcolor-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpconfig-2.0">
|
|
<term><filename
|
|
class="libraryfile">libgimpconfig-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains C functions for reading and writing config information.
|
|
</para>
|
|
<indexterm zone="gimp libgimpconfig-2.0">
|
|
<primary sortas="c-libgimpconfig-2.0">libgimpconfig-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpmath-2.0">
|
|
<term><filename class="libraryfile">libgimpmath-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains C functions which provide mathematical definitions and
|
|
macros, manipulate 3x3 transformation matrices, set up and manipulate
|
|
vectors and the MD5 message-digest algorithm.
|
|
</para>
|
|
<indexterm zone="gimp libgimpmath-2.0">
|
|
<primary sortas="c-libgimpmath-2.0">libgimpmath-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpmodule-2.0">
|
|
<term><filename class="libraryfile">libgimpmodule-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the C functions which implements module loading using
|
|
GModule and keeps a list of GimpModule's found in a given
|
|
searchpath.
|
|
</para>
|
|
<indexterm zone="gimp libgimpmodule-2.0">
|
|
<primary sortas="c-libgimpmodule-2.0">libgimpmodule-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpthumb-2.0">
|
|
<term><filename class="libraryfile">libgimpthumb-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
provides the C functions for handling The
|
|
<application>Gimp</application>'s thumbnail objects.
|
|
</para>
|
|
<indexterm zone="gimp libgimpthumb-2.0">
|
|
<primary sortas="c-libgimpthumb-2.0">libgimpthumb-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpui-2.0">
|
|
<term><filename class="libraryfile">libgimpui-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains The <application>Gimp</application>'s common user
|
|
interface functions.
|
|
</para>
|
|
<indexterm zone="gimp libgimpui-2.0">
|
|
<primary sortas="c-libgimpui-2.0">libgimpui-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<varlistentry id="libgimpwidgets-2.0">
|
|
<term><filename class="libraryfile">libgimpwidgets-2.0.so</filename></term>
|
|
<listitem>
|
|
<para>
|
|
contains The <application>Gimp</application>
|
|
and <application>GTK</application>'s widget creation and
|
|
manipulation functions.
|
|
</para>
|
|
<indexterm zone="gimp libgimpwidgets-2.0">
|
|
<primary
|
|
sortas="c-libgimpwidgets-2.0">libgimpwidgets-2.0.so</primary>
|
|
</indexterm>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
</variablelist>
|
|
|
|
</sect2>
|
|
|
|
</sect1>
|