gimp/etc/gimprc

# This is the system-wide gimprc file.  Any change made in this file will
# affect all users of this system, provided that they are not overriding the
# default values in their personal gimprc file.
# 
# Lines that start with a '#' are comments. Blank lines are ignored.
# 
# By default everything in this file is commented out.  The file then
# documents the default values and shows what changes are possible.
# 
# The variable ${gimp_dir} is set to the value of the environment variable
# GIMP2_DIRECTORY or, if that is not set, the compiled-in default value is
# used.  If GIMP2_DIRECTORY is not an absolute path, it is interpreted
# relative to your home directory.

# Sets the temporary storage directory. Files will appear here during the
# course of running the GIMP.  Most files will disappear when the GIMP exits,
# but some files are likely to remain, so it is best if this directory not be
# one that is shared by other users.  This is a single folder.
#
# (temp-path "${gimp_dir}/tmp")

# Sets the swap file location. The gimp uses a tile based memory allocation
# scheme. The swap file is used to quickly and easily swap tiles out to disk
# and back in. Be aware that the swap file can easily get very large if the
# GIMP is used with large images. Also, things can get horribly slow if the
# swap file is created on a directory that is mounted over NFS.  For these
# reasons, it may be desirable to put your swap file in "/tmp".  This is a
# single folder.
#
# (swap-path "${gimp_dir}")

# There is always a tradeoff between memory usage and speed.  In most cases,
# the GIMP opts for speed over memory.  However, if memory is a big issue,
# try to enable this setting.  Possible values are yes and no.
#
# (stingy-memory-use no)

# On multiprocessor machines, if GIMP has been compiled with --enable-mp this
# sets how many processors GIMP should use simultaneously.  This is an
# integer value.
#
# (num-processors 1)

# The tile cache is used to make sure the GIMP doesn't thrash tiles between
# memory and disk. Setting this value higher will cause the GIMP to use less
# swap space, but will also cause the GIMP to use more memory. Conversely, a
# smaller cache size causes the GIMP to use more swap space and less memory. 
# The integer size can contain a suffix of 'B', 'K', 'M' or 'G' which makes
# GIMP interpret the size as being specified in bytes, kilobytes, megabytes
# or gigabytes. If no suffix is specified the size defaults to being
# specified in kilobytes.
#
# (tile-cache-size 64M)

# Sets the level of interpolation used for scaling and other transformations.
#  Possible values are none, linear and cubic.
#
# (interpolation-type linear)

# Sets the plug-in search path.  This is a colon-separated list of folders to
# search.
#
# (plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")

# Sets the module search path.  This is a colon-separated list of folders to
# search.
#
# (module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")

# Sets the environ search path.  This is a colon-separated list of folders to
# search.
#
# (environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")

# Sets the brush search path.  This is a colon-separated list of folders to
# search.
#
# (brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")

# Sets the pattern search path.  This is a colon-separated list of folders to
# search.
#
# (pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")

# Sets the palette search path.  This is a colon-separated list of folders to
# search.
#
# (palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")

# Sets the gradient search path.  This is a colon-separated list of folders
# to search.
#
# (gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")

# Specify a default brush.  The brush is searched for in the specified brush
# path.  This is a string value.
#
# (default-brush "Circle (11)")

# Specify a default pattern. The pattern is searched for in the specified
# pattern path.  This is a string value.
#
# (default-pattern "Pine")

# Specify a default palette.  The palette is searched for in the specified
# palette path.  This is a string value.
#
# (default-palette "Default")

# Specify a default gradient.  The gradient is searched for in the specified
# gradient path.  This is a string value.
#
# (default-gradient "FG to BG (RGB)")

# Specify a default font.  The font is searched for in the fontconfig font
# path.  This is a string value.
#
# (default-font "Sans")

# Sets the default comment.  This is a string value.
#
# (default-comment "Created with The GIMP")

# Sets the default image type in the "File/New" dialog.  Possible values are
# rgb, gray and indexed.
#
# (default-image-type rgb)

# Sets the default image width in the "File/New" dialog.  This is an integer
# value.
#
# (default-image-width 256)

# Sets the default image height in the "File/New" dialog.  This is an integer
# value.
#
# (default-image-height 256)

