README for vhclmaps 0.7 This directory contains a release of the vhclmaps 0.7.5 distribution from Vectaport Inc.. You should read the rest of this file for information on what vhclmaps is (formerly ivmaps) and the INSTALL file for instructions on how to build it. It is known to build on Linux, Solaris, and Irix, and probably other Unix'es as well. It uses ivtools, which builds on other OS'es. It builds with >= gcc-2.8.1 and >= egcs-1.0.3 and gcc-2.7.2.1. There is a contributed config for HPUX. You can pick up binaries for some of these platforms from the vhclmaps web page (http://www.ivtools.org/vhclmaps/). The overall copyright and permission notice for vhclmaps can be found in the COPYRIGHT file in this directory. If you have a question about this software, desire to contribute code, found a bug, or wonder how to get further assistance, please contact us via e-mail at vhclmaps-info@vectaport.com. vhclmaps was previously distributed in two tar files, ivmaps and vhlcserv. * What is vhclmaps?: vhclmaps provides facilities for map database access and display and vehicle simulation to navigate the maps. It builds on top of ivtools-0.8 (or greater) and PROJ-4.3.3, and optionally vtk-2.2, Mesa-3.0, clippoly and ACE-4.6. It supports a variety of terrain databases produced by the United States Geological Survey (USGS). Additional support for National Imagery and Mapping Agency (NIMA) databases is available in a separate US government-domain distribution. These are the libraries that make up vhclmaps: Map library of Map access base classes MapUnidraw library of Map display Unidraw-derived classes VpfUtil utility library of vpf source code Vpf library of Vector Product Format access classes Dlg library of Digital Line Graph access classes Dem library of elevation grid access classes DemVtk library of elevation grid 3d objects Los line-of-sight and viewshed library from DMAMUSE LosServ losserv library MapServ mapserv library VpfUnidraw library of Vpf display Unidraw-derived classes DlgUnidraw library of Dlg display Unidraw-derived classes DemUnidraw library of Dem display Unidraw-derived classes UtmUnidraw library of generic utm map feature display classes ProjUnidraw library of arbitrary projection display classes VhclServ vhclserv library vhclserv vehicle simulation server VhclUnidraw map viewer with built-in vehicle server vhclviewer example program to demonstrate VhclUnidraw These are the viewers in vhclmaps: vpfviewer VPF viewer dlgviewer DLG viewer demviewer DEM viewer utmviewer 2d map viewer with UTM projection projviewer 2d map viewer with arbitrary projection vhclviewer 2d map viewer with vehicle simulation These are the servers in vhclmaps: mapserv map feature class server losserv line-of-sight server vhlcserv vehicular navigation of maps These are the utility programs in vhclmaps: dcwdemprint usgsdem2vtk usgsdemprint vpfdbprint vpftableprint To get a quick look at these, check out the vhclmaps home page: http://www.ivtools.org/vhclmaps/ A series of makefile targets support the checkin of sources to cvs/rcs, and their subsequent update and modification. This requires cvs (at least 1.3) available from the Free Software Foundation and ivmkcm-0.7.2 available through http://www.ivtools.org/ivmkcm/ * Acknowledgements: vhclmaps programmers at Vectaport: Scott Johnston Jorge Gautier vhclmaps is partially derived from base classes in the ivtools software package. Here is the aggregrate copyright notice for that software package: /* * Copyright (c) 1999 Vectaport Inc., R.B. Kissh and Associates * Copyright (c) 1998 Vectaport Inc., R.B. Kissh and Associates, Eric F. Kahler * Copyright (c) 1997 Vectaport Inc., R.B. Kissh and Associates * Copyright (c) 1996 Vectaport Inc., R.B. Kissh and Associates, Cider Press * Copyright (c) 1994, 1995 Vectaport Inc., Cartoactive Systems, Cider Press * Copyright (c) 1991 Silicon Graphics, Inc. * Copyright (c) 1987, 1988, 1989, 1990, 1991 Stanford University * * Permission to use, copy, modify, distribute, and sell this software and its * related documentation and data files for any purpose is hereby granted * without fee, provided that the above copyright notice appear in all copies * and that both that copyright notice and this permission notice appear in * supporting documentation, and that the names of the copyright holders not * be used in advertising or publicity pertaining to distribution of the * software without specific, written prior permission. The copyright holders * make no representations about the suitability of this software for any * purpose. It is provided "as is" without express or implied warranty. * * THE COPYRIGHT HOLDERS DISCLAIM ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, * INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. * IN NO EVENT SHALL THE COPYRIGHT HOLDERS BE LIABLE FOR ANY SPECIAL, * INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING * FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, * NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. */ The VpfUtil library contains the public domain VPFVIEW C code included with the Digital Chart of the World, Edition 1, which was pruned and ported to work on "POSIX"-like systems. The line-of-sight and viewshed capability was borrowed and retrofitted from the DMA (NIMA) MUSE2 package. vhclmaps relies on the PROJ software package from the USGS and Gerald I. Evenden. The configure script is evolved from ivtools configure script, which was in turn borrowed and retrofitted from Target Jr. The MapServ library contains geomdist.c, which computes the closest point on a line segment to a specified point. This code came from the MAGIC library of Dave Eberly at UNC. His license forbades only one thing, the commercial sale of the source code (http://www.cs.unc.edu/~eberly/index.html). vhclmaps was developed with partial support from IET Inc. (P.O. Box 112450, Campbell, CA 95011) in the form of ARPA subcontracts (Prime Contract Number DACA76-93-C-0025 and DACA76-97-C-0005) to Vectaport Inc. (P.O. Box 7141, Redwood City, CA 94063), and more recently by granting part-time employee Scott Johnston the freedom to evolve ivtools and related open-source frameworks as part of his job.