Name
JoyDir -- return direction of joystick (V1.5)
Synopsis
dir = JoyDir(port[, idx])
Function
This function returns the direction of the Joystick plugged into the port specified by port. The optional argument idx can be used to specify the index of the joystick to use in case there are multiple joysticks on a controller. Joystick indices start at 0.

One of the following states will be returned:

#JOYUP
Joystick direction is up
#JOYUPRIGHT
Joystick direction is up-right
#JOYRIGHT
Joystick direction is right
#JOYDOWNRIGHT
Joystick direction is down-right
#JOYDOWN
Joystick direction is down
#JOYDOWNLEFT
Joystick direction is down-left
#JOYLEFT
Joystick direction is left
#JOYUPLEFT
Joystick direction is up-left
#JOYNODIR
no direction selected

port can range from 0 to the number of joysticks currently plugged in minus 1. You can find out the number of joysticks currently available using the CountJoysticks() function. Please note that under AmigaOS, port 0 addresses the standard joystick port although this is port 1 on classic Amiga hardware. Hollywood switches these ports for cross-platform consistency where port 0 shall always refer to the default joystick.

Inputs
port
port number (usually 0 for the standard Joystick port)
idx
optional: joystick index to query (defaults to 0) (V10.0)
Results
dir
current Joystick state (one of the constants from above)
Example
While state <> #JOYRIGHT
  state = JoyDir(0)
  VWait
Wend
The above code waits until the user moves the Joystick in port 0 to right.
Show TOC