src/joystick/SDL_joystick.c
author Sam Lantinga <slouken@libsdl.org>
Sat, 18 May 2013 14:17:52 -0700
changeset 7191 75360622e65f
parent 7086 141ffce8bb59
child 7279 f7805b13b485
permissions -rw-r--r--
File style cleanup for the SDL 2.0 release
slouken@0
     1
/*
slouken@5535
     2
  Simple DirectMedia Layer
slouken@6885
     3
  Copyright (C) 1997-2013 Sam Lantinga <slouken@libsdl.org>
slouken@0
     4
slouken@5535
     5
  This software is provided 'as-is', without any express or implied
slouken@5535
     6
  warranty.  In no event will the authors be held liable for any damages
slouken@5535
     7
  arising from the use of this software.
slouken@0
     8
slouken@5535
     9
  Permission is granted to anyone to use this software for any purpose,
slouken@5535
    10
  including commercial applications, and to alter it and redistribute it
slouken@5535
    11
  freely, subject to the following restrictions:
slouken@0
    12
slouken@5535
    13
  1. The origin of this software must not be misrepresented; you must not
slouken@5535
    14
     claim that you wrote the original software. If you use this software
slouken@5535
    15
     in a product, an acknowledgment in the product documentation would be
slouken@5535
    16
     appreciated but is not required.
slouken@5535
    17
  2. Altered source versions must be plainly marked as such, and must not be
slouken@5535
    18
     misrepresented as being the original software.
slouken@5535
    19
  3. This notice may not be removed or altered from any source distribution.
slouken@0
    20
*/
slouken@1402
    21
#include "SDL_config.h"
slouken@0
    22
slouken@0
    23
/* This is the joystick API for Simple DirectMedia Layer */
slouken@0
    24
slouken@0
    25
#include "SDL_events.h"
slouken@1361
    26
#include "SDL_sysjoystick.h"
icculus@5861
    27
#include "SDL_assert.h"
icculus@5861
    28
slouken@1361
    29
#if !SDL_EVENTS_DISABLED
slouken@1361
    30
#include "../events/SDL_events_c.h"
slouken@0
    31
#endif
slouken@0
    32
slouken@6712
    33
static SDL_Joystick *SDL_joysticks = NULL;
slouken@6712
    34
static SDL_Joystick *SDL_updating_joystick = NULL;
slouken@0
    35
slouken@1895
    36
int
slouken@1895
    37
SDL_JoystickInit(void)
slouken@0
    38
{
slouken@1895
    39
    int status;
slouken@0
    40
slouken@1895
    41
    status = SDL_SYS_JoystickInit();
slouken@1895
    42
    if (status >= 0) {
slouken@6690
    43
      status = 0;
slouken@1895
    44
    }
slouken@1895
    45
    return (status);
slouken@0
    46
}
slouken@0
    47
slouken@0
    48
/*
slouken@0
    49
 * Count the number of joysticks attached to the system
slouken@0
    50
 */
slouken@1895
    51
int
slouken@1895
    52
SDL_NumJoysticks(void)
slouken@0
    53
{
slouken@6690
    54
    return SDL_SYS_NumJoysticks();
slouken@0
    55
}
slouken@0
    56
slouken@0
    57
/*
slouken@0
    58
 * Get the implementation dependent name of a joystick
slouken@0
    59
 */
slouken@1895
    60
const char *
slouken@6690
    61
SDL_JoystickNameForIndex(int device_index)
slouken@0
    62
{
slouken@6690
    63
    if ((device_index < 0) || (device_index >= SDL_NumJoysticks())) {
slouken@6690
    64
        SDL_SetError("There are %d joysticks available", SDL_NumJoysticks());
slouken@1895
    65
        return (NULL);
slouken@1895
    66
    }
slouken@6707
    67
    return (SDL_SYS_JoystickNameForDeviceIndex(device_index));
slouken@0
    68
}
slouken@0
    69
slouken@0
    70
/*
slouken@0
    71
 * Open a joystick for use - the index passed as an argument refers to
slouken@0
    72
 * the N'th joystick on the system.  This index is the value which will
slouken@0
    73
 * identify this joystick in future joystick events.
slouken@0
    74
 *
slouken@0
    75
 * This function returns a joystick identifier, or NULL if an error occurred.
slouken@0
    76
 */
slouken@1895
    77
SDL_Joystick *
slouken@1895
    78
