Opties voor de opdrachtregel

JOSM wordt beïnvloed door drie groepen van opties voor de opdrachtregel. De Programma argumenten⤓ zijn de meest belangrijke en dan de Java-opties⤓. Bekijk Voorbeelden⤓ voor beide. Alleen van toepassing op Web Start zijn de run-opties⤓. Het laatste gedeelte hier behandelt de andere⤓ opties die ergens op deze helppagina's worden gebruikt.

# Uitvoeren van een jar
java [Java-opties] -jar josm-tested.jar [Programma argumenten]

# Web Start starten
javaws [run-opties] -J[Java-optie] josm.jnlp

Programma argumenten

Ook wel Post jar-argumenten genoemd of args door Oracle.

Het eerste argument is de opdracht voor JOSM. De drie mogelijke opdrachten zijn runjosm voor normaal gebruik (standaard), render voor het genereren van een afbeeldingsbestand en project voor het converteren van coördinaten. Als JOSM een opdracht niet kan herkennen gaat het uit van de standaard en wordt de normale GUI gestart.

De volgende argumenten zijn opties voor JOSM. Zij dienen te worden gescheiden door spaties. Zij mogen URL's, coördinaten, eenvoudige opties en paren optie=argument zijn. De volledige lijst met opdrachten en opties wordt hieronder weergegeven:

gebruik:
  java <Java-opties> -jar josm.jar [<opdracht>] <opties>
opdrachten:
  runjosm     JOSM starten (standaard, uitgevoerd als geen opdracht is gespecificeerd)
  render      gegevens renderen en het resultaat opslaan als een afbeeldingsbestand
  project     coördinaten converteren va het ene coördinaten referentiesysteem naar een ander

Voor details voor de opdrachten render en project, voer ze uit met de optie --help.
De rest van deze Helppagina documenteert de opdracht runjosm.

opties:
--help|-h                                 Deze help weergeven
--geometry=widthxheight(+|-)x(+|-)y       Standaard Unix geometrie argument
[--download=]minlat,minlon,maxlat,maxlon  Download het begrenzingsvak
[--download=]<URL>                        Download de locatie van de URL
                                          (met lat=x&lon=y&zoom=z)
[--download=]<filename>                   Open een bestand (hetzelfde als Menu/Bestand/Openen)
--downloadgps=minlat,minlon,maxlat,maxlon Download een begrenzingsvak als ruwe GPS
--downloadgps=<URL>                       Download de locatie van de URL 
                                          (met lat=x&lon=y&zoom=z) als ruwe GPS
--selection=<searchstring>                Selecteer met de opgegeven zoekactie

--[no-]maximize                           Starten in modus Gemaximaliseerd
--reset-preferences                       herstel de voorkeuren naar de standaard
--load-preferences=<url-to-xml>           Wijzigt voorkeuren overeenkomstig het XML-bestand
--set=<key>=<value>                       Stel voorkeurssleutel in op waarde
--language=<language>                     Stel de taal in
--version                                 Geeft de versie van JOSM weer en sluit
--debug                                   Drukt berichten voor debuggen af op het scherm
--skip-plugins                            Laden van plug-ins overslaan
--offline=<osm_api|josm_website|all>      Toegang tot de opgegeven bron(nen) uitschakelen

Het gedeelte --download= van de optie download is optioneel. Parameters --download, --downloadgps en --selection worden in deze volgorde verwerkt. De waarde <url-to-xml> mag verwijzen naar een lokaal bestand met file:relatief/pad/naam.xml. Meer uitgebreid dan --debug is de optie --trace. De items in de optie --offline dienen te worden gescheiden door een komma.

Java-opties

De Java-opties worden hier ook wel JOSM JVM-opties genoemd of VM-argumenten in het Statusrapport. In dat rapport kunt u ze zien en ook de Programma-argumenten. Zij beheren de Java virtuele machine ​(JVM) en kunnen ​eigenschappen daarin instellen. JOSM leest enkele daarvan, bijvoorbeeld josm.home en user.language.

