Changes between Version 22 and Version 23 of Help/Plugin/PicLayer
- Timestamp:
- 2021-08-01T11:55:46+02:00 (4 years ago)
Legend:
- Unmodified
- Added
- Removed
- Modified
-
Help/Plugin/PicLayer
v22 v23 1 1 [[TranslatedPages]] 2 2 3 3 4 = Plugin -> PicLayer = 4 5 5 [[Image(/pluginicon/PicLayer.jar/images/layericon.png, 32)]]6 [[Image(/pluginicon/PicLayer.jar/images/layericon.png,link=,middle,48)]] 6 7 7 8 This plugin shows images as background in JOSM. 8 9 9 10 It offers two ways of loading the raster image data: 10 -from a file and11 -from the clipboard.11 * from a file and 12 * from the clipboard. 12 13 This is an early version and is not end-user-proof, so please follow the steps exactly when using it. 13 14 14 15 Make sure the image is suitable, copyright-wise, if in doubt, don't use. 15 16 17 16 18 == Usages == 17 19 1. Load some data from the server so the map is visible. 18 20 1. 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.21 1. 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. 22 24 23 25 If something failed, you should get a message box. If not - check the console for messages (Linux only?) … … 26 28 1. Start aligning the image. 27 29 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.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. 31 33 32 34 6. If you need to reset your changes - you can use the context menu from the !PicLayer entry in the layer list. … … 37 39 38 40 == 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.41 For those interested in converting calibration data in !PicLayer: \\ 42 * `INITIAL_SCALE` is the initial size of 100 image pixels (length of ruler in JOSM). 43 * `SCALEX/Y` is the factor after changing the size of the raster image relative to JOSM data layer. 44 * `INITIAL_POS_y/X` are the coordinates of the image center in mercator projection. 45 * `POSITION_X/Y` are the coordinates after shifting the raster image relative to JOSM data layer. 46 * `ANGLE` is the angle in degrees (clockwise -> positive) when the raster image is rotated. 45 47 46 48 * Mercator units are arc units in longitude (PI <-> 180). … … 62 64 (when inverse tangent returns degrees). 63 65 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]]66 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. \\ 65 67 At equator 1 degree -> d0 = 111.321 km (from GRS 80 semi-major axes), at latitude b you get: 66 68 {{{ … … 71 73 72 74 == Using auto calibration action == 73 74 75 This action helps you to position and calibrate an image (preferably a floor plan) into the world map. 75 76 76 '''What do I need to use this action?'''77 **What do I need to use this action?** 77 78 * an image, preferably a floor plan 78 79 * information about side length of building 79 80 80 '''How do I start calibration?'''81 **How do I start calibration?** 81 82 * 1. open the image file and switch to the image layer so you can see the [[osmwiki:JOSM/Plugins/PicLayer|PicLayer]] modes on left side 82 83 * 2. enter the "Calibrate Picture with outline" mode 83 84 * 3. follow the window 84 * 3.1 select '''edge points'''(example in picture)85 * 3.2 enter '''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 '''referencefile'''- open a .osm or .gpx file with coordinates of building outline or select a layer as reference87 * 3.4 select '''referencepoints'''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'''mode85 * 3.1 select **Building Corner Point** (example in picture : edge points) 86 * 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. 87 * 3.3 open the **Building Reference File** - open a .osm or .gpx file with coordinates of building outline or select a layer as reference 88 * 3.4 select **Building Reference Points** 89 * 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 90 * 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 * 3.5 **run** calibration - **result** 91 92 92 93 Example: [[https://wiki.openstreetmap.org/w/images/a/a8/Piclayer_auto_calibration.gif|Piclayer_auto_calibration.gif]] 93 94 94 '''More information''' 95 95 **More information** 96 96 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]]. 97 97 … … 100 100 * [[osmwiki:JOSM/Plugins/PicLayer|PicLayer page]] at OSM wiki 101 101 102 102 103 ---- 103 Back to [wikitr:/Plugins#JOSMdocu Plugin Help] [[BR]]104 Back to [wikitr:/Plugins#JOSMdocu Plugin Help] \\ 104 105 Back to [wikitr:/Help Main Help]
