TopoFusion.com

Using PhotoFusion



PhotoFusion combines your digital photos with GPS data to determine where the pictures were taken. Simply download your GPS track into TopoFusion and point TopoFusion to a directory containing pictures you took during that time. PhotoFusion can do the rest. Photo thumbnails are placed (as waypoints) on the map.

Requirements:
  • Digital pictures in JPEG form (.jpg or .jpeg) with EXIF headers containing timestamps (almost all digital cameras save this information)
  • GPS Data with timestamps (almost all GPS devices save this information)
To Use
Right-click on a GPX file in the listview in the lower right and select "Properties", or alternatively, right click on a track on the map area while in pan mode (hand grabber) and select "File Properties". From the properties dialog box, go to the "Pictures" tab as shown below.


Select the directory containing your digital pictures in the top box by pressing the "..." button to right of it. Then select a time offset associated with your camera (not GPS). For convenience, a drop-down box is provided with common time zone offsets that will fill in the GMT offset box for you. TopoFusion requires this information from you because your GPS data stores the GMT time at each point, not the local time. Your camera is most likely set to local time, so TopoFusion needs to know how far offset it is from GMT.

Now click the "Place Pictures as Waypoints" button to begin PhotoFusion. Take a look at your track. If everything was set up properly, you should see small camera icons on the map located at the places you took the pictures. An example is shown below.


Enable the Photo Toggle ( on the toggle bar) to display image thumbnails on the screen as shown in the screen shot at the top of the page. When in the pan mouse mode each thumbnail will expand to a larger size when the mouse moves over them. The cursor changes to a magnifying glass signifying that clicking on the enlarge thumbnail will enlarge it further. Your computer's default image viewer will be launched with the image when you click on it.

Photos as waypoints In PhotoFusion Pro, photos are simply waypoints with coordinates at the location the photo was taken, and the pathname to the JPEG file in the "URL" field of the waypoint. This means that your photos can be moved (using the select points tool), deleted and edited using the normal waypoint tools available in TopoFusion. This is useful to separate photos that might be too close to each other, and to delete uninteresting photos. All the necessary information is saved in the GPX format.

Other Options:
  • Replace Current Pictures on Placement: This option is useful if you wish to adjust the time offset to more accurately place your photos. If your camera's time was a few minutes off GPS time, you may need to experiment to get the offset correct. This option ensures that you don't get duplicate photos at slightly different offset. If unchecked, any new photos will simply be added to the current GPX file without checking for duplicates.
  • Add URL prefix instead of path: TopoFusion can load photos (for thumbnail display on the map as well as HTML generation) from web sites as well your local filesystem. Use this option to add an http prefix to the filename in the resulting waypoints INSTEAD of the local pathname. Note that you need to have the photos in the local pathname chosen in the JPEG Directory first. Photos won't be able to load unless you have also uploaded the relevant jpeg files at the http prefix you provide here. This way you can share just a GPX file and still have photos load on other's computers.
HTML Page Generation


Once photos are placed, PhotoFusion allows you to generate web pages with a click-able imagemap of your map and pictures. Two types of imagemaps are available:

Thumbnails on map:

Gunnison Exploration Day 1
Sedona Circumcision Loop

Photo icons only:

24 Hours of Old Pueblo
Sutherland/Baby Jesus
CDO+Red Ridge (Snow)
Agua Caliente to Milagrosa

Both types of web pages include the profile of your GPS track, statistics and a table of all photos. To get clickable thumbnails on the map, simply leave the Photo Toggle on when you hit the Generate HTML ImageMap button. If the toggle is off, the resulting image map will only be clickable on the photo icons themselves.

Steps for HTML Generation: First ensure you have placed photo waypoints on your track. Next, you must set a destination directory for the HTML page and other assorted files. Do this by clicking the "..." button.

The resulting map will be the exact size of your TopoFusion map view. So, you should next resize your TopoFusion window to the desired size. Zoom/Pan the map view to include your desired view of the track. You can, if you wish, choose a different size for the generated thumbnails in the dialog (default is 160x120).

Hitting the Generate HTML ImageMap button will activate the status bar, showing the progress of thumbnail generation. Aerial and Topo views will be generated (at the current zoom level). Navigate to the destination directory and open up "index.html" to view your web page.

Error Messages:
  • No jpegs found. TopoFusion's search for .jpg/.jpeg files failed in the directory specified, check to make sure you picked the right directory and that it has JPEG files in it.
  • No proper EXIF headers in jpegs. TopoFusion found JPEG files, but it didn't find any that had EXIF headers with timestamps.
  • No time data found in tracks, can't place pictures! The GPX file you are trying to attach pictures to unfortunately doesn't contain time data. TopoFusion relies on the time data to place the pictures.
  • All of the picture times were BEFORE/AFTER the GPS data, adjust the time offset to compensate. When receiving this message, Topofusion will tell you the latest picture time and the earliest trackpoint so that you can get some idea of how you should change your offset. This is most likely caused by an incorrect offset, or a camera with the incorrect time. For the best results, synchronize your camera's time with your GPS's time.
Note: this page applies to PhotoFusion in the Pro version of TopoFusion. For info on PhotoFusion in TopoFusion Basic, see: PhotoFusion Basic.