Java-opties:
  -Djosm.dir.name=JOSM                       De naam van de map voor JOSM wijzigen
  -Djosm.pref=/PAD/NAAR/JOSM/PREF            Stel de map voor voorkeuren in
                                             Standaard: C:\Users\naam\AppData\Roaming\JOSM
  -Djosm.userdata=/PAD/NAAR/JOSM/USERDATA    Stel de map voor gebruikersgegevens in
                                             Standaard: /home/naam/.local/share/JOSM
  -Djosm.cache=/PAD/NAAR/JOSM/CACHE          Stel de map voor de cache in
                                             Standaard: <...>
  -Djosm.home=/PATH/NAAR/JOSM/HOMEDIR        Stel de algemene map in voor voorkeuren,
                                             gebruikersgegevens en ./cache/. Lagere prioriteit.
                                             Zal worden overschreven door specifieke instelling.
  -Xmx...m                                   Maximale Java heapgrootte instellen in megabytes.
                                             Kan fouten voor Out-of-Memory vermijden.

De optie -Xmx...m kan nuttig zijn als fouten Out of Memory optreden. Indien u een algemene map instelt met Djosm.home dan zal JOSM de submappen ./autosave, ./cache en ./validator maken. Indien een waarde spaties bevat, omsluit die dan met aanhalingstekens, zoals in "josm dev".

Voorbeelden

Voorbeelden voor de Programma-argumenten en Java-opties in actie:

# Laadt drie bestanden
  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
# Download vanaf OSM overeenkomstig een URL met zoom en coördinaten
  java -jar josm.jar https://www.openstreetmap.org/#map=19/51.51/-0.135
# Download een begrenzingsvak en selecteer elk element dat overeenkomt met een tekenreeks
  java -jar josm.jar 51.505,-0.14,51.515,-0.13 --selection="Piccadilly Circus"
#
# Stel een map in voor JOSM overeenkomstig een eigenschap van het besturingssysteem
  java -Djosm.pref=$XDG_CONFIG_HOME jar josm.jar
# Aanhalingstekens voor waarden met een spatie erin
  java -Djosm.dir.name="josm dev" -jar josm.jar
# Stel de algemene map in in een sub-submap onder de actieve command prompt
  java -Djosm.home=biketour2017/london -jar josm.jar
# Meer geheugen in een Franstalige omgeving
  java -Xmx1024m -Duser.language=fr -jar josm.jar
#
# Raak niet in paniek en log info voor debuggen in het Engels
  java -verbose  -jar josm-latest.jar --set=message.notifier.enabled=false --language=en --debug >WhatsUp.txt

run-opties

De run-opties volgen op de opdracht javaws. Zij beheren het mechanisme Web Start en de omgeving voor de JVM.

  -offline                  Stelt Web Start in staat JOSM te starten zonder toegang tot internet
  -J<java option>           verschaft de <Java-optie> aan de JVM
  -J-Xmx1024m               Hier: Stel de maximale heapgrootte voor Java in op 1024 megabyte

De run-optie -J neemt het gedeelte na de letter J en geeft dat als Java-optie. Het jnlp-bestand dat wordt gebruikt door ​Web Start biedt een tweede manier om ​direct opties in te stellen voor JRE en voor het programma JOSM.

Andere opties

De opdracht javaws op alle systemen en de josm.exe op MS Windows hebben enkele aanvullende ​opties.

javaws -viewer            Geeft de Cache Viewer weer in het Java Control Panel
# Maakt het mogelijk het Java Control Panel te openen vanaf de opdrachtregel.

javaws -clearcache        Verwijdert alle niet geïnstalleerde toepassingen uit de cache
# Is gelijk aan 'Delete Files and Applications' uit de 'Temporary File Settings' uitvoeren
# met de knop 'Settings' op de tab 'General' van het Java Control Panel.
# javaws -Xclearcache op OpenJDK

josm.exe --j4l-debug      Probeert een launch4j.log naar de huidige map te schrijven
josm.exe --j4l-dont-wait  Beëindigt de wrapper na het uitvoeren van JOSM.

Verwijderen van tijdelijke bestanden zal niet ook op JNLP gebaseerde pictogrammen van het nureaublad verwijderen.

Zie ook

• Probleemoplossing Java
• Opmerkingen voor installeren
• Voorkeuren - overzichtspagina over alle "voorkeuren"