Changes between Version 39 and Version 40 of Help/CommandLineOptions

Timestamp:

2020-09-07T08:58:14+02:00 (5 years ago)

Author:

simon04

Comment:

update, +PageOutline, +render, +project

Help/CommandLineOptions

@@ -1 @@
-[[TranslatedPages(outdated=Page is incomplete. Help and Options for commands render and project are missing.)]]
+[[TranslatedPages]]
+[[PageOutline]]
 
 = Command Line Options =
@@ -22 +23 @@
 As usual in all four types the arguments are separated by space from each other.
 
-== Program arguments ==#Programarguments
+== JOSM program arguments ==#Programarguments
 
 The first argument can be a **command** for JOSM to make it work autonomous. 
@@ -33 +34 @@
 {{{
 usage:
-  java <java options> -jar josm.jar [<command>] <options>
+        java -jar josm.jar [<command>] <options>...
 
 commands:
-  runjosm     launch JOSM (default, performed when no command is specified)
-  render      render data and save the result to an image file
-  project     convert coordinates from one coordinate reference system to another
+        runjosm     launch JOSM (default, performed when no command is specified)
+        render      render data and save the result to an image file
+        project     convert coordinates from one coordinate reference system to another
 
 For details on the render and project commands, run them with the --help option.
@@ -44 +45 @@
 
 options:
-  --help|-h                                                Show this help
-  --geometry=widthxheight(+|-)x(+|-)y                      Standard unix geometry argument
-  [--download=]minlat,minlon,maxlat,maxlon                 Download the bounding box
-  [--download=]<URL>                                       Download the location URL which has
-                                                           coordinates like lat=x&lon=y&zoom=z
-  [--download=]<filename>                                  Open a file (same as Menu/File/Open)
-  --downloadgps=minlat,minlon,maxlat,maxlon                Download the bounding box as raw GPS
-  --downloadgps=<URL>                                      Download the location as raw GPS
-  --selection=<searchstring>                               Select with the given search
-  --[no-]maximize                                          Launch in maximized mode
-  --reset-preferences                                      Reset the preferences to default
-  --load-preferences=<url-to-xml>                          Import preferences from XML file
-  --set=<key>=<value>                                      Set preference key to value
-  --language=<language>                                    Set the language
-  --version                                                Displays the JOSM version and exits
-  --debug     or   --trace                                 Print debugging messages to console
-  --skip-plugins                                           Skip loading plugins
-  --offline=[osm_api,][josm_website,][certificates,][all]  Disable access to the listed resources
+        --help|-h                                 Show this help
+        --geometry=widthxheight(+|-)x(+|-)y       Standard unix geometry argument
+        [--download=]minlat,minlon,maxlat,maxlon  Download the bounding box
+        [--download=]<URL>                        Download the location at the URL (with lat=x&lon=y&zoom=z)
+        [--download=]<filename>                   Open a file (any file type that can be opened with File/Open)
+        --downloadgps=minlat,minlon,maxlat,maxlon Download the bounding box as raw GPS
+        --downloadgps=<URL>                       Download the location at the URL (with lat=x&lon=y&zoom=z) as raw GPS
+        --selection=<searchstring>                Select with the given search
+        --[no-]maximize                           Launch in maximised mode
+        --reset-preferences                       Reset the preferences to default
+
+        --load-preferences=<url-to-xml>           Changes preferences according to the XML file
+
+        --set=<key>=<value>                       Set preference key to value
+
+        --language=<language>                     Set the language
+
+        --version                                 Displays the JOSM version and exits
+
+        --debug                                   Print debugging messages to console
+
+        --skip-plugins                            Skip loading plugins
+
+        --offline=<OSM_API|JOSM_WEBSITE|CACHE_UPDATES|CERTIFICATES|ALL>
+                                                  Disable access to the given resource(s), separated by comma
+                                                  <OSM API|JOSM website|Cache updates|Certificates|All>
 }}}
 
