| 21 | | As usual in all four types the arguments are separated by space from each other. |
| 22 | | |
| 23 | | == Program arguments ==#Programarguments |
| 24 | | |
| 25 | | The first argument can be a **command** for JOSM to make it work autonomous. |
| 26 | | If JOSM can't recognize the first argument as command, then `runjosm` is assumed as default. |
| 27 | | |
| 28 | | The remaining arguments are **options** for JOSM. |
| 29 | | They can be URLs, filenames, coordinates, simple options and option=value pairs. |
| 30 | | The complete list of commands and options is 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⤓]. |
| 45 | | --help|-h Show this help |
| 46 | | --geometry=widthxheight(+|-)x(+|-)y Standard unix geometry argument |
| 47 | | [--download=]minlat,minlon,maxlat,maxlon Download the bounding box |
| 48 | | [--download=]<URL> Download the location URL which has |
| 49 | | coordinates like lat=x&lon=y&zoom=z |
| 50 | | [--download=]<filename> Open a file (same as Menu/File/Open) |
| 51 | | --downloadgps=minlat,minlon,maxlat,maxlon Download the bounding box as raw GPS |
| 52 | | --downloadgps=<URL> Download the location as raw GPS |
| 53 | | --selection=<searchstring> Select with the given search |
| 54 | | --[no-]maximize Launch in maximized mode |
| 55 | | --reset-preferences Reset the preferences to default |
| 56 | | --load-preferences=<url-to-xml> Import preferences from XML file |
| 57 | | --set=<key>=<value> Set preference key to value |
| 58 | | --language=<language> Set the language |
| 59 | | --version Displays the JOSM version and exits |
| 60 | | --debug or --trace Print debugging messages to console |
| 61 | | --skip-plugins Skip loading plugins |
| 62 | | --offline=[osm_api,][josm_website,][certificates,][all] Disable access to the listed resources |
| 63 | | }}} |
| 64 | | |
| 65 | | 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. |
| 76 | | java options: |
| 77 | | -Djosm.dir.name=JOSM Change the JOSM directory name |
| 78 | | -Djosm.pref=/PATH/TO/JOSM/PREF Set the preferences directory |
| 79 | | Default: C:\Users\name\AppData\Roaming\JOSM |
| 80 | | -Djosm.userdata=/PATH/TO/JOSM/USERDATA Set the user data directory |
| 81 | | Default: /home/name/.local/share/JOSM |
| 82 | | -Djosm.cache=/PATH/TO/JOSM/CACHE Set the cache directory |
| 83 | | Default: <...> |
| 84 | | -Djosm.home=/PATH/TO/JOSM/HOMEDIR Set the common directory for preferences, |
| 85 | | user data and ./cache/. Lower precedence. |
| 86 | | Will get overridden from specific setting. |
| 87 | | -Xmx...m Set maximum Java heap size in megabytes. |
| 88 | | May avoid Out-of-Memory errors. |
| | 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. |
| 151 | | 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. |
| 152 | | |
| 153 | | === See also === |
| | 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 == |
