Moved all interface headers into a 'wx' subdirectory for proper use of Doxygen path settings.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@54385 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

interface/wx/joystick.h

@@ -0,0 +1,272 @@
+/////////////////////////////////////////////////////////////////////////////
+// Name:        joystick.h
+// Purpose:     interface of wxJoystick
+// Author:      wxWidgets team
+// RCS-ID:      $Id$
+// Licence:     wxWindows license
+/////////////////////////////////////////////////////////////////////////////
+
+/**
+    @class wxJoystick
+    @wxheader{joystick.h}
+
+    wxJoystick allows an application to control one or more joysticks.
+
+    @library{wxadv}
+    @category{FIXME}
+
+    @see wxJoystickEvent
+*/
+class wxJoystick : public wxObject
+{
+public:
+    /**
+        Constructor. @a joystick may be one of wxJOYSTICK1, wxJOYSTICK2, indicating the
+        joystick
+        controller of interest.
+    */
+    wxJoystick(int joystick = wxJOYSTICK1);
+
+    /**
+        Destroys the wxJoystick object.
+    */
+    ~wxJoystick();
+
+    //@{
+    /**
+        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;
+    //@}
+
+    /**
+        Returns the manufacturer id.
+    */
+    int GetManufacturerId() const;
+
+    /**
+        Returns the movement threshold, the number of steps outside which the joystick
+        is deemed to have
+        moved.
+    */
+    int GetMovementThreshold() const;
+
+    /**
+        Returns the number of axes for this joystick.
+    */
+    int GetNumberAxes() const;
+
+    /**
+        Returns the number of buttons for this joystick.
+    */
+    int GetNumberButtons() const;
+
+    /**
+        Returns the number of joysticks currently attached to the computer.
+    */
+    static int GetNumberJoysticks();
+
+    /**
+        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
+        degree units,
+        but limited to return 0, 9000, 18000 or 27000.
+        Returns -1 on error.
+    */
+    int GetPOVPosition() const;
+
+    /**
+        Returns the maximum polling frequency.
+    */
+    int GetPollingMax() const;
+
+    /**
+        Returns the minimum polling frequency.
+    */
+    int GetPollingMin() const;
+
+    //@{
+    /**
+        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;
+    //@}
+
+    /**
+        Returns the product id for the joystick.
+    */
+    int GetProductId() const;
+
+    /**
+        Returns the product name for the joystick.
+    */
+    wxString GetProductName() const;
+
+    /**
+        Returns the maximum rudder position.
+    */
+    int GetRudderMax() const;
+
+    /**
+        Returns the minimum rudder position.
+    */
+    int GetRudderMin() const;
+
+    /**
+        Returns the rudder position.
+    */
+    int GetRudderPosition() const;
+
+    /**
+        Returns the maximum U position.
+    */
+    int GetUMax() const;
+
+    /**
+        Returns the minimum U position.
+    */
+    int GetUMin() const;
+
+    /**
+        Gets the position of the fifth axis of the joystick, if it exists.
+    */
+    int GetUPosition() const;
+
+    /**
+        Returns the maximum V position.
+    */
+    int GetVMax() const;
+
+    /**
+        Returns the minimum V position.
+    */
+    int GetVMin() const;
+
+    /**
+        Gets the position of the sixth axis of the joystick, if it exists.
+    */
+    int GetVPosition() const;
+
+    /**
+        Returns the maximum x position.
+    */
+    int GetXMax() const;
+
+    /**
+        Returns the minimum x position.
+    */
+    int GetXMin() const;
+
+    /**
+        Returns the maximum y position.
+    */
+    int GetYMax() const;
+
+    /**
+        Returns the minimum y position.
+    */
+    int GetYMin() const;
+
+    /**
+        Returns the maximum z position.
+    */
+    int GetZMax() const;
+
+    /**
+        Returns the minimum z position.
+    */
+    int GetZMin() const;
+
+    /**
+        Returns the z position of the joystick.
+    */
+    int GetZPosition() const;
+
+    /**
+        Returns @true if the joystick has a point of view control.
+    */
+    bool HasPOV() const;
+
+    /**
+        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.
+    */
+#define bool HasPOVCTS() const     /* implementation is private */
+
+    /**
+        Returns @true if there is a rudder attached to the computer.
+    */
+    bool HasRudder() const;
+
+    /**
+        Returns @true if the joystick has a U axis.
+    */
+    bool HasU() const;
+
+    /**
+        Returns @true if the joystick has a V axis.
+    */
+    bool HasV() const;
+
+    /**
+        Returns @true if the joystick has a Z axis.
+    */
+    bool HasZ() const;
+
+    /**
+        Returns @true if the joystick is functioning.
+    */
+    bool IsOk() const;
+
+    /**
+        Releases the capture set by @b SetCapture.
+
+        @return @true if the capture release succeeded.
+
+        @see SetCapture(), wxJoystickEvent
+    */
+    bool ReleaseCapture();
+
+    /**
+        Sets the capture to direct joystick events to @e win.
+
+        @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.
+
+        @return @true if the capture succeeded.
+
+        @see ReleaseCapture(), wxJoystickEvent
+    */
+    bool SetCapture(wxWindow* win, int pollingFreq = 0);
+
+    /**
+        Sets the movement threshold, the number of steps outside which the joystick is
+        deemed to have
+        moved.
+    */
+    void SetMovementThreshold(int threshold);
+};
+