                                                                register

Chapter 10 Map Manipulation

Every map processed in LTPlus must be registered.  An imported scan file must
be registered to the raster.  A manually-digitized map must be registered to
the digitizer tablet.  In most instances, it is also desirable to link the map
to the real world by identifying control points for which ground coordinates,
in some system or another, are known.  Whenever possible, all four corners
should serve as the map registration control.  Geodetic coordinates must be
entered as latitude and longitude.  State plane feet and UTM meters must be
entered as X (Easting) and Y (Northing) values.  The user may also supply
registration data for a local coordinate  system (or several), if required.  If
map_ht and map_wd are preset in the header file and the map is rectangular with
respect to lat/lon, then the, geodetic registration is satisfied with a single
corner entry.  It is important to note that the control points do not need to
properly bound the mapping area; that is, the control points can be inside the
actual map limits.  However, the best control will be generated when the
control points are at the extreme outside of the desired map area.

register

    Performs map or menu registration.
     
         register [-d] [-p] c [i1=x,y]...[i4=x,y] [type=str] 

    This command performs map or menu registration.  The -d option displays
    the current registration, while the -p option prints the current corner
    registration to the default primary system printer (see config file entry).
    The coordinate type (c) must be identified.  Corner coordinates for the
    four corner positions are entered via the digitizer, mouse and/or
    keyboard.  For geodetic registration, only a single corner is required if
    map_ht and map_wd are set properly in the header file. For geodetic
    registration, use [i1=x,y]...etc.
    ___________________________________________________________________________
    Options/arguments:

         -d        Display registration values of active map
         -p        Print registration values of active map
*         c        coordinate type code:   0 = raster
*                                          1 = geotetic (lat/lon)
*                                          2 = utm
*                                          3 = state plane
*                                          4 = digitizer 1
*                                          5 = digitizer 2
*                                          6 = map inches
*                                          7 = last digitizer1 pts.
*                                          8 =  - reserved -
*                                          9 =  - reserved -
*                                    10 - 19 =  - user defined coord systems
*                                    20 - 29 =  - reserved for system use
         i1..i4    Corner identifier, including:
                        SW  NW  NE  SE
          = x,y    Corner coordinates, in appropriate units
         type      Description for user-defined system
          = str    text string dexcription
    ___________________________________________________________________________
    Example(s):

    To display the corner registration for the current, active map on the
    primary default printer, enter:

         register -p
    ___________________________________________________________________________
    See also:

              reg_copy
    ___________________________________________________________________________
