> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Axis

> Axis

# Axis

Definition of the mapping of touch controls to the physical analog control equivalent.

## Properties

[`input`- *string*](#inputs). The type of touch [input](#inputs) that this control accepts.\
[`output` - *string*](#outputs). The gamepad axes, axis, or polar joystick action this control maps to.\
[`deadzone`](/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone) - [*object*](/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone), *optional*. The size and shape, of the area where no input will be read or mapped.\
`sensitivity` - *number*, *optional*. Multiplier applied after response curve calculation.\
[`responseCurve` - *object*](/reference/system/touchadaptationkit/types/game-streaming-touch-responsecurve), *optional*. Shape of the [response curve](/reference/system/touchadaptationkit/types/game-streaming-touch-responsecurve).

<a id="inputs" />

### Input values

| Constant  | Description                                         |
| :-------- | :-------------------------------------------------- |
| axisXY    | Full 2D input, reads both X-axis and Y-axis values. |
| axisX     | 1D input, only reads X-axis values.                 |
| axisY     | 1D input, only reads Y-axis values.                 |
| axisUp    | Polar input.                                        |
| axisDown  | Polar input.                                        |
| axisLeft  | Polar input.                                        |
| axisRight | Polar input.                                        |

<a id="outputs" />

### Output values

| Constant           | Description                                          |
| :----------------- | :--------------------------------------------------- |
| leftJoystick       | 2D output to the left joystick.                      |
| rightJoystick      | 2D output to the right joystick.                     |
| leftJoystickX      | 1D ouptut to the left joystick X-axis.               |
| leftJoystickY      | 1D ouptut to the left joystick Y-axis.               |
| rightJoystickX     | 1D ouptut to the right joystick X-axis.              |
| rightJoystickY     | 1D ouptut to the left joystick Y-axis.               |
| leftJoystickLeft   | Polar output to the left joystick, left direction.   |
| leftJoystickRight  | Polar output to the left joystick, right direction.  |
| leftJoystickUp     | Polar output to the left joystick, up direction.     |
| leftJoystickDown   | Polar output to the left joystick, down direction.   |
| rightJoystickLeft  | Polar output to the right joystick, left direction.  |
| rightJoystickRight | Polar output to the right joystick, right direction. |
| rightJoystickUp    | Polar output to the right joystick, up direction.    |
| rightJoystickDown  | Polar output to the right joystick, down direction.  |
| relativeMouse      | 2D output to the mouse.                              |
| relativeMouseX     | 1D output to the mouse X-axis.                       |
| relativeMouseY     | 2D output to the mouse Y-axis.                       |
| relativeMouseLeft  | Polar output to the mouse, left direction.           |
| relativeMouseRight | Polar output to the mouse right direction.           |
| relativeMouseUp    | Polar output to the mouse, up direction.             |
| relativeMouseDown  | Polar output to the mouse, down direction.           |

## Remarks

A 2D input must map to a 2D output, similarly a 1D input must map to a 1D output, and a single direction must map to a polar output.

## Related Controls

[Accelerometer](/reference/system/touchadaptationkit/sensor-controls/game-streaming-touch-accelerometer)\
[Gyroscope](/reference/system/touchadaptationkit/sensor-controls/game-streaming-touch-gyroscope)\
[Joystick](/reference/system/touchadaptationkit/controls/game-streaming-touch-joystick)\
[Throttle](/reference/system/touchadaptationkit/controls/game-streaming-touch-throttle)
[Touchpad](/reference/system/touchadaptationkit/controls/game-streaming-touch-touchpad)

## See Also

[Touch Adaptation Kit Reference](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Deadzone](/reference/system/touchadaptationkit/types/game-streaming-touch-deadzone)\
[Response Curve](/reference/system/touchadaptationkit/types/game-streaming-touch-responsecurve)


## Related topics

- [GetExtraAxisIndexes](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxisindexes.md)
- [GameInputAxisMapping](/reference/input/gameinput/structs/gameinputaxismapping.md)
- [GetExtraAxisCount](/reference/input/gameinput/interfaces/igameinputdevice/methods/igameinputdevice_getextraaxiscount.md)
- [GameInputControllerAxisInfo](/reference/input/gameinput/deprecated/structs/gameinputcontrolleraxisinfo.md)
- [D3D12_AXIS_SHADING_RATE (XBOX Series consoles)](/reference/graphics/d3d12/enums/d3d12_axis_shading_rate_public.md)
