1.

Digital Slide Show procedure

This document specifies the procedure for building a digital slide show from a set of .JPG files. It includes the incorporation of GPS data to automatically annotate the images with location information.

1.1

Amendment History
2004-11-07 V002 Amended to describe how to do it from Sarge 2005-xx-xx V003 ??? 2006-08-16 V004 Added initial description of revised process using dcim.pl

1.2

Revision Notes
The procedure is now best run from Sarge, as it is much faster. Can still be done from Msquared but the latest code is on sarge.

2.

New Procedure
(Old procedure is in subsections 3+ below). This new procedure requires some refinement.

2.1

Download From GPS

(Do this first as it takes most time) 1. Connect GPS to serial port. Switch it on and choose Use with GPS Off 2. Start MapSource 3. Select Open from GPS and start downloading (all data except map) 4. Save data as C:\data\gps\mps\quickname.mps 5. Export data as C:\data\gps\mps\quickname.txt 6. Copy the above 2 files to C:\data\gps\mps\database (= X), with names of the form: o Date1-Date2-quickname.mps o Date1-Date2-quickname.txt Where Date1, Date2 are first and last dates of the trackpoints 7. Edit X\catalogue.txt to record the new data 8. Check relevant time zone information is recorded in o Sarge ~/dev/data/Gps/EtrexLegend 9. Update trackpoint database using: o $(Sarge) ~/dev/trackpoint/rebuildTrackpoint.pl quickname (This script knows to look in dir X, and will load in data from any file that contains the string quickname) @@ See also Novatech ~/dev/garmin/getTrackpoints.pl, which will eliminate need to use mapsource, and will avoid the summertime problem, but isnt ready yet (16/08/2006).

2.2

Download from Camera

Copy pictures from camera C:\bigdisk\dcim\cameraName = P card to a new directory D under

2.3

Build DCIM data

$(Sarge) cd /mnt/novatech_bigdisk/dcim/cameraName/D $(Sarge) dcim.pl > thumbnails quick > build View P/D/html/index.htm in Internet Explorer to find out what needs rotating > rotate filenamepattern > > thumbnails oriented > resize

> build > edit title > build

2.4

Building Location data

If pictures cover a new country: $(sarge) cd ~/dev/placeDatabase $(sarge) mk_placeDb.pl XX (where XX is country code) Continuing with dcim.pl: > set loc XX > location > build (Observe any cases where the location data appears to be duff)

2.5

Adjusting location data with Google Earth

Open P/D/html/index.kml (starts google earth) Use GoogleEarth to adjust position of any picture that GPS has incorrectly positioned (select pic, edit, drag & drop) Select slide show and SAVE Continuing with dcim.pl: > location kml=html/index.kml (should report which pics have moved) > location > build

3.

Build the basic slide show

