[[TranslatedPages]]

= Migrating From iD to JOSM =
== What is different ==
=== JOSM uses right mouse drag to pan a map ===
Unlike osm.org, most other editors and software, you have to hold right mouse click to navigate main a map in editing window.

=== Searching in presets ===

Text search accessible via {{{F3}}} key, [Help/Action/TaggingPresetSearch Search presets].

=== JOSM is also an offline editor ===
In simplest case, it is possible to {{{Ctrl+O}}} [Help/Action/Open Open file] and {{{Ctrl+S}}} [Help/Action/Save Save file] with temporary edits. But there [wiki:Shortcuts#Workflow many more tools].

== Background menu (B) ==

=== Background transparency ===

[Help/Dialog/LayerList#OpacityLayer You can set a opacity per each imagery layer] using "Adjust opacity" button.

=== Aerial imagery ===
* you have to enable Aerial imagery using [Help/Menu/Imagery Imagery menu] 
* additional sources can be installed via [Help/Preferences/Imagery Imagery tab in settings]

=== Fix alignment ===

Simplest alternative is to use [Help/Action/ImageryAdjust] or install a dedicated plugin for imagery offsets.

=== OpenStreetMap traces ===

Can be downloaded using [[Image(source:trunk/images/download.png,middle,link=)]] [wiki:Help/Action/Download from OSM] ''Keyboard shortcut:'' **{{{Ctrl+Shift+↓}}}**

== Map data menu (F) ==

=== Mapillary images and traffic signs ===

Images can be accesses via Mapillary plugin. (TODO: explain and add link here)

=== Local GPX file ===

Can be opened:
1. using "File > Open" (GPX file or its archived version)
2. simply drag and drop GPX file over running JOSM

=== Fill areas ===

1. Full fill: use [[Image(source:trunk/images/dialogs/mappaint/wireframe_small.svg,20,link=)]] ''Keyboard shortcut:'' '''{{{Ctrl+W}}}''' to toggle between wireframe and mappaint mode
2. Partial fill: no analogue?..
3. No Fill (Wireframe): use [[Image(source:trunk/images/dialogs/mappaint/wireframe_small.svg,20,link=)]] ''Keyboard shortcut:'' '''{{{Ctrl+W}}}''' to toggle between wireframe and mappaint mode

=== Map features ===

There no direct analogue, but functionality could be emulated using '''Filter dialog''' [[Image(source:/trunk/images/dialogs/filter.png)]] ''Keyboard shortcut:''''' {{{Alt+Shift+F}}}'''

[https://github.com/openstreetmap/iD/blob/c4fbacd6250c0245139207c183b3114dcefe2abd/js/id/renderer/features.js Relevant part of iD source code]. TODO: create a config for simpler re-use.

== Shortcuts ==

Unfortunately, [wiki:Shortcuts JOSM shortcuts] are different from [http://wiki.openstreetmap.org/wiki/ID/Shortcuts iD]. Here is some details:

|| '''Topic or iD function or a shortcut''' || '''Activation''' || '''comment''' || '''JOSM material''' ||
|| 1, "add point" || differ || exact analogue || {{{A+Shift}}}, [[Help/Action/Draw#Shiftmodifier]] || 
|| 1, "add point" || differ || similar tools || {{{Ctrl+D}}} [Help/Action/Duplicate Duplicate selected objects], {{{F3}}} [Help/Action/TaggingPresetSearch Search presets] || 
|| 2, "add line" || differ || exact analogue || {{{A}}} [[Help/Action/Draw]] || 
|| 3, "add area" || differ || similar tools || {{{A}}} [[Help/Action/Draw]] (in most cases, draw a closed way) or {{{Ctrl+B}}} [Action/CreateMultipolygon Create a multi-polygon] out of multiple ways || 
|| A, continue drawing a line at the selected node || same || exact analogue || {{{A}}} [[Help/Action/Draw#StandardMode]] || 
|| B (background layer switcher) || differ || exact analogue || [[Help/Menu/Imagery]] menu, and be configured in [[Help/Preferences/Imagery]] || 
|| C, combines the selected objects || differ || similar tools || [Help/Action/MergeNodes Merge Nodes] {{{M}}}, [Help/Action/CombineWay Combine Ways] {{{C}}}, [Help/Action/JoinNodeWay Join Node to Way] {{{J}}}, {{{Ctrl+B}}} [Action/CreateMultipolygon Create a multi-polygon] || 
|| D, unjoins the associated lines || differ || similar tools || {{{G}}} [Help/Action/UnGlue Unglue ways], there also tool for relations ||
|| Ctrl+C, copy the selected object || same || exact analogue || {{{Ctrl+C}}} [Help/Action/Copy copy the selected object] ||
|| Ctrl+V, paste a previously copied object || same || exact analogue || {{{Ctrl+V}}} [Help/Action/Paste Paste from buffer] ||
|| M, move objects || differ || exact analogue || {{{Shift+←}}}, {{{Shift+↑}}}, {{{Shift+→}}}, {{{Shift+↓}}} or simply [Help/Action/Select#Move using mouse drag] ||
|| O, circle || same || exact analogue || {{{O}}} [Help/Action/AlignInCircle Align nodes in circle] ||
|| R, rotate object || differ || exact analogue || {{{Shift+Ctrl+}}} mouse move to [Help/Action/Select#Rotate rotate objects] ||
|| S, straighten the selected line, or square the corners || differ || similar tools || {{{Q}}} [Help/Action/OrthogonalizeShape Orthogonalize Shape], {{{L}}} [Help/Action/AlignInLine Align nodes into a straight line], {{{X}}} [Help/Action/Extrude#Basicusage extrude tool], {{{A A}}} [Help/Action/Draw#Anglesnapping angle snapping mode] and [wiki:Help#JOSMtools several others] ||
|| H, show help || differ || exact analogue || {{{F1}}} [wiki:Help show help menu] ||
|| V, reverse ways || differ || exact analogue || {{{R}}} [Help/Action/ReverseWays Reverse Way] ||
|| W, toggle wireframe mode || differ || exact analogue || {{{Ctrl+W}}} [Help/Action/WireframeToggle Toggle between wireframe and mappaint mode] ||
|| Ctrl+Z || same || exact analogue || {{{Ctrl+Z}}} [Help/Action/Undo Undo] ||
|| Ctrl+Y || same || exact analogue || {{{Ctrl+Y}}} [Help/Action/Redo Redo] ||
|| Ctrl+S || differ || exact analogue || {{{Ctrl+Shift+↑}}} [Help/Action/Upload Upload] to main server ||
|| X, split line || differ || similar tools || {{{P}}} [Help/Action/SplitWay Split Way] is more restrictive, requires more actions ||
|| Ctrl + {{{+}}} || differ || similar tools || {{{Ctrl+J}}} [Help/Action/JumpToPosition Opens the Jump To Position dialog] or {{{Ctrl+L}}} [Help/Action/OpenLocation Open location] ||
|| Ctrl + {{{-}}} || differ || similar tools || {{{1}}} [Help/Action/ZoomToData Zoom to data], {{{2}}} [Help/Action/ZoomToLayer Zoom to layer], {{{3}}} [Help/Action/ZoomToSelection Zoom to selection] and [wiki:Shortcuts#Viewport others] ||
|| Ctrl+Delete or Ctrl+Backspace || differ || exact analogue || {{{Delete}}} [Help/Action/EditDelete Delete] ||
|| Alt+Mouse click || differ || exact analogue || {{{A+Ctrl}}} [Help/Action/Draw#Ctrlmodifier place node without connecting to existing object] ||
|| Shift+Mouse click || same || exact analogue || {{{Shift}}}+mouse click to [Help/Action/Select#Selectingmultipleobjects select multiple objects] ||
|| Shift+Mouse drag || differ || exact analogue || Simply draw a rectangle using mouse: [Help/Action/Select#Selectingmultipleobjects select multiple objects] ||
|| Escape stop drawing of a line or area || same || exact analogue || {{{Escape}}} also [Help/Action/UnselectAll unselect all] selected elements || 
|| /, toggle minimap || differ || exact analogue || [Help/Dialog/Minimap minimap] ||
|| +, zoom in || same || exact analogue || {{{+}}} [Help/Action/ZoomIn Zoom in], but there [wiki:Shortcuts#Viewport more tools] ||
|| -, zoom out || same || exact analogue || {{{-}}} [Help/Action/ZoomOut Zoom out], but there [wiki:Shortcuts#Viewport more tools] ||
|| {{{←}}}, {{{↑}}}, {{{→}}}, {{{↓}}} pan map || differ || similar tools || {{{Ctrl+←}}}, {{{Ctrl+↑}}}, {{{Ctrl+→}}}, {{{Ctrl+↓}}} move [Help/MapView viewport] ||
|| pan one screen at time: {{{Ctrl+←}}}, {{{Ctrl+↑}}}, {{{Ctrl+→}}}, {{{Ctrl+↓}}} or {{{Shift+←}}}, {{{Shift+↑}}}, {{{Shift+→}}}, {{{Shift+↓}}}  ||  || || ||

== Relations ==

=== Tools to edit relations ===
* [Action/CreateMultipolygon Create a multi-polygon] {{{Ctrl+B}}}
* [Help/Dialog/RelationList Relation List] toggle dialogue
* [Help/Dialog/RelationEditor Relation Editor] - main interface when editing a relation
* [http://wiki.openstreetmap.org/wiki/JOSM/Plugins/Relation_Toolbox relation toolbox plugin] (optional)

=== Multipolygon relations ===

One day you will encounter [http://wiki.openstreetmap.org/wiki/Relation:multipolygon multipolygons]. Please don't be afraid of this big page, there [http://wiki.openstreetmap.org/wiki/Multipolygon_Examples slightly outdated guide (ignore tagging) with decent illustrations].