--- name: "gimp-2.2" section: "1" platform: "linux" package: "gimp" version: "2.2.13-1etch4" release: "Debian 4.0 (Etch)" platforms: ["linux"] url: "https://new.carta.tech/gimp-2.2" --- # gimp-2.2(1) an image manipulation and paint program. ## NAME gimp - an image manipulation and paint program. ## SYNOPSIS **gimp** \[-h\] \[--help\] \[-v\] \[--version\] \[--verbose\] \[--no-shm\] \[--no-cpu-accel\] \[--display *display*\] \[-d\] \[--no-data\] \[-f\] \[--no-fonts\] \[-i\] \[--no-interface\] \[-s\] \[--no-splash\] \[--session *\*\] \[-g\] \[--gimprc *\*\] \[--system-gimprc *\*\] \[--dump-gimprc*\]* *\[--console-messages\] \[--debug-handlers\]* *\[--batch-interpreter \\] \[-b\] \[--batch \\]* *\[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* *manipulations. 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.* - **--verbose** *Show startup messages.* - **--no-shm** *Do not use shared memory between GIMP and its plugins.* *Instead of using shared memory, GIMP will send the data via pipe. This* *will result in slower performance than using shared memory.* - **--no-cpu-accel** *Do not use CPU accelerations such as MMX or SSE even if GIMP detects* *that your CPU provides this functionality.* - **-d, --no-data** *Do not load patterns, gradients, palettes, or brushes. Often useful* *in non-interactive situations where startup time is to be minimized.* - **-f, --no-fonts** *Do not load any fonts. No text functionality will be available if this* *option is used.* - **-i, --no-interface** *Run without a user interface.* - **--display *display*** *Use the designated X display.* - **-s, --no-splash** *Do not show the splash screen.* - **--session *\*** *Use a different sessionrc for this GIMP session. The given session* *name is appended to the default sessionrc filename.* - **-g, --gimprc *\*** *Use an alternative gimprc instead of the default one. Useful in* *cases where plugins paths or machine specs may be different.* - **--system-gimprc *\*** *Use an alternate system gimprc file.* - **--dump-gimprc** *Output a gimprc file with default settings.* - **--debug-handlers** *Enable debugging signal handlers.* - **-c, --console-messages** *Do not popup dialog boxes on errors or warnings. Print the messages on* *the console instead.* - **--stack-trace-mode *{never\|query\|always}*** *If a stack-trace should be generated in case of fatal signals.* - **--pdb-compat-mode *{off\|on\|warn}*** *If the PDB should provide aliases for deprecated functions.* - **--batch-interpreter *\*** *Specifies the procedure to use to process batch events. The default is* *to let Script-Fu evaluate the commands.* - **-b, --batch *\*** *Execute the set of \ non-interactively. The set* *of \ is typically in the form of a script that* *can be executed by one of the GIMP scripting extensions. When* *\ is* **-** *the commands are read from standard* *input.* - ## 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 ${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.* *Most GIMP configuration is read in from the user's init file,* **$HOME***/.gimp-2.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-2.2/devicerc - holds settings for input devices* *together with the tool, colors, brush, pattern and gradient* *associated to that device.* **$HOME***/.gimp-2.2/documents - lists all images that have been* *opened or saved using GIMP.* **$HOME***/.gimp-2.2/gtkrc - users set of GIMP-specific GTK config* *settings. Options such as widget color and fonts sizes can be set* *here.* */etc/gimp/2.0/gtkrc - sytem wide default set of GIMP-specific GTK+* *config settings.* **$HOME***/.gimp-2.2/menurc - user's set of keybindings.* **$HOME***/.gimp-2.2/parasiterc - Stores all persistent GIMP* *parasites. This file will be rewritten every time you quit the GIMP.* **$HOME***/.gimp-2.2/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 the GIMP. If this* *file isn't found, defaults are used.* **$HOME***/.gimp-2.2/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.* */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 the GIMP is ran. If this file isn't found, defaults are* *used.* **$HOME***/.gimp-2.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-2.2/plug-ins - location of user installed plugins.* **$HOME***/.gimp-2.2/pluginrc - plugin initialization values are* *stored here. This file is parsed on startup and regenerated if need* *be.* **$HOME***/.gimp-2.2/modules - location of user installed modules.* **$HOME***/.gimp-2.2/tmp - default location that GIMP uses as* *temporary space.* *${datarootdir}/gimp/2.0/brushes - system wide brush files.* **$HOME***/.gimp-2.2/brushes - user created and installed brush* *files. These files are in the .gbr, .gih or .vbr file formats.* **$HOME***/.gimp-2.2/curves - Curve profiles and presets as saved from* *the Curves tool.* **$HOME***/.gimp-2.2/gimpressionist - Presets and user created brushes* *and papers are stored here.* **$HOME***/.gimp-2.2/levels - Level profiles and presets as saved from* *the Levels tool.* *${datarootdir}/gimp/2.0/palettes - the system wide palette files.* **$HOME***/.gimp-2.2/palettes - user created and modified palette* *files. This files are in the .gpl format.* *${datarootdir}/gimp/2.0/patterns - basic set of patterns for use in GIMP.* **$HOME***/.gimp-2.2/patterns - user created and installed gimp* *pattern files. This files are in the .pat format.* *${datarootdir}/gimp/2.0/gradients - standard system wide set of gradient files.* **$HOME***/.gimp-2.2/gradients - user created and installed gradient* *files.* *${datarootdir}/gimp/2.0/scripts - system wide directory of scripts* *used in Script-Fu and other scripting extensions.* **$HOME***/.gimp-2.2/scripts - user created and installed scripts.* *${datarootdir}/gimp/2.0/gflares - system wide directory used by the gflare* *plug-in.* **$HOME***/.gimp-2.2/gflares - user created and installed gflare* *files.* *${datarootdir}/gimp/2.0/gfig - system wide directory used by the gfig plug-in.* **$HOME***/.gimp-2.2/gfig - user created and installed gfig files.* *${datarootdir}/gimp/2.0/images/gimp-splash.png - the default image used for the* *GIMP splash screen.* *${datarootdir}/gimp/2.0/images/gimp-logo.png - image used in the GIMP about* *dialog.* *${datarootdir}/gimp/2.0/tips/gimp-tips.xml - tips as displayed in the "Tip of* *the Day" dialog box.* ## SPLASH IMAGES *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:* - 1\. *GIMP tries to load a random splash screen from the directory* **$HOME***/.gimp-2.2/splashes.* - 2\. *It then falls back to using* **$HOME***/.gimp-2.2/gimp-splash.png.* - 3\. *If the user didn't install any custom splash images, a random image is* *picked from ${datarootdir}/gimp/2.0/splashes.* - 4\. *As a last resort, GIMP uses the default splash image located at* *${datarootdir}/gimp/2.0/images/gimp-splash.png.* ## SUGGESTIONS AND BUG REPORTS *Any bugs found should be reported to the online bug-tracking system* *available on the web at http://bugzilla.gnome.org/. Before reporting* *bugs, please check to see if the bug has already been reported.* *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.* ## OTHER INFO *The canonical place to find GIMP info is at http://www.gimp.org/.* *Here you can find links to just about many other GIMP sites,* *tutorials, data sets, mailing list archives, and more.* *There is also a GIMP User Manual available at* *http://manual.gimp.org/ that goes into much more detail* *about the interactive use of GIMP.* *The latest version of GIMP and the GTK+ libs is always available at* *ftp://ftp.gimp.org/.* ## AUTHORS *Spencer Kimball and Peter Mattis.* *With patches, fixes, plugins, extensions, scripts,* *translations, documentation, and more from lots* *and lots of people all over the world.* ## SEE ALSO [**gimprc**(5)](/gimprc/5.md), [**gimptool**(1)](/gimptool/1.md), [**gimp-remote**(1)](/gimp-remote/1.md)