# Sets the default unit for new images and for the "File/New" dialog. This
# units will be used for coordinate display when not in dot-for-dot mode. 
# The unit can be one inches, millimeters, points or picas plus those in your
# user units database.
#
# (default-unit inches)

# Sets the default horizontal resolution for new images and for the
# "File/New" dialog. This value is always in dpi (dots per inch).  This is a
# float value.
#
# (default-xresolution 72.000000)

# Sets the default vertical resolution for new images and for the "File/New"
# dialog. This value is always in dpi (dots per inch).  This is a float
# value.
#
# (default-yresolution 72.000000)

# Sets the units for the display of the default resolution in the "File/New"
# dialog.  The unit can be one inches, millimeters, points or picas plus
# those in your user units database.
#
# (default-resolution-unit inches)

# Sets the minimal number of operations that can be undone. More undo levels
# are kept available until the undo-size limit is reached.  This is an
# integer value.
#
# (undo-levels 5)

# Sets an upper limit to the memory that is used per image to keep operations
# on the undo stack.  The integer size can contain a suffix of 'B', 'K', 'M'
# or 'G' which makes GIMP interpret the size as being specified in bytes,
# kilobytes, megabytes or gigabytes. If no suffix is specified the size
# defaults to being specified in kilobytes.
#
# (undo-size 1024k)

# Sets the pluginrc search path.  This is a single filename.
#
# (pluginrc-path "${gimp_dir}/pluginrc")

# To inhibit loading of a module, add its name here.  This is a string value.
#
# (module-load-inhibit "foo")

# Sets whether GIMP should create previews of layers and channels. Previews
# in the layers and channels dialog are nice to have but they can slow things
# down when working with large images.  Possible values are yes and no.
#
# (layer-previews yes)

# Sets the default preview size for layers and channels.  Possible values are
# tiny, extra-small, small, medium, large, extra-large, huge, enormous and
# gigantic.
#
# (layer-preview-size medium)

# Sets the size of the thumbnail saved with each image. Note that GIMP can
# not save thumbnails if layer previews are disabled.  Possible values are
# none, normal and large.
#
# (thumbnail-size normal)

# This setting is ignored.  This is a float value.
#
# (gamma-correction 1.000000)

# Install a private colormap; might be useful on pseudocolor visuals. 
# Possible values are yes and no.
#
# (install-colormap no)

# Generally only a concern for 8-bit displays, this sets the minimum number
# of system colors allocated for the GIMP.  This is an integer value.
#
# (min-colors 144)

# Speed of marching ants in the selection outline.  This value is in
# milliseconds (less time indicates faster marching).  This is an integer
# value.
#
# (marching-ants-speed 300)

# Specify that marching ants for selected regions will be drawn with colormap
# cycling as opposed to be drawn as animated lines.  This color cycling
# option works only with 8-bit displays.  Possible values are yes and no.
#
# (colormap-cycling no)

# When enabled, the image window will automatically resize itself, when
# zooming into and out of images.  Possible values are yes and no.
#
# (resize-windows-on-zoom no)

# When enabled, the image window will automatically resize itself, whenever
# the physical image size changes.  Possible values are yes and no.
#
# (resize-windows-on-resize no)

# When enabled, this will ensure that each pixel of an image gets mapped to a
# pixel on the screen.  Possible values are yes and no.
#
# (default-dot-for-dot yes)

# When enabled, this will ensure that the full image is visible after a file
# is opened, otherwise it will be displayed with a scale of 1:1.  Possible
# values are yes and no.
#
# (initial-zoom-to-fit yes)

# When enabled, the X server is queried for the mouse's current position on
# each motion event, rather than relying on the position hint.  This means
# painting with large brushes should be more accurate, but it may be slower. 
# Perversely, on some X servers enabling this option results in faster
# painting.  Possible values are yes and no.
#
# (perfect-mouse no)

# Sets the mode of cursor the GIMP will use.  Possible values are tool-icon,
# tool-crosshair and crosshair.
#
# (cursor-mode tool-icon)

# Context-dependent cursors are cool.  They are enabled by default. However,
# they require overhead that you may want to do without.  Possible values are
# yes and no.
#
# (cursor-updating yes)

# When enabled, all paint tools will show a preview of the current brush's
# outline.  Possible values are yes and no.
#
# (show-brush-outline yes)

