========
Graphics
========

_FAST_ELLIPSE
  Description   : Draws an ellipse using only fixed-point math.
  Calling format: _FAST_ELLIPSE[XC,YC,RX,RY,_FILLED]
                      XC,YC - center of ellipse
                      RX,RY - X and Y radii (for a circle, RX=RY)
                      _FILLED - whether ellipse should be filled or not
  Return value  : None.
  Special notes : Requires procedure _4WS (included in file).
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca

_FAST_LINE
  Description   : Draws a line using only fixed-point math.
  Calling format: _FAST_LINE[X1,Y1,X2,Y2]
                      X1,Y1 - coordinates of the first point
                      X2,Y2 - coordinates of the second point
  Return value  : None.
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca


=====
Icons
=====

_MAKEMASK
  Description   : Creates a mask for an icon, using a given colour as
                      "transparent".
  Calling format: _MAKEMASK[_SCREEN,_COLOUR,TEMP1,TEMP2,X1,Y1,X2,Y2,_ICON]
                      _SCREEN     - Screen that icon is displayed on
                      _COLOUR     - Colour to make transparent
                      TEMP1,TEMP2 - Two temporary (unused) screens
                      (X1,Y1)     - Upper-left corner of icon
                      (X2,Y2)     - Lower-right corner of icon
                      _ICON       - Icon number to create mask for
  Return value  : None.
  Special notes : Can be changed to work with bobs instead of icons; just
                      just change "Icon Base" to "Sprite Base".
                  Assumes that the icon exists and has a mask.  A typical
                      calling sequence would be:

                      Get Icon N,X1,Y1 To X2,Y2
                      Make Icon Mask N
                      _MAKEMASK[Screen,_COLOUR,TEMP1,TEMP2,X1,Y1,X2,Y2,N]

  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca


=======
Screens
=======

_PALETTE_TO_ANTIQUE
  Description   : Converts palette to "antique photograph".  Hard to
                      describe; you'll have to see it yourself.
  Calling format: _PALETTE_TO_ANTIQUE[_SCREEN]
                      _SCREEN - the screen number to affect.
  Return value  : None.
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca

_PALETTE_TO_BW
  Description   : Converts palette to black and white.
  Calling format: _PALETTE_TO_BW[_SCREEN]
                      _SCREEN - the screen number to affect.
  Return value  : None.
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca

_PALETTE_TO_NEGATIVE
  Description   : Converts palette to "negative" colours (e.g. black<->white)
  Calling format: _PALETTE_TO_NEGATIVE[_SCREEN]
                      _SCREEN - the screen number to affect.
  Return value  : None.
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca

_SEPARATE_RGB
  Description   : Filters colours in picture.
  Calling format: _SEPARATE_RGB[_SCREEN,X]
                      _SCREEN - the screen number to affect.
                      X       - the "filter" colour:
                                  1 - Red
                                  2 - Green
                                  3 - Blue
                                  4 - Magenta
                                  5 - Yellow
                                  6 - Purple
  Return value  : None.
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca


======
System
======

_DOSERROR
  Description   : Returns the AmigaDOS error message for an IoErr() error
                      code.
  Calling format: _DOSERROR[ERR]
                      ERR - IoErr() (Doscall(-132)) return value.
  Return value  : String that contains the error text.
  Special notes : This procedure handles all errors for AmigaDOS 2.1.  Use
                      of the AmigaDOS 2.04 Fault() function is not yet
                      implemented.
  Author        : Andrew Church
                  95ACHURCH@vax.mbhs.edu


====
Text
====

OPENFONT
  Description   : Opens/closes a font.
  Calling format: OPENFONT[NAME$,SIZE,_REM]
                      NAME$ - Name of the font.  ".font" extension is
                                optional.
                      SIZE  - Font size.
                      _REM  - 0 to open the font, nonzero to close it.
  Return value  : Font number (to be used with Set Font).
  Author        : Andrew Church
                  95ACHURCH@vax.mbhs.edu

_SHADOW_TXT
  Description   : Writes shadowed text to the current screen.
  Calling format: _SHADOW_TXT[X,Y,_FG,_BG,_TXT$]
                      X,Y   - coordinates for text (like Text command)
                      _FG   - foreground colour
                      _BG   - background colour
                      _TXT$ - text to write
  Return value  : None.
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca


=====
Other
=====

_TO_NTSC
  Description   : Switches display to NTSC mode.
  Calling format: _TO_PAL
  Return value  : None.
  Special notes : Requires ECS or better chipset.
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca

_TO_PAL
  Description   : Switches display to PAL mode.
  Calling format: _TO_PAL
  Return value  : None.
  Special notes : Requires ECS or better chipset.
  Author        : Michael Sikorsky
                  sikorsky@bode.ee.ualberta.ca


