Options en ligne de commande

Quatre types d'options en ligne de commande affectent JOSM :

• Les Paramètres du programme (Program arguments⤓) contrôlent directement JOSM. Ils sont appelés args par Java.
• Les Options Java (Java options⤓) affectent son environnement (JVM) et sont parfois appelées paramètres VM (VM arguments).
• Les Options de démarrage (Run-options⤓) sont disponibles dans WebStart. Certaines sont destinées au diagnostic et à l'importation.
• D'Autres options (Other options⤓) pour les programmes d'aide.

# Exécution d'un jar
java [Options Java] -jar josm.jar [Paramètres du programme]

# Lancement de Web Start
javaws [Run-options] -J[Options Java] josm.jnlp

Le Rapport d'état du menu Aide énumère les paramètres du programme (Program arguments) et les options Java (Java option). Quelques exemples pour les deux cas sont présentés ci-dessous.

Note : Le terme josm.jar est une abréviation courante pour les noms de fichiers josm-tested.jar et josm-latest.jar. Le terme josm.jnlp signifie également josm-latest.jnlp. Comme d'habitude les paramètres de la ligne de commande sont séparés les uns des autres par des espaces.

Paramètres du programme pour JOSM (Program arguments)

Le premier paramètre peut être une instruction permettant à JOSM de le rendre autonome. les instructions par défaut sont render, project ou runjosm.

Les autres paramètres sont des options pour JOSM. Il peut s'agir d'URL, de noms de fichiers, de coordonnées, de simples options et de paires option=valeur.

Les options pour le lancement de JOSM (runjosm) sont énumérées ci-dessous. En bas se trouvent les options pour les commandes render⤓ et project⤓.

utilisation :
	java -jar josm.jar [<command>] <options>...

