GUI Library ver 1.0
Written by Chris Wahlen

All standard disclaimers apply.  Back up your memory if you're worried.
I take no responsiblity for any damaged hardware or loss of data by the
use of these functions....

The functions:

getch     ( --> bint )

  getch returns a keycode of a currently pressed key.  It doesn't use the internal keyboard
  buffer, so with interrupts off, it still works.  It's really fast, it basically just
  counts up to find the first key thats pressed and returns however high it counted.


choose2   ( str list bint --> bint flag )   --or--   ( str list bint list --> bint flag )

  choose2 is a full screen replacement for the internal choose.  The first str is the title.
  This must be a string less than 33 characters long.  The second argument is a list of strings,
  these are the actual printed choices.  They will be truncated if greater than 32 characters.
  There is no limit to the number of choices you can have.  The third argument is the starting
  selection.  The result is undefined if you give an invalid argument (an starting position,
  say greater than the number of elements).  Optionally, a menu list can be specified.
  This list MUST CONTAIN exactly SIX strings.  These will be shown at the bottom as the menu
  bar.  One thing about the menu bar - a string value of "Cancl" will serve as a Cancel
  button.  If a menu list is not specified, a default list with "Ok" and "Cancl" will be
  added in.

  choose2 returns either one or two arguments.  If the user cancels (presses backspace or
  Cancl) then the first argument is the flag FALSE.  Otherwise, the stack level one will
  contain TRUE, and stack level two will contain a binary integer which is the position the
  user pressed ENTER or Ok on.

choose2 uses UFL's minifont, and DOES NOT check for the existance of UFL.


puts   ( str bint bint --> )   --or--   ( str hxs --> )

  puts draws a string to the screen given str.  puts accounts for carraige returns ( "\n" ),
  and scrolls the screen when appropriate.  There are two ways to call this function.
  The first way would be to specify two binary integers as the x and y positions to start
  outputting the text in levels 1 and 2 of the stack.  The second method would be to specify
  a hex string as stack level 1.  This hex string must be at least 10 nibbles long.  The
  usefulness in specifying a hex string lies in that puts will update the actual hxs itself -
  so you can continue writing where you left off in subsequent calls to puts.

  Puts uses UFL's minifont, and DOES NOT check for the existance of UFL.


invputs   ( str bint bint --> )  --or--  ( str hxs --> )

  Same as puts, except draws the font inverted.


s->gr   ( str --> grob )

  changes a string into a grob.

  s->gr uses UFL's minifont, and DOES NOT check for the existance of UFL.



->menu   ( str --> grob )

  ->menu makes a Java looking menu bar out of a single string.

  ->menu uses UFL's minifont, and DOES NOT check for the existance of UFL.



->menubar   ( str bint --> )

  ->menubar draws the string str as a menu item in location 1 - 6 specified by the binary
  integer in stack level 1.  The result is undefined if a integer greater than 6 or less
  than 1 is specified.  The string will be truncated if longer than 5 characters.



choose3     ( list str list bint --> bint flag )   --or--   ( str list bint list --> bint flag )

  choose3 works exactly like choose2, except that there is the ability to
  flag/unflag entries in the list.  This is done so by using the +/- key.
  A little check mark is placed by the entry when it is flagged, and removed
  when it is not flagged.  The list in level 4 is the same size as the list
  of possible entries in level 2, and contains a flag for each entry (SYSRpl
  TRUE and FALSE.)  These are the startup flagged/unflagged values for each
  entry.  Upon return, choose3 will return a flag on level one.  If this flag
  is true, the level 2 will contain the menu row if a menu button was pressed
  and the list of resulting flagged entries on level 3.
  
makehxs     ( bint bint --> hxs )

  makehxs takes two binary integers (an x and a y value ) and turns them
  as a hex string usable by the puts and invputs functions.