SDL_JoystickOpen(int device_index)
slouken@0
    79
{
slouken@1895
    80
    SDL_Joystick *joystick;
slouken@7191
    81
    SDL_Joystick *joysticklist;
slouken@7191
    82
    const char *joystickname = NULL;
slouken@0
    83
slouken@6690
    84
    if ((device_index < 0) || (device_index >= SDL_NumJoysticks())) {
slouken@6690
    85
        SDL_SetError("There are %d joysticks available", SDL_NumJoysticks());
slouken@1895
    86
        return (NULL);
slouken@1895
    87
    }
slouken@0
    88
slouken@7191
    89
    joysticklist = SDL_joysticks;
slouken@7191
    90
    /* If the joystick is already open, return it
slouken@7191
    91
    * it is important that we have a single joystick * for each instance id
slouken@7191
    92
    */
slouken@7191
    93
    while ( joysticklist )
slouken@7191
    94
    {
slouken@7191
    95
        if ( SDL_SYS_GetInstanceIdOfDeviceIndex(device_index) == joysticklist->instance_id ) {
slouken@7191
    96
                joystick = joysticklist;
slouken@7191
    97
                ++joystick->ref_count;
slouken@7191
    98
                return (joystick);
slouken@7191
    99
        }
slouken@7191
   100
        joysticklist = joysticklist->next;
slouken@1895
   101
    }
slouken@0
   102
slouken@1895
   103
    /* Create and initialize the joystick */
slouken@1895
   104
    joystick = (SDL_Joystick *) SDL_malloc((sizeof *joystick));
icculus@3608
   105
    if (joystick == NULL) {
icculus@3608
   106
        SDL_OutOfMemory();
icculus@3608
   107
        return NULL;
slouken@1895
   108
    }
icculus@3608
   109
icculus@3608
   110
    SDL_memset(joystick, 0, (sizeof *joystick));
slouken@6690
   111
    if (SDL_SYS_JoystickOpen(joystick, device_index) < 0) {
icculus@3608
   112
        SDL_free(joystick);
icculus@3608
   113
        return NULL;
slouken@1895
   114
    }
slouken@6690
   115
slouken@7191
   116
    joystickname = SDL_SYS_JoystickNameForDeviceIndex( device_index );
slouken@7191
   117
    if ( joystickname )
slouken@7191
   118
        joystick->name = SDL_strdup( joystickname );
slouken@7191
   119
    else
slouken@7191
   120
        joystick->name = NULL;
slouken@6690
   121
icculus@3608
   122
    if (joystick->naxes > 0) {
icculus@3608
   123
        joystick->axes = (Sint16 *) SDL_malloc
icculus@3608
   124
            (joystick->naxes * sizeof(Sint16));
icculus@3608
   125
    }
icculus@3608
   126
    if (joystick->nhats > 0) {
icculus@3608
   127
        joystick->hats = (Uint8 *) SDL_malloc
icculus@3608
   128
            (joystick->nhats * sizeof(Uint8));
icculus@3608
   129
    }
icculus@3608
   130
    if (joystick->nballs > 0) {
icculus@3608
   131
        joystick->balls = (struct balldelta *) SDL_malloc
icculus@3608
   132
            (joystick->nballs * sizeof(*joystick->balls));
icculus@3608
   133
    }
icculus@3608
   134
    if (joystick->nbuttons > 0) {
icculus@3608
   135
        joystick->buttons = (Uint8 *) SDL_malloc
icculus@3608
   136
            (joystick->nbuttons * sizeof(Uint8));
icculus@3608
   137
    }
icculus@3608
   138
    if (((joystick->naxes > 0) && !joystick->axes)
icculus@3608
   139
        || ((joystick->nhats > 0) && !joystick->hats)
icculus@3608
   140
        || ((joystick->nballs > 0) && !joystick->balls)
icculus@3608
   141
        || ((joystick->nbuttons > 0) && !joystick->buttons)) {
icculus@3608
   142
        SDL_OutOfMemory();
icculus@3608
   143
        SDL_JoystickClose(joystick);
icculus@3608
   144
        return NULL;
icculus@3608
   145
    }
icculus@3608
   146
    if (joystick->axes) {
icculus@3608
   147
        SDL_memset(joystick->axes, 0, joystick->naxes * sizeof(Sint16));
icculus@3608
   148
    }
icculus@3608
   149
    if (joystick->hats) {
icculus@3608
   150
        SDL_memset(joystick->hats, 0, joystick->nhats * sizeof(Uint8));
icculus@3608
   151
    }
icculus@3608
   152
    if (joystick->balls) {
icculus@3608
   153
        SDL_memset(joystick->balls, 0,
icculus@3608
   154
            joystick->nballs * sizeof(*joystick->balls));
icculus@3608
   155
    }
icculus@3608
   156
    if (joystick->buttons) {
icculus@3608
   157
        SDL_memset(joystick->buttons, 0, joystick->nbuttons * sizeof(Uint8));
icculus@3608
   158
    }
icculus@3608
   159
icculus@3608
   160
    /* Add joystick to list */
icculus@3608
   161
    ++joystick->ref_count;
slouken@7191
   162
    /* Link the joystick in the list */
slouken@7191
   163
    joystick->next = SDL_joysticks;
slouken@7191
   164
    SDL_joysticks = joystick;
slouken@6690
   165
slouken@7191
   166
    SDL_SYS_JoystickUpdate( joystick );
icculus@3608
   167
slouken@1895
   168
    return (joystick);
slouken@0
   169
}
slouken@0
   170
slouken@2713
   171
slouken@2713
   172
/*
slouken@2713
   173
 * Checks to make sure the joystick is valid.
slouken@2713
   174
 */
