Параметры командной строки

JOSM управляется тремя группами параметров командной строки. Наиболее важны аргументы программы, затем опции Java. Только на Web Start влияют опции запуска. См. примеры

# Запуск jar
java [опции Java] -jar josm-tested.jar [аргументы программы]

# Запуск через Web Start
javaws [опции запуска] -J[опции Java] josm.jnlp

Аргументы программы

Также именуются аргументами после jar здесь или args в документации Oracle.

Первый аргумент воспринимается JOSM как команда. Возможные команды: runjosm для обычного запуска (по умолчанию), render для генерации файла изображения и project для преобразования координат. Если JOSM не может распознать команду, он выполняет команду, используемую по умолчанию.

Следующие аргументы — это опции для JOSM. Они разделяются пробелами. Это могут быть URLы, имена файлов, координаты, простые опции и пары опция=аргумент. Полный список команд и опций показан ниже:

Использование:
  java <опции java> -jar josm.jar [<команда>] <опции>

Команды:
  runjosm     запустить JOSM (по умолчанию, выполняется, если никакой команды не указано)
  render      выполнить отрисовку данных и сохранить результат в файл изображения
  project     преобразовать координаты из одной системы координат в другую

Для более подробных сведений о командах render и project запустите их с опцией --help.
Остаток этой страницы документирует команду runjosm.

Опции:
  --help|-h                                 Показать эту справку
  --geometry=widthxheight(+|-)x(+|-)y       Стандартный аргумент unix geometry
  [--download=]minlat,minlon,maxlat,maxlon  Скачать данные в указанной области
  [--download=]<URL>                        Скачать область по URL, содержащему
                                            координаты наподобие lat=x&lon=y&zoom=z
  [--download=]<имя файла>                  Открыть файл (то же, что и меню Файл/Открыть)
  --downloadgps=minlat,minlon,maxlat,maxlon Скачать указанную область, как "сырой" GPS
  --downloadgps=<URL>                       Скачать по URL, как "сырой" GPS
  --selection=<строка поиска>               Выделить объекты по результатам заданного поиска
  --[no-]maximize                           Запустить JOSM развёрнутым во весь экран
  --reset-preferences                       Сбросить настройки к значениям по умолчанию
  --load-preferences=<url-to-xml>           Импортировать настройки из XML-файла
  --set=<key>=<value>                       Присвоить настройке key значение value
  --language=<язык>                         Задать язык интерфейса
  --version                                 Показать версию JOSM и выйти
  --debug                                   Выводить отладочные сообщения в консоль
  --skip-plugins                            Пропустить загрузку модулей
  --offline=[osm_api,][josm_website,][all]  Отключить доступ к указанным ресурсам

Часть --download= опции download является не обязательной. Аргументы --download, --downloadgps и --selection обрабатываются именно в таком порядке, как перечислены здесь. Значение <url-to-xml> может указывать на локальный файл file:relative/path/name.xml. Элементы значения --offline разделяются запятыми.

Опции Java

Опции Java именуются также опциями JOSM JVM здесь или аргументами VM в отчёте о состоянии. В этом отчёте можно увидеть их, а также аргументы программы. Они управляют виртуальной машиной Java ​(JVM) и могут задавать ​свойства внутри неё. JOSM читает некоторые из них, например josm.home и user.language.

Опции Java:
  -Djosm.dir.name=JOSM                      Изменить имя каталога JOSM
  -Djosm.pref=/PATH/TO/JOSM/PREF            Задать каталог настроек
                                            По умолчанию: C:\Users\name\AppData\Roaming\JOSM
  -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Задать каталог пользовательских данных
                                            По умолчанию: /home/name/.local/share/JOSM
  -Djosm.cache=/PATH/TO/JOSM/CACHE          Задать каталог кэша
                                            По умолчанию: <...>
  -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Задать общий каталог для настроек, пользовательских
                                            данных и ./кэша/. Эта опция имеет более низкий приоритет
                                            и будет перекрываться вышеуказанными опциями.
  -Xmx...m                                  Задать максимальный размер кучи Java (heap) в мегабайтах.
                                            Позволяет избежать ошибок о недостаточности памяти.

Опция -Xmx...m может быть полезна при возникновении ошибок «не хватает памяти». Если вы укажете общий каталог опцией Djosm.home, то JOSM создаст подкаталоги ./autosave, ./cache и ./validator. Если значение содержит пробелы, заключите их в кавычки, вот так: "josm dev".

Опции запуска

Опции запуска следуют за командой javaws. Они управляют механизмом Web Start и средой для JVM.

  -offline                  Позволяют выполнить Web Start JOSM без доступа к Интернету
  -J<опции java>            Передаёт <опции java> в JVM 
  -J-Xmx1024m               Здесь: задать максимальный размер кучи Java равным 1024 МБ

Опция -J берёт свою часть после буквы J и передаёт её в качестве опций Java. Файл .jnlp, используемый ​Web Start, предлагает и другой способ ​задать опции для JRE и непосредственно на программы JOSM.

Примеры

# Загрузить три файла
  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
# Скачать с OSM по URL с масштабом и координатами
  java -jar josm.jar https://www.openstreetmap.org/#map=19/51.51/-0.135
# Скачать область и выделить все элементы, совпадающие со строкой
  java -jar josm.jar 51.505,-0.14,51.515,-0.13 --selection="Piccadilly Circus"
#
# Задать каталог для JOSM согласно переменной окружения из операционной системы
  java -Djosm.pref=$XDG_CONFIG_HOME jar josm.jar
# Кавычки для значения с пробелом
  java -Djosm.dir.name="josm dev" -jar josm.jar
# Задать общий каталог в подкаталоге
  java -Djosm.home=biketour2017/london -jar josm.jar
# Больше памяти в среде с французским интерфейсом
  java -Xmx1024m -Duser.language=fr -jar josm.jar
#
# Журналировать всё происходящее на английском
  java -verbose  -jar josm-latest.jar --language=en --debug >WhatsUp.txt

Смотрите также

• Решение проблем с Java
• Примечания по установке
• Настройки - обзорная страница обо всех настройках