src/haptic/SDL_haptic.c
author Edgar Simo <bobbens@gmail.com>
Thu, 03 Jul 2008 09:58:27 +0000
branchgsoc2008_force_feedback
changeset 2495 66c02abeef0e
parent 2491 10bc7aaf5114
child 2497 0893fbf73b3d
permissions -rw-r--r--
Added SDL_HapticGetEffectStatus().
More comments.
bobbens@2472
     1
/*
bobbens@2472
     2
    SDL - Simple DirectMedia Layer
bobbens@2472
     3
    Copyright (C) 2008 Edgar Simo
bobbens@2472
     4
bobbens@2472
     5
    This library is free software; you can redistribute it and/or
bobbens@2472
     6
    modify it under the terms of the GNU Lesser General Public
bobbens@2472
     7
    License as published by the Free Software Foundation; either
bobbens@2472
     8
    version 2.1 of the License, or (at your option) any later version.
bobbens@2472
     9
bobbens@2472
    10
    This library is distributed in the hope that it will be useful,
bobbens@2472
    11
    but WITHOUT ANY WARRANTY; without even the implied warranty of
bobbens@2472
    12
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
bobbens@2472
    13
    Lesser General Public License for more details.
bobbens@2472
    14
bobbens@2472
    15
    You should have received a copy of the GNU Lesser General Public
bobbens@2472
    16
    License along with this library; if not, write to the Free Software
bobbens@2472
    17
    Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
bobbens@2472
    18
bobbens@2472
    19
    Sam Lantinga
bobbens@2472
    20
    slouken@libsdl.org
bobbens@2472
    21
*/
bobbens@2472
    22
#include "SDL_config.h"
bobbens@2472
    23
bobbens@2472
    24
#include "SDL_syshaptic.h"
bobbens@2489
    25
#include "../joystick/SDL_joystick_c.h" /* For SDL_PrivateJoystickValid */
bobbens@2472
    26
bobbens@2472
    27
bobbens@2472
    28
static Uint8 SDL_numhaptics = 0;
bobbens@2472
    29
SDL_Haptic **SDL_haptics = NULL;
bobbens@2472
    30
static SDL_Haptic *default_haptic = NULL;
bobbens@2472
    31
bobbens@2472
    32
bobbens@2472
    33
/*
bobbens@2472
    34
 * Initializes the Haptic devices.
bobbens@2472
    35
 */
bobbens@2472
    36
int
bobbens@2472
    37
SDL_HapticInit(void)
bobbens@2472
    38
{  
bobbens@2472
    39
   int arraylen;
bobbens@2472
    40
   int status;
bobbens@2472
    41
bobbens@2472
    42
   SDL_numhaptics = 0;
bobbens@2472
    43
   status = SDL_SYS_HapticInit();
bobbens@2472
    44
   if (status >= 0) {
bobbens@2472
    45
      arraylen = (status + 1) * sizeof(*SDL_haptics);
bobbens@2472
    46
      SDL_haptics = (SDL_Haptic **) SDL_malloc(arraylen);
bobbens@2472
    47
      if (SDL_haptics == NULL) {
bobbens@2472
    48
         SDL_numhaptics = 0;
bobbens@2472
    49
      } else {
bobbens@2472
    50
         SDL_memset(SDL_haptics, 0, arraylen);
bobbens@2472
    51
         SDL_numhaptics = status;
bobbens@2472
    52
      }
bobbens@2472
    53
      status = 0;
bobbens@2472
    54
   }
bobbens@2472
    55
   default_haptic = NULL;
bobbens@2472
    56
bobbens@2472
    57
   return status;
bobbens@2472
    58
}
bobbens@2472
    59
bobbens@2472
    60
bobbens@2472
    61
/*
bobbens@2472
    62
 * Returns the number of available devices.
bobbens@2472
    63
 */
bobbens@2472
    64
int
bobbens@2472
    65
