How to use the Z's Tilt and Pivot inputs for analog joystick control

The Z operates as a DirectInput joystick. So its joystick outputs will only work natively in games with support for DirectInput.
For games that only support XInput a third-party utility is required to translate DirectInput to XInput (e.g. X360ce).

To use your Z mouse like a joystick you need to map "Analog Left/Right" and "Analog Forward/Back" to control Joystick Axis X and Y respectively. The gif below demonstrates the creation of these two mappings.

Once created set the profile as active and use https://html5gamepad.com to check if its working. You should see Axis 0 and Axis 1 change as you tilt the mouse around.

Your mapping is now ready to be used, but you can also tune the min and max input angles of your tilt to control sensitivity and dead-zones, or adjust the output range if you want to limit the minimum or maximum output on any axis.

 

If you also want to map Pivot to Yaw this works a bit differently. Since its very difficult to move the mouse normally without also pivoting, pivot is not available as a base input. Instead it should be nested in another input. Meaning you hold down a button to activate Pivot.

The following gif shows how to create such a pivot mapping:

The "Reset Pivot (Yaw)" action added on button press is strongly recommend to ensure that your pivot always starts in a neutral position. Depending on your use case you may also want to add it on button release so the pivot output does not remain active after you have released the button.

If you want to try and use Pivot as a base input there is a workaround covered in the article below.

Enable Pivot without a parent input

• Related Articles

• X1 Control Panel Expert Mode Overview

  Main Menu Starting from the top left of the Control Panels window you will find the Main Menu. Here you can access some of the key functionality detailed below. Save Mappings to Permanent Flash Memory in Mouse: This option allows you to export all of ...

• Using Analog functions in games without DirectInput support

  When you plug in The Z Mouse, the PC automatically recognizes it as an analog controller, meaning any game that has an analog joystick support can interpret The Z’s pitch, roll  and yaw as an analog joystick movement. If your joystick mappings are ...

• Z's joystick capabilities are interfering with my other Joystick; or adversely effecting controls in specific games.

  The joystick functions in our classic grip mice can be disabled temporarily within Device Manager. Which can be accessed via control panel, or by right clicking the Start Menu. Within device manager expand the "Human Interface Devices" section, then ...

• Swiftpoint Z Hardware Manual

  You can download the Zs User Guides from the links below: Z Quick Start Guide English Z Quick Start Guide French Z Quick Start Guide German Z Quick Start Guide Spanish Z Quick Start Guide Japanese Z Quick Start Guide Korean

• Tilt or Pivot Mappings are not responding

  If any of your tilt or pivot mappings are not working , try setting the OLED mode on your profile to "Tilt Angles". This will display the current Roll, Pitch, and Yaw, values from the gyroscope, so you can identify if they are responding correctly. ...