[[TranslatedPages]]

= Contourmerge Plugin =

[[Image(/pluginicon/contourmerge.jar/images/mapmode/contourmerge.png)]]

== Usage ==

=== Usage on areas ===

1. ''Enable mode, you will need to select ('''at least''') two points for every area (make sure you are editing areas, not [#Usageonways on ways])''
2. ''Use left mouse click to select point (icon: standard icon add node will appear); use left mouse click to deselect a point (icon with cross will indicate selected point)''
3. ''After all 4 points selected, you can pick one of 4 parts as ''source geometry'' to move. Hover mouse over part and you will (cursor: move with 4 arrows);''
4. ''After you started to drag ''source geometry'', you have one of two options in target geometry. Your ''source geometry'' will change it's shape to a ''target geometry'' shape after mouse hover and icon of a shortcut will be displayed.''
5. ''Contours will be merged. But if ''source geometry'' had only one segment left, it will be completely collaplsed''
6. ''You can repeat steps 2-6 as many times as you want until tool will disabled or there nothing left to merge''

Regular usage on the left and complete collapse of the source geometry on the right:

[[Image(ex1-merge-contour-with-another-countour-usage-on-areas.gif,nolink)]]
[[Image(ex3-merge-contour-with-another-countour-usage-on-areas.gif,nolink)]]

=== Usage with ways ===

Notes on source:
* tags on a way will be kept
* tags on nodes will be discarded
* geometry will be replaced

Notes on target:
* nothing is changed

[[Image(ex2-merge-contour-with-another-countour-usage-on-ways.gif,nolink)]]
[[Image(ex4-merge-contour-with-another-countour-usage-on-areas.gif,nolink)]]

= Old content below =
== In a nutshell ==

The {{{contourmerge}}} plugin helps you to align the contours of areas in JOSM.

[[Image(lake-and-forest.1.png,align=left, valign=top, margin-right=10)]]
Here's a typical example: a '''lake''' with a detailled shoreline and a '''forest'''. 

The contour of the forest should be aligned with the lakes shoreline. 

Select the {{{contourmege}}} map mode in the toolbar for map modes and perform the steps below.
{{{
#!html
<br clear="all"/>
}}}

=== Step 1 - Select the "cut-nodes" ===

[[Image(lake-and-forest.2.png, 160px, align=left, valign=top, margin-right=20)]]

* Select the part of the contour you want to merge, in both the areas for the lake and the forest. '''Left-Click''' on the respective nodes to mark them as selected.

{{{
#!html
<br clear="all"/>
}}}


=== Step 2 - Drag the source contour ===

[[Image(lake-and-forest.3.png, 160px, align=left, valign=top, margin-right=20)]]
* Drag the source contour between two "cut-nodes"

{{{
#!html
<br clear="all"/>
}}}
[[Image(lake-and-forest.4.png,160px, align=left, valign=top, margin-right=20)]]
* When you drag it over a possible target contour, the source contour is aligned with the target contour.

{{{
#!html
<br clear="all"/>
}}}

=== Step 3 - Align the contours ===
[[Image(lake-and-forest.5.png, 160px, align=left, valign=top, margin-right=20)]]
* Drop the source contour. The contours of the lake and the forest are merged.

If the merge doesn't happen as expected, reversing one of the ways helps.

{{{
#!html
<br clear="all"/>
}}}

----
Back to [wiki:/Plugins#JOSMdocu Plugin Help][[BR]]
Back to [wiki:/Help Main Help]