SDL_NumHaptics(void)
bobbens@2472
    66
{
bobbens@2472
    67
   return SDL_numhaptics;
bobbens@2472
    68
}
bobbens@2472
    69
bobbens@2472
    70
bobbens@2472
    71
/*
bobbens@2472
    72
 * Gets the name of a Haptic device by index.
bobbens@2472
    73
 */
bobbens@2472
    74
const char *
bobbens@2472
    75
SDL_HapticName(int device_index)
bobbens@2472
    76
{
bobbens@2472
    77
   if ((device_index < 0) || (device_index >= SDL_numhaptics)) {
bobbens@2472
    78
      SDL_SetError("There are %d haptic devices available", SDL_numhaptics);
bobbens@2472
    79
      return NULL;
bobbens@2472
    80
   }
bobbens@2472
    81
   return SDL_SYS_HapticName(device_index);
bobbens@2472
    82
}
bobbens@2472
    83
bobbens@2472
    84
bobbens@2472
    85
/*
bobbens@2475
    86
 * Opens a Haptic device.
bobbens@2472
    87
 */
bobbens@2472
    88
SDL_Haptic *
bobbens@2472
    89
SDL_HapticOpen(int device_index)
bobbens@2472
    90
{
bobbens@2472
    91
   int i;
bobbens@2472
    92
   SDL_Haptic *haptic;
bobbens@2472
    93
bobbens@2472
    94
   if ((device_index < 0) || (device_index >= SDL_numhaptics)) {
bobbens@2472
    95
      SDL_SetError("There are %d haptic devices available", SDL_numhaptics);
bobbens@2472
    96
      return NULL;
bobbens@2472
    97
   }
bobbens@2472
    98
bobbens@2472
    99
   /* If the haptic is already open, return it */
bobbens@2477
   100
   for (i=0; SDL_haptics[i]; i++) {             
bobbens@2472
   101
      if (device_index == SDL_haptics[i]->index) {
bobbens@2472
   102
         haptic = SDL_haptics[i];
bobbens@2472
   103
         ++haptic->ref_count;
bobbens@2472
   104
         return haptic;
bobbens@2472
   105
      }
bobbens@2472
   106
   }
bobbens@2472
   107
bobbens@2477
   108
   /* Create the haptic device */
bobbens@2472
   109
   haptic = (SDL_Haptic *) SDL_malloc((sizeof *haptic));
bobbens@2477
   110
   if (haptic == NULL) {
bobbens@2477
   111
      SDL_OutOfMemory();
bobbens@2477
   112
      return NULL;
bobbens@2472
   113
   }
bobbens@2477
   114
bobbens@2477
   115
   /* Initialize the haptic device */
bobbens@2477
   116
   SDL_memset(haptic, 0, (sizeof *haptic));
bobbens@2477
   117
   haptic->index = device_index;
bobbens@2477
   118
   if (SDL_SYS_HapticOpen(haptic) < 0) {
bobbens@2477
   119
      SDL_free(haptic);
bobbens@2477
   120
      return NULL;
bobbens@2472
   121
   }
bobbens@2477
   122
bobbens@2477
   123
   /* Add haptic to list */
bobbens@2477
   124
   ++haptic->ref_count;
bobbens@2490
   125
   for (i=0; SDL_haptics[i]; i++)
bobbens@2477
   126
      /* Skip to next haptic */ ;
bobbens@2477
   127
   SDL_haptics[i] = haptic;
bobbens@2477
   128
bobbens@2472
   129
   return haptic;
bobbens@2472
   130
}
bobbens@2474
   131
bobbens@2474
   132
bobbens@2475
   133
/*
bobbens@2489
   134
 * Returns SDL_TRUE if joystick has haptic features.
bobbens@2489
   135
 */
bobbens@2489
   136
int
bobbens@2489
   137
