Changes between Version 10 and Version 11 of Help/Plugin/PicLayer


Ignore:
Timestamp:
2011-06-13T02:13:21+02:00 (15 years ago)
Author:
skyper
Comment:

layout + links

Legend:

Unmodified
Added
Removed
Modified

  • Help/Plugin/PicLayer

    v10 v11  
    11[[TranslatedPages]]
     2
     3= Plugin -> PicLayer =
     4
     5[[Image(http://trac.openstreetmap.org/export/HEAD/applications/editors/josm/plugins/piclayer/images/layericon.png,32)]]
    26
    37This plugin is meant for showing images as a background of the data being edited.
    48
    5 It offers two ways of loading the data - from a file and from the clipboard.
     9It offers two ways of loading the data:
     10- from a file and
     11- from the clipboard.
    612This is an early version and is not end-user-proof, so please follow the steps exactly in case you want to use it.
    713
    8 NOTE: Make sure the image is suitable, copyright-wise, if in doubt, don't use.
     14**Note**: Make sure the image is suitable, copyright-wise, if in doubt, don't use.
    915
    10 Step 1) Load some data from the server so that map is visible.
     16== Usages ==
     171. Load some data from the server so that map is visible.
     182. Go to PicLayer menu and either choose to add a layer from a file or from the clipboard.
     19 a. If you chose a file, a file selector will pop-up. Choose the image you want. Of course the format you are using might not be supported yet :)
     20 b. If you chose a clipboard, please wait. For some reason it takes time. To be fixed later.
    1121
    12 Step 2) Go to PicLayer menu and either choose to add a layer from a file or from the clipboard.
     22 **Note**: If something failed, you should get a message box. If not - check the console for messages (Linux only?)
    1323
    14 Step 2a) If you chose a file, a file selector will pop-up. Choose the image you want. Of course the format you are using might not be supported yet :)
     243. Once the image is visible you may start positioning it. For that - select the PicLayer in the layers list and activate it (!!!).
     254. Start aligning the image.
     26 a. Move the image by choosing 'Move' from the toolbar and draggin the mouse around with left button pressed.
     27 b. Rotate the image by choosing 'Rotate' from the toolbar and draggin the mouse up/down with left button pressed.
     28 c. Scale the image by choosing 'Scale' from the toolbar and draggin the mouse up/down with left button pressed.
     29 d. You can also choose to scale in just one axis by selecting the proper button.
    1530
    16 Step 2b) If you chose a clipboard, please wait. For some reason it takes time. To be fixed later.
     31 **Note**: If it does not work - make sure the right layer is selected AND ACTIVATED.
    1732
    18 NOTE) If something failed, you should get a message box. If not - check the console for messages (Linux only?)
    19 
    20 Step 3) Once the image is visible you may start positioning it. For that - select the PicLayer in the layers list and activate it (!!!).
    21 
    22 Step 4) Start aligning the image.
    23 
    24 Step 4a) Move the image by choosing 'Move' from the toolbar and draggin the mouse around with left button pressed.
    25 
    26 Step 4b) Rotate the image by choosing 'Rotate' from the toolbar and draggin the mouse up/down with left button pressed.
    27 
    28 Step 4c) Scale the image by choosing 'Scale' from the toolbar and draggin the mouse up/down with left button pressed.
    29 
    30 Step 4d) You can also choose to scale in just one axis by selecting the proper button.
    31 
    32 NOTE) If it does not work - make sure the right layer is selected AND ACTIVATED.
    33 
    34 Step 5) If you need to reset your changes - you can use the popup menu available under the PicLayer entry in the layer list.
    35 
    36 Step 6) If you want to save the calibraton of the picture you have made, you can also do this using the popup menu.
     335. If you need to reset your changes - you can use the popup menu available under the PicLayer entry in the layer list.
     346. If you want to save the calibraton of the picture you have made, you can also do this using the popup menu.
    3735
    3836This plugin is meant to help with mapping from photos (for me it's mostly buildings) for people who simply don't like MetaCarta Rectifier.
    3937
    4038
     39== Converting calibration data in PicLayer ==
    4140For those interested in converting calibration data in PicLayer:[[BR]]
    42 INITIAL_SCALE is the initial size of 100 image pixels (length of ruler in JOSM).[[BR]]
    43 SCALEX/Y is the factor after changing the size of the raster image relative to JOSM data layer.[[BR]]
    44 INITIAL_POS_y/X are the coordinates of the image center in mercator projection.[[BR]]
    45 POSITION_X/Y are the coordinates after shifting the raster image relative to JOSM data layer.[[BR]]
    46 ANGLE is the angle in degrees (clockwise -> positive) when the raster image is rotated.[[BR]]
    47 Mercator units are arc units in longitude (PI <-> 180).[[BR]]
    48 Latitude is a bit complicated because this projection preserves angles but not areas:[[BR]]
    49 y = ln(tan(45+b/2))[[BR]]
    50 where b is in degrees, ln ist the natural logarithm and tan ist the tangent.[[BR]]
    51 The longitude in degrees l is obtained from x via l = x*180/PI.[[BR]]
    52 The latitude b can be calculated from y by b = 2*arctan(e!**y) - 45 (when inverse tangent returns degrees).[[BR]]
     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.
     46
     47* Mercator units are arc units in longitude (PI <-> 180).
     48* Latitude is a bit complicated because this projection preserves angles but not areas:
     49{{{
     50y = ln(tan(45+b/2))
     51}}}
     52
     53 where b is in degrees, ln ist the natural logarithm and tan ist the tangent.
     54* The longitude in degrees l is obtained from x via:
     55{{{
     56l = x*180/PI.
     57}}}
     58
     59* The latitude b can be calculated from y by:
     60{{{
     61b = 2*arctan(e!**y) - 45
     62}}}
     63 (when inverse tangent returns degrees).
     64
    5365When 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]]
    54 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%).
     66At equator 1 degree -> d0 = 111.321 km (from GRS 80 semi-major axes), at latitude b you get:
     67{{{
     68d = d0*cos(b)
     69}}}
     70(only exact for sphere, but deviation from ellipsoid < 0.5%).
    5571
     72== See also ==
     73* [[http://wiki.openstreetmap.org/wiki/JOSM/Plugins/PicLayer|PicLayer page]] at OSM wiki
    5674
    57 
     75----
     76Back to [wiki:Help/Plugins Plugin Help][[BR]]
     77Back to [wiki:/Help Main Help]