Kommandolinjealternativer

Fire typer kommandolinjealternativer påvirker JOSM:

• De Programargumentene⤓ kontrollerer JOSM direkte. De kalles args av Java.
• De Java-alternativene⤓ påvirker dens miljø (JVM) og kalles noen ganger VM-argumenter.
• De Run-alternativene⤓ er involvert i WebStart. Noen er for diagnose og import.
• Noen Andre alternativer⤓ for hjelpeprogrammer.

# Kjøre en jar-fil
java [Java-alternativer] -jar josm.jar [Programargumenter]

# Starte Web Start
javaws [Run-alternativer] -J[Java-alternativ] josm.jnlp

Statusrapporten fra Hjelp-menyen lister opp de gitte Programargumentene og Java-alternativene. Noen eksempler⤓ for begge er vist nedenfor.

Merk: Begrepet josm.jar er en vanlig forkortelse for filnavnene josm-tested.jar og josm-latest.jar. Begrepet josm.jnlp står også for josm-latest.jnlp. Som vanlig er kommandolinjeargumentene atskilt med mellomrom fra hverandre.

Programargumenter for JOSM

Det første argumentet kan være en kommando for JOSM for å få den til å jobbe autonomt. Kommandoene er render, project eller runjosm som standard.

De resterende argumentene er alternativer for JOSM. De kan være URL-er, filnavn, koordinater, enkle alternativer og alternativ=verdi-par.

Alternativene for runjosm er listet opp nedenfor. Nederst er alternativene for kommandoene render⤓ og project⤓.

bruk:
	java -jar josm.jar [<kommando>] <alternativer>...

kommandoer:
	runjosm     start JOSM (standard, utføres når ingen kommando er spesifisert)
	render      render data og lagre resultatet til en bildefil
	project     konverter koordinater fra ett koordinatsystem til et annet
	validate    valider data

For detaljer om render- og project-kommandoene, kjør dem med --help-alternativet.
Resten av denne hjelpesiden dokumenterer runjosm-kommandoen.

alternativer:
	--help|-h                                 Vis denne hjelpen
	--geometry=widthxheight(+|-)x(+|-)y       Standard Unix-geometriargument
	[--download=]minlat,minlon,maxlat,maxlon  Last ned begrensningsboksen
	[--download=]<URL>                        Last ned plasseringen på URL-en (med lat=x&lon=y&zoom=z)
	[--download=]<filename>                   Åpne en fil (hvilken som helst filtype som kan åpnes med Fil/Åpne)
	--downloadgps=minlat,minlon,maxlat,maxlon Last ned begrensningsboksen som rå GPS
	--downloadgps=<URL>                       Last ned plasseringen på URL-en (med lat=x&lon=y&zoom=z) som rå GPS
	--selection=<searchstring>                Velg med det gitte søket
	--[no-]maximize                           Start i maksimert modus
	--reset-preferences                       Tilbakestill preferansene til standard

	--load-preferences=<url-to-xml>           Endre preferanser i henhold til XML-filen

	--set=<key>=<value>                       Sett preferansenøkkel til verdi

	--language=<language>                     Sett språket

	--version                                 Vis JOSM-versjonen og avslutt

	--status-report                           Vis statusrapport med nyttig informasjon som kan legges ved feil

	--debug                                   Skriv feilsøkingsmeldinger til konsollen

	--skip-plugins                            Hopp over lasting av plugins

	--offline=<OSM_API|JOSM_WEBSITE|CACHE_UPDATES|CERTIFICATES|ALL>
	                                          Deaktivere tilgang til den/de gitte ressurs(ene), atskilt med komma
	                                          <OSM API|JOSM nettsted|Cache-oppdateringer|Sertifikater|Alle>

--download=-delen av nedlastingsalternativet er valgfri. Argumentene --download, --downloadgps og --selection behandles i denne rekkefølgen. Verdien <url-to-xml> kan peke til en lokal fil med file:relative/path/name.xml. Elementene i --offline-verdien er atskilt med komma.

Java-alternativer

De kontrollerer Java Virtual Machine ​(JVM) og kan sette ​egenskaper inni den. JOSM leser noen av dem direkte, for eksempel josm.home. Andre som user.language og user.country påvirker standardinnstillingene til JVM som også påvirker JOSM.

