src/haptic/darwin/SDL_syshaptic.c
author Edgar Simo <bobbens@gmail.com>
Tue, 22 Jul 2008 11:40:43 +0000
branchgsoc2008_force_feedback
changeset 2546 daf40497dcd4
parent 2543 3544a632064c
child 2547 3cfe0ae232c0
permissions -rw-r--r--
Attempt to fix HIDGetDeviceProduct.
bobbens@2520
     1
/*
bobbens@2520
     2
    SDL - Simple DirectMedia Layer
bobbens@2520
     3
    Copyright (C) 2008 Edgar Simo
bobbens@2520
     4
bobbens@2520
     5
    This library is free software; you can redistribute it and/or
bobbens@2520
     6
    modify it under the terms of the GNU Lesser General Public
bobbens@2520
     7
    License as published by the Free Software Foundation; either
bobbens@2520
     8
    version 2.1 of the License, or (at your option) any later version.
bobbens@2520
     9
bobbens@2520
    10
    This library is distributed in the hope that it will be useful,
bobbens@2520
    11
    but WITHOUT ANY WARRANTY; without even the implied warranty of
bobbens@2520
    12
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
bobbens@2520
    13
    Lesser General Public License for more details.
bobbens@2520
    14
bobbens@2520
    15
    You should have received a copy of the GNU Lesser General Public
bobbens@2520
    16
    License along with this library; if not, write to the Free Software
bobbens@2520
    17
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
bobbens@2520
    18
bobbens@2520
    19
    Sam Lantinga
bobbens@2520
    20
    slouken@libsdl.org
bobbens@2520
    21
*/
bobbens@2520
    22
#include "SDL_config.h"
bobbens@2520
    23
bobbens@2520
    24
#ifdef SDL_HAPTIC_IOKIT
bobbens@2520
    25
bobbens@2520
    26
#include "SDL_haptic.h"
bobbens@2520
    27
#include "../SDL_syshaptic.h"
bobbens@2520
    28
#include "SDL_joystick.h"
bobbens@2520
    29
#include "../../joystick/SDL_sysjoystick.h" /* For the real SDL_Joystick */
bobbens@2520
    30
/*#include "../../joystick/dawrin/SDL_sysjoystick_c.h"*/ /* For joystick hwdata */ 
bobbens@2520
    31
bobbens@2522
    32
#include <IOKit/IOKitLib.h>
bobbens@2522
    33
#include <IOKit/hid/IOHIDKeys.h>
bobbens@2520
    34
#include <ForceFeedback/ForceFeedback.h>
bobbens@2520
    35
#include <ForceFeedback/ForceFeedbackConstants.h>
bobbens@2520
    36
bobbens@2520
    37
bobbens@2520
    38
#define MAX_HAPTICS  32
bobbens@2520
    39
bobbens@2520
    40
bobbens@2520
    41
/*
bobbens@2520
    42
 * List of available haptic devices.
bobbens@2520
    43
 */
bobbens@2520
    44
static struct
bobbens@2520
    45
{
bobbens@2537
    46
   char name[256];
bobbens@2520
    47
   io_service_t dev;
bobbens@2520
    48
   SDL_Haptic *haptic;
bobbens@2520
    49
} SDL_hapticlist[MAX_HAPTICS];
bobbens@2520
    50
bobbens@2520
    51
bobbens@2520
    52
/*
bobbens@2520
    53
 * Haptic system hardware data.
bobbens@2520
    54
 */
bobbens@2520
    55
struct haptic_hwdata
bobbens@2520
    56
{
bobbens@2520
    57
   FFDeviceObjectReference device; /* Hardware device. */
bobbens@2520
    58
};
bobbens@2520
    59
bobbens@2520
    60
bobbens@2520
    61
/*
bobbens@2520
    62
 * Haptic system effect data.
bobbens@2520
    63
 */
bobbens@2520
    64
struct haptic_hweffect
bobbens@2520
    65
{
bobbens@2520
    66
   FFEffectObjectReference ref; /* Reference. */
bobbens@2520
    67
   struct FFEFFECT effect; /* Hardware effect. */
bobbens@2520
    68
};
bobbens@2520
    69
bobbens@2531
    70
/*
bobbens@2531
    71
 * Prototypes.
bobbens@2531
    72
 */
bobbens@2537
    73
static void SDL_SYS_HapticFreeFFEFFECT(FFEFFECT * effect, int type);
bobbens@2537
    74
static int HIDGetDeviceProduct(io_service_t dev, char * name);
bobbens@2531
    75
bobbens@2520
    76
bobbens@2541
    77
/* 
bobbens@2541
    78
 * Like strerror but for force feedback errors.
bobbens@2541
    79
 */
bobbens@2541
    80
static const char *
bobbens@2541
    81
FFStrError(HRESULT err)
bobbens@2541
    82
{
bobbens@2541
    83
   switch (err) {
bobbens@2541
    84
      case FFERR_DEVICEFULL:
bobbens@2541
    85
         return "device full";
bobbens@2543
    86
      /*case FFERR_DEVICENOTREG:
bobbens@2543
    87
         return "device not registered";*/
bobbens@2541
    88
      case FFERR_DEVICEPAUSED:
bobbens@2541
    89
         return "device paused";
bobbens@2541
    90
      case FFERR_DEVICERELEASED:
bobbens@2541
    91
         return "device released";
bobbens@2541
    92
      case FFERR_EFFECTPLAYING:
bobbens@2541
    93
         return "effect playing";
bobbens@2541
    94
      case FFERR_EFFECTTYPEMISMATCH:
bobbens@2541
    95
         return "effect type mismatch";
bobbens@2541
    96
      case FFERR_EFFECTTYPENOTSUPPORTED:
bobbens@2541
    97
         return "effect type not supported";
bobbens@2541
    98
      case FFERR_GENERIC:
bobbens@2541
    99
         return "undetermined error";
bobbens@2541
   100
      case FFERR_HASEFFECTS:
bobbens@2541
   101
         return "device has effects";
bobbens@2541
   102
      case FFERR_INCOMPLETEEFFECT:
bobbens@2541
   103
         return "incomplete effect";
bobbens@2541
   104
      case FFERR_INTERNAL:
bobbens@2541
   105
         return "internal fault";
bobbens@2541
   106
      case FFERR_INVALIDDOWNLOADID:
bobbens@2541
   107
         return "invalid download id";
bobbens@2541
   108
      case FFERR_INVALIDPARAM:
bobbens@2541
   109
         return "invalid parameter";
bobbens@2541
   110
      case FFERR_MOREDATA:
bobbens@2541
   111
         return "more data";
bobbens@2541
   112
      case FFERR_NOINTERFACE:
bobbens@2541
   113
         return "interface not supported";
bobbens@2541
   114
      case FFERR_NOTDOWNLOADED:
bobbens@2541
   115
         return "effect is not downloaded";
bobbens@2541
   116
      case FFERR_NOTINITIALIZED:
bobbens@2541
   117
         return "object has not been initialized";
bobbens@2541
   118
      case FFERR_OUTOFMEMORY:
bobbens@2541
   119
         return "out of memory";
bobbens@2541
   120
      case FFERR_UNPLUGGED:
bobbens@2541
   121
         return "device is unplugged";
bobbens@2541
   122
      case FFERR_UNSUPPORTED:
bobbens@2541
   123
         return "function call unsupported";
bobbens@2541
   124
      case FFERR_UNSUPPORTEDAXIS:
bobbens@2541
   125
         return "axis unsupported";
bobbens@2541
   126
bobbens@2541
   127
      default:
bobbens@2541
   128
         return "unknown error";
bobbens@2541
   129
   }
bobbens@2541
   130
}
bobbens@2541
   131
bobbens@2541
   132
bobbens@2520
   133
/*
bobbens@2520
   134
 * Initializes the haptic subsystem.
bobbens@2520
   135
 */
bobbens@2520
   136
int
bobbens@2520
   137
