BUTTON USE/FREE
                               ===============

S*Basic commands to allocate and deallocate space in the button frame.

                        ©pjwitte 2oo2 - Use at own risk!

If all you want to do is put your program to sleep using the program name
and default button attributes, you dont need these commands! Just:

        JOB_NAME 'Test'
        EXEP 'BUTTON_SLEEP'


System requirements:

SMSQ/E or QDOS with QPAC2
Not compatible with older versions of Turbo as results are retuned via parameters


Usage:

        error% = BUTUSE%(x%, y%)

        call with x/y% specifying size of button required

        returns with x%/y% position of button in button frame

        error% contains any errors returned by button-use code. Parameter
        errors (eg using wrong parameter type for x or y) are "hard", ie
        they stop program execution.


        BUTFREE

        frees button from button frame if space was reserved - else error


Program status:

The code contains a PD routine (thg_getvec) © 1989 Tony Tebby / Jochen Merz

You may incorporate and use these commands in your own programs provided you
acknowledge the authors.

The functional part of the source code is included so you can make any
modifications or bug fixes you require, or simply see how it works.


Enjoy!


Per Witte
July 11th 2004

pj@witte.fsbusiness.co.uk