File Release Notes and Changelog
Release Name: 1.4
Notes:
MAPSURFER - a DHTML interface to the MapServer GIS engine
(provided under the Gnu Public License)
created by Russell Moffitt
Southern California Integrated GPS Network
US Geological Survey
russmo@wmadigital.com
------------------------------------------
Basic documentation describing the main features of MapSurfer is provided in the file docs.html.
------------------------------------------
INSTALLATION:
1) Install MapServer cgi.
MapSurfer is a web interface to MapServer, a freeware mapping engine available at http://mapserver.gis.umn.edu. Please refer to MapServer's own documentation to get it running properly. MapSurfer has been tested with MapServer versions 3.5-3.6.
2) Untar mapsurfer.tar.gz
This should create a directory called mapsurfer containing all of the MapSurfer interface. MapSurfer relies upon the DHTML library DynAPI (dynapi.sourceforge.net). DynAPI3 is already included with MapSurfer.
Put the mapsurfer directory somewhere accessible to the web.
3) Configure MapSurfer
mapper.html: set location of MapServer cgi program and the .map definition file to use. If you're going to use the demo map data provided with MapSurfer as a separate download, you'll want to use mapsurfer/test.map.
------------------------------------------
USING THE DEMO MAP DATA:
A set of sample map data is available with MapSurfer as a separate download, demodata.tar.gz, from mapsurfer.sourceforge.net. Untarring this file will create a directory called data containing several datasets in shapefile format. Place this directory in the mapsurfer directory. The map file test.map is already included with the standard mapsurfer distribution. Make sure that the mapfile variable defined in mapper.html is set to point to test.map. Also, make sure to configure the appropriate variables in test.map to reference the proper places to write MapServer generated files. There is a mapsurfer/tmp directory you can use, but make sure that it is readable and writable by your webserver. See the MapServer documentation for more information on setting up output directories.
------------------------------------------
RUNNING MAPSURFER:
Point your web browser to http://yourdomain.com/mapsurfer/index.html. Look at http://www.scign.org/mapsurfer/mapsurfer/ to see what yours should look and run like.
Please email me at russmo@wmadigital.com if you have questions or need help configuring MapSurfer.
MapSurfer is freeware. Feel free to make any modifications or improvements to MapSurfer. I would appreciate it if you would share improvements with me to be included with future MapSurfer releases.
Changes:
Version 0.4
--Fixed map file and query string template declarations to work with MapServer v4. If you are using MapServer v3.6 or earlier, please see the test.map file and comment out the TEMPLATEPATTERN line.
--Fixed rubberband box for Opera web browser. Opera didn't want to obey clipping settings, so I changed the mechanism to use a single layer with a red border. The previous version used 4 layers with red backgrounds all sized to the full map dimensions (one layer for each side of box). Each layer was clipped to a 1 pixel line segment. This worked smoothly in Internet Explorer for some reason, but Opera didn't like it. The new method resizes the layer with the red border, which works in all browsers, although IE seems a little choppier than it used to be.