SDL_SYS_HapticInit(void)
bobbens@2520
   138
{
bobbens@2520
   139
   int numhaptics;
bobbens@2520
   140
   IOReturn result;
bobbens@2520
   141
   io_iterator_t iter;
bobbens@2520
   142
   CFDictionaryRef match;
bobbens@2521
   143
   io_service_t device;
bobbens@2520
   144
bobbens@2537
   145
   /* Clear all the memory. */
bobbens@2537
   146
   SDL_memset(SDL_hapticlist, 0, sizeof(SDL_hapticlist));
bobbens@2537
   147
bobbens@2520
   148
   /* Get HID devices. */
bobbens@2520
   149
   match = IOServiceMatching(kIOHIDDeviceKey);
bobbens@2520
   150
   if (match == NULL) {
bobbens@2520
   151
      SDL_SetError("Haptic: Failed to get IOServiceMatching.");
bobbens@2520
   152
      return -1;
bobbens@2520
   153
   }
bobbens@2520
   154
bobbens@2520
   155
   /* Now search I/O Registry for matching devices. */
bobbens@2520
   156
   result = IOServiceGetMatchingServices(kIOMasterPortDefault, match, &iter);
bobbens@2520
   157
   if (result != kIOReturnSuccess) {
bobbens@2520
   158
      SDL_SetError("Haptic: Couldn't create a HID object iterator.");
bobbens@2520
   159
      return -1;
bobbens@2520
   160
   }
bobbens@2520
   161
   /* IOServiceGetMatchingServices consumes dictionary. */
bobbens@2520
   162
bobbens@2520
   163
   numhaptics = 0;
bobbens@2520
   164
   while ((device = IOIteratorNext(iter)) != IO_OBJECT_NULL) {
bobbens@2520
   165
bobbens@2520
   166
      /* Check for force feedback. */
bobbens@2520
   167
      if (FFIsForceFeedback(device) == FF_OK) {
bobbens@2537
   168
         HIDGetDeviceProduct(device, SDL_hapticlist[numhaptics].name);
bobbens@2520
   169
         SDL_hapticlist[numhaptics].dev = device;
bobbens@2520
   170
         SDL_hapticlist[numhaptics].haptic = NULL;
bobbens@2520
   171
         numhaptics++;
bobbens@2520
   172
      }
bobbens@2537
   173
      else { /* Free the unused device. */
bobbens@2537
   174
         IOObjectRelease(device);
bobbens@2537
   175
      }
bobbens@2520
   176
bobbens@2520
   177
      /* Reached haptic limit. */
bobbens@2520
   178
      if (numhaptics >= MAX_HAPTICS)
bobbens@2520
   179
         break;
bobbens@2520
   180
   }
bobbens@2520
   181
   IOObjectRelease(iter);
bobbens@2520
   182
bobbens@2520
   183
   return numhaptics;
bobbens@2520
   184
}
bobbens@2520
   185
bobbens@2520
   186
bobbens@2520
   187
/*
bobbens@2520
   188
 * Return the name of a haptic device, does not need to be opened.
bobbens@2520
   189
 */
bobbens@2520
   190
const char *
bobbens@2520
   191
SDL_SYS_HapticName(int index)
bobbens@2520
   192
{
bobbens@2537
   193
   return SDL_hapticlist[index].name;
bobbens@2537
   194
}
bobbens@2537
   195
bobbens@2537
   196
/*
bobbens@2537
   197
 * Gets the device's product name.
bobbens@2537
   198
 */
bobbens@2537
   199
static int
bobbens@2537
   200
HIDGetDeviceProduct(io_service_t dev, char *name)
bobbens@2537
   201
{
bobbens@2537
   202
   CFMutableDictionaryRef hidProperties, usbProperties;
bobbens@2537
   203
   io_registry_entry_t parent1, parent2;
bobbens@2546
   204
   kern_return_t ret;
bobbens@2537
   205
bobbens@2537
   206
   hidProperties = usbProperties = 0;
bobbens@2537
   207
bobbens@2546
   208
   ret = IORegistryEntryCreateCFProperties(hidDevice, &hidProperties,
bobbens@2546
   209
                                           kCFAllocatorDefault,
bobbens@2546
   210
                                           kNilOptions);
bobbens@2546
   211
   if ((ret != KERN_SUCCESS) || !hidProperties) {
bobbens@2546
   212
      SDL_SetError("Haptic: Unable to create CFProperties.");
bobbens@2546
   213
      return -1;
bobbens@2546
   214
   }
bobbens@2546
   215
bobbens@2537
   216
   /* Mac OS X currently is not mirroring all USB properties to HID page so need to look at USB device page also
bobbens@2537
   217
    * get dictionary for usb properties: step up two levels and get CF dictionary for USB properties
bobbens@2537
   218
    */
bobbens@2537
   219
   if ((KERN_SUCCESS ==
bobbens@2537
   220
            IORegistryEntryGetParentEntry(dev, kIOServicePlane, &parent1))
bobbens@2537
   221
         && (KERN_SUCCESS ==
bobbens@2537
   222
            IORegistryEntryGetParentEntry(parent1, kIOServicePlane, &parent2))
bobbens@2537
   223
         && (KERN_SUCCESS ==
bobbens@2537
   224
            IORegistryEntryCreateCFProperties(parent2, &usbProperties,
bobbens@2546
   225
                                              kCFAllocatorDefault,
bobbens@2546
   226
                                              kNilOptions))) {
bobbens@2537
   227
      if (usbProperties) {
bobbens@2537
   228
         CFTypeRef refCF = 0;
bobbens@2537
   229
         /* get device info
bobbens@2537
   230
          * try hid dictionary first, if fail then go to usb dictionary
bobbens@2537
   231
          */
bobbens@2537
   232
bobbens@2537
   233
bobbens@2537
   234
         /* Get product name */
bobbens@2546
   235
         refCF = CFDictionaryGetValue(hidProperties, CFSTR(kIOHIDProductKey));
bobbens@2537
   236
         if (!refCF)
bobbens@2537
   237
            refCF =
bobbens@2537
   238
               CFDictionaryGetValue(usbProperties, CFSTR("USB Product Name"));
bobbens@2537
   239
         if (refCF) {
bobbens@2537
   240
            if (!CFStringGetCString(refCF, name, 256,
bobbens@2537
   241
                                    CFStringGetSystemEncoding())) {
bobbens@2537
   242
               SDL_SetError("CFStringGetCString error retrieving pDevice->product.");
bobbens@2537
   243
               return -1;
bobbens@2537
   244
            }
bobbens@2537
   245
         }
bobbens@2537
   246
bobbens@2537
   247
         CFRelease(usbProperties);
bobbens@2537
   248
      }
bobbens@2537
   249
      else {
bobbens@2537
   250
         SDL_SetError("IORegistryEntryCreateCFProperties failed to create usbProperties.");
bobbens@2537
   251
         return -1;
bobbens@2537
   252
      }
bobbens@2537
   253
bobbens@2537
   254
      /* Release stuff. */
bobbens@2537
   255
      if (kIOReturnSuccess != IOObjectRelease(parent2)) {
bobbens@2537
   256
         SDL_SetError("IOObjectRelease error with parent2.");
bobbens@2537
   257
      }
bobbens@2537
   258
      if (kIOReturnSuccess != IOObjectRelease(parent1))  {
bobbens@2537
   259
         SDL_SetError("IOObjectRelease error with parent1.");
bobbens@2537
   260
      }
bobbens@2537
   261
   }
bobbens@2546
   262
   else {
bobbens@2546
   263
      SDL_SetError("Haptic: Error getting registry entries.");
bobbens@2546
   264
      return -1;
bobbens@2546
   265
   }
bobbens@2546
   266
bobbens@2537
   267
   return 0;
bobbens@2520
   268
}
bobbens@2520
   269
bobbens@2520
   270
bobbens@2520
   271
#define FF_TEST(ff, s) \
bobbens@2520
   272
if (features.supportedEffects & ff) supported |= s
bobbens@2520
   273
/*
bobbens@2520
   274
 * Gets supported features.
bobbens@2520
   275
 */
bobbens@2520
   276
static unsigned int
bobbens@2520
   277
GetSupportedFeatures(FFDeviceObjectReference device,
bobbens@2527
   278
                     int *neffects, int *nplaying, int *naxes)
