FUNCTIONS

1. SDL_SYS_JoystickInit
2. SDL_SYS_JoystickName
3. SDL_SYS_JoystickOpen
4. SDL_SYS_JoystickUpdate
5. SDL_SYS_JoystickClose
6. SDL_SYS_JoystickQuit

   1 /*
   2     SDL - Simple DirectMedia Layer
   3     Copyright (C) 1997, 1998, 1999, 2000, 2001  Sam Lantinga
   4 
   5     This library is free software; you can redistribute it and/or
   6     modify it under the terms of the GNU Library General Public
   7     License as published by the Free Software Foundation; either
   8     version 2 of the License, or (at your option) any later version.
   9 
  10     This library is distributed in the hope that it will be useful,
  11     but WITHOUT ANY WARRANTY; without even the implied warranty of
  12     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13     Library General Public License for more details.
  14 
  15     You should have received a copy of the GNU Library General Public
  16     License along with this library; if not, write to the Free
  17     Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  18 
  19     Sam Lantinga
  20     slouken@devolution.com
  21 */
  23 #ifdef SAVE_RCSID
  24 static char rcsid =
  25  "@(#) $Id: SDL_sysjoystick.c,v 1.1.2.5 2001/02/10 07:20:04 hercules Exp $";
  26 #endif
  28 /* This is the system specific header for the SDL joystick API */
  30 #include <stdio.h>              /* For the definition of NULL */
  32 #include "SDL_error.h"
  33 #include "SDL_joystick.h"
  34 #include "SDL_sysjoystick.h"
  35 #include "SDL_joystick_c.h"
  37 /* Function to scan the system for joysticks.
  38  * This function should set SDL_numjoysticks to the number of available
  39  * joysticks.  Joystick 0 should be the system default joystick.
  40  * It should return 0, or -1 on an unrecoverable fatal error.
  41  */
  42 int SDL_SYS_JoystickInit(void)
     /* [<][>][^][v][top][bottom][index][help] */
  43 {
  44         SDL_numjoysticks = 0;
  45         return(0);
  46 }
  48 /* Function to get the device-dependent name of a joystick */
  49 const char *SDL_SYS_JoystickName(int index)
     /* [<][>][^][v][top][bottom][index][help] */
  50 {
SDL_SetError("Logic error: No joysticks available");
  52         return(NULL);
  53 }
  55 /* Function to open a joystick for use.
  56    The joystick to open is specified by the index field of the joystick.
  57    This should fill the nbuttons and naxes fields of the joystick structure.
  58    It returns 0, or -1 if there is an error.
  59  */
  60 int SDL_SYS_JoystickOpen(SDL_Joystick *joystick)
     /* [<][>][^][v][top][bottom][index][help] */
  61 {
SDL_SetError("Logic error: No joysticks available");
  63         return(-1);
  64 }
  66 /* Function to update the state of a joystick - called as a device poll.
  67  * This function shouldn't update the joystick structure directly,
  68  * but instead should call SDL_PrivateJoystick*() to deliver events
  69  * and update joystick device state.
  70  */
  71 void SDL_SYS_JoystickUpdate(SDL_Joystick *joystick)
     /* [<][>][^][v][top][bottom][index][help] */
  72 {
  73         return;
  74 }
  76 /* Function to close a joystick after use */
  77 void SDL_SYS_JoystickClose(SDL_Joystick *joystick)
     /* [<][>][^][v][top][bottom][index][help] */
  78 {
  79         return;
  80 }
  82 /* Function to perform any system-specific joystick related cleanup */
  83 void SDL_SYS_JoystickQuit(void)
     /* [<][>][^][v][top][bottom][index][help] */
  84 {
  85         return;
  86 }