gimp (1)
NAME
gimp - an image manipulation and paint program.
SYNOPSIS
gimp [-h] [--help] [-v] [--version] [-b] [--batch <commands>] [-g]
[--gimprc <gimprc>] [-n] [--no-interface] [-r] [--restore-session]
[--no-data] [--verbose] [--no-shm] [--no-xshm] [--display display]
[--no-splash] [--no-splash-image] [--debug-handlers] [--console-mes-
sages] [--system-gimprc <gimprc>] [filename]...
DESCRIPTION
The GIMP is the GNU Image Manipulation Program. It is used to edit and
manipulate images. It can load and save a variety of image formats and
can be used to convert between formats.
Gimp can also be used as a paint program. It features a set of drawing
and painting tools such as airbrush, clone, pencil, and paint brush.
Painting and drawing tools can be applied to an image with a variety of
paint modes. It also offers an extensive array of selection tools like
rectangle, ellipse, fuzzy select, bezier select, intelligent scissors,
and select by color.
Gimp offers a variety of plugins that perform a variety of image manip-
ulations. Examples include bumpmap, edge detect, gaussian blur, and
many others.
In addition, Gimp has several scripting extension which allow for
advanced non-interactive processing and creation of images.
OPTIONS
The gimp accepts the following options:
-h, --help
Display a list of all commandline options.
-v, --version
Output the version info.
-b, --batch <commands>
Execute the set of <commands> non-interactively. The set of
<commands> is typically in the form of a script that can be
executed by one of the Gimp scripting extensions.
-g, --gimprc <gimprc>
Use an alternative gimprc instead of the default one. Useful in
cases where plugins paths or machine specs may be different.
-i, --no-interface
Run without a user interface.
-r, --restore-session
Try to restore saved session.
-d, --no-data
of using shared memory, GIMP will send the data via pipe. This
will result in slower performance than using shared memory.
--no-xshm
Do not use the X Shared Memory extension. If GIMP is being dis-
played on a remote X server, this probably needs to be enabled.
Also useful for any X server that doesn't properly support the
X shared memory extension. This will result in slower perfor-
mance than with X shared memory enabled.
--display display
Use the designated X display.
-s, --no-splash
Do not show the splash screen.
-S, --no-splash-image
Do not show the splash screen image as part of the splash
screen.
--debug-handlers
Enable debugging signal handlers.
-c, --console-messages
Do not popup dialog boxes on errors or warnings. Print the mes-
sages on the console instead.
--enable-stack-trace {never|query|always}
If a stack-trace should be generated in case of fatal signals.
--system-gimprc <gimprc>
Use an alternate system gimprc file.
ENVIRONMENT
DISPLAY to get the default host and display number.
XENVIRONMENT
to get the name of a resource file that overrides the global
resources stored in the RESOURCE_MANAGER property.
FILES
Gimp's data files are stored in /usr/share/gimp/1.2, where ${prefix} is
set on install, but is typically /usr/local. Gimp's system-wide config-
uration files are stored in /etc/gimp/1.2. Most gimp configuration is
read in from the user's init file, $HOME/.gimp-1.2/gimprc. The system
wide equivalent is in /etc/gimprc. The system wide file is parsed first
and the user gimprc can override the system settings. /etc/gimprc_user
is the default gimprc placed in users' home directories the first time
gimp is run.
$HOME/.gimp-1.2/gtkrc - users set of gimp-specific GTK config settings.
Options such as widget color and fonts sizes can be set here.
/etc/gimp/1.2/gtkrc - sytem wide default set of gimp-specific GTK con-
fig settings.
$HOME/.gimp-1.2/sessionrc - This file takes session-specific info (that
is info, you want to keep between two gimp-sessions). You are not sup-
posed to edit it manually, but of course you can do. This file will be
entirely rewritten every time you quit the gimp. If this file isn't
found, defaults are used.
/etc/gimp/1.2/unitrc - default user unit database. It contains the unit
definitions for centimeters, meters, feet, yards, typographic points
and typographic picas and is placed in users home directories the first
time the gimp is ran.
$HOME/.gimp-1.2/unitrc - This file contains your user unit database.
You can modify this list with the unit editor. You are not supposed to
edit it manually, but of course you can do. This file will be entirely
rewritten every time you quit the gimp.
$HOME/.gimp-1.2/plug-ins - location of user installed plugins.
$HOME/.gimp-1.2/pluginrc - plugin initialization values are stored
here. This file is parsed on startup and regenerated if need be.
$HOME/.gimp-1.2/modules - location of user installed modules.
$HOME/.gimp-1.2/tmp - default location that gimp uses as temporary
space.
/usr/share/gimp/1.2/brushes - system wide brush files.
$HOME/.gimp-1.2/brushes - user created and installed brush files. These
files are in the .gbr (gimp brush) format.
$HOME/.gimp-1.2/generated_brushes - Brushes generated and saved from
the brush dialog. These files are in the .vbr (gimp vector brush) for-
mat.
$HOME/.gimp-1.2/curves - Curve profiles and presets as saved from the
Curves tool.
$HOME/.gimp-1.2/gimpressionist - Presets and user created brushes and
papers are stored here.
$HOME/.gimp-1.2/levels - Level profiles and presets as saved from the
Levels tool.
/usr/share/gimp/1.2/palettes - the system wide palette files. The files
are copied to the user palettes directory when gimp is first ran to
allow the user to modify the palettes. This directory is not searched
for palettes by default.
$HOME/.gimp-1.2/palettes - copies of the system palette files as well
as user created and modified palette files.
/usr/share/gimp/1.2/patterns - basic set of patterns for use in gimp.
$HOME/.gimp-1.2/patterns - user created and installed gimp pattern
files. This files are in the .pat format.
$HOME/.gimp-1.2/scripts - user created and installed scripts.
/usr/share/gimp/1.2/gflares - system wide directory used by the gflare
plug-in.
$HOME/.gimp-1.2/gflares - user created and installed gflare files.
/usr/share/gimp/1.2/gfig - system wide directory used by the gfig plug-
in.
$HOME/.gimp-1.2/gfig - user created and installed gfig files.
/usr/share/gimp/1.2/gimp_splash.ppm - graphic file used for the gimp
splash screen.
/usr/share/gimp/1.2/gimp_logo.ppm - graphic file used in the Gimp about
dialog.
/usr/share/gimp/1.2/tips/gimp_tips.txt - list of tips displayed in the
"Tip of the Day" dialog box. At the same place you will find files with
tips in other languages.
COPYRIGHT
Copyright © 1995 Spencer Kimball and Peter Mattis
Permission to use, copy, modify, and distribute this software and its
documentation for any purpose and without fee is hereby granted, pro-
vided that the above copyright notice appear in all copies and that
both that copyright notice and this permission notice appear in sup-
porting documentation.
SUGGESTIONS AND BUG REPORTS
Any bugs found should be reported to the Gimp Developer mailing list at
gimp-developer@xcf.berkeley.edu or you may want to make use of the
online bug-tracking system available on the web at
http://bugs.gnome.org/db/pa/lgimp.html or submit a bug report to the
system via http://www.xach.com/gimp/news/bugreport.html
Before reporting bugs, please check to see if the bug is mentioned in
the FAQ's or the mailing list archive. See the section on Other Info
for locations of these.
When reporting Gimp bugs, it is important to include a reliable way to
reproduce the bug, version number of Gimp (and probably GTK), OS name
and version, and any relevant hardware specs. It is also very important
to include as much info as possible about the Xserver the problem was
found on including at least server name, the visual, and the bit depth.
If a bug is causing a crash, it is very useful if a stack trace can be
provided. And of course, patches to rectify the bug are even better.
OTHER INFO
The canonical place to find GIMP info is at http://www.gimp.org/. Here
you can find links to just about every other gimp site, tutorials, data
AUTHORS
Spencer Kimball and Peter Mattis.
With patches, fixes, plugins, extensions, scripts, translations, docu-
mentation, and more from lots and lots of people including but not lim-
ited to Lauri Alanko, Shawn Amundson, Sven Anders, Karl-Johan Anders-
son, John Beale, Zach Beane, Tom Bech, Marc Bless, Edward Blevins, Rea-
gan Blundell, Xavier Bouchoux, Roberto Boyd, Stanislav Brabec, Robert
Brady, Hans Breuer, Simon Budig, Carey Bunks, Seth Burgess, Brent Bur-
ton, Francisco Bustamante, Albert Cahalan, Sean Cier, Winston Chang,
Kenneth Christiansen, Zbigniew Chyla, Ed Connel, Piers Cornwell, Daniel
Cotting, Jay Cox, Brian Degenhardt, Gert Dewit, Andreas Dilger, Austin
Donnelly, Scott Draves, Daniel Dunbar, Misha Dynin, Daniel Egger, Mor-
ton Eriksen, Larry Ewing, Nick Fetchak, Valek Filippov, David Forsyth,
Raphael Francois, Jochen Friedrich, Sami Gerdt, Jim Geuther, Graeme
Gill, Scott Goehring, Heiko Goller, Marcelo de Gomensoro Malheiros,
Pavel Grinfeld, Michael Hammel, Henrik Hansen, Ville Hautamaki, James
Henstridge, Eric Hernes, David Hodson, Christoph Hoegl, Wolfgang Hofer,
Jan Hubicka, Andreas Hyden, Ben Jackson, Krzysztof Jakubowski, Simon
Janes, Tim Janik, Fellmann Joaquim, Andrew Kieschnick, Peter Kirchgess-
ner, Philipp Klaus, David Koblas, Robert L Krawitz, Tuomas Kuosmanen,
Karin Kylander, Olof S Kylander, Karl La Rocca, Chris Lahey, Nick Lamb,
Marco Lamberto, Jens Lautenbacher, Laramie Leavitt, Elliot Lee, Marc
Lehmann, Ray Lehtiniemi, Raph Levien, Wing Tung Leung, Adrian Likins,
Tor Lillqvist, Ingo Luetkebohle, Josh MacDonald, Ed Mackey, Vidar Mad-
sen, Ian Main, Kjartan Maraas, Kelly Martin, Torsten Martinsen, Gordon
Matzigkeit, Gregory McLean, Daniele Medri, Federico Mena Quintero,
James Mitchell, Hirotsuna Mizuno, David Monniaux, Adam D Moss, Balazs
Nagy, Yukihiro Nakai, Sung-Hyun Nam, Shuji Narazaki, Felix Natter,
Michael Natterer, Sven Neumann, Stephen Robert Norris, Tim Newsome,
Erik Nygren, Tomas Ogren, Miles O'Neal, Thom van Os, Garry R. Osgood,
Alan Paeth, Jay Painter, Sergey Panov, Asbjorn Pettersen, Mike
Phillips, Artur Polaczynski, Raphael Quinet, Tom Rathborne, Vincent
Renardias, Jens Restemeier, Maurits Rijk, Daniel Risacher, James Robin-
son, Tim Rowley, Pablo Saratxaga, Mike Schaeffer, John Schlag, Norbert
Schmitz, Thorsten Schnier, Alexander Schulz, Tracy Scott, Craig Setera,
Aaron Sherman, Manish Singh, Daniel Skarda, Nathan Summers, Mike Sweet,
Yuri Syrota, Eiichi Takamori, Tristan Tarrant, Michael Taylor, Owen
Taylor, Ian Tester, Andy Thomas, Kevin Turner, Martin Weber, James
Wang, Kris Wehner, Nigel Wetten, Calvin Williamson, Matthew Wilson,
Shirasaki Yasuhiro.
SEE ALSO
gimprc(5), gimptool(1), gimp-remote(1)
Version 1.2.3 23 June 2000 gimp(1)