slouken@2713
   175
int
slouken@6690
   176
SDL_PrivateJoystickValid(SDL_Joystick * joystick)
slouken@0
   177
{
slouken@1895
   178
    int valid;
slouken@0
   179
slouken@6690
   180
    if ( joystick == NULL ) {
slouken@1895
   181
        SDL_SetError("Joystick hasn't been opened yet");
slouken@1895
   182
        valid = 0;
slouken@1895
   183
    } else {
slouken@1895
   184
        valid = 1;
slouken@1895
   185
    }
slouken@7191
   186
slouken@7191
   187
    if ( joystick && joystick->closed )
slouken@7191
   188
    {
slouken@7191
   189
        valid = 0;
slouken@7191
   190
    }
slouken@7191
   191
slouken@1895
   192
    return valid;
slouken@0
   193
}
slouken@0
   194
slouken@0
   195
/*
slouken@0
   196
 * Get the number of multi-dimensional axis controls on a joystick
slouken@0
   197
 */
slouken@1895
   198
int
slouken@1895
   199
SDL_JoystickNumAxes(SDL_Joystick * joystick)
slouken@0
   200
{
slouken@6690
   201
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@1895
   202
        return (-1);
slouken@1895
   203
    }
slouken@1895
   204
    return (joystick->naxes);
slouken@0
   205
}
slouken@0
   206
slouken@0
   207
/*
slouken@0
   208
 * Get the number of hats on a joystick
slouken@0
   209
 */
slouken@1895
   210
int
slouken@1895
   211
SDL_JoystickNumHats(SDL_Joystick * joystick)
slouken@0
   212
{
slouken@6690
   213
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@1895
   214
        return (-1);
slouken@1895
   215
    }
slouken@1895
   216
    return (joystick->nhats);
slouken@0
   217
}
slouken@0
   218
slouken@0
   219
/*
slouken@0
   220
 * Get the number of trackballs on a joystick
slouken@0
   221
 */
slouken@1895
   222
int
slouken@1895
   223
SDL_JoystickNumBalls(SDL_Joystick * joystick)
slouken@0
   224
{
slouken@6690
   225
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@1895
   226
        return (-1);
slouken@1895
   227
    }
slouken@1895
   228
    return (joystick->nballs);
slouken@0
   229
}
slouken@0
   230
slouken@0
   231
/*
slouken@0
   232
 * Get the number of buttons on a joystick
slouken@0
   233
 */
slouken@1895
   234
int
slouken@1895
   235
SDL_JoystickNumButtons(SDL_Joystick * joystick)
slouken@0
   236
{
slouken@6690
   237
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@1895
   238
        return (-1);
slouken@1895
   239
    }
slouken@1895
   240
    return (joystick->nbuttons);
slouken@0
   241
}
slouken@0
   242
slouken@0
   243
/*
slouken@0
   244
 * Get the current state of an axis control on a joystick
slouken@0
   245
 */
slouken@1895
   246
Sint16
slouken@1895
   247
SDL_JoystickGetAxis(SDL_Joystick * joystick, int axis)
slouken@0
   248
{
slouken@1895
   249
    Sint16 state;
slouken@0
   250
slouken@6690
   251
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@1895
   252
        return (0);
slouken@1895
   253
    }
slouken@1895
   254
    if (axis < joystick->naxes) {
slouken@1895
   255
        state = joystick->axes[axis];
slouken@1895
   256
    } else {
slouken@1895
   257
        SDL_SetError("Joystick only has %d axes", joystick->naxes);
slouken@1895
   258
        state = 0;
slouken@1895
   259
    }
slouken@1895
   260
    return (state);
slouken@0
   261
}
slouken@0
   262
slouken@0
   263
/*
slouken@0
   264
 * Get the current state of a hat on a joystick
slouken@0
   265
 */
slouken@1895
   266
Uint8
slouken@1895
   267
SDL_JoystickGetHat(SDL_Joystick * joystick, int hat)
slouken@0
   268
{
slouken@1895
   269
    Uint8 state;
slouken@0
   270
slouken@6690
   271
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@1895
   272
        return (0);
slouken@1895
   273
    }
slouken@1895
   274
    if (hat < joystick->nhats) {
slouken@1895
   275
        state = joystick->hats[hat];
slouken@1895
   276
    } else {
slouken@1895
   277
        SDL_SetError("Joystick only has %d hats", joystick->nhats);
slouken@1895
   278
        state = 0;
slouken@1895
   279
    }
slouken@1895
   280
    return (state);
slouken@0
   281
}
slouken@0
   282
slouken@0
   283
/*
slouken@0
   284
 * Get the ball axis change since the last poll
slouken@0
   285
 */
slouken@1895
   286
int
slouken@1895
   287
SDL_JoystickGetBall(SDL_Joystick * joystick, int ball, int *dx, int *dy)
slouken@0
   288
{
slouken@1895
   289
    int retval;
slouken@0
   290
slouken@6690
   291
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@1895
   292
        return (-1);
slouken@1895
   293
    }
