home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 5 / FreshFish_July-August1994.bin / bbs / dev / cmanual-3.0.lha / CManual-3.0 / System / DirtyInput / DirtyInput.doc < prev    next >
Encoding:
Text File  |  1993-10-12  |  1.9 KB  |  50 lines
  1. 5    DIRTY INPUT
  2.  
  3. 5.1  INTRODUCTION
  4.  
  5. This directory contains four dirty input readers. The programs
  6. are all using the hardware registers and are therefore very
  7. fast and easy to use. Although it is a bit naughty to use the
  8. hardware registers are these programs still following all
  9. "rules". The reason why they can use the hardware registers and
  10. still be accepted is because they get the values through the
  11. global hardware structures "Custom" and "CIA". 
  12.  
  13. Please use these routines only in games and small programs. If
  14. you intend to write a large serious program you should use the
  15. more polite and nicer devices. See manual "Devices" for more
  16. information.
  17.  
  18.  
  19.  
  20. 5.2  PROGRAMS
  21.  
  22. Joystick
  23.   Joystick() is a handy, easy and fast but naughty function
  24.   that hits the hardware of the Amiga. It looks at either port
  25.   1 or port 2, and returns a bitfield containing the position
  26.   of the stick and the present state of the button.
  27.  
  28. Mouse
  29.   Mouse() is a handy, easy and fast but naughty function that
  30.   hits the hardware of the Amiga. It looks at either port 1 or
  31.   port 2, and returns the (x and y) delta movement of the
  32.   mouse, as well as a bitfield containing the present state of
  33.   the three buttons. (A normal Amiga mouse has only two buttons
  34.   (left and right), but it is possible to connect a mouse with
  35.   three buttons, so why shouldn't we support it?)
  36.  
  37. Keyboard
  38.   Keyboard() is a handy, easy and fast but naughty function
  39.   that hits the hardware of the Amiga. It checks the keyboard,
  40.   and returns the Raw Key Code. (See appendix "SYSTEM DEFAULT
  41.   CONSOLE KEY MAPPING" for the full list of Raw Key Codes.)
  42.  
  43. Analogue
  44.   This is an Analogue Joystick reader. It is handy, easy and
  45.   fast but a bit naughty function since it reads directly from
  46.   the hardware registers. It can read either port 1 ("the mouse
  47.   port") or port 2 ("the joystick port"). Note that an Analogue
  48.   Joystick can have two buttons.
  49.  
  50.