commandes :
        runjosm     lancer JOSM (par défaut, exécuté lors qu’aucune instruction (command) n'est spécifiée)
        render      restituer les données et enregistrer le résultat dans un fichier image
        project     convertir les coordonnées d'un système de référence de coordonnées à un autre
        validate    valider les données

Pour plus de détails sur les commandes de rendu et de projet, exécutez-les avec l'option --help
Le reste de cette page d'aide documente les instructions d'exécution de josm.

options:
        --help|-h                                 Afficher cette aide
        --geometry=widthxheight(+|-)x(+|-)y       Paramètres de géométrie unix standards
        [--download=]minlat,minlon,maxlat,maxlon  Télécharger la zone délimitée
        [--download=]<URL>                        Télécharger l'emplacement à l'URL (avec lat=x&lon=y&zoom=z)
        [--download=]<filename>                   Ouvrir un fichier (tout type de fichier qui peut être ouvert avec Fichier/Ouvrir)
        --downloadgps=minlat,minlon,maxlat,maxlon Télécharger la zone délimitée en tant que GPS brut
        --downloadgps=<URL>                       Télécharger la position à l'URL en tant que GPS brut (avec lat=x&lon=y&zoom=z) 
        --selection=<searchstring>                Sélectionner avec la requête spécifiée
        --[no-]maximize                           Lancement en mode maximalisé
        --reset-preferences                       Réinitialiser les préférences par défaut

        --load-preferences=<url-to-xml>           Modification des préférences conformément au fichier XML

        --set=<key>=<value>                       Définir préférence de clé sur valeur

        --language=<language>                     Définir la langue

        --version                                 Affiche la version JOSM et quitte l'application

        --status-report                           Afficher un rapport d'état avec des informations utiles qui peuvent être jointes aux tickets de bogues

        --debug                                   Imprimer les informations de débogage sur la console

        --skip-plugins                            Ignorer les greffons de chargement

        --offline=<OSM_API|JOSM_WEBSITE|CACHE_UPDATES|CERTIFICATES|ALL>

                                                  Désactiver l'accès à la ou aux ressources indiquées, séparées par une virgule

	                                          <OSM API|JOSM website|Cache updates|Certificates|All>

La partie --download= de l'option de téléchargement est facultative. Les paramètres --download, --downloadgps et --selection sont traités dans cet ordre. La valeur <url-to-xml> peut pointer vers un fichier local avec file:relative/path/name.xml. Les éléments dans la valeur --offline sont séparés par des virgules.

Options Java (Java options)

Ils contrôlent la machine virtuelle Java ​(JVM)(en) et peuvent y définir des ​propriétés (en). JOSM lit certains d'entre elles directement, par exemple josm.home. D'autres comme user.language et user.country affectent les paramètres par défaut d#20647 – r17637e la JVM qui affectent aussi JOSM.

Options des propriétés système de Java :
    -Djosm.dir.name=JOSM                      Modifier le nom du répertoire JOSM
    -Djosm.pref=/PATH/TO/JOSM/PREF            Définir le répertoire des préférences
                                              Par défaut (Linux XDG) : /home/name/.config/JOSM
                                              Par défaut (Windows) : C:\Users\name\AppData\Roaming\JOSM
    -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Définir le répertoire des données utilisateur
                                              Par défaut (Linux XDG) : /home/name/.local/share/JOSM
                                              Par défaut (Windows) : C:\Users\name\AppData\Roaming\JOSM
    -Djosm.cache=/PATH/TO/JOSM/CACHE          Définir le répertoire du cache
                                              Par défaut (Linux XDG) : /home/name/.cache/JOSM
                                              Par défaut (Windows) : C:\Users\name\AppData\Local\JOSM\cache
    -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Définissez le répertoire commun pour les préférences.
                                              données utilisateur et ./cache/. Moins prioritaire.
                                              Sera écrasé par un réglage particulier.
    -Xmx...m                                  Définir la taille maximale de la pile Java en mégaoctets.
                                              Pourrait éviter les erreurs "Out-of-Memory".

L'option -Xmx...m peut être utile en cas d'erreurs de mémoire insuffisante (Out of Memory) (en). Si vous définissez un répertoire commun avec Djosm.home alors JOSM créera les sous-répertoires ./autosave, ./cache et ./validator. Si une des valeurs possède des espaces, mettez-la entre guillemets comme "josm dev".

Lorsque les caractères non ASCII de l'invite de commandes sont embrouillés, utilisez -Dfile.encoding=Cp850 pour recevoir le texte de Java dans une autre ​page de code (en). La ​page de code (en) utilisée affiche chcp⏎ dans le terminal. Pour l'UTF-8 sous Windows, lancez chcp 65001 dans la fenêtre du terminal de Windows avant de lancer JOSM en utilisant java -Dfile.encoding=UTF-8 -jar josm.jar

Le paquet Debian de JOSM josm-latest utilise -Djosm.dir.name=JOSM-latest pour offrir des installations parallèles dans les répertoires de base XDG.

Exemples pour les options de démarrage (runjosm) de JOSM et options Java

# Charger trois fichiers
  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
# Télécharger depuis OSM en fonction d'une URL avec un zoom et des coordonnées
  java -jar josm.jar https://www.openstreetmap.org/#map=18/51.501/-0.124
# Télécharger une zone de délimitée et sélectionner chaque élément correspondant à une chaîne de caractères.
  java -jar josm.jar 51.500,-0.126,51.502,-0.122 --selection="Big Ben"
#
# Définir le répertoire pour JOSM en fonction d'une des propriétés du système d'exploitation
  java -Djosm.pref=$XDG_CONFIG_HOME -jar josm.jar
# Citations pour une valeur avec des espaces et montrer l'interface graphique de JOSM en anglais
  java -Djosm.dir.name="josm dev" -jar josm.jar --language=en
# Définir le répertoire commun dans un sous-répertoire sous l'invite de commandes active
  java -Djosm.home=biketour2017/london -jar josm.jar
# Plus de mémoire et sans téléphoner à la maison
  java -Xmx1024m -set=message.notifier.enabled=false  -jar josm.jar
#
# Commencez dans un environnement anglais et enregistrez les informations de débogage ainsi que les messages de stderr
  java -Duser.language=en -jar josm.jar --debug 1>logfile.txt 2>&1

Options de Démarrage de Java Web Start (Run-options)

Les options de lancement sont lues par la commande javaws. Elles contrôlent le mécanisme Web Start et peuvent encapsuler les options Java et peut diagnostiquer Java.

# Control
  -offline                  Permet de démarrer Web Start JOSM sans accès à Internet

# Encapsuler
  -J<java option>           Fournit <java option> à JVM
  -J-Xmx1024m               Ici : Définir la taille maximale de la pile Java à 1024 mégaoctets

# Diagnostic
javaws -viewer            Affiche le visualiseur du cache dans le panneau de configuration Java
# Permet d'ouvrir le panneau de configuration de Java à partir de la ligne de commande.

javaws -clearcache        Supprime toutes les applications non installées du cache
# Équivalent à "Supprimer les fichiers et applications" dans les "Paramètres des fichiers temporaires" qui sont appelés.
# par le bouton "Paramètres" dans l'onglet "Général" du panneau de configuration Java.
# javaws -Xclearcache on OpenJDK

L'option de Démarrage -J prend sa part derrière la lettre J et fournit cela comme option Java. Le fichier jnlp (en) utilisé par ​Web Start offre un deuxième moyen de définir directement les ​options pour JRE et pour le programme JOSM.

La commande javaws a quelques options de contrôle sur tous les systèmes.

L'option -clearcache (vider le cache) et l'effacement du cache via le panneau de configuration Java suppriment, toutes les deux, du bureau les icônes basées sur JNLP. L'icône JOSM disparaîtra si elle a été placée à la suite d'un clic sur un fichier jnlp dans le navigateur Web.

Autres options

Le lanceur josm.exe alias ​Launch4j (uniquement sous MS Windows) peut donner quelques informations de débogage.

josm.exe --j4l-debug      Essaye d'écrire un launch4j.log dans le répertoire courant
josm.exe --j4l-dont-wait  Met fin à ses activités après avoir appelé JOSM. (Ends the wrapper after invoking JOSM).

Ligne de commande pour Render et Project

Paramètres du programme de rendu de JOSM

Utilisation :
	java -jar josm.jar render <options>

Description :
Restitue les données et enregistre le résultat dans un fichier image.

Options :
	--help|-h                 Affichage de cette aide
	--input|-i <file>         Nom du fichier (de données) d'entrée (.osm)
	--output|-o <file>        Nom du fichier (image) de sortie (.png); defaults to 'out.png'
	--style|-s <file>         Fichier de style (coloriage) à utiliser pour le rendu (.mapcss or .zip)
	                          Cette option peut être répétée pour charger plusieurs styles (coloriage).
	--setting <key>:<value>   Paramètres du style (accessibles dans JOSM dans la fenêtre de la liste des modèles par un clic droit sur le menu)
	                          S'applique au dernier style (coloriage) chargé avec l'option --style.
	--zoom|-z <lvl>           Sélectionne le niveau de zoom pour le rendu. (valeur entière, 0=terre entière, 18=niveau de la rue)
	--scale <scale>           Choisir l'échelle de la carte
	                          Une valeur de 10000 indique une échelle de 1:10000 (1 cm sur la carte équivaut à 100 m sur le terrain ; résolution d'affichage : 96 dpi)
	                          Les options --zoom et --scale sont mutuellement exclusives.
	--bounds|-b auto|<min_lon>,<min_lat>,<max_lon>,<max_lat>
	                          Zone à restituer, la valeur par défaut est 'auto'
	                          Avec le mot-clé 'auto', la zone téléchargée dans le fichier d'entrée .osm sera utilisée (si elle est enregistrée).
	--anchor <lon>,<lat>      Définit le coin inférieur gauche de la zone de rendu
	                          Utilisé en combinaison avec les options de largeur et de hauteur pour déterminer la zone à rendre.
	--width-m <number>        Largeur de la zone rendue, en mètre
	--height-m <number>       Hauteur de la zone rendue, en mètres
	--width-px <number>       Largeur de l'image cible, en pixels
	--height-px <number>      Hauteur de l'image cible, en pixels
	--projection <code>       Projection à utiliser, valeur par défaut 'epsg:3857' (web-Mercator)
	--max-image-size <number> Largeur/hauteur maximale de l'image en pixels ('0' signifie pas de limite), valeur par défaut : 20000

Pour définir la zone et l'échelle du rendu, les options peuvent être combinées de plusieurs façons :
  * --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)
Si ni 'bounds' ni 'anchor' ne sont indiqués, la valeur par défaut --bounds=auto entre en vigueur et les limites de la zone de téléchargement dans le fichier d'entrée .osm sont utilisées.

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

Paramètres du programme de projection (système de référence de coordonnées) JOSM

Utilisation :
	java -jar josm.jar project <options> <crs> +to <crs> [file]

Description :
Convertit les coordonnées d'un système de référence de coordonnées à un autre.

Options :
	--help|-h         Affiche cette aide
	-I                Intervertit l'entrée et la sortie crs
	-r                Change l'ordre d'entrée des coordonnées (est/nord, lon/lat) - (east/north, lon/lat)
	-s                Change l'ordre des coordonnées de sortie (est/nord, lon/lat) - (east/north, lon/lat)

<crs>:
Le format du système de référence des coordonnées d'entrée et de sortie est similaire à celui du logiciel PROJ.4.

[file]:
Lit les données d'entrée d'un ou plusieurs fichiers répertoriés comme arguments de position. Lors qu’aucun fichier n'est donné, ou que le nom du fichier est "-", les données sont lues à partir de l'entrée standard.

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

Voir également

• Résolution des problèmes Java
• Notes d'Installation
• Préférences - Vue d'ensemble des préférences
• La version originale de cette page en anglais

---

Retour à l'Aide principale