wiki:Eo:Help/CommandLineOptions

Komandliniaj Opcioj

Kvar tipoj de komandliniaj opcioj efikas al JOSM:

# Rulante jar-dosieron
java [Java-opcioj] -jar josm.jar [Programaj argumentoj]

# Lanĉi Web Start
javaws [Run-opcioj] -J[Java-opcio] josm.jnlp

La Statusa Raporto el la Helpa menuo listigas la donitajn Programajn argumentojn kaj Java-opciojn. Kelkaj ekzemploj⤓ por ambaŭ estas montritaj sube.

Noto: La termino josm.jar estas komuna mallongigo por la dosiernomoj josm-tested.jar kaj josm-latest.jar. La termino josm.jnlp ankaŭ reprezentas josm-latest.jnlp. Kiel kutime, la komandliniaj argumentoj estas apartigitaj per spaco unu de la alia.

Programaj argumentoj por JOSM

La unua argumento povas esti komando por JOSM por igi ĝin labori aŭtonome. La komandoj estas render, projectrunjosm kiel defaŭlto.

La ceteraj argumentoj estas opcioj por JOSM. Ili povas esti URL-oj, dosiernomoj, koordinatoj, simplaj opcioj kaj opcio=valoro-paroj.

La opcioj por runjosm estas listigitaj sube. Ĉe la fundo estas la opcioj por la komandoj render⤓ kaj project⤓.

uzo:
	java -jar josm.jar [<komando>] <opcioj>...

komandoj:
	runjosm     lanĉi JOSM (defaŭlto, efektivigita kiam neniu komando estas specifita)
	render      bildigi datumojn kaj konservi la rezulton al bilda dosiero
	project     konverti koordinatojn de unu koordinata referenca sistemo al alia
	validate    validigi datumojn

Por detaloj pri la render kaj project komandoj, rulu ilin kun la --help opcio.
La cetero de ĉi tiu helpa paĝo dokumentas la runjosm komandon.

opcioj:
	--help|-h                                 Montri ĉi tiun helpon
	--geometry=widthxheight(+|-)x(+|-)y       Norma unix geometria argumento
	[--download=]minlat,minlon,maxlat,maxlon  Elŝuti la limigan skatolon
	[--download=]<URL>                        Elŝuti la lokon ĉe la URL (kun lat=x&lon=y&zoom=z)
	[--download=]<filename>                   Malfermi dosieron (iu ajn dosiertipo kiu povas esti malfermita per Dosiero/Malfermi)
	--downloadgps=minlat,minlon,maxlat,maxlon Elŝuti la limigan skatolon kiel kruda GPS
	--downloadgps=<URL>                       Elŝuti la lokon ĉe la URL (kun lat=x&lon=y&zoom=z) kiel kruda GPS
	--selection=<searchstring>                Elekti kun la donita serĉo
	--[no-]maximize                           Lanĉi en maksimumigita reĝimo
	--reset-preferences                       Restarigi la preferojn al defaŭlto

	--load-preferences=<url-to-xml>           Ŝanĝi preferojn laŭ la XML-dosiero

	--set=<key>=<value>                       Agordi preferan ŝlosilon al valoro

	--language=<language>                     Agordi la lingvon

	--version                                 Montri la version de JOSM kaj eliri

	--status-report                           Montri statusan raporton kun utilaj informoj kiuj povas esti aldonitaj al cimoj

	--debug                                   Printi sencimigajn mesaĝojn al konzolo

	--skip-plugins                            Ignori ŝargi kromprogramojn

	--offline=<OSM_API|JOSM_WEBSITE|CACHE_UPDATES|CERTIFICATES|ALL>
	                                          Malaktivigi aliron al la donita(j) rimedo(j), apartigitaj per komo
	                                          <OSM API|JOSM retejo|Kaŝmemoraj ĝisdatigoj|Atestiloj|Ĉio>

La --download= parto de la elŝuta opcio estas nedeviga. La argumentoj --download, --downloadgps kaj --selection estas prilaboritaj en ĉi tiu ordo. La valoro <url-to-xml> povas indiki lokan dosieron kun file:relative/path/name.xml. La eroj en la --offline valoro estas apartigitaj per komo.

Java-opcioj

Ili kontrolas la Java virtualan maŝinon (JVM) kaj povas agordi propraĵojn ene de ĝi. JOSM legas kelkajn el ili rekte, ekzemple josm.home. Aliaj kiel user.language kaj user.country efikas al la defaŭltaj agordoj de la JVM kiuj ankaŭ efikas al JOSM.