slouken@0
   294
slouken@1895
   295
    retval = 0;
slouken@1895
   296
    if (ball < joystick->nballs) {
slouken@1895
   297
        if (dx) {
slouken@1895
   298
            *dx = joystick->balls[ball].dx;
slouken@1895
   299
        }
slouken@1895
   300
        if (dy) {
slouken@1895
   301
            *dy = joystick->balls[ball].dy;
slouken@1895
   302
        }
slouken@1895
   303
        joystick->balls[ball].dx = 0;
slouken@1895
   304
        joystick->balls[ball].dy = 0;
slouken@1895
   305
    } else {
icculus@7037
   306
        return SDL_SetError("Joystick only has %d balls", joystick->nballs);
slouken@1895
   307
    }
slouken@1895
   308
    return (retval);
slouken@0
   309
}
slouken@0
   310
slouken@0
   311
/*
slouken@0
   312
 * Get the current state of a button on a joystick
slouken@0
   313
 */
slouken@1895
   314
Uint8
slouken@1895
   315
SDL_JoystickGetButton(SDL_Joystick * joystick, int button)
slouken@0
   316
{
slouken@1895
   317
    Uint8 state;
slouken@0
   318
slouken@6690
   319
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@1895
   320
        return (0);
slouken@1895
   321
    }
slouken@1895
   322
    if (button < joystick->nbuttons) {
slouken@1895
   323
        state = joystick->buttons[button];
slouken@1895
   324
    } else {
slouken@1895
   325
        SDL_SetError("Joystick only has %d buttons", joystick->nbuttons);
slouken@1895
   326
        state = 0;
slouken@1895
   327
    }
slouken@1895
   328
    return (state);
slouken@0
   329
}
slouken@0
   330
slouken@0
   331
/*
slouken@6690
   332
 * Return if the joystick in question is currently attached to the system,
slouken@6690
   333
 *  \return 0 if not plugged in, 1 if still present.
slouken@6690
   334
 */
slouken@6707
   335
SDL_bool
slouken@6707
   336
SDL_JoystickGetAttached(SDL_Joystick * joystick)
slouken@6690
   337
{
slouken@7191
   338
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@6707
   339
        return SDL_FALSE;
slouken@6690
   340
    }
slouken@6690
   341
slouken@7191
   342
    return SDL_SYS_JoystickAttached(joystick);
slouken@6690
   343
}
slouken@6690
   344
slouken@6690
   345
/*
slouken@6690
   346
 * Get the instance id for this opened joystick
slouken@6690
   347
 */
slouken@7191
   348
SDL_JoystickID
slouken@6707
   349
SDL_JoystickInstanceID(SDL_Joystick * joystick)
slouken@6690
   350
{
slouken@7191
   351
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@6690
   352
        return (-1);
slouken@6690
   353
    }
slouken@6690
   354
slouken@7191
   355
    return (joystick->instance_id);
slouken@6690
   356
}
slouken@6690
   357
slouken@6690
   358
/*
slouken@6690
   359
 * Get the friendly name of this joystick
slouken@6690
   360
 */
slouken@6690
   361
const char *
slouken@6690
   362
SDL_JoystickName(SDL_Joystick * joystick)
slouken@6690
   363
{
slouken@6690
   364
    if (!SDL_PrivateJoystickValid(joystick)) {
slouken@6690
   365
        return (NULL);
slouken@6690
   366
    }
slouken@7191
   367
slouken@6690
   368
    return (joystick->name);
slouken@6690
   369
}
slouken@6690
   370
slouken@6690
   371
/*
slouken@0
   372
 * Close a joystick previously opened with SDL_JoystickOpen()
slouken@0
   373
 */
slouken@1895
   374
void
slouken@1895
   375
