This program controls mouse pointer with an analog joystick in a way that is
suitable for Macintosh flight simulators on Shapeshifter.
It is modification of AnalogMouse source code
https://aminet.net/package/util/mouse/AnalogMouse
The AnalogMouse author Piotr Pawlow states that his program can be freely
edited and shared, so I hope this upload is ok.
Most Mac flight sims have implemented mouse control method where the vehicular
control is determined by mouse pointer's relative position to screen center.
The original AnalogMouse doesn't work well with these games, as centering the
joystick just stops the pointer and doesn't bring it back to center.
In this version, every joystick PotX and PotY position has corresponding
screen coordinates, which are calculated using user given arguments.
Requirements:
--------------
- KS 2.0+
- 68020+
- Analog joystick and information of it's deflection values (AnaCal can
provide this information https://aminet.net/package/driver/input/anacal )
Usage:
-------
AJoy2Mouse has following arguments template:
CENTERX=CX/N,CENTERY=CY/N,XFRAME=XF/N,YFRAME=YF/N,MINPOTX=MINX/N,
MAXPOTX=MAXX/N,MINPOTY=MINY/N,MAXPOTY=MAXY/N,PAUSEKEY=PK/N,QUITKEY=QK/N,
SWITCHB=SB/S,BUTTONKEY=BK/N,HELP/S
CENTERX:
X screen coordinate for the mouse pointer when joystick's X axis is
centered. If argument is not given, then CENTERX=XFRAME/2
CENTERY:
Same as above but for Y.
XFRAME:
X movement range of the mouse pointer, centered to CENTERX coordinate.
Default value is 640 if argument is not given.
YFRAME:
Same as above but for Y. Default value is 480.
MINPOTX:
PotX value when joystick is extreme left. Default value is 0.
MAXPOTX:
PotX value when joystick is extreme right. This argument is required.
AnaCal can provide this value:
https://aminet.net/package/driver/input/anacal
MINPOTY:
PotY value when joystick is extreme forward. Default value is 0.
MAXPOTY:
PotY value when joystick is extreme back. This argument is required.
PAUSEKEY:
Decimal rawkey code for Pause key. Default is 70 (Del key). This key
will suspend/resume the program, and gives pointer control back to the
mouse.
QUITKEY:
Decimal rawkey code for Quit key. Default is 95 (Help key). This key
exits the program. Only works when Paused.
SWITCHB:
Switches functions of joystick buttons 1 and 2.
BUTTONKEY:
Decimal rawkey code for mapping joystick button 2 to keyboard key. If
not specified then button 2 acts as a right mouse button. This can be
glitchy in Shapeshifter, as it may not release the key until you press
some key on keyboard. Still, it functions properly in some Mac games,
like X-Wing.
HELP:
Brief description of these arguments.
Examples:
---------
Example 1: Star Wars: X-Wing, RTG 640x480 screenmode
AJoy2Mouse MAXPOTX 44 MAXPOTY 40 BUTTONKEY 22 SWITCHB
I use above line with X-Wing. XFRAME and YFRAME not needed in this case, since
640 and 480 are their default values. BUTTONKEY 22 maps 2nd button to U
(Select ship within target sight)
Example 2: Chuck Yeager's Air Combat, RTG 640x480 screenmode
AJoy2Mouse MAXPOTX 44 MAXPOTY 40 XFRAME 454 YFRAME 320 CENTERX 320 CENTERY 218
This game has a benefit of HUD display that shows effective movement range and
exact null zone, so X/YFRAME and CENTERX/Y arguments can be set precisely.
ShapeShifter Graphics Settings:
--------------------------------
Make sure that "Amiga mouse pointer" setting is selected.
External Picasso96 driver doesn't display the Amiga pointer for some reason,
but controlling still works. ShapeShifter's internal CyberGfx/P96 driver, and
MuEVD driver works properly.
Compatible Mac Games:
----------------------
A-10 Attack!
A-10 Cuba!
Chuck Yeager's Air Combat
Comanche Mac
F-117A Nighthawk Stealth Fighter 2.0
F/A-18 Hornet v1 and v2
Flying Nightmares
Hellcats Over the Pacific
Out of the Sun
Red Baron
Star Wars: X-Wing
If there's any questions, feel free to contact Aardvark on EAB.
|