bionic (5) gimprc-2.8.5.gz

Provided by: gimp-data_2.8.22-1_all bug

NAME

       gimprc - gimp configuration file

DESCRIPTION

       The  gimprc  file  is  a  configuration file read by GIMP when it starts up.  There are two of these: one
       system-wide one stored in /etc/gimp/2.0/gimprc and a per-user $HOME/.gimp-2.8/gimprc which  may  override
       system settings.

       Comments  are  introduced  by  a  hash sign (#), and continue until the end of the line.  Blank lines are
       ignored.

       The gimprc file associates values with properties.  These properties may be set by lisp-like  assignments
       of the form:

              (property-name value)

       where:

       property-name
                 is one of the property names described below.

       value     is the value the property is to be set to.

       Either spaces or tabs may be used to separate the name from the value.

PROPERTIES

       Valid properties and their default values are:

       (temp-path "${gimp_dir}/tmp")

              Sets  the  folder for temporary storage. Files will appear here during the course of running GIMP.
              Most files will disappear when GIMP exits, but some files are likely to remain, so it is  best  if
              this folder not be one that is shared by other users.  This is a single folder.

       (swap-path "${gimp_dir}")

              Sets  the  swap  file location. 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 GIMP is used with large images. Also, things can get horribly slow if the
              swap file is created on a folder that is mounted over NFS.  For these reasons, it may be desirable
              to put your swap file in "/tmp".  This is a single folder.

       (num-processors 1)

              Sets how many processors GIMP should try to use simultaneously.  This is an integer value.

       (tile-cache-size 1421926k)

              When  the amount of pixel data exceeds this limit, GIMP will start to swap tiles to disk.  This is
              a lot slower but it makes it possible to work on images that wouldn't fit into  memory  otherwise.
              If  you  have  a  lot  of  RAM,  you may want to set this to a higher value.  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.

       Specifies the language to use for the user interface.  This is a string value.

       (interpolation-type cubic)

              Sets the level of interpolation used for scaling and other transformations.  Possible  values  are
              none, linear, cubic and lanczos.

       (default-threshold 15)

              Tools  such as fuzzy-select and bucket fill find regions based on a seed-fill algorithm.  The seed
              fill starts at the initially 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.

       (plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")

              Sets the plug-in search path.  This is a colon-separated list of folders to search.

       (module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")

              Sets the module search path.  This is a colon-separated list of folders to search.

       (interpreter-path "${gimp_dir}/interpreters:${gimp_plug_in_dir}/interpreters")

              Sets the interpreter search path.  This is a colon-separated list of folders to search.

       (environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")

              Sets the environ search path.  This is a colon-separated list of folders to search.

       (brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")

              Sets the brush search path.  This is a colon-separated list of folders to search.

       (brush-path-writable "${gimp_dir}/brushes")

              This is a colon-separated list of folders to search.

       (dynamics-path "${gimp_dir}/dynamics:${gimp_data_dir}/dynamics")

              Sets the dynamics search path.  This is a colon-separated list of folders to search.

       (dynamics-path-writable "${gimp_dir}/dynamics")

              This is a colon-separated list of folders to search.

       (pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")

              Sets the pattern search path.  This is a colon-separated list of folders to search.

       (pattern-path-writable "${gimp_dir}/patterns")

              This is a colon-separated list of folders to search.

       (palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")

              Sets the palette search path.  This is a colon-separated list of folders to search.

       (palette-path-writable "${gimp_dir}/palettes")

              This is a colon-separated list of folders to search.

       (gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")

              Sets the gradient search path.  This is a colon-separated list of folders to search.

       (gradient-path-writable "${gimp_dir}/gradients")

              This is a colon-separated list of folders to search.

       (tool-preset-path "${gimp_dir}/tool-presets:${gimp_data_dir}/tool-presets")

              Sets the dynamics search path.  This is a colon-separated list of folders to search.

       (tool-preset-path-writable "${gimp_dir}/tool-presets")

              This is a colon-separated list of folders to search.

       (font-path "${gimp_dir}/fonts:${gimp_data_dir}/fonts")

              Where to look for fonts in addition to the system-wide installed fonts.  This is a colon-separated
              list of folders to search.

       (default-brush "Round Fuzzy")

              Specify a default brush.  The brush is searched for in the specified brush path.  This is a string
              value.

       (default-dynamics "Dynamics Off")

              Specify a default dynamics.  The dynamics is searched for in the specified dynamics path.  This is
              a string value.

       (default-pattern "Pine")

              Specify a default pattern.  This is a string value.

       (default-palette "Default")

              Specify a default palette.  This is a string value.

       (default-gradient "FG to BG (RGB)")

              Specify a default gradient.  This is a string value.

       (default-tool-preset "Current Options")

              Specify a default tool preset.  The tool preset is searched for in the specified tool prests path.
              This is a string value.

       (default-font "Sans")

              Specify a default font.  This is a string value.

       (global-brush yes)

              When enabled, the selected brush will be used for all tools.  Possible values are yes and no.

       (global-dynamics yes)

              When enabled, the selected dynamics will be used for all tools.  Possible values are yes and no.

       (global-pattern yes)

              When enabled, the selected pattern will be used for all tools.  Possible values are yes and no.

       (global-palette yes)

              When enabled, the selected palette will be used for all tools.  Possible values are yes and no.

       (global-gradient yes)

              When enabled, the selected gradient will be used for all tools.  Possible values are yes and no.

       (global-font yes)

              When enabled, the selected font will be used for all tools.  Possible values are yes and no.

       (default-image
                  (width 640)
                  (height 400)
                  (unit pixels)
                  (xresolution 72.000000)
                  (yresolution 72.000000)
                  (resolution-unit inches)
                  (image-type rgb)
                  (fill-type background-fill)
                  (comment "Created with GIMP"))

              Sets the default image in the "File/New" dialog.  This is a parameter list.

       (default-grid
                  (style solid)
                  (fgcolor (color-rgba 0.000000 0.000000 0.000000 1.000000))
                  (bgcolor (color-rgba 1.000000 1.000000 1.000000 1.000000))
                  (xspacing 10.000000)
                  (yspacing 10.000000)
                  (spacing-unit inches)
                  (xoffset 0.000000)
                  (yoffset 0.000000)
                  (offset-unit inches))

              Specify a default image grid.  This is a parameter list.

       (undo-levels 5)

              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-size 64M)

              Sets  an  upper  limit  to the memory that is used per image to keep operations on the undo stack.
              Regardless of this setting, at least as many undo-levels as configured can be undone.  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-preview-size large)

              Sets  the size of the previews in the Undo History.  Possible values are tiny, extra-small, small,
              medium, large, extra-large, huge, enormous and gigantic.

       (plug-in-history-size 10)

              How many recently used plug-ins to keep on the Filters menu.  This is an integer value.

       (pluginrc-path "${gimp_dir}/pluginrc")

              Sets the pluginrc search path.  This is a single filename.

       (layer-previews yes)

              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-preview-size medium)

              Sets the preview size used for layers and channel previews in  newly  created  dialogs.   Possible
              values are tiny, extra-small, small, medium, large, extra-large, huge, enormous and gigantic.

       (thumbnail-size normal)

              Sets  the  size  of  the thumbnail shown in the Open dialog.  Possible values are none, normal and
              large.

       (thumbnail-filesize-limit 4M)

              The thumbnail in the Open dialog will be automatically updated if  the  file  being  previewed  is
              smaller  than  the  size  set 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.

       (color-management
                  (mode display)
                  (display-profile-from-gdk no)
                  (display-rendering-intent perceptual)
                  (simulation-rendering-intent perceptual)
                  (simulation-gamut-check no)
                  (out-of-gamut-color (color-rgb 0.501961 0.501961 0.501961))
                  (display-module "CdisplayLcms"))

              Defines the color management behavior.  This is a parameter list.

       (color-profile-policy ask)

              How  to  handle  embedded  color  profiles when opening a file.  Possible values are ask, keep and
              convert.

       (save-document-history yes)

              Keep a permanent record of all opened and saved files in  the  Recent  Documents  list.   Possible
              values are yes and no.

       (quick-mask-color (color-rgba 1.000000 0.000000 0.000000 0.500000))

              Sets  the default quick mask color.  The color is specified in the form (color-rgba red green blue
              alpha) with channel values as floats in the range of 0.0 to 1.0.

       (transparency-size medium-checks)

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

       (transparency-type gray-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.

       (snap-distance 8)

              This is the distance in pixels where Guide and Grid snapping activates.  This is an integer value.

       (marching-ants-speed 200)

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

       (resize-windows-on-zoom 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-resize no)

              When enabled, the image window will automatically resize itself whenever the physical  image  size
              changes.  Possible values are yes and no.

       (default-dot-for-dot yes)

              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.

       (initial-zoom-to-fit 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.

       (perfect-mouse 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.  Conversely, on some X servers enabling this option results in
              faster painting.  Possible values are yes and no.

       (cursor-mode tool-icon)

              Sets the type of mouse pointers  to  use.   Possible  values  are  tool-icon,  tool-crosshair  and
              crosshair.

       (cursor-updating yes)

              Context-dependent mouse pointers are helpful.  They are enabled by default.  However, they require
              overhead that you may want to do without.  Possible values are yes and no.

       (show-brush-outline yes)

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

       (show-paint-tool-cursor yes)

              When  enabled,  the mouse pointer will be shown over the image while using a paint tool.  Possible
              values are yes and no.

       (image-title-format "%D*%f-%p.%i (%t, %L) %wx%h")

              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
              %B  expands to (modified) if the image is dirty, the empty string otherwise
              %A  expands to (clean) if the image is clean, the empty string otherwise
              %l  the number of layers
              %L  the number of layers (long form)
              %m  memory used by the image
              %n  the name of the active layer/channel
              %P  the PDB id 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
              %M  the image size expressed in megapixels
              %u  unit symbol
              %U  unit abbreviation

       (image-status-format "%n (%m)")

              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
              %B  expands to (modified) if the image is dirty, the empty string otherwise
              %A  expands to (clean) if the image is clean, the empty string otherwise
              %l  the number of layers
              %L  the number of layers (long form)
              %m  memory used by the image
              %n  the name of the active layer/channel
              %P  the PDB id 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
              %M  the image size expressed in megapixels
              %u  unit symbol
              %U  unit abbreviation

       (monitor-xresolution 96.000000)

              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-yresolution 96.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-resolution-from-windowing-system yes)

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

       (navigation-preview-size medium)

              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.

       (default-view
                  (show-menubar yes)
                  (show-statusbar yes)
                  (show-rulers yes)
                  (show-scrollbars yes)
                  (show-selection yes)
                  (show-layer-boundary yes)
                  (show-guides yes)
                  (show-grid no)
                  (show-sample-points yes)
                  (padding-mode default)
                  (padding-color (color-rgb 1.000000 1.000000 1.000000)))

              Sets the default settings for the image view.  This is a parameter list.

       (default-fullscreen-view
                  (show-menubar yes)
                  (show-statusbar yes)
                  (show-rulers yes)
                  (show-scrollbars yes)
                  (show-selection yes)
                  (show-layer-boundary yes)
                  (show-guides yes)
                  (show-grid no)
                  (show-sample-points yes)
                  (padding-mode default)
                  (padding-color (color-rgb 1.000000 1.000000 1.000000)))

              Sets  the  default  settings used when an image is viewed in fullscreen mode.  This is a parameter
              list.

       (default-snap-to-guides yes)

              Snap to guides by default in new image windows.  Possible values are yes and no.

       (default-snap-to-grid no)

              Snap to the grid by default in new image windows.  Possible values are yes and no.

       (default-snap-to-canvas no)

              Snap to the canvas edge by default in new image windows.  Possible values are yes and no.

       (default-snap-to-path no)

              Snap to the active path by default in new image windows.  Possible values are yes and no.

       (activate-on-focus yes)

              When enabled, an image will become the active image when its image window receives the focus. This
              is useful for window managers using "click to focus".
               Possible values are yes and no.

       (space-bar-action pan)

              What  to  do when the space bar is pressed in the image window.  Possible values are none, pan and
              move.

       (zoom-quality high)

              There's a tradeoff between speed and quality of the zoomed-out display.  Possible values  are  low
              and high.

       (use-event-history no)

              Bugs  in  event  history  buffer  are frequent so in case of cursor offset problems turning it off
              helps.  Possible values are yes and no.

       (move-tool-changes-active no)

              If enabled, the move tool sets the edited layer or path as active.  This used to  be  the  default
              behaviour in older versions.  Possible values are yes and no.

       (image-map-tool-max-recent 10)

              How many recent settings to keep around in color correction tools  This is an integer value.

       (trust-dirty-flag no)

              When  enabled,  GIMP  will  not  save  an  image  if  it has not been changed since it was opened.
              Possible values are yes and no.

       (save-device-status no)

              Remember the current tool, pattern, color, and brush across GIMP sessions.   Possible  values  are
              yes and no.

       (save-session-info yes)

              Save the positions and sizes of the main dialogs when GIMP exits.  Possible values are yes and no.

       (restore-session yes)

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

       (save-tool-options no)

              Save the tool options when GIMP exits.  Possible values are yes and no.

       (show-tooltips yes)

              Show a tooltip when the pointer hovers over an item.  Possible values are yes and no.

       (tearoff-menus yes)

              When enabled, menus can be torn off.  Possible values are yes and no.

       (can-change-accels no)

              When  enabled, you can change keyboard shortcuts for menu items by hitting a key combination while
              the menu item is highlighted.  Possible values are yes and no.

       (save-accels yes)

              Save changed keyboard shortcuts when GIMP exits.  Possible values are yes and no.

       (restore-accels yes)

              Restore saved keyboard shortcuts on each GIMP startup.  Possible values are yes and no.

       (last-opened-size 10)

              How many recently opened image filenames to keep on the File menu.  This is an integer value.

       (max-new-image-size 128M)

              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.

       (toolbox-color-area yes)

              Show the current foreground and background colors in the toolbox.  Possible values are yes and no.

       (toolbox-foo-area no)

              Show  the  currently selected brush, pattern and gradient in the toolbox.  Possible values are yes
              and no.

       (toolbox-image-area no)

              Show the currently active image in the toolbox.  Possible values are yes and no.

       (toolbox-wilber yes)

              Show the GIMP mascot at the top of the toolbox.  Possible values are yes and no.

       (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")

              Sets the theme search path.  This is a colon-separated list of folders to search.

       (theme "Default")

              The name of the theme to use.  This is a string value.

       (use-help yes)

              When enabled, pressing F1 will open the help browser.  Possible values are yes and no.

       (show-help-button yes)

              When enabled, dialogs will show a help button that gives access to the related help page.  Without
              this button, the help page can still be reached by pressing F1.  Possible values are yes and no.

       (help-locales "")

              Specifies  the  language  preferences  used  by the help system. This is a colon-separated list of
              language identifiers with decreasing priority. If empty, the language is  taken  from  the  user's
              locale setting.  This is a string value.

       (help-browser gimp)

              Sets the browser used by the help system.  Possible values are gimp and web-browser.

       (user-manual-online no)

              When  enabled,  the  online  user  manual  will be used by the help system.  Otherwise the locally
              installed copy is used.  Possible values are yes and no.

       (user-manual-online-uri "http://docs.gimp.org/2.8")

              The location of the online user manual. This is used if 'user-manual-online' is enabled.  This  is
              a string value.

       (dock-window-hint utility)

              The  window  type hint that is set on dock windows and the toolbox window. This may affect the way
              your window manager decorates and handles these windows.  Possible values are normal, utility  and
              keep-above.

       (cursor-format pixbuf)

              Sets the pixel format to use for mouse pointers.  Possible values are bitmap and pixbuf.

       (cursor-handedness right)

              Sets the handedness for cursor positioning.  Possible values are left and right.

       (fractalexplorer-path "${gimp_dir}/fractalexplorer:${gimp_data_dir}/fractalexplorer")

              Where to search for fractals used by the Fractal Explorer 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 Gfig figures used by the Gfig 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 gflares used by the GFlare plug-in.  This is a colon-separated list of folders
              to search.

       (gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gimpressionist")

              Where to search for data used by the Gimpressionist plug-in.  This is a  colon-separated  list  of
              folders to search.

       (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")

              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.

PATH EXPANSION

       Strings of type PATH are expanded in a manner similar to bash(1).  Specifically: tilde (~) is expanded to
       the  user's  home  directory.  Note  that  the  bash  feature of being able to refer to other user's home
       directories by writing ~userid/ is not valid in this file.

       ${variable} is expanded to the current value of an environment variable.  There are a few variables  that
       are pre-defined:

       gimp_dir
              The  personal gimp directory which is set to the value of the environment variable GIMP2_DIRECTORY
              or to ~/.gimp-2.8.

       gimp_data_dir
              Base for paths to shareable  data,  which  is  set  to  the  value  of  the  environment  variable
              GIMP2_DATADIR or to the compiled-in default value ${datarootdir}/gimp/2.0.

       gimp_plug_in_dir
              Base  to  paths  for  architecture-specific  plugins and modules, which is set to the value of the
              environment variable GIMP2_PLUGINDIR or to the compiled-in default value /usr/lib/gimp/2.0.

       gimp_sysconf_dir
              Path  to  configuration  files,  which  is  set  to  the  value  of   the   environment   variable
              GIMP2_SYSCONFDIR or to the compiled-in default value /etc/gimp/2.0.

FILES

       /etc/gimp/2.0/gimprc
              System-wide configuration file

       $HOME/.gimp-2.8/gimprc
              Per-user configuration file

SEE ALSO

       gimp(1)