docs/gimprc.5.in

   1 .\" This man-page is auto-generated by gimp --dump-gimprc-manpage.
   2
   3 .TH GIMPRC 5 "Version @GIMP_VERSION@" "GIMP Manual Pages"
   4 .SH NAME
   5 gimprc \- gimp configuration file
   6 .SH DESCRIPTION
   7 The
   8 .B gimprc
   9 file is a configuration file read by GIMP when it starts up.  There
  10 are two of these: one system-wide one stored in
  11 @gimpsysconfdir@/gimprc and a per-user @manpage_gimpdir@/gimprc
  12 which may override system settings.
  13
  14 Comments are introduced by a hash sign (#), and continue until the end
  15 of the line.  Blank lines are ignored.
  16
  17 The
  18 .B gimprc
  19 file associates values with properties.  These properties may be set
  20 by lisp-like assignments of the form:
  21 .IP
  22 \f3(\f2property\-name\ value\f3)\f1
  23 .TP
  24 where:
  25 .TP 10
  26 .I property\-name
  27 is one of the property names described below.
  28 .TP
  29 .I value
  30 is the value the property is to be set to.
  31 .PP
  32
  33 Either spaces or tabs may be used to separate the name from the value.
  34 .PP
  35 .SH PROPERTIES
  36 Valid properties and their default values are:
  37
  38 .TP
  39 (temp-path "${gimp_dir}/tmp")
  40
  41 Sets the folder for temporary storage. Files will appear here during the
  42 course of running GIMP.  Most files will disappear when GIMP exits, but some
  43 files are likely to remain, so it is best if this folder not be one that is
  44 shared by other users.  This is a single folder.
  45
  46 .TP
  47 (swap-path "${gimp_dir}")
  48
  49 Sets the swap file location. GIMP uses a tile based memory allocation scheme.
  50 The swap file is used to quickly and easily swap tiles out to disk and back
  51 in. Be aware that the swap file can easily get very large if GIMP is used with
  52 large images. Also, things can get horribly slow if the swap file is created
  53 on a folder that is mounted over NFS.  For these reasons, it may be desirable
  54 to put your swap file in "/tmp".  This is a single folder.
  55
  56 .TP
  57 (num-processors 1)
  58
  59 Sets how many threads GIMP should use for operations that support it.  This is
  60 an integer value.
  61
  62 .TP
  63 (tile-cache-size 2g)
  64
  65 When the amount of pixel data exceeds this limit, GIMP will start to swap
  66 tiles to disk.  This is a lot slower but it makes it possible to work on
  67 images that wouldn't fit into memory otherwise.  If you have a lot of RAM, you
  68 may want to set this to a higher value.  The integer size can contain a suffix
  69 of 'B', 'K', 'M' or 'G' which makes GIMP interpret the size as being specified
  70 in bytes, kilobytes, megabytes or gigabytes. If no suffix is specified the
  71 size defaults to being specified in kilobytes.
  72
  73 .TP
  74 (use-opencl no)
  75
  76 When enabled, uses OpenCL for some operations.  Possible values are yes and
  77 no.
  78
  79 .TP
  80
  81 Specifies the language to use for the user interface.  This is a string value.
  82
  83 .TP
  84 (interpolation-type cubic)
  85
  86 Sets the level of interpolation used for scaling and other transformations.
  87 Possible values are none, linear, cubic, nohalo and lohalo.
  88
  89 .TP
  90 (default-threshold 15)
  91
  92 Tools such as fuzzy-select and bucket fill find regions based on a seed-fill
  93 algorithm.  The seed fill starts at the initially selected pixel and
  94 progresses in all directions until the difference of pixel intensity from the
  95 original is greater than a specified threshold. This value represents the
  96 default threshold.  This is an integer value.
  97
  98 .TP
  99 (plug-in-path "${gimp_dir}/plug-ins:${gimp_plug_in_dir}/plug-ins")
 100
 101 Sets the plug-in search path.  This is a colon-separated list of folders to
 102 search.
 103
 104 .TP
 105 (module-path "${gimp_dir}/modules:${gimp_plug_in_dir}/modules")
 106
 107 Sets the module search path.  This is a colon-separated list of folders to
 108 search.
 109
 110 .TP
 111 (interpreter-path "${gimp_dir}/interpreters:${gimp_plug_in_dir}/interpreters")
 112
 113 Sets the interpreter search path.  This is a colon-separated list of folders
 114 to search.
 115
 116 .TP
 117 (environ-path "${gimp_dir}/environ:${gimp_plug_in_dir}/environ")
 118
 119 Sets the environ search path.  This is a colon-separated list of folders to
 120 search.
 121
 122 .TP
 123 (brush-path "${gimp_dir}/brushes:${gimp_data_dir}/brushes")
 124
 125 Sets the brush search path.  This is a colon-separated list of folders to
 126 search.
 127
 128 .TP
 129 (brush-path-writable "${gimp_dir}/brushes")
 130
 131 This is a colon-separated list of folders to search.
 132
 133 .TP
 134 (dynamics-path "${gimp_dir}/dynamics:${gimp_data_dir}/dynamics")
 135
 136 Sets the dynamics search path.  This is a colon-separated list of folders to
 137 search.
 138
 139 .TP
 140 (dynamics-path-writable "${gimp_dir}/dynamics")
 141
 142 This is a colon-separated list of folders to search.
 143
 144 .TP
 145 (mypaint-brush-path "@mypaint_brushes_dir@:~/.mypaint/brushes")
 146
 147 Sets the brush search path.  This is a colon-separated list of folders to
 148 search.
 149
 150 .TP
 151 (mypaint-brush-path-writable "~/.mypaint/brushes")
 152
 153 This is a colon-separated list of folders to search.
 154
 155 .TP
 156 (pattern-path "${gimp_dir}/patterns:${gimp_data_dir}/patterns")
 157
 158 Sets the pattern search path.  This is a colon-separated list of folders to
 159 search.
 160
 161 .TP
 162 (pattern-path-writable "${gimp_dir}/patterns")
 163
 164 This is a colon-separated list of folders to search.
 165
 166 .TP
 167 (palette-path "${gimp_dir}/palettes:${gimp_data_dir}/palettes")
 168
 169 Sets the palette search path.  This is a colon-separated list of folders to
 170 search.
 171
 172 .TP
 173 (palette-path-writable "${gimp_dir}/palettes")
 174
 175 This is a colon-separated list of folders to search.
 176
 177 .TP
 178 (gradient-path "${gimp_dir}/gradients:${gimp_data_dir}/gradients")
 179
 180 Sets the gradient search path.  This is a colon-separated list of folders to
 181 search.
 182
 183 .TP
 184 (gradient-path-writable "${gimp_dir}/gradients")
 185
 186 This is a colon-separated list of folders to search.
 187
 188 .TP
 189 (tool-preset-path "${gimp_dir}/tool-presets:${gimp_data_dir}/tool-presets")
 190
 191 Sets the dynamics search path.  This is a colon-separated list of folders to
 192 search.
 193
 194 .TP
 195 (tool-preset-path-writable "${gimp_dir}/tool-presets")
 196
 197 This is a colon-separated list of folders to search.
 198
 199 .TP
 200 (font-path "${gimp_dir}/fonts:${gimp_data_dir}/fonts")
 201
 202 Where to look for fonts in addition to the system-wide installed fonts.  This
 203 is a colon-separated list of folders to search.
 204
 205 .TP
 206 (default-brush "2. Hardness 050")
 207
 208 Specify a default brush.  The brush is searched for in the specified brush
 209 path.  This is a string value.
 210
 211 .TP
 212 (default-dynamics "Dynamics Off")
 213
 214 Specify a default dynamics.  The dynamics is searched for in the specified
 215 dynamics path.  This is a string value.
 216
 217 .TP
 218 (default-mypaint-brush "Fixme")
 219
 220 Specify a default MyPaint brush.  This is a string value.
 221
 222 .TP
 223 (default-pattern "Pine")
 224
 225 Specify a default pattern.  This is a string value.
 226
 227 .TP
 228 (default-palette "Default")
 229
 230 Specify a default palette.  This is a string value.
 231
 232 .TP
 233 (default-gradient "FG to BG (RGB)")
 234
 235 Specify a default gradient.  This is a string value.
 236
 237 .TP
 238 (default-tool-preset "Current Options")
 239
 240 Specify a default tool preset.  The tool preset is searched for in the
 241 specified tool prests path.  This is a string value.
 242
 243 .TP
 244 (default-font "Sans-serif")
 245
 246 Specify a default font.  This is a string value.
 247
 248 .TP
 249 (global-brush yes)
 250
 251 When enabled, the selected brush will be used for all tools.  Possible values
 252 are yes and no.
 253
 254 .TP
 255 (global-dynamics yes)
 256
 257 When enabled, the selected dynamics will be used for all tools.  Possible
 258 values are yes and no.
 259
 260 .TP
 261 (global-pattern yes)
 262
 263 When enabled, the selected pattern will be used for all tools.  Possible
 264 values are yes and no.
 265
 266 .TP
 267 (global-palette yes)
 268
 269 When enabled, the selected palette will be used for all tools.  Possible
 270 values are yes and no.
 271
 272 .TP
 273 (global-gradient yes)
 274
 275 When enabled, the selected gradient will be used for all tools.  Possible
 276 values are yes and no.
 277
 278 .TP
 279 (global-font yes)
 280
 281 When enabled, the selected font will be used for all tools.  Possible values
 282 are yes and no.
 283
 284 .TP
 285 (default-image
 286     (width 1920)
 287     (height 1080)
 288     (unit pixels)
 289     (xresolution 300.000000)
 290     (yresolution 300.000000)
 291     (resolution-unit inches)
 292     (image-type rgb)
 293     (precision u8-gamma)
 294     (color-managed yes)
 295     (color-profile NULL)
 296     (fill-type background)
 297     (comment "Created with GIMP"))
 298
 299 Sets the default image in the "File/New" dialog.  This is a parameter list.
 300
 301 .TP
 302 (default-grid
 303     (style solid)
 304     (fgcolor (color-rgba 0.000000 0.000000 0.000000 1.000000))
 305     (bgcolor (color-rgba 1.000000 1.000000 1.000000 1.000000))
 306     (xspacing 10.000000)
 307     (yspacing 10.000000)
 308     (spacing-unit inches)
 309     (xoffset 0.000000)
 310     (yoffset 0.000000)
 311     (offset-unit inches))
 312
 313 Specify a default image grid.  This is a parameter list.
 314
 315 .TP
 316 (undo-levels 5)
 317
 318 Sets the minimal number of operations that can be undone. More undo levels are
 319 kept available until the undo-size limit is reached.  This is an integer
 320 value.
 321
 322 .TP
 323 (undo-size 1g)
 324
 325 Sets an upper limit to the memory that is used per image to keep operations on
 326 the undo stack. Regardless of this setting, at least as many undo-levels as
 327 configured can be undone.  The integer size can contain a suffix of 'B', 'K',
 328 \&'M' or 'G' which makes GIMP interpret the size as being specified in bytes,
 329 kilobytes, megabytes or gigabytes. If no suffix is specified the size defaults
 330 to being specified in kilobytes.
 331
 332 .TP
 333 (undo-preview-size large)
 334
 335 Sets the size of the previews in the Undo History.  Possible values are tiny,
 336 extra-small, small, medium, large, extra-large, huge, enormous and gigantic.
 337
 338 .TP
 339 (plug-in-history-size 10)
 340
 341 How many recently used filters and plug-ins to keep on the Filters menu.  This
 342 is an integer value.
 343
 344 .TP
 345 (pluginrc-path "${gimp_dir}/pluginrc")
 346
 347 Sets the pluginrc search path.  This is a single filename.
 348
 349 .TP
 350 (layer-previews yes)
 351
 352 Sets whether GIMP should create previews of layers and channels. Previews in
 353 the layers and channels dialog are nice to have but they can slow things down
 354 when working with large images.  Possible values are yes and no.
 355
 356 .TP
 357 (layer-preview-size medium)
 358
 359 Sets the preview size used for layers and channel previews in newly created
 360 dialogs.  Possible values are tiny, extra-small, small, medium, large,
 361 extra-large, huge, enormous and gigantic.
 362
 363 .TP
 364 (thumbnail-size normal)
 365
 366 Sets the size of the thumbnail shown in the Open dialog.  Possible values are
 367 none, normal and large.
 368
 369 .TP
 370 (thumbnail-filesize-limit 4M)
 371
 372 The thumbnail in the Open dialog will be automatically updated if the file
 373 being previewed is smaller than the size set here.  The integer size can
 374 contain a suffix of 'B', 'K', 'M' or 'G' which makes GIMP interpret the size
 375 as being specified in bytes, kilobytes, megabytes or gigabytes. If no suffix
 376 is specified the size defaults to being specified in kilobytes.
 377
 378 .TP
 379 (color-management
 380     (mode display)
 381     (display-profile-from-gdk no)
 382     (display-rendering-intent relative-colorimetric)
 383     (display-use-black-point-compensation yes)
 384     (display-optimize yes)
 385     (simulation-rendering-intent perceptual)
 386     (simulation-use-black-point-compensation no)
 387     (simulation-optimize yes)
 388     (simulation-gamut-check no)
 389     (out-of-gamut-color (color-rgb 1.000000 0.000000 1.000000))
 390     (display-module "CdisplayLcms"))
 391
 392 Defines the color management behavior.  This is a parameter list.
 393
 394 .TP
 395 (save-document-history yes)
 396
 397 Keep a permanent record of all opened and saved files in the Recent Documents
 398 list.  Possible values are yes and no.
 399
 400 .TP
 401 (quick-mask-color (color-rgba 1.000000 0.000000 0.000000 0.500000))
 402
 403 Sets the default quick mask color.  The color is specified in the form
 404 (color-rgba red green blue alpha) with channel values as floats in the range
 405 of 0.0 to 1.0.
 406
 407 .TP
 408 (import-promote-float no)
 409
 410 Promote imported images to floating point precision. Does not apply to indexed
 411 images.  Possible values are yes and no.
 412
 413 .TP
 414 (import-promote-dither yes)
 415
 416 When promoting imported images to floating point precision, also add minimal
 417 noise in order to distribute color values a bit.  Possible values are yes and
 418 no.
 419
 420 .TP
 421 (import-add-alpha no)
 422
 423 Add an alpha channel to all layers of imported images.  Possible values are
 424 yes and no.
 425
 426 .TP
 427 (import-raw-plug-in "")
 428
 429 Which plug-in to use for importing raw digital camera files.  This is a single
 430 filename.
 431
 432 .TP
 433 (export-metadata-exif yes)
 434
 435 Export Exif metadata by default.  Possible values are yes and no.
 436
 437 .TP
 438 (export-metadata-xmp yes)
 439
 440 Export XMP metadata by default.  Possible values are yes and no.
 441
 442 .TP
 443 (export-metadata-iptc yes)
 444
 445 Export IPTC metadata by default.  Possible values are yes and no.
 446
 447 .TP
 448 (debug-policy fatal)
 449
 450 Try generating debug data for bug reporting when appropriate.  Possible values
 451 are warning, critical, fatal and never.
 452
 453 .TP
 454 (transparency-size medium-checks)
 455
 456 Sets the size of the checkerboard used to display transparency.  Possible
 457 values are small-checks, medium-checks and large-checks.
 458
 459 .TP
 460 (transparency-type gray-checks)
 461
 462 Sets the manner in which transparency is displayed in images.  Possible values
 463 are light-checks, gray-checks, dark-checks, white-only, gray-only and
 464 black-only.
 465
 466 .TP
 467 (snap-distance 8)
 468
 469 This is the distance in pixels where Guide and Grid snapping activates.  This
 470 is an integer value.
 471
 472 .TP
 473 (marching-ants-speed 200)
 474
 475 Speed of marching ants in the selection outline.  This value is in
 476 milliseconds (less time indicates faster marching).  This is an integer value.
 477
 478 .TP
 479 (resize-windows-on-zoom no)
 480
 481 When enabled, the image window will automatically resize itself when zooming
 482 into and out of images. This setting only takes effect in multi-window mode.
 483 Possible values are yes and no.
 484
 485 .TP
 486 (resize-windows-on-resize no)
 487
 488 When enabled, the image window will automatically resize itself whenever the
 489 physical image size changes. This setting only takes effect in multi-window
 490 mode.  Possible values are yes and no.
 491
 492 .TP
 493 (default-dot-for-dot yes)
 494
 495 When enabled, this will ensure that each pixel of an image gets mapped to a
 496 pixel on the screen.  Possible values are yes and no.
 497
 498 .TP
 499 (initial-zoom-to-fit yes)
 500
 501 When enabled, this will ensure that the full image is visible after a file is
 502 opened, otherwise it will be displayed with a scale of 1:1.  Possible values
 503 are yes and no.
 504
 505 .TP
 506 (cursor-mode tool-crosshair)
 507
 508 Sets the type of mouse pointers to use.  Possible values are tool-icon,
 509 tool-crosshair and crosshair.
 510
 511 .TP
 512 (cursor-updating yes)
 513
 514 Context-dependent mouse pointers are helpful.  They are enabled by default.
 515 However, they require overhead that you may want to do without.  Possible
 516 values are yes and no.
 517
 518 .TP
 519 (show-brush-outline yes)
 520
 521 When enabled, all paint tools will show a preview of the current brush's
 522 outline.  Possible values are yes and no.
 523
 524 .TP
 525 (show-paint-tool-cursor yes)
 526
 527 When enabled, the mouse pointer will be shown over the image while using a
 528 paint tool.  Possible values are yes and no.
 529
 530 .TP
 531 (image-title-format "%D*%f-%p.%i (%t, %o, %L) %wx%h")
 532
 533 Sets the text to appear in image window titles.  This is a format string;
 534 certain % character sequences are recognised and expanded as follows:
 535 .br
 536
 537 .br
 538 %%  literal percent sign
 539 .br
 540 %f  bare filename, or "Untitled"
 541 .br
 542 %F  full path to file, or "Untitled"
 543 .br
 544 %p  PDB image id
 545 .br
 546 %i  view instance number
 547 .br
 548 %t  image type (RGB, grayscale, indexed)
 549 .br
 550 %z  zoom factor as a percentage
 551 .br
 552 %s  source scale factor
 553 .br
 554 %d  destination scale factor
 555 .br
 556 %Dx expands to x if the image is dirty, the empty string otherwise
 557 .br
 558 %Cx expands to x if the image is clean, the empty string otherwise
 559 .br
 560 %B  expands to (modified) if the image is dirty, the empty string otherwise
 561 .br
 562 %A  expands to (clean) if the image is clean, the empty string otherwise
 563 .br
 564 %l  the number of layers
 565 .br
 566 %L  the number of layers (long form)
 567 .br
 568 %m  memory used by the image
 569 .br
 570 %n  the name of the active layer/channel
 571 .br
 572 %P  the PDB id of the active layer/channel
 573 .br
 574 %w  image width in pixels
 575 .br
 576 %W  image width in real-world units
 577 .br
 578 %h  image height in pixels
 579 .br
 580 %H  image height in real-world units
 581 .br
 582 %M  the image size expressed in megapixels
 583 .br
 584 %u  unit symbol
 585 .br
 586 %U  unit abbreviation
 587 .br
 588 %x  the width of the active layer/channel in pixels
 589 .br
 590 %X  the width of the active layer/channel in real-world units
 591 .br
 592 %y  the height of the active layer/channel in pixels
 593 .br
 594 %Y  the height of the active layer/channel in real-world units
 595 .br
 596 %o  the name of the image's color profile
 597 .br
 598
 599 .br
 600
 601 .TP
 602 (image-status-format "%n (%m)")
 603
 604 Sets the text to appear in image window status bars.  This is a format string;
 605 certain % character sequences are recognised and expanded as follows:
 606 .br
 607
 608 .br
 609 %%  literal percent sign
 610 .br
 611 %f  bare filename, or "Untitled"
 612 .br
 613 %F  full path to file, or "Untitled"
 614 .br
 615 %p  PDB image id
 616 .br
 617 %i  view instance number
 618 .br
 619 %t  image type (RGB, grayscale, indexed)
 620 .br
 621 %z  zoom factor as a percentage
 622 .br
 623 %s  source scale factor
 624 .br
 625 %d  destination scale factor
 626 .br
 627 %Dx expands to x if the image is dirty, the empty string otherwise
 628 .br
 629 %Cx expands to x if the image is clean, the empty string otherwise
 630 .br
 631 %B  expands to (modified) if the image is dirty, the empty string otherwise
 632 .br
 633 %A  expands to (clean) if the image is clean, the empty string otherwise
 634 .br
 635 %l  the number of layers
 636 .br
 637 %L  the number of layers (long form)
 638 .br
 639 %m  memory used by the image
 640 .br
 641 %n  the name of the active layer/channel
 642 .br
 643 %P  the PDB id of the active layer/channel
 644 .br
 645 %w  image width in pixels
 646 .br
 647 %W  image width in real-world units
 648 .br
 649 %h  image height in pixels
 650 .br
 651 %H  image height in real-world units
 652 .br
 653 %M  the image size expressed in megapixels
 654 .br
 655 %u  unit symbol
 656 .br
 657 %U  unit abbreviation
 658 .br
 659 %x  the width of the active layer/channel in pixels
 660 .br
 661 %X  the width of the active layer/channel in real-world units
 662 .br
 663 %y  the height of the active layer/channel in pixels
 664 .br
 665 %Y  the height of the active layer/channel in real-world units
 666 .br
 667 %o  the name of the image's color profile
 668 .br
 669
 670 .br
 671
 672 .TP
 673 (monitor-xresolution 96.000000)
 674
 675 Sets the monitor's horizontal resolution, in dots per inch.  If set to 0,
 676 forces the X server to be queried for both horizontal and vertical resolution
 677 information.  This is a float value.
 678
 679 .TP
 680 (monitor-yresolution 96.000000)
 681
 682 Sets the monitor's vertical resolution, in dots per inch.  If set to 0, forces
 683 the X server to be queried for both horizontal and vertical resolution
 684 information.  This is a float value.
 685
 686 .TP
 687 (monitor-resolution-from-windowing-system yes)
 688
 689 When enabled, GIMP will use the monitor resolution from the windowing system.
 690 Possible values are yes and no.
 691
 692 .TP
 693 (navigation-preview-size medium)
 694
 695 Sets the size of the navigation preview available in the lower right corner of
 696 the image window.  Possible values are tiny, extra-small, small, medium,
 697 large, extra-large, huge, enormous and gigantic.
 698
 699 .TP
 700 (default-view
 701     (show-menubar yes)
 702     (show-statusbar yes)
 703     (show-rulers yes)
 704     (show-scrollbars yes)
 705     (show-selection yes)
 706     (show-layer-boundary yes)
 707     (show-guides yes)
 708     (show-grid no)
 709     (show-sample-points yes)
 710     (snap-to-guides yes)
 711     (snap-to-grid no)
 712     (snap-to-canvas no)
 713     (snap-to-path no)
 714     (padding-mode default)
 715     (padding-color (color-rgb 1.000000 1.000000 1.000000)))
 716
 717 Sets the default settings for the image view.  This is a parameter list.
 718
 719 .TP
 720 (default-fullscreen-view
 721     (show-menubar yes)
 722     (show-statusbar yes)
 723     (show-rulers yes)
 724     (show-scrollbars yes)
 725     (show-selection yes)
 726     (show-layer-boundary yes)
 727     (show-guides yes)
 728     (show-grid no)
 729     (show-sample-points yes)
 730     (snap-to-guides yes)
 731     (snap-to-grid no)
 732     (snap-to-canvas no)
 733     (snap-to-path no)
 734     (padding-mode default)
 735     (padding-color (color-rgb 1.000000 1.000000 1.000000)))
 736
 737 Sets the default settings used when an image is viewed in fullscreen mode.
 738 This is a parameter list.
 739
 740 .TP
 741 (activate-on-focus yes)
 742
 743 When enabled, an image will become the active image when its image window
 744 receives the focus. This is useful for window managers using "click to focus".
 745  Possible values are yes and no.
 746
 747 .TP
 748 (space-bar-action pan)
 749
 750 What to do when the space bar is pressed in the image window.  Possible values
 751 are none, pan and move.
 752
 753 .TP
 754 (zoom-quality high)
 755
 756 There's a tradeoff between speed and quality of the zoomed-out display.
 757 Possible values are low and high.
 758
 759 .TP
 760 (use-event-history no)
 761
 762 Bugs in event history buffer are frequent so in case of cursor offset problems
 763 turning it off helps.  Possible values are yes and no.
 764
 765 .TP
 766 (move-tool-changes-active no)
 767
 768 If enabled, the move tool sets the edited layer or path as active.  This used
 769 to be the default behaviour in older versions.  Possible values are yes and
 770 no.
 771
 772 .TP
 773 (filter-tool-max-recent 10)
 774
 775 How many recent settings to keep around in filter tools.  This is an integer
 776 value.
 777
 778 .TP
 779 (filter-tool-use-last-settings no)
 780
 781 Default to the last used settings in filter tools.  Possible values are yes
 782 and no.
 783
 784 .TP
 785 (filter-tool-show-color-options no)
 786
 787 Show advanced color options in filter tools.  Possible values are yes and no.
 788
 789 .TP
 790 (trust-dirty-flag no)
 791
 792 When enabled, GIMP will not save an image if it has not been changed since it
 793 was opened.  Possible values are yes and no.
 794
 795 .TP
 796 (save-device-status yes)
 797
 798 Remember the current tool, pattern, color, and brush across GIMP sessions.
 799 Possible values are yes and no.
 800
 801 .TP
 802 (devices-share-tool no)
 803
 804 When enabled, the same tool and tool options will be used for all input
 805 devices. No tool switching will occur when the input device changes.  Possible
 806 values are yes and no.
 807
 808 .TP
 809 (save-session-info yes)
 810
 811 Save the positions and sizes of the main dialogs when GIMP exits.  Possible
 812 values are yes and no.
 813
 814 .TP
 815 (restore-session yes)
 816
 817 Let GIMP try to restore your last saved session on each startup.  Possible
 818 values are yes and no.
 819
 820 .TP
 821 (restore-monitor no)
 822
 823 When enabled, GIMP will try to restore windows on the monitor they were open
 824 before.  When disabled, windows will appear on the currently used monitor.
 825 Possible values are yes and no.
 826
 827 .TP
 828 (save-tool-options yes)
 829
 830 Save the tool options when GIMP exits.  Possible values are yes and no.
 831
 832 .TP
 833 (show-tooltips yes)
 834
 835 Show a tooltip when the pointer hovers over an item.  Possible values are yes
 836 and no.
 837
 838 .TP
 839 (tearoff-menus yes)
 840
 841 When enabled, menus can be torn off.  Possible values are yes and no.
 842
 843 .TP
 844 (can-change-accels no)
 845
 846 When enabled, you can change keyboard shortcuts for menu items by hitting a
 847 key combination while the menu item is highlighted.  Possible values are yes
 848 and no.
 849
 850 .TP
 851 (save-accels yes)
 852
 853 Save changed keyboard shortcuts when GIMP exits.  Possible values are yes and
 854 no.
 855
 856 .TP
 857 (restore-accels yes)
 858
 859 Restore saved keyboard shortcuts on each GIMP startup.  Possible values are
 860 yes and no.
 861
 862 .TP
 863 (last-opened-size 10)
 864
 865 How many recently opened image filenames to keep on the File menu.  This is an
 866 integer value.
 867
 868 .TP
 869 (max-new-image-size 128M)
 870
 871 GIMP will warn the user if an attempt is made to create an image that would
 872 take more memory than the size specified here.  The integer size can contain a
 873 suffix of 'B', 'K', 'M' or 'G' which makes GIMP interpret the size as being
 874 specified in bytes, kilobytes, megabytes or gigabytes. If no suffix is
 875 specified the size defaults to being specified in kilobytes.
 876
 877 .TP
 878 (toolbox-color-area yes)
 879
 880 Show the current foreground and background colors in the toolbox.  Possible
 881 values are yes and no.
 882
 883 .TP
 884 (toolbox-foo-area no)
 885
 886 Show the currently selected brush, pattern and gradient in the toolbox.
 887 Possible values are yes and no.
 888
 889 .TP
 890 (toolbox-image-area no)
 891
 892 Show the currently active image in the toolbox.  Possible values are yes and
 893 no.
 894
 895 .TP
 896 (toolbox-wilber yes)
 897
 898 Show the GIMP mascot at the top of the toolbox.  Possible values are yes and
 899 no.
 900
 901 .TP
 902 (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes")
 903
 904 Sets the theme search path.  This is a colon-separated list of folders to
 905 search.
 906
 907 .TP
 908 (theme "Dark")
 909
 910 The name of the theme to use.  This is a string value.
 911
 912 .TP
 913 (icon-theme-path "${gimp_dir}/icons:${gimp_data_dir}/icons")
 914
 915 Sets the icon theme search path.  This is a colon-separated list of folders to
 916 search.
 917
 918 .TP
 919 (icon-theme "Symbolic")
 920
 921 The name of the icon theme to use.  This is a string value.
 922
 923 .TP
 924 (icon-size auto)
 925
 926 The size of the icons to use.  Possible values are auto, theme, small, medium,
 927 large and huge.
 928
 929 .TP
 930 (use-help yes)
 931
 932 When enabled, pressing F1 will open the help browser.  Possible values are yes
 933 and no.
 934
 935 .TP
 936 (show-help-button yes)
 937
 938 When enabled, dialogs will show a help button that gives access to the related
 939 help page.  Without this button, the help page can still be reached by
 940 pressing F1.  Possible values are yes and no.
 941
 942 .TP
 943 (help-locales "")
 944
 945 Specifies the language preferences used by the help system. This is a
 946 colon-separated list of language identifiers with decreasing priority. If
 947 empty, the language is taken from the user's locale setting.  This is a string
 948 value.
 949
 950 .TP
 951 (help-browser gimp)
 952
 953 Sets the browser used by the help system.  Possible values are gimp and
 954 web-browser.
 955
 956 .TP
 957 (search-show-unavailable-actions no)
 958
 959 When enabled, a search of actions will also return inactive actions.  Possible
 960 values are yes and no.
 961
 962 .TP
 963 (action-history-size 100)
 964
 965 The maximum number of actions saved in history.  This is an integer value.
 966
 967 .TP
 968 (user-manual-online no)
 969
 970 When enabled, the online user manual will be used by the help system.
 971 Otherwise the locally installed copy is used.  Possible values are yes and no.
 972
 973 .TP
 974 (user-manual-online-uri "http://docs.gimp.org/2.10")
 975
 976 The location of the online user manual. This is used if 'user-manual-online'
 977 is enabled.  This is a string value.
 978
 979 .TP
 980 (dock-window-hint utility)
 981
 982 The window type hint that is set on dock windows and the toolbox window. This
 983 may affect the way your window manager decorates and handles these windows.
 984 Possible values are normal, utility and keep-above.
 985
 986 .TP
 987 (cursor-handedness right)
 988
 989 Sets the handedness for cursor positioning.  Possible values are left and
 990 right.
 991
 992 .TP
 993 (playground-npd-tool no)
 994
 995 Enable the N-Point Deformation tool.  Possible values are yes and no.
 996
 997 .TP
 998 (playground-seamless-clone-tool no)
 999
1000 Enable the Seamless Clone tool.  Possible values are yes and no.
1001
1002 .TP
1003 (color-profile-policy ask)
1004
1005 How to handle embedded color profiles when opening a file.  Possible values
1006 are ask, keep and convert.
1007
1008 .TP
1009
1010 Sets the default folder path for all color profile file dialogs.  This is a
1011 single filename.
1012
1013 .TP
1014 (image-convert-profile-intent relative-colorimetric)
1015
1016 Sets the default rendering intent for the 'Convert to Color Profile' dialog.
1017 Possible values are perceptual, relative-colorimetric, saturation and
1018 absolute-colorimetric.
1019
1020 .TP
1021 (image-convert-profile-black-point-compensation yes)
1022
1023 Sets the default 'Black Point Compensation' state for the 'Convert to Color
1024 Profile' dialog.  Possible values are yes and no.
1025
1026 .TP
1027 (image-convert-precision-layer-dither-method none)
1028
1029 Sets the default layer dithering method for the 'Convert Precision' dialog.
1030 Possible values are none, floyd-steinberg, bayer, random, random-covariant,
1031 add, add-covariant, xor and xor-covariant.
1032
1033 .TP
1034 (image-convert-precision-text-layer-dither-method none)
1035
1036 Sets the default text layer dithering method for the 'Convert Precision'
1037 dialog.  Possible values are none, floyd-steinberg, bayer, random,
1038 random-covariant, add, add-covariant, xor and xor-covariant.
1039
1040 .TP
1041 (image-convert-precision-channel-dither-method none)
1042
1043 Sets the default channel dithering method for the 'Convert Precision' dialog.
1044 Possible values are none, floyd-steinberg, bayer, random, random-covariant,
1045 add, add-covariant, xor and xor-covariant.
1046
1047 .TP
1048 (image-convert-indexed-palette-type generate)
1049
1050 Sets the default palette type for the 'Convert to Indexed' dialog.  Possible
1051 values are generate, web, mono and custom.
1052
1053 .TP
1054 (image-convert-indexed-max-colors 256)
1055
1056 Sets the default maximum number of colors for the 'Convert to Indexed' dialog.
1057  This is an integer value.
1058
1059 .TP
1060 (image-convert-indexed-remove-duplicates yes)
1061
1062 Sets the default 'Remove duplicate colors' state for the 'Convert to Indexed'
1063 dialog.  Possible values are yes and no.
1064
1065 .TP
1066 (image-convert-indexed-dither-type none)
1067
1068 Sets the default dithering type for the 'Convert to Indexed' dialog.  Possible
1069 values are none, fs, fs-lowbleed and fixed.
1070
1071 .TP
1072 (image-convert-indexed-dither-alpha no)
1073
1074 Sets the default 'Dither alpha' state for the 'Convert to Indexed' dialog.
1075 Possible values are yes and no.
1076
1077 .TP
1078 (image-convert-indexed-dither-text-layers no)
1079
1080 Sets the default 'Dither text layers' state for the 'Convert to Indexed'
1081 dialog.  Possible values are yes and no.
1082
1083 .TP
1084 (image-resize-fill-type transparent)
1085
1086 Sets the default fill type for the 'Canvas Size' dialog.  Possible values are
1087 foreground, background, white, transparent and pattern.
1088
1089 .TP
1090 (image-resize-layer-set none)
1091
1092 Sets the default set of layers to resize for the 'Canvas Size' dialog.
1093 Possible values are none, all, image-sized, visible and linked.
1094
1095 .TP
1096 (image-resize-resize-text-layers no)
1097
1098 Sets the default 'Resize text layers' state for the 'Canvas Size' dialog.
1099 Possible values are yes and no.
1100
1101 .TP
1102 (layer-new-name "Layer")
1103
1104 Sets the default layer name for the 'New Layer' dialog.  This is a string
1105 value.
1106
1107 .TP
1108 (layer-new-mode normal)
1109
1110 Sets the default mode for the 'New Layer' dialog.  Possible values are
1111 normal-legacy, dissolve, behind-legacy, multiply-legacy, screen-legacy,
1112 overlay-legacy, difference-legacy, addition-legacy, subtract-legacy,
1113 darken-only-legacy, lighten-only-legacy, hsv-hue-legacy,
1114 hsv-saturation-legacy, hsl-color-legacy, hsv-value-legacy, divide-legacy,
1115 dodge-legacy, burn-legacy, hardlight-legacy, softlight-legacy,
1116 grain-extract-legacy, grain-merge-legacy, color-erase-legacy, overlay,
1117 lch-hue, lch-chroma, lch-color, lch-lightness, normal, behind, multiply,
1118 screen, difference, addition, subtract, darken-only, lighten-only, hsv-hue,
1119 hsv-saturation, hsl-color, hsv-value, divide, dodge, burn, hardlight,
1120 softlight, grain-extract, grain-merge, vivid-light, pin-light, linear-light,
1121 hard-mix, exclusion, linear-burn, luma-darken-only, luma-lighten-only,
1122 luminance, color-erase, erase, merge, split, pass-through, replace and
1123 anti-erase.
1124
1125 .TP
1126 (layer-new-blend-space auto)
1127
1128 Sets the default blend space for the 'New Layer' dialog.  Possible values are
1129 auto, rgb-linear, rgb-perceptual and lab.
1130
1131 .TP
1132 (layer-new-composite-space auto)
1133
1134 Sets the default composite space for the 'New Layer' dialog.  Possible values
1135 are auto, rgb-linear, rgb-perceptual and lab.
1136
1137 .TP
1138 (layer-new-composite-mode auto)
1139
1140 Sets the default composite mode for the 'New Layer' dialog.  Possible values
1141 are auto, union, clip-to-backdrop, clip-to-layer and intersection.
1142
1143 .TP
1144 (layer-new-opacity 1.000000)
1145
1146 Sets the default opacity for the 'New Layer' dialog.  This is a float value.
1147
1148 .TP
1149 (layer-new-fill-type transparent)
1150
1151 Sets the default fill type for the 'New Layer' dialog.  Possible values are
1152 foreground, background, white, transparent and pattern.
1153
1154 .TP
1155 (layer-resize-fill-type transparent)
1156
1157 Sets the default fill type for the 'Layer Boundary Size' dialog.  Possible
1158 values are foreground, background, white, transparent and pattern.
1159
1160 .TP
1161 (layer-add-mask-type white)
1162
1163 Sets the default mask for the 'Add Layer Mask' dialog.  Possible values are
1164 white, black, alpha, alpha-transfer, selection, copy and channel.
1165
1166 .TP
1167 (layer-add-mask-invert no)
1168
1169 Sets the default 'invert mask' state for the 'Add Layer Mask' dialog.
1170 Possible values are yes and no.
1171
1172 .TP
1173 (layer-merge-type expand-as-necessary)
1174
1175 Sets the default merge type for the 'Merge Visible Layers' dialog.  Possible
1176 values are expand-as-necessary, clip-to-image, clip-to-bottom-layer and
1177 flatten-image.
1178
1179 .TP
1180 (layer-merge-active-group-only yes)
1181
1182 Sets the default 'Active group only' for the 'Merge Visible Layers' dialog.
1183 Possible values are yes and no.
1184
1185 .TP
1186 (layer-merge-discard-invisible no)
1187
1188 Sets the default 'Discard invisible' for the 'Merge Visible Layers' dialog.
1189 Possible values are yes and no.
1190
1191 .TP
1192 (channel-new-name "Channel")
1193
1194 Sets the default channel name for the 'New Channel' dialog.  This is a string
1195 value.
1196
1197 .TP
1198 (channel-new-color (color-rgba 0.000000 0.000000 0.000000 0.500000))
1199
1200 Sets the default color and opacity for the 'New Channel' dialog.  The color is
1201 specified in the form (color-rgba red green blue alpha) with channel values as
1202 floats in the range of 0.0 to 1.0.
1203
1204 .TP
1205 (path-new-name "Path")
1206
1207 Sets the default path name for the 'New Path' dialog.  This is a string value.
1208
1209 .TP
1210
1211 Sets the default folder path for the 'Export Path' dialog.  This is a single
1212 filename.
1213
1214 .TP
1215 (path-export-active-only yes)
1216
1217 Sets the default 'Export the active path' state for the 'Export Path' dialog.
1218 Possible values are yes and no.
1219
1220 .TP
1221
1222 Sets the default folder path for the 'Import Path' dialog.  This is a single
1223 filename.
1224
1225 .TP
1226 (path-import-merge no)
1227
1228 Sets the default 'Merge imported paths' state for the 'Import Path' dialog.
1229 Possible values are yes and no.
1230
1231 .TP
1232 (path-import-scale no)
1233
1234 Sets the default 'Scale imported paths to fit size' state for the 'Import
1235 Path' dialog.  Possible values are yes and no.
1236
1237 .TP
1238 (selection-feather-radius 5.000000)
1239
1240 Sets the default feather radius for the 'Feather Selection' dialog.  This is a
1241 float value.
1242
1243 .TP
1244 (selection-grow-radius 1.000000)
1245
1246 Sets the default grow radius for the 'Grow Selection' dialog.  This is a float
1247 value.
1248
1249 .TP
1250 (selection-shrink-radius 1.000000)
1251
1252 Sets the default shrink radius for the 'Shrink Selection' dialog.  This is a
1253 float value.
1254
1255 .TP
1256 (selection-shrink-edge-lock no)
1257
1258 Sets the default 'Selected areas continue outside the image' setting for the
1259 \&'Shrink Selection' dialog.  Possible values are yes and no.
1260
1261 .TP
1262 (selection-border-radius 5.000000)
1263
1264 Sets the default border radius for the 'Border Selection' dialog.  This is a
1265 float value.
1266
1267 .TP
1268 (selection-border-style smooth)
1269
1270 Sets the default border style for the 'Border Selection' dialog.  Possible
1271 values are hard, smooth and feathered.
1272
1273 .TP
1274 (selection-border-edge-lock no)
1275
1276 Sets the default 'Selected areas continue outside the image' setting for the
1277 \&'Border Selection' dialog.  Possible values are yes and no.
1278
1279 .TP
1280 (fill-options
1281     (style solid)
1282     (antialias yes))
1283
1284 The default fill options for the fill dialogs.  This is a parameter list.
1285
1286 .TP
1287 (stroke-options
1288     (style solid)
1289     (antialias yes)
1290     (method line)
1291     (width 6.000000)
1292     (unit pixels)
1293     (cap-style butt)
1294     (join-style miter)
1295     (miter-limit 10.000000)
1296     (dash-offset 0.000000)
1297     (dash-info 0)
1298     (emulate-brush-dynamics no))
1299
1300 The default stroke options for the stroke dialogs.  This is a parameter list.
1301
1302 .TP
1303 (fractalexplorer-path "${gimp_dir}/fractalexplorer:${gimp_data_dir}/fractalexplorer")
1304
1305 Where to search for fractals used by the Fractal Explorer plug-in.  This is a
1306 colon-separated list of folders to search.
1307
1308 .TP
1309 (gfig-path "${gimp_dir}/gfig:${gimp_data_dir}/gfig")
1310
1311 Where to search for Gfig figures used by the Gfig plug-in.  This is a
1312 colon-separated list of folders to search.
1313
1314 .TP
1315 (gflare-path "${gimp_dir}/gflare:${gimp_data_dir}/gflare")
1316
1317 Where to search for gflares used by the GFlare plug-in.  This is a
1318 colon-separated list of folders to search.
1319
1320 .TP
1321 (gimpressionist-path "${gimp_dir}/gimpressionist:${gimp_data_dir}/gimpressionist")
1322
1323 Where to search for data used by the Gimpressionist plug-in.  This is a
1324 colon-separated list of folders to search.
1325
1326 .TP
1327 (script-fu-path "${gimp_dir}/scripts:${gimp_data_dir}/scripts")
1328
1329 This path will be searched for scripts when the Script-Fu plug-in is run.
1330 This is a colon-separated list of folders to search.
1331
1332 .PP
1333 .SH PATH EXPANSION
1334 Strings of type PATH are expanded in a manner similar to
1335 .BR bash (1).
1336 Specifically: tilde (~) is expanded to the user's home directory. Note that
1337 the bash feature of being able to refer to other user's home directories
1338 by writing ~userid/ is not valid in this file.
1339
1340 ${variable} is expanded to the current value of an environment variable.
1341 There are a few variables that are pre-defined:
1342 .TP
1343 .I gimp_dir
1344 The personal gimp directory which is set to the value of the environment
1345 variable GIMP3_DIRECTORY or to @manpage_gimpdir@.
1346 .TP
1347 .I gimp_data_dir
1348 Base for paths to shareable data, which is set to the value of the
1349 environment variable GIMP3_DATADIR or to the compiled-in default value
1350 @gimpdatadir@.
1351 .TP
1352 .I gimp_plug_in_dir
1353 Base to paths for architecture-specific plug-ins and modules, which is set
1354 to the value of the environment variable GIMP3_PLUGINDIR or to the
1355 compiled-in default value @gimpplugindir@.
1356 .TP
1357 .I gimp_sysconf_dir
1358 Path to configuration files, which is set to the value of the environment
1359 variable GIMP3_SYSCONFDIR or to the compiled-in default value
1360 @gimpsysconfdir@.
1361
1362 .SH FILES
1363 .TP
1364 .I @gimpsysconfdir@/gimprc
1365 System-wide configuration file
1366 .TP
1367 .I @manpage_gimpdir@/gimprc
1368 Per-user configuration file
1369
1370 .SH "SEE ALSO"
1371 .BR gimp (1)