SDL_JoystickIsHaptic(SDL_Joystick * joystick)
bobbens@2489
   138
{
bobbens@2489
   139
   int ret;
bobbens@2489
   140
bobbens@2490
   141
   /* Must be a valid joystick */
bobbens@2489
   142
   if (!SDL_PrivateJoystickValid(&joystick)) {
bobbens@2489
   143
      return -1;
bobbens@2489
   144
   }
bobbens@2489
   145
bobbens@2489
   146
   ret = SDL_SYS_JoystickIsHaptic(joystick);
bobbens@2489
   147
bobbens@2489
   148
   if (ret > 0) return SDL_TRUE;
bobbens@2489
   149
   else if (ret == 0) return SDL_FALSE;
bobbens@2489
   150
   else return -1;
bobbens@2489
   151
}
bobbens@2489
   152
bobbens@2489
   153
bobbens@2489
   154
/*
bobbens@2489
   155
 * Opens a haptic device from a joystick.
bobbens@2489
   156
 */
bobbens@2489
   157
SDL_Haptic *
bobbens@2489
   158
SDL_HapticOpenFromJoystick(SDL_Joystick * joystick)
bobbens@2489
   159
{
bobbens@2490
   160
   int i;
bobbens@2490
   161
   SDL_Haptic *haptic;
bobbens@2490
   162
bobbens@2490
   163
   /* Must be a valid joystick */
bobbens@2489
   164
   if (!SDL_PrivateJoystickValid(&joystick)) {
bobbens@2490
   165
      return NULL;
bobbens@2489
   166
   }
bobbens@2490
   167
bobbens@2490
   168
   /* Joystick must be haptic */
bobbens@2490
   169
   if (SDL_SYS_JoystickIsHaptic(joystick) <= 0) {
bobbens@2490
   170
      return NULL;
bobbens@2490
   171
   }
bobbens@2490
   172
bobbens@2490
   173
   /* Check to see if joystick's haptic is already open */
bobbens@2490
   174
   for (i=0; SDL_haptics[i]; i++) {
bobbens@2491
   175
      if (SDL_SYS_JoystickSameHaptic(SDL_haptics[i],joystick)) {
bobbens@2490
   176
         haptic = SDL_haptics[i];
bobbens@2490
   177
         ++haptic->ref_count;
bobbens@2490
   178
         return haptic;
bobbens@2490
   179
      }
bobbens@2490
   180
   }
bobbens@2490
   181
bobbens@2490
   182
   /* Create the haptic device */
bobbens@2490
   183
   haptic = (SDL_Haptic *) SDL_malloc((sizeof *haptic));
bobbens@2490
   184
   if (haptic == NULL) {
bobbens@2490
   185
      SDL_OutOfMemory();
bobbens@2490
   186
      return NULL;
bobbens@2490
   187
   }
bobbens@2490
   188
bobbens@2490
   189
   /* Initialize the haptic device */
bobbens@2490
   190
   SDL_memset(haptic, 0, (sizeof *haptic));
bobbens@2490
   191
   if (SDL_SYS_HapticOpenFromJoystick(haptic,joystick) < 0) {
bobbens@2490
   192
      SDL_free(haptic);
bobbens@2490
   193
      return NULL;
bobbens@2490
   194
   }
bobbens@2490
   195
bobbens@2490
   196
   /* Add haptic to list */
bobbens@2490
   197
   ++haptic->ref_count;
bobbens@2490
   198
   for (i=0; SDL_haptics[i]; i++)
bobbens@2490
   199
      /* Skip to next haptic */ ;
bobbens@2490
   200
   SDL_haptics[i] = haptic;
bobbens@2490
   201
bobbens@2490
   202
   return haptic;
bobbens@2489
   203
}
bobbens@2489
   204
bobbens@2489
   205
bobbens@2489
   206
/*
bobbens@2476
   207
 * Checks to see if the haptic device is valid
bobbens@2476
   208
 */
bobbens@2476
   209
static int
bobbens@2476
   210
