i2p/haiku-beta6
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Complete and rework BJoystick docs.

Browse Source
This commit is contained in:
Adrien Destugues
2015-01-10 11:44:58 +01:00
parent c8e6696716
commit c50131cd6a
1 changed files with 33 additions and 32 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/user/device/Joystick.dox
+33 -32
View File
@@ -11,51 +11,52 @@
*/ */
/*! /*!
\file Joystick.h \file Joystick.h
\ingroup device \ingroup device
\brief BJoystick class definition. \brief BJoystick class definition.
*/ */
/*! /*!
\class Joystick \class Joystick
\ingroup device \ingroup device
\brief Class that provides an interface to a joystick and other similar game \brief Class that provides an interface to joysticks and game controllers.
controllers.
This class adds support for joysticks and other similar game controllers This class allows application to access the data from game controllers of
through game ports, both, on cards and some build-in ports. any type (joysticks, gamepads, racing wheels, etc). It provides discovery
of the button configuration and axis layout and reports the status of the
buttons and position of the axis. There is also support for enumerating the
available controllers.
The class also provides two modes - standard and enhanced Joysticks can be accessed in two modes called standard and enhanced. The
standard mode is for compatibility with the BeBox joysticks and is not
implemented in Haiku. New applications should use the enhanced mode.
*/ */
/*! /*!
\fn int32 BJoystick::CountDevices() \fn int32 BJoystick::CountDevices()
\brief Count the number of joysticks connected. \brief Count the number of joysticks connected.
\return The number of joystick devices connected. \return The number of joystick devices connected to the computer.
*/ */
/*! /*!
\fn status_t BJoystick::Open(const char *portname, bool enhanced) \fn status_t BJoystick::Open(const char *portname, bool enhanced)
\brief Open a specific game port. \brief Open a specific game port.
This method can be used to open the game port specified by the parameter This method can be used to open the game port specified by the parameter
\c portname amd also allows you to specify whether to use enhanced mode or \c portname amd also allows you to specify whether to use enhanced mode or
not. not. The port name can be either an absolute path to the game port device,
or only the device file name.
Enhanced mode adds support for up to 32 buttons per joystick, an indefinite Enhanced mode adds support for more than 32 buttons per joystick, and an
number of axes and thumb controls, and also allows you to connect multiple unlimited number of axes and thumb controls. To support this, several
joysticks to a single game port. It provides several methods to determine functions allow to get information about the device, such as the button
the state of a joystick and also a preference application. count, the name of each button, and the number and name of the axis.
Enhanced mode also provides a mechanism to determine what joysticks are \param portname The name of the game port to be opened.
available and what types of and how many controls are available on them. \param enhanced Specifies whether to use enhanced mode while opening the port.
\return B_BAD_VALUE if portname is null.
\param portname The name of the game port to be opened. \return B_NO_INIT if the object failed to initialize.
\param enhanced Specifies whether to use enhanced mode while opening the port. \return B_ERROR if the specified port cannot be open.
\return B_BAD_VALUE if portname is null. \return The file descriptor for the port if it is opened succesfully.
B_ERROR if the specified port is unable to open or if portname is not valid.
A positive integer if the port is opened succesfully.
\see CountDevices()
GetDeviceName()
*/ */