Java systemegenskapsalternativer:
    -Djosm.dir.name=JOSM                      Endre JOSM-katalognavnet
    -Djosm.pref=/PATH/TO/JOSM/PREF            Sett preferansekatalogen
                                              Standard (Linux XDG): /home/name/.config/JOSM
                                              Standard (Windows): C:\Users\name\AppData\Roaming\JOSM
    -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Sett brukerdatakatalogen
                                              Standard (Linux XDG): /home/name/.local/share/JOSM
                                              Standard (Windows): C:\Users\name\AppData\Roaming\JOSM
    -Djosm.cache=/PATH/TO/JOSM/CACHE          Sett cachekatalogen
                                              Standard (Linux XDG): /home/name/.cache/JOSM
                                              Standard (Windows): C:\Users\name\AppData\Local\JOSM\cache
    -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Sett felles katalog for preferanser,
                                              brukerdata og ./cache/. Lavere prioritet.
                                              Vil bli overstyrt av spesifikke innstillinger.
    -Xmx...m                                  Sett maksimal Java-heap-størrelse i megabyte.
                                              Kan unngå Out-of-Memory-feil.

-Xmx...m-alternativet kan være nyttig når Out of Memory-feil oppstår. Hvis du setter en felles katalog med Djosm.home, vil JOSM opprette underkatalogene ./autosave, ./cache og ./validator. Hvis en verdi har mellomrom, omslutt den med anførselstegn som "josm dev".

Når ikke-ASCII-tegn i kommandolinjen er rotet, bruk -Dfile.encoding=Cp850 for å motta tekst fra Java i en annen ​kodeside. Hvilken ​kodeside som brukes vises med chcp⏎ i terminalen. For UTF-8 på Windows, kjør chcp 65001 i Windows-terminalvinduet før du starter JOSM med java -Dfile.encoding=UTF-8 -jar josm.jar

JOSMs Debian-pakke josm-latest bruker -Djosm.dir.name=JOSM-latest for å tilby parallelle installasjoner i XDG-baserkatalogene.

Eksempler for JOSM runjosm-alternativer og Java-alternativer

# Laste tre filer
  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
# Laste ned fra OSM i henhold til en URL med zoom og koordinater
  java -jar josm.jar https://www.openstreetmap.org/#map=18/51.501/-0.124
# Laste ned en begrensningsboks og velge hvert element som samsvarer med en streng
  java -jar josm.jar 51.500,-0.126,51.502,-0.122 --selection="Big Ben"
#
# Sette katalog for JOSM i henhold til en egenskap fra operativsystemet
  java -Djosm.pref=$XDG_CONFIG_HOME -jar josm.jar
# Anførselstegn for en verdi med mellomrom og vise JOSMs GUI på engelsk
  java -Djosm.dir.name="josm dev" -jar josm.jar --language=en
# Sette felles katalog i en under-underkatalog under den aktive kommandolinjen
  java -Djosm.home=biketour2017/london -jar josm.jar
# Mer minne og uten å ringe hjem
  java -Xmx1024m --set=message.notifier.enabled=false  -jar josm.jar
#
# Starte i et engelsk miljø og logge feilsøkingsinfo pluss meldinger fra stderr
  java -Duser.language=en -jar josm.jar --debug 1>logfile.txt 2>&1

Run-alternativer for Java Web Start

Run-alternativene leses av javaws-kommandoen. De kontrollerer Web Start-mekanismen, kan innkapsle Java-alternativer og kan diagnostisere Java.

# Kontroll
  -offline                  Tillater Web Start JOSM uten internettilgang

# Innkapsle
  -J<java alternativ>       Leverer <java alternativet> til JVM
  -J-Xmx1024m               Her: Sett maksimal Java-heap-størrelse til 1024 megabyte

# Diagnose
javaws -viewer            Viser Cache Viewer i Java-kontrollpanelet
# Tillater å åpne Java-kontrollpanelet fra kommandolinjen.

javaws -clearcache        Fjerner alle ikke-installerte applikasjoner fra cachen
# Tilsvarer 'Slett filer og applikasjoner' fra 'Midlertidige filinnstillinger' påkalt
# av 'Innstillinger'-knappen i 'Generelt'-fanen i Java-kontrollpanelet.
# javaws -Xclearcache på OpenJDK

-J-run-alternativet tar sin del etter J-bokstaven og leverer det som Java-alternativ. jnlp-Filen (en) brukt av ​Web Start tilbyr en annen måte å ​sette alternativer for JRE og for JOSM-programmet direkte.

