Pub.FreeJoy: | Functions | Modinfo | Source |
Function JoyAxisCaps(port) | |
Returns | A bitfield representing which axis are available. |
Description | Available axis (proportional controls) on a joystick. |
Function JoyButtonCaps(port) | |
Returns | A bitfield representing which buttons are present. |
Description | Available buttons (on/off controls) on a joystick. |
Function JoyCount() | |
Returns | The number of joysticks and gamecontrollers connected to the system. |
Description | Counts the number of joysticks. |
Example | ' testjoy.bmx Import Pub.FreeJoy Strict If Not JoyCount() RuntimeError "No joystick found!" Graphics 640,480 Function drawprop(n$,p#,y) Local w DrawText n$,0,y w=Abs(p)*256 If p<0 DrawRect 320-w,y,w,16 Else DrawRect 320,y,w,16 EndIf End Function Local t=0 While Not KeyHit(KEY_ESCAPE) Cls SetColor 255,255,255 Local n=JoyCount() DrawText "joycount="+n,0,0 DrawText "JoyName(0)="+JoyName(0),0,20 DrawText "JoyButtonCaps(0)="+Bin$(JoyButtonCaps(0)),0,40 DrawText "JoyAxisCaps(0)="+Bin$(JoyAxisCaps(0)),0,60 For Local i=0 To 31 SetColor 255,255,255 If JoyDown(i) SetColor 255,0,0 DrawOval i*16,80,14,14 Next SetColor 255,255,0 drawprop "JoyX=",JoyX(0),100 drawprop "JoyY:",JoyY(0),120 drawprop "JoyZ:",JoyZ(0),140 drawprop "JoyR:",JoyR(0),160 drawprop "JoyU:",JoyU(0),180 drawprop "JoyV:",JoyV(0),200 drawprop "JoyHat:",JoyHat(0),220 drawprop "JoyWheel:",JoyWheel(0),240 DrawRect 0,280,t,10 t=(t+1)&511 Flip Wend End |
Function JoyDown( button,port=0 ) | |
Returns | True if the button is pressed. |
Description | Test the status of a joystick button. |
Function JoyHat#( port=0 ) | |
Returns | -1.0 if the joystick is centered, and values between 0.0, 0.25, 0.5. |
Description | Reports the position of the joystick's HAT controller if supported. |
Function JoyHit( button,port=0 ) | |
Returns | Number of times button has been hit. |
Description | Check for a joystick button press. |
Information | The returned value represents the number of the times button has been hit since
the last call to JoyHit with the same specified button. |
Function JoyName$(port) | |
Returns | The system name of the joystick. |
Description | Get the name of the joysticks connected to the specified port. |
Function JoyPitch#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Up, 1.0 if Down or a value inbetween. |
Description | Reports the position of the joystick's PITCH axis if supported. |
Function JoyR#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Up, 1.0 if Down or a value inbetween. |
Description | Reports the position of the joystick's R axis if supported. |
Function JoyRoll#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Up, 1.0 if Down or a value inbetween. |
Description | Reports the position of the joystick's ROLL axis if supported. |
Function JoyU#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Up, 1.0 if Down or a value inbetween. |
Description | Reports the position of the joystick's U axis if supported. |
Function JoyV#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Up, 1.0 if Down or a value inbetween. |
Description | Reports the position of the joystick's V axis if supported. |
Function JoyWheel#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Left, 1.0 if Right or a value inbetween. |
Description | Reports the position of the joystick's YAW axis if supported. |
Function JoyX#( port=0 ) | |
Returns | Zero if the joystick is centered, -1 if Left, 1 if Right or a value inbetween. |
Description | Reports the horizontal position of the joystick. |
Function JoyY#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Up, 1.0 if Down or a value inbetween. |
Description | Reports the vertical position of the joystick. |
Function JoyYaw#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Up, 1.0 if Down or a value inbetween. |
Description | Reports the position of the joystick's YAW axis if supported. |
Function JoyZ#( port=0 ) | |
Returns | Zero if the joystick is centered, -1.0 if Up, 1.0 if Down or a value inbetween. |
Description | Reports the position of the joystick's Z axis if supported. |
Version | 1.08 |
---|---|
Author | Simon Armstrong |
License | Public Domain |
Copyright | Blitz Research Ltd |
Modserver | BRL |
History | 1.08 Release |
History | Added JoyHit samplejoy fix, thanks to HamishTheHystericalHamster |
History | 1.07 Release |
History | Added MacOSX Rx,Ry,Rz (JoyR,JoyU,JoyV) and Wheel |
History | 1.06 Release |
History | Enabled Apple Gamepad and MultiAxis HID classes |
History | 1.05 Release |
History | Fixed Linux C Compiler warnings |
History | 1.04 Release |
History | Fixed C Compiler warnings |