# HG changeset patch
# User Sam Lantinga <slouken@libsdl.org>
# Date 1259350167 0
# Node ID 78fc8ea578b2b39c1cdd0f2ae2d55b93cb3c5e72
# Parent  1b22878e04d0715937ad20d99c97dc1eb8c13524
Joe 2009-11-23 21:31:10 PST

If type is ::SDL_HAPTIC_CARTESIAN, direction is encoded by three positions
367     *  (X axis, Y axis and Z axis (with 3 axes)).  ::SDL_HAPTIC_CARTESIAN
uses
368     *  the first three \c dir parameters.  The cardinal directions would
be:
369     *   - North:  0,-1, 0
370     *   - East:  -1, 0, 0
371     *   - South:  0, 1, 0
372     *   - West:   1, 0, 0

typedef struct SDL_HapticDirection
{
    Uint8 type;         /**< The type of encoding. */
    Uint16 dir[3];      /**< The encoded direction. */
} SDL_HapticDirection;

An unsigned int can't store negative values and I don't see an alternate way to
encode them in the docs or source. The best I have been able to come up with is
using a negative magnitude for the effect but this will only get me 2 of the 4
quadrants in the plane for 2d effects. I looked at the win32 and linux
implementations and I believe is is safe to use signed ints in the direction
struct. I am unfamiliar with the darwin haptics API so I don't know if it is
safe.

diff -r 1b22878e04d0 -r 78fc8ea578b2 include/SDL_haptic.h
--- a/include/SDL_haptic.h	Fri Nov 27 03:11:26 2009 +0000
+++ b/include/SDL_haptic.h	Fri Nov 27 19:29:27 2009 +0000
@@ -411,7 +411,7 @@
 typedef struct SDL_HapticDirection
 {
     Uint8 type;         /**< The type of encoding. */
-    Uint16 dir[3];      /**< The encoded direction. */
+    Sint32 dir[3];      /**< The encoded direction. */
 } SDL_HapticDirection;