Skip to content

Commit

Permalink
update README
Browse files Browse the repository at this point in the history
  • Loading branch information
yunica committed Nov 10, 2022
1 parent ac5fdb5 commit a1a0a34
Showing 1 changed file with 25 additions and 22 deletions.
47 changes: 25 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,23 +3,26 @@
Plugin created for the [JOSM](https://josm.openstreetmap.de/), allows you to select areas to label using a range of
colors, it is also possible to add areas and subtract selected areas.

![Peek 2022-09-22 16-27](https://user-images.githubusercontent.com/12978932/191855039-685b9420-0e55-4883-a466-4ff85d860bac.gif)
![Peek 2022-11-09 16-53](https://user-images.githubusercontent.com/12978932/200950045-179c72d5-600c-4012-b2a4-3ceb1345ea25.gif)

## Installation

1. Search the plugin ( magic wand).
1. Search the magic wand plugin.

![image](https://user-images.githubusercontent.com/12978932/200428835-a652ef65-f895-4acd-a19a-bef3e7a8175a.png)

2. Wait to download the plugin, sometimes it takes a few minutes, because the plugin is 100 MB in size.

![image](https://user-images.githubusercontent.com/12978932/200429273-ce2e2d4d-8839-46ce-ba47-a620e3984b17.png)

3. Confirmation window.

![image](https://user-images.githubusercontent.com/12978932/200429366-c8566cb9-d842-4efe-b810-151b68f86fc3.png)
![image](https://user-images.githubusercontent.com/12978932/200431510-a414f03f-c285-4217-adf0-d9d91d41d47f.png)

## Usage

Josm Magic Wand plugin it has two modes of execution: **generate** and **merge** geometries.
JOSM Magic Wand plugin it has two modes of execution: **generate** and **merge** geometries.

### Generate geometries.

Expand All @@ -31,19 +34,19 @@ To generate geometries, you must have a base map activated and a data layer.
cursor ![image](https://user-images.githubusercontent.com/12978932/191858042-942aa381-3c4b-42bf-b9df-b23782d1dce5.png)
.
- Click on the area.
- `Ctrl + 2` to generate the geometry.
- `ctrl + 2` to generate the geometry.

- To add or enhance the selection, you can press the `Ctrl` button and `click` on new area.
- To add or enhance the selection, you can press the `ctrl` button and `click` on new area.
- To subtract the selection, you can press the `switch` button and `click` on area.

### Merge geometries

this functionality allows you to merge several geometries into one, the geometries must intersects.
This functionality allows you to merge several geometries into one, the geometries must intersects.

![Peek 2022-09-22 22-44](https://user-images.githubusercontent.com/12978932/191888528-ea2105bc-7994-40e0-95bd-9d6c87c97631.gif)

- Select one or more geometries.
- Press `Ctrl + 3`.
- Press `ctrl + 3`.

## Requirements

Expand All @@ -52,7 +55,7 @@ this functionality allows you to merge several geometries into one, the geometri

## Extra options

![image](https://user-images.githubusercontent.com/12978932/191889354-4b67612b-b3c4-454c-89b4-1397b6cb813b.png)
![image](https://user-images.githubusercontent.com/12978932/200949130-5c4bdea3-cccb-4865-987a-5d15013089d7.png)

1. Select mode.
2. Open window.
Expand All @@ -61,21 +64,21 @@ this functionality allows you to merge several geometries into one, the geometri
## Use cases
### Cases where it works well

| Image | Description |
|------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------|
| ![image](https://user-images.githubusercontent.com/12978932/200626354-cfe0ab0b-5490-4abf-9e0d-0e30bf57abf7.png) | the edge of the lake has borders marked with the path |
| ![image](https://user-images.githubusercontent.com/12978932/200627390-ddd26531-cfe7-47c8-bf16-8e7a64ce3f60.png) | the edge of the lake and the farm have marked borders |
| ![image](https://user-images.githubusercontent.com/12978932/200627737-04ec310a-2499-4a2d-8b33-c112e6926cdf.png) | uniform color and sharp edges (contrast) |
| ![image](https://user-images.githubusercontent.com/12978932/200628149-7e536725-369b-42aa-8309-d7cd37a73baa.png) | uniform color and sharp edges (contrast) |
| ![image](https://user-images.githubusercontent.com/12978932/200628412-756285de-581f-4369-8e81-f94c8f2f6da5.png) | uniform color and sharp edges (contrast) |
| ![image](https://user-images.githubusercontent.com/12978932/200628944-2c2143ec-a7e0-4b87-a507-41ad069e4d39.png) | uniform color and sharp edges (contrast) |
| Image | Description |
|------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------|
| ![image](https://user-images.githubusercontent.com/12978932/200626354-cfe0ab0b-5490-4abf-9e0d-0e30bf57abf7.png) | The edge of the lake has borders marked with the path. |
| ![image](https://user-images.githubusercontent.com/12978932/200627390-ddd26531-cfe7-47c8-bf16-8e7a64ce3f60.png) | The edge of the lake and the farm have marked borders. |
| ![image](https://user-images.githubusercontent.com/12978932/200627737-04ec310a-2499-4a2d-8b33-c112e6926cdf.png) | Uniform color and sharp edges (contrast). |
| ![image](https://user-images.githubusercontent.com/12978932/200628149-7e536725-369b-42aa-8309-d7cd37a73baa.png) | Uniform color and sharp edges (contrast). |
| ![image](https://user-images.githubusercontent.com/12978932/200628412-756285de-581f-4369-8e81-f94c8f2f6da5.png) | Uniform color and sharp edges (contrast). |
| ![image](https://user-images.githubusercontent.com/12978932/200628944-2c2143ec-a7e0-4b87-a507-41ad069e4d39.png) | Uniform color and sharp edges (contrast). |



### cases where it doesn't work well
### Cases where it doesn't work well

| Image | Description |
|------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------|
| ![image](https://user-images.githubusercontent.com/12978932/200629118-48fa92ef-60a3-4d8a-b807-917c9dd95b8c.png) | the two farms are separated by a very thin path of similar color |
| ![image](https://user-images.githubusercontent.com/12978932/200629404-9b9a48f5-4c9d-483e-9f8d-1a7499f51659.png) | parts of the farm and the border have similar colors with the rest |
| ![image](https://user-images.githubusercontent.com/12978932/200644356-09bbca8e-833c-49f8-9427-cb2c4de7a223.png) | the borders of the farm with the road and the other farm have similar colors |
| Image | Description |
|------------------------------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------|
| ![image](https://user-images.githubusercontent.com/12978932/200629118-48fa92ef-60a3-4d8a-b807-917c9dd95b8c.png) | The two farms are separated by a very thin path of similar color. |
| ![image](https://user-images.githubusercontent.com/12978932/200629404-9b9a48f5-4c9d-483e-9f8d-1a7499f51659.png) | Parts of the farm and the border have similar colors with the rest. |
| ![image](https://user-images.githubusercontent.com/12978932/200644356-09bbca8e-833c-49f8-9427-cb2c4de7a223.png) | The borders of the farm with the road and the other farm have similar colors. |

0 comments on commit a1a0a34

Please sign in to comment.