c_regmap - Registers a map to a digitizer
SYNTAX
#include "geompak.h"
#include "digitizer.h"
FUNCTION c_regmap (mapfile, mapid, units)
char *mapfile;
char *mapid;
char *units;
PARAMETERS
mapfile (input, character)
The name of the map identifier file. This is a labeled table file containing map
parameters needed to register a map to a digitizer. If <
a href=../../user/mapfile>mapfile is null, the map
identifier file is not used.
mapid (output, character)
The map identifier for the map currently registered to the digitizer.
units (input/output, character)
The units to be returned to the calling program when c_digpt() is used. This field
corresponds to the units fields in the tie point files and the image DDR.
DESCRIPTION
The c_regmap() routine is used to register a map to a digitizer. The parameters needed to register a
map are initially prompted for and then written to the map identifier file for future use. This means
that map parameters and other map information need be entered only once during the course of a
project. After map parameters have been entered (or read from file), the user is prompted to spark
the registration points on the digitizer. When finished with this step, statistics on the digitizer-to-map fit are displayed and the user is given the chance to refine the fit by resparking any point.
Once the fit is satisfactory, the digitizer-to-map fit parameters are stored in a common area to be
used later by c_digpt().
RETURN VALUE
c_regmap() returns
E_SUCC (0) --> successful completion
E_FAIL (-1) --> operation failed
E_DONE (9) --> user aborted map registration
SPECIAL CONSIDERATIONS:
The c_regmap() call is for C only.