Downloading and InstallationTopTcl Commands Implemented

Tcl Commands Implemented

The general philosophy is that of dealing with the Shapefile files (the data file .shp, the index file .shx, and the attribute file .dbf) as a single entity that is called below a set of files. There are Tcl commands for creating a new set and for opening (for reading) an existing one, as well for closing a set that was created or opened.

Each set has a type and dimension associated to it. The basic types are waypoint, route and track, that correspond to the Shapefile point and polylines shapes. When reading from a Shapefile polyline the distinction between routes and tracks can only be made if its attribute field names are the same as those written by gpsmanshp. The type UNKNOWN is used if this distinction cannot be made.

Input/output of polylines is made by first getting/creating an internal description and then reading/writing each point at a time. At the same time there can be no more than one route and one track being created, and no more than one polyline being read from each set.

General Command

GSHPCloseFiles ID

Output Commands

GSHPCreateFiles BASEPATH TYPE DIM

GSHPWriteWP ID X Y ?Z? NAME COMMENT DATE

GSHPCreateRT DIM RTID COMMENT

GSHPForgetRT

GSHPAddWPToRT X Y ?Z?

GSHPWriteRT ID FORGET

GSHPCreateTR DIM NAME COMMENT

GSHPForgetTR

GSHPAddTPToTR X Y ?Z?

GSHPWriteTR ID FORGET

Input Commands

GSHPOpenInputFiles BASEPATH

GSHPInfoFrom ID

GSHPGetObj ID INDEX

GSHPReadNextPoint ID


GPSManSHP WWW pages
©Miguel Filgueiras, mig_at_ncc.up.pt, DCC-FC & LIACC, Universidade do Porto, 2003

Downloading and InstallationTopTcl Commands Implemented