# Sets the text to appear in image window titles.  This is a format string;
# certain % character sequences are recognised and expanded as follows:
# 
# %%  literal percent sign
# %f  bare filename, or "Untitled"
# %F  full path to file, or "Untitled"
# %p  PDB image id
# %i  view instance number
# %t  image type (RGB, grayscale, indexed)
# %z  zoom factor as a percentage
# %s  source scale factor
# %d  destination scale factor
# %Dx expands to x if the image is dirty, the empty string otherwise
# %Cx expands to x if the image is clean, the empty string otherwise
# %m  memory used by the image
# %l  the number of layers
# %L  the name of the active layer/channel
# %w  image width in pixels
# %W  image width in real-world units
# %h  image height in pixels
# %H  image height in real-world units
# %u  unit symbol
# %U  unit abbreviation
# 
#
# (image-title-format "%f-%p.%i (%t)")

# Sets the text to appear in image window status bars.  This is a format
# string; certain % character sequences are recognised and expanded as
# follows:
# 
# %%  literal percent sign
# %f  bare filename, or "Untitled"
# %F  full path to file, or "Untitled"
# %p  PDB image id
# %i  view instance number
# %t  image type (RGB, grayscale, indexed)
# %z  zoom factor as a percentage
# %s  source scale factor
# %d  destination scale factor
# %Dx expands to x if the image is dirty, the empty string otherwise
# %Cx expands to x if the image is clean, the empty string otherwise
# %m  memory used by the image
# %l  the number of layers
# %L  the name of the active layer/channel
# %w  image width in pixels
# %W  image width in real-world units
# %h  image height in pixels
# %H  image height in real-world units
# %u  unit symbol
# %U  unit abbreviation
# 
#
# (image-status-format "%f-%p.%i (%t)")

# Ask for confirmation before closing an image without saving.  Possible
# values are yes and no.
#
# (confirm-on-close yes)

# Sets the monitor's horizontal resolution, in dots per inch.  If set to 0,
# forces the X server to be queried for both horizontal and vertical
# resolution information.  This is a float value.
#
# (monitor-xresolution 72.000000)

# Sets the monitor's vertical resolution, in dots per inch.  If set to 0,
# forces the X server to be queried for both horizontal and vertical
# resolution information.  This is a float value.
#
# (monitor-yresolution 72.000000)

# When enabled, the GIMP will use the monitor resolution from the windowing
# system.  Possible values are yes and no.
#
# (monitor-resolution-from-windowing-system yes)

# Sets the size of the navigation preview available in the lower right corner
# of the image window.  Possible values are tiny, extra-small, small, medium,
# large, extra-large, huge, enormous and gigantic.
#
# (navigation-preview-size medium)

# When enabled, the menubar is visible by default. This can also be toggled
# with the "View->Show Menubar" command.  Possible values are yes and no.
#
# (show-menubar yes)

# When enabled, the rulers are visible by default. This can also be toggled
# with the "View->Show Rulers" command.  Possible values are yes and no.
#
# (show-rulers yes)

# When enabled, the scrollbars are visible by default. This can also be
# toggled with the "View->Show Scrollbars" command.  Possible values are yes
# and no.
#
# (show-scrollbars yes)

# When enabled, the statusbar is visible by default. This can also be toggled
# with the "View->Show Statusbar" command.  Possible values are yes and no.
#
# (show-statusbar yes)

# Specifies how the area around the image should be drawn.  Possible values
# are default, light-check, dark-check and custom.
#
# (canvas-padding-mode default)

# Sets the canvas padding color used if the padding mode is set to custom
# color.  The color is specified in the form (color-rgba red green blue
# alpha) with channel values as floats between 0.0 and 1.0.
#
# (canvas-padding-color (color-rgba 1.000000 1.000000 1.000000 1.000000))

# When enabled, the menubar is visible by default in fullscreen mode. This
# can also be toggled with the "View->Show Menubar" command.  Possible values
# are yes and no.
#
# (fullscreen-show-menubar no)

# When enabled, the rulers are visible by default in fullscreen mode. This
# can also be toggled with the "View->Show Rulers" command.  Possible values
# are yes and no.
#
# (fullscreen-show-rulers no)

# When enabled, the scrollbars are visible by default in fullscreen mode.
# This can also be toggled with the "View->Show Scrollbars" command. 
# Possible values are yes and no.
#
# (fullscreen-show-scrollbars no)

