diff --git a/docs/gimprc.5.in b/docs/gimprc.5.in index d8ca1797d3..d7985c2b17 100644 --- a/docs/gimprc.5.in +++ b/docs/gimprc.5.in @@ -36,7 +36,7 @@ Either spaces or tabs may be used to separate the name from the value. Valid properties and their default values are: .TP -(temp-path "${gimp_dir}/tmp") +(temp-path "${gimp_temp_dir}") 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 @@ -44,7 +44,7 @@ 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. .TP -(swap-path "${gimp_dir}") +(swap-path "${gimp_cache_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 @@ -53,6 +53,12 @@ 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. +.TP +(swap-compression "fast") + +The compression method used for tile data stored in the swap file. This is a +string value. + .TP (num-processors 1) @@ -286,8 +292,8 @@ are yes and no. (width 2001) (height 1984) (unit pixels) - (xresolution 300.000000) - (yresolution 300.000000) + (xresolution 300) + (yresolution 300) (resolution-unit inches) (image-type rgb) (precision u8-non-linear) @@ -300,13 +306,13 @@ Sets the default image in the "File/New" dialog. This is a parameter list. .TP (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) + (fgcolor (color-rgba 0 0 0 1)) + (bgcolor (color-rgba 1 1 1 1)) + (xspacing 10) + (yspacing 10) (spacing-unit inches) - (xoffset 0.000000) - (yoffset 0.000000) + (xoffset 0) + (yoffset 0) (offset-unit inches)) Specify a default image grid. This is a parameter list. @@ -392,7 +398,7 @@ is specified the size defaults to being specified in kilobytes. (simulation-use-black-point-compensation no) (simulation-optimize yes) (simulation-gamut-check no) - (out-of-gamut-color (color-rgb 1.000000 0.000000 1.000000))) + (out-of-gamut-color (color-rgb 1 0 1))) Defines the color management behavior. This is a parameter list. @@ -403,7 +409,7 @@ Keep a permanent record of all opened and saved files in the Recent Documents list. Possible values are yes and no. .TP -(quick-mask-color (color-rgba 1.000000 0.000000 0.000000 0.500000)) +(quick-mask-color (color-rgba 1 0 0 0.5)) 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 @@ -434,11 +440,22 @@ yes and no. Which plug-in to use for importing raw digital camera files. This is a single filename. +.TP +(export-file-type png) + +Export file type used by default. Possible values are png, jpg, ora, psd, +pdf, tif, bmp and webp. + .TP (export-color-profile yes) Export the image's color profile by default. Possible values are yes and no. +.TP +(export-comment yes) + +Export the image's comment by default. Possible values are yes and no. + .TP (export-metadata-exif yes) @@ -460,6 +477,37 @@ Export IPTC metadata by default. Possible values are yes and no. Try generating debug data for bug reporting when appropriate. Possible values are warning, critical, fatal and never. +.TP +(check-updates yes) + +Check for availability of GIMP updates through background internet queries. +Possible values are yes and no. + +.TP +(check-update-timestamp 0) + +Timestamp of the last update check. (null) + +.TP +(last-release-timestamp 0) + +The timestamp for the last known release date. (null) + +.TP + +The last known release version of GIMP as queried from official website. This +is a string value. + +.TP +(last-revision 0) + +The timestamp for the last known release date. This is an integer value. + +.TP + +The last known release version of GIMP as queried from official website. This +is a string value. + .TP (transparency-size medium-checks) @@ -499,6 +547,11 @@ When enabled, the image window will automatically resize itself whenever the physical image size changes. This setting only takes effect in multi-window mode. Possible values are yes and no. +.TP +(default-show-all no) + +Show full image content by default. Possible values are yes and no. + .TP (default-dot-for-dot yes) @@ -531,6 +584,12 @@ values are yes and no. When enabled, all paint tools will show a preview of the current brush's outline. Possible values are yes and no. +.TP +(snap-brush-outline no) + +When enabled, the brush outline will snap to individual dabs while painting. +Possible values are yes and no. + .TP (show-paint-tool-cursor yes) @@ -688,14 +747,14 @@ certain % character sequences are recognised and expanded as follows: .br .TP -(monitor-xresolution 96.000000) +(monitor-xresolution 96) 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. .TP -(monitor-yresolution 96.000000) +(monitor-yresolution 96) 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 @@ -722,6 +781,7 @@ large, extra-large, huge, enormous and gigantic. (show-scrollbars yes) (show-selection yes) (show-layer-boundary yes) + (show-canvas-boundary yes) (show-guides yes) (show-grid no) (show-sample-points yes) @@ -730,7 +790,8 @@ large, extra-large, huge, enormous and gigantic. (snap-to-canvas no) (snap-to-path no) (padding-mode default) - (padding-color (color-rgb 1.000000 1.000000 1.000000))) + (padding-color (color-rgb 1 1 1)) + (padding-in-show-all no)) Sets the default settings for the image view. This is a parameter list. @@ -742,6 +803,7 @@ Sets the default settings for the image view. This is a parameter list. (show-scrollbars yes) (show-selection yes) (show-layer-boundary yes) + (show-canvas-boundary yes) (show-guides yes) (show-grid no) (show-sample-points yes) @@ -750,7 +812,8 @@ Sets the default settings for the image view. This is a parameter list. (snap-to-canvas no) (snap-to-path no) (padding-mode default) - (padding-color (color-rgb 1.000000 1.000000 1.000000))) + (padding-color (color-rgb 1 1 1)) + (padding-in-show-all no)) Sets the default settings used when an image is viewed in fullscreen mode. This is a parameter list. @@ -780,6 +843,12 @@ Possible values are low and high. Bugs in event history buffer are frequent so in case of cursor offset problems turning it off helps. Possible values are yes and no. +.TP +(edit-non-visible no) + +When enabled, non-visible layers can be edited as normal. Possible values are +yes and no. + .TP (move-tool-changes-active no) @@ -905,6 +974,12 @@ no. Show the GIMP mascot at the top of the toolbox. Possible values are yes and no. +.TP +(toolbox-groups yes) + +Use a single toolbox button for grouped tools. Possible values are yes and +no. + .TP (theme-path "${gimp_dir}/themes:${gimp_data_dir}/themes") @@ -1015,7 +1090,13 @@ Enable the Seamless Clone tool. Possible values are yes and no. (color-profile-policy ask) How to handle embedded color profiles when opening a file. Possible values -are ask, keep and convert. +are ask, keep, convert-builtin and convert-preferred. + +.TP +(metadata-rotation-policy ask) + +How to handle "Orientation" metadata when opening a file. Possible values are +ask, keep and rotate. .TP @@ -1153,7 +1234,7 @@ Sets the default composite mode for the 'New Layer' dialog. Possible values are auto, union, clip-to-backdrop, clip-to-layer and intersection. .TP -(layer-new-opacity 1.000000) +(layer-new-opacity 1) Sets the default opacity for the 'New Layer' dialog. This is a float value. @@ -1207,7 +1288,7 @@ Sets the default channel name for the 'New Channel' dialog. This is a string value. .TP -(channel-new-color (color-rgba 0.000000 0.000000 0.000000 0.500000)) +(channel-new-color (color-rgba 0 0 0 0.5)) Sets the default color and opacity for the 'New Channel' dialog. The color is specified in the form (color-rgba red green blue alpha) with channel values as @@ -1247,19 +1328,25 @@ Sets the default 'Scale imported paths to fit size' state for the 'Import Path' dialog. Possible values are yes and no. .TP -(selection-feather-radius 5.000000) +(selection-feather-radius 5) Sets the default feather radius for the 'Feather Selection' dialog. This is a float value. .TP -(selection-grow-radius 1.000000) +(selection-feather-edge-lock yes) + +Sets the default 'Selected areas continue outside the image' setting for the +\&'Feather Selection' dialog. Possible values are yes and no. + +.TP +(selection-grow-radius 1) Sets the default grow radius for the 'Grow Selection' dialog. This is a float value. .TP -(selection-shrink-radius 1.000000) +(selection-shrink-radius 1) Sets the default shrink radius for the 'Shrink Selection' dialog. This is a float value. @@ -1271,7 +1358,7 @@ Sets the default 'Selected areas continue outside the image' setting for the \&'Shrink Selection' dialog. Possible values are yes and no. .TP -(selection-border-radius 5.000000) +(selection-border-radius 5) Sets the default border radius for the 'Border Selection' dialog. This is a float value. @@ -1291,7 +1378,9 @@ Sets the default 'Selected areas continue outside the image' setting for the .TP (fill-options (style solid) - (antialias yes)) + (antialias yes) + (feather no) + (feather-radius 10)) The default fill options for the fill dialogs. This is a parameter list. @@ -1299,13 +1388,15 @@ The default fill options for the fill dialogs. This is a parameter list. (stroke-options (style solid) (antialias yes) + (feather no) + (feather-radius 10) (method line) - (width 6.000000) + (width 6) (unit pixels) (cap-style butt) (join-style miter) - (miter-limit 10.000000) - (dash-offset 0.000000) + (miter-limit 10) + (dash-offset 0) (dash-info 0) (emulate-brush-dynamics no)) @@ -1370,6 +1461,14 @@ compiled-in default value @gimpplugindir@. Path to configuration files, which is set to the value of the environment variable GIMP3_SYSCONFDIR or to the compiled-in default value @gimpsysconfdir@. +.TP +.I gimp_cache_dir +Path to cached files, which is set to the value of the environment +variable GIMP3_CACHEDIR or to the system default for per-user cached files. +.TP +.I gimp_temp_dir +Path to temporary files, which is set to the value of the environment +variable GIMP3_TEMPDIR or to the system default for temporary files. .SH FILES .TP diff --git a/etc/gimprc.in b/etc/gimprc.in index a8642a587a..04df5279ef 100644 --- a/etc/gimprc.in +++ b/etc/gimprc.in @@ -17,7 +17,7 @@ # 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. # -# (temp-path "${gimp_dir}/tmp") +# (temp-path "${gimp_temp_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 @@ -27,7 +27,12 @@ # it may be desirable to put your swap file in "/tmp". This is a single # folder. # -# (swap-path "${gimp_dir}") +# (swap-path "${gimp_cache_dir}") + +# The compression method used for tile data stored in the swap file. This is +# a string value. +# +# (swap-compression "fast") # Sets how many threads GIMP should use for operations that support it. This # is an integer value. @@ -226,8 +231,8 @@ # (width 2001) # (height 1984) # (unit pixels) -# (xresolution 300.000000) -# (yresolution 300.000000) +# (xresolution 300) +# (yresolution 300) # (resolution-unit inches) # (image-type rgb) # (precision u8-non-linear) @@ -239,13 +244,13 @@ # # (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) +# (fgcolor (color-rgba 0 0 0 1)) +# (bgcolor (color-rgba 1 1 1 1)) +# (xspacing 10) +# (yspacing 10) # (spacing-unit inches) -# (xoffset 0.000000) -# (yoffset 0.000000) +# (xoffset 0) +# (yoffset 0) # (offset-unit inches)) # Sets the minimal number of operations that can be undone. More undo levels @@ -321,7 +326,7 @@ # (simulation-use-black-point-compensation no) # (simulation-optimize yes) # (simulation-gamut-check no) -# (out-of-gamut-color (color-rgb 1.000000 0.000000 1.000000))) +# (out-of-gamut-color (color-rgb 1 0 1))) # Keep a permanent record of all opened and saved files in the Recent # Documents list. Possible values are yes and no. @@ -332,7 +337,7 @@ # (color-rgba red green blue alpha) with channel values as floats in the # range of 0.0 to 1.0. # -# (quick-mask-color (color-rgba 1.000000 0.000000 0.000000 0.500000)) +# (quick-mask-color (color-rgba 1 0 0 0.5)) # Promote imported images to floating point precision. Does not apply to # indexed images. Possible values are yes and no. @@ -355,11 +360,20 @@ # # (import-raw-plug-in "") +# Export file type used by default. Possible values are png, jpg, ora, psd, +# pdf, tif, bmp and webp. +# +# (export-file-type png) + # Export the image's color profile by default. Possible values are yes and # no. # # (export-color-profile yes) +# Export the image's comment by default. Possible values are yes and no. +# +# (export-comment yes) + # Export Exif metadata by default. Possible values are yes and no. # # (export-metadata-exif yes) @@ -377,6 +391,33 @@ # # (debug-policy warning) +# Check for availability of GIMP updates through background internet queries. +# Possible values are yes and no. +# +# (check-updates yes) + +# Timestamp of the last update check. (null) +# +# (check-update-timestamp 0) + +# The timestamp for the last known release date. (null) +# +# (last-release-timestamp 0) + +# The last known release version of GIMP as queried from official website. +# This is a string value. +# +# + +# The timestamp for the last known release date. This is an integer value. +# +# (last-revision 0) + +# The last known release version of GIMP as queried from official website. +# This is a string value. +# +# + # Sets the size of the checkerboard used to display transparency. Possible # values are small-checks, medium-checks and large-checks. # @@ -411,6 +452,10 @@ # # (resize-windows-on-resize no) +# Show full image content by default. Possible values are yes and no. +# +# (default-show-all 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. # @@ -438,6 +483,11 @@ # # (show-brush-outline yes) +# When enabled, the brush outline will snap to individual dabs while +# painting. Possible values are yes and no. +# +# (snap-brush-outline no) + # When enabled, the mouse pointer will be shown over the image while using a # paint tool. Possible values are yes and no. # @@ -526,13 +576,13 @@ # forces the X server to be queried for both horizontal and vertical # resolution information. This is a float value. # -# (monitor-xresolution 96.000000) +# (monitor-xresolution 96) # 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 96.000000) +# (monitor-yresolution 96) # When enabled, GIMP will use the monitor resolution from the windowing # system. Possible values are yes and no. @@ -554,6 +604,7 @@ # (show-scrollbars yes) # (show-selection yes) # (show-layer-boundary yes) +# (show-canvas-boundary yes) # (show-guides yes) # (show-grid no) # (show-sample-points yes) @@ -562,7 +613,8 @@ # (snap-to-canvas no) # (snap-to-path no) # (padding-mode default) -# (padding-color (color-rgb 1.000000 1.000000 1.000000))) +# (padding-color (color-rgb 1 1 1)) +# (padding-in-show-all no)) # Sets the default settings used when an image is viewed in fullscreen mode. # This is a parameter list. @@ -574,6 +626,7 @@ # (show-scrollbars yes) # (show-selection yes) # (show-layer-boundary yes) +# (show-canvas-boundary yes) # (show-guides yes) # (show-grid no) # (show-sample-points yes) @@ -582,7 +635,8 @@ # (snap-to-canvas no) # (snap-to-path no) # (padding-mode default) -# (padding-color (color-rgb 1.000000 1.000000 1.000000))) +# (padding-color (color-rgb 1 1 1)) +# (padding-in-show-all no)) # 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 @@ -605,6 +659,11 @@ # # (use-event-history no) +# When enabled, non-visible layers can be edited as normal. Possible values +# are yes and no. +# +# (edit-non-visible 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. @@ -711,6 +770,11 @@ # # (toolbox-wilber yes) +# Use a single toolbox button for grouped tools. Possible values are yes and +# no. +# +# (toolbox-groups yes) + # Sets the theme search path. This is a colon-separated list of folders to # search. # @@ -801,10 +865,15 @@ # (playground-seamless-clone-tool no) # How to handle embedded color profiles when opening a file. Possible values -# are ask, keep and convert. +# are ask, keep, convert-builtin and convert-preferred. # # (color-profile-policy ask) +# How to handle "Orientation" metadata when opening a file. Possible values +# are ask, keep and rotate. +# +# (metadata-rotation-policy ask) + # Sets the default folder path for all color profile file dialogs. This is a # single filename. # @@ -924,7 +993,7 @@ # Sets the default opacity for the 'New Layer' dialog. This is a float # value. # -# (layer-new-opacity 1.000000) +# (layer-new-opacity 1) # Sets the default fill type for the 'New Layer' dialog. Possible values are # foreground, background, white, transparent and pattern. @@ -971,7 +1040,7 @@ # 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. # -# (channel-new-color (color-rgba 0.000000 0.000000 0.000000 0.500000)) +# (channel-new-color (color-rgba 0 0 0 0.5)) # Sets the default path name for the 'New Path' dialog. This is a string # value. @@ -1006,17 +1075,22 @@ # Sets the default feather radius for the 'Feather Selection' dialog. This # is a float value. # -# (selection-feather-radius 5.000000) +# (selection-feather-radius 5) + +# Sets the default 'Selected areas continue outside the image' setting for +# the 'Feather Selection' dialog. Possible values are yes and no. +# +# (selection-feather-edge-lock yes) # Sets the default grow radius for the 'Grow Selection' dialog. This is a # float value. # -# (selection-grow-radius 1.000000) +# (selection-grow-radius 1) # Sets the default shrink radius for the 'Shrink Selection' dialog. This is # a float value. # -# (selection-shrink-radius 1.000000) +# (selection-shrink-radius 1) # Sets the default 'Selected areas continue outside the image' setting for # the 'Shrink Selection' dialog. Possible values are yes and no. @@ -1026,7 +1100,7 @@ # Sets the default border radius for the 'Border Selection' dialog. This is # a float value. # -# (selection-border-radius 5.000000) +# (selection-border-radius 5) # Sets the default border style for the 'Border Selection' dialog. Possible # values are hard, smooth and feathered. @@ -1042,7 +1116,9 @@ # # (fill-options # (style solid) -# (antialias yes)) +# (antialias yes) +# (feather no) +# (feather-radius 10)) # The default stroke options for the stroke dialogs. This is a parameter # list. @@ -1050,13 +1126,15 @@ # (stroke-options # (style solid) # (antialias yes) +# (feather no) +# (feather-radius 10) # (method line) -# (width 6.000000) +# (width 6) # (unit pixels) # (cap-style butt) # (join-style miter) -# (miter-limit 10.000000) -# (dash-offset 0.000000) +# (miter-limit 10) +# (dash-offset 0) # (dash-info 0) # (emulate-brush-dynamics no))