mirror of
https://github.com/RevCurtisP/C02.git
synced 2024-11-25 06:31:25 +00:00
49 lines
2.1 KiB
Plaintext
49 lines
2.1 KiB
Plaintext
Joystick Functions for C02 Programs
|
|
|
|
This module contains constants and a function for reading digital joysticks
|
|
(the type used on Atari and Commodore 8-bit computers). For systems that use
|
|
analog joysticks (such as the Apple II), the paddle module should be used.
|
|
|
|
The constants and assembly code vary by system, so when invoking the
|
|
cross-compilers, the command line option -s must be used to ensure that
|
|
the correct header files are included.
|
|
|
|
At the beginning of the program use the directives
|
|
|
|
#include <joystk.h02>
|
|
|
|
The following constants are defined:
|
|
|
|
#JYSTKS Maximum number of joysticks supported by system.
|
|
|
|
For systems with no joystick support, this will be 0.
|
|
|
|
#JOYUP Joystick Switch Bitmask - Up
|
|
#JOYDN Joystick Switch Bitmask - Down
|
|
#JOYLF Joystick Switch Bitmask - Left
|
|
#JOYRT Joystick Switch Bitmask - Right
|
|
#JOYB0 Joystick Switch Bitmask - Fire Button
|
|
|
|
The following functions are defined:
|
|
|
|
j = joystk(n); Returns the current state of joystick n.
|
|
|
|
If n is greater than or equal to #JYSTKS then $FF
|
|
will be returned. Otherwise, a byte representing the
|
|
state of the joystick switches will be returned.
|
|
|
|
Each switch in the joystick has a corresponding bit
|
|
in the result which will be 1 if the switch is
|
|
depressed or 0 if it is not.
|
|
|
|
The specific assignment of bits varies by system, so
|
|
the joystick bitmask constants should be used to check
|
|
the state of the individual switches.
|
|
|
|
The state of an individual switch can be determined by
|
|
doing a bitwise and of the result with the corresponding
|
|
bitmask constant, which will result in a non-zero value
|
|
if and only if that switch is depressed.
|
|
|
|
Note: This library has no external dependencies.
|