SDL_JoystickClose(SDL_Joystick * joystick)
slouken@0
   376
{
slouken@7191
   377
    SDL_Joystick *joysticklist;
slouken@7191
   378
    SDL_Joystick *joysticklistprev;
slouken@0
   379
slouken@6690
   380
    if (!joystick) {
slouken@1895
   381
        return;
slouken@1895
   382
    }
slouken@0
   383
slouken@1895
   384
    /* First decrement ref count */
slouken@1895
   385
    if (--joystick->ref_count > 0) {
slouken@1895
   386
        return;
slouken@1895
   387
    }
slouken@0
   388
slouken@6712
   389
    if (joystick == SDL_updating_joystick) {
slouken@6712
   390
        return;
slouken@6712
   391
    }
slouken@6712
   392
slouken@1895
   393
    SDL_SYS_JoystickClose(joystick);
slouken@0
   394
slouken@7191
   395
    joysticklist = SDL_joysticks;
slouken@7191
   396
    joysticklistprev = NULL;
slouken@7191
   397
    while ( joysticklist )
slouken@7191
   398
    {
slouken@7191
   399
        if (joystick == joysticklist)
slouken@7191
   400
        {
slouken@7191
   401
            if ( joysticklistprev )
slouken@7191
   402
            {
slouken@7191
   403
                /* unlink this entry */
slouken@7191
   404
                joysticklistprev->next = joysticklist->next;
slouken@7191
   405
            }
slouken@7191
   406
            else
slouken@7191
   407
            {
slouken@7191
   408
                SDL_joysticks = joystick->next;
slouken@7191
   409
            }
slouken@7191
   410
slouken@7191
   411
            break;
slouken@7191
   412
        }
slouken@7191
   413
        joysticklistprev = joysticklist;
slouken@7191
   414
        joysticklist = joysticklist->next;
slouken@7191
   415
    }
slouken@7191
   416
slouken@7191
   417
    if (joystick->name)
slouken@7191
   418
        SDL_free(joystick->name);
slouken@0
   419
slouken@1895
   420
    /* Free the data associated with this joystick */
slouken@1895
   421
    if (joystick->axes) {
slouken@1895
   422
        SDL_free(joystick->axes);
slouken@1895
   423
    }
slouken@1895
   424
    if (joystick->hats) {
slouken@1895
   425
        SDL_free(joystick->hats);
slouken@1895
   426
    }
slouken@1895
   427
    if (joystick->balls) {
slouken@1895
   428
        SDL_free(joystick->balls);
slouken@1895
   429
    }
slouken@1895
   430
    if (joystick->buttons) {
slouken@1895
   431
        SDL_free(joystick->buttons);
slouken@1895
   432
    }
slouken@1895
   433
    SDL_free(joystick);
slouken@0
   434
}
slouken@0
   435
slouken@1895
   436
void
slouken@1895
   437
SDL_JoystickQuit(void)
slouken@0
   438
{
slouken@6712
   439
    /* Make sure we're not getting called in the middle of updating joysticks */
slouken@6712
   440
    SDL_assert(!SDL_updating_joystick);
slouken@6712
   441
slouken@1895
   442
    /* Stop the event polling */
slouken@7191
   443
    while ( SDL_joysticks )
slouken@7191
   444
    {
slouken@7191
   445
        SDL_joysticks->ref_count = 1;
slouken@6690
   446
        SDL_JoystickClose(SDL_joysticks);
slouken@7191
   447
    }
icculus@5856
   448
slouken@1895
   449
    /* Quit the joystick setup */
slouken@1895
   450
    SDL_SYS_JoystickQuit();
slouken@0
   451
}
slouken@0
   452
slouken@0
   453
slouken@0
   454
/* These are global for SDL_sysjoystick.c and SDL_events.c */
slouken@0
   455
slouken@1895
   456
int
slouken@1895
   457
SDL_PrivateJoystickAxis(SDL_Joystick * joystick, Uint8 axis, Sint16 value)
slouken@0
   458
{
slouken@1895
   459
    int posted;
slouken@0
   460
slouken@6145
   461
    /* Make sure we're not getting garbage events */
slouken@6145
   462
    if (axis >= joystick->naxes) {
slouken@6145
   463
        return 0;
slouken@6145
   464
    }
slouken@6145
   465
slouken@1895
   466
    /* Update internal joystick state */
slouken@6735
   467
    if (value == joystick->axes[axis]) {
slouken@6735
   468
        return 0;
slouken@6735
   469
    }
slouken@1895
   470
    joystick->axes[axis] = value;
slouken@0
   471
slouken@1895
   472
    /* Post the event, if desired */
slouken@1895
   473
    posted = 0;
slouken@1361
   474
#if !SDL_EVENTS_DISABLED
slouken@4429
   475
    if (SDL_GetEventState(SDL_JOYAXISMOTION) == SDL_ENABLE) {
slouken@1895
   476
        SDL_Event event;
slouken@1895
   477
        event.type = SDL_JOYAXISMOTION;
slouken@6690
   478
        event.jaxis.which = joystick->instance_id;
slouken@1895
   479
        event.jaxis.axis = axis;
slouken@1895
   480
        event.jaxis.value = value;
slouken@6690
   481
        posted = SDL_PushEvent(&event) == 1;
slouken@1895
   482
    }
slouken@1361
   483
#endif /* !SDL_EVENTS_DISABLED */
slouken@1895
   484
    return (posted);
slouken@0
   485
}
slouken@0
   486
slouken@1895
   487
int
slouken@1895
   488
