wiki:Nl:Help/CommandLineOptions

Version 24 (modified by DiGro, 6 years ago) ( diff )

typo corrected

Opties voor de opdrachtregel

Vier typen opties voor de opdrachtregel beïnvloeden JOSM:

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

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

Het Statusrapport vermeldt de opgegevenb programma-argumenten en Java-opties in zijn tweede gedeelte. Enkele voorbeelden⤓ voor beide worden hieronder weergegeven. Zoals gewoonlijk worden in alle vier typen de argumenten van elkaar gescheiden door een spatie.

Programma argumenten

Het eerste argument mag een opdracht voor JOSM zijn om het autonoom te laten werken. Als JOSM het eerste argument niet herkent als een opdracht, dan wordt runjosm geacht de standaard te zijn.

De resterende argumenten zijn opties voor JOSM. Zij kunnen URL's, bestandsnamen, coördinaten, eenvoudige opties en paren optie=waarde 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     of   --trace                  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. 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 Zij beheren de Java virtuele machine [https://docs.oracle.com/javase/8/docs/technotes/tools/unix/java.html (JVM) en kunnen eigenschappen daarin instellen. JOSM leest enkele daarvan, bijvoorbeeld josm.home en user.language. Andere, zoals user.language en user.country hebben invloed op de standaard instellingen van de JVM wat dan ook weer JOSM beïnvloedt.

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". Wanneer de niet-ASCIItekens in de opdrachtregel zijn versleuteld, gebruik dan -Dfile.encoding=Cp850 om tekst van Java te ontvangen in een andere codering. Welke codering wordt gebruikt, wordt weergegeven door chcp⏎ in de terminal.

Voorbeelden

# Laadt drie bestanden
  java -jar josm-tested.jar track1.gpx BigBen.jpg "london data.osm"
# Download vanaf OSM overeenkomstig een URL met zoom en coördinaten
  java -jar josm-tested.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-tested.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-tested.jar
# Aanhalingstekens voor waarden met een spatie erin en geeft de GUI van JOSM in het Engels weer
  java -Djosm.dir.name="josm dev" -jar josm-latest.jar --language=en
# Stel de algemene map in in een sub-submap onder de actieve command prompt
  java -Djosm.home=biketour2017/london -jar josm-tested.jar
# Meer geheugen in de Canadese variant van een Engels-sprekende omgeving
  java -Xmx1024m -Duser.language=en -Duser.country=CA -jar josm-latest
#
# Log info voor debuggen en raak niet in paniek als JOSM naar huis belt
  java -verbose  -jar josm-latest.jar --set=message.notifier.enabled=false --debug >WhatsUp.txt

Run-opties

De run-opties worden gebruikt door de opdracht javaws. Zij beheren het mechanisme Web Start en kunnen Java-opties bevatten.

  -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 (en) 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 heeft enkele beheersopties op alle systemen. Op MS Windows zou alleen de opstarter josm.exe ook wel Launch4j genoemd, enige debug-info kunnen geven (heeft 64-bit Java nodig op 64-bit Windows).

# Control options:
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

# Op MS Windows:
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.

De optie -clearcache en het leegmaken van de cache via het Java Control Panel zullen beide op JNLP gebaseerde pictogrammen van het bureaublad verwijderen. Het pictogram JOSM zal verdwijnen alsof het was geplaatst met een klik op een JNLP-bestand in een webbrowser.

Zie ook


Terug naar Help

Note: See TracWiki for help on using the wiki.