1
Installation instructions for GIMP 2.2
1
Installation instructions for GIMP 2.3
2
2
--------------------------------------
4
4
There are some basic steps to building and installing The GIMP.
6
GIMP 2.2 replaces GIMP 2.0. It is advised that you uninstall GIMP 2.0
7
before installing GIMP 2.2. If you want to keep GIMP 2.0 installed in
8
parallel to GIMP 2.2, you have to choose a separate prefix which is
9
not in your default library search path.
6
GIMP 2.3 replaces earlier GIMP 2.x versions. It is advised that you
7
uninstall them before installing GIMP 2.3. If you want to keep your
8
older GIMP 2.x installation in parallel to GIMP 2.3, you have to
9
choose a separate prefix which is not in your default library search
11
GIMP 2.2 is fully backward compatible to GIMP 2.0. Plug-ins and
12
GIMP 2.x is fully backward compatible to GIMP 2.0. Plug-ins and
12
13
scripts written for GIMP 2.0 will continue to work and don't need to
13
be changed nor recompiled to be used with GIMP 2.2.
14
be changed nor recompiled to be used with GIMP 2.x.
15
16
The most important part is to make sure the requirements for a build
16
17
are fulfilled. We depend on a number of tools and libraries which are
27
28
1. You need to have installed a recent version of pkg-config available
28
29
from http://www.freedesktop.org/software/pkgconfig/.
30
2. You need to have installed GTK+ version 2.4.4 or better. Do not
31
try to use an older GTK+ version (1.2.x), it will not work.
32
GTK+ itself needs recent versions of GLib (>= 2.4.5),
33
Pango (>= 1.4.0) and ATK. Sources for these can be grabbed from
34
ftp://ftp.gtk.org/. GTK+-2.x and friends can be installed side
35
by side with GTK+-1.2.
31
2. You need to have installed GTK+ version 2.10.6 or newer. GIMP
32
needs an even more recent version of GLib (>= 2.12.3). It also
33
wants Pango (>= 1.12.2). Sources for these can be grabbed from
37
36
3. We require PangoFT2, a Pango backend that uses FreeType2. Make
38
37
sure you have FreeType2 and fontconfig installed before you
39
38
compile Pango. FreeType2 can be downloaded from
40
39
http://www.freetype.org/. Fontconfig from
41
http://freedesktop.org/fontconfig/. GIMP 2.2 depends on
42
freetype2 being newer than version 2.1.7. Older versions are
43
known to have bugs that seriously affect stability of The GIMP.
40
http://freedesktop.org/fontconfig/. GIMP depends on freetype2
41
being newer than version 2.1.7 and fontconfig 2.2.0 or newer.
42
Older versions are known to have bugs that seriously affect
45
4. We use libart2. Grab the module libart_lgpl out of GNOME CVS or
45
4. We use libart2. Grab the module libart_lgpl out of GNOME SVN or
46
46
fetch the tarball from
47
47
ftp://ftp.gnome.org/pub/gnome/sources/libart_lgpl/
49
5. You may want to install other third party libraries or programs that
50
are needed for some of the available plugins. We recommend to check
51
that the following libraries are installed: libpng, libjpeg,
52
libtiff, gimp-print (4.2.x), gtkhtml-2, libmng, librsvg, libwmf.
54
6. Configure the GIMP by running the `configure' script. You may want
49
5. We use dbus-glib if available. Grab it from
50
http://dbus.freedesktop.org/releases/dbus-glib/
52
6. You may want to install other third party libraries or programs
53
that are needed for some of the available plugins. We recommend
54
to check that the following libraries are installed: libpng,
55
libjpeg, libpoppler, libtiff, gtkhtml-2, libmng, librsvg, libwmf.
57
7. The Python extension requires Python development headers to be
58
present. You will also need PyGTK and the respective development
61
8. Configure GIMP by running the `configure' script. You may want
55
62
to pass some options to it, see below.
57
7. Build the GIMP by running `make'. The use of GNU make is recommened.
64
9. Build GIMP by running `make'. The use of GNU make is recommended.
58
65
If you need to tweak the build to make it work with other flavours
59
66
of make, we'd appreciate if you'd send us a patch with the changes.
61
8. Install the GIMP by running `make install'. In order to avoid clashes
62
with other versions of The GIMP, we install a binary called gimp-2.2.
68
10. Install GIMP by running `make install'. In order to avoid clashes
69
with other versions of GIMP, we install a binary called gimp-2.3.
63
70
By default there's also a link created so that you can type 'gimp'
64
to start gimp-2.2. If you have the 2.0 version installed, you should
65
still be able to run it using 'gimp-2.0'.
67
73
Please make sure you don't have any old GTK+-2.x, jpeg, etc. libraries
68
74
lying around on your system, otherwise configure may fail to find the
72
78
Generic instructions for configuring and compiling auto-configured
73
79
packages are included below. Here is an illustration of commands that
74
might be used to build and install the GIMP. The actual configuration,
80
might be used to build and install GIMP. The actual configuration,
75
81
compilation and installation output is not shown.
77
% tar xvfz gimp-2.2.x.tar.gz # unpack the sources
78
% cd gimp-2.2.x # change to the toplevel directory
83
% tar xvfz gimp-2.3.x.tar.gz # unpack the sources
84
% cd gimp-2.3.x # change to the toplevel directory
79
85
% ./configure # run the `configure' script
80
% make # build the GIMP
81
% make install # install the GIMP
84
The `configure' script examines your system, and adapts the GIMP to
85
run on it. The script has many options, some of which are described in
86
the generic instructions included at the end of this file. All of the
87
% make install # install GIMP
90
The `configure' script examines your system, and adapts GIMP to run on
91
it. The script has many options, some of which are described in the
92
generic instructions included at the end of this file. All of the
87
93
options can be listed using the command `./configure --help'. There
88
94
are several special options the GIMP `configure' script recognizes.
96
102
--enable-debug and --disable-debug. This option causes the build
97
103
process to compile with debugging enabled. If debugging is
98
disabled, the GIMP will instead be compiled with optimizations turned
104
disabled, GIMP will instead be compiled with optimizations turned
99
105
on. The default is for debugging to be disabled. NOTE: This
100
106
option is intended primarily as a convenience for developers.
108
--enable-profile and --disable-profile. This options causes the build
109
process to compile with execution profiling enabled. The default is
110
for profiling to be disabled. NOTE: This option is intended primarily
111
as a convenience for developers.
102
113
--enable-ansi and --disable-ansi. This option causes stricter
103
114
ANSI C checking to be performed when compiling with GCC. The
104
115
default is for strict checking to be disabled. NOTE: This option
105
116
is intended primarily as a convenience for developers.
107
118
--enable-gimpdir=DIR. This option changes the default directory
108
the gimp uses to search for its configuration files from ~/.gimp-2.2
109
(the directory .gimp-2.2 in the users home directory) to DIR.
119
GIMP uses to search for its configuration files from ~/.gimp-2.3
120
(the directory .gimp-2.3 in the users home directory) to DIR.
122
--enable-binreloc. When compiled for Linux with this option enabled,
123
GIMP will be binary relocatable. Plug-ins and data files will
124
be searched relative to the gimp binary instead of in the paths
125
defined at compile time.
127
--with-shm=[none|sysv|posix|auto]. This option allows you to specify
128
how image data is transported between the core and plug-ins. Usually
129
the best way to do this is detected automatically.
111
131
--without-libtiff, --without-libjpeg, --without-libpng. configure
112
132
will bail out if libtiff, libjpeg or libpng can not be found. You
136
156
--without-lcms. If for some reason you want to build GIMP without
137
157
using lcms for color support, you can build with --without-lcms.
159
--without-poppler. If for some reason you don't want to build the PDF
160
import plug-in that uses libpoppler, you can use --without-poppler.
162
--without-print. If for some reason you don't want to build the Print
163
plug-in based on the GtkPrint API, you can build with --without-print.
165
--without-gnomevfs. If you don't want to use gnomevfs to access remote
166
files, you can pass --without-gnomevfs to the configure script.
168
--without-libcurl. If you don't want to use libcurl to access remote
169
files, you can pass --without-gnomevfs to the configure script.
171
--without-alsa. If you don't want to compile ALSA support into the
172
MIDI input controller module, you can use the --without-alsa option.
174
--without-linux-input. If you don't want to compile the Linux Input
175
controller module, you can use the --without-linux-input option.
177
--without-dbus. If you want to build without D-Bus support, you can
178
pass --without-dbus to the configure script.
139
180
--with-gif-compression=[lzw|rle|none]. Allows to tune the compression
140
181
algorithm used by the GIF plug-in. If you are afraid of Unisys' LZW
141
182
patent (which should have expired in most countries by now), you
153
194
their API references so that the libgimp reference can link to
156
--disable-print. The print plug-in requires a recent version of
157
libgimpprint. If you don't have it already installed, download
158
it from http://gimp-print.sourceforge.net/. You need to pass
159
--without-gimp to gimp-print's configure script to build it without
160
having gimp-1.2 installed. If you want to compile GIMP without
161
support for printing, use the --disable-print option.
163
--enable-mp. This options control whether to build GIMP with or without
164
support for multiple processors. This option is off by default. If
165
you do have multiply processors and run GIMP with an OS supporting
166
them you will like to enable this features to use all of your
167
horsepower. Enabling it on singleprocessor systems won't harm but
168
cause a bit processing overhead.
197
--disable-mp. This option allows you to disable support for multiple
198
processors. It is enabled by default.
170
200
--with-sendmail=[PATH]. This option is used to tell GIMP where to find
171
201
the sendmail command. Normally this options don't have to be used
172
202
because configure tries to find it in the usual places.
174
204
--with-desktop-dir=[PATH]. This option specifies where to install
175
links to the gimp desktop files. These files are used by desktop
176
environments that comply to the specs published at freedesktop.org.
177
The default value ${prefix}/share should be fine if your desktop
178
environment is installed in the same prefix as gimp. No links are
179
created if the desktop directories don't exist or you used
180
--without-desktop-dir.
205
desktop files. These files are used by desktop environments that
206
comply to the specs published at freedesktop.org. The default
207
value ${prefix}/share should be fine if your desktop environment
208
is installed in the same prefix as gimp. No files are installed
209
if you call configure with --without-desktop-dir.
182
211
--disable-default-binary. Use this option if you don't want to make
183
gimp-2.2 the default gimp installation. Otherwise a link called
184
gimp pointing to the gimp-2.2 executable will be installed.
186
--enable-gimp-console. In addition to the standard gimp binary,
187
build a console-only binary which does not link GTK+ at all.
212
gimp-2.3 the default gimp installation. Otherwise a link called
213
gimp pointing to the gimp-2.3 executable will be installed.
215
--disable-gimp-console. Use this option if you don't want the
216
gimp-console binary to be built in addition to the standard binary.
217
gimp-console is useful for command-line batch mode or as a server.
219
--disable-python. If for some reason you don't want to build the
220
Python based pygimp plug-in, you can use --disable-python.
222
--without-script-fu. If for some reason you don't want to build the
223
Script-Fu plug-in, you can use --without-script-fu.
190
226
The `make' command builds several things:
191
227
- A bunch of public libraries in the directories starting with 'libgimp'.
192
228
- The plug-in programs in the 'plug-ins' directory.
193
229
- Some modules in the 'modules' subdirectory.
194
- The main GIMP program 'gimp-2.2' in `app'.
230
- The main GIMP program 'gimp-2.3' in `app'.
196
232
The `make install' commands installs the gimp header files associated
197
233
with the libgimp libraries, the plug-ins, some data files and the GIMP