File	Date	Author	Commit
.settings	2022-11-17	Oddwarg	[996d1d] Initial import
lib	2022-11-17	oddwarg	[998176] Added jinput license and windows icon
src	2023-01-30	oddwarg	[17cd12] Fixed bug where changing the controller did not...
.classpath	2022-11-17	Oddwarg	[996d1d] Initial import
.hgignore	2024-01-23	oddwarg	[9c3aea] Ignore temp file
.project	2022-11-17	Oddwarg	[996d1d] Initial import
Readme.txt	2022-11-17	oddwarg	[de23a7] Minor readme update
screenshot.png	2022-11-17	oddwarg	[546aee] Added screenshot
windowsIcon.ico	2022-11-17	oddwarg	[998176] Added jinput license and windows icon

Read Me

       ___            ________      _ __         __  ___                 
      / _ \__ _____ _/ / __/ /_____(_) /_____   /  |/  /__  __ _____ ___ 
     / // / // / _ `/ /\ \/ __/ __/ /  '_/ -_) / /|_/ / _ \/ // (_-</ -_)
    /____/\_,_/\_,_/_/___/\__/_/ /_/_/\_\\__/ /_/  /_/\___/\_,_/___/\__/
   ___________________________________________________________________
  /                                                                  /
 /    Control the mouse cursor using a SideWinder Dual Strike.      /
/__________________________________________________________________/

This software application attempts to replicate some of the functionality
of the  SideWinder Game Software 4.0, where it allowed you to control the
mouse cursor using a SideWinder Dual Strike USB controller.


-- Running the application --

First, extract the DualStrikeMouse folder from the zip archive to a
directory of your choice.

This is a Java 6 application. For Windows Vista 64-bit and later, the
provided executable automatically locates/downloads the Java runtime as
needed, and starts the software.

For other operating systems, you will need to install a suitable Java
runtime yourself, then run the file DualStrikeMouse.jar.

Mac OS is not supported. It may or may not work.


-- Limitations --

This software does not map button presses to keypresses. This can be
accomplished by running a software like Joy2Key for Windows or
AntiMicro for Linux alongside this software.

This software does not simulate a hardware mouse; Some video games are
programmed in such a way that they do not respond to the mouse movement
events generated by this application.


-- Basic physical operation --

-When moving the handle in the central aiming zone, the mouse cursor will
 track the handle movement.
-When pushing the handle into the outer spin zones, the mouse cursor will
 keep moving in the direction you are pushing.
-When pressing the Return-To-Center button, the mouse cursor is released,
 allowing you to re-center the handle, much like you would reposition a
 regular mouse by lifting it off the mouse mat.

This software also adds optional momentum to the mouse cursor when the
Return-To-Center button is pressed, allowing you to fling the cursor in
a manner similar to a trackball.


-- Configuration options --

This software comes with a graphical user interface (GUI) configurator.

The window minimises to the system tray, if your system supports it.

The GUI controls have tooltip text, which appear if you hold the mouse
still over the controls.

The software will automatically load the configuration from the file
dualstrike.conf in the current directory, if it exists. This file can be
created by pressing the save button at the bottom of the GUI.


-- Command line usage --

To run the software from the command line, cd to the application folder,
and run the following command:
java -jar DualStrikeMouse.jar

To run the software without the GUI:
Windows command:
java -cp DualStrikeMouse.jar;DualStrikeMouse_lib/* ^
         owg.dualstrike.DualStrike dualstrike.conf
Linux command:
java -cp DualStrikeMouse.jar:DualStrikeMouse_lib/* \
         owg.dualstrike.DualStrike dualstrike.conf

Note this requires you to first create dualstrike.conf using the GUI.


-- Troubleshooting --

1. The application fails to save the configuration file:
You probably need to obtain write permissions in the application folder.
Refer to your operating system manual or system administrator.

2. "Permission denied"/"not marked as executable" when trying to run:
You need to obtain execute permissions for the jar file.
Refer to your operating system manual or system administrator.

3. The cursor does not move when the handle is near the center:
The controller likely needs to be calibrated in the OS to remove the dead
zone. In Linux, this is typically done with jscal or jstest-gtk.

4. The configuration file is loaded/saved in the wrong location:
The application will use the current directory for this. Try the command
line usage, making sure to cd to the application directory first.

5. The GUI is too large/small:
You need to manually set the scaling on the command line:
java -jar -Dhubol.ui.scale=1 DualStrikeMouse.jar
Or:
java -jar -Dhubol.ui.scale=2 DualStrikeMouse.jar


-- Links --
Source code: https://dualstrike-mouse.sourceforge.io
Donate: https://ko-fi.com/oddwarg