ValidHaptic(SDL_Haptic ** haptic)
bobbens@2476
   211
{
bobbens@2476
   212
   int valid;
bobbens@2476
   213
bobbens@2476
   214
   if (*haptic == NULL) {
bobbens@2476
   215
      SDL_SetError("Haptic device hasn't been opened yet");
bobbens@2476
   216
      valid = 0;
bobbens@2476
   217
   } else {
bobbens@2476
   218
      valid = 1;
bobbens@2476
   219
   }
bobbens@2476
   220
   return valid;
bobbens@2476
   221
}
bobbens@2476
   222
bobbens@2476
   223
bobbens@2476
   224
/*
bobbens@2475
   225
 * Closes a SDL_Haptic device.
bobbens@2475
   226
 */
bobbens@2475
   227
void
bobbens@2475
   228
SDL_HapticClose(SDL_Haptic * haptic)
bobbens@2475
   229
{
bobbens@2476
   230
   int i;
bobbens@2476
   231
bobbens@2476
   232
   /* Must be valid */
bobbens@2476
   233
   if (!ValidHaptic(&haptic)) {
bobbens@2476
   234
      return;
bobbens@2476
   235
   }
bobbens@2476
   236
bobbens@2476
   237
   /* Check if it's still in use */
bobbens@2476
   238
   if (--haptic->ref_count < 0) {
bobbens@2476
   239
      return;
bobbens@2476
   240
   }
bobbens@2476
   241
bobbens@2480
   242
   /* Close it, properly removing effects if needed */
bobbens@2480
   243
   for (i=0; i<haptic->neffects; i++) {
bobbens@2480
   244
      if (haptic->effects[i].hweffect != NULL) {
bobbens@2480
   245
         SDL_HapticDestroyEffect(haptic,i);
bobbens@2480
   246
      }
bobbens@2480
   247
   }
bobbens@2476
   248
   SDL_SYS_HapticClose(haptic);
bobbens@2476
   249
bobbens@2476
   250
   /* Remove from the list */
bobbens@2476
   251
   for (i = 0; SDL_haptics[i]; ++i) {
bobbens@2476
   252
      if (haptic == SDL_haptics[i]) {
bobbens@2476
   253
         SDL_memcpy(&SDL_haptics[i], &SDL_haptics[i + 1],
bobbens@2476
   254
               (SDL_numhaptics - i) * sizeof(haptic));
bobbens@2476
   255
         break;
bobbens@2476
   256
      }
bobbens@2476
   257
   }
bobbens@2476
   258
bobbens@2476
   259
   /* Free */
bobbens@2476
   260
   SDL_free(haptic);
bobbens@2475
   261
}
bobbens@2475
   262
bobbens@2475
   263
/*
bobbens@2475
   264
 * Cleans up after the subsystem.
bobbens@2475
   265
 */
bobbens@2474
   266
void
bobbens@2474
   267
SDL_HapticQuit(void)
bobbens@2474
   268
{
bobbens@2474
   269
   SDL_numhaptics = 0;
bobbens@2474
   270
bobbens@2474
   271
   SDL_SYS_HapticQuit();
bobbens@2474
   272
   if (SDL_haptics != NULL) {
bobbens@2474
   273
      SDL_free(SDL_haptics);
bobbens@2474
   274
      SDL_haptics = NULL;
bobbens@2474
   275
   }
bobbens@2474
   276
}
bobbens@2477
   277
bobbens@2478
   278
/*
bobbens@2478
   279
 * Returns the number of effects a haptic device has.
bobbens@2478
   280
 */
bobbens@2478
   281
int
bobbens@2478
   282
SDL_HapticNumEffects(SDL_Haptic * haptic)
bobbens@2478
   283
{
bobbens@2478
   284
   if (!ValidHaptic(&haptic)) {
bobbens@2478
   285
      return -1;
bobbens@2478
   286
   }
bobbens@2478
   287
bobbens@2478
   288
   return haptic->neffects;
bobbens@2478
   289
}
bobbens@2478
   290
