Cette page est incomplète. L'aide et les options pour les commandes de rendu et de projet sont manquantes.

Options en ligne de commande

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

• Les paramètres du programme 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).
• Seules les options de Démarrage (run-options) sont disponibles dans Web Start.
• Quelques autres options pour le diagnostic et les dispositifs de lancement.

# Exécution d'un jar
java [Java options] -jar josm-tested.jar [Program arguments]

# Lancement de Web Start
javaws [run-options] -J[Java option] josm.jnlp

Le rapport d'État énumère les paramètres du programme (Program arguments) et les options Java donnés dans sa deuxième section. Quelques exemples pour les deux cas sont présentés ci-dessous. Comme d'habitude dans les quatre types, les paramètres sont séparés les uns des autres par des espaces.

Paramètres du programme (Program arguments)

Le premier argument peut être une instruction permettant à JOSM de le rendre autonome. Si JOSM ne peut pas reconnaître le premier argument comme une instruction, alors runjosm est supposé etre l'instruction par défaut.

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. La liste complète des instructions et des options est présentée ci-dessous :

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

commands:
  runjosm     lancer JOSM (par défaut, exécuté lorsqu'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

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échargez l'URL de l'emplacement qui a
                                                           des coordonnées du type lat=x&lon=y&zoom=z
  [--download=]<filename>                                  Ouvrir un fichier (comme Menu/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 en tant que GPS brut
  --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>                          Importer les préférences à partir d'un 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
  --debug     or   --trace                                 Imprimer les messages de débogage vers la console
  --skip-plugins                                           Ignorer les greffons de chargement
  --offline=[osm_api,][josm_website,][certificates,][all]  Désactiver l'accès aux ressources de la liste.

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 de la JVM qui affectent aussi JOSM.

java options:
  -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 : C:\Users\name\AppData\Roaming\JOSM
  -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Définir le répertoire des données utilisateur
                                            Par défaut : /home/name/.local/share/JOSM
  -Djosm.cache=/PATH/TO/JOSM/CACHE          Définir le répertoire du cache
                                            Par défaut : <...>
  -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Définissez le répertoire commun pour les préférences.
                                            user data and ./cache/. Lower precedence.
                                            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-tested.jar

Exemples

# Charger trois fichiers
  java -jar josm-tested.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-tested.jar https://www.openstreetmap.org/#map=19/51.51/-0.135
# Télécharger une zone de délimitation et sélectionner chaque élément correspondant à une chaîne de caractères.
  java -jar josm-tested.jar 51.505,-0.14,51.515,-0.13 --selection="Piccadilly Circus"
#
# 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-tested.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-latest.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-tested.jar
# Plus de mémoire dans la variante canadienne dans un environnement anglophone
  java -Xmx1024m -Duser.language=en -Duser.country=CA -jar josm-latest.jar
#
# Log debug info and do not get disturbed by JOSM phoning home
  java -verbose -jar josm-latest.jar --set=message.notifier.enabled=false --debug >WhatsUp.txt

Options de Démarrage (Run-options)

Les options de lancement sont utilisées par la commande javaws. Ils contrôlent le mécanisme Web Start et peuvent encapsuler les options Java.

  -offline                  Permet de démarrer Web Start JOSM sans accès à Internet
  -J<java option>           Fournit <java option> à JVM 
  -J-Xmx1024m               Ici : Définir la taille maximale de la pile Java à 1024 mégaoctets

L'option de Démarrage -J prend sa part derrière la lettre J et fournit cela comme option Java. The jnlp-File (en) used by ​Web Start offers a second way to ​set options for JRE and for the JOSM program directly.

Autres options

La commande javaws a quelques options de contrôle sur tous les systèmes. Sous MS Windows, seul le lanceur josm.exe dit Launch4j peut donner des informations de débogage (nécessite Java 64-bit sur Windows 64-bit).

# Options de commande :
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


# Avec MS Windows :
josm.exe --j4l-debug      Essaye d'écrire un launch4j.log dans le répertoire courant
josm.exe --j4l-dont-wait  Ends the wrapper after invoking JOSM.

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

Voir également

• Résolution des problèmes Java
• Notes d'Installation
• Préférences - Vue d'ensemble des préférences

---

Retour à l'Aide principale