javaws-kommandoen har noen kontrollalternativer på alle systemer.

-clearcache-alternativet og tømming av cachen via Java-kontrollpanelet vil begge slette JNLP-baserte ikoner fra skrivebordet. JOSM-ikonet vil forsvinne hvis det ble plassert som et resultat av et klikk i en nettleser på en jnlp-fil.

Andre alternativer

Launcher josm.exe aka ​Launch4j (bare på MS Windows) kan gi noen feilsøkingsinformasjon.

josm.exe --j4l-debug      Prøver å skrive en launch4j.log til gjeldende katalog
josm.exe --j4l-dont-wait  Avslutter wrapperen etter å ha startet JOSM.

Kommandolinje for Render og Project

JOSM rendering Programargumenter

Bruk:
	java -jar josm.jar render <alternativer>

Beskrivelse:
Rendrer data og lagrer resultatet til en bildefil.

Alternativer:
	--help|-h                 Vis denne hjelpen
	--input|-i <file>         Inndatafilnavn (.osm)
	--output|-o <file>        Utdata bildefilnavn (.png); standard er 'out.png'
	--style|-s <file>         Stilfil for bruk ved rendering (.mapcss eller .zip)
	                          Dette alternativet kan gjentas for å laste flere stiler.
	--setting <key>:<value>   Stilinnstilling (i JOSM tilgjengelig i stil-liste-dialog høyreklikkmeny)
	                          Gjelder for den siste stilen lastet med --style-alternativet.
	--zoom|-z <lvl>           Velg zoomnivå for rendering. (heltallsverdi, 0=hele jorden, 18=gatetilstand)
	--scale <scale>           Velg kartskala
	                          En verdi på 10000 betyr en skala på 1:10000 (1 cm på kartet tilsvarer 100 m på bakken; visningsoppløsning: 96 dpi)
	                          Alternativene --zoom og --scale er gjensidig utelukkende.
	--bounds|-b auto|<min_lon>,<min_lat>,<max_lon>,<max_lat>
	                          Område å rendere, standardverdi er 'auto'
	                          Med nøkkelordet 'auto', vil det nedlastede området i .osm-inndatafilen bli brukt (hvis registrert).
	--anchor <lon>,<lat>      Spesifiser nedre venstre hjørne av renderingsområdet
	                          Brukes i kombinasjon med bredde- og høydealternativer for å bestemme området som skal rendres.
	--width-m <number>        Bredde på renderingsområdet, i meter
	--height-m <number>       Høyde på renderingsområdet, i meter
	--width-px <number>       Bredde på målbildet, i piksler
	--height-px <number>      Høyde på målbildet, i piksler
	--projection <code>       Projeksjon som skal brukes, standardverdi 'epsg:3857' (web-Mercator)
	--max-image-size <number> Maksimal bildebredde/-høyde i piksler ('0' betyr ingen grense), standardverdi: 20000

For å spesifisere renderingsområdet og skalaen, kan alternativene kombineres på ulike måter:
  * --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)
Hvis verken 'bounds' eller 'anchor' er gitt, vil standardverdien --bounds=auto tre i kraft, og grensene for nedlastingsområdet i .osm-inndatafilen vil bli brukt.

Eksempler:
  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
josm render -i data.osm -s style.mapcss --scale 5000 --projection epsg:4326

JOSM projeksjonsprogramargumenter

Bruk:
	java -jar josm.jar project <alternativer> <crs> +to <crs> [fil]

Beskrivelse:
Konverterer koordinater fra ett koordinatsystem til et annet.

Alternativer:
	--help|-h         Vis denne hjelpen
	-I                Bytt inngående og utgående crs
	-r                Bytt rekkefølge på inngående koordinater (øst/nord, lon/lat)
	-s                Bytt rekkefølge på utgående koordinater (øst/nord, lon/lat)

<crs>:
Formatet for inngående og utgående koordinatsystem er likt det som brukes i PROJ.4-programvaren.

[fil]:
Leser inndata fra en eller flere filer listet som posisjonsargumenter. Når ingen filer er gitt, eller filnavnet er "-", leses data fra standard inndata.

Eksempler:
    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

Se også

• Feilsøking av Java
• Installasjonsnotater
• Preferanser - Oversikt over preferanser

---

Tilbake til Hovedhjelp