Changes between Version 18 and Version 24 of Help/Plugin/PicLayer


Ignore:
Timestamp:
(multiple changes)
Author:
(multiple changes)
Comment:
(multiple changes)

Legend:

Unmodified
Added
Removed
Modified
  • Help/Plugin/PicLayer

    v18 v24  
    11[[TranslatedPages]]
     2[[PageOutline(2-4,Table of content)]]
    23
    34= Plugin -> PicLayer =
    45
    5 [[Image(/pluginicon/PicLayer.jar/images/layericon.png,32)]]
     6[[Image(/pluginicon/PicLayer.jar/images/layericon.png,link=,middle,48)]]
    67
    78This plugin shows images as background in JOSM.
    89
    910It offers two ways of loading the raster image data:
    10 - from a file and
    11 - from the clipboard.
     11* from a file and
     12* from the clipboard.
    1213This is an early version and is not end-user-proof, so please follow the steps exactly when using it.
    1314
    1415Make sure the image is suitable, copyright-wise, if in doubt, don't use.
    1516
     17
    1618== Usages ==
    17191. Load some data from the server so the map is visible.
    18201. Move and zoom the [wikitr:/Help/MapView MapView] to the estimated target position of the new background image.
    19 1. Click the '''Imagery''' menu and either choose '''New picture layer from file''' or '''New picture layer from clipboard'''.
    20  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.
    21  b. If you chose clipboard, importing the image data may take some time. 
     211. Click the **Imagery** menu and either choose **New picture layer from file** or **New picture layer from clipboard**.
     22 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.
     23 a. If you chose clipboard, importing the image data may take some time.
    2224
    2325If something failed, you should get a message box. If not - check the console for messages (Linux only?)
     
    26281. Start aligning the image.
    2729 a. Move the image by choosing 'Move' from the [wikitr:/Help/EditToolbar toolbar] and dragging the mouse around with left button pressed.
    28  b. Rotate the image by choosing 'Rotate' from the toolbar and drag.
    29  c. Scale the image by choosing 'Scale' from the toolbar and drag.
    30  d. You can also choose to scale in just one axis by selecting the proper button.
    31 
    32 6. If you need to reset your changes - you can use the context menu from the !PicLayer entry in the layer list.
     30 a. Rotate the image by choosing 'Rotate' from the toolbar and drag.
     31 a. Scale the image by choosing 'Scale' from the toolbar and drag.
     32 a. You can also choose to scale in just one axis by selecting the proper button. \\ \\
     331. If you need to reset your changes - you can use the context menu from the !PicLayer entry in the layer list.
    33341. If you want to save the calibration of the image, you can also do this using the popup menu.
    3435
    35 This plugin is meant to help with mapping from aerial photos, similar to [http://mapwarper.net/ mapwarper.net].
     36This plugin is meant to help with mapping from aerial photos, similar to [https://mapwarper.net/ mapwarper.net].
    3637
    3738
    3839== Converting calibration data in !PicLayer ==
    39 For those interested in converting calibration data in !PicLayer:[[BR]]
    40 * {{{INITIAL_SCALE}}} is the initial size of 100 image pixels (length of ruler in JOSM).
    41 * {{{SCALEX/Y}}} is the factor after changing the size of the raster image relative to JOSM data layer.
    42 * {{{INITIAL_POS_y/X}}} are the coordinates of the image center in mercator projection.
    43 * {{{POSITION_X/Y}}} are the coordinates after shifting the raster image relative to JOSM data layer.
    44 * {{{ANGLE}}} is the angle in degrees (clockwise -> positive) when the raster image is rotated.
     40For those interested in converting calibration data in !PicLayer: \\
     41* `INITIAL_SCALE` is the initial size of 100 image pixels (length of ruler in JOSM).
     42* `SCALEX/Y` is the factor after changing the size of the raster image relative to JOSM data layer.
     43* `INITIAL_POS_y/X` are the coordinates of the image center in mercator projection.
     44* `POSITION_X/Y` are the coordinates after shifting the raster image relative to JOSM data layer.
     45* `ANGLE` is the angle in degrees (clockwise -> positive) when the raster image is rotated.
    4546
    4647* Mercator units are arc units in longitude (PI <-> 180).
     
    6263 (when inverse tangent returns degrees).
    6364
    64 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.[[BR]]
     65When 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. \\
    6566At equator 1 degree -> d0 = 111.321 km (from GRS 80 semi-major axes), at latitude b you get:
    6667{{{
     
    6970(only exact for sphere, but deviation from ellipsoid < 0.5%).
    7071
     72
     73== Using auto calibration action ==
     74This action helps you to position and calibrate an image (preferably a floor plan) into the world map.
     75
     76**What do I need to use this action?**
     77* an image, preferably a floor plan
     78* information about side length of building
     79
     80**How do I start calibration?**
     81* 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.
     82* 2. enter the "Calibrate Picture with outline" mode
     83* 3. follow the window
     84* 3.1 select **Building Corner Point** (example in picture : edge points)
     85* 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.
     86* 3.3 open the **Building Reference File** - open a .osm or .gpx file with coordinates of building outline or select a layer as reference
     87* 3.4 select **Building Reference Points**
     88  * 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
     89  * 3.4.2 select the same points as in step 3.1, now only on your real building outline (example in picture)
     90* 3.5 **run** calibration - **result**
     91
     92Example: [osmwiki:../w/images/a/a8/Piclayer_auto_calibration.gif Piclayer_auto_calibration.gif]
     93
     94**More information**
     95For 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]].
     96
     97
    7198== See also ==
    72 * [[osmwiki:JOSM/Plugins/PicLayer|PicLayer page]] at OSM wiki
     99* [osmwiki:JOSM/Plugins/PicLayer PicLayer page] at OSM wiki
     100
    73101
    74102----
    75 Back to [wikitr:/Plugins#JOSMdocu Plugin Help][[BR]]
     103Back to [wikitr:/Plugins#JOSMdocu Plugin Help] \\
    76104Back to [wikitr:/Help Main Help]