tpad_set_cursor() — Apollo Domain/OS SR10.3.5

TPAD_$SET_CURSOR                  Domain/OS                   TPAD_$SET_CURSOR


NAME
     tpad_$set_cursor - re-establish the locator origin in relative mode

SYNOPSIS (C)
     #include <apollo/base.h>
     #include <apollo/tpad.h>

     void tpad_$set_cursor(
          smd_$pos_t &origin)

SYNOPSIS (Pascal)
     %include '/sys/ins/base.ins.pas';
     %include '/sys/ins/tpad.ins.pas';

     procedure tpad_$set_cursor(
          in origin: smd_$pos_t);

SYNOPSIS (FORTRAN)
     %include '/sys/ins/base.ins.ftn'
     %include '/sys/ins/tpad.ins.ftn'

           integer*2 line, column, origin(2)

           equivalence (line, origin(1)), (column, origin(2))

           call tpad_$set_cursor(origin)

DESCRIPTION
     This call is useful for relative and absolute/relative mode only and is
     primarily used with touchpad and bitpad locating devices.

     The system remembers the last cursor position delivered by the locator.
     When new input comes from a locator in relative mode, a displacement is
     computed and applied to the previous locator position.  The
     tpad_$set_cursor call makes the system forget the previous locator posi-
     tion, and use the value passed in the call instead.  The next displace-
     ment will be computed from the position specified in the tpad_$set_cursor
     call instead of the locator's previous position.  Tpad_$set_cursor can be
     called at any time and affect all subsequent locator input.

     When using a touchpad or bitpad in relative mode, the origin is automati-
     cally re-established when the user takes his finger from the touchpad for
     more than one eighth of a second.  One effect of relative mode is that
     the cursor doesn't move the next time the user touches the pad unless
     tpad_$set_cursor was called in the interim.

     When using a touchpad in absolute/relative mode, a call to
     tpad_$set_cursor is only useful while the locator is functioning in the
     relative phase; that is, after the first touch and before the operator
     lifts his finger for more than one half second.

     origin
          The screen position that will be the origin for subsequent input
          from the the locator in smd_$pos_t format.

SEE ALSO
     tpad_$inquire, tpad_$set_mode.
Museum