@@ -121 +130 @@
 
 
-== Run-options ==#run-options
+== Java Web Start Run-options ==#run-options
 The run-options are used by the `javaws` command. They control the Web Start mechanism and can encapsulate Java options. 
 {{{
@@ -132 +141 @@
 The [wikitr:/Help/jnlpOptions jnlp-File] used by [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/javaws.html Web Start] offers a second way to [https://docs.oracle.com/javase/8/docs/technotes/guides/javaws/developersguide/syntax.html  set options] for JRE and for the JOSM program directly. 
 
-== Other options ==#Otheroptions
 The `javaws` command has some control options on all systems.
 On [wikitr:/Download#Mswindowswrapper MS Windows] only the Launcher `josm.exe` aka [http://launch4j.sourceforge.net/docs.html#Runtime_options  Launch4j] may give some debug info (needs 64-bit Java on 64-bit Windows).  
@@ -153 +161 @@
 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.
 
-=== See also ===
+== JOSM rendering command line interface ==
+
+{{{
+Usage:
+        java -jar josm.jar render <options>
+
+Description:
+Renders data and saves the result to an image file.
+
+Options:
+        --help|-h                 Show this help
+        --input|-i <file>         Input data file name (.osm)
+        --output|-o <file>        Output image file name (.png); defaults to 'out.png'
+        --style|-s <file>         Style file to use for rendering (.mapcss or .zip)
+                                  This option can be repeated to load multiple styles.
+        --setting <key>:<value>   Style setting (in JOSM accessible in the style list dialogue right click menu)
+                                  Applies to the last style loaded with the --style option.
+        --zoom|-z <lvl>           Select zoom level to render. (integer value, 0=entire earth, 18=street level)
+        --scale <scale>           Select the map scale
+                                  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)
+                                  Options --zoom and --scale are mutually exclusive.
+        --bounds|-b auto|<min_lon>,<min_lat>,<max_lon>,<max_lat>
+                                  Area to render, default value is 'auto'
+                                  With keyword 'auto', the downloaded area in the .osm input file will be used (if recorded).
+        --anchor <lon>,<lat>      Specify bottom left corner of the rendering area
+                                  Used in combination with width and height options to determine the area to render.
+        --width-m <number>        Width of the rendered area, in meter
+        --height-m <number>       Height of the rendered area, in metres
+        --width-px <number>       Width of the target image, in pixels
+        --height-px <number>      Height of the target image, in pixels
+        --projection <code>       Projection to use, default value 'epsg:3857' (web-Mercator)
+        --max-image-size <number> Maximum image width/height in pixel ('0' means no limit), default value: 20000
+
+To specify the rendered area and scale, the options can be combined in various ways:
+  * --bounds (--zoom|--scale|--width-px|--height-px)
+  * --anchor (--width-m|--width-px) (--height-m|--height-px) (--zoom|--scale)
+  * --anchor --width-m --height-m (--width-px|--height-px)
+  * --anchor --width-px --height-px (--width-m|--height-m)
+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.
+
+Examples:
+  java -jar josm.jar render -i data.osm -s style.mapcss -z 16
+  josm render -i data.osm -s style.mapcss --scale 5000
+  josm render -i data.osm -s style.mapcss -z 16 -o image.png
+  josm render -i data.osm -s elemstyles.mapcss --setting hide_icons:false -z 16
+  josm render -i data.osm -s style.mapcss -s another_style.mapcss -z 16 -o image.png
+  josm render -i data.osm -s style.mapcss --bounds 21.151,51.401,21.152,51.402 -z 16
+  josm render -i data.osm -s style.mapcss --anchor 21.151,51.401 --width-m 500 --height-m 300 -z 16
+  josm render -i data.osm -s style.mapcss --anchor 21.151,51.401 --width-m 500 --height-m 300 --width-px 1800
+  josm render -i data.osm -s style.mapcss --scale 5000 --projection epsg:4326
+}}}
+
+== JOSM projection command line interface ==
+
+{{{
+Usage:
+        java -jar josm.jar project <options> <crs> +to <crs> [file]
+
+Description:
+Converts coordinates from one coordinate reference system to another.
+
+Options:
+        --help|-h         Show this help
+        -I                Switch input and output crs
+        -r                Switch order of input coordinates (east/north, lon/lat)
+        -s                Switch order of output coordinates (east/north, lon/lat)
+
+<crs>:
+The format for input and output coordinate reference system is similar to that of the PROJ.4 software.
+
+[file]:
+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.
+
+Examples:
+    java -jar josm.jar project +init=epsg:4326 +to +init=epsg:3857 <<<"11.232274 50.5685716"
+       => 1250371.1334500168 6545331.055189664
+
+    java -jar josm.jar project +proj=lonlat +datum=WGS84 +to +proj=merc +a=6378137 +b=6378137 +nadgrids=@null <<EOF
+    11d13'56.19"E 50d34'6.86"N
+    118d39'30.42"W 37d20'18.76"N
+    EOF
+       => 1250371.1334500168 6545331.055189664
+          -1.3208998232319113E7 4486401.160664663
+}}}
+
+== See also ==
 * [wikitr:/Download#Troubleshooting Troubleshooting Java]
 * [wikitr:/InstallNotes Installation notes]