Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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]	[--li-
       cense] [--verbose] [-n] [--new-instance]	[-a] [--as-new]	[-i] [--no-in-
       terface]	  [-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  ma-
       nipulate	 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 ma-
       nipulations.  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 de-
       tects 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. Al-
	       ways 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.   In-
	       stead of	using shared memory, GIMP will send the	data via pipe.
	       This will result	in slower performance than using  shared  mem-
	       ory.

       --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 de-
	       fault 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 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}/libexec/gimp/2.2 is used.

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

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

       GIMP2_TEMPDIR
	       to get the location of temporary	files. If unset	the system de-
	       fault 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, where  ${dataroot-
       dir} is set on install, but is typically	/usr/share. GIMP's system-wide
       configuration files are stored in ${prefix}/etc/gimp/2.2, where	${pre-
       fix} 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.2/gimprc.  The system wide file is parsed first and the
       user   gimprc   can   override	 the	system	  settings.	${pre-
       fix}/etc/gimp/2.2/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.2/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.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	 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/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/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/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/gradients  -	 standard  system wide set of gradient
       files.

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

       ${datarootdir}/gimp/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/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/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/images/gimp-splash.png - the	default	image used for
       the GIMP	splash screen.

       ${datarootdir}/gimp/images/gimp-logo.png	- image	used in	the GIMP about
       dialog.

       ${datarootdir}/gimp/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/splashes.

       4.     As a last	resort,	GIMP uses the default splash image located  at
	      ${datarootdir}/gimp/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. Be-
       fore  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.20			 March 23 2008			       GIMP(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | ENVIRONMENT | FILES | SPLASH IMAGES | SUGGESTIONS AND BUG REPORTS | OTHER INFO | AUTHORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=gimp&sektion=1&manpath=FreeBSD+12.1-RELEASE+and+Ports>

home | help