zenilib
0.5.3.0
|
Structure that represents a haptic direction. More...
#include <SDL_haptic.h>
Public Attributes | |
Sint32 | dir [3] |
Uint8 | type |
Structure that represents a haptic direction.
Directions can be specified by:
Cardinal directions of the haptic device are relative to the positioning of the device. North is considered to be away from 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---
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):
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):
Definition at line 439 of file SDL_haptic.h.
Sint32 SDL_HapticDirection::dir[3] |
The encoded direction.
Definition at line 442 of file SDL_haptic.h.
Uint8 SDL_HapticDirection::type |
The type of encoding.
Definition at line 441 of file SDL_haptic.h.