Move code removing "-psn_xxx" command line arguments to common code.

[wxWidgets.git] / interface / wx / joystick.h

diff --git a/interface/wx/joystick.h b/interface/wx/joystick.h
index 6550ae1594942082fe9563e72b840de8473ae8dd..c2c227606a5f6ffedcd9df3aafacea6039de799c 100644 (file)
--- a/interface/wx/joystick.h
+++ b/interface/wx/joystick.h
@@ -2,8 +2,7 @@
 // Name:        joystick.h
 // Purpose:     interface of wxJoystick
 // Author:      wxWidgets team
 // Name:        joystick.h
 // Purpose:     interface of wxJoystick
 // Author:      wxWidgets team

-// RCS-ID:      $Id$
-// Licence:     wxWindows license
+// Licence:     wxWindows licence

 /////////////////////////////////////////////////////////////////////////////
 
 /**
 /////////////////////////////////////////////////////////////////////////////
 
 /**


@@ -12,7 +11,7 @@
     wxJoystick allows an application to control one or more joysticks.
 
     @library{wxadv}
     wxJoystick allows an application to control one or more joysticks.
 
     @library{wxadv}

-    @category{FIXME}
+    @category{misc}

 
     @see wxJoystickEvent
 */
 
     @see wxJoystickEvent
 */


@@ -20,8 +19,9 @@ class wxJoystick : public wxObject
 {
 public:
     /**
 {
 public:
     /**

-        Constructor. @a joystick may be one of wxJOYSTICK1, wxJOYSTICK2, indicating the
-        joystick
+        Constructor.
+
+        @a joystick may be one of wxJOYSTICK1, wxJOYSTICK2, indicating the joystick

         controller of interest.
     */
     wxJoystick(int joystick = wxJOYSTICK1);
         controller of interest.
     */
     wxJoystick(int joystick = wxJOYSTICK1);


@@ -31,16 +31,23 @@ public:
     */
     virtual ~wxJoystick();
 
     */
     virtual ~wxJoystick();
 

-    //@{
+    /**
+        Returns the state of the joystick buttons.
+        Every button is mapped to a single bit in the returned integer, with the
+        first button being mapped to the least significant bit, and so on.
+
+        A bitlist of wxJOY_BUTTONn identifiers, where n is 1, 2, 3 or 4 is available
+        for historical reasons.
+    */
+    int GetButtonState() const;
+

     /**
         Returns the state of the specified joystick button.
 
         @param id
             The button id to report, from 0 to GetNumberButtons() - 1
     */
     /**
         Returns the state of the specified joystick button.
 
         @param id
             The button id to report, from 0 to GetNumberButtons() - 1
     */

-    int GetButtonState() const;
-    const bool GetButtonState(unsigned id) const;
-    //@}
+    bool GetButtonState(unsigned int id) const;

 
     /**
         Returns the manufacturer id.
 
     /**
         Returns the manufacturer id.


@@ -72,14 +79,15 @@ public:
     /**
         Returns the point-of-view position, expressed in continuous, one-hundredth of a
         degree units.
     /**
         Returns the point-of-view position, expressed in continuous, one-hundredth of a
         degree units.

+

         Returns -1 on error.
     */
     int GetPOVCTSPosition() const;
 
     /**
         Returns the point-of-view position, expressed in continuous, one-hundredth of a
         Returns -1 on error.
     */
     int GetPOVCTSPosition() const;
 
     /**
         Returns the point-of-view position, expressed in continuous, one-hundredth of a

-        degree units,
-        but limited to return 0, 9000, 18000 or 27000.
+        degree units, but limited to return 0, 9000, 18000 or 27000.
+

         Returns -1 on error.
     */
     int GetPOVPosition() const;
         Returns -1 on error.
     */
     int GetPOVPosition() const;


@@ -94,16 +102,18 @@ public:
     */
     int GetPollingMin() const;
 
     */
     int GetPollingMin() const;
 

-    //@{
+    /**
+        Returns the x, y position of the joystick.
+    */
+    wxPoint GetPosition() const;
+

     /**
         Returns the position of the specified joystick axis.
 
         @param axis
             The joystick axis to report, from 0 to GetNumberAxes() - 1.
     */
     /**
         Returns the position of the specified joystick axis.
 
         @param axis
             The joystick axis to report, from 0 to GetNumberAxes() - 1.
     */

-    wxPoint GetPosition() const;
-    const int GetPosition(unsigned axis) const;
-    //@}
+    int GetPosition(unsigned int axis) const;

 
     /**
         Returns the product id for the joystick.
 
     /**
         Returns the product id for the joystick.


@@ -201,15 +211,15 @@ public:
     bool HasPOV() const;
 
     /**
     bool HasPOV() const;
 
     /**

-        Returns @true if the joystick point-of-view supports discrete values (centered,
-        forward, backward, left, and right).
+        Returns @true if the joystick point-of-view supports discrete values
+        (centered, forward, backward, left, and right).

     */
     bool HasPOV4Dir() const;
 
     /**
         Returns @true if the joystick point-of-view supports continuous degree bearings.
     */
     */
     bool HasPOV4Dir() const;
 
     /**
         Returns @true if the joystick point-of-view supports continuous degree bearings.
     */

-#define bool HasPOVCTS() const     /* implementation is private */
+    bool HasPOVCTS() const;

 
     /**
         Returns @true if there is a rudder attached to the computer.
 
     /**
         Returns @true if there is a rudder attached to the computer.


@@ -246,14 +256,13 @@ public:
     bool ReleaseCapture();
 
     /**
     bool ReleaseCapture();
 
     /**

-        Sets the capture to direct joystick events to @e win.
+        Sets the capture to direct joystick events to @a win.

 
         @param win
             The window that will receive joystick events.
         @param pollingFreq
 
         @param win
             The window that will receive joystick events.
         @param pollingFreq

-            If zero, movement events are sent when above the
-            threshold. If greater than zero, events are received every pollingFreq
-        milliseconds.
+            If zero, movement events are sent when above the threshold.
+            If greater than zero, events are received every @a pollingFreq milliseconds.

 
         @return @true if the capture succeeded.
 
 
         @return @true if the capture succeeded.
 


@@ -263,8 +272,7 @@ public:
 
     /**
         Sets the movement threshold, the number of steps outside which the joystick is
 
     /**
         Sets the movement threshold, the number of steps outside which the joystick is

-        deemed to have
-        moved.
+        deemed to have moved.

     */
     void SetMovementThreshold(int threshold);
 };
     */
     void SetMovementThreshold(int threshold);
 };