18 | | javaws [run-options] -J[Java option] josm.jnlp |
19 | | }}} |
20 | | |
21 | | |
22 | | === Program arguments ===#Programarguments |
23 | | |
24 | | Also called ''Post jar arguments'' here or ''args'' by Java publishers. |
25 | | |
26 | | The first argument is seen as ''command'' by JOSM. The possible commands are `runjosm` for normal launch (default), `render` for generating an image file and `project` converting coordinates. If JOSM can't recognize a command the default is assumed. |
27 | | |
28 | | The following arguments are ''options'' for JOSM. They are separated by spaces. They can be URLs, filenames, coordinates, simple options and option=argument pairs. The complete list of commands and options is shown below: |
| 18 | javaws [Run-options] -J[Java option] josm.jnlp |
| 19 | }}} |
| 20 | |
| 21 | The [wikitr:/Help/Action/ShowStatusReport Status Report] from the Help menu lists the given Program arguments and Java options. |
| 22 | Some [#Examples examples⤓] for both of them are shown below. |
| 23 | |
| 24 | **Note:** The term {{{josm.jar}}} is a common abbreviation for the file names ''josm-tested.jar'' and ''josm-latest.jar''. |
| 25 | The term ''josm.jnlp'' also stands for ''josm-latest.jnlp''. |
| 26 | As usual the command line arguments are separated by space from each other. |
| 27 | |
| 28 | |
| 29 | == Program arguments for JOSM ==#Programarguments |
| 30 | |
| 31 | The first argument can be a **command** for JOSM to make it work autonomous. |
| 32 | The commands are `render`, `project` or `runjosm` as default. |
| 33 | |
| 34 | The remaining arguments are **options** for JOSM. |
| 35 | They can be URLs, filenames, coordinates, simple options and option=value pairs. |
| 36 | |
| 37 | The options for runjosm are listed in the following. |
| 38 | At the bottom are the options for the commands [#Programargumentsrendering render⤓] and [#Programargumentsproject project⤓]. |
43 | | --help|-h Show this help |
44 | | --geometry=widthxheight(+|-)x(+|-)y Standard unix geometry argument |
45 | | [--download=]minlat,minlon,maxlat,maxlon Download the bounding box |
46 | | [--download=]<URL> Download the location URL which has |
47 | | coordinates like lat=x&lon=y&zoom=z |
48 | | [--download=]<filename> Open a file (same as Menu/File/Open) |
49 | | --downloadgps=minlat,minlon,maxlat,maxlon Download the bounding box as raw GPS |
50 | | --downloadgps=<URL> Download the location as raw GPS |
51 | | --selection=<searchstring> Select with the given search |
52 | | --[no-]maximize Launch in maximized mode |
53 | | --reset-preferences Reset the preferences to default |
54 | | --load-preferences=<url-to-xml> Import preferences from XML file |
55 | | --set=<key>=<value> Set preference key to value |
56 | | --language=<language> Set the language |
57 | | --version Displays the JOSM version and exits |
58 | | --debug Print debugging messages to console |
59 | | --skip-plugins Skip loading plugins |
60 | | --offline=[osm_api,][josm_website,][all] Disable access to the listed resources |
61 | | }}} |
62 | | |
63 | | The `--download=` part of the download option is optional. |
| 54 | --help|-h Show this help |
| 55 | --geometry=widthxheight(+|-)x(+|-)y Standard unix geometry argument |
| 56 | [--download=]minlat,minlon,maxlat,maxlon Download the bounding box |
| 57 | [--download=]<URL> Download the location at the URL (with lat=x&lon=y&zoom=z) |
| 58 | [--download=]<filename> Open a file (any file type that can be opened with File/Open) |
| 59 | --downloadgps=minlat,minlon,maxlat,maxlon Download the bounding box as raw GPS |
| 60 | --downloadgps=<URL> Download the location at the URL (with lat=x&lon=y&zoom=z) as raw GPS |
| 61 | --selection=<searchstring> Select with the given search |
| 62 | --[no-]maximize Launch in maximized mode |
| 63 | --reset-preferences Reset the preferences to default |
| 64 | |
| 65 | --load-preferences=<url-to-xml> Changes preferences according to the XML file |
| 66 | |
| 67 | --set=<key>=<value> Set preference key to value |
| 68 | |
| 69 | --language=<language> Set the language |
| 70 | |
| 71 | --version Displays the JOSM version and exits |
| 72 | |
| 73 | --status-report Show status report with useful information that can be attached to bugs |
| 74 | |
| 75 | --debug Print debugging messages to console |
| 76 | |
| 77 | --skip-plugins Skip loading plugins |
| 78 | |
| 79 | --offline=<OSM_API|JOSM_WEBSITE|CACHE_UPDATES|CERTIFICATES|ALL> |
| 80 | Disable access to the given resource(s), separated by comma |
| 81 | <OSM API|JOSM website|Cache updates|Certificates|All> |
| 82 | }}} |
| 83 | |
| 84 | The `--download=` part of the download option is optional. |
70 | | === Java options ===#Javaoptions |
71 | | |
72 | | The Java options are also ''JOSM JVM options'' called here or ''VM arguments'' in the [wiki:/Help/Action/ShowStatusReport Status Report]. In that report you can see the invoked Program Arguments and below the VM arguments. They control the Java virtual machine [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)] and can set [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html properties] inside it. JOSM reads some of them, for example `josm.home` and `user.language`. |
73 | | {{{ |
74 | | java options: |
75 | | -Djosm.dir.name=JOSM Change the JOSM directory name |
76 | | -Djosm.pref=/PATH/TO/JOSM/PREF Set the preferences directory |
77 | | Default: C:\Users\name\AppData\Roaming\JOSM |
78 | | -Djosm.userdata=/PATH/TO/JOSM/USERDATA Set the user data directory |
79 | | Default: /home/name/.local/share/JOSM |
80 | | -Djosm.cache=/PATH/TO/JOSM/CACHE Set the cache directory |
81 | | Default: <...> |
82 | | -Djosm.home=/PATH/TO/JOSM/HOMEDIR Set the common directory for preferences, |
83 | | user data and ./cache/. Lower precedence. |
84 | | Will get overridden from specific setting. |
85 | | -Xmx...m Set maximum Java heap size in megabytes. |
86 | | May avoid Out-of-Memory errors. |
87 | | }}} |
88 | | |
89 | | The `-Xmx...m` option may be useful when [wiki:/Download#Outofmemory Out of Memory] errors arise. |
| 90 | == Java options ==#Javaoptions |
| 91 | |
| 92 | They control the Java virtual machine [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM)] and can set [https://docs.oracle.com/javase/tutorial/essential/environment/sysprop.html properties] inside it. JOSM reads some of them directly, for example `josm.home`. Others like `user.language` and `user.country` affect the default settings of the JVM which affect JOSM too. |
| 93 | |
| 94 | {{{ |
| 95 | Java system properties options: |
| 96 | -Djosm.dir.name=JOSM Change the JOSM directory name |
| 97 | -Djosm.pref=/PATH/TO/JOSM/PREF Set the preferences directory |
| 98 | Default (Linux XDG): /home/name/.config/JOSM |
| 99 | Default (Windows): C:\Users\name\AppData\Roaming\JOSM |
| 100 | -Djosm.userdata=/PATH/TO/JOSM/USERDATA Set the user data directory |
| 101 | Default (Linux XDG): /home/name/.local/share/JOSM |
| 102 | Default (Windows): C:\Users\name\AppData\Roaming\JOSM |
| 103 | -Djosm.cache=/PATH/TO/JOSM/CACHE Set the cache directory |
| 104 | Default (Linux XDG): /home/name/.cache/JOSM |
| 105 | Default (Windows): C:\Users\name\AppData\Local\JOSM\cache |
| 106 | -Djosm.home=/PATH/TO/JOSM/HOMEDIR Set the common directory for preferences, |
| 107 | user data and ./cache/. Lower precedence. |
| 108 | Will get overridden from specific setting. |
| 109 | -Xmx...m Set maximum Java heap size in megabytes. |
| 110 | May avoid Out-of-Memory errors. |
| 111 | }}} |
| 112 | |
| 113 | The `-Xmx...m` option may be useful when [wikitr:/Download#Outofmemory Out of Memory] errors arise. |
145 | | |
146 | | }}} |
147 | | The `-clearcache` option and clearing the cache via the Java Control Panel will both delete JNLP based icons from the Desktop. The JOSM icon will be gone if it was placed as result of a click in a web browser on a jnlp-file. |
148 | | |
149 | | === See also === |
150 | | * [wiki:Download#Troubleshooting Troubleshooting Java] |
151 | | * [wiki:InstallNotes Installation notes] |
152 | | * [wiki:Help/Preferences Preferences] - Preferences overview |
153 | | * [.. Main Help] |
| 183 | }}} |
| 184 | |
| 185 | == Command line for Render and Project == |
| 186 | |
| 187 | === JOSM rendering Program arguments ===#Programargumentsrendering |
| 188 | |
| 189 | {{{ |
| 190 | Usage: |
| 191 | java -jar josm.jar render <options> |
| 192 | |
| 193 | Description: |
| 194 | Renders data and saves the result to an image file. |
| 195 | |
| 196 | Options: |
| 197 | --help|-h Show this help |
| 198 | --input|-i <file> Input data file name (.osm) |
| 199 | --output|-o <file> Output image file name (.png); defaults to 'out.png' |
| 200 | --style|-s <file> Style file to use for rendering (.mapcss or .zip) |
| 201 | This option can be repeated to load multiple styles. |
| 202 | --setting <key>:<value> Style setting (in JOSM accessible in the style list dialogue right click menu) |
| 203 | Applies to the last style loaded with the --style option. |
| 204 | --zoom|-z <lvl> Select zoom level to render. (integer value, 0=entire earth, 18=street level) |
| 205 | --scale <scale> Select the map scale |
| 206 | A value of 10000 denotes a scale of 1:10000 (1 cm on the map equals 100 m on the ground; display resolution: 96 dpi) |
| 207 | Options --zoom and --scale are mutually exclusive. |
| 208 | --bounds|-b auto|<min_lon>,<min_lat>,<max_lon>,<max_lat> |
| 209 | Area to render, default value is 'auto' |
| 210 | With keyword 'auto', the downloaded area in the .osm input file will be used (if recorded). |
| 211 | --anchor <lon>,<lat> Specify bottom left corner of the rendering area |
| 212 | Used in combination with width and height options to determine the area to render. |
| 213 | --width-m <number> Width of the rendered area, in meter |
| 214 | --height-m <number> Height of the rendered area, in metres |
| 215 | --width-px <number> Width of the target image, in pixels |
| 216 | --height-px <number> Height of the target image, in pixels |
| 217 | --projection <code> Projection to use, default value 'epsg:3857' (web-Mercator) |
| 218 | --max-image-size <number> Maximum image width/height in pixel ('0' means no limit), default value: 20000 |
| 219 | |
| 220 | To specify the rendered area and scale, the options can be combined in various ways: |
| 221 | * --bounds (--zoom|--scale|--width-px|--height-px) |
| 222 | * --anchor (--width-m|--width-px) (--height-m|--height-px) (--zoom|--scale) |
| 223 | * --anchor --width-m --height-m (--width-px|--height-px) |
| 224 | * --anchor --width-px --height-px (--width-m|--height-m) |
| 225 | If neither 'bounds' nor 'anchor' is given, the default value --bounds=auto takes effect and the bounds of the download area in the .osm input file are used. |
| 226 | |
| 227 | Examples: |
| 228 | java -jar josm.jar render -i data.osm -s style.mapcss -z 16 |
| 229 | josm render -i data.osm -s style.mapcss --scale 5000 |
| 230 | josm render -i data.osm -s style.mapcss -z 16 -o image.png |
| 231 | josm render -i data.osm -s elemstyles.mapcss --setting hide_icons:false -z 16 |
| 232 | josm render -i data.osm -s style.mapcss -s another_style.mapcss -z 16 -o image.png |
| 233 | josm render -i data.osm -s style.mapcss --bounds 21.151,51.401,21.152,51.402 -z 16 |
| 234 | josm render -i data.osm -s style.mapcss --anchor 21.151,51.401 --width-m 500 --height-m 300 -z 16 |
| 235 | josm render -i data.osm -s style.mapcss --anchor 21.151,51.401 --width-m 500 --height-m 300 --width-px 1800 |
| 236 | josm render -i data.osm -s style.mapcss --scale 5000 --projection epsg:4326 |
| 237 | }}} |
| 238 | |
| 239 | === JOSM projection Program arguments ===#Programargumentsprojection |
| 240 | |
| 241 | {{{ |
| 242 | Usage: |
| 243 | java -jar josm.jar project <options> <crs> +to <crs> [file] |
| 244 | |
| 245 | Description: |
| 246 | Converts coordinates from one coordinate reference system to another. |
| 247 | |
| 248 | Options: |
| 249 | --help|-h Show this help |
| 250 | -I Switch input and output crs |
| 251 | -r Switch order of input coordinates (east/north, lon/lat) |
| 252 | -s Switch order of output coordinates (east/north, lon/lat) |
| 253 | |
| 254 | <crs>: |
| 255 | The format for input and output coordinate reference system is similar to that of the PROJ.4 software. |
| 256 | |
| 257 | [file]: |
| 258 | Reads input data from one or more files listed as positional arguments. When no files are given, or the filename is "-", data is read from standard input. |
| 259 | |
| 260 | Examples: |
| 261 | java -jar josm.jar project +init=epsg:4326 +to +init=epsg:3857 <<<"11.232274 50.5685716" |
| 262 | => 1250371.1334500168 6545331.055189664 |
| 263 | |
| 264 | java -jar josm.jar project +proj=lonlat +datum=WGS84 +to +proj=merc +a=6378137 +b=6378137 +nadgrids=@null <<EOF |
| 265 | 11d13'56.19"E 50d34'6.86"N |
| 266 | 118d39'30.42"W 37d20'18.76"N |
| 267 | EOF |
| 268 | => 1250371.1334500168 6545331.055189664 |
| 269 | -1.3208998232319113E7 4486401.160664663 |
| 270 | }}} |
| 271 | |
| 272 | |
| 273 | == See also == |
| 274 | * [wikitr:/Download#Troubleshooting Troubleshooting Java] |
| 275 | * [wikitr:/InstallNotes Installation notes] |
| 276 | * [wikitr:/Help/Preferences Preferences] - Preferences overview |
| 277 | |
| 278 | ---- |
| 279 | Back to [wikitr:/Help Main Help] |