4 | | = Preferences > Advanced Preferences = |
5 | | |
6 | | [[Image(source:trunk/images/preferences/advanced.png)]] |
7 | | |
8 | | **Advanced preferences** gives you a view of all your raw preferences data. This setting requires [wiki:Help/ExpertMode expert mode]. |
9 | | |
10 | | The majority of preference settings can be more easily and safely modified via the other preference panels. Normally you should not need to use this display to change settings. Do so with caution because there is no validation, and invalid or missing settings can cause unexpected errors and/or loss of data. You may be instructed to change or add settings here in order to access experimental or under-development features e.g. if somebody developed a plugin and provided a setting, but didn't get around to creating a more attractive interface for changing it. |
11 | | |
12 | | As you can see, your preference data is composed of a set of name->value pairs. The setting names are often "namespaced" with dot ('.') separated words. Many JOSM plugins will store preferences grouped in a namespace. |
13 | | |
14 | | Preference data is saved to a file in 'Applications Settings' folder (windows) or the hidden system folder ~/.josm (linux). You can get a similar raw view by viewing this file, but this 'Advanced' preferences panel is intended to provide a easier alternative. |
15 | | |
16 | | [[Image(AdvancedPreferences.png, 600px)]] |
| 4 | = Preferences > Advanced Preferences = |
| 5 | [[JOSMImage(preferences/advanced,link=,48,middle,margin-right=20)]] **''Setting Preference directly. Use with caution! ''** |
| 6 | |
| 7 | The **Advanced Peferences** register shows all raw settings and allows to manipulate them. It is visible in [wikitr:/Help/ExpertMode expert mode] only. |
| 8 | |
| 9 | Most settings can easily and safely be modified via the other registers of this dialog box. |
| 10 | Normally you should not need to use this register. |
| 11 | Do so with caution. |
| 12 | Invalid settings can cause errors and/or loss of data. |
| 13 | Some setting changes need a restart to work. Unlike the other registers there is no warning about it. |
| 14 | You may be instructed to edit here in order to access experimental features. |
| 15 | See more about user settings in the [wikitr:/Help/Preferences Preferences Overwiew]. |
| 16 | |
| 17 | == Search == |
| 18 | Use the Search field to quickly access values and keys grouped by namespace. |
| 19 | |
| 20 | == List colors == |
| 21 | 1. [[span(style=background-color:#FFFFC8;font-weight:bold;, Bold on yellow)]] - value has changed at least once. |
| 22 | 1. [[span(style=background-color:#C8FFC8;font-weight:bold;, Bold on green)]] - value was changed in this dialog. |
| 23 | 1. [[span(style=background-color:#C8FFC8;font-weight:normal;, Normal on green)]] - value was reset to default in this dialog. |
| 24 | After a restart of JOSM all preference settings which are equal to their default values loose any list colors. |
| 25 | |
| 26 | [[Image(PreferencesAdvancedPreferences.png,link=,45%,right,margin-left=10)]] |
| 27 | |
| 28 | == Buttons ==#Buttons |
| 29 | Add:: To add keys with simple values and with a XML structure. |
| 30 | |
| 31 | Edit:: To edit one marked key/value pair. |
| 32 | |
| 33 | Reset:: Sets all marked key/value pairs to their default value. |
| 34 | |
| 35 | Read from file:: Imports a JOSM custom configuration XML file. |
| 36 | That can contain preferences modifications, commands to download some files or plugins and even JavaScript code. \\ |
| 37 | After a file import is complete, you can see a detailed log and the changed preferences will be represented. |
| 38 | You can reject these changes by pressing **Cancel** button. |
| 39 | **Caution**: You can not undo reject file or plugin operations (download, delete, etc.), so be careful and do not open scripts from untrusted sources! |
| 40 | |
| 41 | Export selected items:: Generates a custom configuration XML file automatically. |
| 42 | When reading this file, the key-value pairs will replace existing ones or be appended to them (in case of properties containing lists or maps). |
| 43 | You can use it together with the **Search** field to find all preferences you need to backup or share. |
| 44 | |
| 45 | More...:: launches a popup menu with additional actions: |
| 46 | * **Save ... profile** - saves part of preferences related to shortcuts, colors, toolbar and imagery to a separate custom configuration XML files. |
| 47 | * **Load profile** - replace existing part of preferences with previously saved fragment (for example, reset all shortcuts to default and then load them from file). |
| 48 | User should press OK to confirm changes. |
| 49 | * **Reset preferences** - reset all preferences by deleting the preferences.xml file. |
| 50 | See [wikitr:/Help/ResetPreferences Reset preferences] also. |
| 51 | |
| 52 | == Explanation == |
| 53 | The table below contains settings not accessible in the other tabs of the Preferences dialog (incomplete list): |
| 54 | ||= **Key** =||\ |
| 55 | ||= **Values** =||= **Default** =||\ |
| 56 | ||= **Description** =||\ |
| 57 | || |
| 58 | || **''$panel''`.buttonhiding`** ||\ |
| 59 | || DYNAMIC, ALWAYS_HIDDEN or ALWAYS_SHOWN || DYNAMIC ||\ |
| 60 | || See [wikitr:"/Help/JOSM interface customization" JOSM interface customization] ||\ |
| 61 | || |
| 62 | || **''$panel''`.minimized`** ||\ |
| 63 | || true or false || false ||\ |
| 64 | || See [wikitr:"/Help/JOSM interface customization" JOSM interface customization] ||\ |
| 65 | || |
| 66 | || **''$panel''`.docked`** ||\ |
| 67 | || true or false || true ||\ |
| 68 | || if a window is in the side pane or floating ||\ |
| 69 | || |
| 70 | || **''$panel''`.lastHeight`** ||\ |
| 71 | || integer || mixed ||\ |
| 72 | || is used to store the last used height of a panel ||\ |
| 73 | || |
| 74 | || **''$panel''`.preferredHeight`** ||\ |
| 75 | || integer || mixed ||\ |
| 76 | || can be used to overwrite the hard coded preferred height of a panel ||\ |
| 77 | || |
| 78 | || **''$dialogname''`.geometry`** ||\ |
| 79 | || ''`x=*,y=*,width=*,height=*`'' || || Size and position of dialog boxes ||\ |
| 80 | || |
| 81 | || **''$widget''`.always-visible`** ||\ |
| 82 | || true or false || true ||\ |
| 83 | || if TAB toggles this screen widget ||\ |
| 84 | || |
| 85 | || **`validator.*`** \\ **`overlapping-ways.*`** ||\ |
| 86 | || mixed || mixed ||\ |
| 87 | || See [wikitr:/Help/Preferences/Validator validator preferences] ||\ |
| 88 | || |
| 89 | || **`draw.anglesnap.*`** and probably keys starting with **`color.draw.angle.snap`** ||\ |
| 90 | || mixed || mixed ||\ |
| 91 | || should be explained at [wikitr:/Help/Action/Draw Draw] ||\ |
| 92 | || |
| 93 | || **`edit.initial-move-threshold`** ||\ |
| 94 | || pixels || || See [wikitr:/Help/Action/Select#Advanceddetails Select] ||\ |
| 95 | || |
| 96 | || **`edit.initial-move-delay`** ||\ |
| 97 | || ms || || See [wikitr:/Help/Action/Select#Advanceddetails Select] ||\ |
| 98 | || |
| 99 | || **`message.movedManyElements`** ||\ |
| 100 | || true or false || unset ||\ |
| 101 | || Decision of "do not ask again" message after moving many objects. ||\ |
| 102 | || |
| 103 | || **`draw.fullscreen`** ||\ |
| 104 | || true or false || false || See [wikitr:/Help/Action/FullscreenView Fullscreen view] ||\ |
| 105 | || |
| 106 | || **`navigation.always-visible`** ||\ |
| 107 | || `true` or `false` || `true` || Hide on-screen zoom control and current scale and [wikitr:/Help/ToggleDialogs Toggle Dialogs] are hidden (since r18755) ||\ |
| 108 | || |
| 109 | || **`zoom.undo.delay` \\ `zoom.undo.max`** ||\ |
| 110 | || || || See [wikitr:/Help/Action/ZoomToPrevious#AdvancedPreferences Zoom to previous] ||\ |
| 111 | || |
| 112 | || **`relation.editor.presets.visible?`** ||\ |
| 113 | || true or false || true || If set to true, displays the list of presets matching the current tags in the relation editor. ||\ |
| 114 | || |
| 115 | || **`properties.presets.visible`** ||\ |
| 116 | || true or false || true || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\ |
| 117 | || |
| 118 | || **`properties.presets.top`** ||\ |
| 119 | || true or false || true || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\ |
| 120 | || |
| 121 | || **`url.openstreetmap-wiki`** ||\ |
| 122 | |||| !https://wiki.openstreetmap.org/wiki/ ||\ |
| 123 | || See [wikitr:/Help/Dialog/TagsMembership#AdvancedPreferences Tags/Membership panel] ||\ |
| 124 | || |
| 125 | || **`selectaction.cycles.multiple.matches`** ||\ |
| 126 | || true or false || false ||\ |
| 127 | || See [wikitr:/Help/Action/Select#Selectsingle] ||\ |
| 128 | || |
| 129 | || **`osm.notes.daysClosed`** ||\ |
| 130 | || -1, 0 or positive integer || 7 || See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Notes panel], available in [wikitr:/Help/Preferences/Connection OSM Server preferences] ||\ |
| 131 | || |
| 132 | || **`osm.notes.downloadLimit`** ||\ |
| 133 | || from ... to 10000 || 1000 || See [wikitr:/Help/Dialog/Notes#AdvancedPreferences Notes panel] ||\ |
| 134 | || |
| 135 | || **`latlon.dms.decimal-format` \\ `latlon.dm.decimal-format` \\ `statusbar.decimal-format`** ||\ |
| 136 | || || || See [wikitr:/Help/StatusBar#AdvancedPreferences StatusBar] ||\ |
| 137 | || |
| 138 | || **`statusbar.distance-threshold`** ||\ |
| 139 | || || || See [wikitr:/Help/StatusBar#AdvancedPreferences StatusBar] ||\ |
| 140 | || |
| 141 | || **`override.numbering.format`** ||\ |
| 142 | || true or false || `true` || disable/enable overriding of number format. So far only Arabic languages and Khmer are supported, see #18856. ''(since r16111)'' ||\ |
| 143 | || |
| 144 | || **`simplify-way.max-error`** ||\ |
| 145 | || integer, meters || `3` || See [wikitr:/Help/Action/SimplifyWay Simplify Way] ||\ |
| 146 | || |
| 147 | || **`message.way.split.segment-selection-dialog`** ||\ |
| 148 | || true or false || `false` || See [wikitr:/Help/Action/SplitWay#AdvancedPreferences Split Way] ||\ |
| 149 | || |
| 150 | || **`mappaint.wireframe.use-antialiasing`** ||\ |
| 151 | || true or false || `false` || See [wikitr:/Help/Action/WireframeToggle#AdvancedPreferences Wireframe view], available in the [[JOSMImage(layer/osmdata_small,24,link=,middle)]] [wikitr:/Help/Preferences/DrawingPreference OSM Data preferences] ||\ |
| 152 | || |
| 153 | || **`merge-nodes.mode`** ||\ |
| 154 | || 0 or 1 or 2 || `0` || See [wikitr:/Help/Action/MergeNodes#AdvancedPreferences Merge Nodes] ||\ |
| 155 | || |
| 156 | || **`upload.comment.max-age`** ||\ |
| 157 | || integer || `4*3600*1000` || See [wikitr:/Help/Concepts/Changeset#AdvancedPreferences Changeset] ||\ |
| 158 | || |
| 159 | || **`upload.show.review.request`** ||\ |
| 160 | || true or false || `true` || displays the "I want someone to review my edits." check box in the upload dialog ||\ |
| 161 | || |
| 162 | || **`upload.show.automatic.source`** ||\ |
| 163 | || true or false || `true` || displays the "Automatically obtain source from current layers" check box in the upload dialog ||\ |
| 164 | || |
| 165 | || **`mappaint.fillalpha`**, **`mappaint.showicons`** and couple others ||\ |
| 166 | || || || See [wikitr:/Styles#AdvancedPreferences Styles] ||\ |
| 167 | || |
| 168 | || **`browser.unix`** ||\ |
| 169 | || || ["xdg-open", \\ "#DESKTOP#", \\ "$BROWSER", \\ "gnome-open", \\ "kfmclient openURL", \\ "firefox"] || sets another external browser than the default browser to open external links on unix os ||\ |
| 170 | || |
| 171 | || **`browser.windows`** ||\ |
| 172 | || || || sets another external browser than the default browser to open external links on windows os (use the browser executable) ||\ |
| 173 | || |
| 174 | |||| |
| 175 | || **`osm-primitives.localize-name`** ||\ |
| 176 | || true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\ |
| 177 | || |
| 178 | || **`osm-primitives.showcoor`** ||\ |
| 179 | || true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\ |
| 180 | || |
| 181 | || **`osm-primitives.showid`** ||\ |
| 182 | || true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\ |
| 183 | || |
| 184 | || **`osm-primitives.showid.new-primitives`** ||\ |
| 185 | || true or false || `false` || Instead of `id:0`, displays the internal negative id for new objects beside the object in lists ||\ |
| 186 | || |
| 187 | || **`osm-primitives.showversion`** ||\ |
| 188 | || true or false || `false` || See [wikitr:/Help/Preferences/Display Display preferences] ||\ |
| 189 | || |
| 190 | |||| |
| 191 | || **`propertiesdialog.autoresizeTagsTable`** ||\ |
| 192 | || true or false || `false` || Enables automatic column width of the tags table to fit content, see #14666 ||\ |
| 193 | || |
| 194 | || **`zoom.scale-follow-native-resolution-at-load`** ||\ |
| 195 | || true or false || `true` || `true` means "Scale follows native resolution of layer" is enabled when layer is created ||\ |
| 196 | || |
| 197 | || **`properties.autocomplete-keys`** ||\ |
| 198 | || true or false || `true` || `true` means autocomplete keys by default in the add tag dialog ||\ |
| 199 | || |
| 200 | || **`properties.autocomplete-values`** ||\ |
| 201 | || true or false || `true` || `true` means autocomplete values by default in the add tag dialog ||\ |
| 202 | || |
| 203 | || **`imagery.generic.popupmenu`** ||\ |
| 204 | || true or false || `true` || `false` disables the imagery context menu in the mapview ||\ |
| 205 | || |
| 206 | || **`gui.start.animation`** ||\ |
| 207 | || true or false || `true` || `false` disables the animation while displaying the [wikitr:/StartupPage Startup page] ||\ |
| 208 | || |
| 209 | || **`jcs.cache.use_image_resource_cache`** ||\ |
| 210 | || true or false || `false` || `true` enables caching rendered SVG images using JCS ''(since r17364)'' ||\ |
| 211 | || |
| 212 | |||| |
| 213 | || **`osm.download.threads`** ||\ |
| 214 | || integer || `2` || Maximum parallel download threads downloading OSM data objects ||\ |
| 215 | || |
| 216 | || **`socket.maxredirects`** ||\ |
| 217 | || integer || `5` || Maximum of allowed redirects ||\ |
| 218 | || |
| 219 | || **`socket.timeout.connect`** ||\ |
| 220 | || integer || `15` || Maximum interval to wait for a connection with server ||\ |
| 221 | || |
| 222 | || **`socket.timeout.read`** ||\ |
| 223 | || integer || `30` || Maximum interval to wait for an answer from server ||\ |
| 224 | || |
| 225 | |||| |
| 226 | || **`autosave.deletedLayersBackupCount`** ||\ |
| 227 | || integer || `5` || ||\ |
| 228 | || |
| 229 | || **`autosave.enabled`** ||\ |
| 230 | || true or false || `true` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\ |
| 231 | || |
| 232 | || **`autosave.extension`** ||\ |
| 233 | || || `osm` || File extension to use for data layers when [wikitr:/Help/Action/AutoSave auto saving] ||\ |
| 234 | || |
| 235 | || **`autosave.filesPerLayer`** ||\ |
| 236 | || integer || `1` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\ |
| 237 | || |
| 238 | || **`autosave.index-limit`** ||\ |
| 239 | || integer || `1000` || ||\ |
| 240 | || |
| 241 | || **`autosave.interval`** ||\ |
| 242 | || integer || `300` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\ |
| 243 | || |
| 244 | || **`autosave.notification`** ||\ |
| 245 | || true or false || `false` || See [wikitr:/Help/Preferences/BackupPreference File backup] ||\ |
| 246 | || |
| 247 | |||| |
| 248 | || **`multipoly.alltags`** ||\ |
| 249 | || true or false || `false` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\ |
| 250 | || |
| 251 | || **`multipoly.lineartagstokeep`** ||\ |
| 252 | || key list || `[barrier,fence_type,source]` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\ |
| 253 | || |
| 254 | || **`multipoly.movetags`** ||\ |
| 255 | || true or false || `true` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\ |
| 256 | || |
| 257 | || **`multipoly.show-relation-editor`** ||\ |
| 258 | || true or false || `false` || See [[JOSMImage(multipoly_create)]] [wikitr:/Help/Action/CreateMultipolygon#AdvancedPreferences Create Multipolygon] ||\ |
| 259 | || |
| 260 | |||| |
| 261 | |
| 262 | **''$dialogname''** is short for a dialog name \\ |
| 263 | **''$panel''** is short for changesetdialog, commandstack, conflict, filter, layerlist, mapstyle, notes/note_open, propertiesdialog, relationlist, selectionlist, userlist or validator \\ |
| 264 | **''$widget''** is short for menu, sidetoolbar, statusbar or toolbar \\ |
| 265 | |