PicMapTool 

Easily Capture, Manipulate And Measure Pictures  

Align AstroSpotter 

 Site Home Page        References   

 

About PicMapTool   (Java version)

PicMapTool is a Java application that makes use of a 'transparent' window to view and/or capture desktop windows below the application  Typically the application is placed over a map, picture or charts and then measurements and/or a grid can be placed over the image.   A key and powerful feature is built around the ability to capture the image below PicMapTool and then manipulate the captured image.  After an image is captured you can move PicMapTool or place some other window below it and 'mix' the captured/manipulated image with the new image below using an adjustment for the percent of each that is to be mixed.   

In 2010 I had developed a windows only application for PicMapTool but have stopped work on that as there were assorted issues of support on different flavors of Windows so I felt the application needed to be done in Java.  The older application is not supported, only the Java version on Windows XP, Windows 7 and Mac have been tried to date with windows being best tested.

The examples I show later feature usage for certain needs specific to astronomy but you should get the idea that any number of similar measurement or graphics overlay needs can be met using PicMapTool.  

Stay tunned for other features still on the drawing board or under development ...  


IMPORTANT COMPATIBILITY INFO:   Read this prior to download

The PicMapTool Java app requires Java 1.6 to run correctly.  It has been tested many Windows 7 as well as Windows XP  fully updated systems with limited  Apple Powerbook tests to date.  You can use this Java revision tester to check your revision.  If you care to download official Java you can get it from the official source here. which was distributing a very recent version of Java 1.6 as of 12/2011.   It has not been tested on Java 7 as that is not 'blessed' yet.  Running PicMapTool on linux has shown there are configuration needs there that I don't understand well enough to support Linux as of 12/2011.

PicMapTool was conceived and designed by Mark Johnston who retains rights for it's distribution and usage under creative commons licensing.


Key features of PicMapTool

- Capturing images from behind the tool such as road or weather maps and then drawing grids and measurement lines scaled to the distance key on that map.   Saving and loading of the images is of course supported.

- Determining distances and angles  of  terrestrial, astronomical, architectural, or other pictures and/or charts once you tell the tool how long the last line you drew is in the units you need to use.  Normally a map scale of distance makes this easy.

- Drawing and aligning grids with a known scale over images where you need to fit the grid to some unit of measure is as easy as drawing a line then hitting the Grid Align And Scale function.

- Capturing an image and then altering it's rotation or it's size as viewed within the PicMapTool window.   You may also 'mirror' the captured image.

- Alter the transparency  of a captured image using a simple slider so it appears to blend with whatever is below the PicMapTool window.  When you combine this with with the additional ability to rotate and resize the captured image you have a powerful visual dual-layer composition tool that can be used to overlay outlines or other patterns on top of maps or charts.

The most common features have buttons or sliders near the bottom with tooltips.  There are menus along the top with an extensive list of features not as common or requiring numerical input.   There is a right click context menu with several common operations that are felt to be fairly common and in need of context menu support.

A few pictures are worth a thousand (or more) words so here are a couple pics to show key features of PicMapTool


Examples Showing Usage Of PicMapTool

Example 1:  Take Measurements Or Overlay Grids

PicMapTool can be used to assist measurements of images that have been captured OR are showing up through the graphics window from the desktop below.   You can easily adjust the rotation and spacing of an optional grid all of which are fixed to the application so you can move PicMapTool to other areas on your screen and the desktop below with whatever windows are there show up through the transparent graphics area.  I'll show a simple distance measurement on a chart first then a more complex measurement example that features the grid overlay part of the tool.

You may grab the  image below and do all the measurements on that as well.  All the features of PicMapTool complement each other and are used in powerful combinations for any number of uses you may have.

Example 1a:  Measurement on the screen or captured Image

MeasureOnAChartOrMap

In example 1a we bring PicMapTool over an image which in this case is a charting program called MegaStar used for astronomy.  Since the PicMapTool screen shows the screen below we see our chart program.   The first thing we do is draw a line with the mouse on the bottom between +34 21  and  +34 30.  We then right click and select 'Set scale from last line'.  We type in 9 so e will then be calibrated for 'minutes' which is the 21 to 30 units.   Now we draw a line on the screen area from the bright core of the large lower galaxy to the top galaxy core and we then see in the 'Lines'  measurement box near bottom left that this was 8 minutes.   You can do this with any picture such as a map of a park or streets.

Example 1b:  A complex Measurement using calibrated Grid and lines 

MeasureSDcard


In Example 1b PicMapTool was placed over a jpeg picture viewer and we see the picture above.  The grid size slider was adjusted so each grid was 5mm with the grid not rotated yet.  Next we drew a line with the mouse along the edge of the SD card and hit 'Align Grid' to snap the grid to the same angle as the card. We moved PicMapTool so the grid was along two sides of the card so we have 5mm per grid.   Next we draw a line along the real ruler that is 30mm and then use Grid menu to tell PicMapTool this line was 30 long.  Now we draw a line seen just below the card from the bottom to the knotch in the SD card.  When done we see in the 'Line' spec the length and the angle of the last line drawn so we have just 'measured' one length.  