Copy the .JPG files off the compact flash card onto Novatech, eg into directory: C:\Bigdisk\DCIM\100MLT12\Islay2003 From Sarge, build the slideshow: $ cd /mnt/novatech_bigdisk/DCIM/100MLT12/Islay2003 $ EditImageInfo.pl $PWD > thumbnails > build NOTE: with the Minolta S404 camera, thumbnails command gives an error, thumbnail not properly ended for all thumbnails, but seems to complete them OK. Should investigate Jpeg.pm to see if this is a bug or a non-compliance with Exif by Minolta. View the generated slideshow from Internet Explorer (Novatech) with URL C:\Bigdisk\DCIM\100MLT12\Islay2003\index.htm For pictures that need rotating, issue the command: > r nnn Where nnn is the last part of the image number (use sufficient digits to avoid ambiguity; regular expressions are permitted, eg r 25[0-6] will rotate PICT0250.JPG thru PICT0256.JPG. Add titles: >titles Build again: >build

4.
4.1

Add GPS Data

Retrieve GPS data
Retrieve GPS data from GPS using MapSource application (Novatech). Ensure MapSource settings are for decimal Lat/Long: Edit/Preferences/Position Format = Lat/Lon hddd.dddddo Save the GPS data as (eg): C:\Data\gps\mps\database\2005.04.29-2005.05.02-Tallinn.mps Export the data as (eg): C:\Data\gps\mps\database\2005.04.29-2005.05.02-Tallinn.txt @@ Need to improve the naming conventions for this (ideas in progress) @@ NB new function available on Novatech (~/readGPStrackpoints.pl) that avoids the need to use MapSource to get the data off GPS

4.2

Import the trackpoint data

@@ This needs improving with the advent of readGPStrackpoints.pl From sarge, copy the .txt file to ~/dev/trackpoint: $ cd ~/dev/trackpoint $ cp /mnt/novatech_data/gps/mps/database/2005.04.29-2005.05.02-Tallinn.txt . Check ~/dev/data/Gps/EtrexLegend to see whether it will correctly determine the trackpoint timestamps - you may have to add an additional clause to signify summertime for the current year. (@@Latest on this: ~/dev/data/gps/EtrexLegend specifies (UK) summertime date ranges, which should, for the future, be specified as last Sunday in March to last Sunday in October; this seems to be needed because the procedure of extracting data off Gps results in timestamps that are in UK local time rather than UTC. This was the case up to & including 31/10/2004, using MapSource and GPS (Etrex Legend) software version 2.29. GPS is now upgraded to software version 3.60 and this and/or the readGPStrackpoints.pl script may mean that the extraction will now generate UTC all year round (certainly it should according to the GARMIN GPS Interface Specification). 04/05/2005: latest situation: still seem to need to specify UK summertime when using MapSource, but readGPStrackpoints.pl seems to generate GMT consistently. [CONCLUSION: MapSource converts GMT times read from the GPS to local time on the PC, based on the assumed PC local time at the time the timestamp was written (ie times that were recorded during British Standard Time (=GMT) come out as GMT, times that were recorded during British Summer Time (=GMT+1hr) come out as BST. So the offset data in data/gps/EtrexLegend really ought to be associated with the MapSource product] Add the trackpoints to the main database. (before doing this, ensure you have a backup of ~/dev/data/Trackpoint/EtrexLegend.*) [@@ migration note: the trackpoint database on Sarge is a different format to that on Msquared due to internal implementation differences between the operating systems and/or perl versions, ie the perl tie function maps hashes onto disk files in a different way: on Msquared you get one file (trackpoints.db); on Sarge you get 2 (trackpoints.pag, trackpoints.dir). At some point I need to completely rebuild the trackpoints database on Sarge it was a bit hacked on migration] $ addTrackpoints.pl 2005.04.29-2005.05.02-Tallinn.txt

4.3

Set up camera data

Sarge: $ cd ~/dev/data/Camera Create (or edit) text file for the camera: the filename should be the cameras Model as recorded in the EXIF data in the Jpeg files it creates (spelling, case and spacing must match exactly). The text file should define the cameras clock time as offset in seconds from UTC (ie -900 would mean 15 minutes slow).

4.4

Set up placename data

Sarge: $ cd ~/dev/data/Bucket Ensure there is a set of 3 files covering the geographical area of concern. Filenames should be XX.dat, XX.idx and XX.ini where by convention XX is country code (though it doesnt need to be, eg for UK we have UK_PTS instead). If not present, build as follows (sarge: this works for all countries for USA, where we have text files of place names downloaded already) $ cd ~/dev/placeDatabase $ mk_placeDb.pl XX

4.5

Calculate Image Locations

Sarge, within EditImageInfo.pl (above): > locations > settitles =[ > settitles NearestPlace > settitles =] > build If necessary, force which placename database is used, with command: location_file XX Sarge, with dcim.pl: set loc <countrycode> location build # not strictly necessary, but frequently useful

5.

Setting Image Quality

Doing this enables you to generate slideshows that only contain a subset of the images in a directory (ie just the best images) >edit ImageQuality Use jed to set a quality value for each image (eg set all images to 10 to indicate top quality, then set to 5 for those which are substandard and set to 0 for those which are junk) >setqualitylevel 6 >build Builds a slide show that only contains images of ImageQuality >=6

6.

Building Multiple Slide Shows

This creates 2 slide shows: a full slide show in the main directory, and high quality show in a subdirectory. Build the full slide show in the normal way.

Then: $ mkdir slideShow $ cp index.htm index-full.htm $ EditImageInfo.pl >setqualitylevel 10 >setslideshowdirs . . . slideshow >build $ cp index.htm index-short.htm

7.
7.1

Making a CD
Quick CD (single slide show)
Run Nero and copy the whole directory onto the CDs root. The CD will auto-run. (The necessary files are generate by the build command. NB as currently configured auto-run will start the index.htm file. To start the slide show instead, change the autorun_template.inf to refer to start.htm instead of index.htm and re-run build

7.2

Composite CD (multiple slide shows)

Use MasterIndex.pl: cd to the root directory (which contains all the individual slide shows), then just run it. It creates an overall index etc. Read the comments at the top of the script on the specific steps needed to make the CD auto-run (depends on where on the CD you put the files).