Programming the Extended Joystick

• Extended Joystick Resistors
• Calibrating the Extended Joystick
• Recommended Sequence for Setup

Extended Joystick Resistors

• Even when idle, the joystick registers movement. Therefore if you ask for any of the axis data, you typically get new events at every vertical refresh. Make sure that your program code expects this. If it takes more than one frame-time to draw its graphics, for example, there are likely to be many events in your input queue that must be processed before you get the most current one.

• Because the data tends to jump around, you must filter the input before use. The feel of a title depends on the kind of filtering you do (which is why the device driver doesn't do it), and you are encouraged to develop your own filters.

Calibrating the Extended Joystick

The purpose of a setup routine for the joystick is to:

• Allow the user to center the trim controls (x and y calibration) so that an un-touched stick registers about 512 for both the stk_HorizPosition and stk_VertPosition (x and y) axes.

• Determine a nominal maximum and minimum range for each axis that the title uses (i.e., x, y, and z if all three are used).

The purpose of extended joystick autorecalibration is to:

• Get the most dynamic range possible from the joystick. In other words, to always use all of the bits provided by the joystick.

• Compensate for any possible change of extreme values. Although theoretically the device is capable of a range of from 0-1024, joysticks are unlikely to produce this full range. Therefore you must perform some calibration, and use the results to map actual input values to the values the title expects to see. These values also can vary during use, so use autoranging with continuous recalibration for maximum sensitivity at all times.

Recommended Sequence for Setup

1. Over a background image, center a small cursor over a target using just the trim controls. Position the cursor so that a value of 512 in the stk_HorizPosition and stk_VertPosition elements of the StickEventData structure place it visually in the center of the target.

   When the cursor is centered, press the Play button on the base of the consumer joystick; this is to encourage the hands-free aspect of this part of the setup.

2. Move the stick to the top-left corner of its range and depress the Fire button.

3. Move the stick to the bottom-right corner of its range and depress the Fire button.

   If stk_DepthPosition (z) is being used, roll the Auxiliary Axis control away from you to the extreme end position and press the Fire button.

4. Roll the Auxiliary control towards you to the extreme end position and press the Fire button.