Context Navigation

Editing Help/Plugin/PicLayer

Adjust edit area height: Edit side-by-side

[[TranslatedPages]]
[[PageOutline(2-4,Table of content)]]

= Plugin -> PicLayer =

[[Image(/pluginicon/PicLayer.jar/images/layericon.png,link=,middle,48)]]

This plugin shows images as background in JOSM.

It offers two ways of loading the raster image data:
* from a file and
* from the clipboard.
This is an early version and is not end-user-proof, so please follow the steps exactly when using it.

Make sure the image is suitable, copyright-wise, if in doubt, don't use.

== Usages ==
1. Load some data from the server so the map is visible.
1. Move and zoom the [wikitr:/Help/MapView MapView] to the estimated target position of the new background image.
1. Click the **Imagery** menu and either choose **New picture layer from file** or **New picture layer from clipboard**.
 a. If you chose file, a file selector will pop-up. Pick the image you want. All formats supported by Java  (GIF with transparency) and furthermore ZIP as container and KML (#5451 experimental) are possible.
 a. If you chose clipboard, importing the image data may take some time.

If something failed, you should get a message box. If not - check the console for messages (Linux only?)

4. Once the image is visible you may start to position and calibrate it. For that - activate the !PicLayer layer with the image in the [wikitr:/Help/Dialog/LayerList Layers window].
1. Start aligning the image.
 a. Move the image by choosing 'Move' from the [wikitr:/Help/EditToolbar toolbar] and dragging the mouse around with left button pressed.
 a. Rotate the image by choosing 'Rotate' from the toolbar and drag.
 a. Scale the image by choosing 'Scale' from the toolbar and drag.
 a. You can also choose to scale in just one axis by selecting the proper button. \\ \\
1. If you need to reset your changes - you can use the context menu from the !PicLayer entry in the layer list.
1. If you want to save the calibration of the image, you can also do this using the popup menu.

This plugin is meant to help with mapping from aerial photos, similar to [https://mapwarper.net/ mapwarper.net].

== Converting calibration data in !PicLayer ==
For those interested in converting calibration data in !PicLayer: \\
* `INITIAL_SCALE` is the initial size of 100 image pixels (length of ruler in JOSM).
* `SCALEX/Y` is the factor after changing the size of the raster image relative to JOSM data layer.
* `INITIAL_POS_y/X` are the coordinates of the image center in mercator projection.
* `POSITION_X/Y` are the coordinates after shifting the raster image relative to JOSM data layer.
* `ANGLE` is the angle in degrees (clockwise -> positive) when the raster image is rotated.

* Mercator units are arc units in longitude (PI <-> 180).
* Latitude is a bit complicated because this projection preserves angles but not areas:
{{{
y = ln(tan(45+b/2))
}}}

where b is in degrees, ln is the natural logarithm and tan is the tangent.
* The longitude in degrees l is obtained from x via:
{{{
l = x*180/PI.
}}}

* The latitude b can be calculated from y by:
{{{
b = 2*arctan(e!**y) - 45
}}}
 (when inverse tangent returns degrees).

When transforming longitude degree differences of image corners to distance, you have to take into account that one degree east-west has different size dependent on latitude. \\
At equator 1 degree -> d0 = 111.321 km (from GRS 80 semi-major axes), at latitude b you get:
{{{
d = d0*cos(b)
}}}
(only exact for sphere, but deviation from ellipsoid < 0.5%).

== Using auto calibration action ==
This action helps you to position and calibrate an image (preferably a floor plan) into the world map.

**What do I need to use this action?** 
* an image, preferably a floor plan
* information about side length of building

**How do I start calibration?** 
* 1. open the image file and switch to the image layer so you can see the !PicLayer modes in the [wikitr:/Help/EditToolbar Edit Toolbar] on the left.
* 2. enter the "Calibrate Picture with outline" mode 
* 3. follow the window
* 3.1 select **Building Corner Point** (example in picture : edge points) 
* 3.2 enter **True Distances** - if you select the text field a green line will pop up and show you which distance on the image is required. Please enter the real distance in meter between the two points.
* 3.3 open the **Building Reference File** - open a .osm or .gpx file with coordinates of building outline or select a layer as reference
* 3.4 select **Building Reference Points**
  * 3.4.1 mode selection - if the building outline coordinates are already defined in layer, select **defined** mode (.osm files only), if you want to set the coordinates somewhere on layer, select **manual** mode
  * 3.4.2 select the same points as in step 3.1, now only on your real building outline (example in picture)
* 3.5 **run** calibration - **result**

Example: [osmwiki:../w/images/a/a8/Piclayer_auto_calibration.gif Piclayer_auto_calibration.gif]

**More information**
For more information about why do I need to insert distances and why the image usually does not fit exactly in the outline file, see [[osmwiki:JOSM/Plugins/PicLayer|PicLayer Page]].

== See also ==
* [osmwiki:JOSM/Plugins/PicLayer PicLayer page] at OSM wiki

----
Back to [wikitr:/Plugins#JOSMdocu Plugin Help] \\
Back to [wikitr:/Help Main Help]

Note: See WikiFormatting and TracWiki for help on editing wiki content.

Change information

Your email or username:

E-mail address and name can be saved in the Preferences

Comment about this change (optional):

Attachments (4)

set_edge_points.png (247.9 KB ) - added by rebsc 5 years ago.
select_distances.png (118.8 KB ) - added by rebsc 5 years ago.
select_ref_points.png (46.0 KB ) - added by rebsc 5 years ago.
final_cali.png (898.8 KB ) - added by rebsc 5 years ago.

Download all attachments as: .zip

Note: See TracWiki for help on using the wiki.