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.