SDL_HapticDirection

A structure that contains a haptic direction. Does this structure define individual directions or a set of directions used by a particular device? Seems like you'd have to create an awful lot of these structures to make anything with any complexity. Am I understanding this correctly?

Data Fields

There was a [3] attached to dir but I thought I remembered that we aren't including those details here. Is that right or should I put it back in because it's important?

Code Examples

Example of force coming from the south with all encodings (force coming from the south means the user will have to pull the stick to counteract):

SDL_HapticDirection direction;

// Cartesian directions
direction.type = SDL_HAPTIC_CARTESIAN; // Using cartesian direction encoding.
direction.dir[0] = 0; // X position
direction.dir[1] = 1; // Y position
// Assuming the device has 2 axes, we don't need to specify third parameter.

// Polar directions
direction.type = SDL_HAPTIC_POLAR; // We'll be using polar direction encoding.
direction.dir[0] = 18000; // Polar only uses first parameter

// Spherical coordinates
direction.type = SDL_HAPTIC_SPHERICAL; // Spherical encoding
direction.dir[0] = 9000; // Since we only have two axes we don't need more parameters.

Remarks

This is the direction where the force comes from, instead of the direction in which the force is exerted.

Cardinal directions of the haptic device are relative to the positioning of the device. North is considered to be away from the user. South is toward the user, east is right, and west is left of the user.

The following diagram represents the cardinal directions:

               .--.
               |__| .-------.
               |=.| |.-----.|
               |--| ||     ||
               |  | |'-----'|
               |__|~')_____('
                [ COMPUTER ]


                 North (0,-1)
                      ^
                      |
                      |
(-1,0) West <----[ HAPTIC ]----> East (1,0)
                      |
                      |
                      v
                 South (0,1)


                 [ USER ]
                   \|||/
                   (o o)
             ---ooO-(_)-Ooo---

The following paragraph was at the beginning in the header. Seemed to logically fit better here.
Directions can be specified by:

If type is SDL_HAPTIC_POLAR, direction is encoded by hundredths of a degree starting north and turning clockwise. SDL_HAPTIC_POLAR only uses the first dir parameter. The cardinal directions would be:

If type is SDL_HAPTIC_CARTESIAN, direction is encoded by three positions (X axis, Y axis and Z axis (with 3 axes)). SDL_HAPTIC_CARTESIAN uses the first three dir parameters. The cardinal directions would be:

• The Z axis represents the height of the effect if supported, otherwise it's unused. In cartesian encoding (1, 2) would be the same as (2, 4), you can use any multiple you want, only the direction matters.

If type is SDL_HAPTIC_SPHERICAL, direction is encoded by two rotations. The first two dir parameters are used. The dir parameters are as follows (all values are in hundredths of degrees):

Related Structures

• SDL_HapticPeriodic

Related Functions

• SDL_HapticNumAxes

CategoryStruct, CategoryForceFeedback