bobbens@2520
   279
{
bobbens@2520
   280
   HRESULT ret;
bobbens@2520
   281
   FFCAPABILITIES features;
bobbens@2520
   282
   unsigned int supported;
bobbens@2520
   283
   Uint32 val;
bobbens@2520
   284
bobbens@2520
   285
   ret = FFDeviceGetForceFeedbackCapabilities(device, &features);
bobbens@2520
   286
   if (ret != FF_OK) {
bobbens@2520
   287
      SDL_SetError("Haptic: Unable to get device's supported features.");
bobbens@2520
   288
      return 0;
bobbens@2520
   289
   }
bobbens@2520
   290
bobbens@2520
   291
   supported = 0;
bobbens@2520
   292
bobbens@2520
   293
   /* Get maximum effects. */
bobbens@2520
   294
   *neffects = features.storageCapacity;
bobbens@2520
   295
   *nplaying = features.playbackCapacity;
bobbens@2520
   296
bobbens@2520
   297
   /* Test for effects. */
bobbens@2520
   298
   FF_TEST(FFCAP_ET_CONSTANTFORCE, SDL_HAPTIC_CONSTANT);
bobbens@2520
   299
   FF_TEST(FFCAP_ET_RAMPFORCE,     SDL_HAPTIC_RAMP);
bobbens@2520
   300
   FF_TEST(FFCAP_ET_SQUARE,        SDL_HAPTIC_SQUARE);
bobbens@2520
   301
   FF_TEST(FFCAP_ET_SINE,          SDL_HAPTIC_SINE);
bobbens@2520
   302
   FF_TEST(FFCAP_ET_TRIANGLE,      SDL_HAPTIC_TRIANGLE);
bobbens@2520
   303
   FF_TEST(FFCAP_ET_SAWTOOTHUP,    SDL_HAPTIC_SAWTOOTHUP);
bobbens@2520
   304
   FF_TEST(FFCAP_ET_SAWTOOTHDOWN,  SDL_HAPTIC_SAWTOOTHDOWN);
bobbens@2520
   305
   FF_TEST(FFCAP_ET_SPRING,        SDL_HAPTIC_SPRING);
bobbens@2520
   306
   FF_TEST(FFCAP_ET_DAMPER,        SDL_HAPTIC_DAMPER);
bobbens@2520
   307
   FF_TEST(FFCAP_ET_INERTIA,       SDL_HAPTIC_INERTIA);
bobbens@2520
   308
   FF_TEST(FFCAP_ET_FRICTION,      SDL_HAPTIC_FRICTION);
bobbens@2520
   309
   FF_TEST(FFCAP_ET_CUSTOMFORCE,   SDL_HAPTIC_CUSTOM);
bobbens@2520
   310
bobbens@2520
   311
   /* Check if supports gain. */
bobbens@2520
   312
   ret = FFDeviceGetForceFeedbackProperty(device, FFPROP_FFGAIN,
bobbens@2522
   313
                                          &val, sizeof(val));
bobbens@2520
   314
   if (ret == FF_OK) supported |= SDL_HAPTIC_GAIN;
bobbens@2520
   315
   else if (ret != FFERR_UNSUPPORTED) {
bobbens@2541
   316
      SDL_SetError("Haptic: Unable to get if device supports gain: %s.",
bobbens@2542
   317
                   FFStrError(ret));
bobbens@2520
   318
      return 0;
bobbens@2520
   319
   }
bobbens@2520
   320
bobbens@2520
   321
   /* Checks if supports autocenter. */
bobbens@2521
   322
   ret = FFDeviceGetForceFeedbackProperty(device, FFPROP_AUTOCENTER,
bobbens@2522
   323
                                          &val, sizeof(val));
bobbens@2520
   324
   if (ret == FF_OK) supported |= SDL_HAPTIC_AUTOCENTER;
bobbens@2520
   325
   else if (ret != FFERR_UNSUPPORTED) {
bobbens@2541
   326
      SDL_SetError("Haptic: Unable to get if device supports autocenter: %s.",
bobbens@2541
   327
                   FFStrError(ret));
bobbens@2520
   328
      return 0;
bobbens@2520
   329
   }
bobbens@2520
   330
bobbens@2527
   331
   /* Check for axes, we have an artificial limit on axes */
bobbens@2528
   332
   *naxes = ((features.numFfAxes) > 3) ?
bobbens@2527
   333
         3 : features.numFfAxes;
bobbens@2527
   334
bobbens@2520
   335
   /* Always supported features. */
bobbens@2520
   336
   supported |= SDL_HAPTIC_STATUS;
bobbens@2520
   337
   return supported;
bobbens@2520
   338
}
bobbens@2520
   339
bobbens@2520
   340
bobbens@2520
   341
/*
bobbens@2520
   342
 * Opens the haptic device from the file descriptor.
bobbens@2520
   343
 */
bobbens@2520
   344
static int
bobbens@2520
   345
SDL_SYS_HapticOpenFromService(SDL_Haptic * haptic, io_service_t service)
bobbens@2520
   346
{
bobbens@2541
   347
   HRESULT ret;
bobbens@2541
   348
bobbens@2520
   349
   /* Allocate the hwdata */
bobbens@2520
   350
   haptic->hwdata = (struct haptic_hwdata *)
bobbens@2520
   351
         SDL_malloc(sizeof(*haptic->hwdata));
bobbens@2520
   352
   if (haptic->hwdata == NULL) {
bobbens@2520
   353
      SDL_OutOfMemory();
bobbens@2520
   354
      goto creat_err;
bobbens@2520
   355
   }
bobbens@2520
   356
   SDL_memset(haptic->hwdata, 0, sizeof(*haptic->hwdata));
bobbens@2520
   357
  
bobbens@2520
   358
   /* Open the device */
bobbens@2541
   359
   ret = FFCreateDevice( service, &haptic->hwdata->device);
bobbens@2541
   360
   if (ret != FF_OK) {
bobbens@2541
   361
      SDL_SetError("Haptic: Unable to create device from service: %s.",
bobbens@2541
   362
                   FFStrError(ret));
bobbens@2520
   363
      goto creat_err;
bobbens@2520
   364
   }
bobbens@2520
   365
bobbens@2520
   366
   /* Get supported features. */
bobbens@2520
   367
   haptic->supported = GetSupportedFeatures(haptic->hwdata->device,
bobbens@2527
   368
                                            &haptic->neffects, &haptic->nplaying,
bobbens@2527
   369
                                            &haptic->naxes);
bobbens@2520
   370
   if (haptic->supported == 0) { /* Error since device supports nothing. */
bobbens@2520
   371
      goto open_err;
bobbens@2520
   372
   }
bobbens@2520
   373
   haptic->effects = (struct haptic_effect *)
bobbens@2520
   374
         SDL_malloc(sizeof(struct haptic_effect) * haptic->neffects);
bobbens@2520
   375
   if (haptic->effects == NULL) {
bobbens@2520
   376
      SDL_OutOfMemory();
bobbens@2520
   377
      goto open_err;
bobbens@2520
   378
   }
bobbens@2520
   379
   /* Clear the memory */
bobbens@2520
   380
   SDL_memset(haptic->effects, 0,
bobbens@2520
   381
         sizeof(struct haptic_effect) * haptic->neffects);
bobbens@2520
   382
   
bobbens@2520
   383
   return 0;
bobbens@2520
   384
   
bobbens@2520
   385
   /* Error handling */
bobbens@2520
   386
open_err:
bobbens@2520
   387
   FFReleaseDevice(haptic->hwdata->device);
bobbens@2520
   388
creat_err:
bobbens@2520
   389
   if (haptic->hwdata != NULL) {
bobbens@2520
   390
      free(haptic->hwdata);
bobbens@2520
   391
      haptic->hwdata = NULL;                                              
bobbens@2520
   392
   }
bobbens@2520
   393
   return -1;
bobbens@2520
   394
bobbens@2520
   395
}
bobbens@2520
   396
bobbens@2520
   397
bobbens@2520
   398
/*
bobbens@2520
   399
 * Opens a haptic device for usage.
bobbens@2520
   400
 */
bobbens@2520
   401
int
bobbens@2520
   402
SDL_SYS_HapticOpen(SDL_Haptic * haptic)
bobbens@2520
   403
{
bobbens@2520
   404
   return SDL_SYS_HapticOpenFromService(haptic,
bobbens@2522
   405
                SDL_hapticlist[haptic->index].dev);
bobbens@2520
   406
}
bobbens@2520
   407
bobbens@2520
   408
bobbens@2520
   409
/*
bobbens@2520
   410
 * Opens a haptic device from first mouse it finds for usage.
bobbens@2520
   411
 */
bobbens@2520
   412
int
bobbens@2520
   413
SDL_SYS_HapticMouse(void)
bobbens@2520
   414
{
bobbens@2520
   415
   return -1;
bobbens@2520
   416
}
bobbens@2520
   417
bobbens@2520
   418
bobbens@2520
   419
/*
bobbens@2520
   420
 * Checks to see if a joystick has haptic features.
bobbens@2520
   421
 */
