AminetAminet
Search:
84734 packages online
About
Recent
Browse
Search
Upload
Setup
Services

util/mouse/ajoy2mouse.lha

Mirror:Random
Showing: generic icon
No screenshot available
Short:Control mouse with analog joystick
Author:Aardvark, (original AnalogMouse by Piotr Pawlow)
Type:util/mouse
Version:1.0
Architecture:m68k-amigaos
Date:2022-02-17
Requires:68020
Download:util/mouse/ajoy2mouse.lha - View contents
Readme:util/mouse/ajoy2mouse.readme
Downloads:1588

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.


Contents of util/mouse/ajoy2mouse.lha
PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                 1448    2670  54.2% -lh5- 4c0c Feb 16 18:26 ajoy2mouse.info
[unknown]                 3519    8380  42.0% -lh5- 605e Feb 16 16:13 ajoy2mouse/ajoy2mouse
[unknown]                 4729   16140  29.3% -lh5- 4fec Feb 16 16:13 ajoy2mouse/source/ajoy2mouse.s
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total         3 files    9696   27190  35.7%            Feb 17 04:46
Page generated in 0.01 seconds
Aminet © 1992-2024 Urban Müller and the Aminet team. Aminet contact address: <aminetaminet net>