manpagez: man pages & more
man gimp(1)
Home | html | info | man
gimp(1)                        GIMP Manual Pages                       gimp(1)




NAME

       gimp - an image manipulation and paint program.




SYNOPSIS

       gimp   [-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 display] [--session <name>] [-g]
       [--gimprc  <gimprc>] [--system-gimprc <gimprc>] [--dump-gimprc] [--con-
       sole-messages]    [--debug-handlers]    [--stack-trace-mode     <mode>]
       [--pdb-compat-mode   <mode>]   [--batch-interpreter  <procedure>]  [-b]
       [--batch <command>] [filename] ...




DESCRIPTION

       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  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.

       GIMP  ships  with a second binary called gimp-console. This binary is a
       console-only version and  behaves  as  if  gimp  was  called  with  the
       --no-interface command-line option.

       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.




OPTIONS

       GIMP accepts the following options:

       -h, --help
               Show GIMP command-line options.

       --help-all
               Show all command-line options.

       --help-gtk
               Show GTK+ command-line options.

       --help-gegl
               Show GEGL command-line options.

       -v, --version
               Output version information and exit.  When  combined  with  the
               --verbose  option,  version information about libraries used by
               GIMP is shown as well.

       --license
               Output license information and exit.

       --verbose
               Be verbose and create information on standard output.

       -n, --new-instance
               Do not attempt to  reuse  an  already  running  GIMP  instance.
               Always start a new one.

       -a, --as-new
               Open  filenames passed on the command-line as new images, don't
               set the filename on them.

       -i, --no-interface
               Run without a user interface.

       -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.

       --display display
               Use the designated X display.

       -s, --no-splash
               Do not show the splash screen.

       --no-shm
               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.

       --no-cpu-accel
               Do not use CPU accelerations such as MMX or SSE  even  if  GIMP
               detects that your CPU provides this functionality.

       --session <name>
               Use a different sessionrc for this GIMP session. The given ses-
               sion name is appended to the default sessionrc filename.

       -g, --gimprc <gimprc>
               Use an alternative gimprc instead of the default one. Useful in
               cases where plug-in paths or machine specs may be different.

       --system-gimprc <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 mes-
               sages 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 <procedure>
               Specifies  the  procedure  to  use to process batch events. The
               default is to let Script-Fu evaluate the commands.

       -b, --batch <command>
               Execute <command> non-interactively.  This  option  may  appear
               multiple  times.   The  <command> is passed to the batch inter-
               preter. When <command> is - the commands are read from standard
               input.




ENVIRONMENT

       GIMP respects a number of environment variables.


       DISPLAY to get the default host and display number.

       GIMP2_DIRECTORY
               to  get  the  name  of  the  personal  GIMP directory. If unset
               $XDG_CONFIG_HOME/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 $XDG_CONFIG_HOME.

       GIMP2_DATADIR
               to get the base location for data files  such  as  brushes  and
               patterns.  If unset ${datarootdir}/gimp/2.0 is used.

       GIMP2_LOCALEDIR
               to get the base location for translations. If unset ${dataroot-
               dir}/locale is used.

       GIMP2_PLUGINDIR
               to get the base location for plug-ins  and  modules.  If  unset
               ${exec_prefix}/lib/gimp/2.0 is used.

       GIMP2_SYSCONFDIR
               to  get  the  location  of configuration files. If unset ${pre-
               fix}/etc/gimp/2.0 is used.

       GIMP2_CACHEDIR
               to get the location for  caches  files.  If  unset  the  system
               default for per-user cached files is used.

       GIMP2_TEMPDIR
               to  get  the  location  of temporary files. If unset the system
               default for temporary files is used.

               On Linux GIMP can be compiled with support for binary relocati-
               bility.  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.