bobbens@2478
   291
/*
bobbens@2478
   292
 * Returns supported effects by the device.
bobbens@2478
   293
 */
bobbens@2478
   294
unsigned int
bobbens@2478
   295
SDL_HapticQueryEffects(SDL_Haptic * haptic)
bobbens@2478
   296
{
bobbens@2478
   297
   if (!ValidHaptic(&haptic)) {
bobbens@2478
   298
      return -1;
bobbens@2478
   299
   }
bobbens@2478
   300
bobbens@2478
   301
   return haptic->supported;
bobbens@2478
   302
}
bobbens@2478
   303
bobbens@2486
   304
/*
bobbens@2486
   305
 * Checks to see if the device can support the effect.
bobbens@2486
   306
 */
bobbens@2478
   307
int
bobbens@2478
   308
SDL_HapticEffectSupported(SDL_Haptic * haptic, SDL_HapticEffect * effect)
bobbens@2478
   309
{
bobbens@2478
   310
   if (!ValidHaptic(&haptic)) {
bobbens@2478
   311
      return -1;
bobbens@2478
   312
   }
bobbens@2478
   313
bobbens@2478
   314
   if ((haptic->supported & effect->type) != 0)
bobbens@2478
   315
      return SDL_TRUE;
bobbens@2478
   316
   return SDL_FALSE;
bobbens@2478
   317
}
bobbens@2477
   318
bobbens@2477
   319
/*
bobbens@2477
   320
 * Creates a new haptic effect.
bobbens@2477
   321
 */
bobbens@2477
   322
int
bobbens@2477
   323
SDL_HapticNewEffect(SDL_Haptic * haptic, SDL_HapticEffect * effect)
bobbens@2477
   324
{
bobbens@2477
   325
   int i;
bobbens@2477
   326
bobbens@2477
   327
   /* Check for device validity. */
bobbens@2477
   328
   if (!ValidHaptic(&haptic)) {
bobbens@2477
   329
      return -1;
bobbens@2477
   330
   }
bobbens@2477
   331
bobbens@2480
   332
   /* Check to see if effect is supported */
bobbens@2480
   333
   if (SDL_HapticEffectSupported(haptic,effect)==SDL_FALSE) {
bobbens@2480
   334
      SDL_SetError("Haptic effect not supported by haptic device.");
bobbens@2480
   335
      return -1;
bobbens@2480
   336
   }
bobbens@2480
   337
bobbens@2477
   338
   /* See if there's a free slot */
bobbens@2477
   339
   for (i=0; i<haptic->neffects; i++) {
bobbens@2477
   340
      if (haptic->effects[i].hweffect == NULL) {
bobbens@2477
   341
bobbens@2477
   342
         /* Now let the backend create the real effect */
bobbens@2480
   343
         if (SDL_SYS_HapticNewEffect(haptic,&haptic->effects[i],effect) != 0) {
bobbens@2477
   344
            return -1; /* Backend failed to create effect */
bobbens@2477
   345
         }
bobbens@2477
   346
         return i;
bobbens@2477
   347
      }
bobbens@2477
   348
   }
bobbens@2477
   349
bobbens@2477
   350
   SDL_SetError("Haptic device has no free space left.");
bobbens@2477
   351
   return -1;
bobbens@2477
   352
}
bobbens@2477
   353
bobbens@2477
   354
/*
bobbens@2480
   355
 * Checks to see if an effect is valid.
bobbens@2480
   356
 */
bobbens@2480
   357
static int
bobbens@2480
   358
ValidEffect(SDL_Haptic * haptic, int effect)
bobbens@2480
   359
{
bobbens@2480
   360
   if ((effect < 0) || (effect >= haptic->neffects)) {
bobbens@2480
   361
      SDL_SetError("Invalid haptic effect identifier.");
bobbens@2480
   362
      return 0;
bobbens@2480
   363
   }
bobbens@2480
   364
   return 1;
bobbens@2480
   365
}
bobbens@2480
   366