SDL_PrivateJoystickHat(SDL_Joystick * joystick, Uint8 hat, Uint8 value)
slouken@0
   489
{
slouken@1895
   490
    int posted;
slouken@0
   491
slouken@6145
   492
    /* Make sure we're not getting garbage events */
slouken@6145
   493
    if (hat >= joystick->nhats) {
slouken@6145
   494
        return 0;
slouken@6145
   495
    }
slouken@6145
   496
slouken@1895
   497
    /* Update internal joystick state */
slouken@1895
   498
    joystick->hats[hat] = value;
slouken@0
   499
slouken@1895
   500
    /* Post the event, if desired */
slouken@1895
   501
    posted = 0;
slouken@1361
   502
#if !SDL_EVENTS_DISABLED
slouken@4429
   503
    if (SDL_GetEventState(SDL_JOYHATMOTION) == SDL_ENABLE) {
slouken@1895
   504
        SDL_Event event;
slouken@1895
   505
        event.jhat.type = SDL_JOYHATMOTION;
slouken@6690
   506
        event.jhat.which = joystick->instance_id;
slouken@1895
   507
        event.jhat.hat = hat;
slouken@1895
   508
        event.jhat.value = value;
slouken@6690
   509
        posted = SDL_PushEvent(&event) == 1;
slouken@1895
   510
    }
slouken@1361
   511
#endif /* !SDL_EVENTS_DISABLED */
slouken@1895
   512
    return (posted);
slouken@0
   513
}
slouken@0
   514
slouken@1895
   515
int
slouken@1895
   516
SDL_PrivateJoystickBall(SDL_Joystick * joystick, Uint8 ball,
slouken@1895
   517
                        Sint16 xrel, Sint16 yrel)
slouken@0
   518
{
slouken@1895
   519
    int posted;
slouken@0
   520
slouken@6145
   521
    /* Make sure we're not getting garbage events */
slouken@6145
   522
    if (ball >= joystick->nballs) {
slouken@6145
   523
        return 0;
slouken@6145
   524
    }
slouken@6145
   525
slouken@1895
   526
    /* Update internal mouse state */
slouken@1895
   527
    joystick->balls[ball].dx += xrel;
slouken@1895
   528
    joystick->balls[ball].dy += yrel;
slouken@0
   529
slouken@1895
   530
    /* Post the event, if desired */
slouken@1895
   531
    posted = 0;
slouken@1361
   532
#if !SDL_EVENTS_DISABLED
slouken@4429
   533
    if (SDL_GetEventState(SDL_JOYBALLMOTION) == SDL_ENABLE) {
slouken@1895
   534
        SDL_Event event;
slouken@1895
   535
        event.jball.type = SDL_JOYBALLMOTION;
slouken@6690
   536
        event.jball.which = joystick->instance_id;
slouken@1895
   537
        event.jball.ball = ball;
slouken@1895
   538
        event.jball.xrel = xrel;
slouken@1895
   539
        event.jball.yrel = yrel;
slouken@6690
   540
        posted = SDL_PushEvent(&event) == 1;
slouken@1895
   541
    }
slouken@1361
   542
#endif /* !SDL_EVENTS_DISABLED */
slouken@1895
   543
    return (posted);
slouken@0
   544
}
slouken@0
   545
slouken@1895
   546
int
slouken@1895
   547
SDL_PrivateJoystickButton(SDL_Joystick * joystick, Uint8 button, Uint8 state)
slouken@0
   548
{
slouken@1895
   549
    int posted;
slouken@1361
   550
#if !SDL_EVENTS_DISABLED
slouken@1895
   551
    SDL_Event event;
slouken@0
   552
slouken@1895
   553
    switch (state) {
slouken@1895
   554
    case SDL_PRESSED:
slouken@1895
   555
        event.type = SDL_JOYBUTTONDOWN;
slouken@1895
   556
        break;
slouken@1895
   557
    case SDL_RELEASED:
slouken@1895
   558
        event.type = SDL_JOYBUTTONUP;
slouken@1895
   559
        break;
slouken@1895
   560
    default:
slouken@1895
   561
        /* Invalid state -- bail */
slouken@1895
   562
        return (0);
slouken@1895
   563
    }
slouken@1361
   564
#endif /* !SDL_EVENTS_DISABLED */
slouken@0
   565
slouken@6145
   566
    /* Make sure we're not getting garbage events */
slouken@6145
   567
    if (button >= joystick->nbuttons) {
slouken@6145
   568
        return 0;
slouken@6145
   569
    }
slouken@6145
   570
slouken@1895
   571
    /* Update internal joystick state */
slouken@1895
   572
    joystick->buttons[button] = state;
slouken@0
   573
slouken@1895
   574
    /* Post the event, if desired */
slouken@1895
   575
    posted = 0;
slouken@1361
   576
#if !SDL_EVENTS_DISABLED
slouken@4429
   577
    if (SDL_GetEventState(event.type) == SDL_ENABLE) {
slouken@6690
   578
        event.jbutton.which = joystick->instance_id;
slouken@1895
   579
        event.jbutton.button = button;
slouken@1895
   580
        event.jbutton.state = state;
slouken@6690
   581
        posted = SDL_PushEvent(&event) == 1;
slouken@1895
   582
    }
slouken@1361
   583
#endif /* !SDL_EVENTS_DISABLED */
slouken@1895
   584
    return (posted);
slouken@0
   585
}
slouken@0
   586
slouken@1895
   587
void
slouken@1895
   588