bobbens@2520
   422
int
bobbens@2520
   423
SDL_SYS_JoystickIsHaptic(SDL_Joystick * joystick)
bobbens@2520
   424
{
bobbens@2520
   425
   return SDL_FALSE;
bobbens@2520
   426
}
bobbens@2520
   427
bobbens@2520
   428
bobbens@2520
   429
/*
bobbens@2520
   430
 * Checks to see if the haptic device and joystick and in reality the same.
bobbens@2520
   431
 */
bobbens@2520
   432
int
bobbens@2520
   433
SDL_SYS_JoystickSameHaptic(SDL_Haptic * haptic, SDL_Joystick * joystick)
bobbens@2520
   434
{
bobbens@2520
   435
   return 0;
bobbens@2520
   436
}
bobbens@2520
   437
bobbens@2520
   438
bobbens@2520
   439
/*
bobbens@2520
   440
 * Opens a SDL_Haptic from a SDL_Joystick.
bobbens@2520
   441
 */
bobbens@2520
   442
int
bobbens@2520
   443
SDL_SYS_HapticOpenFromJoystick(SDL_Haptic * haptic, SDL_Joystick * joystick)
bobbens@2520
   444
{
bobbens@2520
   445
   return -1;
bobbens@2520
   446
}
bobbens@2520
   447
bobbens@2520
   448
bobbens@2520
   449
/*
bobbens@2520
   450
 * Closes the haptic device.
bobbens@2520
   451
 */
bobbens@2520
   452
void
bobbens@2520
   453
SDL_SYS_HapticClose(SDL_Haptic * haptic)
bobbens@2520
   454
{
bobbens@2520
   455
   int i;
bobbens@2520
   456
bobbens@2520
   457
   if (haptic->hwdata) {
bobbens@2520
   458
bobbens@2530
   459
      /* Free the effects. */
bobbens@2530
   460
      for (i=0; i<haptic->neffects; i++) {        
bobbens@2530
   461
         if (haptic->effects[i].hweffect != NULL) {
bobbens@2535
   462
            SDL_SYS_HapticFreeFFEFFECT(&haptic->effects[i].hweffect->effect,
bobbens@2535
   463
                                       haptic->effects[i].effect.type);
bobbens@2530
   464
            SDL_free(haptic->effects[i].hweffect);
bobbens@2530
   465
         } 
bobbens@2530
   466
      }    
bobbens@2530
   467
      SDL_free(haptic->effects);
bobbens@2530
   468
      haptic->neffects = 0;
bobbens@2530
   469
bobbens@2520
   470
      /* Clean up */
bobbens@2520
   471
      FFReleaseDevice(haptic->hwdata->device);
bobbens@2520
   472
bobbens@2520
   473
      /* Free */
bobbens@2520
   474
      SDL_free(haptic->hwdata);
bobbens@2520
   475
      haptic->hwdata = NULL;
bobbens@2520
   476
   }
bobbens@2520
   477
}
bobbens@2520
   478
bobbens@2520
   479
bobbens@2520
   480
/* 
bobbens@2520
   481
 * Clean up after system specific haptic stuff
bobbens@2520
   482
 */
bobbens@2520
   483
void
bobbens@2520
   484
SDL_SYS_HapticQuit(void)
bobbens@2520
   485
{
bobbens@2520
   486
   int i;
bobbens@2520
   487
bobbens@2520
   488
   for (i=0; i < SDL_numhaptics; i++) {
bobbens@2530
   489
      /* Opened and not closed haptics are leaked, this is on purpose.
bobbens@2530
   490
       * Close your haptic devices after usage. */
bobbens@2530
   491
bobbens@2530
   492
      /* Free the io_service_t */
bobbens@2520
   493
      IOObjectRelease(SDL_hapticlist[i].dev);
bobbens@2520
   494
   }
bobbens@2520
   495
}
bobbens@2520
   496
bobbens@2520
   497
bobbens@2520
   498
/*
bobbens@2520
   499
 * Sets the direction.
bobbens@2520
   500
 */
bobbens@2520
   501
static int
bobbens@2529
   502
SDL_SYS_SetDirection( FFEFFECT * effect, SDL_HapticDirection *dir, int naxes )
bobbens@2520
   503
{
bobbens@2521
   504
   LONG *rglDir;
bobbens@2527
   505
bobbens@2527
   506
   /* Handle no axes a part. */
bobbens@2528
   507
   if (naxes == 0) {
bobbens@2527
   508
      effect->rglDirection = NULL;
bobbens@2527
   509
      return 0;
bobbens@2527
   510
   }
bobbens@2527
   511
bobbens@2527
   512
   /* Has axes. */
bobbens@2529
   513
   rglDir = SDL_malloc( sizeof(LONG) * naxes );
bobbens@2527
   514
   if (rglDir == NULL) {
bobbens@2520
   515
      SDL_OutOfMemory();
bobbens@2520
   516
      return -1;
bobbens@2520
   517
   }
bobbens@2529
   518
   SDL_memset( rglDir, 0, sizeof(LONG) * naxes );
bobbens@2521
   519
   effect->rglDirection = rglDir;
bobbens@2520
   520
bobbens@2520
   521
   switch (dir->type) {
bobbens@2520
   522
      case SDL_HAPTIC_POLAR:
bobbens@2520
   523
         effect->dwFlags |= FFEFF_POLAR;
bobbens@2521
   524
         rglDir[0] = dir->dir[0];
bobbens@2520
   525
         return 0;
bobbens@2520
   526
      case SDL_HAPTIC_CARTESIAN:
bobbens@2522
   527
         effect->dwFlags |= FFEFF_CARTESIAN;
bobbens@2521
   528
         rglDir[0] = dir->dir[0];
bobbens@2521
   529
         rglDir[1] = dir->dir[1];
bobbens@2521
   530
         rglDir[2] = dir->dir[2];
bobbens@2520
   531
         return 0;
bobbens@2521
   532
      case SDL_HAPTIC_SPHERICAL:
bobbens@2522
   533
         effect->dwFlags |= FFEFF_SPHERICAL;
bobbens@2521
   534
         rglDir[0] = dir->dir[0];
bobbens@2521
   535
         rglDir[1] = dir->dir[1];
bobbens@2521
   536
         rglDir[2] = dir->dir[2];
bobbens@2520
   537
         return 0;
bobbens@2520
   538
bobbens@2520
   539
      default:
bobbens@2520
   540
         SDL_SetError("Haptic: Unknown direction type.");
bobbens@2520
   541
         return -1;
bobbens@2520
   542
   }
bobbens@2520
   543
}
bobbens@2520
   544
bobbens@2520
   545
#define CONVERT(x)   (((x)*10000) / 0xFFFF )
bobbens@2520
   546
/*
bobbens@2527
   547
 * Creates the FFEFFECT from a SDL_HapticEffect.
bobbens@2520
   548
 */
bobbens@2520
   549
static int
bobbens@2527
   550