bobbens@2480
   367
/*
bobbens@2488
   368
 * Updates an effect.
bobbens@2488
   369
 */
bobbens@2488
   370
int
bobbens@2488
   371
SDL_HapticUpdateEffect(SDL_Haptic * haptic, int effect, SDL_HapticEffect * data)
bobbens@2488
   372
{
bobbens@2488
   373
   if (!ValidHaptic(&haptic) || !ValidEffect(haptic,effect)) {
bobbens@2488
   374
      return -1;
bobbens@2488
   375
   }
bobbens@2488
   376
bobbens@2488
   377
   /* Updates the effect */
bobbens@2488
   378
   if (SDL_SYS_HapticUpdateEffect(haptic,&haptic->effects[effect],data) < 0) {
bobbens@2488
   379
      return -1;
bobbens@2488
   380
   }
bobbens@2488
   381
bobbens@2488
   382
   return 0;
bobbens@2488
   383
}
bobbens@2488
   384
bobbens@2488
   385
bobbens@2488
   386
/*
bobbens@2477
   387
 * Runs the haptic effect on the device.
bobbens@2477
   388
 */
bobbens@2477
   389
int
bobbens@2477
   390
SDL_HapticRunEffect(SDL_Haptic * haptic, int effect)
bobbens@2477
   391
{
bobbens@2480
   392
   if (!ValidHaptic(&haptic) || !ValidEffect(haptic,effect)) {
bobbens@2477
   393
      return -1;
bobbens@2477
   394
   }
bobbens@2479
   395
bobbens@2479
   396
   /* Run the effect */
bobbens@2479
   397
   if (SDL_SYS_HapticRunEffect(haptic,&haptic->effects[effect]) < 0) {
bobbens@2479
   398
      return -1;
bobbens@2479
   399
   }
bobbens@2479
   400
bobbens@2479
   401
   return 0;
bobbens@2477
   402
}
bobbens@2477
   403
bobbens@2477
   404
/*
bobbens@2485
   405
 * Stops the haptic effect on the device.
bobbens@2485
   406
 */
bobbens@2485
   407
int
bobbens@2485
   408
SDL_HapticStopEffect(SDL_Haptic * haptic, int effect)
bobbens@2485
   409
{
bobbens@2485
   410
   if (!ValidHaptic(&haptic) || !ValidEffect(haptic,effect)) {
bobbens@2485
   411
      return -1;
bobbens@2485
   412
   }
bobbens@2485
   413
bobbens@2485
   414
   /* Stop the effect */
bobbens@2485
   415
   if (SDL_SYS_HapticStopEffect(haptic,&haptic->effects[effect]) < 0) {
bobbens@2485
   416
      return -1;
bobbens@2485
   417
   }
bobbens@2485
   418
bobbens@2485
   419
   return 0;
bobbens@2485
   420
}
bobbens@2485
   421
bobbens@2485
   422
/*
bobbens@2477
   423
 * Gets rid of a haptic effect.
bobbens@2477
   424
 */
bobbens@2477
   425
void
bobbens@2477
   426
SDL_HapticDestroyEffect(SDL_Haptic * haptic, int effect)
bobbens@2477
   427
{
bobbens@2480
   428
   if (!ValidHaptic(&haptic) || !ValidEffect(haptic,effect)) {
bobbens@2477
   429
      return;
bobbens@2477
   430
   }
bobbens@2479
   431
bobbens@2479
   432
   /* Not allocated */
bobbens@2479
   433
   if (haptic->effects[effect].hweffect == NULL) {
bobbens@2479
   434
      return;
bobbens@2479
   435
   }
bobbens@2479
   436
bobbens@2479
   437
   SDL_SYS_HapticDestroyEffect(haptic, &haptic->effects[effect]);
bobbens@2477
   438
}
bobbens@2477
   439