SDL_JoystickUpdate(void)
slouken@0
   589
{
slouken@7191
   590
    SDL_Joystick *joystick;
slouken@7191
   591
slouken@7191
   592
    joystick = SDL_joysticks;
slouken@7191
   593
    while ( joystick )
slouken@7191
   594
    {
slouken@7191
   595
        SDL_Joystick *joysticknext;
slouken@7191
   596
        /* save off the next pointer, the Update call may cause a joystick removed event
slouken@7191
   597
         * and cause our joystick pointer to be freed
slouken@7191
   598
         */
slouken@7191
   599
        joysticknext = joystick->next;
slouken@0
   600
slouken@6712
   601
        SDL_updating_joystick = joystick;
slouken@6712
   602
slouken@6690
   603
        SDL_SYS_JoystickUpdate( joystick );
slouken@6690
   604
slouken@7191
   605
        if ( joystick->closed && joystick->uncentered )
slouken@7191
   606
        {
slouken@7191
   607
            int i;
slouken@7191
   608
            joystick->uncentered = 0;
slouken@6690
   609
slouken@6712
   610
            /* Tell the app that everything is centered/unpressed...  */
slouken@6690
   611
            for (i = 0; i < joystick->naxes; i++)
slouken@6690
   612
                SDL_PrivateJoystickAxis(joystick, i, 0);
slouken@6690
   613
slouken@6690
   614
            for (i = 0; i < joystick->nbuttons; i++)
slouken@6690
   615
                SDL_PrivateJoystickButton(joystick, i, 0);
slouken@6690
   616
slouken@6690
   617
            for (i = 0; i < joystick->nhats; i++)
slouken@6690
   618
                SDL_PrivateJoystickHat(joystick, i, SDL_HAT_CENTERED);
slouken@6712
   619
slouken@7191
   620
        }
slouken@6690
   621
slouken@6712
   622
        SDL_updating_joystick = NULL;
slouken@6712
   623
slouken@6712
   624
        /* If the joystick was closed while updating, free it here */
slouken@6712
   625
        if ( joystick->ref_count <= 0 ) {
slouken@6712
   626
            SDL_JoystickClose(joystick);
slouken@6712
   627
        }
slouken@6712
   628
slouken@7191
   629
        joystick = joysticknext;
slouken@7191
   630
    }
slouken@6690
   631
slouken@7191
   632
    /* this needs to happen AFTER walking the joystick list above, so that any
slouken@7191
   633
       dangling hardware data from removed devices can be free'd
slouken@7191
   634
     */
slouken@7191
   635
    SDL_SYS_JoystickDetect();
slouken@0
   636
}
slouken@0
   637
slouken@1895
   638
int
slouken@1895
   639
SDL_JoystickEventState(int state)
slouken@0
   640
{
slouken@1361
   641
#if SDL_EVENTS_DISABLED
slouken@6753
   642
    return SDL_DISABLE;
slouken@0
   643
#else
slouken@4429
   644
    const Uint32 event_list[] = {
slouken@1895
   645
        SDL_JOYAXISMOTION, SDL_JOYBALLMOTION, SDL_JOYHATMOTION,
slouken@6690
   646
        SDL_JOYBUTTONDOWN, SDL_JOYBUTTONUP, SDL_JOYDEVICEADDED, SDL_JOYDEVICEREMOVED
slouken@1895
   647
    };
slouken@1895
   648
    unsigned int i;
slouken@0
   649
slouken@1895
   650
    switch (state) {
slouken@1895
   651
    case SDL_QUERY:
slouken@6753
   652
        state = SDL_DISABLE;
slouken@1895
   653
        for (i = 0; i < SDL_arraysize(event_list); ++i) {
slouken@1895
   654
            state = SDL_EventState(event_list[i], SDL_QUERY);
slouken@1895
   655
            if (state == SDL_ENABLE) {
slouken@1895
   656
                break;
slouken@1895
   657
            }
slouken@1895
   658
        }
slouken@1895
   659
        break;
slouken@1895
   660
    default:
slouken@1895
   661
        for (i = 0; i < SDL_arraysize(event_list); ++i) {
slouken@1895
   662
            SDL_EventState(event_list[i], state);
slouken@1895
   663
        }
slouken@1895
   664
        break;
slouken@1895
   665
    }
slouken@1895
   666
    return (state);
slouken@1361
   667
#endif /* SDL_EVENTS_DISABLED */
slouken@0
   668
}
slouken@1895
   669
slouken@6690
   670
/* return 1 if you want to run the joystick update loop this frame, used by hotplug support */
slouken@7191
   671
SDL_bool
slouken@6690
   672
SDL_PrivateJoystickNeedsPolling()
slouken@6690
   673
{
slouken@7191
   674
    if (SDL_joysticks != NULL) {
slouken@7191
   675
        return SDL_TRUE;
slouken@7191
   676
    } else {
slouken@7191
   677
        return SDL_SYS_JoystickNeedsPolling();
slouken@7191
   678
    }
slouken@6690
   679
}
slouken@6690
   680
slouken@6690
   681
slouken@6693
   682
/* return the guid for this index */
slouken@6738
   683
SDL_JoystickGUID SDL_JoystickGetDeviceGUID(int device_index)
slouken@6690
   684
{
slouken@7191
   685
    return SDL_SYS_JoystickGetDeviceGUID( device_index );
slouken@6690
   686
}
slouken@6690
   687