SDL_SYS_ToFFEFFECT( SDL_Haptic * haptic, FFEFFECT * dest, SDL_HapticEffect * src )
bobbens@2520
   551
{
bobbens@2530
   552
   int i;
bobbens@2520
   553
   FFCONSTANTFORCE *constant;
bobbens@2520
   554
   FFPERIODIC *periodic;
bobbens@2530
   555
   FFCONDITION *condition; /* Actually an array of conditions - one per axis. */
bobbens@2520
   556
   FFRAMPFORCE *ramp;
bobbens@2520
   557
   FFCUSTOMFORCE *custom;
bobbens@2522
   558
   FFENVELOPE *envelope;
bobbens@2520
   559
   SDL_HapticConstant *hap_constant;
bobbens@2521
   560
   SDL_HapticPeriodic *hap_periodic;
bobbens@2520
   561
   SDL_HapticCondition *hap_condition;
bobbens@2520
   562
   SDL_HapticRamp *hap_ramp;
bobbens@2535
   563
   SDL_HapticCustom *hap_custom;
bobbens@2527
   564
   DWORD *axes;
bobbens@2520
   565
bobbens@2520
   566
   /* Set global stuff. */
bobbens@2520
   567
   SDL_memset(dest, 0, sizeof(FFEFFECT));
bobbens@2520
   568
   dest->dwSize = sizeof(FFEFFECT); /* Set the structure size. */
bobbens@2520
   569
   dest->dwSamplePeriod = 0; /* Not used by us. */
bobbens@2520
   570
   dest->dwGain = 10000; /* Gain is set globally, not locally. */
bobbens@2522
   571
bobbens@2522
   572
   /* Envelope. */
bobbens@2522
   573
   envelope = SDL_malloc( sizeof(FFENVELOPE) );
bobbens@2522
   574
   if (envelope == NULL) {
bobbens@2522
   575
      SDL_OutOfMemory();
bobbens@2522
   576
      return -1;
bobbens@2522
   577
   }
bobbens@2522
   578
   SDL_memset(envelope, 0, sizeof(FFENVELOPE));
bobbens@2522
   579
   dest->lpEnvelope = envelope;
bobbens@2522
   580
   envelope->dwSize = sizeof(FFENVELOPE); /* Always should be this. */
bobbens@2520
   581
bobbens@2527
   582
   /* Axes. */
bobbens@2527
   583
   dest->cAxes = haptic->naxes;
bobbens@2527
   584
   if (dest->cAxes > 0) {
bobbens@2527
   585
      axes = SDL_malloc(sizeof(DWORD) * dest->cAxes);
bobbens@2527
   586
      if (axes == NULL) {
bobbens@2527
   587
         SDL_OutOfMemory();
bobbens@2527
   588
         return -1;
bobbens@2527
   589
      }
bobbens@2527
   590
      axes[0] = FFJOFS_X; /* Always at least one axis. */
bobbens@2527
   591
      if (dest->cAxes > 1) {
bobbens@2527
   592
         axes[1] = FFJOFS_Y;
bobbens@2527
   593
      }
bobbens@2527
   594
      if (dest->cAxes > 2) {
bobbens@2527
   595
         axes[2] = FFJOFS_Z;
bobbens@2527
   596
      }
bobbens@2527
   597
      dest->rgdwAxes = axes;
bobbens@2527
   598
   }
bobbens@2527
   599
bobbens@2527
   600
bobbens@2530
   601
   /* The big type handling switch, even bigger then linux's version. */
bobbens@2520
   602
   switch (src->type) {
bobbens@2520
   603
      case SDL_HAPTIC_CONSTANT:
bobbens@2520
   604
         hap_constant = &src->constant;
bobbens@2520
   605
         constant = SDL_malloc( sizeof(FFCONSTANTFORCE) );
bobbens@2527
   606
         if (constant == NULL) {
bobbens@2527
   607
            SDL_OutOfMemory();
bobbens@2527
   608
            return -1;
bobbens@2527
   609
         }
bobbens@2535
   610
         SDL_memset(constant, 0, sizeof(FFCONSTANTFORCE));
bobbens@2520
   611
bobbens@2520
   612
         /* Specifics */
bobbens@2520
   613
         constant->lMagnitude = CONVERT(hap_constant->level);
bobbens@2520
   614
         dest->cbTypeSpecificParams = sizeof(FFCONSTANTFORCE); 
bobbens@2520
   615
         dest->lpvTypeSpecificParams = constant;
bobbens@2520
   616
bobbens@2520
   617
         /* Generics */
bobbens@2521
   618
         dest->dwDuration = hap_constant->length * 1000; /* In microseconds. */
bobbens@2520
   619
         dest->dwTriggerButton = FFJOFS_BUTTON(hap_constant->button);
bobbens@2520
   620
         dest->dwTriggerRepeatInterval = hap_constant->interval;
bobbens@2521
   621
         dest->dwStartDelay = hap_constant->delay * 1000; /* In microseconds. */
bobbens@2520
   622
bobbens@2520
   623
         /* Direction. */
bobbens@2522
   624
         if (SDL_SYS_SetDirection(dest, &hap_constant->direction, dest->cAxes) < 0) {
bobbens@2520
   625
            return -1;
bobbens@2520
   626
         }
bobbens@2520
   627
         
bobbens@2520
   628
         /* Envelope */
bobbens@2522
   629
         envelope->dwAttackLevel = CONVERT(hap_constant->attack_level);
bobbens@2522
   630
         envelope->dwAttackTime = hap_constant->attack_length * 1000;
bobbens@2522
   631
         envelope->dwFadeLevel = CONVERT(hap_constant->fade_level);
bobbens@2522
   632
         envelope->dwFadeTime = hap_constant->fade_length * 1000;
bobbens@2520
   633
bobbens@2520
   634
         break;
bobbens@2520
   635
bobbens@2520
   636
      case SDL_HAPTIC_SINE:
bobbens@2520
   637
      case SDL_HAPTIC_SQUARE:
bobbens@2520
   638
      case SDL_HAPTIC_TRIANGLE:
bobbens@2520
   639
      case SDL_HAPTIC_SAWTOOTHUP:
bobbens@2520
   640
      case SDL_HAPTIC_SAWTOOTHDOWN:
bobbens@2522
   641
         hap_periodic = &src->periodic;
bobbens@2527
   642
         periodic = SDL_malloc(sizeof(FFPERIODIC));
bobbens@2527
   643
         if (periodic == NULL) {
bobbens@2527
   644
            SDL_OutOfMemory();
bobbens@2527
   645
            return -1;
bobbens@2527
   646
         }
bobbens@2535
   647
         SDL_memset(periodic, 0, sizeof(FFPERIODIC));
bobbens@2527
   648
bobbens@2527
   649
         /* Specifics */
bobbens@2527
   650
         periodic->dwMagnitude = CONVERT(hap_periodic->magnitude);
bobbens@2527
   651
         periodic->lOffset = CONVERT(hap_periodic->offset);
bobbens@2527
   652
         periodic->dwPhase = hap_periodic->phase;
bobbens@2527
   653
         periodic->dwPeriod = hap_periodic->period * 1000;
bobbens@2527
   654
         dest->cbTypeSpecificParams = sizeof(FFPERIODIC);
bobbens@2527
   655
         dest->lpvTypeSpecificParams = periodic;
bobbens@2527
   656
bobbens@2527
   657
         /* Generics */
bobbens@2527
   658
         dest->dwDuration = hap_periodic->length * 1000; /* In microseconds. */
bobbens@2527
   659
         dest->dwTriggerButton = FFJOFS_BUTTON(hap_periodic->button);
bobbens@2527
   660
         dest->dwTriggerRepeatInterval = hap_periodic->interval;
bobbens@2527
   661
         dest->dwStartDelay = hap_periodic->delay * 1000; /* In microseconds. */
bobbens@2527
   662
         
bobbens@2527
   663
         /* Direction. */
bobbens@2527
   664
         if (SDL_SYS_SetDirection(dest, &hap_periodic->direction, dest->cAxes) < 0) {
bobbens@2527
   665
            return -1;
bobbens@2527
   666
         }
bobbens@2527
   667
         
bobbens@2527
   668
         /* Envelope */
bobbens@2527
   669
         envelope->dwAttackLevel = CONVERT(hap_periodic->attack_level);
bobbens@2527
   670
         envelope->dwAttackTime = hap_periodic->attack_length * 1000;
bobbens@2527
   671
         envelope->dwFadeLevel = CONVERT(hap_periodic->fade_level);
bobbens@2527
   672
         envelope->dwFadeTime = hap_periodic->fade_length * 1000;
bobbens@2520
   673
bobbens@2520
   674
         break;
bobbens@2520
   675
bobbens@2520
   676
      case SDL_HAPTIC_SPRING:
bobbens@2520
   677
      case SDL_HAPTIC_DAMPER:
bobbens@2520
   678
      case SDL_HAPTIC_INERTIA:
bobbens@2520
   679
      case SDL_HAPTIC_FRICTION:
bobbens@2522
   680
         hap_condition = &src->condition;
bobbens@2530
   681
         condition = SDL_malloc(sizeof(FFCONDITION) * dest->cAxes);
bobbens@2530
   682
         if (condition == NULL) {
bobbens@2530
   683
            SDL_OutOfMemory();
bobbens@2530
   684
            return -1;
bobbens@2530
   685
         }
bobbens@2535
   686
         SDL_memset(condition, 0, sizeof(FFCONDITION));
bobbens@2530
   687
bobbens@2530
   688
         /* Specifics */
bobbens@2530
   689
         for (i=0; i<dest->cAxes; i++) {
bobbens@2531
   690
            condition[i].lOffset = CONVERT(hap_condition->center[i]);
bobbens@2531
   691
            condition[i].lPositiveCoefficient = CONVERT(hap_condition->right_coeff[i]);
bobbens@2531
   692
            condition[i].lNegativeCoefficient = CONVERT(hap_condition->left_coeff[i]);
bobbens@2531
   693
            condition[i].dwPositiveSaturation = CONVERT(hap_condition->right_sat[i]);
bobbens@2531
   694
            condition[i].dwNegativeSaturation = CONVERT(hap_condition->left_sat[i]);
bobbens@2531
   695
            condition[i].lDeadBand = CONVERT(hap_condition->deadband[i]);
bobbens@2530
   696
         }
bobbens@2530
   697
         dest->cbTypeSpecificParams = sizeof(FFCONDITION) * dest->cAxes;
bobbens@2530
   698
         dest->lpvTypeSpecificParams = condition;
bobbens@2530
   699
bobbens@2530
   700
         /* Generics */
bobbens@2531
   701
         dest->dwDuration = hap_condition->length * 1000; /* In microseconds. */
bobbens@2531
   702
         dest->dwTriggerButton = FFJOFS_BUTTON(hap_condition->button);
bobbens@2531
   703
         dest->dwTriggerRepeatInterval = hap_condition->interval;
bobbens@2531
   704
         dest->dwStartDelay = hap_condition->delay * 1000; /* In microseconds. */
bobbens@2530
   705
bobbens@2530
   706
         /* Direction. */
bobbens@2531
   707
         if (SDL_SYS_SetDirection(dest, &hap_condition->direction, dest->cAxes) < 0) {
bobbens@2530
   708
            return -1;                
bobbens@2530
   709
         }                            
bobbens@2530
   710
                                      
bobbens@2532
   711
         /* Envelope */
bobbens@2532
   712
/* TODO Check is envelope actually used.
bobbens@2531
   713
         envelope->dwAttackLevel = CONVERT(hap_condition->attack_level);
bobbens@2531
   714
         envelope->dwAttackTime = hap_condition->attack_length * 1000;
bobbens@2531
   715
         envelope->dwFadeLevel = CONVERT(hap_condition->fade_level);
bobbens@2531
   716
         envelope->dwFadeTime = hap_condition->fade_length * 1000;
bobbens@2532
   717
*/
bobbens@2520
   718
bobbens@2520
   719
         break;
bobbens@2520
   720
bobbens@2520
   721
      case SDL_HAPTIC_RAMP:
bobbens@2522
   722
         hap_ramp = &src->ramp;
bobbens@2533
   723
         ramp = SDL_malloc(sizeof(FFRAMPFORCE));
bobbens@2533
   724
         if (ramp == NULL) {
bobbens@2533
   725
            SDL_OutOfMemory();
bobbens@2533
   726
            return -1;
bobbens@2533
   727
         }
bobbens@2535
   728
         SDL_memset(ramp, 0, sizeof(FFRAMPFORCE));
bobbens@2533
   729
bobbens@2533
   730
         /* Specifics */
bobbens@2534
   731
         ramp->lStart = CONVERT(hap_ramp->start);
bobbens@2533
   732
         ramp->lEnd = CONVERT(hap_ramp->end);
bobbens@2535
   733
         dest->cbTypeSpecificParams = sizeof(FFRAMPFORCE);
bobbens@2535
   734
         dest->lpvTypeSpecificParams = ramp;
bobbens@2533
   735
bobbens@2533
   736
         /* Generics */
bobbens@2533
   737
         dest->dwDuration = hap_ramp->length * 1000; /* In microseconds. */
bobbens@2533
   738
         dest->dwTriggerButton = FFJOFS_BUTTON(hap_ramp->button);
bobbens@2533
   739
         dest->dwTriggerRepeatInterval = hap_ramp->interval;
bobbens@2533
   740
         dest->dwStartDelay = hap_ramp->delay * 1000; /* In microseconds. */
bobbens@2533
   741
bobbens@2533
   742
         /* Direction. */
bobbens@2533
   743
         if (SDL_SYS_SetDirection(dest, &hap_ramp->direction, dest->cAxes) < 0) {
bobbens@2533
   744
            return -1;
bobbens@2533
   745
         }
bobbens@2533
   746
bobbens@2533
   747
         /* Envelope */
bobbens@2533
   748
         envelope->dwAttackLevel = CONVERT(hap_ramp->attack_level);
bobbens@2533
   749
         envelope->dwAttackTime = hap_ramp->attack_length * 1000;
bobbens@2533
   750
         envelope->dwFadeLevel = CONVERT(hap_ramp->fade_level);
bobbens@2533
   751
         envelope->dwFadeTime = hap_ramp->fade_length * 1000;
bobbens@2520
   752
bobbens@2520
   753
         break;
bobbens@2520
   754
bobbens@2535
   755
      case SDL_HAPTIC_CUSTOM:
bobbens@2535
   756
         hap_custom = &src->custom;
bobbens@2535
   757
         custom = SDL_malloc(sizeof(FFCUSTOMFORCE));
bobbens@2535
   758
         if (custom == NULL) {
bobbens@2535
   759
            SDL_OutOfMemory();
bobbens@2535
   760
            return -1;
bobbens@2535
   761
         }
bobbens@2535
   762
         SDL_memset(custom, 0, sizeof(FFCUSTOMFORCE));
bobbens@2535
   763
bobbens@2535
   764
         /* Specifics */
bobbens@2535
   765
         custom->cChannels = hap_custom->channels;
bobbens@2535
   766
         custom->dwSamplePeriod = hap_custom->period * 1000;
bobbens@2535
   767
         custom->cSamples = hap_custom->samples;
bobbens@2535
   768
         custom->rglForceData = SDL_malloc(sizeof(LONG)*custom->cSamples*custom->cChannels);
bobbens@2535
   769
         for (i=0; i<hap_custom->samples*hap_custom->channels; i++) { /* Copy data. */
bobbens@2535
   770
            custom->rglForceData[i] = CONVERT(hap_custom->data[i]);
bobbens@2535
   771
         }
bobbens@2535
   772
         dest->cbTypeSpecificParams = sizeof(FFCUSTOMFORCE);
bobbens@2535
   773
         dest->lpvTypeSpecificParams = custom;
bobbens@2535
   774
bobbens@2535
   775
         /* Generics */
bobbens@2535
   776
         dest->dwDuration = hap_custom->length * 1000; /* In microseconds. */
bobbens@2535
   777
         dest->dwTriggerButton = FFJOFS_BUTTON(hap_custom->button);
bobbens@2535
   778
         dest->dwTriggerRepeatInterval = hap_custom->interval;
bobbens@2535
   779
         dest->dwStartDelay = hap_custom->delay * 1000; /* In microseconds. */
bobbens@2535
   780
bobbens@2535
   781
         /* Direction. */
bobbens@2535
   782
         if (SDL_SYS_SetDirection(dest, &hap_custom->direction, dest->cAxes) < 0) {
bobbens@2535
   783
            return -1;
bobbens@2535
   784
         }
bobbens@2535
   785
         
bobbens@2535
   786
         /* Envelope */
bobbens@2535
   787
         envelope->dwAttackLevel = CONVERT(hap_custom->attack_level);
bobbens@2535
   788
         envelope->dwAttackTime = hap_custom->attack_length * 1000;
bobbens@2535
   789
         envelope->dwFadeLevel = CONVERT(hap_custom->fade_level);
bobbens@2535
   790
         envelope->dwFadeTime = hap_custom->fade_length * 1000;
bobbens@2535
   791
bobbens@2535
   792
         break;
bobbens@2535
   793
bobbens@2520
   794
bobbens@2520
   795
      default:
bobbens@2520
   796
         SDL_SetError("Haptic: Unknown effect type.");
bobbens@2520
   797
         return -1;
bobbens@2520
   798
   }
bobbens@2520
   799
bobbens@2520
   800
   return 0;
bobbens@2520
   801
}
bobbens@2520
   802