bobbens@2483
   440
/*
bobbens@2495
   441
 * Gets the status of a haptic effect.
bobbens@2495
   442
 */
bobbens@2495
   443
int
bobbens@2495
   444
SDL_HapticGetEffectStatus(SDL_Haptic *haptic, int effect)
bobbens@2495
   445
{
bobbens@2495
   446
   if (!ValidHaptic(&haptic) || !ValidEffect(haptic,effect)) {
bobbens@2495
   447
      return -1;
bobbens@2495
   448
   }
bobbens@2495
   449
bobbens@2495
   450
   if ((haptic->supported & SDL_HAPTIC_STATUS) == 0) {
bobbens@2495
   451
      SDL_SetError("Haptic device does not support status queries.");
bobbens@2495
   452
      return -1;
bobbens@2495
   453
   }
bobbens@2495
   454
bobbens@2495
   455
   return SDL_SYS_HapticGetEffectStatus(haptic, &haptic->effects[effect]);
bobbens@2495
   456
}
bobbens@2495
   457
bobbens@2495
   458
/*
bobbens@2483
   459
 * Sets the global gain of the device.
bobbens@2483
   460
 */
bobbens@2483
   461
int
bobbens@2483
   462
SDL_HapticSetGain(SDL_Haptic * haptic, int gain )
bobbens@2483
   463
{
bobbens@2483
   464
   if (!ValidHaptic(&haptic)) {
bobbens@2483
   465
      return -1;
bobbens@2483
   466
   }
bobbens@2477
   467
bobbens@2484
   468
   if ((haptic->supported & SDL_HAPTIC_GAIN) == 0) {
bobbens@2484
   469
      SDL_SetError("Haptic device does not support setting gain.");
bobbens@2484
   470
      return -1;
bobbens@2484
   471
   }
bobbens@2484
   472
bobbens@2483
   473
   if ((gain < 0) || (gain > 100)) {
bobbens@2483
   474
      SDL_SetError("Haptic gain must be between 0 and 100.");
bobbens@2483
   475
      return -1;
bobbens@2483
   476
   }
bobbens@2483
   477
bobbens@2483
   478
   if (SDL_SYS_HapticSetGain(haptic,gain) < 0) {
bobbens@2483
   479
      return -1;
bobbens@2483
   480
   }
bobbens@2483
   481
bobbens@2483
   482
   return 0;
bobbens@2483
   483
}
bobbens@2483
   484
bobbens@2484
   485
/*
bobbens@2484
   486
 * Makes the device autocenter, 0 disables.
bobbens@2484
   487
 */
bobbens@2484
   488
int
bobbens@2484
   489
SDL_HapticSetAutocenter(SDL_Haptic * haptic, int autocenter )
bobbens@2484
   490
{
bobbens@2484
   491
   if (!ValidHaptic(&haptic)) {
bobbens@2484
   492
      return -1;
bobbens@2484
   493
   }
bobbens@2483
   494
bobbens@2484
   495
   if ((haptic->supported & SDL_HAPTIC_AUTOCENTER) == 0) {
bobbens@2484
   496
      SDL_SetError("Haptic device does not support setting autocenter.");
bobbens@2484
   497
      return -1;
bobbens@2484
   498
   }
bobbens@2484
   499
bobbens@2484
   500
   if ((autocenter < 0) || (autocenter > 100)) {
bobbens@2484
   501
      SDL_SetError("Haptic autocenter must be between 0 and 100.");
bobbens@2484
   502
      return -1;
bobbens@2484
   503
   }                                           
bobbens@2484
   504
bobbens@2484
   505
   if (SDL_SYS_HapticSetAutocenter(haptic,autocenter) < 0) {
bobbens@2484
   506
      return -1;
bobbens@2484
   507
   }
bobbens@2484
   508
bobbens@2484
   509
   return 0;
bobbens@2484
   510
}
bobbens@2484
   511
bobbens@2484
   512