460 lines
15 KiB
HTML
460 lines
15 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of GIMP</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>GIMP</H1>
|
|
Section: GIMP Manual Pages (1)<BR>Updated: March 23 2008<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<P>
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
gimp - an image manipulation and paint program.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>gimp</B>
|
|
|
|
[-h] [--help] [--help-all] [--help-gtk] [-v] [--version]
|
|
[--license] [--verbose] [-n] [--new-instance] [-a] [--as-new]
|
|
[-i] [--no-interface] [-d] [--no-data] [-f] [--no-fonts]
|
|
[-s] [--no-splash] [--no-shm] [--no-cpu-accel]
|
|
[--display <I>display</I>] [--session <I><name></I>]
|
|
[-g] [--gimprc <I><gimprc></I>] [--system-gimprc <I><gimprc></I>]
|
|
[--dump-gimprc] [--console-messages] [--debug-handlers]
|
|
[--stack-trace-mode <I><mode></I>] [--pdb-compat-mode <I><mode></I>]
|
|
[--batch-interpreter <I><procedure></I>] [-b] [--batch <I><command></I>]
|
|
[<I>filename</I>] ...
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<P>
|
|
|
|
GIMP is the <I>GNU Image Manipulation Program</I>. 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.
|
|
<P>
|
|
|
|
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.
|
|
<P>
|
|
|
|
GIMP offers a variety of plug-ins that perform a variety of image
|
|
manipulations. Examples include bumpmap, edge detect, gaussian blur,
|
|
and many others. In addition, GIMP has several scripting extensions
|
|
which allow for advanced non-interactive processing and creation of
|
|
images.
|
|
<P>
|
|
|
|
GIMP ships with a second binary called <I>gimp-console</I>. This binary
|
|
is a console-only version and behaves as if <I>gimp</I> was called with
|
|
the --no-interface command-line option.
|
|
<P>
|
|
|
|
On platforms with the D-Bus message bus system, GIMP will by default check
|
|
if an instance is already running in this user session. If it detects that,
|
|
it will pass all filenames given on the command-line to the already running
|
|
GIMP instance and quit.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>OPTIONS</H2>
|
|
|
|
GIMP accepts the following options:
|
|
<DL COMPACT>
|
|
<DT id="1"><B>-h, --help</B>
|
|
|
|
<DD>
|
|
Show GIMP command-line options.
|
|
<DT id="2"><B>--help-all</B>
|
|
|
|
<DD>
|
|
Show all command-line options.
|
|
<DT id="3"><B>--help-gtk</B>
|
|
|
|
<DD>
|
|
Show GTK+ command-line options.
|
|
<DT id="4"><B>--help-gegl</B>
|
|
|
|
<DD>
|
|
Show GEGL command-line options.
|
|
<DT id="5"><B>-v, --version</B>
|
|
|
|
<DD>
|
|
Output version information and exit. When combined with the --verbose
|
|
option, version information about libraries used by GIMP is shown as well.
|
|
<DT id="6"><B>--license</B>
|
|
|
|
<DD>
|
|
Output license information and exit.
|
|
<DT id="7"><B>--verbose</B>
|
|
|
|
<DD>
|
|
Be verbose and create information on standard output.
|
|
<DT id="8"><B>-n, --new-instance</B>
|
|
|
|
<DD>
|
|
Do not attempt to reuse an already running GIMP instance. Always start a
|
|
new one.
|
|
<DT id="9"><B>-a, --as-new</B>
|
|
|
|
<DD>
|
|
Open filenames passed on the command-line as new images, don't set the
|
|
filename on them.
|
|
<DT id="10"><B>-i, --no-interface</B>
|
|
|
|
<DD>
|
|
Run without a user interface.
|
|
<DT id="11"><B>-d, --no-data</B>
|
|
|
|
<DD>
|
|
Do not load patterns, gradients, palettes, or brushes. Often useful
|
|
in non-interactive situations where startup time is to be minimized.
|
|
<DT id="12"><B>-f, --no-fonts</B>
|
|
|
|
<DD>
|
|
Do not load any fonts. No text functionality will be available if this
|
|
option is used.
|
|
<DT id="13"><B>--display </B><I>display</I>
|
|
|
|
<DD>
|
|
Use the designated X display.
|
|
<DT id="14"><B>-s, --no-splash</B>
|
|
|
|
<DD>
|
|
Do not show the splash screen.
|
|
<DT id="15"><B>--no-shm</B>
|
|
|
|
<DD>
|
|
Do not use shared memory between GIMP and its plug-ins.
|
|
Instead of using shared memory, GIMP will send the data via pipe. This
|
|
will result in slower performance than using shared memory.
|
|
<DT id="16"><B>--no-cpu-accel</B>
|
|
|
|
<DD>
|
|
Do not use CPU accelerations such as MMX or SSE even if GIMP detects
|
|
that your CPU provides this functionality.
|
|
<DT id="17"><B>--session </B><I><name></I>
|
|
|
|
<DD>
|
|
Use a different sessionrc for this GIMP session. The given session
|
|
name is appended to the default sessionrc filename.
|
|
<DT id="18"><B>-g, --gimprc </B><I><gimprc></I>
|
|
|
|
<DD>
|
|
Use an alternative gimprc instead of the default one. Useful in
|
|
cases where plug-in paths or machine specs may be different.
|
|
<DT id="19"><B>--system-gimprc </B><I><gimprc></I>
|
|
|
|
<DD>
|
|
Use an alternate system gimprc file.
|
|
<DT id="20"><B>--dump-gimprc</B>
|
|
|
|
<DD>
|
|
Output a gimprc file with default settings.
|
|
<DT id="21"><B>--debug-handlers</B>
|
|
|
|
<DD>
|
|
Enable debugging signal handlers.
|
|
<DT id="22"><B>-c, --console-messages</B>
|
|
|
|
<DD>
|
|
Do not popup dialog boxes on errors or warnings. Print the messages on
|
|
the console instead.
|
|
<DT id="23"><B>--stack-trace-mode </B><I>{never|query|always}</I>
|
|
|
|
<DD>
|
|
If a stack-trace should be generated in case of fatal signals.
|
|
<DT id="24"><B>--pdb-compat-mode </B><I>{off|on|warn}</I>
|
|
|
|
<DD>
|
|
If the PDB should provide aliases for deprecated functions.
|
|
<DT id="25"><B>--batch-interpreter </B><I><procedure></I>
|
|
|
|
<DD>
|
|
Specifies the procedure to use to process batch events. The default is
|
|
to let Script-Fu evaluate the commands.
|
|
<DT id="26"><B>-b, --batch </B><I><command></I>
|
|
|
|
<DD>
|
|
Execute <I><command></I> non-interactively. This option may appear
|
|
multiple times. The <I><command></I> is passed to the batch
|
|
interpreter. When <I><command></I> is <B>-</B> the commands are read
|
|
from standard input.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>ENVIRONMENT</H2>
|
|
|
|
GIMP respects a number of environment variables.
|
|
<P>
|
|
|
|
<DL COMPACT>
|
|
<DT id="27"><B>DISPLAY</B>
|
|
|
|
<DD>
|
|
to get the default host and display number.
|
|
<DT id="28"><B>GIMP2_DIRECTORY</B>
|
|
|
|
<DD>
|
|
to get the name of the personal GIMP directory. If unset <B>$XDG_CONFIG_HOME</B>/GIMP/2.10 is
|
|
used. If this is an absolute path, it is used as is. If it is a
|
|
relative path, it is taken to be a subdirectory of <B>$XDG_CONFIG_HOME</B>.
|
|
<DT id="29"><B>GIMP2_DATADIR</B>
|
|
|
|
<DD>
|
|
to get the base location for data files such as brushes and patterns.
|
|
If unset ${datarootdir}/gimp/2.0 is used.
|
|
<DT id="30"><B>GIMP2_LOCALEDIR</B>
|
|
|
|
<DD>
|
|
to get the base location for translations. If unset ${datarootdir}/locale
|
|
is used.
|
|
<DT id="31"><B>GIMP2_PLUGINDIR</B>
|
|
|
|
<DD>
|
|
to get the base location for plug-ins and modules. If unset
|
|
/usr/lib/gimp/2.0 is used.
|
|
<DT id="32"><B>GIMP2_SYSCONFDIR</B>
|
|
|
|
<DD>
|
|
to get the location of configuration files. If unset /etc/gimp/2.0
|
|
is used.
|
|
<DT id="33"><B>GIMP2_CACHEDIR</B>
|
|
|
|
<DD>
|
|
to get the location for caches files. If unset the system default for
|
|
per-user cached files is used.
|
|
<DT id="34"><B>GIMP2_TEMPDIR</B>
|
|
|
|
<DD>
|
|
to get the location of temporary files. If unset the system default for
|
|
temporary files is used.
|
|
<P>
|
|
On Linux GIMP can be compiled with support for binary relocatibility.
|
|
This will cause data, plug-ins and configuration files to be searched
|
|
relative to the location of the gimp executable file unless overridden
|
|
by the environment variables mentioned above.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
GIMP's data files are stored in ${datarootdir}/gimp/2.0, where ${datarootdir}
|
|
is set on install, but is typically /usr/share. GIMP's system-wide
|
|
configuration files are stored in /etc/gimp/2.0, where ${prefix}
|
|
is typically /usr.
|
|
<P>
|
|
Most GIMP configuration is read in from the user's init file,
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/gimprc. The system wide equivalent is in
|
|
/etc/gimp/2.0/gimprc. The system wide file is parsed first and the
|
|
user gimprc can override the system settings.
|
|
/etc/gimp/2.0/gimprc_user is the default gimprc placed in users'
|
|
home directories the first time GIMP is run.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/devicerc - holds settings for input devices together
|
|
with the tool, colors, brush, pattern and gradient associated to that
|
|
device.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/gtkrc - users set of GIMP-specific GTK+ config
|
|
settings. Options such as widget color and fonts sizes can be set
|
|
here.
|
|
<P>
|
|
/etc/gimp/2.0/gtkrc - system wide default set of GIMP-specific GTK+
|
|
config settings.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/menurc - user's set of keybindings.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/parasiterc - Stores all persistent GIMP
|
|
parasites. This file will be rewritten every time you quit GIMP.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/sessionrc - This file takes session-specific info
|
|
(that is info, you want to keep between two GIMP sessions). You are
|
|
not supposed to edit it manually, but of course you can do. This file
|
|
will be entirely rewritten every time you quit GIMP. If this file
|
|
isn't found, defaults are used.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/templaterc - Image templates are kept in this
|
|
file. New images can conveniently created from these templates. If
|
|
this file isn't found, defaults are used.
|
|
<P>
|
|
/etc/gimp/2.0/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 GIMP is ran. If this file isn't found, defaults are
|
|
used.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/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 GIMP.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/plug-ins - location of user installed plug-ins.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/pluginrc - plug-in initialization values are stored
|
|
here. This file is parsed on startup and regenerated if need be.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/modules - location of user installed modules.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/tmp - default location that GIMP uses as temporary
|
|
space.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/brushes - system wide brush files.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/brushes - user created and installed brush
|
|
files. These files are in the .gbr, .gih or .vbr file formats.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/curves - Curve profiles and presets as saved from
|
|
the Curves tool.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/gimpressionist - Presets and user created brushes
|
|
and papers are stored here.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/levels - Level profiles and presets as saved from
|
|
the Levels tool.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/palettes - the system wide palette files.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/palettes - user created and modified palette
|
|
files. This files are in the .gpl format.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/patterns - basic set of patterns for use in GIMP.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/patterns - user created and installed gimp pattern
|
|
files. This files are in the .pat format.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/gradients - standard system wide set of gradient files.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/gradients - user created and installed gradient
|
|
files.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/scripts - system wide directory of scripts
|
|
used in Script-Fu and other scripting extensions.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/scripts - user created and installed scripts.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/gflares - system wide directory used by the gflare
|
|
plug-in.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/gflares - user created and installed gflare
|
|
files.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/gfig - system wide directory used by the gfig plug-in.
|
|
<P>
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/gfig - user created and installed gfig files.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/images/gimp-splash.png - the default image used for the
|
|
GIMP splash screen.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/images/gimp-logo.png - image used in the GIMP about
|
|
dialog.
|
|
<P>
|
|
${datarootdir}/gimp/2.0/tips/gimp-tips.xml - tips as displayed in the "Tip of
|
|
the Day" dialog box.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SPLASH IMAGES</H2>
|
|
|
|
GIMP comes with a default image for the splash screen but it allows
|
|
system administrators and users to customize the splash screen by
|
|
providing other images. The image to be used with the splash screen is
|
|
chosen as follows:
|
|
<P>
|
|
<DL COMPACT>
|
|
<DT id="35">1.<DD>
|
|
GIMP tries to load a random splash screen from the directory
|
|
<B>$XDG_CONFIG_HOME</B>/GIMP/2.10/splashes.
|
|
<DT id="36">2.<DD>
|
|
It then falls back to using <B>$XDG_CONFIG_HOME</B>/GIMP/2.10/gimp-splash.png.
|
|
<DT id="37">3.<DD>
|
|
If the user didn't install any custom splash images, a random image is
|
|
picked from ${datarootdir}/gimp/2.0/splashes.
|
|
<DT id="38">4.<DD>
|
|
As a last resort, GIMP uses the default splash image located at
|
|
${datarootdir}/gimp/2.0/images/gimp-splash.png.
|
|
<P>
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAI"> </A>
|
|
<H2>SUGGESTIONS AND BUG REPORTS</H2>
|
|
|
|
Any bugs found should be reported to the online bug-tracking system
|
|
available on the web at
|
|
<A HREF="https://gitlab.gnome.org/GNOME/gimp/issues.">https://gitlab.gnome.org/GNOME/gimp/issues.</A> Before reporting bugs,
|
|
please check to see if the bug has already been reported.
|
|
<P>
|
|
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. 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.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAJ"> </A>
|
|
<H2>OTHER INFO</H2>
|
|
|
|
The canonical place to find GIMP info is at <A HREF="https://www.gimp.org/.">https://www.gimp.org/.</A>
|
|
Here you can find links to just about many other GIMP sites,
|
|
tutorials, data sets, mailing list archives, and more.
|
|
<P>
|
|
There is also a GIMP User Manual available at <A HREF="https://docs.gimp.org/">https://docs.gimp.org/</A>
|
|
that goes into much more detail about the interactive use of GIMP.
|
|
<P>
|
|
The latest versions of GIMP and the GTK+ libs are always available at
|
|
<A HREF="https://download.gimp.org/.">https://download.gimp.org/.</A>
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAK"> </A>
|
|
<H2>AUTHORS</H2>
|
|
|
|
Spencer Kimball, Peter Mattis and the GIMP Development Team.
|
|
<P>
|
|
With patches, fixes, plug-ins, extensions, scripts, translations,
|
|
documentation and more from lots and lots of people all over the
|
|
world.
|
|
<P>
|
|
<P>
|
|
<A NAME="lbAL"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?5+gimprc">gimprc</A></B>(5),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?1+gimptool">gimptool</A></B>(1),
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="39"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="40"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="41"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="42"><A HREF="#lbAE">OPTIONS</A><DD>
|
|
<DT id="43"><A HREF="#lbAF">ENVIRONMENT</A><DD>
|
|
<DT id="44"><A HREF="#lbAG">FILES</A><DD>
|
|
<DT id="45"><A HREF="#lbAH">SPLASH IMAGES</A><DD>
|
|
<DT id="46"><A HREF="#lbAI">SUGGESTIONS AND BUG REPORTS</A><DD>
|
|
<DT id="47"><A HREF="#lbAJ">OTHER INFO</A><DD>
|
|
<DT id="48"><A HREF="#lbAK">AUTHORS</A><DD>
|
|
<DT id="49"><A HREF="#lbAL">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:13 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|