                                                                ginput
Chapter 8 Display and Level Operations

Only one graphics input device may be active at any given time, although up to
three devices may be present.  The standard three devices are the mouse,
digitizer 1 and digitizer 2.   Each device type and address should be
identified in the config file.  The primary, default startup device is also set
in the config file as ginput = (dev).  The user may reset the graphics input
device at any time.

Entering an optional -a argument sets the coordinate mode to absolute; the
default (no argument) is relative mode.  In relative mode, LTPlus is basically
treating the incoming x,y positions as relative movement, with no relationship
between the screen cursor position and the map location on the digitizer.
This is perfectly sufficient for most LTPlus activities.  However, absolute
mode is desirable when digitizing or editing map data; it provides the
correlation between movement on the map surface and the position of the screen
cursor on the corresponding map screen display.

ginput

    Select an active graphics input device (GIN).

         ginput gdev [-a,d]

    Selects graphics input device based on argument gdev.  Option -a specifies
    that the coordinates be received from gdev as absolute in nature; the
    default setting is for relative coordinates.  The -d argument allows the
    user to perform debugging tasks.
    ___________________________________________________________________________
    Options/arguments:

         gdev      Graphics input device; valid entries are:
                   mouse     (or m)
                   dig1      (or 1)
                   dig2      (or 2)
         -a        Specifies absolute coordinates
         -d        Specifies debug mode.   When this option is chosen, the
                   first 1600 characters or 10000 reads (whichever comes first)
                   are printed on the screen.  After that, the input is used as
                   normal digitizer input.  This allows debugging of a
                   digitizer interface after the basic baud, address and output
                   sequences are correct.
    ___________________________________________________________________________
    Example(s):

    To select digitizer 1, in absolute mode, as the active graphics input
    device, enter:
     
         ginput -a dig1
    ___________________________________________________________________________
    See also:

              config
    ___________________________________________________________________________