# When enabled, the statusbar is visible by default in fullscreen mode. This
# can also be toggled with the "View->Show Statusbar" command.  Possible
# values are yes and no.
#
# (fullscreen-show-statusbar no)

# Specifies how the area around the image should be drawn when in fullscreen
# mode.  Possible values are default, light-check, dark-check and custom.
#
# (fullscreen-canvas-padding-mode custom)

# Sets the canvas padding color used when in fullscreen mode and the padding
# mode is set to custom color.  The color is specified in the form
# (color-rgba red green blue alpha) with channel values as floats between 0.0
# and 1.0.
#
# (fullscreen-canvas-padding-color (color-rgba 0.000000 0.000000 0.000000 1.000000))

# Sets the size of the checkerboard used to display transparency.  Possible
# values are small-checks, medium-checks and large-checks.
#
# (transparency-size medium-checks)

# Sets the manner in which transparency is displayed in images.  Possible
# values are light-checks, gray-checks, dark-checks, white-only, gray-only
# and black-only.
#
# (transparency-type gray-checks)

# Tools such as fuzzy-select and bucket fill find regions based on a
# seed-fill algorithm.  The seed fill starts at the intially selected pixel
# and progresses in all directions until the difference of pixel intensity
# from the original is greater than a specified threshold. This value
# represents the default threshold.  This is an integer value.
#
# (default-threshold 15)

# When enabled, the GIMP will use a different info window per image view. 
# Possible values are yes and no.
#
# (info-window-per-display no)

# When enabled, the GIMP will not save if the image is unchanged since
# opening it.  Possible values are yes and no.
#
# (trust-dirty-flag no)

# Remember the current tool, pattern, color, and brush across GIMP sessions. 
# Possible values are yes and no.
#
# (save-device-status no)

# Save the positions and sizes of the main dialogs when the GIMP exits. 
# Possible values are yes and no.
#
# (save-session-info yes)

# Let GIMP try to restore your last saved session on each startup.  Possible
# values are yes and no.
#
# (restore-session yes)

# Enable to display a handy GIMP tip on startup.  Possible values are yes and
# no.
#
# (show-tips yes)

# Enable to display tooltips.  Possible values are yes and no.
#
# (show-tool-tips yes)

# When enabled, menus can be torn off.  Possible values are yes and no.
#
# (tearoff-menus yes)

# When enabled, you can change keyboard shortcuts for menu items on the fly. 
# Possible values are yes and no.
#
# (can-change-accels no)

# Save changed keyboard shortcuts when the GIMP exits.  Possible values are
# yes and no.
#
# (save-accels yes)

# Restore saved keyboard shortcuts on each GIMP startup.  Possible values are
# yes and no.
#
# (restore-accels yes)

# How many recently opened image filenames to keep on the File menu.  This is
# an integer value.
#
# (last-opened-size 4)

# GIMP will warn the user if an attempt is made to create an image that would
# take more memory than the size specified here.  The integer size can
# contain a suffix of 'B', 'K', 'M' or 'G' which makes GIMP interpret the
# size as being specified in bytes, kilobytes, megabytes or gigabytes. If no
# suffix is specified the size defaults to being specified in kilobytes.
#
# (max-new-image-size 32M)

# Sets the theme search path.  This is a colon-separated list of folders to
# search.
#
# (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")

# The name of the theme to use.  This is a string value.
#
# (theme "Default")

# When enabled, pressing F1 will open the help browser.  Possible values are
# yes and no.
#
# (use-help yes)

# Sets the browser used by the help system.  Possible values are gimp and
# netscape.
#
# (help-browser gimp)

# Where to search for fractals used by the Fractal Explorer plug-in.  This is
# a colon-separated list of folders to search.
#
# (fractalexplorer-path "${gimp_dir}/fractalexplorer:${gimp_data_dir}/fractalexplorer")

# Where to search for Gfig figures used by the Gfig plug-in.  This is a
# colon-separated list of folders to search.
#
# (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")

# Where to search for gflares used by the GFlare plug-in.  This is a
# colon-separated list of folders to search.
#
# (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")

# Where to search for data used by the Gimpressionist plug-in.  This is a
# colon-separated list of folders to search.
#
# (gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gimpressionist")

# This path will be searched for scripts when the Script-Fu plug-in is run. 
# This is a colon-separated list of folders to search.
#
# (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")