slouken@6693
   688
/* return the guid for this opened device */
slouken@6738
   689
SDL_JoystickGUID SDL_JoystickGetGUID(SDL_Joystick * joystick)
slouken@6690
   690
{
slouken@7191
   691
    return SDL_SYS_JoystickGetGUID( joystick );
slouken@6690
   692
}
slouken@6690
   693
slouken@6690
   694
/* convert the guid to a printable string */
slouken@6738
   695
void SDL_JoystickGetGUIDString( SDL_JoystickGUID guid, char *pszGUID, int cbGUID )
slouken@6690
   696
{
slouken@7191
   697
    static const char k_rgchHexToASCII[] = "0123456789abcdef";
slouken@7191
   698
    int i;
slouken@6690
   699
icculus@6748
   700
    if ((pszGUID == NULL) || (cbGUID <= 0)) {
icculus@6748
   701
        return;
icculus@6748
   702
    }
icculus@6748
   703
slouken@7191
   704
    for ( i = 0; i < sizeof(guid.data) && i < (cbGUID-1); i++ )
slouken@7191
   705
    {
slouken@7191
   706
        /* each input byte writes 2 ascii chars, and might write a null byte. */
slouken@7191
   707
        /* If we don't have room for next input byte, stop */
slouken@7191
   708
        unsigned char c = guid.data[i];
slouken@6690
   709
slouken@7191
   710
        *pszGUID++ = k_rgchHexToASCII[ c >> 4 ];
slouken@7191
   711
        *pszGUID++ = k_rgchHexToASCII[ c & 0x0F ];
slouken@7191
   712
    }
slouken@7191
   713
    *pszGUID = '\0';
slouken@6690
   714
}
slouken@6690
   715
slouken@6690
   716
slouken@7191
   717
/*-----------------------------------------------------------------------------
slouken@7191
   718
 * Purpose: Returns the 4 bit nibble for a hex character
slouken@7191
   719
 * Input  : c -
slouken@7191
   720
 * Output : unsigned char
slouken@7191
   721
 *-----------------------------------------------------------------------------*/
slouken@6690
   722
static unsigned char nibble( char c )
slouken@6690
   723
{
slouken@7191
   724
    if ( ( c >= '0' ) &&
slouken@7191
   725
        ( c <= '9' ) )
slouken@7191
   726
    {
slouken@7191
   727
        return (unsigned char)(c - '0');
slouken@7191
   728
    }
slouken@6690
   729
slouken@7191
   730
    if ( ( c >= 'A' ) &&
slouken@7191
   731
        ( c <= 'F' ) )
slouken@7191
   732
    {
slouken@7191
   733
        return (unsigned char)(c - 'A' + 0x0a);
slouken@7191
   734
    }
slouken@6690
   735
slouken@7191
   736
    if ( ( c >= 'a' ) &&
slouken@7191
   737
        ( c <= 'f' ) )
slouken@7191
   738
    {
slouken@7191
   739
        return (unsigned char)(c - 'a' + 0x0a);
slouken@7191
   740
    }
slouken@6690
   741
slouken@7191
   742
    /* received an invalid character, and no real way to return an error */
slouken@7191
   743
    /* AssertMsg1( false, "Q_nibble invalid hex character '%c' ", c ); */
slouken@7191
   744
    return 0;
slouken@6690
   745
}
slouken@6690
   746
slouken@6690
   747
slouken@6690
   748
/* convert the string version of a joystick guid to the struct */
slouken@6738
   749
SDL_JoystickGUID SDL_JoystickGetGUIDFromString(const char *pchGUID)
slouken@6690
   750
{
slouken@7191
   751
    SDL_JoystickGUID guid;
slouken@7191
   752
    int maxoutputbytes= sizeof(guid);
slouken@7191
   753
    int len = SDL_strlen( pchGUID );
slouken@7191
   754
    Uint8 *p;
slouken@7191
   755
    int i;
slouken@6690
   756
slouken@7191
   757
    /* Make sure it's even */
slouken@7191
   758
    len = ( len ) & ~0x1;
slouken@6690
   759
slouken@7191
   760
    SDL_memset( &guid, 0x00, sizeof(guid) );
slouken@6690
   761
slouken@7191
   762
    p = (Uint8 *)&guid;
slouken@7191
   763
    for ( i = 0;
slouken@7191
   764
        ( i < len ) && ( ( p - (Uint8 *)&guid ) < maxoutputbytes );
slouken@7191
   765
        i+=2, p++ )
slouken@7191
   766
    {
slouken@7191
   767
        *p = ( nibble( pchGUID[i] ) << 4 ) | nibble( pchGUID[i+1] );
slouken@7191
   768
    }
slouken@6690
   769
slouken@7191
   770
    return guid;
slouken@6690
   771
}
slouken@6690
   772
slouken@6690
   773
slouken@1895
   774
/* vi: set ts=4 sw=4 expandtab: */