SGPT
                                     ====

                        Set pointer & Get pointer


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

GPT gets the current pointer position directly from the driver


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

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

These commands require the Pointer Interface to be present. It does not
check this!


Usage
=====

SPT
---

        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.

Update: If the coordinates are out of range the routine simply ignores the
request and doesnt error!


GPT
---

        GPT x%, y%

The current coordinates are returned in x%, y%. If either parameter is
missing, or either parameter is not an integer variable, that parameter
is skipped. No errors are reported.


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

V0.01, pjw, 2020 Mar 22, based on earlier work
V0.02, pjw, 2020 Aug 27, GPT added

               Conditions of use and DISCLAIMER as per Knoware.no

Generated by QuickHTM, 2023 Aug 21