bobbens@2520
   803
bobbens@2520
   804
/*
bobbens@2527
   805
 * Frees an FFEFFECT allocated by SDL_SYS_ToFFEFFECT.
bobbens@2527
   806
 */
bobbens@2531
   807
static void
bobbens@2535
   808
SDL_SYS_HapticFreeFFEFFECT( FFEFFECT * effect, int type )
bobbens@2527
   809
{
bobbens@2535
   810
   FFCUSTOMFORCE *custom;
bobbens@2535
   811
bobbens@2527
   812
   if (effect->lpEnvelope != NULL) {
bobbens@2527
   813
      SDL_free(effect->lpEnvelope);
bobbens@2527
   814
      effect->lpEnvelope = NULL;
bobbens@2527
   815
   }
bobbens@2527
   816
   if (effect->rgdwAxes != NULL) {
bobbens@2527
   817
      SDL_free(effect->rgdwAxes);
bobbens@2527
   818
      effect->rgdwAxes = NULL;
bobbens@2527
   819
   }
bobbens@2527
   820
   if (effect->lpvTypeSpecificParams != NULL) {
bobbens@2535
   821
      if (type == SDL_HAPTIC_CUSTOM) { /* Must free the custom data. */
bobbens@2535
   822
         custom = (FFCUSTOMFORCE*) effect->lpvTypeSpecificParams;
bobbens@2535
   823
         SDL_free(custom->rglForceData);
bobbens@2535
   824
         custom->rglForceData = NULL;
bobbens@2535
   825
      }
bobbens@2527
   826
      SDL_free(effect->lpvTypeSpecificParams);
bobbens@2527
   827
      effect->lpvTypeSpecificParams = NULL;
bobbens@2527
   828
   }
bobbens@2527
   829
   if (effect->rglDirection != NULL) {
bobbens@2527
   830
      SDL_free(effect->rglDirection);
bobbens@2527
   831
      effect->rglDirection = NULL;
bobbens@2527
   832
   }
bobbens@2527
   833
}
bobbens@2527
   834
