orxJoystick.h

Go to the documentation of this file.

/* Orx - Portable Game Engine
 *
 * Copyright (c) 2008-2018 Orx-Project
 *
 * This software is provided 'as-is', without any express or implied
 * warranty. In no event will the authors be held liable for any damages
 * arising from the use of this software.
 *
 * Permission is granted to anyone to use this software for any purpose,
 * including commercial applications, and to alter it and redistribute it
 * freely, subject to the following restrictions:
 *
 *    1. The origin of this software must not be misrepresented; you must not
 *    claim that you wrote the original software. If you use this software
 *    in a product, an acknowledgment in the product documentation would be
 *    appreciated but is not required.
 *
 *    2. Altered source versions must be plainly marked as such, and must not be
 *    misrepresented as being the original software.
 *
 *    3. This notice may not be removed or altered from any source
 *    distribution.
 */

#ifndef _orxJOYSTICK_H_
#define _orxJOYSTICK_H_

#include "orxInclude.h"
#include "plugin/orxPluginCore.h"


#define orxJOYSTICK_GET_AXIS_FOR_PLAYER(AXIS, PLAYER)     (((AXIS) % orxJOYSTICK_AXIS_SINGLE_NUMBER) + ((PLAYER - 1) * orxJOYSTICK_AXIS_SINGLE_NUMBER))
#define orxJOYSTICK_GET_BUTTON_FOR_PLAYER(BUTTON, PLAYER) (((BUTTON) % orxJOYSTICK_BUTTON_SINGLE_NUMBER) + ((PLAYER - 1) * orxJOYSTICK_BUTTON_SINGLE_NUMBER))

#define orxJOYSTICK_GET_PLAYER_FROM_AXIS(AXIS)            (((AXIS) / orxJOYSTICK_AXIS_SINGLE_NUMBER) + 1)
#define orxJOYSTICK_GET_PLAYER_FROM_BUTTON(BUTTON)        (((BUTTON) / orxJOYSTICK_BUTTON_SINGLE_NUMBER) + 1)


typedef enum __orxJOYSTICK_BUTTON_t
{
  orxJOYSTICK_BUTTON_1_1 = 0,
  orxJOYSTICK_BUTTON_2_1,
  orxJOYSTICK_BUTTON_3_1,
  orxJOYSTICK_BUTTON_4_1,
  orxJOYSTICK_BUTTON_5_1,
  orxJOYSTICK_BUTTON_6_1,
  orxJOYSTICK_BUTTON_7_1,
  orxJOYSTICK_BUTTON_8_1,
  orxJOYSTICK_BUTTON_9_1,
  orxJOYSTICK_BUTTON_10_1,
  orxJOYSTICK_BUTTON_11_1,
  orxJOYSTICK_BUTTON_12_1,
  orxJOYSTICK_BUTTON_13_1,
  orxJOYSTICK_BUTTON_14_1,
  orxJOYSTICK_BUTTON_15_1,
  orxJOYSTICK_BUTTON_16_1,

  orxJOYSTICK_BUTTON_SINGLE_NUMBER,

  orxJOYSTICK_BUTTON_1_2 = orxJOYSTICK_BUTTON_SINGLE_NUMBER,
  orxJOYSTICK_BUTTON_2_2,
  orxJOYSTICK_BUTTON_3_2,
  orxJOYSTICK_BUTTON_4_2,
  orxJOYSTICK_BUTTON_5_2,
  orxJOYSTICK_BUTTON_6_2,
  orxJOYSTICK_BUTTON_7_2,
  orxJOYSTICK_BUTTON_8_2,
  orxJOYSTICK_BUTTON_9_2,
  orxJOYSTICK_BUTTON_10_2,
  orxJOYSTICK_BUTTON_11_2,
  orxJOYSTICK_BUTTON_12_2,
  orxJOYSTICK_BUTTON_13_2,
  orxJOYSTICK_BUTTON_14_2,
  orxJOYSTICK_BUTTON_15_2,
  orxJOYSTICK_BUTTON_16_2,

  orxJOYSTICK_BUTTON_1_3,
  orxJOYSTICK_BUTTON_2_3,
  orxJOYSTICK_BUTTON_3_3,
  orxJOYSTICK_BUTTON_4_3,
  orxJOYSTICK_BUTTON_5_3,
  orxJOYSTICK_BUTTON_6_3,
  orxJOYSTICK_BUTTON_7_3,
  orxJOYSTICK_BUTTON_8_3,
  orxJOYSTICK_BUTTON_9_3,
  orxJOYSTICK_BUTTON_10_3,
  orxJOYSTICK_BUTTON_11_3,
  orxJOYSTICK_BUTTON_12_3,
  orxJOYSTICK_BUTTON_13_3,
  orxJOYSTICK_BUTTON_14_3,
  orxJOYSTICK_BUTTON_15_3,
  orxJOYSTICK_BUTTON_16_3,

  orxJOYSTICK_BUTTON_1_4,
  orxJOYSTICK_BUTTON_2_4,
  orxJOYSTICK_BUTTON_3_4,
  orxJOYSTICK_BUTTON_4_4,
  orxJOYSTICK_BUTTON_5_4,
  orxJOYSTICK_BUTTON_6_4,
  orxJOYSTICK_BUTTON_7_4,
  orxJOYSTICK_BUTTON_8_4,
  orxJOYSTICK_BUTTON_9_4,
  orxJOYSTICK_BUTTON_10_4,
  orxJOYSTICK_BUTTON_11_4,
  orxJOYSTICK_BUTTON_12_4,
  orxJOYSTICK_BUTTON_13_4,
  orxJOYSTICK_BUTTON_14_4,
  orxJOYSTICK_BUTTON_15_4,
  orxJOYSTICK_BUTTON_16_4,

  orxJOYSTICK_BUTTON_NUMBER,

  orxJOYSTICK_BUTTON_NONE = orxENUM_NONE

} orxJOYSTICK_BUTTON;