Here is another usage for a chart of the night skies but you could easily imagine this same sort of measurement for a map of a city or other roads or parks.

Example 2:  Use the transparency feature for a map overlay

TransparentOverlayOnAMap

In example 2 we want to use NexSat weather map to see what the clouds look like at the site we want to go out to use a telescope or camp or hike.   First we lay the tool over a black and white image such as this one I am supplying for California and we then use 'Grab'.  We then visit the  NexSat California low clouds sat image link and click on it to make it the larger picture.  Now move  PicMapTool over the weather map after bringing 'Image Transparency' to the right to make our overlay partially transparent.   In this example the map I have offered for use is the right size for the expanded version supplied by the sat images so no adjustment is needed.  BUT you could also use 'Image Scale' and 'Image Rotation' to scale and align some sort of overlay to whatever scale the screen graphic below is using.

Example 3:  Using the current line or grid to measure relative distances

FocusMaskMeasurement

The pattern above is used for astrophotography focus of a telescope.  We try to focus a telescope using a special tool called a Bahtinov Mask that when the telescope is focused is completely symetrical where the middle line is between the 'V'  patterns on each side.   In this example we can right after taking an exposure with the telescope lay PicMapTool screen so that the origin 'O' is in the middle of the pattern then use the Grid Rotation slider to align the grid to the central long line.   Now when focus is perfect it is easy to judge the 'V' pattern to see if it crosses over the  grid lines above and below at the very same relative position to the other side of the V.    OR we can start to draw a line with a click on the central line perhaps 3 grid spaces to the left of the origin and drag the mouse up to the upper leg of the V and note the distance in the 'Lines:' box in yellow here.   Then keep the mouse pressed and move to the lower leg of the V and see if it is the same.  You can without guesswork then know you are in focus or need another focus adjustment.


Example 4: Simple Interactive Image Compositing 

PicMapTool is positioned over an image to be captured and then the 'GrabImage' button grabs and holds that image even if PicMapTool is moved.  

Once an image has been grabbed you may alter the image scale (size) or it's rotation with simple sliders.  You may also mirror the image and/or rotate it in 90 degree increments for flexible image transformations.

A real fancy feature for the grabbed image is that you may adjust the 'Image Transparency' slider to go from 100 of the grabbed image all the way to 100% of the screen image that is behind PicMapTool.  This is a very powerful ability that also works with re-scaled and/or rotated images.

Example 2:  Capture, Manipulate, and Layer An Image over the Desktop

Measure an SD card


PicMapTool was placed over a well known picture and we sized the application then grabbed the image.  Next we enlarged it with 'Image Scale', then did a horizontal 'mirror' and then rotated the image with the 'Image Rotation' slider.  As if that were not enough we then used the 'Image transparency' slider to allow the origional to show through a bit stronger (we can choose any percentage of mix).   We have turned off  the 'Grid' and are not using any lines but all those are still possible on top if we really wanted to measure these fine gentlemen from America's past.  So notice that the lighter image has larger men and is mirrored and rotated.  We could also move PicMapTool or put some completely different image under the application which allows any number of useful things to be done one of which is to overlay black/white outlines over some image or place a simple watermark.  I use this feature to place an outline of California showing my house and other locations as dots over sattelite weather images and so on.  


Known Issues Or Limitations  (As of  rev 12-4-11)

- Your system must use Java Version 1.6.0_22 or other 1.6 version (current in 2011).  No testing on Java version 1.7 has been done to date as 1.7 is not the officially general distrbution yet.  You can test your version here  You can get the latest version of Java here.  

- The image window only works on the primary monitor at this time.

- If a window below PicMapTool moves you need to refresh by clicking on PicMapTool again and it re-grabs desktop

- If an operation does not repaint grids/lines right away a simple click on the window may work or worse case you may also click on some other open program then re-activate PicMapTool (perhaps by use of icons on the system taskbar if PicMapTool is below a screen)

- Don't size the main window so small as to have it start hiding controls as it is not prevented currently and has some issues.

- The background capture operation blinks the screen and it can be anoying.  Sorry about that and at this time I have some mild fears that the update on slower systems may lead to graphics display being wrong but have not proved that to myself yet.

- Apple testing has been minimal as I have to ask people to let me try it since I don't own one myself.



Please read before downloading PicMapTool 

This is a Beta copies that expires because these early versions are likely to become obsolite fast.   You can send me feedback on PicMapTool through my info on the about me page.

PicMapTool is concieved and created by Mark E. Johnstons and you are not allowed to distribute PicMapTool or to use the program to profit on your own.  Please direct people to this site should they wish to learn more about PicMapTool.

Please consider a secure donation of any amount using the key below. This will lead to PayPal where you can use a PayPal account or select to use a secure credit card donation. Thank you.    


Get the latest PicMapTool free from the download link below

DOWNLOAD PicMapTool







This page was last updated on 2/12/2012.