bobbens@2527
   835
bobbens@2527
   836
/*
bobbens@2520
   837
 * Gets the effect type from the generic SDL haptic effect wrapper.
bobbens@2520
   838
 */
bobbens@2531
   839
CFUUIDRef
bobbens@2531
   840
SDL_SYS_HapticEffectType(struct haptic_effect * effect)
bobbens@2520
   841
{
bobbens@2521
   842
   switch (effect->effect.type) {
bobbens@2520
   843
      case SDL_HAPTIC_CONSTANT:
bobbens@2520
   844
         return kFFEffectType_ConstantForce_ID;
bobbens@2520
   845
bobbens@2520
   846
      case SDL_HAPTIC_RAMP:
bobbens@2520
   847
         return kFFEffectType_RampForce_ID;
bobbens@2520
   848
bobbens@2520
   849
      case SDL_HAPTIC_SQUARE:
bobbens@2520
   850
         return kFFEffectType_Square_ID;
bobbens@2520
   851
bobbens@2520
   852
      case SDL_HAPTIC_SINE:
bobbens@2520
   853
         return kFFEffectType_Sine_ID;
bobbens@2520
   854
bobbens@2521
   855
      case SDL_HAPTIC_TRIANGLE:
bobbens@2520
   856
         return kFFEffectType_Triangle_ID;
bobbens@2520
   857
bobbens@2520
   858
      case SDL_HAPTIC_SAWTOOTHUP:
bobbens@2520
   859
         return kFFEffectType_SawtoothUp_ID;
bobbens@2520
   860
bobbens@2520
   861
      case SDL_HAPTIC_SAWTOOTHDOWN:
bobbens@2520
   862
         return kFFEffectType_SawtoothDown_ID;
bobbens@2520
   863
bobbens@2520
   864
      case SDL_HAPTIC_SPRING:
bobbens@2520
   865
         return kFFEffectType_Spring_ID;
bobbens@2520
   866
bobbens@2520
   867
      case SDL_HAPTIC_DAMPER:
bobbens@2520
   868
         return kFFEffectType_Damper_ID;
bobbens@2520
   869
bobbens@2520
   870
      case SDL_HAPTIC_INERTIA:
bobbens@2520
   871
         return kFFEffectType_Inertia_ID;
bobbens@2520
   872
bobbens@2520
   873
      case SDL_HAPTIC_FRICTION:
bobbens@2520
   874
         return kFFEffectType_Friction_ID;
bobbens@2520
   875
bobbens@2520
   876
      case SDL_HAPTIC_CUSTOM:
bobbens@2520
   877
         return kFFEffectType_CustomForce_ID;
bobbens@2520
   878
bobbens@2520
   879
      default:
bobbens@2520
   880
         SDL_SetError("Haptic: Unknown effect type.");
bobbens@2520
   881
         return NULL;
bobbens@2520
   882
   }
bobbens@2520
   883
}
bobbens@2520
   884
bobbens@2520
   885
bobbens@2520
   886
/*
bobbens@2520
   887
 * Creates a new haptic effect.
bobbens@2520
   888
 */
bobbens@2520
   889
int
bobbens@2520
   890
SDL_SYS_HapticNewEffect(SDL_Haptic * haptic, struct haptic_effect * effect,
bobbens@2520
   891
      SDL_HapticEffect * base)
bobbens@2520
   892
{
bobbens@2520
   893
   HRESULT ret;
bobbens@2520
   894
   CFUUIDRef type;
bobbens@2520
   895
bobbens@2520
   896
   /* Alloc the effect. */
bobbens@2520
   897
   effect->hweffect = (struct haptic_hweffect *)
bobbens@2520
   898
         SDL_malloc(sizeof(struct haptic_hweffect));
bobbens@2520
   899
   if (effect->hweffect == NULL) {
bobbens@2520
   900
      SDL_OutOfMemory();
bobbens@2527
   901
      goto err_hweffect;
bobbens@2520
   902
   }
bobbens@2520
   903
bobbens@2520
   904
   /* Get the type. */
bobbens@2520
   905
   type = SDL_SYS_HapticEffectType(effect);
bobbens@2520
   906
   if (type == NULL) {
bobbens@2527
   907
      goto err_hweffect;
bobbens@2520
   908
   }
bobbens@2520
   909
bobbens@2520
   910
   /* Get the effect. */
bobbens@2538
   911
   if (SDL_SYS_ToFFEFFECT(haptic, &effect->hweffect->effect, base) < 0) {
bobbens@2527
   912
      goto err_effectdone;
bobbens@2520
   913
   }
bobbens@2520
   914
bobbens@2527
   915
   /* Create the actual effect. */
bobbens@2538
   916
   ret = FFDeviceCreateEffect(haptic->hwdata->device, type,
bobbens@2538
   917
         &effect->hweffect->effect, &effect->hweffect->ref);
bobbens@2527
   918
   if (ret != FF_OK) {
bobbens@2541
   919
      SDL_SetError("Haptic: Unable to create effect: %s.", FFStrError(ret));
bobbens@2527
   920
      goto err_effectdone;
bobbens@2527
   921
   }
bobbens@2527
   922
bobbens@2527
   923
   return 0;
bobbens@2527
   924
bobbens@2527
   925
err_effectdone:
bobbens@2538
   926
   SDL_SYS_HapticFreeFFEFFECT(&effect->hweffect->effect, base->type);
bobbens@2527
   927
err_hweffect:
bobbens@2527
   928
   if (effect->hweffect != NULL) {
bobbens@2527
   929
      SDL_free(effect->hweffect);
bobbens@2527
   930
      effect->hweffect = NULL;
bobbens@2527
   931
   }
bobbens@2527
   932
   return -1;
bobbens@2520
   933
}
bobbens@2520
   934
bobbens@2520
   935
bobbens@2520
   936
/*
bobbens@2520
   937
 * Updates an effect.
bobbens@2520
   938
 */
bobbens@2531
   939
int
bobbens@2531
   940
SDL_SYS_HapticUpdateEffect(SDL_Haptic * haptic,
bobbens@2520
   941
      struct haptic_effect * effect, SDL_HapticEffect * data)
bobbens@2520
   942
{
bobbens@2538
   943
   HRESULT ret;
bobbens@2538
   944
   FFEffectParameterFlag flags;
bobbens@2538
   945
   FFEFFECT temp;
bobbens@2538
   946
bobbens@2538
   947
   /* Get the effect. */
bobbens@2538
   948
   SDL_memset(&temp, 0, sizeof(FFEFFECT));
bobbens@2538
   949
   if (SDL_SYS_ToFFEFFECT(haptic, &temp, data) < 0) {
bobbens@2538
   950
      goto err_update;
bobbens@2538
   951
   }
bobbens@2538
   952
bobbens@2538
   953
   /* Set the flags.  Might be worthwhile to diff temp with loaded effect and
bobbens@2538
   954
    *  only change those parameters. */
bobbens@2538
   955
   flags = FFEP_ALLPARAMS;
bobbens@2538
   956
bobbens@2538
   957
   /* Create the actual effect. */
bobbens@2542
   958
   ret = FFEffectSetParameters(effect->hweffect->ref, &temp, flags);
bobbens@2538
   959
   if (ret != FF_OK) {
bobbens@2541
   960
      SDL_SetError("Haptic: Unable to update effect: %s.", FFStrError(ret));
bobbens@2538
   961
      goto err_update;
bobbens@2538
   962
   }
bobbens@2538
   963
bobbens@2538
   964
   /* Copy it over. */
bobbens@2538
   965
   SDL_SYS_HapticFreeFFEFFECT(&effect->hweffect->effect, data->type);
bobbens@2538
   966
   SDL_memcpy(&effect->hweffect->effect, &temp, sizeof(FFEFFECT));
bobbens@2538
   967
bobbens@2538
   968
   return 0;
bobbens@2538
   969
bobbens@2538
   970
err_update:
bobbens@2538
   971
   SDL_SYS_HapticFreeFFEFFECT(&temp, data->type);
bobbens@2520
   972
   return -1;
bobbens@2520
   973
}
bobbens@2520
   974
