include/SDL_haptic.h
branchgsoc2008_force_feedback
changeset 2483 9d52368ebcf5
parent 2482 b51ad78812d5
child 2484 666472fd4cb0
--- a/include/SDL_haptic.h	Tue Jul 01 11:21:36 2008 +0000
+++ b/include/SDL_haptic.h	Tue Jul 01 14:09:53 2008 +0000
@@ -232,11 +232,15 @@
 
 /*
  * Creates a new haptic effect on the device.
+ *
+ * Returns the id of the effect on success, -1 on failure.
  */
 extern DECLSPEC int SDL_HapticNewEffect(SDL_Haptic * haptic, SDL_HapticEffect * effect);
 
 /*
  * Runs the haptic effect on it's assosciated haptic device.
+ *
+ * Returns 0 on success or -1 on failure.
  */
 extern DECLSPEC int SDL_HapticRunEffect(SDL_Haptic * haptic, int effect);
 
@@ -245,6 +249,13 @@
  */
 extern DECLSPEC void SDL_HapticDestroyEffect(SDL_Haptic * haptic, int effect);
 
+/*
+ * Sets the global gain of the device.  Gain should be between 0 and 100.
+ *
+ * Returns 0 on success or -1 on failure.
+ */
+extern DECLSPEC int SDL_HapticSetGain(SDL_Haptic * haptic, int gain);
+
 
 /* Ends C function definitions when using C++ */
 #ifdef __cplusplus