FILES

       GIMP's data files are stored in ${datarootdir}/gimp/2.0, where  ${data-
       rootdir} is set on install, but is typically /usr/share. GIMP's system-
       wide configuration files are stored  in  ${prefix}/etc/gimp/2.0,  where
       ${prefix} is typically /usr.

       Most GIMP configuration is read in from the user's init file, $XDG_CON-
       FIG_HOME/GIMP/2.10/gimprc. The system  wide  equivalent  is  in  ${pre-
       fix}/etc/gimp/2.0/gimprc.  The system wide file is parsed first and the
       user   gimprc   can   override    the    system    settings.     ${pre-
       fix}/etc/gimp/2.0/gimprc_user  is  the  default gimprc placed in users'
       home directories the first time GIMP is run.

       $XDG_CONFIG_HOME/GIMP/2.10/devicerc - holds settings for input  devices
       together  with the tool, colors, brush, pattern and gradient associated
       to that device.

       $XDG_CONFIG_HOME/GIMP/2.10/gtkrc - users set of GIMP-specific GTK+ con-
       fig  settings.  Options such as widget color and fonts sizes can be set
       here.

       ${prefix}/etc/gimp/2.0/gtkrc - system wide default set of GIMP-specific
       GTK+ config settings.

       $XDG_CONFIG_HOME/GIMP/2.10/menurc - user's set of keybindings.

       $XDG_CONFIG_HOME/GIMP/2.10/parasiterc - Stores all persistent GIMP par-
       asites. This file will be rewritten every time you quit GIMP.

       $XDG_CONFIG_HOME/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.

       $XDG_CONFIG_HOME/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.

       ${prefix}/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.

       $XDG_CONFIG_HOME/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.

       $XDG_CONFIG_HOME/GIMP/2.10/plug-ins  - location of user installed plug-
       ins.

       $XDG_CONFIG_HOME/GIMP/2.10/pluginrc - plug-in initialization values are
       stored here. This file is parsed on startup and regenerated if need be.

       $XDG_CONFIG_HOME/GIMP/2.10/modules - location of  user  installed  mod-
       ules.

       $XDG_CONFIG_HOME/GIMP/2.10/tmp  -  default  location  that GIMP uses as
       temporary space.

       ${datarootdir}/gimp/2.0/brushes - system wide brush files.

       $XDG_CONFIG_HOME/GIMP/2.10/brushes - user created and  installed  brush
       files. These files are in the .gbr, .gih or .vbr file formats.

       $XDG_CONFIG_HOME/GIMP/2.10/curves - Curve profiles and presets as saved
       from the Curves tool.

       $XDG_CONFIG_HOME/GIMP/2.10/gimpressionist - Presets  and  user  created
       brushes and papers are stored here.

       $XDG_CONFIG_HOME/GIMP/2.10/levels - Level profiles and presets as saved
       from the Levels tool.

       ${datarootdir}/gimp/2.0/palettes - the system wide palette files.

       $XDG_CONFIG_HOME/GIMP/2.10/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.

       $XDG_CONFIG_HOME/GIMP/2.10/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 gradi-
       ent files.

       $XDG_CONFIG_HOME/GIMP/2.10/gradients - user created and installed  gra-
       dient files.

       ${datarootdir}/gimp/2.0/scripts - system wide directory of scripts used
       in Script-Fu and other scripting extensions.

       $XDG_CONFIG_HOME/GIMP/2.10/scripts  -  user   created   and   installed
       scripts.

       ${datarootdir}/gimp/2.0/gflares  -  system  wide  directory used by the
       gflare plug-in.

       $XDG_CONFIG_HOME/GIMP/2.10/gflares - user created and installed  gflare
       files.

       ${datarootdir}/gimp/2.0/gfig  -  system wide directory used by the gfig
       plug-in.

       $XDG_CONFIG_HOME/GIMP/2.10/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 pro-
       viding 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
              $XDG_CONFIG_HOME/GIMP/2.10/splashes.

       2.     It     then     falls     back      to      using      $XDG_CON-
              FIG_HOME/GIMP/2.10/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  https://gitlab.gnome.org/GNOME/gimp/issues.
       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  https://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  https://docs.gimp.org/
       that goes into much more detail about the interactive use of GIMP.

       The  latest  versions of GIMP and the GTK+ libs are always available at
       https://download.gimp.org/.




AUTHORS

       Spencer Kimball, Peter Mattis and the GIMP Development Team.

       With patches, fixes, plug-ins, extensions, scripts, translations, docu-
       mentation and more from lots and lots of people all over the world.




SEE ALSO

       gimprc(5), gimptool(1),



Version 2.10.10                  March 23 2008                         gimp(1)

gimp 2.10.10 - Generated Mon Apr 15 06:01:47 CDT 2019
© manpagez.com 2000-2021
Individual documents may contain additional copyright information.