bobbens@2520
   975
bobbens@2520
   976
/*
bobbens@2520
   977
 * Runs an effect.
bobbens@2520
   978
 */
bobbens@2520
   979
int
bobbens@2520
   980
SDL_SYS_HapticRunEffect(SDL_Haptic * haptic, struct haptic_effect * effect,
bobbens@2520
   981
                        Uint32 iterations)
bobbens@2520
   982
{
bobbens@2520
   983
   HRESULT ret;
bobbens@2520
   984
   Uint32 iter;
bobbens@2520
   985
bobbens@2520
   986
   /* Check if it's infinite. */
bobbens@2520
   987
   if (iterations == SDL_HAPTIC_INFINITY) {
bobbens@2521
   988
      iter = FF_INFINITE;
bobbens@2520
   989
   }
bobbens@2520
   990
   else
bobbens@2520
   991
      iter = iterations;
bobbens@2520
   992
bobbens@2520
   993
   /* Run the effect. */
bobbens@2520
   994
   ret = FFEffectStart(effect->hweffect->ref, iter, 0);
bobbens@2520
   995
   if (ret != FF_OK) {
bobbens@2541
   996
      SDL_SetError("Haptic: Unable to run the effect: %s.", FFStrError(ret));
bobbens@2520
   997
      return -1;
bobbens@2520
   998
   }
bobbens@2520
   999
bobbens@2520
  1000
   return 0;
bobbens@2520
  1001
}
bobbens@2520
  1002
bobbens@2520
  1003
bobbens@2520
  1004
/*
bobbens@2520
  1005
 * Stops an effect.
bobbens@2520
  1006
 */
bobbens@2520
  1007
int
bobbens@2520
  1008
SDL_SYS_HapticStopEffect(SDL_Haptic * haptic, struct haptic_effect * effect)
bobbens@2520
  1009
{
bobbens@2520
  1010
   HRESULT ret;
bobbens@2520
  1011
bobbens@2520
  1012
   ret = FFEffectStop(effect->hweffect->ref);
bobbens@2520
  1013
   if (ret != FF_OK) {
bobbens@2541
  1014
      SDL_SetError("Haptic: Unable to stop the effect: %s.", FFStrError(ret));
bobbens@2520
  1015
      return -1;
bobbens@2520
  1016
   }
bobbens@2520
  1017
bobbens@2520
  1018
   return 0;
bobbens@2520
  1019
}
bobbens@2520
  1020
bobbens@2520
  1021
bobbens@2520
  1022
/*
bobbens@2520
  1023
 * Frees the effect.
bobbens@2520
  1024
 */
bobbens@2520
  1025
void
bobbens@2520
  1026
SDL_SYS_HapticDestroyEffect(SDL_Haptic * haptic, struct haptic_effect * effect)
bobbens@2520
  1027
{
bobbens@2520
  1028
   HRESULT ret;
bobbens@2520
  1029
bobbens@2520
  1030
   ret = FFDeviceReleaseEffect(haptic->hwdata->device, effect->hweffect->ref);
bobbens@2520
  1031
   if (ret != FF_OK) {
bobbens@2541
  1032
      SDL_SetError("Haptic: Error removing the effect from the device: %s.",
bobbens@2541
  1033
                   FFStrError(ret));
bobbens@2520
  1034
   }
bobbens@2520
  1035
   SDL_free(effect->hweffect->effect.lpvTypeSpecificParams);
bobbens@2520
  1036
   effect->hweffect->effect.lpvTypeSpecificParams = NULL;
bobbens@2520
  1037
   SDL_free(effect->hweffect);
bobbens@2520
  1038
   effect->hweffect = NULL;
bobbens@2520
  1039
}
bobbens@2520
  1040
bobbens@2520
  1041
bobbens@2520
  1042
/*
bobbens@2520
  1043
 * Gets the status of a haptic effect.
bobbens@2520
  1044
 */
bobbens@2520
  1045
int
bobbens@2520
  1046
SDL_SYS_HapticGetEffectStatus(SDL_Haptic * haptic, struct haptic_effect * effect)
bobbens@2520
  1047
{
bobbens@2520
  1048
   HRESULT ret;
bobbens@2520
  1049
   FFEffectStatusFlag status;
bobbens@2520
  1050
bobbens@2521
  1051
   ret = FFEffectGetEffectStatus(effect->hweffect->ref, &status);
bobbens@2520
  1052
   if (ret != FF_OK) {
bobbens@2541
  1053
      SDL_SetError("Haptic: Unable to get effect status: %s.", FFStrError(ret));
bobbens@2520
  1054
      return -1;
bobbens@2520
  1055
   }
bobbens@2520
  1056
bobbens@2520
  1057
   if (status == 0) return SDL_FALSE;
bobbens@2520
  1058
   return SDL_TRUE; /* Assume it's playing or emulated. */
bobbens@2520
  1059
}
bobbens@2520
  1060
bobbens@2520
  1061
bobbens@2520
  1062
/*
bobbens@2520
  1063
 * Sets the gain.
bobbens@2520
  1064
 */
bobbens@2520
  1065
int
bobbens@2520
  1066
SDL_SYS_HapticSetGain(SDL_Haptic * haptic, int gain)
bobbens@2520
  1067
{
bobbens@2520
  1068
   HRESULT ret;
bobbens@2520
  1069
   Uint32 val;
bobbens@2520
  1070
bobbens@2520
  1071
   val = gain * 100; /* Mac OS X uses 0 to 10,000 */
bobbens@2520
  1072
   ret = FFDeviceSetForceFeedbackProperty(haptic->hwdata->device, FFPROP_FFGAIN, &val);
bobbens@2520
  1073
   if (ret != FF_OK) {
bobbens@2541
  1074
      SDL_SetError("Haptic: Error setting gain: %s.", FFStrError(ret));
bobbens@2520
  1075
      return -1;
bobbens@2520
  1076
   }
bobbens@2520
  1077
bobbens@2520
  1078
   return 0;
bobbens@2520
  1079
}
bobbens@2520
  1080
bobbens@2520
  1081
bobbens@2520
  1082
/*
bobbens@2520
  1083
 * Sets the autocentering.
bobbens@2520
  1084
 */
bobbens@2520
  1085
int
bobbens@2520
  1086
SDL_SYS_HapticSetAutocenter(SDL_Haptic * haptic, int autocenter)
bobbens@2520
  1087
{
bobbens@2520
  1088
   HRESULT ret;
bobbens@2520
  1089
   Uint32 val;
bobbens@2520
  1090
bobbens@2520
  1091
   /* Mac OS X only has 0 (off) and 1 (on) */
bobbens@2520
  1092
   if (autocenter == 0) val = 0;
bobbens@2520
  1093
   else val = 1;
bobbens@2520
  1094
bobbens@2520
  1095
   ret = FFDeviceSetForceFeedbackProperty(haptic->hwdata->device,
bobbens@2521
  1096
               FFPROP_AUTOCENTER, &val);
bobbens@2520
  1097
   if (ret != FF_OK) {
bobbens@2541
  1098
      SDL_SetError("Haptic: Error setting autocenter: %s.", FFStrError(ret));
bobbens@2520
  1099
      return -1;
bobbens@2520
  1100
   }
bobbens@2520
  1101
  
bobbens@2520
  1102
   return 0;
bobbens@2520
  1103
bobbens@2520
  1104
}
bobbens@2520
  1105
bobbens@2520
  1106
bobbens@2541
  1107
#endif /* SDL_HAPTIC_IOKIT */