Java sistemaj propraĵaj opcioj:
    -Djosm.dir.name=JOSM                      Ŝanĝi la JOSM dosierujnomon
    -Djosm.pref=/PATH/TO/JOSM/PREF            Agordi la preferan dosierujon
                                              Defaŭlto (Linux XDG): /home/name/.config/JOSM
                                              Defaŭlto (Windows): C:\Users\name\AppData\Roaming\JOSM
    -Djosm.userdata=/PATH/TO/JOSM/USERDATA    Agordi la uzantan datumdosierujon
                                              Defaŭlto (Linux XDG): /home/name/.local/share/JOSM
                                              Defaŭlto (Windows): C:\Users\name\AppData\Roaming\JOSM
    -Djosm.cache=/PATH/TO/JOSM/CACHE          Agordi la kaŝmemoran dosierujon
                                              Defaŭlto (Linux XDG): /home/name/.cache/JOSM
                                              Defaŭlto (Windows): C:\Users\name\AppData\Local\JOSM\cache
    -Djosm.home=/PATH/TO/JOSM/HOMEDIR         Agordi la komunan dosierujon por preferoj,
                                              uzantaj datumoj kaj ./cache/. Malpli alta prioritato.
                                              Estos anstataŭigita de specifa agordo.
    -Xmx...m                                  Agordi maksimuman Java-amasgrandon en megabajtoj.
                                              Povas eviti Erarojn pri Memormanko.

La -Xmx...m opcio povas esti utila kiam Memormanko eraroj okazas. Se vi agordas komunan dosierujon kun Djosm.home tiam JOSM kreos la subdosierujojn ./autosave, ./cache kaj ./validator. Se valoro havas spacojn, tiam enfermu ĝin en citiloj kiel "josm dev".

Kiam la ne-ASCII signoj en la komandlinio estas fuŝitaj, uzu -Dfile.encoding=Cp850 por ricevi tekston de Java en alia kodpaĝo. Kiun kodpaĝon estas uzata montras chcp⏎ en la terminalo. Por UTF-8 en Windows, invoku chcp 65001 en la Windows terminala fenestro antaŭ ol lanĉi JOSM uzante java -Dfile.encoding=UTF-8 -jar josm.jar

JOSMs Debian-pakaĵo josm-latest uzas -Djosm.dir.name=JOSM-latest por proponi paralelajn instalaĵojn en la XDG-bazaj dosierujoj.

Ekzemploj por JOSM runjosm opcioj kaj Java-opcioj

# Ŝargi tri dosierojn
  java -jar josm.jar track1.gpx BigBen.jpg "london data.osm"
# Elŝuti de OSM laŭ URL kun zomo kaj koordinatoj
  java -jar josm.jar https://www.openstreetmap.org/#map=18/51.501/-0.124
# Elŝuti limigan skatolon kaj elekti ĉiun elementon kongruantan kun ĉeno
  java -jar josm.jar 51.500,-0.126,51.502,-0.122 --selection="Big Ben"
#
# Agordi dosierujon por JOSM laŭ propraĵo de la operaciumo
  java -Djosm.pref=$XDG_CONFIG_HOME -jar josm.jar
# Citiloj por valoro kun spaco kaj montri JOSM GUI en la angla
  java -Djosm.dir.name="josm dev" -jar josm.jar --language=en
# Agordi la komunan dosierujon en sub-subdosierujo sub la aktiva komandlinio
  java -Djosm.home=biketour2017/london -jar josm.jar
# Pli da memoro kaj sen telefoni hejmen
  java -Xmx1024m --set=message.notifier.enabled=false  -jar josm.jar
#
# Komenci en angla medio kaj enskribi sencimigajn informojn plus mesaĝojn de stderr
  java -Duser.language=en -jar josm.jar --debug 1>logfile.txt 2>&1

Run-opcioj por Java Web Start

La run-opcioj estas legataj de la javaws komando. Ili kontrolas la Web Start mekanismon, povas enkapsuli Java-opciojn kaj povas diagnozi Java.

# Kontrolo
  -offline                  Permesas Web Start JOSM sen interreta aliro

# Enkapsuli
  -J<java opcio>            Provizas la <java opcion> al la JVM
  -J-Xmx1024m               Ĉi tie: Agordi maksimuman Java-amasgrandon al 1024 megabajtoj

# Diagnozo
javaws -viewer            Montras la Kaŝmemoran Rigardilon en la Java Kontrolpanelo
# Permesas malfermi la Java Kontrolpanelon de la komandlinio.

javaws -clearcache        Forigas ĉiujn ne-instalitajn aplikaĵojn el la kaŝmemoro
# Egala al 'Forigi Dosierojn kaj Aplikaĵojn' el la 'Provizoraj Dosieragordoj' invokitaj
# per la 'Agordoj' butono en la 'Ĝenerala' langeto de la Java Kontrolpanelo.
# javaws -Xclearcache en OpenJDK

