SPT
                                       ===

                                   Set pointer


This is a simple wrapper for the IOP.SPTR trap. All it does is set the
pointer to a given position.


Limitations
-----------

Error trapping is rudimentary as it is expected that the programmer will
get their paramters right at the point of implementation!

This command requires the Pointer Interface to be present. It does not
check this!


Usage
-----

        SPT[#chan,] [key%,] x%, y%

Where
        #chan is a S*BASIC channel number, default #0
        key% is an optional key:
            -1 => relative to current window,
             0 => absolute position on screen (default),
             1 => relative to the channel's hit area
        x%/y% are coordindates to set 0..max%
             max% depends on the key%:
             absolute coordinates => anywhere within screen boundries
             relative coordinates => anywhere within the specified area

There are no return values, and errors are "hard", ie they stop program
execution.

This command may be usefully employed together with RPT% as RPT% does not
set the pointer itself.


Software status
---------------

V0.01, pjw, 2020 Mar 22, based on earlier work

Conditions of use and discalimer as per Knoware.no