typedef enum __orxJOYSTICK_AXIS_t
{
  orxJOYSTICK_AXIS_X_1 = 0,
  orxJOYSTICK_AXIS_Y_1,
  orxJOYSTICK_AXIS_Z_1,
  orxJOYSTICK_AXIS_R_1,
  orxJOYSTICK_AXIS_U_1,
  orxJOYSTICK_AXIS_V_1,
  orxJOYSTICK_AXIS_POV_1,

  orxJOYSTICK_AXIS_SINGLE_NUMBER,

  orxJOYSTICK_AXIS_X_2 = orxJOYSTICK_AXIS_SINGLE_NUMBER,
  orxJOYSTICK_AXIS_Y_2,
  orxJOYSTICK_AXIS_Z_2,
  orxJOYSTICK_AXIS_R_2,
  orxJOYSTICK_AXIS_U_2,
  orxJOYSTICK_AXIS_V_2,
  orxJOYSTICK_AXIS_POV_2,

  orxJOYSTICK_AXIS_X_3,
  orxJOYSTICK_AXIS_Y_3,
  orxJOYSTICK_AXIS_Z_3,
  orxJOYSTICK_AXIS_R_3,
  orxJOYSTICK_AXIS_U_3,
  orxJOYSTICK_AXIS_V_3,
  orxJOYSTICK_AXIS_POV_3,

  orxJOYSTICK_AXIS_X_4,
  orxJOYSTICK_AXIS_Y_4,
  orxJOYSTICK_AXIS_Z_4,
  orxJOYSTICK_AXIS_R_4,
  orxJOYSTICK_AXIS_U_4,
  orxJOYSTICK_AXIS_V_4,
  orxJOYSTICK_AXIS_POV_4,

  orxJOYSTICK_AXIS_NUMBER,

  orxJOYSTICK_AXIS_NONE = orxENUM_NONE

} orxJOYSTICK_AXIS;


/***************************************************************************
 * Functions directly implemented by orx core
 ***************************************************************************/

extern orxDLLAPI void orxFASTCALL             orxJoystick_Setup();


/***************************************************************************
 * Functions extended by plugins
 ***************************************************************************/

extern orxDLLAPI orxSTATUS orxFASTCALL        orxJoystick_Init();

extern orxDLLAPI void orxFASTCALL             orxJoystick_Exit();

extern orxDLLAPI orxFLOAT orxFASTCALL         orxJoystick_GetAxisValue(orxJOYSTICK_AXIS _eAxis);

extern orxDLLAPI orxBOOL orxFASTCALL          orxJoystick_IsButtonPressed(orxJOYSTICK_BUTTON _eButton);

extern orxDLLAPI const orxSTRING orxFASTCALL  orxJoystick_GetButtonName(orxJOYSTICK_BUTTON _eButton);

extern orxDLLAPI const orxSTRING orxFASTCALL  orxJoystick_GetAxisName(orxJOYSTICK_AXIS _eAxis);

#endif /* _orxJOYSTICK_H_ */