La -J run-opcio prenas sian parton post la J litero kaj provizas tion kiel Java-opcion. La jnlp-Dosiero (en) uzata de Web Start ofertas duan vojon por agordi opciojn por JRE kaj por la JOSM programo rekte.

La javaws komando havas kelkajn kontrolopciojn sur ĉiuj sistemoj.

La -clearcache opcio kaj malplenigo de la kaŝmemoro per la Java Kontrolpanelo ambaŭ forigos JNLP-bazitajn ikonojn de la labortablo. La JOSM ikono malaperos se ĝi estis metita kiel rezulto de klako en retumilo sur jnlp-dosiero.

Aliaj opcioj

La Lanĉilo josm.exe aka Launch4j (nur en MS Windows) povas doni kelkajn sencimigajn informojn.

josm.exe --j4l-debug      Provas skribi launch4j.log en la aktuala dosierujo
josm.exe --j4l-dont-wait  Finas la envolvaĵon post invoki JOSM.

Komandlinio por Render kaj Project

JOSM bildigaj Programaj argumentoj

Uzo:
	java -jar josm.jar render <opcioj>

Priskribo:
Bildigas datumojn kaj konservas la rezulton al bilda dosiero.

Opcioj:
	--help|-h                 Montri ĉi tiun helpon
	--input|-i <file>         Eniga datumdosiernomo (.osm)
	--output|-o <file>        Eliga bilddosiernomo (.png); defaŭlto estas 'out.png'
	--style|-s <file>         Stila dosiero por uzi por bildigo (.mapcss aŭ .zip)
	                          Ĉi tiu opcio povas esti ripetita por ŝargi multajn stilojn.
	--setting <key>:<value>   Stila agordo (en JOSM alirebla en la stila listo dialogo dekstraklika menuo)
	                          Aplikiĝas al la lasta stilo ŝargita per la --style opcio.
	--zoom|-z <lvl>           Elekti zoman nivelon por bildigi. (entjera valoro, 0=tuta tero, 18=strata nivelo)
	--scale <scale>           Elekti la mapan skalon
	                          Valoro de 10000 signifas skalon de 1:10000 (1 cm sur la mapo egalas 100 m sur la tero; montra rezolucio: 96 dpi)
	                          Opcioj --zoom kaj --scale estas reciproke ekskluzivaj.
	--bounds|-b auto|<min_lon>,<min_lat>,<max_lon>,<max_lat>
	                          Areo por bildigi, defaŭlta valoro estas 'auto'
	                          Kun ŝlosilvorto 'auto', la elŝutita areo en la .osm eniga dosiero estos uzata (se registrita).
	--anchor <lon>,<lat>      Specifi la malsupran maldekstran angulon de la bildiga areo
	                          Uzata kombinita kun larĝo kaj alto opcioj por determini la areon por bildigi.
	--width-m <number>        Larĝo de la bildigita areo, en metroj
	--height-m <number>       Alto de la bildigita areo, en metroj
	--width-px <number>       Larĝo de la cela bildo, en rastrumeroj
	--height-px <number>      Alto de la cela bildo, en rastrumeroj
	--projection <code>       Projekcio por uzi, defaŭlta valoro 'epsg:3857' (reto-Merkatoro)
	--max-image-size <number> Maksimuma bilda larĝo/alto en rastrumeroj ('0' signifas sen limo), defaŭlta valoro: 20000

Por specifi la bildigitan areon kaj skalon, la opcioj povas esti kombinitaj en diversaj manieroj:
  * --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)
Se nek 'bounds' nek 'anchor' estas donita, la defaŭlta valoro --bounds=auto efikas kaj la limoj de la elŝuta areo en la .osm eniga dosiero estas uzataj.

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

JOSM projekciaj Programaj argumentoj

Uzo:
	java -jar josm.jar project <opcioj> <crs> +to <crs> [file]

Priskribo:
Konvertas koordinatojn de unu koordinata referenca sistemo al alia.

Opcioj:
	--help|-h         Montri ĉi tiun helpon
	-I                Ŝanĝi enigan kaj eligan crs
	-r                Ŝanĝi ordon de enigaj koordinatoj (oriento/nordo, lon/lat)
	-s                Ŝanĝi ordon de eligaj koordinatoj (oriento/nordo, lon/lat)

<crs>:
La formato por eniga kaj eliga koordinata referenca sistemo estas simila al tiu de la PROJ.4 programaro.

[file]:
Legas enigajn datumojn de unu aŭ pli da dosieroj listigitaj kiel poziciaj argumentoj. Kiam neniu dosiero estas donita, aŭ la dosiernomo estas "-", datumoj estas legataj de norma enigo.

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

Vidu ankaŭ


Reen al Ĉefa Helpo

Last modified 4 months ago Last modified on 2025-03-03T04:49:52+01:00
Note: See TracWiki for help on using the wiki.